v0.8.5 - First PyPI Release

folder-datetime-fix v0.8.5 -- first PyPI release

Fix folder "modified" dates that get clobbered when the OS drops housekeeping files (thumbs.db, .DS_Store, ...) into your folders -- now a one-line install on Windows, macOS, and Linux.

Install

pip install folder-datetime-fix

Then run the short fdtfix command (the folder-datetime-fix and mod_fldr_dt commands also work):

fdtfix . --fix-all --dry-run   # preview first
fdtfix . --fix-all             # apply

Highlights (the 0.8.x line)

• On PyPI -- pip install folder-datetime-fix; dependencies (DazzleTreeLib, dazzle-filekit) resolve automatically. Published via PyPI Trusted Publishing (OIDC -- no stored token).
• Cross-platform -- runs on Windows / macOS / Linux. Recognises platform "litter" (Windows thumbs.db/desktop.ini, macOS .DS_Store/._*/ .Spotlight-V100/..., Linux .directory/.hidden) and skips VCS metadata dirs (.git, .svn, .hg) by default -- while leaving user files like .gitignore alone.
• cp1252-safe CLI -- tree/help output no longer crashes on a legacy Windows console; it degrades to ASCII when the console can't encode emoji/box glyphs.
• src/ layout -- standard packaging; the test suite runs against the installed package.
• fdtfix short command plus the fdtfix.py no-install shim for running straight from a git clone.

Requirements

• Python 3.9+

Verification

Built wheel installs in a clean venv and pulls the dependency stack from PyPI; the fdtfix entry point runs. CI green across Windows/macOS/Linux x Python 3.9-3.12.

v0.7.2 - Alpha Release with DazzleTreeLib Integration

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

• README - Quick start and overview
• CHANGELOG - Detailed version history
• Troubleshooting Guide - Debugging and advanced usage

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.