feat: add stapi-fastapi (#10)

Move the [stapi-fastapi](https://github.com/stapi-spec/stapi-fastapi)
into this monorepo for STAPI Python reference implementations.

1. Copied the source code from the old repository into `stapi-fastapi`.
2. Make its `pyproject.toml` ready for uv.
3. Move the `.pre-commit-config.yaml` and linter and formatter
configuration to the top `pyproject.toml`.
4. Make `pytest` work for both sub-packages.

Unfortunately, you cannot build the packages for both projects with one
execution of `uv build `.
You have to execute it like this for each sub-project: `uv build
--package stapi-fastapi`.

---------

Co-authored-by: Pete Gadomski <[email protected]>

Author: toro-berlin

.github/workflows/ci.yaml

@@ -19,15 +19,16 @@ jobs:
       - uses: astral-sh/setup-uv@v5
       - name: Sync
         run: uv sync
-      - name: Lint
-        run: scripts/lint
+      - name: Pre-Commit Hooks
+        run: uv run pre-commit run --all-files
       - name: Test
         run: uv run pytest
       - name: Docs
         run: uv run mkdocs build --strict
       - uses: actions/upload-pages-artifact@v3
         with:
           path: site/
+
   docs:
     name: Deploy docs
     runs-on: ubuntu-latest

.pre-commit-config.yaml

@@ -0,0 +1,85 @@
+repos:
+  - repo: local
+    hooks:
+
+      - id: ruff-check
+        name: Lint with ruff
+        entry: uv run ruff check --fix
+        language: system
+        types: [python]
+        pass_filenames: false
+        verbose: true
+
+      - id: ruff-format
+        name: Format with ruff
+        entry: uv run ruff format
+        language: system
+        types: [python]
+        pass_filenames: false
+        verbose: true
+
+      - id: mypy
+        name: Check typing with mypy
+        entry: uv run mypy
+        language: system
+        types: [python]
+        pass_filenames: false
+        verbose: true
+
+      - id: pymarkdown
+        name: Markdownlint
+        description: Run markdownlint on Markdown files
+        entry: uv run pymarkdown scan
+        language: system
+        files: \.(md|mdown|markdown)$
+
+      - id: check-added-large-files
+        name: Check for added large files
+        entry: uv run check-added-large-files
+        language: system
+
+      - id: check-toml
+        name: Check Toml
+        entry: uv run check-toml
+        language: system
+        types: [toml]
+
+      - id: check-yaml
+        name: Check Yaml
+        entry: uv run check-yaml
+        language: system
+        types: [yaml]
+        exclude: ^mkdocs.yml$
+
+      - id: mixed-line-ending
+        name: Check mixed line endings
+        entry: uv run mixed-line-ending
+        language: system
+        types: [text]
+        stages: [pre-commit, pre-push, manual]
+
+      - id: end-of-file-fixer
+        name: Fix End of Files
+        entry: uv run end-of-file-fixer
+        language: system
+        types: [text]
+        stages: [pre-commit, pre-push, manual]
+
+      - id: trailing-whitespace
+        name: Trim Trailing Whitespace
+        entry: uv run trailing-whitespace-fixer
+        language: system
+        types: [text]
+        stages: [pre-commit, pre-push, manual]
+
+      - id: check-merge-conflict
+        name: Check merge conflicts
+        entry: uv run check-merge-conflict
+        language: system
+
+      - id: no-commit-to-branch
+        name: Check not committting to main
+        entry: uv run no-commit-to-branch
+        language: system
+        args: ["--branch", "main"]
+        pass_filenames: false

RELEASING.md

@@ -4,8 +4,8 @@
 2. Determine the next version, following [semantic versioning](https://semver.org/)
 3. Create a release branch: `git checkout -b release/{package}-v{version}`
 4. Update that package's CHANGELOG with:
-    - A new header with the new version
-    - A new link at the bottom of the CHANGELOG for that header
+   - A new header with the new version
+   - A new link at the bottom of the CHANGELOG for that header
 5. `git push -u origin`
 6. Once approved, merge the PR
 7. `git checkout main && git pull && git tag {package}/v{version} && git push {package}/v{version}`

pyproject.toml

@@ -6,13 +6,19 @@ readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
     "stapi-pydantic",
+    "stapi-fastapi",
 ]
 
 [dependency-groups]
 dev = [
+    "pytest>=8.1.1",
+    "pytest-coverage>=0.0",
     "mypy>=1.15.0",
     "pytest>=8.3.5",
     "ruff>=0.11.2",
+    "pymarkdownlnt>=0.9.25",
+    "pre-commit>=4.2.0",
+    "pre-commit-hooks>=5.0.0",
 ]
 docs = [
     "mkdocs-material>=9.6.11",
@@ -23,11 +29,61 @@ docs = [
 default-groups = ["dev", "docs"]
 
 [tool.uv.workspace]
-members = ["stapi-pydantic"]
+members = ["stapi-pydantic", "stapi-fastapi"]
 
 [tool.uv.sources]
 stapi-pydantic.workspace = true
+stapi-fastapi.workspace = true
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.format]
+quote-style = 'double'
+
+[tool.ruff.lint]
+select = [
+    "E",  # pydocstyle error
+    "W",  # pydocstyle warning
+    "F",  # Pyflakes
+    "I",  # isort
+    "UP", # pyupgrade
+    "C9"  # mccabe complexity
+]
+
+[tool.ruff.lint.mccabe]
+max-complexity = 8  # default 10
 
 [tool.mypy]
 strict = true
-files = "stapi-pydantic/src/stapi_pydantic/**/*.py"
+files = [
+    "stapi-pydantic/src/stapi_pydantic/**/*.py",
+    "stapi-fastapi/src/stapi_fastapi/**/*.py"
+]
+
+[[tool.mypy.overrides]]
+module = "pygeofilter.parsers.*"
+ignore_missing_imports = true
+
+[tool.pymarkdown]
+plugins.md013.line_length = 120
+plugins.md024.enabled = false  # duplicate headers in changelog
+
+[tool.coverage.report]
+show_missing = true
+skip_empty = true
+sort = "Cover"
+omit = [
+    "stapi-pydantic/tests/**/*.py",
+    "stapi-fastapi/tests/**/*.py",
+]
+
+[tool.pytest.ini_options]
+addopts="--cov=stapi-pydantic/src/stapi_pydantic --cov=stapi-fastapi/src/stapi_fastapi"
+filterwarnings = [
+    "ignore:The 'app' shortcut is now deprecated.:DeprecationWarning",
+    "ignore:Pydantic serializer warnings:UserWarning",
+]
+markers = [
+    "mock_products",
+]