Site Scout
==========
[](https://community-tc.services.mozilla.com/api/github/v1/repository/MozillaSecurity/site-scout/main/latest)
[](https://codecov.io/gh/MozillaSecurity/site-scout)
[](https://matrix.to/#/#fuzzing:mozilla.org)
[](https://pypi.org/project/site-scout)
Site Scout is a tool that can identify and report issues that are triggered in the wild.
A URL or a collection of URLs must be provided. All results are collected and reported.
The primary goal is to find issues such as crashes, assertion failures and other
issues detected by AddressSanitizer, UndefinedBehaviourSanitizer and ThreadSanitizer.
Installation
------------
Install the latest version from PyPI:
```
python3 -m pip install site-scout --upgrade
```
Usage
-----
Visit a collection of URLs:
```
site-scout <firefox-bin> -i <urls>.yml [<urls>.yml ...]
```
-or-
Visit one or more URLs (typically used to reproduce an issue):
```
site-scout <firefox-bin> -u <url> [<url> ...]
```
Input YAML Layout
-----------------
URLs to visit are stored in the following format:
```yml
# subdomain.domain.tld/path
domain.tld:
subdomain:
- /path
# '*' is used to omit the subdomain
github.com:
'*':
- /MozillaSecurity/site-scout
mozilla.org:
www:
- /
- /firefox/browsers/mobile/
- /firefox/new/
```
Raw data
{
"_id": null,
"home_page": "https://github.com/MozillaSecurity/site-scout",
"name": "site-scout",
"maintainer": "Mozilla Fuzzing Team",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "fuzzing@mozilla.com",
"keywords": "automation testing",
"author": "Tyson Smith",
"author_email": "twsmith@mozilla.com",
"download_url": "https://files.pythonhosted.org/packages/f1/06/8130dd2a45a2be83f87fe27b9cbcbe9d596498a04af54e32eab1c53479f3/site_scout-2.2.0.tar.gz",
"platform": null,
"description": "Site Scout\n==========\n[](https://community-tc.services.mozilla.com/api/github/v1/repository/MozillaSecurity/site-scout/main/latest)\n[](https://codecov.io/gh/MozillaSecurity/site-scout)\n[](https://matrix.to/#/#fuzzing:mozilla.org)\n[](https://pypi.org/project/site-scout)\n\nSite Scout is a tool that can identify and report issues that are triggered in the wild.\nA URL or a collection of URLs must be provided. All results are collected and reported.\n\nThe primary goal is to find issues such as crashes, assertion failures and other\nissues detected by AddressSanitizer, UndefinedBehaviourSanitizer and ThreadSanitizer.\n\nInstallation\n------------\n\nInstall the latest version from PyPI:\n\n```\npython3 -m pip install site-scout --upgrade\n```\n\nUsage\n-----\n\nVisit a collection of URLs:\n```\nsite-scout <firefox-bin> -i <urls>.yml [<urls>.yml ...]\n```\n\n-or-\n\nVisit one or more URLs (typically used to reproduce an issue):\n```\nsite-scout <firefox-bin> -u <url> [<url> ...]\n```\n\nInput YAML Layout\n-----------------\n\nURLs to visit are stored in the following format:\n```yml\n# subdomain.domain.tld/path\ndomain.tld:\n subdomain:\n - /path\n# '*' is used to omit the subdomain\ngithub.com:\n '*':\n - /MozillaSecurity/site-scout\nmozilla.org:\n www:\n - /\n - /firefox/browsers/mobile/\n - /firefox/new/\n```\n",
"bugtrack_url": null,
"license": "MPL 2.0",
"summary": "A tool to identify and report browser issues triggered by visiting a list of URLs.",
"version": "2.2.0",
"project_urls": {
"Homepage": "https://github.com/MozillaSecurity/site-scout"
},
"split_keywords": [
"automation",
"testing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ae8d470a06d17e573ec4368c679ef9263e35e44fec89ca32ed28dfebb6330960",
"md5": "0071bd0eee272881374fe0894786d926",
"sha256": "fd91037f5a3f01ce89efea51acd0ba608f12ef720c05d02cfd2c8b8bd4622bfa"
},
"downloads": -1,
"filename": "site_scout-2.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0071bd0eee272881374fe0894786d926",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 42253,
"upload_time": "2025-01-10T16:59:39",
"upload_time_iso_8601": "2025-01-10T16:59:39.108854Z",
"url": "https://files.pythonhosted.org/packages/ae/8d/470a06d17e573ec4368c679ef9263e35e44fec89ca32ed28dfebb6330960/site_scout-2.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f1068130dd2a45a2be83f87fe27b9cbcbe9d596498a04af54e32eab1c53479f3",
"md5": "0317d148b2ad77b74dde3aa9cf187346",
"sha256": "980c5788a28b1901a3485534a6fd779e8bc2cb1a4006cc51f0596fefdd3d4169"
},
"downloads": -1,
"filename": "site_scout-2.2.0.tar.gz",
"has_sig": false,
"md5_digest": "0317d148b2ad77b74dde3aa9cf187346",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 39185,
"upload_time": "2025-01-10T16:59:40",
"upload_time_iso_8601": "2025-01-10T16:59:40.326084Z",
"url": "https://files.pythonhosted.org/packages/f1/06/8130dd2a45a2be83f87fe27b9cbcbe9d596498a04af54e32eab1c53479f3/site_scout-2.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-10 16:59:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MozillaSecurity",
"github_project": "site-scout",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"tox": true,
"lcname": "site-scout"
}
JSON
