Stefano Cristiano

Sane C++ Libraries Dependencies (October 2025)

Sane C++ Libraries - October 2025

✅ Further reduction of internal dependencies
✅ Bring Your Own Containers example (InteropSTL)
✅ New bootstrap for SC::Tools written in C++
✅ Increased test coverage
✅ Improved CI
✅ Fixes

github.com/Pagghiu/Sane...
#cpp #cplusplus

InteropSTL: Show std::string and std::vector<char> usage with File an… · Pagghiu/SaneCppLibraries@cb8bca4 …d FileSystem libraries

Sane C++ Libraries has finally become a BYOC (Bring Your Own Containers) project!
We have SC::Strings and SC::Vector<T>, using relative pointers and a "scoped" allocator logic that not everyone may like, but you can now write adapters to use something else

A drawing showing current state of dependencies between Sane C++ Libraries

Sane C++ Libraries - September 2025

✅Get rid of many inter-library dependencies
✅Stop accidental dependencies additions in CI
✅Free most libraries from dynamic allocation
✅Transform Build from lib to app
✅Add GDB Pretty Printer
✅Many smaller fixes

github.com/Pagghiu/Sane...

#cpp #cplusplus

Picture of the pretty printers being registered by the new GDB debug visualizer script for Sane C++ Libraries

I've been adding to Sane C++ Libraries a GDB debug visualizer (pretty printer in gdb terminology) taking care of strings and containers.

In addition to the already existing ones for LLDB and MSVC Debugger (.natvis) I think we should be good now!
#cpp #cplusplus

Release 2025-08 · Pagghiu/SaneCppLibraries August 2025 Update Blog Post Single File Libraries One of the core principles of this project is to be "Easy to Integrate". I'm always looking for ways to lower the barrier to entry for using these...

Sane C++ Libraries - August 2025

✅ Available as Single File Libs
✅ Threading: Semaphore / Barrier / RWLock (→ Stable)
✅ AsyncStreams: IPC Pipe Streams (→ MVP)
✅ Process: Improve reliability
✅ More fixes (see blog post details)

pagghiu.github.io/site/blog/2025-08-31-SaneCppLibrariesUpdate.html
#cpp

Of course I would only vibe-code Sane C++ Libraries!

Screenshot of the Sane C++ Libraries Amalgamation tool, allowing to amalgamate libraries directly in browser.

Screenshot of one example amalgamated single file lib (SaneCppFileSystem.h) showing the initial header section with LOC count for header vs. implementation, explicit list of dependencies, copyright etc.

Sane C++ Libraries are now available as amalgamated single-file libs!

They can be amalgamated offline or directly in-browser at: pagghiu.github.io/SaneCppLibra...

Each amalgamation lists dependencies on other amalgamated libs and the LOC of its header vs. implementation sections.

Have fun!
#cpp

Release 2025-07 · Pagghiu/SaneCppLibraries July 2025 Update Blog Post Automatic Dependency and LOC List of dependencies between libraries and the number of lines of code (LOC) composing them gives an immediate complexity indication. For thi...

Sane C++ Libraries - July 2025

Major cleanup month!🧹

✅ Massive reduction in inter-library dependencies
✅ 7 libraries now allocation-free:
- Async
- File
- FileSystem
- FileSystemIterator
- FileSystemWatcher
- Process
- Socket

pagghiu.github.io/site/blog/2025-07-31-SaneCppLibrariesUpdate.html
#cpp

FileSystemWatcher: Remove dependency from Async and File libraries · Pagghiu/SaneCppLibraries@563c03e

I have been removing the dependency of the Sane C++ FileSystemWatcher library from the Async one.
There's a new mini-lib now called FileSystemWatcherAsync wiring them together explicitly when event loops are needed.
It feels so much cleaner now!

github.com/Pagghiu/Sane...

I wonder if I should capitalize on this by distributing them as isolated single file libraries...

I have been removing many inter-dependencies between Sane C++ "Libraries" (mainly Strings/Memory/Containers)

The following libraries do not allocate anymore! 🎉

✅ Async
✅ File
✅ FileSystem
✅ FileSystemWatcher
✅ FileSystemIterator
✅ Process
✅ Socket

See: pagghiu.github.io/SaneCppLibra...

#cpp

Release 2025-06 · Pagghiu/SaneCppLibraries June 2025 Update Blog Post Async File System Operations A major new feature this month is the unified AsyncFileSystemOperation that provides async file system operations across all platforms. This ...

Sane C++ Libraries June 2025:

✅ Async FS Ops
- {copy|remove|rename}{file|folder}
- {open|close|read|write}file
✅ AsyncUDP {SendTo | ReceiveFrom}
✅ FileSystem {Iterator | Watcher} / Memory dependencies cleanup

Blog
pagghiu.github.io/site/blog/20...

Github
github.com/Pagghiu/Sane...
#cpp #cplusplus

