chore: add poetry to handle the tests of the git extras

.github/workflows/ci.yml

@@ -43,15 +43,15 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Python 3.10
+      - name: Set up Python 3.11
         uses: actions/setup-python@v4
         with:
-          python-version: '3.10'
+          python-version: '3.11'
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
           pip install pytest==7.4.0
-          pip install GitPython==3.1.36
+          pip install GitPython==3.1.40
       - name: Unit test
         run: make test
 

CONTRIBUTING.md

@@ -14,16 +14,6 @@ Your change must also be compatible with the dependency constraints that we spec
 
 If you aren't able to test your new command on a platform, make that clear in your PR; someone else may be able to test it on their system.
 
-## Testing
-
-We now have a testing suite. Run it with `make test`.
-
-It uses the following dependencies (same or later versions):
-
-- `python==3.10`
-- `pytest==7.4.0`
-- `GitPython==3.1.36`
-
 ## Adding a New Command
 
 Let's say you wish to add a new command. Assuming your new command is named `foo`:

tests/README.md

@@ -0,0 +1,32 @@
+# Test for git-extras
+The git-extras has its own testcases now, and the more is on the way! So let's introduce it.
+
+We choose python to help us to reach to other shore cause **python is life saver**.
+
+The test part depends on:
+
+* python >= 3.11
+* poetry >= 1.7.1
+* pytest >= 7.4
+* gitpython >= 3.1.40
+
+So the versions are higher than above is recommended.
+
+# How to test
+1. Install `poetry`
+2. Install the dependencies via `poetry install --no-root`
+3. Run `poetry run pytest`
+
+It is done or go without `poetry`,
+
+1. Install python >= 3.11
+2. Install pytest >= 7.4
+3. Install gitpython >= 3.1.40
+4. Run `pytest`
+
+The second way maybe blocked the some missing dependencies at someday, so the first one is recommended.
+
+# References
+* [poetry](https://github.com/python-poetry/poetry)
+* [pytest](https://github.com/pytest-dev/pytest/)
+* [git python](https://github.com/gitpython-developers/GitPython)

tests/pyproject.toml

@@ -0,0 +1,21 @@
+[tool.poetry]
+name = "git-extras-tests"
+version = "0.1.0"
+description = "tests for git extras"
+authors = ["vanpipy <[email protected]>"]
+license = "MIT"
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = "^3.11"
+pytest = "7.4"
+gitpython = "3.1.40"
+
+[tool.pytest.ini_options]
+minversion = "7.4"
+addopts = "-ra -q"
+testpaths = ["."]
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"