Skip to content

Releases: DazzleTools/folder-datetime-fix

v0.7.2 - Alpha Release with DazzleTreeLib Integration

24 Sep 10:02
@djdarcy djdarcy
v0.7.2
568c72e

Choose a tag to compare

View all tags
v0.7.2 - Alpha Release with DazzleTreeLib Integration Pre-release
Pre-release

What's New

This alpha release represents a major architectural enhancement of Folder DateTime Fix. The project has evolved from a utility script to a well-tested tool with significant performance improvements and architectural refinements.

Key Features

Performance & Architecture

  • DazzleTreeLib Integration: Complete migration to external tree traversal library achieving 82% code reduction
  • Smart Caching: 57% performance improvement with intelligent cache completeness tracking
  • Unlimited Depth Support: Previously capped at 3 levels, now handles any directory depth
  • Robust Error Handling: Enhanced permission error recovery with PolicyDrivenErrorAdapter

User Experience

  • Transformed Documentation: User-focused README with clear problem/solution presentation
  • 3-Step Quick Start: Get running in seconds with --fix-all command
  • Troubleshooting Guide: Comprehensive debugging documentation moved to dedicated file
  • Visual Improvements: Fixed ASCII tree diagrams for better depth visualization

Development & Quality

  • Multi-OS Testing: CI/CD pipeline now tests on Ubuntu, Windows, and macOS
  • Python 3.8-3.12 Support: Dropped EOL Python 3.7, added 3.12 testing
  • 188+ Tests: Comprehensive test suite including regression tests for Issues #15-17
  • GPL-3.0 License: Properly licensed for open source distribution

Installation

# From source
git clone https://github.com/djdarcy/folder-datetime-fix.git
cd folder-datetime-fix
pip install -e .

Quick Start

Fix folder timestamps corrupted by Windows system files:

# Preview changes first
folder-datetime-fix . --fix-all --dry-run

# Apply the fix
folder-datetime-fix . --fix-all

Breaking Changes

  • Python 3.7 Dropped: Minimum version is now Python 3.8
  • DazzleTreeLib Required: Now depends on DazzleTreeLib >= 0.9.2
  • Cache System: Migrated from enum-based to integer-based depth tracking

What's Changed Since Initial Development

Major Milestones

  • August 28: Initial release with core functionality
  • August 29: 57% performance boost with smart caching
  • August 30: Revolutionary modular help system
  • September 3: DazzleTreeLib integration and error handling
  • September 23: Documentation overhaul and multi-OS CI/CD

Statistics

  • Code Reduction: 82% through library integration
  • Performance Gain: 57% faster with caching
  • Test Coverage: 188+ comprehensive tests
  • Platform Support: 3 operating systems × 5 Python versions

Documentation

Contributors

Thanks to everyone who contributed to making this tool better.

Full Changelog

See CHANGELOG.md for complete version history.

Note: This is an alpha release ready for testing and feedback. While the core functionality is solid with 188+ tests, users should test thoroughly in their environments before production use. Future releases will continue to improve stability and features based on user feedback.

Loading