Style: go to pyproject.toml (#53)

* style(pyproject.toml): regroup configuration in pyproject.toml

* style(pyproject.toml): regroup configuration in pyproject.toml

* docs(mkdocs): setup mkdocs and switch docstring style

* style(documentation): switch to mkdocs from sphinx

* fix: working on fixing github actions pipeline

* build: bump pypy to 3.10

* docs(mkdocs): add file import via snippet

* fix: restore install.sh and see if github pipeline pass

* fix: rollback install as it changed nothing

* fix: rollback github action

* Install self in tests.yml and test PyPy 3.9 as well

* Revert pip -e invocation in tests.yml  lol

* fix: restore coveragerc

* fix: pytest declare specific dir instead of mean directory

* fix: pytest declare specific dir instead of mean directory

* fix: pytest declare specific dir instead of mean directory

---------

Co-authored-by: William Barnhart <[email protected]>

.editorconfig

@@ -10,5 +10,9 @@ insert_final_newline = true
 charset = utf-8
 end_of_line = lf
 
+[{*.yml,*.yaml}]
+indent_style = space
+indent_size = 2
+
 [Makefile]
 indent_style = tab

.github/workflows/gh-pages.yml → .github/workflows/deploy-docs.yml

@@ -8,28 +8,34 @@ on:
   release:
     types: [created]
     branches:
-      - 'master'
+      - master
 
 jobs:
   build:
-    name: "Build docs"
+    name: Build docs
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/setup-python@v4
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 0 # otherwise, you will failed to push refs to dest repo
-    - name: "Install runtime dependencies in order to get package metadata"
-      run: "scripts/install"
-    - name: "Install deps and build with Sphinx"
-      run: make docs
-    - name: "Upload artifacts"
-      uses: actions/upload-pages-artifact@v1
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+
+    - name: Install dependencies
+      run: pip install -r requirements.txt
+
+    - name: Build docs
+      run: scripts/build-docs.sh
+
+    - name: Upload artifacts
+      uses: actions/upload-pages-artifact@v3
       with:
         # Upload built docs
-        path: "./Documentation"
+        path: "./site"
   deploy:
-    name: "Deploy docs"
+    name: Deploy docs
     if: github.event_name == 'release' && github.event.action == 'published'
     needs: build
     runs-on: ubuntu-latest
@@ -42,6 +48,6 @@ jobs:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     steps:
-    - uses: actions/deploy-pages@v1
+    - uses: actions/deploy-pages@v4
       id: deployment
       name: "Deploy to GitHub Pages"

.github/workflows/publish.yml

@@ -0,0 +1,49 @@
+name: Publish Package
+
+on:
+  # Only run when release is created in the master branch
+  release:
+    types: [created]
+    branches:
+      - 'master'
+
+jobs:
+  build:
+    name: Build distributable files
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: 'Checkout source repository'
+        uses: actions/checkout@v4
+        with:
+            fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+
+      - name: Install build dependencies
+        run: pip install build twine
+
+      - name: 'Build package'
+        run: scripts/build.sh
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          path: 'dist/*'
+
+  upload_pypi:
+    name: Upload packages
+    needs: ['build']
+    runs-on: 'ubuntu-latest'
+    if: github.event_name == 'release' && github.event.action == 'created'
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: artifact
+          path: dist
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: '__token__'
+          password: '${{ secrets.PYPI_API_TOKEN }}'

.github/workflows/python-package.yml → .github/workflows/tests.yml

@@ -1,7 +1,7 @@
 # This workflow will install Python dependencies, run tests and lint with a variety of Python versions
-# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
 
-name: Run Python tests
+name: Python package
 
 on:
   push:
@@ -20,6 +20,7 @@ jobs:
       matrix:
         python-version:
           - "pypy3.9"
+          - "pypy3.10"
           - "3.8"
           - "3.9"
           - "3.10"
@@ -39,16 +40,21 @@ jobs:
           python-version: "${{ matrix.python-version }}"
           cache: "pip"
           cache-dependency-path: |
-            requirements/*.txt
-            requirements/**/*.txt
-      - name: "Install dependencies"
-        run: "scripts/install"
-      - name: "Run linting checks"
-        run: "scripts/check"
-      - name: "Run tests"
-        run: "scripts/tests"
-      - name: "Enforce coverage"
-        uses: codecov/codecov-action@v3
+            requirements-docs.txt
+            requirements-tests.txt
+            pyproject.toml
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Run linting checks
+        run: scripts/lint.sh
+
+      - name: Run tests
+        run: scripts/tests.sh
+
+      - name: Enforce coverage
+        uses: codecov/codecov-action@v4
         with:
             token: ${{ secrets.CODECOV_TOKEN }}
 

.gitignore

@@ -84,6 +84,7 @@ Session.vim
 tags
 .pytest_cache/
 .ipython/
+.ruff_cache/
 
 ### PyCharm
 .idea

.pre-commit-config.yaml

@@ -9,7 +9,10 @@ repos:
       - id: check-yaml
       - id: check-toml
       - id: check-added-large-files
-
+  - repo: https://github.com/commitizen-tools/commitizen
+    rev: v3.18.0
+    hooks:
+      - id: commitizen
   - repo: https://github.com/charliermarsh/ruff-pre-commit
     rev: v0.3.0
     hooks:

CHANGELOG.md

@@ -0,0 +1,4 @@
+
+## v0.2.0 (2024-03-02)
+
+## 0.1.0 (2023-01-10)

CODE_OF_CONDUCT.rst → CODE_OF_CONDUCT.md

@@ -1,5 +1,4 @@
-Code of Conduct
-===============
+# Code of Conduct
 
 Everyone interacting in the project's codebases, issue trackers, chat rooms,
 and mailing lists is expected to follow the Mode Code of Conduct.