Summary

Remove the Dir struct and move all directory resolution methods to module-level functions, simplifying the API from Dir::config_home() to config_home().

Type of Change

• 🐛 Bug fix (non-breaking change that fixes an issue)
• ✨ New feature (non-breaking change that adds functionality)
• 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
• 📚 Documentation update
• 🧹 Code cleanup or refactoring
• 🔧 Build system or dependency changes
• 🧪 Test improvements

What Changed?

• Removed Dir struct entirely - All static methods have been moved to module-level functions
• Updated all function calls - Changed from Dir::config_home() to config_home() pattern for all 19 directory functions
• Updated documentation - All examples in lib.rs, README.md, and function docs now use the new API
• Updated tests - All test modules now use direct function calls instead of Dir:: prefixed calls
• Version bump - Updated to v0.5.0 in Cargo.toml to reflect breaking changes
• CHANGELOG updated - Added comprehensive v0.5.0 entry documenting all breaking changes
• Migration guide created - Added detailed migration guide at docs/migration_guides/0.4.x-0.5.0.md

Why?

1. Simpler API - Removes redundant Dir:: prefix, making function calls more concise
2. More idiomatic Rust - Module-level functions are more common than static methods on empty structs
3. Better discoverability - IDE autocomplete shows all available functions directly when importing the crate
4. Cleaner imports - Users can import specific functions they need: use dir_spec::{config_home, cache_home};
5. Reduced cognitive overhead - No need to remember to use Dir:: prefix for every call

How Has This Been Tested?

• Existing tests pass (mise test)
• New tests added for new functionality - All existing tests updated to use new API
• Manual testing performed - Verified examples in docs work correctly
• Code follows style guidelines (mise lint)

Additional verification:

• cargo check - Compilation verified
• cargo doc - Documentation builds successfully
• All 19 directory functions tested across Linux/macOS/Windows
• XDG environment variable handling unchanged
• Platform-specific fallbacks unchanged
• No Dir:: references remain in codebase (verified with grep)

Screenshots/Demo

Before (v0.4.0):

use dir_spec::Dir;

let config = Dir::config_home();
let cache = Dir::cache_home();

After (v0.5.0):

use dir_spec::{config_home, cache_home};

let config = config_home();
let cache = cache_home();

Additional Notes

• Migration is straightforward - Mostly find/replace of Dir::function_name( with function_name(
• No functional changes - All directory resolution logic remains identical
• Comprehensive migration guide - Includes automated migration scripts and complete examples
• Backward compatibility - This is intentionally a breaking change to clean up the API before 1.0

The core functionality remains exactly the same - this is purely an API ergonomics improvement that makes the library more pleasant to use and more idiomatic Rust.