oryn 1.0

A PEP 517-compliant build backend for Python projects

Oryn

Oryn is a PEP 517-compliant build backend for Python projects.

For now, Oryn only supports pure Python wheels and just recursively copies files from the project root into the wheel, making sure to ignore certain files. It also copies the appropriate metadata from pyproject.toml into the wheel's metadata.

Oryn requires Python 3.13 or later.

Usage

Add the following to your pyproject.toml:

[build-system]
requires = ["oryn~=1.0"]
build-backend = "oryn"

[tool.oryn]
# 1. Add inclusion roots
# Only the last part of the path is retained in the wheel. Paths are relative
# to the project root despite the absence of a leading slash.

# For a src layout
include = ["src/foo/"]
include = ["src/*/"]

# For a flat layout
include = ["foo/"]

# 2. Add ignored files, using patterns similar to .gitignore.
ignore = [
  "*.pyc",
]

# 3. Optionally reuse existing .gitignore rules.
use-gitignore = true

The following files are ignored by default:

• __pycache__/
• .DS_Store
• .git/
• .gitignore
• .venv/
• *.egg-info/

To show which files will be included, install Oryn and run python -m oryn.