docs: adding uv testing

Author: xmlking

docs/SUMMARY.md

@@ -28,6 +28,7 @@
   - [GoLang](platforms/go/golang.md)
   - [Rust](platforms/rust/rust.md)
   - [Python](platforms/python/uv.md)
+    - [Testing](platforms/python/testing.md)
     - [Agno AI](platforms/python/agno.md)
 - DevOps
   - [Development Workflow](devops/devflow/development-workflow.md)

docs/platforms/python/testing.md

@@ -0,0 +1,145 @@
+# testing
+
+Setting up testing with pytest and uv
+
+## Creating a Project with Tests
+
+```shell
+uv init myapp --package
+d myapp
+```
+
+This creates a Python package project with the following structure:
+
+```
+myapp/
+├── pyproject.toml
+├── README.md
+└── src
+    └── myapp
+        └── __init__.py
+```
+
+## Adding pytest as a Development Dependency
+
+Add pytest to your project’s development dependencies:
+
+```shell
+uv add --dev pytest
+```
+
+This command:
+
+- Updates your `pyproject.toml` with pytest as a development dependency
+- Create the project’s lockfile
+- Installs pytest in your project’s virtual environment
+
+## Creating a Simple Module to Test
+
+Let’s create a simple calculator module to test.
+Create a new file at `src/myapp/calculator.py`:
+
+```python
+def add(a, b):
+    return a + b
+
+
+def subtract(a, b):
+    return a - b
+
+
+def multiply(a, b):
+    return a * b
+
+
+def divide(a, b):
+    if b == 0:
+        raise ValueError("Cannot divide by zero")
+    return a / b
+```
+
+## Creating Test Files
+
+Create a `tests` directory at the root of your project
+
+Now, create a test file for our calculator module in tests/test_calculator.py:
+
+```python
+import pytest
+from myapp.calculator import add, subtract, multiply, divide
+
+
+def test_add():
+    assert add(1, 2) == 3
+    assert add(-1, 1) == 0
+    assert add(-1, -1) == -2
+
+
+def test_subtract():
+    assert subtract(3, 2) == 1
+    assert subtract(2, 3) == -1
+    assert subtract(0, 0) == 0
+
+
+def test_multiply():
+    assert multiply(2, 3) == 6
+    assert multiply(-2, 3) == -6
+    assert multiply(-2, -3) == 6
+
+
+def test_divide():
+    assert divide(6, 3) == 2
+    assert divide(6, -3) == -2
+    assert divide(-6, -3) == 2
+
+
+def test_divide_by_zero():
+    with pytest.raises(ValueError):
+        divide(5, 0)
+```
+
+## Configuring pytest
+
+Let’s configure pytest in your pyproject.toml file by adding these settings:
+
+```yml
+[tool.pytest.ini_options]
+log_cli = true
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_functions = "test_*"
+addopts = ["-v", "--strict-markers"]
+pythonpath = ["."]
+```
+
+This configuration:
+
+- Sets the test discovery path to the `tests` directory
+- Specifies that test files should start with `test_`
+- Specifies that test functions should start with `test_`
+
+## Running Tests
+
+Now you can run your tests using uv:
+
+```shell
+uv run pytest
+```
+
+To see more detailed output, use the verbose flag:
+
+```shell
+uv run pytest --cov=testing_demo
+```
+
+For a more detailed report:
+
+```shell
+uv run pytest --cov=testing_demo --cov-report=term-missing
+```
+
+To test a specific test case in a test file
+
+```shell
+uv run pytest tests/integration/agent/test_basic.py::test_basic
+```

docs/platforms/python/uv.md

@@ -397,6 +397,7 @@ uv cache prune
 * How to Learn Python From Scratch in 2025: [An Expert Guide](https://www.datacamp.com/blog/how-to-learn-python-expert-guide)
 * UV [features](https://github.com/astral-sh/uv/blob/main/docs/getting-started/features.md)
 * UV [Working on projects](https://docs.astral.sh/uv/guides/projects/)
+* UV [Python Developer Tooling Handbook](https://pydevtools.com/handbook/)
 * Beyond Hypermodern: [Python is easy now](https://rdrn.me/postmodern-python/)
 * Python UV: [The Ultimate Guide to the Fastest Python Package Manager](https://www.datacamp.com/tutorial/python-uv)
 * [Writing your pyproject.toml](https://packaging.python.org/en/latest/guides/writing-pyproject-toml/)