site-scout 5.0.0

A tool to identify and report browser issues triggered by visiting a list of URLs.

Site Scout

Site Scout is a tool that can identify issues that are triggered by visiting live content. The primary goal is to create a tool that can be used in automation to collect debugging data for issues such as crashes and assertion failures. A collection of URLs to visit must be provided.

Installation

Install the latest version from PyPI:

pip install site-scout --upgrade

Usage

Visit one or more URLs (typically used to reproduce an issue):

site-scout <firefox-bin> -u <url> [<url> ...]

Visit a collection of URLs from a file:

site-scout <firefox-bin> -i <urls>.yml [<urls>.yml ...]

Input Formats

YML - URLs to visit are stored in the following format:

# 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/

JSONL - URLs to visits with optional alias:

{"url1.tld": "alias-string-1"}
{"url2.tld/path": "alias-string-2"}
{"sub.url3.tld": null}