chore(test): move pytest cli args definition

The `--broker-url` PyTest CLI argument is used by the examples to
determine whether a Broker is automatically launched, or whether an
existing broker is used.

All PyTest CLI arguments _must_ be defined in the root directory of the
project. As a result, the previous location where these arguments were
defined meant that the examples could only be launched of PyTest was
specifically pointed at the `examples/` directory.

This commit moves the definition to the root directory, thereby unifying
the `examples/` with the remaining tests.

Signed-off-by: JP-Ellis <josh@jpellis.me>

conftest.py

@@ -0,0 +1,21 @@
+"""
+Global PyTest configuration.
+
+This file is automatically loaded by PyTest before running any tests and is used
+to define global fixtures and command line options. Command line options can
+only be defined in this file.
+"""
+
+import pytest
+
+
+def pytest_addoption(parser: pytest.Parser) -> None:
+    """Define additional command lines to customise the examples."""
+    parser.addoption(
+        "--broker-url",
+        help=(
+            "The URL of the broker to use. If this option has been given, the container"
+            " will _not_ be started."
+        ),
+        type=str,
+    )

examples/conftest.py

@@ -21,18 +21,6 @@
 EXAMPLE_DIR = Path(__file__).parent.resolve()
 
 
-def pytest_addoption(parser: pytest.Parser) -> None:
-    """Define additional command lines to customise the examples."""
-    parser.addoption(
-        "--broker-url",
-        help=(
-            "The URL of the broker to use. If this option has been given, the container"
-            " will _not_ be started."
-        ),
-        type=str,
-    )
-
-
 @pytest.fixture(scope="session")
 def broker(request: pytest.FixtureRequest) -> Generator[URL, Any, None]:
     """