QUICK REFERENCE
Use this table to check whether your Python code fits PyCForge {{APPLICATION_VERSION}} before converting a larger program.
| Python feature | Supported use | Details |
|---|---|---|
| Scalar variables | Annotated or inferred locals, declarations before assignment, chained assignment, flat unpacking, scalar augmented assignment. | Local variables |
| Module variables | Scalar constants calculated from literals and earlier constants; read from functions. | Module variables |
| Strings | Length, content comparisons, prefix/suffix tests, search, and membership; extra operations on constant text. | String operations |
| Branches and loops | if, while, fixed-container loops, positional range, break, continue, loop else. | Control flow |
| Containers and records | Fixed local lists, tuples, dictionaries and numeric/Boolean sets; simple immutable records. | Containers and records |
| Function calls and imports | Direct annotated calls, explicit required arguments, function imports from files included in the conversion. | Functions and modules |
| Text files | Bounded whole-file UTF-8 reads and writes using the exact documented with open forms. | Reading and writing files |
General Python classes and objects, mutable global state, dynamic containers, arbitrary installed packages, exceptions, recursion, asynchronous code, and runtime string construction are outside the supported set. Split a larger application into suitable functions and keep unsupported work outside those converted functions.
The variable and string examples in this guide require version 1.1 or later with its default conversion settings. Check Help → About, or run:
python -c "import pycforge; print(pycforge.__version__)"
If your Python API code explicitly selects older conversion settings, upgrading the package does not change that selection. Start with ConversionRequest.from_source(source) to use the current defaults. Keep your Python source and package version alongside generated C when you need to reproduce a conversion.