nextcloud-desktop/test/scripts
Olivier Goffart 1e43d1fa49 Add missing license headers in tests
LGPL for csync tests,  GPL for mirall tests
2014-02-24 11:08:58 +01:00
..
references Add torture scripts + standard layout files 2013-06-05 21:36:55 +02:00
README.rst torture scripts: fix description 2013-06-06 11:05:21 +02:00
torture_create_files.pl Add missing license headers in tests 2014-02-24 11:08:58 +01:00
torture_gen_layout.pl Add missing license headers in tests 2014-02-24 11:08:58 +01:00

Torture for Mirall

This is a set of scripts comprising of two parts:

  • torture_gen_layout.pl: Generation of layout files (random)
  • torture_create_files.pl: Generation of a real file tree based on the layout files (deterministic)

These scripts allow to produce a data set with the following criteria:

  • realistic in naming
  • realistic in file size
  • realistic in structural size

without checking in the actual data. Instead, a layout file that gets generated once (reference.lay) is checked in. This makes it possible to produce standardized benchmarks for mirall. It allows allows to check for files gone missing in action and other kinds of corruption produced during sync run.

torture_create_files.pl can be fine tuned via variables in the script header. It sources its file names from dict wordlist, file extensions and other parameters can be added as needed. The defaults should be reasonable in terms of size.

The references/ directory contains default folder layouts.

Usage

In order to create a reference layout and create a tree from it:

./torture_gen_layout.pl > reference.lay
./torture_create_files.pl reference.lay <targetdir>

TODO

  • Based on the layout file, write a validator that checks files for existence and size without requiring a full reference tree to be created via ./torture_gen_layout.pl.
  • The current file naming is fairly tame (i.e. almost within ASCII range). Extending it randomly is dangerous, we first need to filter all characters forbidden by various OSes. Or maybe not, because we want to see what happens? :-). Anyway, you have been warned.