fmf 0.4.1

Description

The fmf Python module and command line tool implement a flexible format for defining metadata in plain text files which can be stored close to the source code and structured in a hierarchical way with support for inheritance.

Although the proposal initially originated from user stories centered around test execution, the format is general and thus can be used in broader scenarios, e.g. test coverage mapping.

Using this approach it’s also possible to combine both test execution metadata and test coverage information. Thanks to elasticity and hierarchy it provides ability to organize data into well-sized text documents while preventing duplication.

Synopsis

Command line usage is straightforward:

fmf [path...] [options]

Examples

List all metadata stored in the current directory:

fmf

Show all test metadata (with ‘test’ attribute defined):

fmf --key test

List test names only:

fmf --key test --brief

Show metddata for all tree nodes (not only leaves):

fmf --key test --whole --brief

List all attributes for the wget/recursion tests:

fmf --key test --name wget/recursion

Show all covered requirements:

fmf --key requirement --key coverage

Search for all tests with the Tier1 tag defined and show a brief summary of what was found:

fmf --key test --filter tags:Tier1 --verbose

See fmf --help for complete list of available options.

Options

Here is the list of the most frequently used options.

Install

Install from the Copr repository:

dnf copr enable psss/fmf
dnf install fmf

or use PIP (sudo required if not in a virtualenv):

pip install fmf

See documentation for more details about installation options.

Links

Git: https://github.com/psss/fmf

Docs: http://fmf.readthedocs.io/

Issues: https://github.com/psss/fmf/issues

Releases: https://github.com/psss/fmf/releases

Copr: http://copr.fedoraproject.org/coprs/psss/fmf

PIP: https://pypi-hypernode.com/pypi/fmf

Travis: https://travis-ci.org/psss/fmf

Coveralls: https://coveralls.io/github/psss/fmf

Authors

Petr Šplíchal, Jakub Krysl, Jan Ščotka, Alois Mahdal and Cleber Rosa.

Copyright

Copyright (c) 2018 Red Hat, Inc.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.