{"repo":"MozillaSecurity/ffpuppet","free":true,"listed":false,"github":"https://github.com/MozillaSecurity/ffpuppet","clone":"git clone https://github.com/MozillaSecurity/ffpuppet.git","description":"A Python module that enables the automation of Firefox","language":"Python","stars":33,"topics":["python","automation","firefox","fuzzing","automated-testing"],"license":"MPL-2.0","category":"workflow-automation","readme_excerpt":"FFPuppet ======== FFPuppet is a Python module that automates browser process related tasks to aid in fuzzing. Happy bug hunting! Are you fuzzing the browser? Grizzly can help. Installation ------------ To install the latest version from PyPI pip install ffpuppet Xvfb on Linux On Linux xvfb can be used in order to run headless (this is not the same as Firefox's -headless mode). To install xvfb on Ubuntu run: apt-get install xvfb Install minidump-stackwalk minidump-stackwalk is used to collect crash reports from minidump files. More information can be found here. Browser Builds -------------- If you are looking for builds to use with FFPuppet there are a few options. Download a build fuzzfetch is the recommended method for obtaining builds and is also very helpful in automation. Taskcluster has a collection of many different build types for multiple platforms and branches. An index of the latest mozilla-central builds can be found here. Create your own build If you would like to compile your own, build instructions can be found here. When using minidump-stackwalk breakpad symbols are required for symbolized stacks. Usage ----- Once installed FFPuppet can be run using the following command: ffpuppet Replaying a test case ffpuppet -p -d -u This will open the provided test case file in Firefox using the provided prefs.js file. Any log data (stderr, stdout, ASan logs... etc) will be dumped to the console if a failure is detected. Grizzly Replay is recommended for replaying test cas","default_branch":null,"files":null,"tree":[],"storefront":"/r/MozillaSecurity","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/MozillaSecurity/ffpuppet/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}