METADATA 4.0 KB

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