80 lines
3.5 KiB
Markdown
80 lines
3.5 KiB
Markdown
# servant - A Type-Level Web DSL
|
|
|
|
|
|
|
|
## Getting Started
|
|
|
|
We have a [tutorial](http://haskell-servant.readthedocs.org/en/stable/tutorial/index.html) that
|
|
introduces the core features of servant. After this article, you should be able
|
|
to write your first servant webservices, learning the rest from the haddocks'
|
|
examples.
|
|
|
|
The central documentation can be found [here](http://haskell-servant.readthedocs.org/).
|
|
Other blog posts, videos and slides can be found on the
|
|
[website](http://haskell-servant.github.io/).
|
|
|
|
If you need help, drop by the IRC channel (#servant on freenode) or [mailing
|
|
list](https://groups.google.com/forum/#!forum/haskell-servant).
|
|
|
|
## Version history
|
|
|
|
This table lists the versions of some `servant-` libraries at the point of
|
|
release of `servant` package.
|
|
|
|
| | **0.10** | **0.11** | **0.12** |
|
|
| ------------------- | -------- |----------|----------|
|
|
| servant | 0.10 | 0.11 | 0.12 |
|
|
| servant-blaze | 0.7.1 | ? | ? |
|
|
| servant-cassava | 0.7 | ? | ? |
|
|
| servant-client | 0.10 | 0.11 | 0.12 |
|
|
| servant-docs | 0.10 | 0.11 | 0.11.1 |
|
|
| servant-foreign | 0.10 | 0.10.0.1 | 0.10.2 |
|
|
| servant-js | 0.9.1 | ? | ? |
|
|
| servant-lucid | 0.7.1 | ? | ? |
|
|
| servant-mock | 0.8.1.1 | ? | ? |
|
|
| servant-server | 0.10 | 0.11 | 0.12 |
|
|
| servant-swagger | 1.1.2.1 | ? | ? |
|
|
|
|
## Contributing
|
|
|
|
See `CONTRIBUTING.md`
|
|
|
|
## Release process outline (by phadej)
|
|
|
|
- Update changelog and bump versions in `master`
|
|
- `git log --oneline v0.12.. | grep 'Merge pull request'` is a good starting point (use correct previous release tag)
|
|
- Create a release branch, e.g. `release-0.13`, and *protect it* from accidental force pushes.
|
|
- Release branch is useful for backporting fixes from `master`
|
|
- Smoke test in [`servant-universe`](https://github.com/phadej/servant-universe)
|
|
- `git submodule foreach git checkout master` and `git submodule foreach git pull` to get newest of everything.
|
|
- `cabal new-build --enable-tests all` to verify that everything builds, and `cabal new-test all` to run tests
|
|
- It's a good idea to separate these steps, as tests often pass, if they compile :)
|
|
- See `cabal.project` to selectively `allow-newer`
|
|
- If some packages are broken, on your discretisation there are two options:
|
|
- Fix them and make PRs: it's good idea to test against older `servant` version too.
|
|
- Temporarily comment out broken package
|
|
- If you make a commit for `servant-universe`, you can use it as submodule in private projects to test even more
|
|
- When ripples are cleared out:
|
|
- `git tag -s` the release
|
|
- `git push --tags`
|
|
- `cabal sdist` and `cabal upload`
|
|
|
|
## travis
|
|
|
|
`.travis.yml` is generated using `make-travis-yml` tool, in
|
|
[multi-ghc-travis](https://github.com/haskell-hvr/multi-ghc-travis) repository.
|
|
|
|
To regenerate the script use (*note:* atm you need to comment `doc/cookbook/` packages).
|
|
|
|
```
|
|
runghc ~/Documents/other-haskell/multi-ghc-travis/make_travis_yml_2.hs regenerate
|
|
```
|
|
|
|
In case Travis jobs fail due failing build of dependency, you can temporarily
|
|
add `constraints` to the `cabal.project`, and regenerate the `.travis.yml`.
|
|
For example, the following will disallow single `troublemaker-13.37` package version:
|
|
|
|
```
|
|
constraints:
|
|
troublemaker <13.37 && > 13.37
|
|
```
|