feat: split file system out into create-fs package, with diffCreatedDirectory tester

[JoshuaKGoldberg]

PR Checklist

• Addresses an existing open issue: fixes 🚀 Feature: End-to-end testing API to treat folders on disk as snapshots #38; fixed 🛠 Tooling: Extract file system into its own module #40
• That issue was marked as status: accepting prs
• Steps in CONTRIBUTING.md were taken

Overview

Splits the file system and files creation types into a separate create-fs module. They have a few renames, mostly around switching CreatedFiles to CreatedDirectory.

Adds two important high-level APIs:

• create-fs > intakeFromDirectory: Reads files from disk into a CreatedDirectory
  • This intentionally doesn't use the ReadingFileSystem type because I don't want to add the concept of fs.stat to that system
• create-testers > diffCreatedDirectory: Given an actual directory, i.e. from intakeFromDirectory, and a produced Creation, returns an object describing their differences

This is intentionally different from the tester API proposed in #38. I don't feel ready yet to commit to a particular high-level API for repository templates. For now I'd rather provide lower-level pieces and explore using them.

💝

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
create	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jan 14, 2025 6:08pm

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 98.51%. Comparing base (67fbd7a) to head (b8385fb).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #129      +/-   ##
==========================================
+ Coverage   98.35%   98.51%   +0.16%     
==========================================
  Files         174      179       +5     
  Lines        6124     6520     +396     
  Branches      896      961      +65     
==========================================
+ Hits         6023     6423     +400     
+ Misses         98       94       -4     
  Partials        3        3              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.