Check out the official documentation here.
Note: Version 1.6.1 had a critical division by zero error that wasn't caught.
Package Extensions
Cpyte supports a package extension system that allows packages to extend the compiler with custom keywords, operators, and compiler hooks. Packages can provide:
- Custom Keywords: Add new language keywords via
package.json - Custom Operators: Define new operators for syntax extensions
- Compiler Hooks: Extend lexing, parsing, semantic analysis, and code generation
- Runtime Extensions: Add runtime code and libraries
Package Structure
Packages are stored in .cpm/modules/package_name/version/ and can include:
package.json- Extension manifest declaring capabilitiesparser_hooks.py- Custom syntax extensionssemantic_hooks.py- Custom type checking and analysis rulescodegen_hooks.py- Custom LLVM IR generationruntime_hooks.py- Runtime code and libraries*.cpy- Main package entry point*.ll- Prebuilt LLVM IR
Example Package
See examples/example_package/ for a complete example package with:
- Custom keywords:
async,await,defer - Custom operator:
~~ - Parser, semantic, codegen, and runtime hooks
Using Extension Packages
import @package_name
# Use custom keywords and syntax from the package
async def my_function() -> Promise:
# Custom syntax
defer cleanup()
return result
Examples
You'll find comprehensive examples in the examples/ directory that cover C imports, header imports, 64-bit support, and standard library usage:
| File | Description |
|---|---|
examples/c_import_example.cpy |
Importing and calling functions from C source files |
examples/example_math.c |
C source with math utility functions for the C import example |
examples/h_import_example.cpy |
Importing functions declared in C header files |
examples/example_functions.h / example_functions.c |
Header and implementation for the H import example |
examples/64bit_example.cpy |
Comprehensive int64/uint64 arithmetic, hex literals, type promotion |
examples/c_library_imports.cpy |
Using built-in C libraries (stdio, stdlib, math, string, time) |
examples/mixed_features.cpy |
Combines C imports, H imports, 64-bit, structs, pointers, linked lists |
examples/mixed_helpers.c / mixed_helpers.h |
Supporting C/header files for the mixed features example |
examples/test.cpy |
macOS event tap example that intercepts keyboard events using ApplicationServices framework |
examples/example_package/ |
Example package demonstrating extension capabilities with custom keywords, operators, and compiler hooks |
You can also import .cpy files — the examples show how to use import "other.cpy" to bring in public functions and structs from other Cpy files.
Run any example with:
python source/mainpie.py --jit examples/<filename>.cpy
Note
Cpyte is experimental software. The compiler is continuously tested with fuzzing, and we're still discovering and fixing correctness bugs. While many programs compile and run correctly, I can't make any guarantees about correctness or stability.
If you decide to use Cpyte, always use the latest version — older versions have bugs that are pretty easy to run into.
Memory Management
Cpyte uses Boehm GC (bdw-gc) for automatic garbage collection. Heap-allocated objects (via new) are managed automatically — no manual free needed.
Note: Boehm GC adds a small runtime overhead (~5-10%) compared to manual malloc/free. For performance-critical ecosystem projects or embedded use cases, this trade-off may be significant. The GC is required for safety but will slow down programs that do heavy heap allocation.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cpyte-2.2.0.tar.gz.
File metadata
- Download URL: cpyte-2.2.0.tar.gz
- Upload date:
- Size: 87.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7001a7b0bb728899ed44368e0c3fad8cfd857bfda1a27979219048b81f696e6f
|
|
| MD5 |
37beff76ad704177608d79e656c4004a
|
|
| BLAKE2b-256 |
29e556260a33095c084271f5b2f47bfb4bcf4abafedab0813c33f7e79c1e462e
|
File details
Details for the file cpyte-2.2.0-py3-none-any.whl.
File metadata
- Download URL: cpyte-2.2.0-py3-none-any.whl
- Upload date:
- Size: 88.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
16cd5571821bd7a53a6388c9282298d7c8d3710240a1876d0762889c9aab3422
|
|
| MD5 |
10e97e8fc96b5078bf1706062314e014
|
|
| BLAKE2b-256 |
3ff8050ae99d6df2a57fb74bab3bcdf255e24cbba8c3e5b1cbf6cbf302d8f4a6
|
