pyc_wheel documentation¶

pyc_wheel¶

Compile all py files in a wheel to pyc files.

Overview¶

pyc_wheel is a strict fork of Grant Patten’s pycwheel package with a fixes allowing to work with Python3 or higher and with a code reformatting and some improvements.

PyPI record.

Documentation.

Usage¶

Processing the wheel in place:

$ python3 -m pyc_wheel your_wheel-1.0.0-py3-none-any.whl
# Output: your_wheel-1.0.0-py3-none-any.whl

or renaming for the python version:

$ python3.13 -m pyc_wheel --rename your_wheel-1.0.0-py3-none-any.whl
# Output: your_wheel-1.0.0-cp313-none-any.whl

or with backup:

$ python3.13 -m pyc_wheel --rename --with-backup your_wheel-1.0.0-py3-none-any.whl
# Output: your_wheel-1.0.0-cp313-none-any.whl
#         your_wheel-1.0.0-py3-none-any.whl.bak

or with quiet:

$ python3 -m pyc_wheel --quiet your_wheel-1.0.0-py3-none-any.whl
# Output: your_wheel-1.0.0-py3-none-any.whl

or skipping compilation for a file subset:

$ python3 -m pyc_wheel --exclude "some/regex" your_wheel-1.0.0-py3-none-any.whl

To check all available processing options:

$ python3 -m pyc_wheel --help

Installation¶

Prerequisites:

Python 3.10 or higher
- https://www.python.org/
pip and setuptools
- https://pypi.org/project/pip/
- https://pypi.org/project/setuptools/

To install run:

python -m pip install --upgrade pyc_wheel

Development¶

Prerequisites:

Development is strictly based on nox. To install it run:
```
python -m pip install --upgrade nox
```

Visit Development page.

Installation from sources:

clone the sources:

git clone https://github.com/karpierz/pyc_wheel pyc_wheel

and run:

python -m pip install ./pyc_wheel

or on development mode:

python -m pip install --editable ./pyc_wheel

License¶

Copyright (c) 2019-2026 Adam Karpierz

Copyright (c) 2016 Grant Patten

Licensed under the MIT License

https://opensource.org/license/mit

Please refer to the accompanying LICENSE file.

Authors¶

Grant Patten <grant@gpatten.com>
Adam Karpierz <adam@karpierz.net>

Sponsoring¶

If you would like to sponsor the development of this project, your contribution is greatly appreciated.

As I am now retired, any support helps me dedicate more time to maintaining and improving this work.

Donate

Contents¶

Changelog