Bump hypothesis-python version to 4.28.0 and update changelog

[skip ci]
HypothesisWorks · Jul 11, 2019 · 0dbf160 · 0dbf160
1 parent 68820ca
commit 0dbf160
Show file tree

Hide file tree

Showing 4 changed files with 16 additions and 11 deletions.
diff --git a/hypothesis-python/RELEASE.rst b/hypothesis-python/RELEASE.rst
diff --git a/hypothesis-python/docs/changes.rst b/hypothesis-python/docs/changes.rst
@@ -21,6 +21,20 @@ Hypothesis APIs come in three flavours:
 You should generally assume that an API is internal unless you have specific
 information to the contrary.
 
+.. _v4.28.0:
+
+-------------------
+4.28.0 - 2019-07-11
+-------------------
+
+This release deprecates ``find()``.  The ``.example()`` method is a better
+replacement if you want *an* example, and for the rare occasions where you
+want the *minimal* example you can get it from :func:`@given <hypothesis.given>`.
+
+:func:`@given <hypothesis.given>` has steadily outstripped ``find()`` in both
+features and performance over recent years, and as we do not have the resources
+to maintain and test both we think it is better to focus on just one.
+
 .. _v4.27.0:
 
 -------------------

diff --git a/hypothesis-python/src/hypothesis/core.py b/hypothesis-python/src/hypothesis/core.py
@@ -1058,7 +1058,7 @@ def find(
     note_deprecation(
         "`find(s, f)` is deprecated, because it is rarely used but takes "
         "ongoing work to maintain as we upgrade other parts of Hypothesis.",
-        since="RELEASEDAY",
+        since="2019-07-11",
     )
     if settings is None:
         settings = Settings(max_examples=2000)

diff --git a/hypothesis-python/src/hypothesis/version.py b/hypothesis-python/src/hypothesis/version.py
@@ -17,5 +17,5 @@
 
 from __future__ import absolute_import, division, print_function
 
-__version_info__ = (4, 27, 0)
+__version_info__ = (4, 28, 0)
 __version__ = ".".join(map(str, __version_info__))