protofuzz - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #go #machine-learning #linux #docker #macos #nodejs #java #vue #openai #open-source

protofuzz

(★ 287)

Google Protocol Buffers message generator

File Explorer

Download Latest Version (.zip)

- - ci.yml
  - pip-audit.yml
- dependabot.yml
- - __init__.py
  - test.proto
  - test_gen.py
  - test_log.py
  - test_pbimport.py
  - test_protofuzz.py
  - test_values.py
- __init__.py
- fuzzdb
- gen.py
- log.py
- pbimport.py
- protofuzz.py
- values.py
.gitignore
.gitmodules
LICENSE
MANIFEST.in
README.md
setup.py

# Installation Guide

1. Get the code

git clone https://github.com/trailofbits/protofuzz

Downloads the entire project code from GitHub to your computer.

cd protofuzz

Moves into the project folder you just downloaded.

2. Python

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install .

Installs the package published on PyPI directly — no need to clone the source.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ProtoFuzz

[![CI](https://github.com/trailofbits/protofuzz/workflows/CI/badge.svg)](https://github.com/trailofbits/protofuzz/actions/workflows/ci.yml)
[![PyPI version](https://badge.fury.io/py/protofuzz.svg)](https://badge.fury.io/py/protofuzz)

ProtoFuzz is a generic fuzzer for Google’s Protocol Buffers format. Instead of defining a new fuzzer generator for custom binary formats, protofuzz automatically creates a fuzzer based on the same format definition that programs use. ProtoFuzz is implemented as a stand-alone Python3 program.

## Installation

Make sure you have protobuf package installed and `protoc` is accessible from $PATH, and that `protoc` can generate Python3-compatible code.

```console
$ git clone --recursive git@github.com:trailofbits/protofuzz.git
$ cd protofuzz
$ python3 setup.py install
```

## Usage

```python
>>> from protofuzz import protofuzz
>>> message_fuzzers = protofuzz.from_description_string("""
...     message Address {
...      required int32 house = 1;
...      required string street = 2;
...     }
... """)
>>> for obj in message_fuzzers['Address'].permute():
...     print("Generated object: {}".format(obj))
...
Generated object: house: -1
street: "!"

Generated object: house: 0
street: "!"

Generated object: house: 256
street: "!"
...
```

You can also create dependencies between arbitrary fields that are resolved with
any callable object:

```python
>>> message_fuzzers = protofuzz.from_description_string("""
...     message Address {
...      required int32 house = 1;
...      required string street = 2;
...     }
...     message Other {
...       required Address addr = 1;
...       required uint32 foo = 2;
...     }
... """)
>>> fuzzer = message_fuzzers['Other']
>>> # The following creates a dependency that ensures Other.foo is always set
>>> # to 1 greater than Other.addr.house
>>> fuzzer.add_dependency('foo', 'addr.house', lambda x: x+1)
>>> for obj in fuzzer.permute():
...     print("Generated object: {}".format(obj))
```

Note however, the values your lambda creates must be conformant to the destination
type.

## Caveats

Currently, we use [fuzzdb](https://github.com/fuzzdb-project/fuzzdb) for values. This might not be complete or appropriate for your use. Consider swapping it for your own values.

If you have your own separate instance of fuzzdb, you can export `FUZZDB_DIR`
in your environment with the absolute path to your instance.

```console
export FUZZDB_DIR=/path/to/your/fuzzdb
```