mirror of
https://github.com/rls-moe/nyx
synced 2024-11-16 22:12:24 +00:00
41 lines
2.0 KiB
Markdown
41 lines
2.0 KiB
Markdown
|
# Changelog
|
||
|
|
|
||
|
|
## v2.0.0 (2017-01-06)
|
||
|
|
|
||
|
|
- After many months of v2 being in an RC state with many companies and users running it in
|
||
|
|
production, the inclusion of some improvements to the middlewares, we are very pleased to
|
||
|
|
announce v2.0.0 of chi.
|
||
|
|
|
||
|
|
|
||
|
|
## v2.0.0-rc1 (2016-07-26)
|
||
|
|
|
||
|
|
- Huge update! chi v2 is a large refactor targetting Go 1.7+. As of Go 1.7, the popular
|
||
|
|
community `"net/context"` package has been included in the standard library as `"context"` and
|
||
|
|
utilized by `"net/http"` and `http.Request` to managing deadlines, cancelation signals and other
|
||
|
|
request-scoped values. We're very excited about the new context addition and are proud to
|
||
|
|
introduce chi v2, a minimal and powerful routing package for building large HTTP services,
|
||
|
|
with zero external dependencies. Chi focuses on idiomatic design and encourages the use of
|
||
|
|
stdlib HTTP handlers and middlwares.
|
||
|
|
- chi v2 deprecates its `chi.Handler` interface and requires `http.Handler` or `http.HandlerFunc`
|
||
|
|
- chi v2 stores URL routing parameters and patterns in the standard request context: `r.Context()`
|
||
|
|
- chi v2 lower-level routing context is accessible by `chi.RouteContext(r.Context()) *chi.Context`,
|
||
|
|
which provides direct access to URL routing parameters, the routing path and the matching
|
||
|
|
routing patterns.
|
||
|
|
- Users upgrading from chi v1 to v2, need to:
|
||
|
|
1. Update the old chi.Handler signature, `func(ctx context.Context, w http.ResponseWriter, r *http.Request)` to
|
||
|
|
the standard http.Handler: `func(w http.ResponseWriter, r *http.Request)`
|
||
|
|
2. Use `chi.URLParam(r *http.Request, paramKey string) string`
|
||
|
|
or `URLParamFromCtx(ctx context.Context, paramKey string) string` to access a url parameter value
|
||
|
|
|
||
|
|
|
||
|
|
## v1.0.0 (2016-07-01)
|
||
|
|
|
||
|
|
- Released chi v1 stable https://github.com/pressly/chi/tree/v1.0.0 for Go 1.6 and older.
|
||
|
|
|
||
|
|
|
||
|
|
## v0.9.0 (2016-03-31)
|
||
|
|
|
||
|
|
- Reuse context objects via sync.Pool for zero-allocation routing [#33](https://github.com/pressly/chi/pull/33)
|
||
|
|
- BREAKING NOTE: due to subtle API changes, previously `chi.URLParams(ctx)["id"]` used to access url parameters
|
||
|
|
has changed to: `chi.URLParam(ctx, "id")`
|