# grainfs
An simple & lightweight file system API library.
This library abstracts away the mess that working with `std::path` and `std::fs` modules is, and exposes some functions you'd often use in your application (e.g. reading files, writing to files, checking if a file exists, etc).
Module overview:
- `path` - general path operations
- `dir` - directory operations
- `file` - file operations
- `types` - definitions for different filetypes
- `search` - basic searching functionality
- `env` - read environment variables (not fs per se, but environment variables are often paired with fs operations, so a lightweight API was included)
## Scope
This is meant to be a tiny, dependency-free repo for a more pleasant experience when working with the file system API.
While this *is* technically a reinvention of the wheel, the amount of cognitive strain this library saves me from when working with files is worth the effort I put into it.
## Stability
Expect breaking changes at any point until version `1.0.0`.
## Contributions
Any contributions are welcome!