xwnode 0.9.0.20

Convenience wrapper for exonware-xwnode - provides 'import xwnode' alias

xwnode

Graph-shaped data with one API: many node and edge strategies, lots of query languages behind the same surface, and AUTO when you want the implementation chosen for you.

Longer write-up: README_LONG.md.

Company: eXonware.com · Author: eXonware Backend Team · Email: [e-mail]

---

Install

Install	What you get	When to use
pip install exonware-xwnode	Lite - core only	Smallest install.
pip install exonware-xwnode[lazy]	Lazy - backends pulled in when first used	Local dev.
pip install exonware-xwnode[full]	Full - common strategies pre-installed	CI or production bundles.

Requires xwsystem. Extras only add dependencies; the import path stays the same.

---

Quick start

from exonware.xwnode import XWNode

node = XWNode.from_native({
    'users': [{'name': 'Alice', 'age': 30, 'city': 'NYC'}, {'name': 'Bob', 'age': 25, 'city': 'LA'}],
    'products': {'laptop': {'price': 1000}, 'phone': {'price': 500}}
})

print(node['users'][0]['name'].value)   # Alice
results = node.query("SELECT * FROM users WHERE age > 25")
node.add_edge('Alice', 'Bob', {'relationship': 'friend'})
friends = node.neighbors('Alice')

Pick a mode explicitly (NodeMode.HASH_MAP, NodeMode.LSM_TREE, EdgeMode.COMPRESSED_GRAPH, EdgeMode.HNSW, …) or use NodeMode.AUTO. See REF_14_DX and REF_15_API.

---

What you get

Area	Contents
Node strategies	Hash maps, ordered structures, LSM-style trees, tries, learned indexes, and more behind one API.
Edge strategies	Adjacency, compressed graphs, HNSW, R-tree, quadtree, temporal layouts, …
Query	Many languages (SQL, GraphQL, Cypher, XPath, …) via xwquery.
Operations	WAL, Bloom filters, lock-free options, automatic strategy selection where enabled.

Status and roadmap: REF_22_PROJECT. Full strategy lists: REF_15_API, docs/.

---

Strategy Matrix - Possibilities

94 IMPLEMENTATIONS

63 NODE STRATEGIES x 31 EDGE STRATEGIES = 1,953 MIX-AND-MATCH COMBINATIONS

Choose any node strategy and pair it with any edge strategy under the same XWNode API surface.

Scientific compatibility note: Not every node-edge combination is semantically valid for every workload. Use strategy pairs that match the data model and query physics. Example: matrix/sparse-matrix representations and tree-centric representations solve different structural problems, so they should not be treated as equivalent.

Node strategy implementations (63)

