Registry / devops / pyc-wheel

pyc-wheel

JSON →
library2.4.3pypypi✓ verified 86d ago

A tool to compile all .py files inside a wheel to .pyc files, optimizing startup time. Current version 2.3.0, supports Python >=3.10,<4.0.0. Maintenance release cadence appears irregular.

devops
pip install pyc-wheel
github ↗package ↗homepage ↗docs ↗changelog ↗
INSTALL
IMPORT
SIG · PYC-WHEEL
P
pyc-wheel
devopspythonv2.4.3
Install
2.6s avg
Import
621ms
Disk
24MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.9–3.13
musl
3.9–3.13
Install & Compatibility
Where this runs
tested against v2.3.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.650s · 22.5MB
glibc
py 3.10–3.95 runs
installs and imports cleanly · install 2.6s · import 0.592s · 23MB
24MB installed
● package 24MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

main
✓ from pyc_wheel import main
✗ import pyc_wheel
The module exposes a main function; direct module import does not provide useful API.

Import and call main() with appropriate arguments. For CLI usage, run 'pyc-wheel --help'.

from pyc_wheel import main # Compile a wheel in-place # main() expects sys.argv style list or uses sys.argv # example: main(['pyc-wheel', '--inplace', 'path/to/wheel.whl'])
pyc-wheel --version
Debug
Known issues
gotchaThe package name on PyPI is 'pyc-wheel' (with hyphen), but the importable module is 'pyc_wheel' (with underscore). This mismatch is a common source of ImportError.
fix
Use 'pip install pyc-wheel' and 'from pyc_wheel import main'.
affects: all
gotchapyc-wheel only works with wheel files, not directories. You must first build a wheel from your project (e.g., 'pip wheel .') before running pyc-wheel.
fix
Run 'pip wheel . --no-deps -w dist' then 'pyc-wheel dist/*.whl'.
affects: all
deprecatedThe CLI flag '--inplace' modifies the original wheel file. This may be deprecated in future; prefer outputting to a new file with '--output-dir'.
fix
Use 'pyc-wheel input.whl -o output.whl' or '--output-dir'.
affects: >=2.0.0
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'pyc-wheel'
Mistaking the pip package name for the Python module name; 'pyc-wheel' is not importable.
fix
Use 'from pyc_wheel import main' (underscore) instead.
ERROR: pyc-wheel requires Python >=3.10,<4.0.0 but you have Python 3.9.
Python version too old. pyc-wheel drops support for Python <3.10 as of version 2.0.0.
fix
Upgrade Python to 3.10 or higher, or use an older version of pyc-wheel (pip install 'pyc-wheel<2').
Upgrade
Version history
2.4.3latest on PyPI · released Jun 2, 2026
Audit
Dependencies

No dependency data recorded yet.

Agent activity
10 hits · last 30 days
node
4
Resources
githubhttps://github.com/karpierz/pyc_wheel ↗
packagehttps://pypi.org/project/pyc-wheel/ ↗
homepagehttps://pypi.org/project/pyc-wheel/ ↗
docshttps://karpierz.github.io/pyc_wheel/ ↗
changeloghttps://karpierz.github.io/pyc_wheel/CHANGES.html ↗
pyc-wheel — pip install pyc-wheel · libregistry