Grizzly
=======
[![Task Status](https://community-tc.services.mozilla.com/api/github/v1/repository/MozillaSecurity/grizzly/master/badge.svg)](https://community-tc.services.mozilla.com/api/github/v1/repository/MozillaSecurity/grizzly/master/latest)
[![codecov](https://codecov.io/gh/MozillaSecurity/grizzly/branch/master/graph/badge.svg)](https://codecov.io/gh/MozillaSecurity/grizzly)
[![Matrix](https://img.shields.io/badge/dynamic/json?color=green&label=chat&query=%24.chunk[%3F(%40.canonical_alias%3D%3D%22%23fuzzing%3Amozilla.org%22)].num_joined_members&suffix=%20users&url=https%3A%2F%2Fmozilla.modular.im%2F_matrix%2Fclient%2Fr0%2FpublicRooms&style=flat&logo=matrix)](https://riot.im/app/#/room/#fuzzing:mozilla.org)
[![PyPI](https://img.shields.io/pypi/v/grizzly-framework)](https://pypi.org/project/grizzly-framework)
Grizzly is a modular general purpose browser fuzzing framework. The goal is to create a platform that can be extended via the creation of plug-ins to support multiple combinations of browsers and fuzzers. An Adapter is used to add support for a fuzzer and a Target to add support for a browser. Generated test cases are intended to be standalone and not require Grizzly.
Cross platform compatibility is available for Windows, Linux and MacOS.
However not all features may be available.
For additional information please check out the [wiki](https://github.com/MozillaSecurity/grizzly/wiki) or the [announcement](https://blog.mozilla.org/security/2019/07/10/grizzly/).
Quick Start
-----------
Install the latest version from PyPI. For more details see [getting started](https://github.com/MozillaSecurity/grizzly/wiki/Getting-Started) on the wiki.
```
python3 -m pip install grizzly-framework --upgrade
```
**Fuzzing** - Run the `no-op` test adapter to check everything is working.
```
grizzly <browser-binary> no-op
```
**Reduce** - [Grizzly Reduce](https://github.com/MozillaSecurity/grizzly/wiki/Grizzly-Reduce) can reduce a test case.
```
grizzly-reduce <browser-binary> <testcase>
```
**Replay** - [Grizzly Replay](https://github.com/MozillaSecurity/grizzly/wiki/Grizzly-Replay) can replay a test case with different builds and debuggers.
```
grizzly-replay <browser-binary> <testcase>
```
[Bugzilla](https://bugzilla.mozilla.org/) is also supported by Grizzly Replay. Bugs can be replayed via a bug ID:
```
grizzly-replay-bugzilla <browser-binary> <bug_id>
```
Questions
---------
Common questions can be found on the [Q&A](https://github.com/MozillaSecurity/grizzly/wiki/Q&A) page.
Questions can also be asked in the [#fuzzing](https://riot.im/app/#/room/#fuzzing:mozilla.org) channel.
Please be sure you are using the latest version Grizzly before reporting issues.
Raw data
{
"_id": null,
"home_page": "https://github.com/MozillaSecurity/grizzly",
"name": "grizzly-framework",
"maintainer": "Mozilla Fuzzing Team",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "fuzzing@mozilla.com",
"keywords": "firefox framework fuzz fuzzing test testing",
"author": "Tyson Smith",
"author_email": "twsmith@mozilla.com",
"download_url": "https://files.pythonhosted.org/packages/7b/e1/275a3f6d95d486db427fe8c062c7a1ace69bc54b1aec566a0a5704b044f6/grizzly_framework-0.21.0.tar.gz",
"platform": null,
"description": "Grizzly\n=======\n[![Task Status](https://community-tc.services.mozilla.com/api/github/v1/repository/MozillaSecurity/grizzly/master/badge.svg)](https://community-tc.services.mozilla.com/api/github/v1/repository/MozillaSecurity/grizzly/master/latest)\n[![codecov](https://codecov.io/gh/MozillaSecurity/grizzly/branch/master/graph/badge.svg)](https://codecov.io/gh/MozillaSecurity/grizzly)\n[![Matrix](https://img.shields.io/badge/dynamic/json?color=green&label=chat&query=%24.chunk[%3F(%40.canonical_alias%3D%3D%22%23fuzzing%3Amozilla.org%22)].num_joined_members&suffix=%20users&url=https%3A%2F%2Fmozilla.modular.im%2F_matrix%2Fclient%2Fr0%2FpublicRooms&style=flat&logo=matrix)](https://riot.im/app/#/room/#fuzzing:mozilla.org)\n[![PyPI](https://img.shields.io/pypi/v/grizzly-framework)](https://pypi.org/project/grizzly-framework)\n\nGrizzly is a modular general purpose browser fuzzing framework. The goal is to create a platform that can be extended via the creation of plug-ins to support multiple combinations of browsers and fuzzers. An Adapter is used to add support for a fuzzer and a Target to add support for a browser. Generated test cases are intended to be standalone and not require Grizzly.\n\nCross platform compatibility is available for Windows, Linux and MacOS.\nHowever not all features may be available.\n\nFor additional information please check out the [wiki](https://github.com/MozillaSecurity/grizzly/wiki) or the [announcement](https://blog.mozilla.org/security/2019/07/10/grizzly/).\n\nQuick Start\n-----------\nInstall the latest version from PyPI. For more details see [getting started](https://github.com/MozillaSecurity/grizzly/wiki/Getting-Started) on the wiki.\n\n```\npython3 -m pip install grizzly-framework --upgrade\n```\n\n**Fuzzing** - Run the `no-op` test adapter to check everything is working.\n\n```\ngrizzly <browser-binary> no-op\n```\n\n**Reduce** - [Grizzly Reduce](https://github.com/MozillaSecurity/grizzly/wiki/Grizzly-Reduce) can reduce a test case.\n\n```\ngrizzly-reduce <browser-binary> <testcase>\n```\n\n**Replay** - [Grizzly Replay](https://github.com/MozillaSecurity/grizzly/wiki/Grizzly-Replay) can replay a test case with different builds and debuggers.\n\n```\ngrizzly-replay <browser-binary> <testcase>\n```\n\n[Bugzilla](https://bugzilla.mozilla.org/) is also supported by Grizzly Replay. Bugs can be replayed via a bug ID:\n\n```\ngrizzly-replay-bugzilla <browser-binary> <bug_id>\n```\n\nQuestions\n---------\n\nCommon questions can be found on the [Q&A](https://github.com/MozillaSecurity/grizzly/wiki/Q&A) page.\nQuestions can also be asked in the [#fuzzing](https://riot.im/app/#/room/#fuzzing:mozilla.org) channel.\n\nPlease be sure you are using the latest version Grizzly before reporting issues.\n",
"bugtrack_url": null,
"license": "MPL 2.0",
"summary": "A framework for developing and running browser fuzzers",
"version": "0.21.0",
"project_urls": {
"Homepage": "https://github.com/MozillaSecurity/grizzly"
},
"split_keywords": [
"firefox",
"framework",
"fuzz",
"fuzzing",
"test",
"testing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2865a058024310aa75331f86dfa64c88e2365f2f7c3e6f381f991b8a6bca55fc",
"md5": "24ab71fe20d6ce98a2a38da05218f55f",
"sha256": "7a05a5143625609ff35a84d1157affa074b665706c308903a6cfa990d10a7b34"
},
"downloads": -1,
"filename": "grizzly_framework-0.21.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "24ab71fe20d6ce98a2a38da05218f55f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 249335,
"upload_time": "2024-11-19T19:13:44",
"upload_time_iso_8601": "2024-11-19T19:13:44.225047Z",
"url": "https://files.pythonhosted.org/packages/28/65/a058024310aa75331f86dfa64c88e2365f2f7c3e6f381f991b8a6bca55fc/grizzly_framework-0.21.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7be1275a3f6d95d486db427fe8c062c7a1ace69bc54b1aec566a0a5704b044f6",
"md5": "4ceb4e5ab373fda9db871fd509b2cc53",
"sha256": "f8325a2377e849916d70351e5a5b6ba5658db4243834d95f51208cd99982195d"
},
"downloads": -1,
"filename": "grizzly_framework-0.21.0.tar.gz",
"has_sig": false,
"md5_digest": "4ceb4e5ab373fda9db871fd509b2cc53",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 202459,
"upload_time": "2024-11-19T19:13:46",
"upload_time_iso_8601": "2024-11-19T19:13:46.184756Z",
"url": "https://files.pythonhosted.org/packages/7b/e1/275a3f6d95d486db427fe8c062c7a1ace69bc54b1aec566a0a5704b044f6/grizzly_framework-0.21.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-19 19:13:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MozillaSecurity",
"github_project": "grizzly",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "grizzly-framework"
}