Implementation	File
AdjacencyListStrategy	adjacency_list.py
AhoCorasickStrategy	aho_corasick.py
ArrayListStrategy	array_list.py
ARTStrategy	art.py
ASTStrategy	ast.py
AVLTreeStrategy	avl_tree.py
BPlusTreeStrategy	b_plus_tree.py
BTreeStrategy	b_tree.py
BitmapStrategy	bitmap.py
BitsetDynamicStrategy	bitset_dynamic.py
BloomFilterStrategy	bloom_filter.py
BloomierFilterStrategy	bloomier_filter.py
BwTreeStrategy	bw_tree.py
CircularBufferStrategy	circular_buffer.py
CountMinSketchStrategy	count_min_sketch.py
COWTreeStrategy	cow_tree.py
CRDTMapStrategy	crdt_map.py
CuckooHashStrategy	cuckoo_hash.py
DataInterchangeOptimizedStrategy	data_interchange_optimized.py
DawgStrategy	dawg.py
DequeStrategy	deque.py
ExtendibleHashStrategy	extendible_hash.py
FenwickTreeStrategy	fenwick_tree.py
HAMTStrategy	hamt.py
HashMapStrategy	hash_map.py
HeapStrategy	heap.py
HistogramStrategy	histogram.py
HopscotchHashStrategy	hopscotch_hash.py
HyperLogLogStrategy	hyperloglog.py
IntervalTreeStrategy	interval_tree.py
KdTreeStrategy	kd_tree.py
LearnedIndexStrategy	learned_index.py
LinearHashStrategy	linear_hash.py
LinkedListStrategy	linked_list.py
LRUCacheStrategy	lru_cache.py
LSMTreeStrategy	lsm_tree.py
MasstreeStrategy	masstree.py
OrderedMapStrategy	ordered_map.py
OrderedMapBalancedStrategy	ordered_map_balanced.py
PatriciaStrategy	patricia.py
PersistentTreeStrategy	persistent_tree.py
PriorityQueueStrategy	priority_queue.py
QueueStrategy	queue.py
RadixTrieStrategy	radix_trie.py
RangeMapStrategy	range_map.py
RedBlackTreeStrategy	red_black_tree.py
RoaringBitmapStrategy	roaring_bitmap.py
RopeStrategy	rope.py
SegmentTreeStrategy	segment_tree.py
SetHashStrategy	set_hash.py
SetTreeStrategy	set_tree.py
SkipListStrategy	skip_list.py
SparseMatrixStrategy	sparse_matrix.py
SplayTreeStrategy	splay_tree.py
StackStrategy	stack.py
SuffixArrayStrategy	suffix_array.py
TDigestStrategy	t_digest.py
TTreeStrategy	t_tree.py
TreapStrategy	treap.py
TreeGraphHybridStrategy	tree_graph_hybrid.py
TrieStrategy	trie.py
UnionFindStrategy	union_find.py
VebTreeStrategy	veb_tree.py

Edge strategy implementations (31)

Implementation	File
AdjListStrategy	adj_list.py
AdjMatrixStrategy	adj_matrix.py
BidirWrapperStrategy	bidir_wrapper.py
BitemporalStrategy	bitemporal.py
BlockAdjMatrixStrategy	block_adj_matrix.py
BVGraphStrategy	bv_graph.py
CompressedGraphStrategy	compressed_graph.py
COOStrategy	coo.py
CSCStrategy	csc.py
CSRStrategy	csr.py
DynamicAdjListStrategy	dynamic_adj_list.py
EdgeListStrategy	edge_list.py
EdgePropertyStoreStrategy	edge_property_store.py
EulerTourStrategy	euler_tour.py
FlowNetworkStrategy	flow_network.py
GraphBLASStrategy	graphblas.py
HNSWStrategy	hnsw.py
Hop2LabelsStrategy	hop2_labels.py
HyperEdgeSetStrategy	hyperedge_set.py
IncidenceMatrixStrategy	incidence_matrix.py
K2TreeStrategy	k2_tree.py
LinkCutStrategy	link_cut.py
MultiplexStrategy	multiplex.py
NeuralGraphStrategy	neural_graph.py
OctreeStrategy	octree.py
QuadTreeStrategy	quadtree.py
RoaringAdjStrategy	roaring_adj.py
RTreeStrategy	rtree.py
TemporalEdgeSetStrategy	temporal_edgeset.py
TreeGraphBasicStrategy	tree_graph_basic.py
WeightedGraphStrategy	weighted_graph.py

Source of truth: strategy classes discovered in src/exonware/xwnode/nodes/strategies/ and src/exonware/xwnode/edges/strategies/.

---

Docs and tests

• Start: docs/INDEX.md.
• Usage: docs/GUIDE_01_USAGE.md.
• REFs: REF_01_REQ, REF_22_PROJECT, REF_13_ARCH, REF_14_DX, REF_15_API, REF_51_TEST.
• Tests: docs/REF_51_TEST.md. Run: python tests/runner.py from repo root.

---

License and links

MIT - see LICENSE.

• Homepage: https://exonware.com
• Repository: https://github.com/exonware/xwnode

Async Support

• xwnode includes asynchronous execution paths in production code.
• Source validation: 522 async def definitions and 0 await usages under src/.
• Use async APIs for I/O-heavy or concurrent workloads to improve throughput and responsiveness.

Version: 0.9.0.20 | Updated: 31-Mar-2026

Built with ❤️ by eXonware.com - Revolutionizing Python Development Since 2025