Skip to main content

Client API for talking to an Encapsia system.

Project description

Encapsia API Library

Workflows PyPI pre-commit PyPI - Python Version

Known Vulnerabilities

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.

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

encapsia_api-0.4.6.tar.gz (24.4 kB view details)

Uploaded Source

Built Distribution

encapsia_api-0.4.6-py3-none-any.whl (26.7 kB view details)

Uploaded Python 3

File details

Details for the file encapsia_api-0.4.6.tar.gz.

File metadata

  • Download URL: encapsia_api-0.4.6.tar.gz
  • Upload date:
  • Size: 24.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.11.8 Linux/6.5.0-26-generic

File hashes

Hashes for encapsia_api-0.4.6.tar.gz
Algorithm Hash digest
SHA256 42590d50a35e06c0ec2071f67895e7ebcdfb8d6cc704f6502a11c20e8f9d7cf8
MD5 a5da295b2ec03d128c3d504859f345be
BLAKE2b-256 c3ec036a83dcfbf3cac9736e757e6816cb3bd44cf8e6a7666d7d96c2c6c816ec

See more details on using hashes here.

File details

Details for the file encapsia_api-0.4.6-py3-none-any.whl.

File metadata

  • Download URL: encapsia_api-0.4.6-py3-none-any.whl
  • Upload date:
  • Size: 26.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.11.8 Linux/6.5.0-26-generic

File hashes

Hashes for encapsia_api-0.4.6-py3-none-any.whl
Algorithm Hash digest
SHA256 d395cc57ea53ba447b6337203cd124e827fcebfa4ed3ef690981e2fc1acf71f4
MD5 d2fbac8ec5268a115762e1a5a1d67967
BLAKE2b-256 4e6424e082a2188290de493273b23b4c2267a5460d3bad42b6600d1069b6f443

See more details on using hashes here.

Supported by

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