Browse Source

fix doc build error

pull/2157/merge
David Lord 7 years ago
parent
commit
d2a46dc56d
No known key found for this signature in database
GPG Key ID: 7A1C87E3F5BC42A8
  1. 22
      docs/appcontext.rst

22
docs/appcontext.rst

@ -5,14 +5,14 @@ The Application Context
.. versionadded:: 0.9 .. versionadded:: 0.9
One of the design ideas behind Flask is that there are at least two One of the design ideas behind Flask is that there are at least two
different “states” in which code is executed: different “states” in which code is executed:
1. The application setup state, in which the application implicitly is 1. The application setup state, in which the application implicitly is
on the module level. on the module level.
This state starts when the :class:`Flask` object is instantiated, and This state starts when the :class:`Flask` object is instantiated, and
it implicitly ends when the first request comes in. While the it implicitly ends when the first request comes in. While the
application is in this state, a few assumptions are true: application is in this state, a few assumptions are true:
- the programmer can modify the application object safely. - the programmer can modify the application object safely.
@ -21,20 +21,20 @@ on the module level.
modify it, there is no magic proxy that can give you a reference to modify it, there is no magic proxy that can give you a reference to
the application object you're currently creating or modifying. the application object you're currently creating or modifying.
2. In contrast, in the request handling state, a couple of other rules 2. In contrast, in the request handling state, a couple of other rules
exist: exist:
- while a request is active, the context local objects - while a request is active, the context local objects
(:data:`flask.request` and others) point to the current request. (:data:`flask.request` and others) point to the current request.
- any code can get hold of these objects at any time. - any code can get hold of these objects at any time.
3. There is also a third state somewhere in between 'module-level' and 3. There is also a third state somewhere in between 'module-level' and
'request-handling': 'request-handling':
Sometimes you are dealing with an application in a way that is similar to Sometimes you are dealing with an application in a way that is similar to
how you interact with applications during request handling, but without how you interact with applications during request handling, but without
there being an active request. Consider, for instance, that you're there being an active request. Consider, for instance, that you're
sitting in an interactive Python shell and interacting with the sitting in an interactive Python shell and interacting with the
application, or a command line application. application, or a command line application.
The application context is what powers the :data:`~flask.current_app` The application context is what powers the :data:`~flask.current_app`

Loading…
Cancel
Save