How thenumbat/rpp works
Main Components Organization
a) Core Library Components:
• Related components into logical subsystems:
• Memory Management (alloc0.h, alloc1.h, pool.h, range_allocator.h)
• Data Structures (array.h, map.h, queue.h, stack.h, vec.h)
• Concurrency (async.h, thread.h)
• Math/SIMD (math.h, simd.h, vmath.h)
• Utilities (format.h, log.h, profile.h)
b) Platform-Specific Implementations:
• Create two parallel implementation branches:
• POSIX Implementation (pos/ directory)
• Windows Implementation (w32/ directory)
Component Relationships
• How higher-level components depend on core components
• Platform-specific implementations feeding into their respective abstractions
b) Cross-Component Interactions:
• How async/thread components interact with platform-specific code
• Memory allocator relationships with data structures
Specific Elements
• Component name
• Key files/classes contained
• Platform support indicators
• Version requirements (e.g., MSVC 19.39+, Clang 17+)
Architectural Patterns to Emphasize
• Platform Abstraction Layer pattern
• RAII and Resource Management
• Type-safe containers and smart pointers
• Reflection system
• Async/await pattern implementation
Platform-Specific Implementation Layer (bottom)
• Clean separation between platform-specific and platform-independent code
• Clear dependency chains
• Resource management and safety features
• Cross-platform compatibility
Keep the abstraction level focused on architectural components while including enough detail to show the library's key features like SIMD support, async operations, and memory management strategies.