Cenom is a non-intrusive, security-enhanced runtime infrastructure for C, designed to augment legacy and modern codebases without enforcing an API or architectural changes.
⚠️ Note: This map documents implemented and existing components only, not planned features.The project's source code was decoded on 2026/1/24 .
project allows you to activate only the features you want; whether it's one feature, two, or all of them.
- Object-Oriented Programming (OOP): Full support for Classes, Inheritance, and Polymorphism within C.
- Reflection API: Ability to inspect and modify program structure at runtime.
- Generics: Write flexible and reusable code with different data types.
- Exception Management: A robust system for error handling similar to high-level languages.
- Modern Features: Support for Lambdas, Mixins, Interfaces, and Properties.
- VENOM System: A powerful security engine to detect and thwart attacks in real-time.
- Vulnerability Detection: Ability to detect 48 types of memory and security vulnerabilities (Buffer Overflow, Use-After-Free, Double Free, etc.).
- Active Protection: Technologies like Stack Canary, ASLR Protection, and CFI (Control Flow Integrity).
- Memory Profiler: Tools to generate heatmaps and track memory consumption.
- Collector: Smart and 4 memory management systems and prevent leaks.
- Smart Pointers: Support for Unique Ptr and Shared Ptr for RAII-style resource management.
- Memory Tracker: Accurate system to track every byte allocated and freed.
- HTTP/HTTPS Server & Client: A powerful, newly written networking library supporting SSL/TLS.
- Asynchronous Programming (Async/Await): Non-blocking I/O model for high performance.
- WebSocket: Support for bidirectional real-time communication.
- Connection Pooling: Efficient connection management to reduce latency.
- Integrated ORM: Object-Relational Mapping supporting PostgreSQL, MySQL, and SQLite.
- Query Builder: Build complex SQL queries in a seamless programmatic way.
- Migrations: System for managing schema changes and database updates.
- Massive Algorithms Library: Includes Graph algorithms, Dynamic Programming (DP), and Matrix operations.
- Unified Data Structures: High-performance Lists, Maps, Sets, and Trees.
- Venom Watch: Static Code Analyzer written in Rust to ensure code quality.
- dependencies: The project follows a philosophy of avoiding any dependencies, meaning it is completely free of any dependencies except for OpenSSL for security purposes.
- Note: The project is still a developer version and has not yet reached the beta stage.
Complete project hierarchy with all files and subdirectories as of January 2026.
Cenom/
│
├── 📄 Makefile # Main build system
├── 📄 Makefile.security # Security module build
├── 📄 Makefile.tests # Tests build system
├── 📄 Makefile.tracker # Memory tracker build
├── 📄 README.md # Project documentation
├── 📄 USAGE_GUIDE.md # Usage documentation
├── 📄 REPORT.md # Project report
├── 📄 Output_Container.md # Output container docs
├── 📄 memory_graph.dot # Memory graph visualization
│
├── 📁 include/cenom/ # 🔷 Public Headers
│ ├── 📄 cenom.h # Main unified header
│ ├── 📄 cenom_security.h # Security module header
│ │
│ ├── 📁 core/ # Core Framework Headers
│ │ ├── 📄 class.h # Class system
│ │ ├── 📄 exception.h # Exception handling
│ │ ├── 📄 extension.h # Extension methods
│ │ ├── 📄 generics.h # Generics support
│ │ ├── 📄 interface.h # Interface system
│ │ ├── 📄 main_wrapper.h # Main wrapper
│ │ ├── 📄 match.h # Pattern matching
│ │ ├── 📄 mixin.h # Mixin support
│ │ ├── 📄 modern.h # Modern features
│ │ ├── 📄 object.h # Object base class
│ │ ├── 📄 properties.h # Properties system
│ │ ├── 📄 record.h # Record types
│ │ ├── 📄 reflect.h # Reflection API
│ │ ├── 📄 string.h # String operations
│ │ ├── 📄 sugar.h # Syntactic sugar
│ │ ├── 📄 syntax.h # Syntax helpers
│ │ └── 📄 types.h # Type definitions
│ │
│ ├── 📁 memory/ # Memory Management Headers
│ │ ├── 📄 alloc.h # Memory allocation
│ │ ├── 📄 cenom_gc.h # Garbage collector
│ │ ├── 📄 memory.h # Memory utilities
│ │ ├── 📄 raii.h # RAII support
│ │ ├── 📄 raii_enhanced.h # Enhanced RAII
│ │ └── 📄 smart_ptr.h # Smart pointers
│ │
│ ├── 📁 net/ # 🌐 Network & Async Headers (UPDATED)
│ │ ├── 📄 async.h # Async operations
│ │ ├── 📄 events.h # Event system
│ │ ├── 📄 net.h # HTTP client API (~424 lines) ✨ REWRITTEN
│ │ ├── 📄 server.h # HTTP/HTTPS server (~556 lines) ✨ REWRITTEN
│ │ ├── 📄 socket.h # Socket abstraction (~625 lines) 🆕
│ │ ├── 📄 tls.h # TLS/SSL layer (~523 lines) 🆕
│ │ ├── 📄 http_parser.h # HTTP parsing (~350 lines) 🆕
│ │ ├── 📄 dns.h # DNS resolution (~229 lines) 🆕
│ │ ├── 📄 connection_pool.h # Connection pooling (~298 lines) 🆕
│ │ └── 📄 websocket.h # WebSocket client (~323 lines) 🆕
│ │
│ ├── 📁 security/ # Security Module Headers
│ │ ├── 📄 advanced_detector.h # Advanced detection
│ │ ├── 📄 honeypot.h # Honeypot system
│ │ ├── 📄 mem_diff.h # Memory diff
│ │ ├── 📄 memory_profiler.h # Memory profiling
│ │ ├── 📄 memory_tracker.h # Memory tracking
│ │ ├── 📄 race_detector.h # Race condition detector
│ │ ├── 📄 security_monitor.h # Security monitor
│ │ ├── 📄 shadow_mem.h # Shadow memory
│ │ ├── 📄 taint.h # Taint analysis
│ │ └── 📄 timeline.h # Timeline tracking
│ │
│ ├── 📁 collections/ # Data Structures Headers
│ │ ├── 📄 collections.h # Collections unified
│ │ ├── 📄 list.h # List container
│ │ └── 📄 map.h # Map container
│ │
│ ├── 📁 db/ # 🗄️ Database/ORM Headers (MAJOR UPDATE)
│ │ ├── 📄 orm.h # ORM API (~880 lines) ✨ REWRITTEN
│ │ ├── 📄 driver.h # Driver interface (~250 lines) 🆕
│ │ └── 📄 db_config.h # Configuration system (~260 lines) 🆕
│ │
│ ├── 📁 io/ # Input/Output Headers
│ │ ├── 📄 io.h # IO utilities
│ │ └── 📄 stream.h # Stream processing
│ │
│ ├── 📁 ui/ # UI Headers
│ │ └── 📄 tui.h # Terminal UI
│ │
│ ├── 📁 utils/ # Utility Headers
│ │ ├── 📄 builder.h # Builder pattern
│ │ ├── 📄 chain.h # Chain operations
│ │ ├── 📄 json.h # JSON handling
│ │ ├── 📄 lambda.h # Lambda support
│ │ ├── 📄 nullable.h # Nullable types
│ │ ├── 📄 optional.h # Optional types
│ │ └── 📄 template.h # Templates
│ │
│ └── 📁 test/ # Testing Headers
│ └── 📄 test.h # Test framework
│
├── 📁 src/ # 🔶 Source Implementation
│ ├── 📁 core/ # Core Implementation
│ │ ├── 📄 class.c # Class system
│ │ ├── 📄 exception.c # Exception handling
│ │ ├── 📄 interface.c # Interface system
│ │ ├── 📄 object.c # Object base
│ │ ├── 📄 properties.c # Properties
│ │ ├── 📄 reflect.c # Reflection
│ │ └── 📄 string.c # String ops
│ │
│ ├── 📁 memory/ # Memory Implementation
│ │ ├── 📄 alloc.c # Allocation
│ │ ├── 📄 cenom_gc.c # Garbage collector
│ │ ├── 📄 memory.c # Memory utils
│ │ ├── 📄 raii.c # RAII
│ │ ├── 📄 raii_enhanced.c # Enhanced RAII
│ │ └── 📄 smart_ptr.c # Smart pointers
│ │
│ ├── 📁 net/ # 🌐 Network Implementation (UPDATED)
│ │ ├── 📄 async.c # Async ops
│ │ ├── 📄 events.c # Events
│ │ ├── 📄 net.c # HTTP client (~650 lines) ✨ REWRITTEN
│ │ ├── 📄 server.c # HTTPS server (~770 lines) ✨ REWRITTEN
│ │ ├── 📄 socket.c # Socket layer (~1,050 lines) 🆕
│ │ ├── 📄 tls.c # OpenSSL TLS (~900 lines) 🆕
│ │ ├── 📄 http_parser.c # HTTP parsing (~770 lines) 🆕
│ │ ├── 📄 dns.c # DNS resolution (~320 lines) 🆕
│ │ ├── 📄 connection_pool.c # Connection pool (~400 lines) 🆕
│ │ └── 📄 websocket.c # WebSocket client (~700 lines) 🆕
│ │
│ ├── 📁 security/ # Security Implementation
│ │ ├── 📄 advanced_detector.c # Advanced detection
│ │ ├── 📄 honeypot.c # Honeypot
│ │ ├── 📄 mem_diff.c # Memory diff
│ │ ├── 📄 memory_profiler.c # Profiler
│ │ ├── 📄 memory_tracker.c # Tracker
│ │ ├── 📄 race_detector.c # Race detector
│ │ ├── 📄 security_monitor.c # Monitor
│ │ ├── 📄 shadow_mem.c # Shadow memory
│ │ ├── 📄 taint.c # Taint analysis
│ │ └── 📄 timeline.c # Timeline
│ │
│ ├── 📁 collections/ # Collections Implementation
│ │ ├── 📄 list.c # List
│ │ └── 📄 map.c # Map
│ │
│ ├── 📁 db/ # 🗄️ Database/ORM (MAJOR UPDATE)
│ │ ├── 📄 orm.c # Core ORM (~1,345 lines) ✨ REWRITTEN
│ │ ├── 📄 migration.c # Migration system (~350 lines) 🆕
│ │ ├── 📄 pool.c # DB Connection pooling (~212 lines) 🆕
│ │ ├── 📄 validator.c # Validation & Hooks (~270 lines) 🆕
│ │ ├── 📄 sqlite_driver.c # SQLite driver (~430 lines) 🆕
│ │ ├── 📄 postgres_driver.c # PostgreSQL driver (~631 lines) 🆕 ✅
│ │ ├── 📄 mysql_driver.c # MySQL driver (~725 lines) 🆕 ✅
│ │ ├── 📄 dialect.c # SQL dialect helpers (~340 lines) 🆕
│ │ └── 📄 db_config.c # Configuration system (~600 lines) 🆕
│ │
│ ├── 📁 io/ # IO Implementation
│ │ ├── 📄 io.c # IO
│ │ └── 📄 stream.c # Stream
│ │
│ ├── 📁 ui/ # UI Implementation
│ │ └── 📄 tui.c # Terminal UI
│ │
│ ├── 📁 utils/ # Utils Implementation
│ │ ├── 📄 json.c # JSON
│ │ ├── 📄 lambda.c # Lambda
│ │ ├── 📄 optional.c # Optional
│ │ └── 📄 template.c # Template
│ │
│ └── 📁 test/ # Test Implementation
│ └── 📄 test.c # Test framework
│
├── 📁 examples/ # 🔹 Example Programs
│ ├── 📁 core/ # Core Examples (14 files)
│ │ ├── 📄 animal_example.c # OOP demo
│ │ ├── 📄 dart_example.c # Dart syntax
│ │ ├── 📄 dart_pure_example.c # Pure Dart
│ │ ├── 📄 dartlike_example.c # Dart-like features
│ │ ├── 📄 generics_example.c # Generics demo
│ │ ├── 📄 highlevel_example.c # High-level API
│ │ ├── 📄 interface_example.c # Interface usage
│ │ ├── 📄 magic_intercept_demo.c # Magic intercept
│ │ ├── 📄 mixed_native_venom.c # Native integration
│ │ ├── 📄 modern_complex_example.c # Modern complex
│ │ ├── 📄 modern_syntax_example.c # Modern syntax
│ │ ├── 📄 reflection_example.c # Reflection demo
│ │ ├── 📄 template_example.c # Template demo
│ │ └── 📄 test_framework_example.c # Test framework
│ │
│ ├── 📁 memory/ # Memory Examples (8 files)
│ │ ├── 📄 benchmark_smart_pointers.c
│ │ ├── 📄 memory_tracker_example1.c
│ │ ├── 📄 memory_tracker_example2.c
│ │ ├── 📄 memory_usage_test.c
│ │ ├── 📄 raii_advanced_patterns.c
│ │ ├── 📄 raii_compiler_support.c
│ │ ├── 📄 smart_pointer_example.c
│ │ └── 📄 test_smart_pointers.c
│ │
│ ├── 📁 network/ # 🌐 Network Examples (8 files) (UPDATED)
│ │ ├── 📄 cenom_api_server.c # REST API server
│ │ ├── 📄 http_example.c # HTTP client
│ │ ├── 📄 io_async_example.c # Async IO
│ │ ├── 📄 lambda_async_example.c # Async lambdas
│ │ ├── 📄 server_example.c # Server demo
│ │ ├── 📄 stream_match_example.c # Stream matching
│ │ ├── 📄 https_test.c # HTTPS/TLS test (~165 lines) 🆕
│ │ └── 📄 http_client_test.c # HTTP client test (~95 lines) 🆕
│ │
│ ├── 📁 security/ # Security Examples (6 files)
│ │ ├── 📄 advanced_detection_example.c
│ │ ├── 📄 advanced_features_test.c
│ │ ├── 📄 comprehensive_security_test.c
│ │ ├── 📄 detector_test.c
│ │ ├── 📄 vulnerability_33_test.c
│ │ └── 📄 vulnerability_48_test.c
│ │
│ ├── 📁 data/ # Database Examples (1 file)
│ │ └── 📄 orm_example.c # ORM demo
│ │
│ ├── 📁 ui/ # UI Examples (2 files)
│ │ ├── 📄 cenom_tui_dashboard.c # TUI dashboard
│ │ └── 📄 tui_example.c # TUI demo
│ │
│ ├── 📁 algorithms/ # [Excluded] Algorithm Examples (10 files)
│ │ ├── 📄 algorithm_examples.c
│ │ ├── 📄 dp_example.c
│ │ ├── 📄 graph_example.c
│ │ ├── 📄 linked_list_example.c
│ │ ├── 📄 list_example.c
│ │ ├── 📄 map_example.c
│ │ ├── 📄 matrix_example.c
│ │ ├── 📄 set_example.c
│ │ ├── 📄 string_example.c
│ │ └── 📄 tree_example.c
│ │
│ └── 📁 legacy/ # [Archived] Legacy Examples (9 files)
│ ├── 📄 cenom_genesis.c
│ ├── 📄 comprehensive_test.c
│ ├── 📄 duplicate_test.c
│ ├── 📄 enterprise_ems_orm.c
│ ├── 📄 extended_test.c
│ ├── 📄 modern_showcase.c
│ ├── 📄 stress_test.c
│ ├── 📄 titan_ems_orm.c
│ └── 📄 ultimate_traffic_sim.c
│
├── 📁 tests/ # 🔸 Unit & Integration Tests
│ ├── 📁 core/ # Core Tests (2 files)
│ │ ├── 📄 test_basic.c
│ │ └── 📄 test_smart_perf.c
│ │
│ ├── 📁 memory/ # Memory Tests (5 files)
│ │ ├── 📄 benchmark_cenom_gc_vs_manual.c
│ │ ├── 📄 benchmark_gc_v6.c
│ │ ├── 📄 stress_test.c
│ │ ├── 📄 test_cenom_gc.c
│ │ └── 📄 test_visual_gc.c
│ │
│ ├── 📁 algorithms/ # [Excluded] Algorithm Tests (19 files)
│ │ ├── 📄 benchmark_algorithms.c
│ │ ├── 📄 benchmark_cenom_float.c
│ │ ├── 📄 cenom_king_search.c
│ │ ├── 📄 compare_cenom_sort.c
│ │ ├── 📄 test_all_algorithms.c
│ │ ├── 📄 test_cenom_dp.c
│ │ ├── 📄 test_cenom_float.c
│ │ ├── 📄 test_cenom_graph.c
│ │ ├── 📄 test_cenom_list.c
│ │ ├── 📄 test_cenom_ll.c
│ │ ├── 📄 test_cenom_map.c
│ │ ├── 📄 test_cenom_matrix.c
│ │ ├── 📄 test_cenom_seek.c
│ │ ├── 📄 test_cenom_set.c
│ │ ├── 📄 test_cenom_string.c
│ │ ├── 📄 test_cenom_string_seek.c
│ │ ├── 📄 test_cenom_tree.c
│ │ ├── 📄 test_native_graph.c
│ │ └── 📄 test_new_algorithms.c
│ │
│ ├── 📁 benchmarks/ # [Excluded] Benchmarks (7 files)
│ │ ├── 📄 benchmark_cenom_debug.c
│ │ ├── 📄 benchmark_native.c
│ │ ├── 📄 benchmark_oop.c
│ │ ├── 📄 benchmark_precision.c
│ │ ├── 📄 benchmark_pure.c
│ │ ├── 📄 benchmark_raw.c
│ │ └── 📄 benchmark_venom.c
│ │
│ └── 📁 legacy/ # [Archived] Legacy Tests (28 files)
│ ├── 📄 chaos_file_test.c
│ ├── 📄 test_cenom_cage.c
│ ├── 📄 test_cenom_cage_image.c
│ ├── 📄 test_cenom_ml_basic.c
│ ├── 📄 test_cenom_ml_knn.c
│ ├── 📄 test_cenom_vision_real.c
│ ├── 📄 test_extreme_latency.c
│ ├── 📄 test_neural_resonance.c
│ ├── 📄 test_omni_sync.c
│ ├── 📄 test_orm_adv.c
│ ├── 📄 test_orm_full.c
│ ├── 📄 test_phase2_enhancements.c
│ ├── 📄 test_phase3_enhancements.c
│ ├── 📄 test_phase5_enhancements.c
│ ├── 📄 test_phase6_enhancements.c
│ ├── 📄 test_qbp.c
│ ├── 📄 test_qgci_chained.c
│ ├── 📄 test_qgci_density.c
│ ├── 📄 test_qgci_discrimination.c
│ ├── 📄 test_qgci_fidelity.c
│ ├── 📄 test_qgci_gravity.c
│ ├── 📄 test_qgci_induction.c
│ ├── 📄 test_qgci_vsqn.c
│ ├── 📄 test_quantum_entanglement.c
│ ├── 📄 test_quantum_generator.c
│ ├── 📄 test_revolutionary_enhancements.c
│ ├── 📄 test_vsqn_speed.c
│ └── 📄 virus_shield_test.c
│
├── 📁 algorithms/ # 🔺 Algorithm Library
│ ├── 📁 DP/ # Dynamic Programming
│ │ ├── 📁 include/ # (1 header)
│ │ └── 📁 src/ # (5 source files)
│ │
│ ├── 📁 LinkedList/ # Linked List
│ │ ├── 📁 include/ # (1 header)
│ │ └── 📁 src/ # (3 source files)
│ │
│ ├── 📁 List/ # Dynamic List
│ │ ├── 📁 include/ # (1 header)
│ │ └── 📁 src/ # (4 source files)
│ │
│ ├── 📁 Map/ # Hash Map
│ │ ├── 📁 include/ # (1 header)
│ │ └── 📁 src/ # (4 source files)
│ │
│ ├── 📁 Matrix/ # Matrix Operations
│ │ ├── 📁 include/ # (1 header)
│ │ └── 📁 src/ # (3 source files)
│ │
│ ├── 📁 Set/ # Hash Set
│ │ ├── 📁 include/ # (1 header)
│ │ └── 📁 src/ # (4 source files)
│ │
│ ├── 📁 String/ # String Algorithms
│ │ ├── 📁 include/ # (1 header)
│ │ └── 📁 src/ # (3 source files)
│ │
│ ├── 📁 Tree/ # Tree Structures
│ │ ├── 📁 include/ # (1 header)
│ │ └── 📁 src/ # (4 source files)
│ │
│ ├── 📁 VenomFloat/ # Float Operations
│ │ ├── 📁 include/ # (1 header)
│ │ └── 📁 src/ # (1 source file)
│ │
│ ├── 📁 VenomStringSeek/ # String Search
│ │ ├── 📁 include/ # (1 header)
│ │ └── 📁 src/ # (1 source file)
│ │
│ └── 📁 graph/ # Graph Algorithms
│ ├── 📁 include/ # (10 headers)
│ │ ├── 📄 connectivity_native.h
│ │ ├── 📄 flow_native.h
│ │ ├── 📄 graph_native.h
│ │ ├── 📄 mincut_native.h
│ │ ├── 📄 mst_native.h
│ │ ├── 📄 pathfinding_native.h
│ │ ├── 📄 priority_queue.h
│ │ ├── 📄 specialized_native.h
│ │ ├── 📄 traversal_native.h
│ │ └── 📄 union_find_native.h
│ │
│ └── 📁 src/ # (10 source files)
│ ├── 📄 connectivity_native.c
│ ├── 📄 flow_native.c
│ ├── 📄 graph_native.c
│ ├── 📄 mincut_native.c
│ ├── 📄 mst_native.c
│ ├── 📄 pathfinding_native.c
│ ├── 📄 priority_queue.c
│ ├── 📄 specialized_native.c
│ ├── 📄 traversal_native.c
│ └── 📄 union_find_native.c
│
├── 📁 venom-watch/ # 🔻 Static Analyzer (Rust)
│ ├── 📄 Cargo.toml # Rust project config
│ ├── 📄 Cargo.lock # Dependency lock
│ ├── 📄 VenomWatchREADME.md # Analyzer documentation
│ ├── 📄 cenom_safe.h # Safe headers
│ │
│ ├── 📁 src/ # Rust Source
│ │ ├── 📄 main.rs # Entry point
│ │ ├── 📄 lib.rs # Library root
│ │ ├── 📄 models.rs # Data models
│ │ │
│ │ └── 📁 analysis/ # Analysis Modules
│ │ ├── 📄 mod.rs # Module root
│ │ ├── 📄 cfg.rs # Control flow graph
│ │ ├── 📄 concurrency.rs # Concurrency analysis
│ │ ├── 📄 core.rs # Core analysis
│ │ ├── 📄 engine.rs # Analysis engine
│ │ ├── 📄 layout.rs # Memory layout
│ │ ├── 📄 null_safety.rs # Null safety
│ │ ├── 📄 overflow.rs # Overflow detection
│ │ ├── 📄 ownership.rs # Ownership tracking
│ │ └── 📄 patcher.rs # Auto-patcher
│ │
│ └── 📄 ... (test files) # (20+ test .c files)
│
├── 📁 docs/ # 📚 Documentation
│ ├── 📄 README1.md # Overview 1
│ ├── 📄 README2.md # Overview 2
│ ├── 📄 01_core.md # Core features
│ ├── 📄 02_stdlib.md # Standard library
│ ├── 📄 03_modern.md # Modern features
│ ├── 📄 04_advanced.md # Advanced usage
│ ├── 📄 05_ecosystem.md # Ecosystem
│ ├── 📄 06_generics_reflection.md # Generics & Reflection
│ ├── 📄 07_database.md # Database/ORM
│ ├── 📄 08_web_server.md # Web server
│ ├── 📄 09_tools.md # Tools
│ ├── 📄 ALGORITHMS.md # Algorithm docs
│ ├── 📄 ADVANCED_DETECTOR_GUIDE.md # Detector guide
│ ├── 📄 MEMORY_TRACKER_GUIDE.md # Tracker guide
│ ├── 📄 MEMORY_TRACKER_INTEGRATION.md # Integration guide
│ └── 📄 MEMORY_TRACKER_README.md # Tracker readme
│
├── 📁 wiki/ # 📖 Cenom Wiki Encyclopedia 🆕
│ ├── 📄 README.md # Wiki home page & index
│ │
│ ├── 📁 db/ # 🗄️ Database/ORM Documentation (20 files)
│ │ ├── 📄 README.md # ORM overview
│ │ ├── 📄 01_quick_start.md # Quick start guide
│ │ ├── 📄 02_installation.md # Installation & setup
│ │ ├── 📄 03_database_config.md # Database configuration
│ │ ├── 📄 04_connection_pooling.md # Connection pooling
│ │ ├── 📄 05_multi_database.md # SQLite/PostgreSQL/MySQL
│ │ ├── 📄 06_models.md # Models & Reflection
│ │ ├── 📄 07_crud.md # CRUD operations
│ │ ├── 📄 08_query_builder.md # Query Builder
│ │ ├── 📄 09_relationships.md # Model relationships
│ │ ├── 📄 10_transactions.md # Transactions & savepoints
│ │ ├── 📄 11_migrations.md # Database migrations
│ │ ├── 📄 12_validation.md # Validation & Hooks
│ │ ├── 📄 13_soft_deletes.md # Soft deletes
│ │ ├── 📄 14_timestamps.md # Automatic timestamps
│ │ ├── 📄 15_caching.md # Query caching
│ │ ├── 📄 16_batch_operations.md # Batch operations
│ │ ├── 📄 17_api_reference.md # Complete API reference
│ │ ├── 📄 18_error_handling.md # Error handling
│ │ └── 📄 19_best_practices.md # Best practices
│ │
│ ├── 📁 core/ # 🔷 Core Framework (Coming Soon)
│ ├── 📁 memory/ # 💾 Memory Management (Coming Soon)
│ ├── 📁 net/ # 🌐 Networking (Coming Soon)
│ ├── 📁 security/ # 🔒 Security (Coming Soon)
│ └── 📁 collections/ # 📦 Collections (Coming Soon)
│
├── 📁 scripts/ # 🔧 Build & Test Scripts
│ ├── 📄 quickstart.sh # Quick start script
│ ├── 📄 run_all_tests.sh # Run all tests
│ ├── 📄 run_examples.sh # Run examples
│ ├── 📄 execute_cenom_binaries.sh # Execute binaries
│ │
│ └── 📁 test_results/ # Test Output (15 files)
│ └── 📄 *.txt # Individual test results
│
├── 📁 tools/ # 🛠️ Development Tools
│ ├── 📄 repl.c # REPL implementation
│ └── 📄 venom.c # Venom tool
│
├── 📁 report/ # 📊 Reports
│ ├── 📄 cenom_memory_report.txt # Memory report
│ ├── 📄 comprehensive_security.text # Security report
│ └── 📄 test_report.txt # Test report
│
└── 📁 build/ # 🏗️ Build Output
├── 📄 libcenom.a # Static library
├── 📄 libcenom_security.a # Static security lib
├── 📄 libcenom_security.so # Dynamic security lib
├── 📄 *.o # Object files
├── 📄 *_example # Example binaries
├── 📄 *_test # Test binaries
│
├── 📁 core/ # Core build artifacts
├── 📁 memory/ # Memory build artifacts
├── 📁 net/ # Network build artifacts
├── 📁 security/ # Security build artifacts
├── 📁 collections/ # Collections build artifacts
├── 📁 db/ # Database build artifacts
├── 📁 io/ # IO build artifacts
├── 📁 ui/ # UI build artifacts
├── 📁 utils/ # Utils build artifacts
├── 📁 test/ # Test build artifacts
└── 📁 report/ # Report output
| Component | Command | Output |
|---|---|---|
| Core Library + Examples | make examples |
build/ |
| Unit Tests | make tests |
build/ |
| Security Module | make -f Makefile.security all |
build/libcenom_security.* |
| Memory Tracker | make -f Makefile.tracker all |
build/ |
| Clean Build | make clean |
Removes all artifacts |
| Category | Count | Notes |
|---|---|---|
| Header Files | 86 | +6 network, +3 db headers |
| Source Files | 247 | +8 network, +5 db sources |
| Example Programs | 60 | +2 network examples |
| Test Files | 65 | +1 benchmark |
| Algorithm Modules | 11 | — |
| Documentation Files | 43 | +20 wiki pages |
| Scripts | 4 | — |
| Tools | 2 | — |
| Symbol | Meaning |
|---|---|
| 📁 | Directory |
| 📄 | File |
| 🔷 | Headers (include/) |
| 🔶 | Implementation (src/) |
| 🔹 | Examples |
| 🔸 | Tests |
| 🔺 | Algorithms Library |
| 🔻 | Static Analyzer |
| 📚 | Documentation |
| 🔧 | Scripts |
| 🛠️ | Tools |
| 🏗️ | Build Output |
| 📊 | Reports |
| 🌐 | Network Module (Updated) |
| 🆕 | New file (Jan 2026 Network Overhaul) |
| ✨ | Rewritten file |
| [Excluded] | Not built by default |
| [Archived] | Legacy/deprecated |
Line counts calculated using
wc -landfind- 17 January 2026
| File Type | Extension | Files Count | Lines Count | Percentage |
|---|---|---|---|---|
| C Source | .c |
272 | 64,182 | 52.5% |
| C Headers | .h |
86 | 16,223 | 13.3% |
| Markdown | .md |
76 | 24,518 | 20.1% |
| Rust | .rs |
56 | 16,249 | 13.3% |
| Shell Scripts | .sh |
5 | 387 | 0.3% |
| Text Files | .text |
1 | 392 | 0.3% |
| Component | Headers (Lines) | Source (Lines) | Total |
|---|---|---|---|
| ORM Core | ~880 | ~1,345 | ~2,225 |
| SQLite Driver | — | ~430 | ~430 |
| PostgreSQL Driver | — | ~631 | ~631 |
| MySQL Driver | — | ~725 | ~725 |
| Driver Interface | ~250 | — | ~250 |
| Migration | — | ~350 | ~350 |
| Pool | — | ~212 | ~212 |
| Validator | — | ~270 | ~270 |
| Dialect | — | ~340 | ~340 |
| Config | ~260 | ~600 | ~860 |
| المجموع | ~1,390 | ~4,903 | ~6,293 |
| المحتوى | عدد الملفات | عدد الأسطر |
|---|---|---|
| Wiki Pages | 20 | 16,642 |
╔═════════════════════════════════════════════════════════════════════╗
║ 📊 CENOM PROJECT METRICS ║
║ 17 January 2026 ║
╠═════════════════════════════════════════════════════════════════════╣
║ ║
║ 📝 C Source Code: 64,182 lines ║
║ 📄 C Headers: 16,223 lines ║
║ 🦀 Rust Code: 16,249 lines ║
║ 📚 Markdown Documentation: 24,518 lines ║
║ 🔧 Shell Scripts: 387 lines ║
║ 📄 Text Files: 392 lines ║
║ ║
║ ═══════════════════════════════════════════════════════════════ ║
║ 📦 GRAND TOTAL: 121,951 lines ║
║ ║
╠═════════════════════════════════════════════════════════════════════╣
║ 📁 Total Files: 496 files (C: 272, H: 86, RS: 56) ║
║ 🗄️ Database Drivers: SQLite ✅ | PostgreSQL ✅ | MySQL ✅ ║
║ 📖 Wiki Pages: 20 documentation files ║
╚═════════════════════════════════════════════════════════════════════╝
C Source Code ██████████████████████████░░░░░░░░░░░░░░░ 52.5%
Markdown Docs ████████████████░░░░░░░░░░░░░░░░░░░░░░░░ 20.1%
Rust Code █████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░ 13.3%
C Headers █████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░ 13.3%
Text Files ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.3%
Scripts ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.3%
# Required for TLS support
sudo apt install libssl-dev
# Build with OpenSSL
LDFLAGS = -lssl -lcrypto -lpthread -lm╔═════════════════════════════════════════════════════════════════════╗
║ Connection Pool Benchmark - PostgreSQL (1000 records) ║
╠═════════════════════════════════════════════════════════════════════╣
║ No Pool: 21,160 ms (47 ops/sec) 🐢 Baseline ║
║ With Pool: 870 ms (1,148 ops/sec) 🚀 24.3x faster ║
║ Pool+Batch: 233 ms (4,282 ops/sec) ⚡ 90.6x faster ║
╚═════════════════════════════════════════════════════════════════════╝
Last Updated: 17 January 2026 (Statistics Updated - 121,951 Total Lines)