spf13/afero

Health v2 · maintenance only

Adoption not part of the score

6692 stars · 570 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Afero is a filesystem abstraction library for Go that provides a universal interface over multiple storage backends, including local disk, in-memory, archives, and remote systems. It acts as a drop-in replacement for the standard os package, enabling easy testing and composable filesystem layers like caching, sandboxing, and path restriction.

Use cases

• mock the filesystem in Go unit tests
• swap file storage backends without changing application code
• sandbox file access to a subdirectory
• cache reads from a slow network filesystem
• read and write files inside zip or tar archives
• make Go code portable across local, cloud, and remote storage

When to choose

• you need fast, isolated filesystem tests without touching disk
• you want to abstract storage backends behind one interface
• you need layered filesystem behaviors like copy-on-write or caching
• you want os-package-compatible file APIs with io/fs support

When to avoid

• you only ever touch the local disk and never test file logic
• you need a POSIX-compliant full filesystem implementation
• your code depends on os-specific features outside the abstraction

Facets

library · maturity stable

file-system testing mocking developer-tools files testing go cross-platform filesystem-abstraction vfs in-memory-filesystem drop-in-replacement os-package

Member repositories

For agents

markdown · JSON · MCP: product_card(name="spf13/afero")