[](https://community-tc.services.mozilla.com/api/github/v1/repository/MozillaSecurity/fuzzfetch/master/latest)
[](https://codecov.io/gh/MozillaSecurity/fuzzfetch)
[].num_joined_members&suffix=%20users&url=https%3A%2F%2Fmozilla.modular.im%2F_matrix%2Fclient%2Fr0%2FpublicRooms&style=flat&logo=matrix)](https://matrix.to/#/#fuzzing:mozilla.org)
[](https://pypi.org/project/fuzzfetch)
Fuzzfetch is a python tool for retrieving builds from the [Firefox-CI](https://firefox-ci-tc.services.mozilla.com/) Taskcluster instance.
Overview
--------
Fuzzfetch can be used to retrieve nearly any build type indexed by Firefox-CI. This includes AddressSanitizer, ThreadSanitizer, Valgrind, debug, and Fuzzing builds for both Firefox and Spidermonkey.
Installation
------------
```
pip install fuzzfetch
```
Usage
-----
Fuzzfetch supports the following arguments:
```
usage: fuzzfetch [-h] [--target [TARGET ...]]
[--os {Android,Darwin,Linux,Windows}]
[--cpu {AMD64,ARM64,aarch64,arm,arm64,i686,x64,x86,x86_64}]
[--build DATE|REV|NS]
[--central | --release | --beta | --esr-stable | --esr-next | --try | --autoland]
[-d] [-a] [-t] [--fuzzing] [--fuzzilli] [--coverage]
[--valgrind] [--no-opt] [--nyx] [--searchfox] [-n NAME]
[-o OUT] [--dry-run] [--nearest-newer | --nearest-older] [-V]
options:
-h, --help show this help message and exit
-V, --version print version and exit
Target:
--target [TARGET ...]
Specify the build artifacts to download. Valid
options: firefox js common gtest mozharness searchfox
(default: firefox)
--os {Android,Darwin,Linux,Windows}
Specify the target system. (default: Linux)
--cpu {AMD64,ARM64,aarch64,arm,arm64,i686,x64,x86,x86_64}
Specify the target CPU. (default: x86_64)
Build:
--build DATE|REV|NS Specify the build to download, (default: latest)
Accepts values in format YYYY-MM-DD (2017-01-01)
revision (57b37213d81150642f5139764e7044b07b9dccc3) or
TaskCluster namespace (gecko.v2....)
Branch:
--central Download from mozilla-central (default)
--release Download from mozilla-release
--beta Download from mozilla-beta
--esr-stable Download from esr-stable
--esr-next Download from esr-next
--try Download from try
--autoland Download from autoland
Build Arguments:
-d, --debug Get debug builds w/ symbols (default=optimized).
-a, --asan Download AddressSanitizer builds.
-t, --tsan Download ThreadSanitizer builds.
--fuzzing Download --enable-fuzzing builds.
--fuzzilli Download --enable-js-fuzzilli builds.
--coverage Download --coverage builds.
--valgrind Download Valgrind builds.
--no-opt Download non-optimized builds.
--nyx Download Nyx snapshot builds.
--searchfox Download searchfox data.
Misc. Arguments:
-n NAME, --name NAME Specify a name (default=auto)
-o OUT, --out OUT Specify output directory (default=.)
--dry-run Search for build and output metadata only, don't
download anything.
Near Arguments:
If the specified build isn't found, iterate over builds in the specified
direction
--nearest-newer Search from specified build in ascending order
--nearest-older Search from the specified build in descending order
```
Simple Build Retrieval
----------------------
To retrieve the latest build from mozilla-central built with `--enable-address-sanitizer` and `--enable-fuzzing`, you can use the following:
```
fuzzfetch -a --fuzzing
```
To retrieve the latest build from mozilla-central built with `--enable-debug`, you can use the following:
```
fuzzfetch --target js -d
```
To retrieve a specific revision from mozilla-central, you can use the following:
```
fuzzfetch --build 08471023c834
```
Raw data
{
"_id": null,
"home_page": "https://github.com/MozillaSecurity/fuzzfetch",
"name": "fuzzfetch",
"maintainer": "Mozilla Fuzzing Team",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "fuzzing@mozilla.com",
"keywords": "fuzz fuzzing security test testing",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/20/19/05b326d42bda1d7b535a85e203a85d21bac552e47efe552df83f247f4b02/fuzzfetch-7.0.0.tar.gz",
"platform": "any",
"description": "[](https://community-tc.services.mozilla.com/api/github/v1/repository/MozillaSecurity/fuzzfetch/master/latest)\n[](https://codecov.io/gh/MozillaSecurity/fuzzfetch)\n[].num_joined_members&suffix=%20users&url=https%3A%2F%2Fmozilla.modular.im%2F_matrix%2Fclient%2Fr0%2FpublicRooms&style=flat&logo=matrix)](https://matrix.to/#/#fuzzing:mozilla.org)\n[](https://pypi.org/project/fuzzfetch)\n\nFuzzfetch is a python tool for retrieving builds from the [Firefox-CI](https://firefox-ci-tc.services.mozilla.com/) Taskcluster instance.\n\nOverview\n--------\n\nFuzzfetch can be used to retrieve nearly any build type indexed by Firefox-CI. This includes AddressSanitizer, ThreadSanitizer, Valgrind, debug, and Fuzzing builds for both Firefox and Spidermonkey.\n\nInstallation\n------------\n```\npip install fuzzfetch\n```\n\nUsage\n-----\nFuzzfetch supports the following arguments:\n\n```\nusage: fuzzfetch [-h] [--target [TARGET ...]]\n [--os {Android,Darwin,Linux,Windows}]\n [--cpu {AMD64,ARM64,aarch64,arm,arm64,i686,x64,x86,x86_64}]\n [--build DATE|REV|NS]\n [--central | --release | --beta | --esr-stable | --esr-next | --try | --autoland]\n [-d] [-a] [-t] [--fuzzing] [--fuzzilli] [--coverage]\n [--valgrind] [--no-opt] [--nyx] [--searchfox] [-n NAME]\n [-o OUT] [--dry-run] [--nearest-newer | --nearest-older] [-V]\n\noptions:\n -h, --help show this help message and exit\n -V, --version print version and exit\n\nTarget:\n --target [TARGET ...]\n Specify the build artifacts to download. Valid\n options: firefox js common gtest mozharness searchfox\n (default: firefox)\n --os {Android,Darwin,Linux,Windows}\n Specify the target system. (default: Linux)\n --cpu {AMD64,ARM64,aarch64,arm,arm64,i686,x64,x86,x86_64}\n Specify the target CPU. (default: x86_64)\n\nBuild:\n --build DATE|REV|NS Specify the build to download, (default: latest)\n Accepts values in format YYYY-MM-DD (2017-01-01)\n revision (57b37213d81150642f5139764e7044b07b9dccc3) or\n TaskCluster namespace (gecko.v2....)\n\nBranch:\n --central Download from mozilla-central (default)\n --release Download from mozilla-release\n --beta Download from mozilla-beta\n --esr-stable Download from esr-stable\n --esr-next Download from esr-next\n --try Download from try\n --autoland Download from autoland\n\nBuild Arguments:\n -d, --debug Get debug builds w/ symbols (default=optimized).\n -a, --asan Download AddressSanitizer builds.\n -t, --tsan Download ThreadSanitizer builds.\n --fuzzing Download --enable-fuzzing builds.\n --fuzzilli Download --enable-js-fuzzilli builds.\n --coverage Download --coverage builds.\n --valgrind Download Valgrind builds.\n --no-opt Download non-optimized builds.\n --nyx Download Nyx snapshot builds.\n --searchfox Download searchfox data.\n\nMisc. Arguments:\n -n NAME, --name NAME Specify a name (default=auto)\n -o OUT, --out OUT Specify output directory (default=.)\n --dry-run Search for build and output metadata only, don't\n download anything.\n\nNear Arguments:\n If the specified build isn't found, iterate over builds in the specified\n direction\n\n --nearest-newer Search from specified build in ascending order\n --nearest-older Search from the specified build in descending order\n```\n\nSimple Build Retrieval\n----------------------\nTo retrieve the latest build from mozilla-central built with `--enable-address-sanitizer` and `--enable-fuzzing`, you can use the following:\n```\nfuzzfetch -a --fuzzing\n```\n\nTo retrieve the latest build from mozilla-central built with `--enable-debug`, you can use the following:\n```\nfuzzfetch --target js -d\n```\n\nTo retrieve a specific revision from mozilla-central, you can use the following:\n```\nfuzzfetch --build 08471023c834\n```\n",
"bugtrack_url": null,
"license": "MPL 2.0",
"summary": "Downloader for firefox/jsshell builds.",
"version": "7.0.0",
"project_urls": {
"Homepage": "https://github.com/MozillaSecurity/fuzzfetch"
},
"split_keywords": [
"fuzz",
"fuzzing",
"security",
"test",
"testing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1b4b227614244bc363b841d78f92c76b50a8a8e4b34f1b7ea7c780840065fc32",
"md5": "e653f1a44c9d891cb33da7d244f70c5b",
"sha256": "a65241c6f19909c3afe15ee8282a78849f0276d9c22de4eaec9d3dcd6ca71c8a"
},
"downloads": -1,
"filename": "fuzzfetch-7.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e653f1a44c9d891cb33da7d244f70c5b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 29478,
"upload_time": "2024-04-30T19:48:26",
"upload_time_iso_8601": "2024-04-30T19:48:26.291208Z",
"url": "https://files.pythonhosted.org/packages/1b/4b/227614244bc363b841d78f92c76b50a8a8e4b34f1b7ea7c780840065fc32/fuzzfetch-7.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "201905b326d42bda1d7b535a85e203a85d21bac552e47efe552df83f247f4b02",
"md5": "88329a3ab9c7001a635bb235513a6ff6",
"sha256": "603c81ad49acb91b7960f5e1ee716b90bebb0e29333dc1219dad40c38d7956e8"
},
"downloads": -1,
"filename": "fuzzfetch-7.0.0.tar.gz",
"has_sig": false,
"md5_digest": "88329a3ab9c7001a635bb235513a6ff6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 198070,
"upload_time": "2024-04-30T19:48:27",
"upload_time_iso_8601": "2024-04-30T19:48:27.830065Z",
"url": "https://files.pythonhosted.org/packages/20/19/05b326d42bda1d7b535a85e203a85d21bac552e47efe552df83f247f4b02/fuzzfetch-7.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-30 19:48:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MozillaSecurity",
"github_project": "fuzzfetch",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"tox": true,
"lcname": "fuzzfetch"
}
JSON
