Fond
Foundation for Cooking, Foundation for Life.
Experimental: This package is under active development. APIs may change without notice.
C++ header-only utilities distributed via PyPI as a build-time dependency. Your end users never need to install it.
Installation
pip install fond
Usage
As a build dependency
[build-system]
requires = [
"fond>=0.1.0",
"build-cub",
"pybind11",
]
Getting include paths
import fond
fond.get_include() # Root include path
fond.get_libs() # Binding source files
In your C++ code
#include <fond/collections/maps.hpp>
#include <fond/logger/logger.hpp>
#include <fond/colors/palette.hpp>
#include <fond/msgpack/packer.hpp>
Available Headers
Collections (fond/collections/)
Policy-based data structures with compile-time Ordered/Frozen variants:
- Set — unordered, ordered, frozen, frozen-ordered (policy-based)
- Map — same four variants via policies
- List / Tuple — mutable list + frozen tuple
- BloomFilter / BloomSet — probabilistic fast-negative-lookup set
- LRUCache — simpoo version wrapping Map
- RingBuffer — fixed-size circular buffer, compile-time sized
- Trie — prefix tree for string lookup and autocomplete
- BitFlag — type-safe enum-keyed bitset wrapper
- Arena — bump allocator for bulk allocation
- Pool — fixed-size typed object pool with freelist
- SparseSet — O(1) add/remove/contains with dense iteration
- DynStack — dynamic LIFO stack, doubles as a freelist
Collections Core (fond/collections/core/)
Composable low-level building blocks for high-performance data structures:
- OpenMap — open-addressing hash map with tombstones, node pool, intrusive LRU list
- IntrusiveList — doubly-linked list that doesn't own nodes
- NodePool — pre-allocated typed pool for ListNode-derived types
- HashUtils — probing, power-of-2 masking, hash mixing, load factor math
High-Performance (fond/collections/)
- FastLRU — LRU cache built on OpenMap (zero allocations per get/put)
Colors (fond/colors/)
- Color — RGBA color struct with conversions to ANSI, ImGui, uint32
- Palette — named color constants (single source of truth)
- ANSI — terminal color constants (constexpr, zero allocation)
- ImGui — ImVec4/ImU32 color constants (generated from palette)
Logger (fond/logger/)
- Compile-time configurable logging with function pointer dispatch
- ANSI color support, file output with rotation, buffer mode, callbacks
std::formattemplate overloads on all log methods
Info (fond/info/)
- ProjectInfo — version, exit codes, project metadata with pybind11 bindings
- VersionHelpers — version bump/parse utilities
MsgPack (fond/msgpack/)
- Binary serialization with
MSGPACK_DEFINEmacro (powered byFOND_FOR_EACH) - Packer, Unpacker, Python packer/unpacker variants
Lua (fond/lua/)
- Lua table serialization with
LUA_DEFINEmacro (powered byFOND_FOR_EACH)
Macros (fond/macros/)
- FOND_FOR_EACH — preprocessor for-each over variadic args (generated, up to 100 args)
Tools
- ByteBuffer — unified read/write byte buffer
- Timer — scoped timer with auto unit selection, lap times,
time_it()lambda - EpochTimestamp — configurable timestamp formatting
- KeyStore — file-backed key/value store using MsgPack
- Locking — mutex helpers (C and C++ variants)
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distributions
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 fond-0.1.17-cp314-cp314-macosx_15_0_arm64.whl.
File metadata
- Download URL: fond-0.1.17-cp314-cp314-macosx_15_0_arm64.whl
- Upload date:
- Size: 671.7 kB
- Tags: CPython 3.14, macOS 15.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
92cc3247173d7ae05e2126d72a617a6e32b06ca012c958b1290888ba01a3507d
|
|
| MD5 |
441bc2cb2dfeaa72b3090b7bd2b45415
|
|
| BLAKE2b-256 |
3b34dfe904cafaabc843b00ff7231ace108966ca9697d7b175408a909a85a8a7
|
File details
Details for the file fond-0.1.17-cp313-cp313-macosx_15_0_arm64.whl.
File metadata
- Download URL: fond-0.1.17-cp313-cp313-macosx_15_0_arm64.whl
- Upload date:
- Size: 671.4 kB
- Tags: CPython 3.13, macOS 15.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c9545c5102799416c45f8fe5866a8c1c392e0ab0d2978ff13bd6c57eda51e0bd
|
|
| MD5 |
8d756efe42f2806cdf0153960bdd0e02
|
|
| BLAKE2b-256 |
3f28459fded7c367fe24322a0aabd37d167af14530e9b8e915eabbcf1d7e70fc
|
File details
Details for the file fond-0.1.17-cp312-cp312-macosx_15_0_arm64.whl.
File metadata
- Download URL: fond-0.1.17-cp312-cp312-macosx_15_0_arm64.whl
- Upload date:
- Size: 671.4 kB
- Tags: CPython 3.12, macOS 15.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b51e16704b5b2bcb4a863f770e7d09a96d93dee31ef2068651941347d668d80f
|
|
| MD5 |
d4882477c7d114ca92d3cd95fb88c95b
|
|
| BLAKE2b-256 |
ff7756aa6747dc47d13038276a68d2e7f8ec7c87482ca97be61564368b41a2d1
|
