FAT-Forensics 0.1.2

Dependencies

FAT Forensics requires Python 3.5 or higher and the following dependencies:

In addition, some of the modules require optional dependencies:

User Installation

The easies way to install FAT Forensics is via pip:

pip install fat-forensics

which will only installed the required dependencies. If you want to install the package together with all the auxiliary dependencies please consider using the [all] option:

pip install fat-forensics[all]

The documentation provides more detailed installation instructions.

Important Links

• Project’s web site and documentation: https://fat-forensics.org.

• Official source code repository: https://github.com/fat-forensics/fat-forensics.

• FAT Forensics releases: https://pypi.org/project/fat-forensics.

• Issue tracker: https://github.com/fat-forensics/fat-forensics/issues.

Source Code

You can check out the latest FAT Forensics source code via git with the command:

git clone https://github.com/fat-forensics/fat-forensics.git

Contributing

To learn more about contributing to FAT Forensics, please see our Contributing Guide.

Testing

You can launch the test suite from the root directory of this repository with:

make test-with-code-coverage

To run the tests you will need to have version 3.9.1 of pytest installed. This package, together with other development dependencies, can be also installed with:

pip install -r requirements-dev.txt

or with:

pip install fat-forensics[dev]

See the Testing section of the Development Guide page for more information.

Please note that the make test-with-code-coverage command will test the version of the package in the local fatf directory and not the one installed since the pytest command is preceded by PYTHONPATH=./. If you want to test the installed version, consider using the command from the Makefile without the PYTHONPATH variable.

To control the randomness during the tests the Makefile sets the random seed to 42 by preceding each test command with FATF_SEED=42, which sets the environment variable responsible for that. More information about the setup of the Testing Environment is available on the development web page in the documentation.

Submitting a Pull Request

Before opening a Pull Request, please have a look at the Contributing page to make sure that your code complies with our guidelines.

Communication

You can reach out to us at:

• our gitter channel for code-related development discussion; and

• our mailing list for discussion about the project’s future and the direction of the development.

More information about the communication can be found in our documentation on the main page and on the develop page.

Citation

If you use FAT Forensics in a scientific publication, we would appreciate citations! Information on how to cite use is available on the citation web page in our documentation.