chore: add tox and fix tests for py3.9

.gitignore

@@ -9,6 +9,7 @@
 .pdm-build/
 .pdm-python
 .pdm.toml
+.tox/
 .venv/
 .vscode/
 __pycache__/

README.md

@@ -8,7 +8,8 @@
 
 AI powered Git repository analysis and reporting.
 
-This project is currently in its infancy. The readme will be updated to include more information as the project progresses.
+This project is currently in its infancy. The readme will be updated to include more information as the project
+progresses.
 
 If you find what you are seeing intriguing, go ahead and ⭐️ the repository to show your support.
 
@@ -17,7 +18,7 @@ If you find what you are seeing intriguing, go ahead and ⭐️ the repository t
 ### Prerequisites
 
 - A compatible python version. It's recommended to use [pyenv](https://github.com/pyenv/pyenv) to manage
-python versions.
+  python versions.
 - [pdm](https://github.com/pdm-project/pdm) installed.
 - [pre-commit](https://pre-commit.com) installed.
 - [hatch](https://hatch.pypa.io) installed,
@@ -39,15 +40,25 @@ python versions.
 ### Linting
 
 To lint the codebase, run:
+
 ```shell
    pdm run lint
 ```
 
+Tip: You can also run the linters configured in `pyproject.toml` inside your IDE of choice.
+
 ### Testing
 
 To run the tests, run:
+
 ```shell
    pdm run test
 ```
 
-Tip: You can also run the linters configured in `pyproject.toml` inside your IDE of choice.
+#### Tox
+
+To run the tests with `tox`, run:
+
+```shell
+   pdm run tox
+```

gitmind/prompts/grade_commit.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Final, Literal, TypedDict
+from typing import TYPE_CHECKING, Final, Literal, TypedDict, Union
 
 from typing_extensions import override
 
@@ -16,7 +16,7 @@
 class CommitGradingResult(TypedDict):
     """DTO for grading results."""
 
-    grade: int | Literal["NOT_EVALUATED"]
+    grade: Union[int, Literal["NOT_EVALUATED"]]  # noqa: UP007
     """The grade for the commit."""
     reason: str
     """The reason for the grade."""

pyproject.toml

@@ -86,6 +86,7 @@ dev = [
     "polyfactory>=2.16.0",
     "pytest-logger>=1.1.1",
     "types-pygit2>=1.15.0.20240714",
+    "tox>=4.16.0",
 ]
 
 [tool.pdm.scripts]

tests/caching/file_test.py

@@ -95,10 +95,10 @@ def test_get_or_create_cache_dir_with_non_existing_cache_dir(non_existing_cache_
     assert non_existing_cache_dir.exists()
 
 
-def test_get_or_create_cache_dir_with_none(default_cache_dir: SyncPath) -> None:
+async def test_get_or_create_cache_dir_with_none(default_cache_dir: SyncPath) -> None:
     path = get_or_create_cache_dir(None)
     assert path == default_cache_dir
-    assert path.exists()
+    assert await path.exists()
 
 
 def test_is_idempotent() -> None:

tests/prompts/describe_commit_test.py

@@ -1,14 +1,20 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
 import pytest
 
 from gitmind.exceptions import LLMClientError
 from gitmind.llm.base import RetryConfig
 from gitmind.prompts import DescribeCommitHandler
 from gitmind.prompts.describe_commit import CommitDescriptionResult
-from gitmind.utils.commit import CommitMetadata, CommitStatistics
 from gitmind.utils.serialization import deserialize
 from tests.data_fixtures import describe_commit_response
 from tests.helpers import create_mock_client
 
+if TYPE_CHECKING:
+    from gitmind.utils.commit import CommitMetadata, CommitStatistics
+
 
 async def test_describe_commit_contents_success_path(commit_data: tuple[CommitStatistics, CommitMetadata, str]) -> None:
     mock_client = create_mock_client(return_value=describe_commit_response)

tests/prompts/grade_commit_test.py

@@ -1,14 +1,20 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
 import pytest
 
 from gitmind.exceptions import LLMClientError
 from gitmind.llm.base import RetryConfig
 from gitmind.prompts import GradeCommitHandler
 from gitmind.prompts.grade_commit import CommitGradingResult
 from gitmind.rules import DEFAULT_GRADING_RULES
-from gitmind.utils.commit import CommitMetadata, CommitStatistics
 from tests.data_fixtures import grade_commit_response
 from tests.helpers import create_mock_client
 
+if TYPE_CHECKING:
+    from gitmind.utils.commit import CommitMetadata, CommitStatistics
+
 
 async def test_grade_commit_success_path(commit_data: tuple[CommitStatistics, CommitMetadata, str]) -> None:
     mock_client = create_mock_client(return_value=grade_commit_response)

tox.ini

@@ -0,0 +1,10 @@
+[tox]
+env_list = py{39,310,311,312}
+
+[testenv]
+setenv =
+    PDM_IGNORE_SAVED_PYTHON="1"
+deps = pdm
+commands =
+    pdm install
+    pytest tests