Urchin  v0.1.0

Documentation specific to v0.1.0

Tests are organized recursively in directories, where the names of the files and directories have special meanings.

tests/
  setup
  setup_dir
  bar/
    setup
    test_that_something_works
    teardown
  baz/
    jack-in-the-box/
      setup
      test_that_something_works
      teardown
    cat-in-the-box/
      fixtures/
        thingy.pdf
      test_thingy
  teardown

Directories are processed in a depth-first order. When a particular directory is processed, setup_dir is sourced before everything else in the directory, including subdirectories. teardown_dir is sourced after everything else in the directory.

A directory's setup file, if it exists, is sourced right before each test file within the particular directory is run, and the teardown file is sourced right after.