exonware-xwnode 0.0.1.21__tar.gz → 0.0.1.23__tar.gz

exonware_xwnode-0.0.1.23/.gitignore

@@ -0,0 +1,288 @@
+# ========================================
+# eXonware {LIBRARY_NAME} .gitignore
+# ========================================
+
+# CI/CD Tools (keep private)
+.ci/
+
+# ========================================
+# Python
+# ========================================
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff
+instance/
+.webassets-cache
+
+# Scrapy stuff
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# ========================================
+# IDEs and Editors
+# ========================================
+
+# Visual Studio Code
+.vscode/
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+!.vscode/*.code-snippets
+
+# Local History for Visual Studio Code
+.history/
+
+# Built Visual Studio Code Extensions
+*.vsix
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# Sublime Text
+*.tmlanguage.cache
+*.tmPreferences.cache
+*.stTheme.cache
+*.sublime-workspace
+*.sublime-project
+
+# Vim
+*~
+*.swp
+*.swo
+*tmp
+
+# Emacs
+*~
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+auto-save-list
+tramp
+.\#*
+
+# ========================================
+# Operating Systems
+# ========================================
+
+# Windows
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+*.stackdump
+[Dd]esktop.ini
+$RECYCLE.BIN/
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+*.lnk
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon
+._*
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+# Linux
+*~
+.fuse_hidden*
+.directory
+.Trash-*
+.nfs*
+
+# ========================================
+# Development Tools
+# ========================================
+
+# Backup files
+*.bak
+*.backup
+*.tmp
+*.temp
+
+# Log files
+*.log
+logs/
+
+# Database files
+*.sqlite
+*.sqlite3
+*.db
+
+# Configuration files with secrets
+config.ini
+secrets.json
+.secrets
+credentials.json
+
+# Local environment files
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# ========================================
+# Test Runner Output Files (auto-generated)
+# ========================================
+**/runner_out.md
+tests/runner_out.md
+tests/*/runner_out.md
+tests/*/*/runner_out.md

exonware_xwnode-0.0.1.23/PKG-INFO

@@ -0,0 +1,188 @@
+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*

exonware_xwnode-0.0.1.23/README.md

@@ -0,0 +1,151 @@
+# 🚀 **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*