129 lines
4.6 KiB
Plaintext
129 lines
4.6 KiB
Plaintext
|
Metadata-Version: 2.1
|
||
|
|
Name: Werkzeug
|
||
|
|
Version: 1.0.1
|
||
|
|
Summary: The comprehensive WSGI web application library.
|
||
|
|
Home-page: https://palletsprojects.com/p/werkzeug/
|
||
|
|
Author: Armin Ronacher
|
||
|
|
Author-email: armin.ronacher@active-4.com
|
||
|
|
Maintainer: Pallets
|
||
|
|
Maintainer-email: contact@palletsprojects.com
|
||
|
|
License: BSD-3-Clause
|
||
|
|
Project-URL: Documentation, https://werkzeug.palletsprojects.com/
|
||
|
|
Project-URL: Code, https://github.com/pallets/werkzeug
|
||
|
|
Project-URL: Issue tracker, https://github.com/pallets/werkzeug/issues
|
||
|
|
Platform: UNKNOWN
|
||
|
|
Classifier: Development Status :: 5 - Production/Stable
|
||
|
|
Classifier: Environment :: Web Environment
|
||
|
|
Classifier: Intended Audience :: Developers
|
||
|
|
Classifier: License :: OSI Approved :: BSD License
|
||
|
|
Classifier: Operating System :: OS Independent
|
||
|
|
Classifier: Programming Language :: Python
|
||
|
|
Classifier: Programming Language :: Python :: 2
|
||
|
|
Classifier: Programming Language :: Python :: 2.7
|
||
|
|
Classifier: Programming Language :: Python :: 3
|
||
|
|
Classifier: Programming Language :: Python :: 3.5
|
||
|
|
Classifier: Programming Language :: Python :: 3.6
|
||
|
|
Classifier: Programming Language :: Python :: 3.7
|
||
|
|
Classifier: Programming Language :: Python :: 3.8
|
||
|
|
Classifier: Programming Language :: Python :: Implementation :: CPython
|
||
|
|
Classifier: Programming Language :: Python :: Implementation :: PyPy
|
||
|
|
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
|
||
|
|
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
|
||
|
|
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
|
||
|
|
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Middleware
|
||
|
|
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
|
||
|
|
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
||
|
|
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
|
||
|
|
Description-Content-Type: text/x-rst
|
||
|
|
Provides-Extra: dev
|
||
|
|
Requires-Dist: pytest ; extra == 'dev'
|
||
|
|
Requires-Dist: pytest-timeout ; extra == 'dev'
|
||
|
|
Requires-Dist: coverage ; extra == 'dev'
|
||
|
|
Requires-Dist: tox ; extra == 'dev'
|
||
|
|
Requires-Dist: sphinx ; extra == 'dev'
|
||
|
|
Requires-Dist: pallets-sphinx-themes ; extra == 'dev'
|
||
|
|
Requires-Dist: sphinx-issues ; extra == 'dev'
|
||
|
|
Provides-Extra: watchdog
|
||
|
|
Requires-Dist: watchdog ; extra == 'watchdog'
|
||
|
|
|
||
|
|
Werkzeug
|
||
|
|
========
|
||
|
|
|
||
|
|
*werkzeug* German noun: "tool". Etymology: *werk* ("work"), *zeug* ("stuff")
|
||
|
|
|
||
|
|
Werkzeug is a comprehensive `WSGI`_ web application library. It began as
|
||
|
|
a simple collection of various utilities for WSGI applications and has
|
||
|
|
become one of the most advanced WSGI utility libraries.
|
||
|
|
|
||
|
|
It includes:
|
||
|
|
|
||
|
|
- An interactive debugger that allows inspecting stack traces and
|
||
|
|
source code in the browser with an interactive interpreter for any
|
||
|
|
frame in the stack.
|
||
|
|
- A full-featured request object with objects to interact with
|
||
|
|
headers, query args, form data, files, and cookies.
|
||
|
|
- A response object that can wrap other WSGI applications and handle
|
||
|
|
streaming data.
|
||
|
|
- A routing system for matching URLs to endpoints and generating URLs
|
||
|
|
for endpoints, with an extensible system for capturing variables
|
||
|
|
from URLs.
|
||
|
|
- HTTP utilities to handle entity tags, cache control, dates, user
|
||
|
|
agents, cookies, files, and more.
|
||
|
|
- A threaded WSGI server for use while developing applications
|
||
|
|
locally.
|
||
|
|
- A test client for simulating HTTP requests during testing without
|
||
|
|
requiring running a server.
|
||
|
|
|
||
|
|
Werkzeug is Unicode aware and doesn't enforce any dependencies. It is up
|
||
|
|
to the developer to choose a template engine, database adapter, and even
|
||
|
|
how to handle requests. It can be used to build all sorts of end user
|
||
|
|
applications such as blogs, wikis, or bulletin boards.
|
||
|
|
|
||
|
|
`Flask`_ wraps Werkzeug, using it to handle the details of WSGI while
|
||
|
|
providing more structure and patterns for defining powerful
|
||
|
|
applications.
|
||
|
|
|
||
|
|
|
||
|
|
Installing
|
||
|
|
----------
|
||
|
|
|
||
|
|
Install and update using `pip`_:
|
||
|
|
|
||
|
|
.. code-block:: text
|
||
|
|
|
||
|
|
pip install -U Werkzeug
|
||
|
|
|
||
|
|
|
||
|
|
A Simple Example
|
||
|
|
----------------
|
||
|
|
|
||
|
|
.. code-block:: python
|
||
|
|
|
||
|
|
from werkzeug.wrappers import Request, Response
|
||
|
|
|
||
|
|
@Request.application
|
||
|
|
def application(request):
|
||
|
|
return Response('Hello, World!')
|
||
|
|
|
||
|
|
if __name__ == '__main__':
|
||
|
|
from werkzeug.serving import run_simple
|
||
|
|
run_simple('localhost', 4000, application)
|
||
|
|
|
||
|
|
|
||
|
|
Links
|
||
|
|
-----
|
||
|
|
|
||
|
|
- Website: https://palletsprojects.com/p/werkzeug/
|
||
|
|
- Documentation: https://werkzeug.palletsprojects.com/
|
||
|
|
- Releases: https://pypi.org/project/Werkzeug/
|
||
|
|
- Code: https://github.com/pallets/werkzeug
|
||
|
|
- Issue tracker: https://github.com/pallets/werkzeug/issues
|
||
|
|
- Test status: https://dev.azure.com/pallets/werkzeug/_build
|
||
|
|
- Official chat: https://discord.gg/t6rrQZH
|
||
|
|
|
||
|
|
.. _WSGI: https://wsgi.readthedocs.io/en/latest/
|
||
|
|
.. _Flask: https://www.palletsprojects.com/p/flask/
|
||
|
|
.. _pip: https://pip.pypa.io/en/stable/quickstart/
|
||
|
|
|
||
|
|
|