This week I have been adding a few more obvious Async FileSystem Ops:

✅ file/directory rename
✅ file/directory remove

pagghiu.github.io/SaneCppLibra...

#cpp #cplusplus

Async FileSystem Operation has been added to Sane C++ Libraries for:

✅file open/close
✅file read/write
✅file copy

All ops are executed on user supplied thread-pool for IOCP(win)/kqueue(mac)/epoll(linux), with special code path for io_uring(linux)!

pagghiu.github.io/SaneCppLibra...
#cpp #cplusplus

I have been adding to Sane C++ Libraries some async primitives needed to send and receive bytes to and from UDP sockets (sendTo and receiveFrom).

As always implemented for IOCP, kqueue / epoll and io_uring!

Documentation:
pagghiu.github.io/SaneCppLibra...

Commit:
github.com/Pagghiu/Sane...

#cpp

Sane C++ Libraries May 2025:

✅ AsyncSequence
- Serial execution of async requests
✅ SC::Async
- Smaller memory footprint
- Improved cancellation handling

deepwiki.com/Pagghiu/Sane...

Blog:
pagghiu.github.io/site/blog/20...

Github:
github.com/Pagghiu/Sane...

Have a nice weekend!
#cpp #cplusplus

Release 2025-04 · Pagghiu/SaneCppLibraries April 2025 Update Blog Post Process SC::Process library allows spawning process across all supported platforms with many features, including I/O redirection and setting environment variables / star...

Sane C++ Libraries April 2025

✅ Process fork
✅ Struct dumping
✅ Async vectorized writes
✅ Tools update
✅ Repo restructuring

Blog:
pagghiu.github.io/site/blog/2025-04-30-SaneCppLibrariesUpdate.html

Github:
github.com/Pagghiu/SaneCppLibraries/releases/tag/release%2F2025%2F04

Have a nice week!
#cpp

I've added a ProcessFork class to Sane C++ Libraries after discovering that "fork" on Windows can be approximated with RtlCloneUserProcess.
There are a ton of limitations but it's useful to serialize a data structure without blocking for IO or copying it for async IO.
Nice!
#cpp

std::launder is so 2024

An example of "struct dumping" in Sane C++ Libraries.
Anything SC::Segment based (Vector / String / VectorMap etc.) can be dumped and restored by just casting it (well, start_lifetime_as 🤭).
I guess it's not rocket science but recent additions make creating this simple and easy.
#cpp #cplusplus

Sane C++ Libraries improvements for March 2025:

✅ Custom Allocators (Segment / Containers)
✅ Relative Pointers

Blog:
pagghiu.github.io/site/blog/2025-03-31-SaneCppLibrariesUpdate.html

Github:
github.com/Pagghiu/SaneCppLibraries/releases/tag/release%2F2025%2F03

Have a nice week!
#cpp #cplusplus

This is going to be hard!

Fun fact: I was just incidentally thinking right now about using thread_local static to store a memory allocator.

While debugging some of the recent container issues for Sane C++ Libraries I have been starting to track the number of allocation and deallocations calls.

The test suite by itself is doing 20K allocations and ~50K re-allocations 🫠.

Is it MAYBE time to add support for custom allocators? 😅

I have been slapping volatile where I think it makes sense to force the optimizer think twice about making weird assumptions around that code.
Hopefully this will not be so bad performance wise.
I could maybe replace that offset == 0 conditional with some branchless code to improve things further...

Foundation: Refactor Segment to reduce and isolate UB · Pagghiu/SaneCppLibraries@7a97c14

I've been pushing one more refactoring for Sane C++ Libraries Containers (never enough!) to take advantage of all of my recently acquired know-how on fighting UB connected to violating compiler aliasing analysis...or at least isolate it!

Hopefully this is now better than before 🧹
#cpp #cplusplus

Ok I was just told on the Italian C++ Discord about a presentation that linked to boost::interprocess::offset_ptr
www.boost.org/doc/libs/1_8...
Looking at the code it just seems to slap const volatile everywhere and be happy with that 😅
www.boost.org/doc/libs/1_8...
Can we consider Boost UB free? 🤭

yeah, the thing is you may never hit specific UB manifestation until maybe someday with some compiler / platform combination after modifying some unrelated code or with a specific runtime workload.
That's why UB are so bad, and in C++ it's too easy hitting one of the many defined by the standard 😮‍💨

Most SSO implementations I have seen use an union of pointer+size and the buffer. They discriminate the union depending on value of capacity (if > than buffer array size then you’re on the heap and viceversa).
There is no pointer arithmetic in this case, correct.

that is exactly what you wrote @jeremy.laumon.name , sorry I was reading your message too quickly 😅

Well I just replied to myself in another post, that the issue is not only that on some platform such equivalences do not hold, but that once declared UB, compiler writers started to use them for very obscure optimizations breaking your code anyway even on platforms where equivalences would be valid.