Add CHANGELOG and update README for 3.3.0

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
 ---