The Rubin Observatory SQuaRE framework for FastAPI services.
Project description
Safir
Safir is Rubin Observatory's library for building FastAPI services for the Rubin Science Platform (Phalanx) and Roundtable Kubernetes clusters. Safir is developed, maintained, and field tested by the SQuaRE team.
Safir is available from PyPI:
pip install safir
The best way to create a new FastAPI/Safir service is with the fastapi_safir_app template.
Read more about Safir at https://safir.lsst.io.
Features
- Set up an
httpx.AsyncClientas part of the application start-up and shutdown lifecycle. - Set up structlog-based logging.
- Middleware for attaching request context to the logger to include a request UUID, method, and route in all log messages.
- Process
X-Forwarded-*headers to determine the source IP and related information of the request. - Gather and structure standard metadata about your application.
- Operate a distributed Redis job queue with arq using convenient clients, testing mocks, and a FastAPI dependency.
Developing Safir
The best way to start contributing to Safir is by cloning this repository creating a virtual environment, and running the init command:
git clone https://github.com/lsst-sqre/safir.git
cd safir
make init
For details, see https://safir.lsst.io/dev/development.html.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file safir-5.2.2.tar.gz.
File metadata
- Download URL: safir-5.2.2.tar.gz
- Upload date:
- Size: 164.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.0.0 CPython/3.12.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e6ad2553e60d1b74bfdbb47bda83776843bb74c3599760b66391253bb0bd4ddb |
|
| MD5 | 18b39be642452eb69ba32ac85dc8a5b0 |
|
| BLAKE2b-256 | aa220df4bb94b55b1c381b81f1fbfd1667b0b26b0f7fd9e8294b69badfc1ab57 |
File details
Details for the file safir-5.2.2-py3-none-any.whl.
File metadata
- Download URL: safir-5.2.2-py3-none-any.whl
- Upload date:
- Size: 74.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.0.0 CPython/3.12.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 13069fb1413443be3685e337ce54f25fc427a86ff718c1e3ca44daaaf5c03d34 |
|
| MD5 | 54a813d85bd30aebcebc7121145213ab |
|
| BLAKE2b-256 | 5fac7e9f4b595e0f54410d2a32c42907b93961d62e505eb45597af39d03f9016 |
