{"adoption": {"forks": 198, "observed_at": "2026-08-28T04:07:06.320875+00:00", "stars": 2637}, "canonical_url": "https://ross.abutalabs.com/products/johnsundell-files", "card": {"archived": false, "artifact_type": "library", "description": "A nicer way to handle files & folders in Swift", "domain": ["developer-tools", "files", "cross-platform"], "enriched": true, "function": ["file-system", "developer-tools"], "health_score": 47, "homepage": null, "language": "Swift", "license": "MIT", "license_family": "permissive", "maturity": "stable", "member_repos": ["JohnSundell/Files"], "name": "JohnSundell/Files", "platform": [], "pushed_at": "2025-05-30T11:22:15+00:00", "repo": "JohnSundell/Files", "stars": 2637, "tags": ["swift-scripting", "filemanager-wrapper", "folders", "macos", "linux", "ios", "swift"], "topics": ["files", "folders", "swift", "script", "swift-script", "xcode"], "urls": [], "use_cases": ["iterate over files in a folder in a swift script", "rename files in a folder programmatically", "recursively walk a folder tree in swift", "create, write, and delete files and folders", "move files between folders in a command line tool", "access system folders like home and documents in swift"], "what_it_is": "Files is a compact Swift library offering a modern, object-oriented API for reading, writing, and managing files and folders, wrapping Foundation's FileManager. It is aimed primarily at Swift scripting and tooling but can also be embedded in apps.", "when_to_avoid": ["you need advanced file system features like watching, permissions, or streaming I/O", "your project is not written in Swift", "you need cross-language file handling outside the Apple/Linux Swift ecosystem"], "when_to_choose": ["you write Swift scripts or command line tools that manipulate the file system", "you want a cleaner, object-oriented alternative to raw FileManager APIs", "you need unified do-try-catch error handling for file operations"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/johnsundell-files", "repo": "JohnSundell/Files", "role": "main", "score": 34}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T02:19:17.283800+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "41b06bad20109e55195c5f138dc33fa38a86dea2f638ac433fdab4e60b8832af", "fetched_at": "2026-08-28T04:07:06.320875+00:00", "kind": "readme", "missing": false, "url": "https://github.com/JohnSundell/Files"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T02:19:17.283800+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "41b06bad20109e55195c5f138dc33fa38a86dea2f638ac433fdab4e60b8832af", "fetched_at": "2026-08-28T04:07:06.320875+00:00", "kind": "readme", "missing": false, "url": "https://github.com/JohnSundell/Files"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T02:19:17.283800+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "41b06bad20109e55195c5f138dc33fa38a86dea2f638ac433fdab4e60b8832af", "fetched_at": "2026-08-28T04:07:06.320875+00:00", "kind": "readme", "missing": false, "url": "https://github.com/JohnSundell/Files"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T02:19:17.283800+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "41b06bad20109e55195c5f138dc33fa38a86dea2f638ac433fdab4e60b8832af", "fetched_at": "2026-08-28T04:07:06.320875+00:00", "kind": "readme", "missing": false, "url": "https://github.com/JohnSundell/Files"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T02:19:17.283800+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "41b06bad20109e55195c5f138dc33fa38a86dea2f638ac433fdab4e60b8832af", "fetched_at": "2026-08-28T04:07:06.320875+00:00", "kind": "readme", "missing": false, "url": "https://github.com/JohnSundell/Files"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T02:19:17.283800+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "41b06bad20109e55195c5f138dc33fa38a86dea2f638ac433fdab4e60b8832af", "fetched_at": "2026-08-28T04:07:06.320875+00:00", "kind": "readme", "missing": false, "url": "https://github.com/JohnSundell/Files"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:07:06.320875+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T02:19:17.283800+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "41b06bad20109e55195c5f138dc33fa38a86dea2f638ac433fdab4e60b8832af", "fetched_at": "2026-08-28T04:07:06.320875+00:00", "kind": "readme", "missing": false, "url": "https://github.com/JohnSundell/Files"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T02:19:17.283800+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "41b06bad20109e55195c5f138dc33fa38a86dea2f638ac433fdab4e60b8832af", "fetched_at": "2026-08-28T04:07:06.320875+00:00", "kind": "readme", "missing": false, "url": "https://github.com/JohnSundell/Files"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T02:19:17.283800+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "41b06bad20109e55195c5f138dc33fa38a86dea2f638ac433fdab4e60b8832af", "fetched_at": "2026-08-28T04:07:06.320875+00:00", "kind": "readme", "missing": false, "url": "https://github.com/JohnSundell/Files"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T02:19:17.283800+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "41b06bad20109e55195c5f138dc33fa38a86dea2f638ac433fdab4e60b8832af", "fetched_at": "2026-08-28T04:07:06.320875+00:00", "kind": "readme", "missing": false, "url": "https://github.com/JohnSundell/Files"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 24, "longevity": 100, "rhythm": 8}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 3517, "days_push": 460, "days_rel": 460, "gap_med": null, "n_releases_24m": 1}, "score": 34, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}