update readme with dev, testing, and contribution section

This commit is contained in:
Matthias Kadenbach 2017-02-08 18:27:12 -08:00
parent e6163082d7
commit b3f6bc47bb
1 changed files with 17 additions and 6 deletions

View File

@ -106,14 +106,25 @@ Each migration version has an up and down migration.
1481574547_create_users_table.down.sql
```
## Development and Testing
## Development, Testing and Contributing
Tests require Docker (for database driver testing).
1. Make sure you have a running Docker daemon
(Install for [MacOS](https://docs.docker.com/docker-for-mac/))
2. Fork this repo and `git clone` somewhere to `$GOPATH/src/github.com/%you%/migrate`
3. `make rewrite-import-paths` to update imports to your local fork
4. Confirm tests are working: `make test-short`
5. Write awesome code ...
6. `make test` to run all tests against all database versions
7. `make restore-import-paths` to restore import paths
8. Push code and open Pull Request
Some more notes:
```
make test-short DATABASE='postgres'
make test
```
* You can specify which database/ source tests to run:
`make test-short SOURCE='file go-bindata' DATABASE='postgres cassandra'`
* After `make test`, run `make html-coverage` which opens a shiny test coverage overview.
* Missing imports? `make deps`
* `make build-cli` builds the CLI in directory `cli/build/`.
## Alternatives