|
| 1 | +Metadata-Version: 2.1 |
| 2 | +Name: Werkzeug |
| 3 | +Version: 2.0.1 |
| 4 | +Summary: The comprehensive WSGI web application library. |
| 5 | +Home-page: https://palletsprojects.com/p/werkzeug/ |
| 6 | +Author: Armin Ronacher |
| 7 | +Author-email: armin.ronacher@active-4.com |
| 8 | +Maintainer: Pallets |
| 9 | +Maintainer-email: contact@palletsprojects.com |
| 10 | +License: BSD-3-Clause |
| 11 | +Project-URL: Donate, https://palletsprojects.com/donate |
| 12 | +Project-URL: Documentation, https://werkzeug.palletsprojects.com/ |
| 13 | +Project-URL: Changes, https://werkzeug.palletsprojects.com/changes/ |
| 14 | +Project-URL: Source Code, https://github.com/pallets/werkzeug/ |
| 15 | +Project-URL: Issue Tracker, https://github.com/pallets/werkzeug/issues/ |
| 16 | +Project-URL: Twitter, https://twitter.com/PalletsTeam |
| 17 | +Project-URL: Chat, https://discord.gg/pallets |
| 18 | +Platform: UNKNOWN |
| 19 | +Classifier: Development Status :: 5 - Production/Stable |
| 20 | +Classifier: Environment :: Web Environment |
| 21 | +Classifier: Intended Audience :: Developers |
| 22 | +Classifier: License :: OSI Approved :: BSD License |
| 23 | +Classifier: Operating System :: OS Independent |
| 24 | +Classifier: Programming Language :: Python |
| 25 | +Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content |
| 26 | +Classifier: Topic :: Internet :: WWW/HTTP :: WSGI |
| 27 | +Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application |
| 28 | +Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Middleware |
| 29 | +Classifier: Topic :: Software Development :: Libraries :: Application Frameworks |
| 30 | +Requires-Python: >=3.6 |
| 31 | +Description-Content-Type: text/x-rst |
| 32 | +Requires-Dist: dataclasses ; python_version < "3.7" |
| 33 | +Provides-Extra: watchdog |
| 34 | +Requires-Dist: watchdog ; extra == 'watchdog' |
| 35 | + |
| 36 | +Werkzeug |
| 37 | +======== |
| 38 | + |
| 39 | +*werkzeug* German noun: "tool". Etymology: *werk* ("work"), *zeug* ("stuff") |
| 40 | + |
| 41 | +Werkzeug is a comprehensive `WSGI`_ web application library. It began as |
| 42 | +a simple collection of various utilities for WSGI applications and has |
| 43 | +become one of the most advanced WSGI utility libraries. |
| 44 | + |
| 45 | +It includes: |
| 46 | + |
| 47 | +- An interactive debugger that allows inspecting stack traces and |
| 48 | + source code in the browser with an interactive interpreter for any |
| 49 | + frame in the stack. |
| 50 | +- A full-featured request object with objects to interact with |
| 51 | + headers, query args, form data, files, and cookies. |
| 52 | +- A response object that can wrap other WSGI applications and handle |
| 53 | + streaming data. |
| 54 | +- A routing system for matching URLs to endpoints and generating URLs |
| 55 | + for endpoints, with an extensible system for capturing variables |
| 56 | + from URLs. |
| 57 | +- HTTP utilities to handle entity tags, cache control, dates, user |
| 58 | + agents, cookies, files, and more. |
| 59 | +- A threaded WSGI server for use while developing applications |
| 60 | + locally. |
| 61 | +- A test client for simulating HTTP requests during testing without |
| 62 | + requiring running a server. |
| 63 | + |
| 64 | +Werkzeug doesn't enforce any dependencies. It is up to the developer to |
| 65 | +choose a template engine, database adapter, and even how to handle |
| 66 | +requests. It can be used to build all sorts of end user applications |
| 67 | +such as blogs, wikis, or bulletin boards. |
| 68 | + |
| 69 | +`Flask`_ wraps Werkzeug, using it to handle the details of WSGI while |
| 70 | +providing more structure and patterns for defining powerful |
| 71 | +applications. |
| 72 | + |
| 73 | +.. _WSGI: https://wsgi.readthedocs.io/en/latest/ |
| 74 | +.. _Flask: https://www.palletsprojects.com/p/flask/ |
| 75 | + |
| 76 | + |
| 77 | +Installing |
| 78 | +---------- |
| 79 | + |
| 80 | +Install and update using `pip`_: |
| 81 | + |
| 82 | +.. code-block:: text |
| 83 | + |
| 84 | + pip install -U Werkzeug |
| 85 | + |
| 86 | +.. _pip: https://pip.pypa.io/en/stable/quickstart/ |
| 87 | + |
| 88 | + |
| 89 | +A Simple Example |
| 90 | +---------------- |
| 91 | + |
| 92 | +.. code-block:: python |
| 93 | + |
| 94 | + from werkzeug.wrappers import Request, Response |
| 95 | + |
| 96 | + @Request.application |
| 97 | + def application(request): |
| 98 | + return Response('Hello, World!') |
| 99 | + |
| 100 | + if __name__ == '__main__': |
| 101 | + from werkzeug.serving import run_simple |
| 102 | + run_simple('localhost', 4000, application) |
| 103 | + |
| 104 | + |
| 105 | +Donate |
| 106 | +------ |
| 107 | + |
| 108 | +The Pallets organization develops and supports Werkzeug and other |
| 109 | +popular packages. In order to grow the community of contributors and |
| 110 | +users, and allow the maintainers to devote more time to the projects, |
| 111 | +`please donate today`_. |
| 112 | + |
| 113 | +.. _please donate today: https://palletsprojects.com/donate |
| 114 | + |
| 115 | + |
| 116 | +Links |
| 117 | +----- |
| 118 | + |
| 119 | +- Documentation: https://werkzeug.palletsprojects.com/ |
| 120 | +- Changes: https://werkzeug.palletsprojects.com/changes/ |
| 121 | +- PyPI Releases: https://pypi.org/project/Werkzeug/ |
| 122 | +- Source Code: https://github.com/pallets/werkzeug/ |
| 123 | +- Issue Tracker: https://github.com/pallets/werkzeug/issues/ |
| 124 | +- Website: https://palletsprojects.com/p/werkzeug/ |
| 125 | +- Twitter: https://twitter.com/PalletsTeam |
| 126 | +- Chat: https://discord.gg/pallets |
| 127 | + |
| 128 | + |
0 commit comments