test_descriptor 1.0.3

  • README.md
  • Installing
  • Versions
  • 45

The test_descriptor package provides a convenient, easy-to-read API for defining and verifying directory structures in tests.

We recommend that you import this library with the d prefix. The d.dir() and d.file() functions are the main entrypoints. They define a filesystem structure that can be created using Descriptor.create() and verified using Descriptor.validate(). For example:

import 'dart:io';

import 'package:test_descriptor/test_descriptor.dart' as d;

void main() {
  test("Directory.rename", () async {
    await d.dir("parent", [
      d.file("sibling", "sibling-contents"),
      d.dir("old-name", [
        d.file("child", "child-contents")

    await new Directory("${d.sandbox}/parent/old-name")

    await d.dir("parent", [
      d.file("sibling", "sibling-contents"),
      d.dir("new-name", [
        d.file("child", "child-contents")

By default, descriptors create entries in a temporary sandbox directory, d.sandbox. A new sandbox is automatically created the first time you create a descriptor in a given test, and automatically deleted once the test finishes running.

This package is term_glyph aware. It will decide whether to use ASCII or Unicode glyphs based on the glyph.ascii attribute.


  • Stop using comment-based generics.


  • Declare support for async 2.0.0.


  • FileDescriptor.validate() now allows invalid UTF-8 files.

  • Fix a bug where DirectoryDescriptor.load() would incorrectly report that multiple versions of a file or directory existed.


  • Initial version.

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:

  test_descriptor: ^1.0.3

2. Install it

You can install packages from the command line:

with pub:

$ pub get

Alternatively, your editor might support pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:test_descriptor/test_descriptor.dart';
Version Uploaded Documentation Archive
1.1.1 Jul 13, 2018 Go to the documentation of test_descriptor 1.1.1 Download test_descriptor 1.1.1 archive
1.1.0 Jun 19, 2018 Go to the documentation of test_descriptor 1.1.0 Download test_descriptor 1.1.0 archive
1.0.4 Jun 15, 2018 Go to the documentation of test_descriptor 1.0.4 Download test_descriptor 1.0.4 archive
1.0.3 Oct 17, 2017 Go to the documentation of test_descriptor 1.0.3 Download test_descriptor 1.0.3 archive
1.0.2 Sep 22, 2017 Go to the documentation of test_descriptor 1.0.2 Download test_descriptor 1.0.2 archive
1.0.1 Jun 1, 2017 Go to the documentation of test_descriptor 1.0.1 Download test_descriptor 1.0.1 archive
1.0.0 Mar 11, 2017 Go to the documentation of test_descriptor 1.0.0 Download test_descriptor 1.0.0 archive
Describes how popular the package is relative to other packages. [more]
Code health derived from static analysis. [more]
Reflects how tidy and up-to-date the package is. [more]
Weighted score of the above. [more]
Learn more about scoring.

The package version is not analyzed, because it does not support Dart 2. Until this is resolved, the package will receive a health and maintenance score of 0.

Issues and suggestions

Support Dart 2 in pubspec.yaml.

The SDK constraint in pubspec.yaml doesn't allow the Dart 2.0.0 release. For information about upgrading it to be Dart 2 compatible, please see https://www.dartlang.org/dart-2#migration.


Package Constraint Resolved Available
Direct dependencies
Dart SDK >=1.21.0 <2.0.0