fuzzfetch

library16.1.0pypypi✓ verified 81d ago

A Python library for downloading Firefox, Thunderbird, and jsshell builds from Mozilla's Taskcluster. Currently at version 16.1.0, with frequent releases (multiple per year). Requires Python >=3.10.

devops

pip install fuzzfetch

github ↗package ↗

INSTALL

IMPORT

SIG · FUZZFETCH

fuzzfetch

devopspythonv16.1.0

Install

2.3s avg

Import

—

Disk

22MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v16.1.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.000s · 24MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 2.3s · import 0.000s · 24MB

22MB installed

● package 22MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Fetcher

✓ from fuzzfetch import Fetcher

✗ from fuzzfetch import FuzzFetch

FetcherArgs

✓ from fuzzfetch import FetcherArgs

BuildTask

✓ from fuzzfetch import BuildTask

Basic usage: create FuzzFetch instance, call fetch() with build flags and platform.

from fuzzfetch import FuzzFetch, BuildFlags ff = FuzzFetch() # Fetch the latest Firefox nightly for Linux64 build = ff.fetch( build=BuildFlags.FIREFOX, platform='linux64', branch='mozilla-central' ) print(build.binary_path) # Or fetch with specific date: build = ff.fetch( build=BuildFlags.FIREFOX, platform='linux64', branch='mozilla-central', date='2025-01-15' ) print(build.binary_path)

Debug

Known issues

breakingVersion 14.0.0 changed behavior to return the newest build matching requested parameters, instead of raising an error if multiple builds found. Code that relied on the old error handling may silently get a different build.

fix

Review any code that catches exceptions for ambiguous builds; now the newest build is always returned.

affects: >=14.0.0

breakingVersion 16.0.0 dropped support for Python 3.9. Users on Python 3.9 must upgrade to 3.10+.

fix

Upgrade Python to 3.10 or later. Pin fuzzfetch<16 if necessary.

affects: >=16.0.0

gotchaWhen using the 'date' parameter, be aware that only builds indexed from that exact date are returned; if no build exists, an exception is raised. Use 'from_date' and 'to_date' for ranges.

fix

Use from_date and to_date for date ranges, or catch FuzzFetchException if exact date fails.

affects: All

gotchafuzzfetch depends on network access to Mozilla's Taskcluster. Running without a network or behind a strict proxy may cause timeouts or failures. Consider using retry logic (built-in since v11.1.0) or custom timeout.

fix

Configure network/proxy settings or use FuzzFetch(max_retries=3, timeout=60).

affects: All

Upgrade

Version history

16.1.0latest on PyPI · released Dec 11, 2025

Audit

Dependencies

requestsrequiredHTTP requests to Taskcluster API

sentry-sdkoptionalSentry error tracking (optional, for automation)

Agent activity

5 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/MozillaSecurity/fuzzfetch ↗

packagehttps://pypi.org/project/fuzzfetch/ ↗