exonware-xwnode 0.0.1.23

Node-based data processing and graph computation library

🚀 xwnode: Node-Based Data Processing Library

Company: eXonware.com
Author: Eng. Muhammad AlShehri
Email: [e-mail]
Version: 0.0.1.23 Last Updated: 11-Oct-2025

🎯 What is xwnode?

xwnode is a powerful Python library for node-based data processing and graph computation. It provides a flexible framework for building data processing workflows using interconnected nodes, enabling complex data transformations and computations through an intuitive graph-based approach.

⚡ Quick Start

Installation

xwnode offers three installation modes to match your needs:

Default (Lite) - Minimal Installation

pip install exonware-xwnode
# or
pip install xwnode

• ✅ Core node functionality
• ✅ Basic graph operations
• ✅ Essential data processing
• ✅ Zero external dependencies (beyond xwsystem)

Lazy - Auto-Install on Demand

pip install exonware-xwnode[lazy]
# or
pip install xwnode[lazy]

• ✅ Everything from default
• ✅ Automatic dependency installation
• ✅ Enterprise serialization on-demand
• ✅ Performance monitoring when needed

Full - Complete Feature Set

pip install exonware-xwnode[full]
# or
pip install xwnode[full]

• ✅ Everything from lazy
• ✅ All xwsystem serialization formats (50+)
• ✅ Advanced security features
• ✅ Performance monitoring
• ✅ Enterprise-grade capabilities

Basic Usage

from exonware.xwnode import XWNode, XWQuery, XWFactory
# Or use convenience import:
# import xwnode

# Your node-based processing code here
node = XWNode({'data': 'example'})

🎯 Perfect For:

• 🔄 Data Processing Pipelines - Build complex data transformation workflows
• 📊 Graph Computation - Process data through interconnected node networks
• 🔀 Workflow Management - Create reusable processing components
• 🧠 Algorithm Development - Implement graph-based algorithms and computations
• 🔗 System Integration - Connect different data processing stages

🚀 Key Features

✅ 57 Production-Ready Node Strategies - Comprehensive data structures (vEB Tree, DAWG, Interval Tree, k-d Tree, CRDT Map, Rope, and more)
✅ Advanced Persistent Structures - LSM Tree (WAL + Bloom filters), BW Tree (atomic CAS), Learned Index (ML-based)
✅ 28 Edge Strategies - Advanced graph representations (ADJ_LIST, k²-tree, BVGraph, HNSW, Euler Tour, Link-Cut, 2-Hop Labels, Multiplex, and more)
✅ 35 Query Languages - SQL, GraphQL, Cypher, SPARQL, XPath, JMESPath, and more
✅ Production Features - Version management, memory monitoring, background compaction, lock-free operations
✅ Node-based architecture for modular data processing
✅ Graph computation engine for complex workflows
✅ Flexible data flow between processing nodes
✅ Reusable components for common operations
✅ Performance optimized for large-scale processing
✅ Easy integration with existing Python data tools

🎯 Production-Grade Node Strategies (51 Total)

Linear Structures (7): Stack, Queue, Deque, Priority Queue, Linked List, Array List, Circular Buffer
Hash-Based (7): HashMap, OrderedMap, HAMT, Cuckoo Hash, Linear Hash, Extendible Hash, Set Hash
Tree Structures (18): AVL, Red-Black, B-Tree, B+ Tree, Trie, Radix, Patricia, Splay, Treap, Skip List, Heap, ART, and more
Advanced (5): LSM Tree (WAL + Bloom), BW Tree (atomic CAS), Learned Index (ML), Persistent Tree (versioning), COW Tree (memory monitoring)
Matrix/Bitmap (5): Bitmap, Dynamic Bitset, Roaring Bitmap, Sparse Matrix, Adjacency List
Probabilistic (3): Bloom Filter, Count-Min Sketch, HyperLogLog
Specialized (6): Union Find, Segment Tree, Fenwick Tree, Suffix Array, Aho-Corasick, Data Interchange

📖 Complete Strategy Guide & Selection Matrix

🚀 Project Phases

xWNode follows a structured 5-phase development approach designed to deliver enterprise-grade functionality while maintaining rapid iteration and continuous improvement.

Current Phase: 🧪 Version 0 - Experimental Stage

• Focus: Fast applications & usage, refactoring to perfection of software patterns and design
• Status: 🟢 ACTIVE - Foundation complete with core node functionality, graph traversal algorithms, and comprehensive testing

Development Roadmap:

• Version 1 (Q1 2026): Production Ready - Enterprise deployment and hardening
• Version 2 (Q2 2026): Mars Standard Draft Implementation - Cross-platform interoperability
• Version 3 (Q3 2026): RUST Core & Facades - High-performance multi-language support
• Version 4 (Q4 2026): Mars Standard Implementation - Full compliance and enterprise deployment

📖 View Complete Project Phases Documentation

📚 Documentation

• Strategy Selection Guide - Complete 51-strategy matrix with production readiness status
• Production Readiness Summary - Detailed improvements and test results
• API Documentation - Complete reference and examples
• Examples - Practical usage examples
• Tests - Test suites and usage patterns

🔧 Development

# Install in development mode
pip install -e .

# Run tests
python tests/runner.py

# Run specific test types
python tests/runner.py --core
python tests/runner.py --unit
python tests/runner.py --integration

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Run the test suite
6. Submit a pull request

📄 License

MIT License - see LICENSE file for details.

---

Built with ❤️ by eXonware.com - Making node-based data processing effortless