pyaud

Framework for writing Python package audits

The pyaud framework is designed for writing modular audits for Python packages

Audits can be run to fail, such as when using CI, or include a fix

Fixes can be written for whole directories or individual files

Plugins can be written for manipulating files

Supports single script plugins

Installation

$ pip install pyaud

Usage

Commandline

usage: pyaud [-h] [-v] [-f] [-n] [-s] [--audit LIST] [--exclude EXCLUDE] MODULE

positional arguments:
  MODULE             choice of module: [modules] to list all

optional arguments:
  -h, --help         show this help message and exit
  -v, --version      show program's version number and exit
  -f, --fix          suppress and fix all fixable issues
  -n, --no-cache     disable file caching
  -s, --suppress     continue without stopping for errors
  --audit LIST       comma separated list of plugins for audit
  --exclude EXCLUDE  regex of paths to ignore

Plugins

pyaud will search for a plugins package in the project root

To register a plugin package ensure it is importable and prefix the package with pyaud_

The name pyaud_plugins is reserved and will be automatically imported

To view available plugins see pyaud-plugins README or run pyaud modules all

For writing plugins see docs

Configure

Configuration values are declared in the pyproject.toml file

[tool.pyaud]
audit = [
  "commit-policy",
  "const",
  "docs",
  "files",
  "format",
  "format-docs",
  "format-str",
  "imports",
  "lint",
  "params",
  "test",
  "typecheck",
  "unused"
]
exclude = '''
(?x)^(
  | docs\/conf\.py
  | whitelist\.py
)$
'''

Metadata

Release files for pyaud 8.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyaud 8.0.0
File	Size	Uploaded
pyaud-8.0.0.tar.gz	13.2 kB	Aug 1, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for pyaud 8.0.0
File	Interpreter	ABI	Platform	Reset
pyaud-8.0.0-py3-none-any.whl 15.4 kB Aug 1, 2025	Python 3	none	any	Details

Total release size: 28.7 kB

Release files / pyaud-8.0.0.tar.gz

Download URL	pyaud-8.0.0.tar.gz
Size	13.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`0482f9455be5f8ae37e82b101584cdd4dd499f82d40cf8f35dc21f8761dfd11e`
BLAKE2b-256 checksum How to use checksums	`f1e699c6c398fce8fdca9d5fefe005b801179b26eeef5a7f236de84c20d38d3c`
Upload date	Aug 1, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.1 CPython/3.13.3 Darwin/24.5.0`

Release files / pyaud-8.0.0-py3-none-any.whl

Download URL	pyaud-8.0.0-py3-none-any.whl
Size	15.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`806cde9b138b89a0768f6fdc3ca8d18ae04ac887dfb81eb5474e5b84038cf0da`
BLAKE2b-256 checksum How to use checksums	`099ec999fe0d8e46996c29cf501a5403dbd7d0c144eccca79206188a5fae734b`
Upload date	Aug 1, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.1 CPython/3.13.3 Darwin/24.5.0`