https://github.com/k0retux/fuddly

Fuzzing and Data Manipulation Framework (for GNU/Linux)
https://github.com/k0retux/fuddly

data-manipulation framework fuzzing python security

Last synced: 10 months ago
JSON representation

Fuzzing and Data Manipulation Framework (for GNU/Linux)

• Host: GitHub
• URL: https://github.com/k0retux/fuddly
• Owner: k0retux
• License: gpl-3.0
• Created: 2015-03-22T17:55:36.000Z (almost 11 years ago)
• Default Branch: develop
• Last Pushed: 2025-04-18T15:42:59.000Z (10 months ago)
• Last Synced: 2025-04-19T04:52:33.221Z (10 months ago)
• Topics: data-manipulation, framework, fuzzing, python, security
• Language: Python
• Homepage:
• Size: 7.9 MB
• Stars: 162
• Watchers: 17
• Forks: 44
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: COPYING

Awesome Lists containing this project

• awesome-rainmana - k0retux/fuddly - Fuzzing and Data Manipulation Framework (for GNU/Linux) (Python)

README

          
fuddly: a fuzzing and data manipulation framework

=================================================

|docs|

.. |docs| image:: https://readthedocs.org/projects/fuddly/badge/?version=develop

   :target: https://readthedocs.org/projects/fuddly/?badge=develop

   :alt: Documentation

List of features

----------------

+ Graph-based data model that enables:

  - to represent complex data formats and also to mix them

  - complex data manipulations

  - to dissect/absorb existing data

  - generation & mutation fuzzing strategy

+ Fuzzing automation framework:

  - target abstraction

  - monitoring means based on independant probes

  - replay & logging

  - data manipulation based on operators (objects that implement

    specific data transformation)

  - scenario infrastructure (for modeling protocol logic)

  - virtual directors

+ and so on...

What's still missing

--------------------

+ Refer to TODO file

About the Documentation

-----------------------

+ The documentation is available `here`_.

+ In order to generate the documentation from the source, follow these steps:

  #. go to the folder ``docs/``

  #. execute ``make html`` to generate HTML documentation

  #. execute ``make latexpdf`` to generate PDF documentation

  #. generated documentation is located in ``docs/build/``

.. _here: http://fuddly.readthedocs.io

Basic Installation Instructions

-------------------------------

Installation with `pipenv`::

    $ cd 

    $ pipenv install   # or pipenv sync (if you want to match exactly the environment

                       # described in fuddly Pipfile.lock)

    $ pipenv shell

Refer to the documentation for more information

Launch fuddly shell

-------------------

- If `fuddly` is installed either through pip/pipenv or a package from your distribution::

    $ fuddly shell

- If `fuddly` is not installed::

    $ python -m fuddly.cli shell

Launch fuddly Test Cases

------------------------

The package ``test`` include all unit & integration test cases

of ``fuddly`` itself. From the ``src/`` directory, usage is as follows:

- To launch all the tests, issue the command::

    $ python -m fuddly.test -a

- To launch all the tests but the longer ones, issue the command::

    $ python -m fuddly.test

- To avoid data model specific test cases use the option ``--ignore-dm-specifics``

- To launch a specific test category issue the following command::

    $ python -m fuddly.test fuddly.test....