text / tests / README.markdown

Tests

This directory contains the tests for the Text library. To run these tests, you will need the test data from one of the following locations:

You should clone that repository to the same directory as this README file, then run make to uncompress the test files. Many tests will fail if the test files are missing.

There are two categories of tests: functional tests (including QuickCheck properties), and benchmarks.

Functional tests

The functional tests are located in the tests subdirectory. An overview of what's in that directory:

scripts           Various utility scripts
src               Source files of the testing code
text-tests.cabal  Cabal file which compiles all benchmarks
Makefile          Has targets for common tasks

The text-tests.cabal builds:

  • A copy of the text library, sharing the source code, but exposing all internal modules, for testing purposes
  • The different test suites

To compile, run all tests, and generate a coverage report, simply use make.

Benchmarks

The benchmarks are located in the benchmarks subdirectory. An overview of what's in that directory:

python            Python implementations of some benchmarks
ruby              Ruby implementations of some benchmarks
src               Source files of the haskell benchmarks
benchmarks.cabal  Cabal file which compiles all benchmarks
Makefile          Has targets for common tasks

To compile the benchmarks, navigate to the benchmarks subdirectory and run cabal configure && cabal build. Then, you can run the benchmarks using:

./dist/build/benchmarks/benchmarks

However, since there quite a lot of benchmarks, you usually don't want to run them all. Instead, use the -l flag to get a list of benchmarks:

./dist/build/benchmarks/benchmarks

And run the ones you want to inspect. If you want to configure the benchmarks further, the exact parameters can be changed in src/Data/Text/Benchmarks.hs.

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.