163783d8a7
This patch removes the TypeError heuristic code altogether, since it
has been problematic in the past (and often masks app bugs).
BREAKING CHANGE: You can no longer overload a single resource class to
respond to multiple routes that differ by URI template params. This
has come to be viewed as an anti-pattern, and so it will no longer
be supported.
If you attempt to have a single OxResource that you try to overload to
respond to both, e.g., "PUT /oxen/old-ben" and "GET /oxen", it will
no longer work after this commit.
Developers should be advised to resist the temptation to overload their
resources; instead, create OxResource and OxenResource. It is common to
put these two classes in the same module.
Fixes Issue #205
67 lines
1.9 KiB
Python
67 lines
1.9 KiB
Python
"""Default responders for handling common error cases.
|
|
|
|
Copyright 2013 by Rackspace Hosting, Inc.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
|
|
"""
|
|
|
|
from falcon.status_codes import HTTP_204
|
|
from falcon.status_codes import HTTP_400
|
|
from falcon.status_codes import HTTP_404
|
|
from falcon.status_codes import HTTP_405
|
|
|
|
|
|
def path_not_found(req, resp, **kwargs):
|
|
"""Simply sets responseto "404 Not Found", no body."""
|
|
resp.status = HTTP_404
|
|
|
|
|
|
def bad_request(req, resp, **kwargs):
|
|
"""Sets response to "400 Bad Request", no body."""
|
|
resp.status = HTTP_400
|
|
|
|
|
|
def create_method_not_allowed(allowed_methods):
|
|
"""Creates a responder for "405 Method Not Allowed"
|
|
|
|
Args:
|
|
allowed_methods: A list of HTTP methods (uppercase) that should be
|
|
returned in the Allow header.
|
|
|
|
"""
|
|
allowed = ', '.join(allowed_methods)
|
|
|
|
def method_not_allowed(req, resp, **kwargs):
|
|
resp.status = HTTP_405
|
|
resp.set_header('Allow', allowed)
|
|
|
|
return method_not_allowed
|
|
|
|
|
|
def create_default_options(allowed_methods):
|
|
"""Creates a default responder for the OPTIONS method
|
|
|
|
Args:
|
|
allowed_methods: A list of HTTP methods (uppercase) that should be
|
|
returned in the Allow header.
|
|
|
|
"""
|
|
allowed = ', '.join(allowed_methods)
|
|
|
|
def on_options(req, resp, **kwargs):
|
|
resp.status = HTTP_204
|
|
resp.set_header('Allow', allowed)
|
|
|
|
return on_options
|