METADATA 3.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. Metadata-Version: 2.4
  2. Name: typing_extensions
  3. Version: 4.15.0
  4. Summary: Backported and Experimental Type Hints for Python 3.9+
  5. Keywords: annotations,backport,checker,checking,function,hinting,hints,type,typechecking,typehinting,typehints,typing
  6. Author-email: "Guido van Rossum, Jukka Lehtosalo, Łukasz Langa, Michael Lee" <levkivskyi@gmail.com>
  7. Requires-Python: >=3.9
  8. Description-Content-Type: text/markdown
  9. License-Expression: PSF-2.0
  10. Classifier: Development Status :: 5 - Production/Stable
  11. Classifier: Environment :: Console
  12. Classifier: Intended Audience :: Developers
  13. Classifier: Operating System :: OS Independent
  14. Classifier: Programming Language :: Python :: 3
  15. Classifier: Programming Language :: Python :: 3 :: Only
  16. Classifier: Programming Language :: Python :: 3.9
  17. Classifier: Programming Language :: Python :: 3.10
  18. Classifier: Programming Language :: Python :: 3.11
  19. Classifier: Programming Language :: Python :: 3.12
  20. Classifier: Programming Language :: Python :: 3.13
  21. Classifier: Programming Language :: Python :: 3.14
  22. Classifier: Topic :: Software Development
  23. License-File: LICENSE
  24. Project-URL: Bug Tracker, https://github.com/python/typing_extensions/issues
  25. Project-URL: Changes, https://github.com/python/typing_extensions/blob/main/CHANGELOG.md
  26. Project-URL: Documentation, https://typing-extensions.readthedocs.io/
  27. Project-URL: Home, https://github.com/python/typing_extensions
  28. Project-URL: Q & A, https://github.com/python/typing/discussions
  29. Project-URL: Repository, https://github.com/python/typing_extensions
  30. # Typing Extensions
  31. [![Chat at https://gitter.im/python/typing](https://badges.gitter.im/python/typing.svg)](https://gitter.im/python/typing)
  32. [Documentation](https://typing-extensions.readthedocs.io/en/latest/#) –
  33. [PyPI](https://pypi.org/project/typing-extensions/)
  34. ## Overview
  35. The `typing_extensions` module serves two related purposes:
  36. - Enable use of new type system features on older Python versions. For example,
  37. `typing.TypeGuard` is new in Python 3.10, but `typing_extensions` allows
  38. users on previous Python versions to use it too.
  39. - Enable experimentation with new type system PEPs before they are accepted and
  40. added to the `typing` module.
  41. `typing_extensions` is treated specially by static type checkers such as
  42. mypy and pyright. Objects defined in `typing_extensions` are treated the same
  43. way as equivalent forms in `typing`.
  44. `typing_extensions` uses
  45. [Semantic Versioning](https://semver.org/). The
  46. major version will be incremented only for backwards-incompatible changes.
  47. Therefore, it's safe to depend
  48. on `typing_extensions` like this: `typing_extensions ~=x.y`,
  49. where `x.y` is the first version that includes all features you need.
  50. [This](https://packaging.python.org/en/latest/specifications/version-specifiers/#compatible-release)
  51. is equivalent to `typing_extensions >=x.y, <(x+1)`. Do not depend on `~= x.y.z`
  52. unless you really know what you're doing; that defeats the purpose of
  53. semantic versioning.
  54. ## Included items
  55. See [the documentation](https://typing-extensions.readthedocs.io/en/latest/#) for a
  56. complete listing of module contents.
  57. ## Contributing
  58. See [CONTRIBUTING.md](https://github.com/python/typing_extensions/blob/main/CONTRIBUTING.md)
  59. for how to contribute to `typing_extensions`.