Skip to main content

Appendix-05.CPython_vs_Pure_Python

CPython vs Pure Python​

In CPython (the standard Python implementation), you’ll often find two versions of the same module or object:

  • A fast implementation in C
  • A fallback or reference implementation in pure Python

This happens for several important reasons:

1. Performance (C version)​

Many Python modules, especially those used frequently or in performance-critical code, are implemented in C to make them much faster.

Examples:

  • collections.deque (C)
  • json → uses json (Python) + json._json / ujson-like C accelerators
  • threading.local → C implementation (_thread._local) + pure Python fallback (threading.local)

The C version gives significant speed improvements, especially for low-level operations like attribute access, locking, or memory management.

2. Portability (Python version)​

CPython can run on many platforms where the C extension might not be available or cannot be compiled. A pure-Python implementation is guaranteed to run everywhere, including:

  • rare architectures
  • restricted environments (embedded systems)
  • platforms where compiling C extensions is difficult

So the Python version ensures broad compatibility.

3. Maintainability and clarity​

The Python version often acts as a reference implementation:

  • It’s easier to read and understand
  • It clarifies tricky semantics
  • It helps test and validate the C version for correctness

Example: threading.local in Python acts as a readable reference to guide the C implementation.

4. Extensibility and fallback​

Python users can sometimes subclass or modify the Python implementation when they can’t modify the C one. Also, if the C extension fails to load, Python seamlessly falls back to the pure version.

Example: threading.local​

The CPython source includes:

ComponentRole
PyThread_local (C version)Fast thread-local storage used by default
threading.local (Python wrapper)Pure Python fallback + nicer API

This design lets CPython:

  • use the fast C implementation in normal conditions,
  • but still provide a pure Python fallback that behaves the same.