Build Status Coverage Status

File

A generic file system abstraction for Dart.

Like dart:io, package:file supplies a rich Dart-idiomatic API for accessing a file system.

Unlike dart:io, package:file:

  • Can be used to implement custom file systems.
  • Comes with an in-memory implementation out-of-the-box, making it super-easy to test code that works with the file system.
  • Allows using multiple file systems simultaneously. A file system is a first-class object. Instantiate however many you want and use them all.

Usage

Implement your own custom file system:

import 'package:file/file.dart';

class FooBarFileSystem implements FileSystem { ... }

Use the in-memory file system:

import 'package:file/memory.dart';

var fs = new MemoryFileSystem();

Use the local file system (requires dart:io access):

import 'package:file/local.dart';

var fs = const LocalFileSystem();

Libraries

chroot

A file system that provides a view into another FileSystem via a path.

file

Core interfaces containing the abstract FileSystem interface definition and all associated types used by FileSystem.

local

A local file system implementation. This relies on the use of dart:io and is thus not suitable for use in the browser.

memory

An implementation of FileSystem that exists entirely in memory with an internal representation loosely based on the Filesystem Hierarchy Standard.

record_replay

File systems that work together to record invocations during live operation and then play invocations back in tests.

testing

Matchers (from package:test) for use in tests that deal with file systems.