apdev (Python)
General-purpose development tools for Python projects.
Installation
pip install apdev
For development:
pip install apdev[dev]
Tools
check-chars
Validate that files contain only allowed characters (ASCII, common emoji, and technical symbols like arrows and box-drawing characters).
# Check default project directories (src/, tests/, examples/) and config files
apdev check-chars
# Check a directory recursively
apdev check-chars src/
# Check specific files
apdev check-chars src/mypackage/*.py
# Enable extra charset (e.g. Chinese characters)
apdev check-chars --charset chinese src/
Options:
--charset <name>— Enable a built-in charset preset (repeatable, e.g.chinese)--charset-file <path>— Load a custom charset JSON file (repeatable)- Environment variable
APDEV_EXTRA_CHARS— Comma-separated list of charset names or file paths, used when no--charset/--charset-fileis given
check-imports
Detect circular imports in a Python package.
# Specify package explicitly
apdev check-imports --package mypackage --src-dir src
# Or configure in pyproject.toml (see Configuration below)
apdev check-imports
release
Interactive release automation for publishing Python packages to PyPI and GitHub. Auto-detects project name from pyproject.toml and GitHub repo from git remote.
From the project root, apdev release uses the project's .venv automatically when no virtual environment is active. Install build, pip, and twine in the environment used for release.
# Run with auto-detected version from pyproject.toml
apdev release
# Or specify version explicitly
apdev release 0.2.0
The command provides an interactive menu with steps:
- Version verification (checks
pyproject.tomland__init__.pymatch) - Status check (tag, build files, PyPI)
- Clean build files
- Build package (
python -m build) - Check package (
twine check) - Create git tag and push
- Create GitHub release (via
ghCLI or API) - Upload to PyPI (
twine upload)
Override auto-detection with environment variables:
PROJECT_NAME=mypackage GITHUB_REPO=owner/repo apdev release
Configuration
Add to your project's pyproject.toml so commands can run without CLI arguments:
[tool.apdev]
base_package = "mypackage" # Required by check-imports
src_dir = "src" # Source directory (default: "src")
With this config, both commands work out of the box:
apdev check-chars # Checks default project directories and config files
apdev check-imports # Reads base_package / src_dir from pyproject.toml
Pre-commit Integration
repos:
- repo: https://github.com/aiperceivable/apdev
rev: python/v0.1.0
hooks:
- id: check-chars
- id: check-imports
Or use as a local hook with the pip-installed package:
repos:
- repo: local
hooks:
- id: check-chars
name: apdev check-chars
entry: apdev check-chars
language: system
types_or: [text, python]
- id: check-imports
name: apdev check-imports
entry: apdev check-imports
language: system
pass_filenames: false
always_run: true
License
Apache-2.0
Metadata
Release files for apdev 0.2.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| apdev-0.2.5.tar.gz | 26.4 kB | Without provenance | Details for apdev-0.2.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| apdev-0.2.5-py3-none-any.whl | Python 3 | none | any | Details for apdev-0.2.5-py3-none-any.whl |
Total release size: 47.7 kB
Release files / apdev-0.2.5.tar.gz
| Download URL | apdev-0.2.5.tar.gz |
|---|---|
| Size | 26.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
93abdce50b6f1b7184d3fe0706bb5980042098041ae02188f9d7504aeb4d7aa1
|
|
BLAKE2b-256 checksum How to use checksums |
53a493a78769148f93c9efcfd83e6654f04ba8041aecf9f50ec808c587a8fc60
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.16
|
Release files / apdev-0.2.5-py3-none-any.whl
| Download URL | apdev-0.2.5-py3-none-any.whl |
|---|---|
| Size | 21.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2844f31fdf3609914a3adc991ff0a6e6bbfc39ee4ee0dbe58ac8b7d430f82817
|
|
BLAKE2b-256 checksum How to use checksums |
75cb2187560a14a55c7df05dccb7112b677f2a7d2cba15ba82b6d639010a8946
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.16
|
Security for apdev 0.2.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.