跳转到主要内容

与Encapsia系统通信的客户端API。

项目描述

Encapsia API库

Workflows PyPI pre-commit PyPI - Python Version

Known Vulnerabilities

用于与Encapsia一起工作的REST API。

安装

pip安装encapsia-api

贡献

encapsia-api是一个由poetry管理的python包。您需要Python 3.8或更高版本。要开始,在检出此存储库后,运行

poetry install

代码样式

此项目中的代码应使用black自动格式化,并遵循isort-like导入,同时应通过linting和检查。您可以手动运行以下命令,或将工具集成到您的开发环境中,但也可以参考下一节。

poetry run black .
poetry run ruff check .
poetry run mypy .

Ruff可以修复它发现的一些问题。例如,它可以修复模块导入的样式,但还可以做更多。可以通过运行

poetry run ruff check --fix .

但是,请确保检查它执行的所有修复!

版本控制

此项目的发布分支是master,功能分支应通过pull请求合并到其中。

该仓库使用 pre-commit 来运行各种检查,通过 git 预提交钩子。要开始使用,请运行

pre-commit install

之后,配置的检查会在您提交更改之前运行。您也可以显式地运行它们以检查所有文件

pre-commit run -a

版本控制

encapsia-api 遵循 语义版本控制

要更改版本,请运行

poetry version <specifier>   # e.g. patch

或在 pyproject.toml 中编辑版本字符串。在任何情况下,都要更新以下文件以匹配新版本:encapsia_api/__init__.py

请注意,我们目前还处于 <1.0.0 的阶段,因此版本变更不是非常严格,并且在 1.0.0 之前可能仍然会发生向后不兼容的更改。

构建

通过运行以下命令手动构建:

poetry build

更新依赖关系

这是通过以下方式实现的:

poetry update
poetry lock
poetry export -f requirements.txt > requirements.txt

如何运行测试

运行

poetry run pytest

持续集成

本项目使用 Github Actions 在提交到或针对主分支的拉取请求中进行代码风格检查、检查和运行测试。

项目详情


下载文件

下载适合您平台的应用程序。如果您不确定选择哪个,请了解更多关于 安装软件包 的信息。

源代码分发

encapsia_api-0.4.8.tar.gz (24.2 kB 查看哈希值)

上传时间 源代码

构建分发

encapsia_api-0.4.8-py3-none-any.whl (26.7 kB 查看哈希值)

上传时间 Python 3

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面