chumicro-compat
Stdlib polyfills for the bits CircuitPython and MicroPython skipped.
Import from chumicro_compat instead of the stdlib and your code works everywhere. CPython gets the real C implementation (zero overhead); CircuitPython and MicroPython get a lightweight pure-Python version of the same public API.
Part of the ChuMicro family: small, focused Python libraries for microcontrollers and laptops. Browse all libraries.
Install
# CircuitPython (after `circup bundle-add ChuMicro/ChuMicro-Bundle-Experimental`)
circup install chumicro_compat
# MicroPython
mpremote mip install github:ChuMicro/ChuMicro-Bundle-Experimental/chumicro_compat
# CPython
pip install chumicro-compat-experimental
For bundle setup, pre-compiled .mpy bundles, the experimental channel, and details on PyPI naming, see the chumicro INSTALL guide.
Quick example
from chumicro_compat.functools import partial
def set_led(pin: int, brightness: int) -> None:
"""Set an LED pin to a brightness level."""
print(f"pin {pin} → {brightness}%")
# Freeze the pin, vary the brightness later.
set_status_led = partial(set_led, 13)
set_status_led(50) # pin 13 → 50%
set_status_led(100) # pin 13 → 100%
What's included
functools
| Symbol | Description |
|---|---|
partial(func, *args, **keywords) |
Freeze positional and keyword arguments to a callable |
partial.func |
The original wrapped callable |
partial.args |
Frozen positional arguments (tuple) |
partial.keywords |
Frozen keyword arguments (dict) |
Where this fits
Leaf: no upstream ChuMicro deps. It is a standalone polyfill that no chumicro library currently requires; reach for it in your own code when you want stdlib features (functools.partial, …) missing from CircuitPython / MicroPython.
Platform support
| Runtime | What happens |
|---|---|
| CPython | Uses the built-in functools.partial directly, zero overhead |
| MicroPython | Lightweight pure-Python replacement |
| CircuitPython | Lightweight pure-Python replacement |
The public API (.func, .args, .keywords, __call__, __repr__) is identical across all runtimes.
Examples
| Example | What it shows |
|---|---|
partial_basic.py |
Freeze one argument to a function |
partial_keyword_override.py |
Freeze keyword args, override at call time |
partial_callback.py |
Wire a callback with frozen context (embedded pattern) |
Contributing
Issues, bug reports, and pull requests are welcome, and so is "I ran it on this board and here's what happened", some of the most useful feedback a hardware project can get. Development happens in the ChuMicro repository, whose contributing guide covers setup and the test workflow.
Docs
📖 Stable docs · Experimental docs
Find this library
- PyPI: chumicro-compat
- Bundle: ChuMicro-Bundle (CircuitPython & MicroPython)
- Experimental bundle: ChuMicro-Bundle-Experimental
- Source: libraries/compat
License
1 maintainer
Metadata
1 maintainer
Release files for chumicro-compat-experimental 0.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| chumicro_compat_experimental-0.3.2.tar.gz | 9.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| chumicro_compat_experimental-0.3.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 14.0 kB
Release files / chumicro_compat_experimental-0.3.2.tar.gz
| Download URL | chumicro_compat_experimental-0.3.2.tar.gz |
|---|---|
| Size | 9.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f9618afe1d94de9274e6e6f6f6836f7094bc4ea74c31e9f9973ae2bb815af9be
|
|
BLAKE2b-256 checksum How to use checksums |
5537c425b910a494f31a2911a62c94ff1f9f2bf2349a19335b7950ad5cf45b9a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 7, 2026.
Transparency logRelease files / chumicro_compat_experimental-0.3.2-py3-none-any.whl
| Download URL | chumicro_compat_experimental-0.3.2-py3-none-any.whl |
|---|---|
| Size | 4.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a9a44eef6c960455ace2538dd5265fd74a3594aae9aeb908073c85593dbea313
|
|
BLAKE2b-256 checksum How to use checksums |
8a54edabd0835f99d50f4f603a5d1e233552e3e7dfdcc8dd2ebd5c9bcac4d055
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 7, 2026.
Transparency log
