METADATA 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125
  1. Metadata-Version: 2.1
  2. Name: hypothesis
  3. Version: 4.57.1
  4. Summary: A library for property-based testing
  5. Home-page: https://github.com/HypothesisWorks/hypothesis/tree/master/hypothesis-python
  6. Author: David R. MacIver
  7. Author-email: david@drmaciver.com
  8. License: MPL v2
  9. Project-URL: Website, https://hypothesis.works
  10. Project-URL: Documentation, https://hypothesis.readthedocs.io
  11. Project-URL: Issues, https://github.com/HypothesisWorks/hypothesis/issues
  12. Keywords: python testing fuzzing property-based-testing
  13. Platform: UNKNOWN
  14. Classifier: Development Status :: 5 - Production/Stable
  15. Classifier: Framework :: Hypothesis
  16. Classifier: Framework :: Pytest
  17. Classifier: Intended Audience :: Developers
  18. Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
  19. Classifier: Operating System :: Unix
  20. Classifier: Operating System :: POSIX
  21. Classifier: Operating System :: Microsoft :: Windows
  22. Classifier: Programming Language :: Python
  23. Classifier: Programming Language :: Python :: 2.7
  24. Classifier: Programming Language :: Python :: 3
  25. Classifier: Programming Language :: Python :: 3.5
  26. Classifier: Programming Language :: Python :: 3.6
  27. Classifier: Programming Language :: Python :: 3.7
  28. Classifier: Programming Language :: Python :: 3.8
  29. Classifier: Programming Language :: Python :: Implementation :: CPython
  30. Classifier: Programming Language :: Python :: Implementation :: PyPy
  31. Classifier: Topic :: Education :: Testing
  32. Classifier: Topic :: Software Development :: Testing
  33. Classifier: Typing :: Typed
  34. Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
  35. Description-Content-Type: text/x-rst
  36. Requires-Dist: attrs (>=19.2.0)
  37. Requires-Dist: sortedcontainers (<3.0.0,>=2.1.0)
  38. Requires-Dist: enum34 ; python_version == "2.7"
  39. Provides-Extra: all
  40. Requires-Dist: django (>=1.11) ; extra == 'all'
  41. Requires-Dist: dpcontracts (>=0.4) ; extra == 'all'
  42. Requires-Dist: lark-parser (>=0.6.5) ; extra == 'all'
  43. Requires-Dist: numpy (>=1.9.0) ; extra == 'all'
  44. Requires-Dist: pandas (>=0.19) ; extra == 'all'
  45. Requires-Dist: pytest (>=4.3) ; extra == 'all'
  46. Requires-Dist: python-dateutil (>=1.4) ; extra == 'all'
  47. Requires-Dist: pytz (>=2014.1) ; extra == 'all'
  48. Provides-Extra: dateutil
  49. Requires-Dist: python-dateutil (>=1.4) ; extra == 'dateutil'
  50. Provides-Extra: django
  51. Requires-Dist: pytz (>=2014.1) ; extra == 'django'
  52. Requires-Dist: django (>=1.11) ; extra == 'django'
  53. Provides-Extra: dpcontracts
  54. Requires-Dist: dpcontracts (>=0.4) ; extra == 'dpcontracts'
  55. Provides-Extra: lark
  56. Requires-Dist: lark-parser (>=0.6.5) ; extra == 'lark'
  57. Provides-Extra: numpy
  58. Requires-Dist: numpy (>=1.9.0) ; extra == 'numpy'
  59. Provides-Extra: pandas
  60. Requires-Dist: pandas (>=0.19) ; extra == 'pandas'
  61. Provides-Extra: pytest
  62. Requires-Dist: pytest (>=4.3) ; extra == 'pytest'
  63. Provides-Extra: pytz
  64. Requires-Dist: pytz (>=2014.1) ; extra == 'pytz'
  65. ==========
  66. Hypothesis
  67. ==========
  68. Hypothesis is an advanced testing library for Python. It lets you write tests which
  69. are parametrized by a source of examples, and then generates simple and comprehensible
  70. examples that make your tests fail. This lets you find more bugs in your code with less
  71. work.
  72. e.g.
  73. .. code-block:: python
  74. @given(st.lists(st.floats(allow_nan=False, allow_infinity=False), min_size=1))
  75. def test_mean(xs):
  76. assert min(xs) <= mean(xs) <= max(xs)
  77. .. code-block::
  78. Falsifying example: test_mean(
  79. xs=[1.7976321109618856e+308, 6.102390043022755e+303]
  80. )
  81. Hypothesis is extremely practical and advances the state of the art of
  82. unit testing by some way. It's easy to use, stable, and powerful. If
  83. you're not using Hypothesis to test your project then you're missing out.
  84. ------------------------
  85. Quick Start/Installation
  86. ------------------------
  87. If you just want to get started:
  88. .. code-block::
  89. pip install hypothesis
  90. -----------------
  91. Links of interest
  92. -----------------
  93. The main Hypothesis site is at `hypothesis.works <https://hypothesis.works/>`_, and contains a lot
  94. of good introductory and explanatory material.
  95. Extensive documentation and examples of usage are `available at readthedocs <https://hypothesis.readthedocs.io/en/latest/>`_.
  96. If you want to talk to people about using Hypothesis, `we have both an IRC channel
  97. and a mailing list <https://hypothesis.readthedocs.io/en/latest/community.html>`_.
  98. If you want to receive occasional updates about Hypothesis, including useful tips and tricks, there's a
  99. `TinyLetter mailing list to sign up for them <https://tinyletter.com/DRMacIver/>`_.
  100. If you want to contribute to Hypothesis, `instructions are here <https://github.com/HypothesisWorks/hypothesis-python/blob/master/CONTRIBUTING.rst>`_.
  101. If you want to hear from people who are already using Hypothesis, some of them `have written
  102. about it <https://hypothesis.readthedocs.io/en/latest/endorsements.html>`_.
  103. If you want to create a downstream package of Hypothesis, please read `these guidelines for packagers <https://hypothesis.readthedocs.io/en/latest/packaging.html>`_.