test_descriptor 1.0.2

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.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.2"

2. Install it

You can install packages from the command line:

$ 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';

Platforms

About

An API for defining and verifying directory structures.

Author

Email misc@dartlang.org Dart Team

Homepage

github.com/dart-lang/test_descriptor

Documentation

www.dartdocs.org/documentation/test_descriptor/1.0.2/

Source code (hyperlinked)

www.crossdart.info/p/test_descriptor/1.0.2/

Uploader

nweiz@google.com

License

BSD

Published

Sep 22, 2017

Share