Merge pull request #200 from nicoddemus/release-3.3.0

Add CHANGELOG and update README for 3.3.0

Author: nicoddemus

CHANGELOG.rst

@@ -1,3 +1,23 @@
+3.3.0 (2020-08-21)
+------------------
+
+* ``pytest-mock`` now includes inline type annotations and exposes them to user programs. The ``mocker`` fixture returns ``pytest_mock.MockerFixture``, which can be used to annotate your tests:
+
+  .. code-block:: python
+
+        from pytest_mock import MockerFixture
+
+        def test_foo(mocker: MockerFixture) -> None:
+            ...
+
+  The type annotations were developed against mypy version ``0.782``, the
+  minimum version supported at the moment. If you run into an error that you believe to be incorrect, please open an issue.
+
+  Many thanks to `@staticdev`_ for providing the initial patch (`#199`_).
+
+.. _@staticdev: https://github.com/staticdev
+.. _#199: https://github.com/pytest-dev/pytest-mock/pull/199
+
 3.2.0 (2020-07-11)
 ------------------
 

README.rst

@@ -90,6 +90,28 @@ the appropriate mock fixture:
 * ``package_mocker``
 * ``session_mocker``
 
+Type Annotations
+----------------
+
+*New in version 3.3.0.*
+
+``pytest-mock`` is fully type annotated, letting users use static type checkers to
+test their code.
+
+The ``mocker`` fixture returns ``pytest_mock.MockerFixture`` which can be used
+to annotate test functions:
+
+.. code-block:: python
+
+    from pytest_mock import MockerFixture
+
+    def test_foo(mocker: MockerFixture) -> None:
+        ...
+
+The type annotations have been checked with ``mypy``, which is the only
+type checker supported at the moment; other type-checkers might work
+but are not currently tested.
+
 Spy
 ---