Changelog for Falcon 1.2.0
New & Improved
- A new `default` kwarg was added to :meth:`~falcon.Request.get_header`.
- A :meth:`~falcon.Response.delete_header` method was added to
  :class:`falcon.Response`.
- Several new HTTP status codes and error classes were added, such as
  :class:`falcon.HTTPFailedDependency`.
- If `ujson` is installed it will be used in lieu of `json` to speed up
  error serialization and query string parsing under CPython. PyPy users
  should continue to use `json`.
- The `independent_middleware` kwarg was added to :class:`falcon.API` to
  enable the execution of `process_response()` middleware methods, even
  when `process_request()` raises an error.
- Single-character field names are now allowed in URL templates when
  specifying a route.
- A detailed error message is now returned when an attempt is made to
  add a route that conflicts with one that has already been added.
- The HTTP protocol version can now be specified when simulating
  requests with the testing framework.
- The :class:`falcon.ResponseOptions` class was added, along with a
  `secure_cookies_by_default` option to control the default value of
  the "secure" attribute when setting cookies. This can make testing
  easier by providing a way to toggle whether or not HTTPS is required.
- `port`, `netloc` and `scheme` properties were added to the
  :class:`falcon.Request` class. The `protocol` property is now
  deprecated and will be removed in a future release.
- The `strip_url_path_trailing_slash` was added
  to :class:`falcon.RequestOptions` to control whether or not to retain
  the trailing slash in the URL path, if one is present. When this
  option is enabled (the default), the URL path is normalized by
  stripping the trailing slash character. This lets the application
  define a single route to a resource for a path that may or may not end
  in a forward slash. However, this behavior can be problematic in
  certain cases, such as when working with authentication schemes that
  employ URL-based signatures. Therefore, the
  `strip_url_path_trailing_slash` option was introduced to make this
  behavior configurable.
- Improved the documentation for :class:`falcon.HTTPError`, particularly
  around customizing error serialization.
- Misc. improvements to the look and feel of Falcon's documentation.
- The tutorial in the docs was revamped, and now includes guidance on
  testing Falcon applications.


(adam)