Metadata-Version: 2.1
Name: woodblock
Version: 0.1.5
Summary: A framework to generate file carving test data
Home-page: https://github.com/fkie-cad/woodblock/
Author: Fraunhofer FKIE
Author-email: martin.lambertz@fkie.fraunhofer.de
License: MIT
Project-URL: Documentation, https://fkie-cad.github.io/woodblock/
Project-URL: Source, https://github.com/fkie-cad/woodblock/
Project-URL: Tracker, https://github.com/fkie-cad/woodblock/issues
Description: [![Build Status](https://travis-ci.org/fkie-cad/woodblock.svg?branch=master)](https://travis-ci.org/fkie-cad/woodblock)
        [![codecov](https://codecov.io/gh/fkie-cad/woodblock/branch/master/graph/badge.svg)](https://codecov.io/gh/fkie-cad/woodblock)
        [![Codacy Badge](https://api.codacy.com/project/badge/Grade/330a44b0155f4c989c581485799ae8e9)](https://app.codacy.com/app/0x4d4c/woodblock?utm_source=github.com&utm_medium=referral&utm_content=fkie-cad/woodblock&utm_campaign=Badge_Grade_Settings)
        [![Documentation Status](https://readthedocs.org/projects/woodblock/badge/?version=latest)](https://woodblock.readthedocs.io/en/latest/?badge=latest)
        
        # Woodblock – Easy File Carving Test Data Generation
        
        The goal of Woodblock is to make it as easy as possible to generate file carving test data
        sets such as the ones created by the [DFRWS](https://www.dfrws.org/) in their
        [2006](http://old.dfrws.org/2006/challenge/) and [2007](http://old.dfrws.org/2007/challenge/)
        challenges or by the ones created by
        [NIST](https://www.nist.gov/itl/ssd/software-quality-group/computer-forensics-tool-testing-program-cftt/cftt-technical-0).
        
        ## Basic Features
        
        *  Simple configuration files based image creation for most use cases.
        *  Easy to use Python API for more complex requirements.
        *  Ground truth file in JSON format.
        
        ## Documentation
        
        Our documentation is hosted on  [Read the Docs](https://woodblock.readthedocs.io/en/latest/index.html).
        
        ## Concepts
        Woodblock borrows most concepts from the DFRWS [2006](http://old.dfrws.org/2006/challenge/)
        and [2007](http://old.dfrws.org/2006/challenge/) challenges. As stated there,
        a **scenario** reflects a “*specific situation that might occur in a real file system*”.
        A scenario consists of **files** which are split into **fragments**. Scenarios on the
        other hand can be put into an image which can then used as input for the carving tool
        you would like to test.
        
        The following example should clarify these concepts. Consider for example the two
        **files** `A` and `B`.
        
        ![two files](https://raw.githubusercontent.com/fkie-cad/woodblock/master/docs/images/two_files.png "two files, A and B")
        
        These files can be split into **fragments**. In the example, we split file `A` into two
        fragments, `A.1` and `A.2`. File `B` has not been fragmented.
        
        ![two files fragmented](https://raw.githubusercontent.com/fkie-cad/woodblock/master/docs/images/two_files_fragmented.png "two files, A and B, A is fragmented")
        
        If we arrange the fragments of our files, we have a **scenario**:
        
        ![example scenario](https://raw.githubusercontent.com/fkie-cad/woodblock/master/docs/images/scenario_example-01.png "a simple scenario")
        
        A scenario can be added to an **image**, which in turn can be written to disk. Or you can
        add another scenario to the image as shown below.
        
        ![example image with two scenarios](https://raw.githubusercontent.com/fkie-cad/woodblock/master/docs/images/scenario_example-03.png "an image with two scenarios")
        
        Using Woodblock, you could create the images shown above using a simple configuration file:
        
        ```ini
        [general]
        block size = 512
        seed = 123
        corpus = testfiles
        
        [scenario 1]
        frags file1 = 2
        frags file2 = 1
        layout = 1.1, 2.1, 1.2
        
        [scenario 2]
        frags file1 = 3
        layout = 1.2, 1.1, Z, 1.3
        ```
        
        All files possibly added to a scenario have to be stored in a directory. This
        directory serves as the test file **corpus** and has to be distributed along
        with Woodstock configuration files or scripts using the Woodstock API.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >3.6
Description-Content-Type: text/markdown
