PYTHON-5550 Add a test that uses uvloop as the event loop

Author: blink1073

.github/workflows/test-python.yml

@@ -165,6 +165,30 @@ jobs:
         run: |
           just typing
 
+  integration_tets:
+    runs-on: ubuntu-latest
+    name: Integration Tests
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          persist-credentials: false
+      - name: Install uv
+        uses: astral-sh/setup-uv@557e51de59eb14aaaba2ed9621916900a91d50c6 # v5
+        with:
+          enable-cache: true
+          python-version: "3.9"
+      - name: Install just
+        run: uv tool install rust-just
+      - id: setup-mongodb
+        uses: mongodb-labs/drivers-evergreen-tools@master
+        with:
+          version: "8.0"
+      - name: Install dependencies
+        run: just install
+      - name: Run tests
+        run:  |
+          just integration-tests
+
   make_sdist:
     runs-on: ubuntu-latest
     name: "Make an sdist"

CONTRIBUTING.md

@@ -413,6 +413,12 @@ a use the ticket number as the "reason" parameter to the decorator, e.g. `@flaky
 When running tests locally (not in CI), the `flaky` decorator will be disabled unless `ENABLE_FLAKY` is set.
 To disable the `flaky` decorator in CI, you can use `evergreen patch --param DISABLE_FLAKY=1`.
 
+## Integration Tests
+
+The `integration_tests` directory has a set of scripts that verify the usage of PyMongo with downstream packages or frameworks.  See the [README](./integration_tests/README.md) for more information.
+
+To run the tests, use `just integration_tests`.
+
 ## Specification Tests
 
 The MongoDB [specifications repository](https://github.com/mongodb/specifications)

integration_tests/README.md

@@ -0,0 +1,19 @@
+# Integration Tests
+
+A set of tests that verify the usage of PyMongo with downstream packages or frameworks.
+
+Each test uses [PEP 723 inline metadata](https://packaging.python.org/en/latest/specifications/inline-script-metadata/) and can be run using `pipx` or `uv`.
+
+The `run.sh` convenience script can be used to run all of the files using `uv`.
+
+When creating a new script, use the following snippet to ensure that the local version of PyMongo is used:
+
+
+```python
+# Use pymongo from parent directory.
+import sys
+from pathlib import Path
+
+root = Path(__file__).parent.parent
+sys.path.insert(0, str(root))
+```

integration_tests/run.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# Run all of the integration test files using `uv run`.
+set -eu
+
+HERE=$(dirname ${BASH_SOURCE:-$0})
+pushd "$HERE" > /dev/null
+trap 'popd' ERR
+
+for file in test_*.py ; do
+    echo "-----------------"
+    echo "Running $file..."
+    uv run $file
+    echo "Running $file...done."
+    echo "-----------------"
+done
+
+popd

tools/test_uv_loop.py renamed to integration_tests/test_uv_loop.py

@@ -2,7 +2,7 @@
 # dependencies = [
 #   "uvloop>=0.18"
 # ]
-# requires-python = ">=3.11"
+# requires-python = ">=3.10"
 # ///
 from __future__ import annotations
 
@@ -20,7 +20,8 @@
 
 async def main():
     client = AsyncMongoClient()
-    print(await client.admin.command("ping"))
+    result = await client.admin.command("ping")
+    assert result["ok"]
 
 
 uvloop.run(main())

justfile

@@ -73,6 +73,10 @@ setup-tests *args="":
 teardown-tests:
     bash .evergreen/scripts/teardown-tests.sh
 
+[group('test')]
+integration-tests:
+    UV_FROZEN="0" bash integration_tests/run.sh
+
 [group('server')]
 run-server *args="":
     bash .evergreen/scripts/run-server.sh {{args}}