./devel/py-falcon, Unladen web framework for building APIs and app backends

[ CVSweb ] [ Homepage ] [ RSS ] [ Required by ] [ Add to tracker ]

Branch: CURRENT, Version: 2.0.0, Package name: py37-falcon-2.0.0, Maintainer: pkgsrc-users

Falcon is a high-performance Python framework for building cloud APIs.
It encourages the REST architectural style, and tries to do as little
as possible while remaining highly effective.

Required to run:
[devel/py-setuptools] [devel/py-cython] [lang/python37]

Required to build:

Master sites:

SHA1: 04cc91d672ab40c229002862e1c4be091acb91ad
RMD160: 27954bce1bc1651056c4bd3dbb2af6610fea069a
Filesize: 388.478 KB

Version history: (Expand)

CVS history: (Expand)

   2020-05-16 19:08:53 by Adam Ciarcinski | Files touched by this commit (3) | Package updated
Log message:
py-falcon: updated to 2.0.0

Changelog for Falcon 2.0.0
Many thanks to all of our awesome contributors (listed down below) who made this \ 
release possible!

In 2.0 we added a number of new convenience methods and properties. We also made \ 
it a lot cleaner and less error-prone to assign multiple routes to the same \ 
resource class via suffixed responders.

Also noteworthy is the significant effort we invested in improving the accuracy, \ 
clarity, and breadth of the docs. We hope these changes will help make the \ 
framework easier to learn for newcomers.

Middleware methods can now short-circuit request processing, and we improved \ 
cookie and ETag handling. Plus, the testing framework received several \ 
improvements to make it easier to simulate certain types of requests.

As this is the first major release that we have had in quite a while, we have \ 
taken the opportunity to clean up many parts of the framework. Deprecated \ 
variables, methods, and classes have been removed, along with all \ 
backwards-compatibility shims for old method signatures. We also changed the \ 
defaults for a number of request options based on community feedback.

Please carefully review the list of breaking changes below to see what you may \ 
need to tweak in your app to make it compatible with this release.
   2020-01-26 18:32:28 by Roland Illig | Files touched by this commit (981)
Log message:
all: migrate homepages from http to https

pkglint -r --network --only "migrate"

As a side-effect of migrating the homepages, pkglint also fixed a few
indentations in unrelated lines. These and the new homepages have been
checked manually.
   2018-02-22 12:14:19 by Adam Ciarcinski | Files touched by this commit (3) | Package updated
Log message:
py-falcon: updated to 1.4.0

Changes to Supported Platforms

Python 3 is now supported on PyPy as of PyPy3.5 v5.10.
Support for CPython 3.3 is now deprecated and will be removed in Falcon 2.0.
As with the previous release, Python 2.6 and Jython 2.7 remain deprecated and \ 
will no longer be supported in Falcon 2.0.

New & Improved

We added a new method, API.add_static_route(), that makes it easy to serve files \ 
from a local directory. This feature provides an alternative to serving files \ 
from the web server when you don't have that option, when authorization is \ 
required, or for testing purposes.
Arguments can now be passed to hooks.
The default JSON media type handler will now use ujson, if available, to speed \ 
up JSON (de)serialization under CPython.
Semantic validation via the format keyword is now enabled for the \ 
falcon.media.validators.jsonschema.validate() JSON Schema decorator.
We added a new helper, falcon.Request.get_param_as_uuid(), to the Request class.
We added a new property, downloadable_as, to the Response class for setting the \ 
Content-Disposition header.
Falcon now supports WebDAV methods (RFC 3253), such as UPDATE and REPORT.
falcon.routing.create_http_method_map has been refactored into two new methods, \ 
falcon.routing.map_http_methods and falcon.routing.set_default_responders, so \ 
that custom routers can better pick and choose the functionality they need. The \ 
original method is still available for backwards-compatibility, but will be \ 
removed in a future release.
We added a new json param to falcon.testing.simulate_request() et al. to \ 
automatically serialize the request body from a JSON serializable object or type \ 
(for a complete list of serializable types, see json.JSONEncoder).
TestClient's simulate_*() methods now call TestClient.simulate_request to make \ 
it easier for subclasses to override TestClient's behavior.
TestClient can now be configured with a default set of headers to send with \ 
every request.
testing.Result.json now returns None when the response body is empty, rather \ 
than raising an error.
The FAQ has been reorganized and greatly expanded.
We restyled the docs to match https://falconframework.org


Forwarded headers containing quoted strings with commas were not being parsed \ 
correctly. This has been fixed, and the parser generally made more robust.
falcon.media.JSONHandler was raising an error under Python 2.x when serializing \ 
strings containing Unicode code points. This issue has been fixed.
Overriding a resource class and calling its responders via super() did not work \ 
when passing URI template params as positional arguments. This has now been \ 
Python 3.6 was generating warnings for strings containing '\s' within Falcon. \ 
These strings have been converted to raw strings to mitigate the warning.
Several syntax errors were found and fixed in the code examples used in the docs.
   2017-12-22 06:53:05 by Adam Ciarcinski | Files touched by this commit (3) | Package updated
Log message:
py-falcon: updated to 1.3.0

Changelog for Falcon 1.3.0

Changes to Supported Platforms
- CPython 3.6 is now fully supported.
- Falcon appears to work well on PyPy3.5, but we are waiting until
  that platform is out of beta before officially supporting it.
- Support for both CPython 2.6 and Jython 2.7 is now deprecated and
  will be discontinued in Falcon 2.0.

New & Improved
- We added built-in resource representation serialization and
  deserialization, including input validation based on JSON Schema.
  (See also: :ref:`Media <media>`)
- URI template field converters are now supported. We expect to expand
  this feature over time. (See also:
  :ref:`Field Converters <routing_field_converters>`)
- A new method, :meth:`~.Request.get_param_as_datetime`, was added to
- A number of attributes were added to :class:`~.Request` to
  make proxy information easier to consume. These include the
  :attr:`~.Request.forwarded`, :attr:`~.Request.forwarded_uri`,
  :attr:`~.Request.forwarded_scheme`, :attr:`~.Request.forwarded_host`,
  and :attr:`~.Request.forwarded_prefix` attributes. The
  :attr:`~.Request.prefix` attribute was also added as part of this
- A :attr:`~.Request.referer` attribute was added to
- We implemented ``__repr__()`` for :class:`~.Request`,
  :class:`~.Response`, and :class:`~.HTTPError` to aid in
- A number of Internet media type constants were defined to make it
  easier to check and set content type headers. (See also:
  :ref:`Media Type Constants <media_type_constants>`)
- Several new 5xx error classes were implemented. (See also:
  :ref:`Error Handling <errors>`)

- If even a single cookie in the request to the server is malformed,
  none of the cookies will be parsed (all-or-nothing). Change the
  parser to simply skip bad cookies (best-effort).
- :class:`~.API` instances are not pickleable. Modify the default router
  to fix this.
   2017-05-21 08:54:13 by Adam Ciarcinski | Files touched by this commit (2)
Log message:
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
- Several new HTTP status codes and error classes were added, such as
- 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.
   2017-04-25 22:55:35 by Filip Hajny | Files touched by this commit (5)
Log message:
Import falcon 1.1.0 as devel/py-falcon.

Falcon is a high-performance Python framework for building cloud APIs.
It encourages the REST architectural style, and tries to do as little
as possible while remaining highly effective.