The pyramid_methodrewrite package is a pyramid plugin that adds a “tween” that rewrites the active HTTP method (as exposed via request.method) to the value provided in a HTTP header or query-string. The main reason for this is to allow clients to fake the use of HTTP methods beyond GET and POST (such as PUT and DELETE) that are behind non-compliant proxies, browsers, or other deficient software that limit which HTTP methods can be sent.
It does this by looking for an X-HTTP-Method-Override HTTP header or a _method parameter in either the query-string or POST data, and if the value is of the known set of HTTP methods, will override the active request’s .method attribute. Both the header name and parameter name are configurable. The header value, if specified, takes precedence over the parameter value.
For example, the request:
GET /path/to/resource?_method=OPTIONS HTTP/1.1Becomes equivalent (from the application’s point of view) to:
OPTIONS /path/to/resource HTTP/1.1Project
Installation
$ pip install pyramid-methodrewriteUsage
Enable the tween either in your INI file via:
pyramid.includes = pyramid_methodrewriteor in code in your package’s application initialization via:
def main(global_config, **settings):
# ...
config.include('pyramid_methodrewrite')
# ...Configuration
The following configuration settings can be set in your application’s main section:
methodrewrite.enabled: a boolean flag to control whether or not method rewriting should be enabled. Default: True.
methodrewrite.on: a list of incoming HTTP methods that will cause this tween to check the request parameters and potentially make the change. Defaults to (GET, POST).
methodrewrite.header: the name of the header that controls the requested method. Defaults to X-HTTP-Method-Override. If present, the header override takes precedence over the parameter override.
methodrewrite.param: the name of the parameter that controls the requested method. Defaults to _method.
methodrewrite.to: list of acceptable HTTP methods that a request can be rewritten to. If set to empty, no restrictions will be made on mapping to acceptable or known methods. Defaults to pyramid_methodrewrite.HTTP_METHODS.
Note that all method names are always converted to upper case.
1 maintainer
Metadata
1 maintainer
Release files for pyramid_methodrewrite 0.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyramid_methodrewrite-0.2.3.tar.gz | 5.8 kB | Details |
Release files / pyramid_methodrewrite-0.2.3.tar.gz
| Download URL | pyramid_methodrewrite-0.2.3.tar.gz |
|---|---|
| Size | 5.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
37da8b0c7d8b2e3dbfe8db4b689a2ccd7ae7e7c70d160317a3d3b46c40292c96
|
|
BLAKE2b-256 checksum How to use checksums |
ee4077ce4dd1899bc4d0141dc73b0ed1242df2a846cc6357d5cdf843bb6873c1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
