Foundation Libraries for the Dazzle Ecosystem

High-quality, reusable Python libraries that power DazzleTools, DazzleML, and DazzleNodes.

DazzleLib is a collection of foundational Python libraries designed to solve common development challenges with cross-platform compatibility, robust error handling, and minimal dependencies. Built on principles of composability and clarity, these libraries are the building blocks powering the entire Dazzle ecosystem.

Read our design philosophy →

Cross-platform file operations with verification and metadata preservation

pip install dazzle-filekit

File operations (copy, move, verify) with hash calculation, metadata preservation, and cross-platform path handling including Windows UNC paths.

Full documentation → | Repository →

Tree structure utilities for hierarchical data

pip install dazzletreelib

Generic tree data structures with traversal algorithms (DFS, BFS), visualization tools, and path-based operations.

Full documentation → | Repository →

Windows UNC path handling and network drive utilities

pip install unctools

Parse UNC paths, detect network drives, convert between drive letters and UNC paths, and handle long path names (>260 characters). Cross-platform safe with graceful no-ops on Unix systems.

Full documentation → | Repository →

# File operations with verification
from dazzle_filekit import copy_file, calculate_file_hash

copy_file("source.txt", "dest.txt", preserve_metadata=True)
hash_value = calculate_file_hash("file.txt", algorithm="sha256")

# Tree structures
from dazzletreelib import TreeNode

root = TreeNode("root")
child = root.add_child("child1")

# Windows UNC paths
from unctools import is_unc_path, parse_unc_path

if is_unc_path(r"\\server\share\file.txt"):
    server, share, path = parse_unc_path(r"\\server\share\file.txt")

• Design Philosophy - Principles and architectural decisions
• Library Roadmap - Current status and planned libraries
• dazzle-filekit Documentation - File operations
• dazzle-tree-lib Documentation - Tree structures
• UNCtools Documentation - UNC path handling

DazzleLib powers these projects in the Dazzle ecosystem:

DazzleTools: preserve, dazzlelink, relinker (future) DazzleML: File organization and training data management DazzleNodes: ComfyUI custom nodes file operations

Contributions are welcome! Each library has its own repository with contribution guidelines.

General Process:

1. Fork the library repository
2. Create a feature branch
3. Add tests for new functionality
4. Ensure all tests pass (pytest)
5. Submit a pull request

Read full contributing guidelines →

Learn about supporting DazzleLib →

If DazzleLib saves you time, consider sponsoring on GitHub or buying us a coffee

DazzleLib is one of five organizations in the Dazzle ecosystem:

• DazzleProj - Ecosystem coordination
• DazzleLib - Foundation libraries ← You are here
• DazzleTools - Command-line tools
• DazzleNodes - ComfyUI custom nodes
• DazzleML - AI development tools

All DazzleLib libraries are released under the MIT License for maximum compatibility with both open source and commercial projects.

See individual library repositories for specific license files.

• Issues: Use repository-specific issue trackers
• Discussions: GitHub Discussions
• Sponsorship: GitHub Sponsors
• Website: DazzleProj.com (coming soon)

Build better tools with DazzleLib 🛠️