Skip to main content

An implementation of LabThings using FastAPI

Project description

codecov Documentation Status

labthings-fastapi

A FastAPI based library to implement a Web of Things interface for laboratory hardware using Python. This is a ground-up rewrite of python-labthings, based on FastAPI and Pydantic. It is the underlying framework for v3 of the OpenFlexure Microscope software.

Documentation, including install instructions, is available on readthedocs.

Installation

See readthedocs for installation instructions that are automatically tested. You can install this package with pip install labthings-fastapi.

Developer notes

For the latest development version, clone this repository and run pip install -e .[dev].

The code is linted with ruff ., type checked with mypy, and tested with pytest. These all run in CI with GitHub Actions. We recommend a pre-commit hook to ensure ruff passes on every commit. flake8 is also run in CI, primarily to enable stricter checks on docstrings. It is run as flake8 src. ruff and flake8 are both configured from pyproject.toml.

All changes to the codebase should go via pull requests, and should only be merged once all the checks in the test job are passing. It is preferable to merge code where the test-with-unpinned-dependencies job fails, and deal with the dependency issues in another PR, particularly where the required changes are distinct from the code in the PR.

Dependencies are defined in pyproject.toml and can be compiled to dev-requirements.txt with:

uv pip compile --extra dev pyproject.toml --output-file dev-requirements.txt

If you're not using uv, just regular pip-compile from pip-tools should do the same thing.

Demo

See readthedocs for a runnable demo.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

labthings_fastapi-0.1.0.tar.gz (117.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

labthings_fastapi-0.1.0-py3-none-any.whl (137.5 kB view details)

Uploaded Python 3

File details

Details for the file labthings_fastapi-0.1.0.tar.gz.

File metadata

  • Download URL: labthings_fastapi-0.1.0.tar.gz
  • Upload date:
  • Size: 117.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for labthings_fastapi-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f92fbb02c08862b18242bb16c406ba06612ddae07414da59f61b657262886c79
MD5 ac17d3025b56ef7b6a5c37dcf53ccc96
BLAKE2b-256 9a751328c911a7ead4d252cb8da6bcdfd73ea985f9e48c7e35873f0fea09c0de

See more details on using hashes here.

Provenance

The following attestation bundles were made for labthings_fastapi-0.1.0.tar.gz:

Publisher: publish.yml on labthings/labthings-fastapi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file labthings_fastapi-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for labthings_fastapi-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 52ea4d873f9273bfed40b272244147691913ae24dbe00dc7fa4373c16bed24f1
MD5 69616bbbabdf86a3d4e84a1928a5c105
BLAKE2b-256 116dec47e0ff2122cc8b266f5e09786c2b23875915ff1e63ea7f8a45000e7fb4

See more details on using hashes here.

Provenance

The following attestation bundles were made for labthings_fastapi-0.1.0-py3-none-any.whl:

Publisher: publish.yml on labthings/labthings-fastapi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page