Address CI failures and warnings

Author: A5rocks

docs-requirements.in

@@ -23,5 +23,4 @@ exceptiongroup >= 1.0.0rc9
 immutables >= 0.6
 
 # types used in annotations
-# TODO: fix support for importing typing-extensions
-pyOpenSSL < 25.0.0
+pyOpenSSL

docs-requirements.txt

@@ -55,7 +55,7 @@ pycparser==2.22 ; os_name == 'nt' or platform_python_implementation != 'PyPy'
     # via cffi
 pygments==2.19.1
     # via sphinx
-pyopenssl==24.3.0
+pyopenssl==25.0.0
     # via -r docs-requirements.in
 requests==2.32.3
     # via sphinx
@@ -105,6 +105,8 @@ sphinxcontrib-trio==1.1.2
 towncrier==24.8.0
     # via -r docs-requirements.in
 typing-extensions==4.12.2
-    # via beautifulsoup4
+    # via
+    #   beautifulsoup4
+    #   pyopenssl
 urllib3==2.3.0
     # via requests

docs/source/conf.py

@@ -25,6 +25,8 @@
 from pathlib import Path
 from typing import TYPE_CHECKING, cast
 
+from sphinx.util.inventory import _InventoryItem
+
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.util.typing import Inventory
@@ -266,11 +268,11 @@ def add_mapping(
         assert isinstance(inventory, dict)
         inventory = cast("Inventory", inventory)
 
-        inventory[f"py:{reftype}"][f"{target}"] = (
-            "Python",
-            version,
-            f"https://docs.python.org/{url_version}/library/{library}.html/{obj}",
-            "-",
+        inventory[f"py:{reftype}"][f"{target}"] = _InventoryItem(
+            project_name="Python",
+            project_version=version,
+            uri=f"https://docs.python.org/{url_version}/library/{library}.html/{obj}",
+            display_name="-",
         )
 
     # This has been removed in Py3.12, so add a link to the 3.11 version with deprecation warnings.

docs/source/contributing.rst

@@ -318,7 +318,7 @@ format all our code to a standard style. While you're editing code you
 can be as sloppy as you like about whitespace; and then before you commit,
 just run:
 
-.. code-block::
+.. code-block:: text
 
     pip install -U pre-commit
     pre-commit
@@ -332,14 +332,14 @@ nicely formatted. (black doesn't reformat comments or docstrings.)
 If you would like, you can even have pre-commit run before you commit by
 running:
 
-.. code-block::
+.. code-block:: text
 
     pre-commit install
 
 and now pre-commit will run before git commits. You can uninstall the
 pre-commit hook at any time by running:
 
-.. code-block::
+.. code-block:: text
 
     pre-commit uninstall
 
@@ -349,7 +349,7 @@ you can can add ``# fmt: off`` and ``# fmt: on`` comments.
 
 If you want to see what changes black will make, you can use:
 
-.. code-block::
+.. code-block:: text
 
     black --diff trio
 
@@ -433,7 +433,7 @@ file to install all of the required packages (possibly using a
 virtualenv). After that, build the docs using ``make html`` in the
 docs directory. The whole process might look something like this:
 
-.. code-block::
+.. code-block:: text
 
     cd path/to/project/checkout/
     pip install -r docs-requirements.txt

src/trio/testing/_memory_streams.py

@@ -280,6 +280,15 @@ def put_eof(self) -> None:
         self._incoming.close()
 
 
+# TODO: investigate why this is necessary for the docs
+MemorySendStream.__module__ = MemorySendStream.__module__.replace(
+    "._memory_streams", ""
+)
+MemoryReceiveStream.__module__ = MemoryReceiveStream.__module__.replace(
+    "._memory_streams", ""
+)
+
+
 def memory_stream_pump(
     memory_send_stream: MemorySendStream,
     memory_receive_stream: MemoryReceiveStream,

src/trio/testing/_raises_group.py

@@ -270,7 +270,7 @@ class Matcher(AbstractMatcher[MatchE]):
 
     Examples::
 
-        with RaisesGroups(Matcher(ValueError, match="string"))
+        with RaisesGroups(Matcher(ValueError, match="string")):
             ...
         with RaisesGroups(Matcher(check=lambda x: x.args == (3, "hello"))):
             ...
@@ -326,7 +326,7 @@ def matches(
 
         Examples::
 
-            assert Matcher(ValueError).matches(my_exception):
+            assert Matcher(ValueError).matches(my_exception)
             # is equivalent to
             assert isinstance(my_exception, ValueError)
 
@@ -336,7 +336,7 @@ def matches(
             assert Matcher(SyntaxError, match="foo").matches(excinfo.value.__cause__)
             # above line is equivalent to
             assert isinstance(excinfo.value.__cause__, SyntaxError)
-            assert re.search("foo", str(excinfo.value.__cause__)
+            assert re.search("foo", str(excinfo.value.__cause__))
 
         """
         if not self._check_type(exception):
@@ -549,7 +549,7 @@ def __init__(
         )
         self.allow_unwrapped = allow_unwrapped
         self.flatten_subgroups: bool = flatten_subgroups
-        self.is_baseexceptiongroup = False
+        self.is_baseexceptiongroup: bool = False
 
         if allow_unwrapped and other_exceptions:
             raise ValueError(