carbonengine/blue

How carbonengine/blue works

carbon-blue is a central native library for an embedded Python runtime, game-loop services, resource loading, networking, and supporting platform facilities. The principal workflow is an application entering through Blue’s Python-facing runtime, which exposes services used by Python code; resource and data-format facilities provide additional capabilities. The tree and excerpts identify these subsystems, but sampled implementation evidence is limited, so uncertain internal wiring is intentionally omitted.

Main entry points: BluePython.cpp Python runtime · _taskletextension.py Tasklet extensions · stacklessio.h Async I/O queue · BlueNet.cpp BlueNet messaging

Components 20

Runtime and scheduling

Python runtime src/BluePython.cpp
Tasklet extensions python/bluepycore/_taskletextension.py
Python shutdown python/bluepycore/_shutdown.py
Async I/O queue include/stacklessio.h
Tasklet timer src/TaskletTimer.cpp

Resource loading

Resource manager src/BlueResMan.cpp
Async resources src/BlueAsyncRes.cpp
Local resource FS src/BlueResFileSystemLocal.cpp
Remote resource FS src/BlueResFileSystemRemote.cpp
Remote file cache src/RemoteFileCache.cpp
Resource streams src/BlueRemoteStream.cpp

Networking and data

Data readers writers src/BlackReader.cpp
YAML formats src/YamlReader.cpp
BlueNet messaging src/BlueNet.cpp
Network streams src/BlueNetworkStream.cpp

Platform services

Logging src/Logger/Logger.cpp
Statistics src/BlueStatistics.cpp
OS services src/BlueOS.cpp
Path services src/BluePaths.cpp

Other components

Host application

Connections 5

Host application → Python runtime: enters runtime
Tasklet extensions → Tasklet timer: tracks tasklets
Async I/O queue → Host application: dispatches events
Python runtime → Python shutdown: shuts down
BlueNet messaging → Network streams: uses transport

More C++ diagrams: tzursoffer/windowspasswordbypasser · ali-pahlevani/multi_sensor_slam · arty3/stack-obfuscator · coastalredwood/zeal · coremaze/cwsdk

Drawn by GitDiagram on September 28, 2026 from the repository's file tree, README and source files. Read as Markdown ·