Metadata-Version: 2.4
Name: oryn
Version: 1.0
Summary: A PEP 517-compliant build backend for Python projects
Requires-Python: >=3.13
Description-Content-Type: text/markdown
Requires-Dist: editables==0.5
Requires-Dist: packaging==25.0

# 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`:

```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`.

