test_descriptor 1.0.3

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")
      ])
    ]).create();

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

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

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.

1.0.3

  • Stop using comment-based generics.

1.0.2

  • Declare support for async 2.0.0.

1.0.1

  • 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.

1.0.0

  • Initial version.

1. Depend on it

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

dependencies:
  test_descriptor: "^1.0.3"

2. Install it

You can install packages from the command line:

with pub:


$ pub get

with Flutter:


$ flutter packages get

Alternatively, your editor might support pub get or packages 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';

Platforms

About

An API for defining and verifying directory structures.

Author

Dart Team

Homepage

github.com/dart-lang/test_descriptor

Documentation

www.dartdocs.org/documentation/test_descriptor/1.0.3/

Uploader

nweiz@google.com

License

BSD (LICENSE)

Published

Oct 17, 2017