METADATA 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899
  1. Metadata-Version: 2.3
  2. Name: Werkzeug
  3. Version: 3.1.3
  4. Summary: The comprehensive WSGI web application library.
  5. Maintainer-email: Pallets <contact@palletsprojects.com>
  6. Requires-Python: >=3.9
  7. Description-Content-Type: text/markdown
  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. Classifier: Typing :: Typed
  20. Requires-Dist: MarkupSafe>=2.1.1
  21. Requires-Dist: watchdog>=2.3 ; extra == "watchdog"
  22. Project-URL: Changes, https://werkzeug.palletsprojects.com/changes/
  23. Project-URL: Chat, https://discord.gg/pallets
  24. Project-URL: Documentation, https://werkzeug.palletsprojects.com/
  25. Project-URL: Donate, https://palletsprojects.com/donate
  26. Project-URL: Issue Tracker, https://github.com/pallets/werkzeug/issues/
  27. Project-URL: Source Code, https://github.com/pallets/werkzeug/
  28. Provides-Extra: watchdog
  29. # Werkzeug
  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. ## A Simple Example
  61. ```python
  62. # save this as app.py
  63. from werkzeug.wrappers import Request, Response
  64. @Request.application
  65. def application(request: Request) -> Response:
  66. return Response("Hello, World!")
  67. if __name__ == "__main__":
  68. from werkzeug.serving import run_simple
  69. run_simple("127.0.0.1", 5000, application)
  70. ```
  71. ```
  72. $ python -m app
  73. * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
  74. ```
  75. ## Donate
  76. The Pallets organization develops and supports Werkzeug and other
  77. popular packages. In order to grow the community of contributors and
  78. users, and allow the maintainers to devote more time to the projects,
  79. [please donate today][].
  80. [please donate today]: https://palletsprojects.com/donate