Encapsia API Library
REST API for working with Encapsia.
Installation
pip install encapsia-api
Contributing
encapsia-api is a python package managed with poetry.
You will need python 3.8 or newer. To get started, after checking out this repository,
run:
poetry install
Code Style
Code in this project should be auto-formatted using black and adhere to isort-like
imports, and should pass linting and checks. You can run the following commands
manually, or integrate the tooling in your dev environment, but see also the next
section.
poetry run black .
poetry run ruff check .
poetry run mypy .
Ruff can fix some of the issues it finds. For example, it can fix the style of importing modules, but it can do much more. This can be done with running:
poetry run ruff check --fix .
However, please make sure you check the fixes it performs!
Revision Control
The release branch for this project is master and feature branches should be merged
into it via pull requests.
This repository uses pre-commit to run various checks with
git pre-commit hooks. To get started, run:
pre-commit install
After this, configured checks are run before you commit changes. You can also run them explicitly for all files:
pre-commit run -a
Versioning
encapsia-api adheres to Semantic Versioning.
To change the version, run:
poetry version <specifier> # e.g. patch
or edit the version string in pyproject.toml. In any case, update the following file
to match the new version: encapsia_api/__init__.py.
Note that we are yet in <1.0.0 land and thus version changes are not too strict and
backward-incompatible changes may still occur before 1.0.0.
Building
Manually build by running:
poetry build
Updating Dependencies
This is achieved with:
poetry update
poetry lock
poetry export -f requirements.txt > requirements.txt
How to Run Tests
Run:
poetry run pytest
Continuous Integration
This project uses Github Actions to for linting, checking, and running the tests on commit to or pull requests targeting the main branch.
Release files for encapsia-api 0.4.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| encapsia_api-0.4.8.tar.gz | 24.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| encapsia_api-0.4.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 51.0 kB
Release files / encapsia_api-0.4.8.tar.gz
| Download URL | encapsia_api-0.4.8.tar.gz |
|---|---|
| Size | 24.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
34c82d83264e66e835a65e4cff16460f1d53a730f7af9f4553366b2b593fc66e
|
|
BLAKE2b-256 checksum How to use checksums |
edaa026f32436112870a91c7f3962a3d34ac192896775a607297bdfa3dd2ebef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.3 CPython/3.12.3 Linux/6.8.0-38-generic
|
Release files / encapsia_api-0.4.8-py3-none-any.whl
| Download URL | encapsia_api-0.4.8-py3-none-any.whl |
|---|---|
| Size | 26.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e068da91b7ab514f5640b58d2d883acf426802f31b7fdf7092748c9a47bbfabd
|
|
BLAKE2b-256 checksum How to use checksums |
946933cc4c9e031c5b99fbe70b91a09ecf93e62cc7446b5b06699f1269f911cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.3 CPython/3.12.3 Linux/6.8.0-38-generic
|