development.md

Development

Requirements

• Python >=3.10
• A Service Principal (again) to access Azure Applications

Local Development

# Install dependencies
pip install --user -r requirements.txt -r requirements-dev.txt

# Update dependencies
$ python -m pur -r requirements.txt -r requirements-dev.txt
All requirements up-to-date.

# Run tests
$ python -m pytest --cov
test/api/test_apps.py::test_apps PASSED

============================= 1 passed in 0.05s =============================

# Run - development mode
$ python -m uvicorn main:app --reload
INFO:     Will watch for changes in these directories: ['...azure-app-exporter/src']
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO:     Started reloader process [3272] using statreload
WARNING:  The --reload flag should not be used in production.
INFO:     Started server process [20152]
INFO:     Waiting for application startup.
INFO:     Application startup complete.

Next hit

• API: /api/openapi.json & Swagger-UI at /docs
• Metrics: /health & /metrics