PYCOMPILE(1)

💖 PYCOMPILE — the pycompile(1) glow-up 💖

okay bestie, sit DOWN, because we're talking about pycompile, the manual page from section 1 (general commands, the ones you just... run). she's a little wrapper, she's got range, and she's about to byte-compile ur whole life. let's go 🫶

✨ SYNOPSIS ✨

pycompile [-V [X.Y][-][A.B]] DIR_OR_FILE [-X REGEXPR]

pycompile -p PACKAGE

literally just two ways in. pick ur fighter. 💅

🌸 DESCRIPTION 🌸

so pycompile is a wrapper around the Python standard library's py_compile module, and her whole job is byte-compiling Python files. that's it. that's the gig. she takes ur source and turns it into byte-code. iconic behavior, no notes. ✨

🎀 OPTIONS 🎀

• --version — shows the program's version number and then dips. bye! 👋
• -h, --help — shows this help message and exits. the classic "help me help u" move. 🆘
• -f, --force — forces a rebuild of the byte-code files even if the timestamps are already up-to-date. like, even if it looks fine? yes. rebuild anyway. she said no shortcuts. 🔥
• -O — byte-compile to .pyo files. different file, different vibe. 💜
• -q, --quiet — be quiet. shhh. 🤫
• -v, --verbose — turn verbose mode on. she's gonna tell u EVERYTHING and honestly? we love a yapper. 🗣️
• *-p *PACKAGE, --package=PACKAGE — specify the Debian package name whose files should be bytecompiled. and pro tip: combining this with DIR_OR_FILE will additionally limit the list of files. so it's package + path, both vibing, both filtering. 🎯
• *-V *VRANGE — forces private modules to be bytecompiled with a Python version from the given range, regardless of the default Python version in the system. and if there are no other options? then she'll bytecompile all public modules for the installed Python versions that match the given range. here's what VERSION_RANGE looks like in the wild:
  • 2.5 — version 2.5 only
  • 2.5- — version 2.5 or newer
  • 2.5-2.7 — version 2.5 or 2.6
  • -3.0 — all supported 2.X versions
• *-X *REGEXPR, --exclude=REGEXPR — excludes items that match the given REGEXPR. and bestie, u can use this option MULTIPLE times to build up a whole list of things to exclude. stack 'em. go off. 🚫

👑 AUTHOR 👑

Piotr Ożarowski, 2012-2013. the original main character. we stan. 💖

okay that's the whole page, and yes, we made it to the end 🦋 this was pycompile, section 1 of the manual, from those golden 2012-2013 days — Piotr Ożarowski's era, periodt. now go byte-compile something and slay. 💅✨🌸