Using uv

Author: MrMatAP

.idea/copyright/profiles_settings.xml

@@ -6,20 +6,27 @@ Boilerplate (and playground) for a code-first Python FastAPI API.
 
 ## How to build this
 
-Create a virtual environment, then:
+### Interactively
 
-```shell
-(venv) $ pip install -r requirements.txt
-(venv) $ python -m build -n --wheel
-```
+The project uses the [uv build tool](https://docs.astral.sh/uv/). Install it first, then simply run `uv build --wheel`.
 
-If you intend to run the testsuite or work on the code, then also install the requirements from `requirements.dev.txt`. You can run the testsuite using
+All interactive builds default their version to '0.0.0.dev0', which we use as a marker that this is a locally produced
+build which should not go into production. You can override this behaviour by setting the 'MRMAT_VERSION' environment
+variable to the desired version, but doing so is discouraged.
 
-```shell
-(venv) $ PYTHONPATH=src pytest tests
-```
+### Continuous Integration
+
+GitHub Actions will trigger builds for pushes and pull requests. A merge push onto the main branch will additionally
+create a release.
+
+All builds on branches other than main will have their version calculated from the MAJOR, MINOR and GITHUB_RUN_NUMBER
+environment variables with a '.dev0' suffix appended. You can set the MAJOR and MINOR variables in
+`.github/workflows/build.yml`. Builds resulting from a merge push onto the main branch will not have a suffix.
+
+The resulting code is aware of its version at build-time via the extra `src/ci` module, which is explicitly excluded from
+the distribution. Pythons own `importlib.metadata` is then used to make the version available at runtime.
 
-The resulting wheel is installable and knows its runtime dependencies. Any locally produced wheel will have version 0.0.0.dev0. This is intentional to distinguish local versions from those that are produced as releases in GitHub. You can override this behaviour by setting the `MRMAT_VERSION` environment variable to the desired version.
+### Container Image
 
 You can produce a container image and associated Helm chart using the provided Makefile:
 

.idea/encodings.xml

@@ -1,6 +1,7 @@
 [build-system]
 requires = [
-    'setuptools==78.1.1',
+    'setuptools==80.9.0',
+    'build==1.3.0',
     'wheel==0.45.1'
 ]
 build-backend = 'setuptools.build_meta'
@@ -23,12 +24,47 @@ classifiers = [
     "Programming Language :: Python :: 3.13"
 ]
 requires-python = ">=3.13"
-dynamic = ["version", "dependencies", "optional-dependencies"]
+dynamic = ["version"]
+dependencies = [
+    "fastapi[standard]==0.119.0",
+    "sqlalchemy[asyncio]==2.0.44",
+    "uvicorn==0.37.0",
+    "pydantic==2.12.2",
+    "psycopg2-binary==2.9.11",
+    "prometheus-fastapi-instrumentator==7.1.0",
+    "opentelemetry-distro",
+    "opentelemetry-exporter-otlp==1.38.0",
+    "opentelemetry-instrumentation-asyncio==0.59b0",
+    "opentelemetry-instrumentation-dbapi==0.59b0",
+    "opentelemetry-instrumentation-logging==0.59b0",
+    "opentelemetry-instrumentation-sqlite3==0.59b0",
+    "opentelemetry-instrumentation-threading==0.59b0",
+    "opentelemetry-instrumentation-urllib==0.59b0",
+    "opentelemetry-instrumentation-wsgi==0.59b0",
+    "opentelemetry-instrumentation-asgi==0.59b0",
+    "opentelemetry-instrumentation-click==0.59b0",
+    "opentelemetry-instrumentation-fastapi==0.59b0",
+    "opentelemetry-instrumentation-grpc==0.59b0",
+    "opentelemetry-instrumentation-httpx==0.59b0",
+    "opentelemetry-instrumentation-requests==0.59b0",
+    "opentelemetry-instrumentation-sqlalchemy==0.59b0",
+    "opentelemetry-instrumentation-starlette==0.59b0",
+    "opentelemetry-instrumentation-tortoiseorm==0.59b0",
+    "opentelemetry-instrumentation-urllib3==0.59b0",
+    "types-pyyaml==6.0.12.20250915",
+]
+[dependency-groups]
+dev = [
+    "pytest==8.4.2",
+    "pytest-cov==7.0.0",
+    "mypy==1.18.2",
+    "types-PyYAML==6.0.12.20250915",
+    "httpx==0.28.1",
+    "black>=25.9.0",
+]
 
 [tool.setuptools.dynamic]
 version = { attr = "ci.version"}
-dependencies = {file = ["requirements.txt"]}
-optional-dependencies = { dev = {file = ["requirements.dev.txt"] } }
 
 [tool.setuptools.packages.find]
 where = ["src"]