servant/servant-docs/CHANGELOG.md

167 lines
5.0 KiB
Markdown
Raw Permalink Normal View History

[The latest version of this document is on GitHub.](https://github.com/haskell-servant/servant/blob/master/servant-docs/CHANGELOG.md)
[Changelog for `servant` package contains significant entries for all core packages.](https://github.com/haskell-servant/servant/blob/master/servant/CHANGELOG.md)
0.12
----
### Significant changes
- Generate sample cURL requests
([#1401](https://github.com/haskell-servant/servant/pull/1401/files)).
Breaking change: requires sample header values to be supplied with `headers`.
2021-06-23 23:38:46 +02:00
0.11.9
------
### Significant changes
- Use Capture Description if available (#1423).
### Other changes
- Support GHC-9.0.1.
- Bump `bytestring` and `lens` dependencies.
2020-11-22 15:51:32 +01:00
0.11.8
------
### Significant changes
- Support `Fragment` combinator.
0.11.7
------
### Significant changes
- Add instance for ToSample NonEmpty
### Other changes
- Bump "tested-with" ghc versions
- Fix servant-docs code sample in README
2020-01-23 13:10:20 +01:00
0.11.5
2020-01-23 12:43:19 +01:00
----
- Add NoContentVerb [#1028](https://github.com/haskell-servant/servant/issues/1028) [#1219](https://github.com/haskell-servant/servant/pull/1219) [#1228](https://github.com/haskell-servant/servant/pull/1228)
The `NoContent` API endpoints should now use `NoContentVerb` combinator.
The API type changes are usually of the kind
```diff
- :<|> PostNoContent '[JSON] NoContent
+ :<|> PostNoContent
```
i.e. one doesn't need to specify the content-type anymore. There is no content.
- `Capture` can be `Lenient` [#1155](https://github.com/haskell-servant/servant/issues/1155) [#1156](https://github.com/haskell-servant/servant/pull/1156)
You can specify a lenient capture as
```haskell
:<|> "capture-lenient" :> Capture' '[Lenient] "foo" Int :> GET
```
which will make the capture always succeed. Handlers will be of the
type `Either String CapturedType`, where `Left err` represents
the possible parse failure.
- *servant-docs* Merge documentation from duplicate routes [#1240](https://github.com/haskell-servant/servant/issues/1240) [#1241](https://github.com/haskell-servant/servant/pull/1241)
Servant supports defining the same route multiple times with different
content-types and result-types, but servant-docs was only documenting
the first of copy of such duplicated routes. It now combines the
documentation from all the copies.
Unfortunately, it is not yet possible for the documentation to specify
multiple status codes.
- *servant-docs* Prevent race-conditions in testing [#1194](https://github.com/haskell-servant/servant/pull/1194)
2019-09-15 16:19:56 +02:00
0.11.4
------
- Drop dependency on `control-monad-omega` in favor of `Data.Universe.Helpers` from `universe-base`.
0.11.3
------
- Support `servant-0.15`
- Instances for 'Stream' and 'StreamBody'
2018-02-08 11:29:16 +01:00
0.11.2
------
* Allow `servant-0.13`:
- Doesn't have instances for streaming.
- Servant.API.Modifiers extra information isn't used.
0.11.1
------
* Export `DocAuthentication` and related lenses.
* Make `defAction`'s documentation visible in Haddock documentation.
* Add a markdown header for the Headers an endpoint is sensitive to.
* Document the HTTP Method the parameters of an endpoint belong to
(rather than assuming `GET` for all of them).
* Content type of sample response body is also displayed.
2017-10-11 03:19:00 +02:00
* Can now customise various aspects of how the document is produced
using `markdownWith` and `RenderingOptions`:
- How many content-types for each example are shown
- Whether notes should be grouped together under their own header.
2017-07-24 08:08:57 +02:00
0.11
----
* changed the type of `rqbody`.
0.10
----
There are no changes. Released as a part of `servant` suite.
2016-05-10 22:45:06 +02:00
0.7.1
-----
* Support GHC 8.0
2016-04-15 10:17:51 +02:00
0.7
---
2016-04-11 20:19:18 +02:00
2016-04-12 06:54:04 +02:00
* Use `throwError` instead of `throwE` in documentation
2016-04-11 20:19:18 +02:00
2016-03-19 13:26:13 +01:00
0.5
----
* Support for the `HttpVersion`, `IsSecure`, `RemoteHost` and `Vault` combinators
2015-09-21 12:49:26 +02:00
* Support maximum samples setting with new `DocOptions` type (used by `docsWithOptions` and `docsWith`)
2015-09-24 13:29:27 +02:00
* Remove redundant second parameter of ToSample
2015-09-21 12:49:26 +02:00
* Add Generic-based default implementation for `ToSample` class
* Add more `ToSamples` instances: `Bool`, `Ordering`, tuples (up to 7), `[]`, `Maybe`, `Either`, `Const`, `ZipList` and some monoids
* Move `toSample` out of `ToSample` class
* Add a few helper functions to define `toSamples`
2015-10-13 21:46:52 +02:00
* Remove matrix params.
* Added support for Basic authentication
2015-03-04 02:07:13 +01:00
0.4
---
* `Delete` now is like `Get`, `Post`, `Put`, and `Patch` and returns a response body
2015-03-04 02:07:13 +01:00
* Allow for extra information to be added to the docs
2015-05-09 02:28:05 +02:00
* Support content-type aware combinators of *servant-0.4*
2015-03-04 02:07:13 +01:00
* Render endpoints in a canonical order (https://github.com/haskell-servant/servant-docs/pull/15)
2015-04-08 16:27:38 +02:00
* Remove ToJSON superclass from ToSample
* Split out Internal module
2015-05-02 12:09:00 +02:00
* Add support for response headers
2015-05-04 17:04:11 +02:00
* Allow `ToSample` to return a different type than it's arguments
* Add Proxy argument to `ToSample`
2015-03-04 02:07:13 +01:00
2015-01-04 17:17:57 +01:00
0.3
---
* Add the ability to display multiple responses, with some accompanying `Text` to describe the context in which we get the corresponding JSON.
* Expose the `headers` lens
* Represent an endpoint's path as `[String]` (previously `String`), fixing a corner case where the leading `/` would be missing.