Major Refactor to Codebase Directory

[EdwardJXLi]

Existing Implementation:

• Mirrors how codebase.files operates
• dir.files returns a recursive list of all source files
• dir.subdirectories returns a recursive list of all directories
• A reference between the file and directory is built during parse time (files hold a reference to dir, and dirs hold references to files)

New Implementation:

• Mirrors more closely to the conceptual idea of a directory
• dir.files returns all top level source files
• dir.files now has a extensions argument just like codebase
• dir.subdirectories returns all top level directories
• Both dir.files and dir.subdirectories have a recursive=True flag to get everything (similar to old behaviour)
• Introduces a dir.tree api to recursively list everything
• dir.items is now a list
• Directories and files are grabbed on the fly instead of being linked during parse time (file grabs directories using ctx.get_directory on the fly and vice versa)

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

✅ All tests successful. No failed tests found.

Additional details and impacted files

Addressed changes

[github-actions]

🎉 This PR is included in version 0.34.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