reason, fuzz tests should gracefully handle anticipated exception cases with a`try`/`except` block to avoid false

positives that halt the fuzzing engine.

Provides hints to the fuzzing engine about inputs that might trigger unique code paths. Each fuzz target may have a

corresponding`.dict` file. For information about dictionary syntax, refer to

the[LibFuzzer documentation on the subject](https://llvm.org/docs/LibFuzzer.html#dictionaries).

**Things to Know**:

- OSS-Fuzz loads dictionary files per fuzz target if one exists with the same name, all others are ignored.

- Most entries in the dictionary files found here are escaped hex or Unicode values that were recommended by the fuzzing

engine after previous runs.

- A default set of dictionary entries are created for all fuzz targets as part of the build process, regardless of an

existing file here.

- Development or updates to dictionaries should reflect the varied formats and edge cases relevant to the

functionalities under test.

- Example dictionaries (some of which are used to build the default dictionaries mentioned above) can be found here:

-[AFL++ dictionary repository](https://github.com/AFLplusplus/AFLplusplus/tree/stable/dictionaries#readme)

-[Google/fuzzing dictionary repository](https://github.com/google/fuzzing/tree/master/dictionaries)

Includes scripts for building and integrating fuzz targets with OSS-Fuzz:

python3 -m pip install.

SEED_DATA_DIR="$SRC/seed_data"

find"$SEED_DATA_DIR"\( -name'*_seed_corpus.zip' -o -name'*.options' -o -name'*.dict'\) \

!\( -name'__base.*'\) -execprintf'Copying: %s\n' {}\; \

find"$SRC" -maxdepth 1 \

\( -name'*_seed_corpus.zip' -o -name'*.options' -o -name'*.dict'\) \

-execprintf'[%s] Copying: %s\n'"$(date'+%Y-%m-%d %H:%M:%S')" {}\; \

-exec chmod a-x {}\; \

-exec cp {}"$OUT"\;

find"$SRC/gitpython/fuzzing" -name'fuzz_*.py' -print0|while IFS=read -r -d'' fuzz_harness;do

compile_python_fuzzer"$fuzz_harness" --add-binary="$(command -v git):."

common_base_dictionary_filename="$SEED_DATA_DIR/__base.dict"

if [[-r"$common_base_dictionary_filename" ]];then

fuzz_harness_dictionary_filename="$(basename"$fuzz_harness" .py).dict"

output_file="$OUT/$fuzz_harness_dictionary_filename"

if [[-s"$output_file" ]];then

cat"$common_base_dictionary_filename">>"$output_file"

forcmdin python3 git wgetrsync;do

forcmdin python3 git wgetzip;do

command -v"$cmd">/dev/null2>&1|| {

exit 1

}

SEED_DATA_DIR="$SRC/seed_data"

mkdir -p"$SEED_DATA_DIR"

download_and_concatenate_common_dictionaries() {

target_file="$1"

localtarget_file="$1"

}

fetch_seed_corpora() {

git clone --depth 1 https://github.com/gitpython-developers/qa-assets.git qa-assets&&

rsync -avc qa-assets/gitpython/corpra/"$SEED_DATA_DIR/"&&

rm -rf qa-assets# Clean up the cloned repo to keep the Docker image as slim as possible.

create_seed_corpora_zips() {

local seed_corpora_dir="$1"

local output_zip

fordirin"$seed_corpora_dir"/*;do

if [-d"$dir" ]&& [-n"$dir" ];then

output_zip="$SRC/$(basename"$dir")_seed_corpus.zip"

zip -jur"$output_zip""$dir"/*

}

prepare_dictionaries_for_fuzz_targets() {

local dictionaries_dir="$1"

local fuzz_targets_dir="$2"

local common_base_dictionary_filename="$WORK/__base.dict"

cp -v"$dictionaries_dir"/*.dict"$SRC/"

download_and_concatenate_common_dictionaries"$common_base_dictionary_filename" \

"https://raw.githubusercontent.com/google/fuzzing/master/dictionaries/utf8.dict" \

find"$fuzz_targets_dir" -name'fuzz_*.py' -print0|while IFS=read -r -d'' fuzz_harness;do

if [[-r"$common_base_dictionary_filename" ]];then

fuzz_harness_dictionary_filename="$(basename"$fuzz_harness" .py).dict"

local output_file="$SRC/$fuzz_harness_dictionary_filename"

if [[-s"$output_file" ]];then

cat"$common_base_dictionary_filename">>"$output_file"

}

git clone --depth 1 https://github.com/gitpython-developers/qa-assets.git"$WORK/qa-assets"

download_and_concatenate_common_dictionaries"$SEED_DATA_DIR/__base.dict" \

"https://raw.githubusercontent.com/google/fuzzing/master/dictionaries/utf8.dict" \

prepare_dictionaries_for_fuzz_targets"$WORK/qa-assets/gitpython/dictionaries""$SRC/gitpython/fuzzing"

python3 -m pip install --upgrade pip