Metadata-Version: 2.4
Name: exonware-xwnode
Version: 0.0.1.23
Summary: Node-based data processing and graph computation library
Project-URL: Homepage, https://exonware.com
Project-URL: Repository, https://github.com/exonware/xwnode
Project-URL: Documentation, https://github.com/exonware/xwnode#readme
Author-email: "Eng. Muhammad AlShehri" <connect@exonware.com>
License: MIT
License-File: LICENSE
Keywords: computation,data-processing,exonware,graph,node,workflow
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Requires-Dist: exonware-xwsystem
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: isort>=5.12.0; extra == 'dev'
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Provides-Extra: full
Requires-Dist: exonware-xwsystem[full]; extra == 'full'
Provides-Extra: lazy
Requires-Dist: exonware-xwsystem[lazy]; extra == 'lazy'
Description-Content-Type: text/markdown

# 🚀 **xwnode: Node-Based Data Processing Library**

**Company:** eXonware.com  
**Author:** Eng. Muhammad AlShehri  
**Email:** connect@exonware.com  
**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**
```bash
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**
```bash
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**
```bash
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**
```python
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](docs/STRATEGIES.md)**  

## 🚀 **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](docs/PROJECT_PHASES.md)**

## 📚 **Documentation**

- **[Strategy Selection Guide](docs/STRATEGIES.md)** - Complete 51-strategy matrix with production readiness status
- **[Production Readiness Summary](docs/PRODUCTION_READINESS_SUMMARY.md)** - Detailed improvements and test results
- **[API Documentation](docs/)** - Complete reference and examples
- **[Examples](examples/)** - Practical usage examples
- **[Tests](tests/)** - Test suites and usage patterns

## 🔧 **Development**

```bash
# 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*