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)
Metadata
Release files for fond 0.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| fond-0.2.4-cp314-cp314-win_amd64.whl | CPython 3.14 | CPython 3.14 | Windows x86-64 | Details |
| fond-0.2.4-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.14 | CPython 3.14 | Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| fond-0.2.4-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl | CPython 3.14 | CPython 3.14 | Linux glibc 2.28+ ARM64, Linux glibc 2.26+ ARM64 | Details |
| fond-0.2.4-cp314-cp314-macosx_15_0_arm64.whl | CPython 3.14 | CPython 3.14 | macOS 15.0+ ARM64 | Details |
| fond-0.2.4-cp313-cp313-win_amd64.whl | CPython 3.13 | CPython 3.13 | Windows x86-64 | Details |
| fond-0.2.4-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 | Details |
| fond-0.2.4-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.28+ ARM64, Linux glibc 2.26+ ARM64 | Details |
| fond-0.2.4-cp313-cp313-macosx_15_0_arm64.whl | CPython 3.13 | CPython 3.13 | macOS 15.0+ ARM64 | Details |
| fond-0.2.4-cp312-cp312-win_amd64.whl | CPython 3.12 | CPython 3.12 | Windows x86-64 | Details |
| fond-0.2.4-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| fond-0.2.4-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.26+ ARM64, Linux glibc 2.28+ ARM64 | Details |
| fond-0.2.4-cp312-cp312-macosx_15_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 15.0+ ARM64 | Details |
Total release size: 28.3 MB
Release files / fond-0.2.4-cp314-cp314-win_amd64.whl
| Download URL | fond-0.2.4-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 1.4 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
37083b6555ce2f97047054a7b0a10c900ef371d6fe4b6c0558e93591029b8200
|
|
BLAKE2b-256 checksum How to use checksums |
08c7f8463bf579a437a9b688e12baa5a179f8a4e547970664d8619b9df8a460c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 19, 2026.
Transparency logRelease files / fond-0.2.4-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | fond-0.2.4-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.14 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
d86fbe0581861bb5a46032c63e98a6a1114e4fd944c5c1f99ffd8410e0080d37
|
|
BLAKE2b-256 checksum How to use checksums |
102b0aab8ee19142e2e5f4b381bd15930acc269d7b7459700666283f1e3588ce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 19, 2026.
Transparency logRelease files / fond-0.2.4-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | fond-0.2.4-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.14 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
79ecb70252e9743a8ea469dbe5ca62b66131bded528c8be63fac6a1c7a0d2143
|
|
BLAKE2b-256 checksum How to use checksums |
a804ba6bde19eb81544fe967261164718bcd43b11a5456be2c7a891e3463865b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 19, 2026.
Transparency logRelease files / fond-0.2.4-cp314-cp314-macosx_15_0_arm64.whl
| Download URL | fond-0.2.4-cp314-cp314-macosx_15_0_arm64.whl |
|---|---|
| Size | 708.8 kB |
| Tags | CPython 3.14 macOS 15.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
435ab9bac3ae1dacef2c4b88a23ff8479403b58ba461351c77150d7a0c58953e
|
|
BLAKE2b-256 checksum How to use checksums |
a16fe76ed5911fd261950676940689febf06a43b66401c77fa077f9af8c89ba7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is 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}
|
Release files / fond-0.2.4-cp313-cp313-win_amd64.whl
| Download URL | fond-0.2.4-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
e1d40af85d724e28d61bb9496a699619c7f81804eb1b4f3d6f1a13f9401f4b63
|
|
BLAKE2b-256 checksum How to use checksums |
ea389bd8af28e2959be8daea2a6e02e949a6d7609b64380a91fff6b7324ee64e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 19, 2026.
Transparency logRelease files / fond-0.2.4-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | fond-0.2.4-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.13 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
e13db934578e0d50f53148c63b931292f9a98c82282268b917cc3c953bdd9066
|
|
BLAKE2b-256 checksum How to use checksums |
b577ccbdfb2cd2602361a200db457ff68cc488dda6a83c47315aefd3e44f178a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 19, 2026.
Transparency logRelease files / fond-0.2.4-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | fond-0.2.4-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.13 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
c75cea7da0f290c63c13376d32e54e0b424549a5b4521becc17422fb23edd769
|
|
BLAKE2b-256 checksum How to use checksums |
c8ced577a3f3ea392bd044dccbabcfcea620499aa48a4a61dd0388f346fbc7e2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 19, 2026.
Transparency logRelease files / fond-0.2.4-cp313-cp313-macosx_15_0_arm64.whl
| Download URL | fond-0.2.4-cp313-cp313-macosx_15_0_arm64.whl |
|---|---|
| Size | 708.7 kB |
| Tags | CPython 3.13 macOS 15.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
9cd674a5112a70959ef681098c35d319f2c668dc20478bdddc50e0a1d629e0ed
|
|
BLAKE2b-256 checksum How to use checksums |
a951aa885252a4cc556154ce4326954adebc33ea769aad0d289112d1e305ba47
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is 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}
|
Release files / fond-0.2.4-cp312-cp312-win_amd64.whl
| Download URL | fond-0.2.4-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 973.8 kB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0222fc68d76c29f4e6354532e2fe51ba4c25f60a73aabf5a13d78b1119cfa036
|
|
BLAKE2b-256 checksum How to use checksums |
3b8af2714f3efbfccb1537cb24a1d15c0c8b7ad74d1f273d371ff2e2d2b4c665
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 19, 2026.
Transparency logRelease files / fond-0.2.4-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | fond-0.2.4-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
b268913846e014b3a35b43b346375da09d62a048ade94fe520718db5357abbbb
|
|
BLAKE2b-256 checksum How to use checksums |
2293e497869f84bdc89e0a834c0876c62e829dddf305539248c085dbff99630a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 19, 2026.
Transparency logRelease files / fond-0.2.4-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | fond-0.2.4-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.12 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
cad15d91bef3b6e834f7d0a1cbe5e6288f27213116916a1f370454b8aa1d16ba
|
|
BLAKE2b-256 checksum How to use checksums |
f816dbf0bb8ca201835199d832a3caa7f0421030b645c14fa13279d8d5a055db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 19, 2026.
Transparency logRelease files / fond-0.2.4-cp312-cp312-macosx_15_0_arm64.whl
| Download URL | fond-0.2.4-cp312-cp312-macosx_15_0_arm64.whl |
|---|---|
| Size | 708.7 kB |
| Tags | CPython 3.12 macOS 15.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
fa80604181c183a30ad47433f8d3a19f4b3c38706050e54cd02b5e85e7e97d1a
|
|
BLAKE2b-256 checksum How to use checksums |
ea30ea3aa80e514efdd9e4989d960813c6547997f15002908a6870be64446fbd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is 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}
|