123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137 |
- # -*- coding: utf-8 -*-
- """
- flask.wrappers
- ~~~~~~~~~~~~~~
- Implements the WSGI wrappers (request and response).
- :copyright: 2010 Pallets
- :license: BSD-3-Clause
- """
- from werkzeug.exceptions import BadRequest
- from werkzeug.wrappers import Request as RequestBase
- from werkzeug.wrappers import Response as ResponseBase
- from werkzeug.wrappers.json import JSONMixin as _JSONMixin
- from . import json
- from .globals import current_app
- class JSONMixin(_JSONMixin):
- json_module = json
- def on_json_loading_failed(self, e):
- if current_app and current_app.debug:
- raise BadRequest("Failed to decode JSON object: {0}".format(e))
- raise BadRequest()
- class Request(RequestBase, JSONMixin):
- """The request object used by default in Flask. Remembers the
- matched endpoint and view arguments.
- It is what ends up as :class:`~flask.request`. If you want to replace
- the request object used you can subclass this and set
- :attr:`~flask.Flask.request_class` to your subclass.
- The request object is a :class:`~werkzeug.wrappers.Request` subclass and
- provides all of the attributes Werkzeug defines plus a few Flask
- specific ones.
- """
- #: The internal URL rule that matched the request. This can be
- #: useful to inspect which methods are allowed for the URL from
- #: a before/after handler (``request.url_rule.methods``) etc.
- #: Though if the request's method was invalid for the URL rule,
- #: the valid list is available in ``routing_exception.valid_methods``
- #: instead (an attribute of the Werkzeug exception
- #: :exc:`~werkzeug.exceptions.MethodNotAllowed`)
- #: because the request was never internally bound.
- #:
- #: .. versionadded:: 0.6
- url_rule = None
- #: A dict of view arguments that matched the request. If an exception
- #: happened when matching, this will be ``None``.
- view_args = None
- #: If matching the URL failed, this is the exception that will be
- #: raised / was raised as part of the request handling. This is
- #: usually a :exc:`~werkzeug.exceptions.NotFound` exception or
- #: something similar.
- routing_exception = None
- @property
- def max_content_length(self):
- """Read-only view of the ``MAX_CONTENT_LENGTH`` config key."""
- if current_app:
- return current_app.config["MAX_CONTENT_LENGTH"]
- @property
- def endpoint(self):
- """The endpoint that matched the request. This in combination with
- :attr:`view_args` can be used to reconstruct the same or a
- modified URL. If an exception happened when matching, this will
- be ``None``.
- """
- if self.url_rule is not None:
- return self.url_rule.endpoint
- @property
- def blueprint(self):
- """The name of the current blueprint"""
- if self.url_rule and "." in self.url_rule.endpoint:
- return self.url_rule.endpoint.rsplit(".", 1)[0]
- def _load_form_data(self):
- RequestBase._load_form_data(self)
- # In debug mode we're replacing the files multidict with an ad-hoc
- # subclass that raises a different error for key errors.
- if (
- current_app
- and current_app.debug
- and self.mimetype != "multipart/form-data"
- and not self.files
- ):
- from .debughelpers import attach_enctype_error_multidict
- attach_enctype_error_multidict(self)
- class Response(ResponseBase, JSONMixin):
- """The response object that is used by default in Flask. Works like the
- response object from Werkzeug but is set to have an HTML mimetype by
- default. Quite often you don't have to create this object yourself because
- :meth:`~flask.Flask.make_response` will take care of that for you.
- If you want to replace the response object used you can subclass this and
- set :attr:`~flask.Flask.response_class` to your subclass.
- .. versionchanged:: 1.0
- JSON support is added to the response, like the request. This is useful
- when testing to get the test client response data as JSON.
- .. versionchanged:: 1.0
- Added :attr:`max_cookie_size`.
- """
- default_mimetype = "text/html"
- def _get_data_for_json(self, cache):
- return self.get_data()
- @property
- def max_cookie_size(self):
- """Read-only view of the :data:`MAX_COOKIE_SIZE` config key.
- See :attr:`~werkzeug.wrappers.BaseResponse.max_cookie_size` in
- Werkzeug's docs.
- """
- if current_app:
- return current_app.config["MAX_COOKIE_SIZE"]
- # return Werkzeug's default when not in an app context
- return super(Response, self).max_cookie_size
|