This repository contains tools, libraries and applications to analyze network measurements.

Disclaimer: This is not an officially supported Jigsaw product.

Experimental code. We may break you. Please let us know if you are using this code.

netanalysis is not in PyPI. Instead you can install straight from our Github repository:

pip install git+git://github.com/Jigsaw-Code/net-analysis.git@master

On a Pipfile, you can do:

[packages]
netanalysis = {git = "git://github.com/Jigsaw-Code/net-analysis.git", ref = "master"}

You should specify a version tag or a commit if the master branch breaks you.

Analyze DNS Queries describes how to fetch data from OONI and check for interference.

netanalysis/analysis/DomainAnalysis.ipynb gives you an idea of what the analysis look like.

This uses the Google Transparency Report internal API. You must agree to Google APIs Terms of Service.

python -m netanalysis.traffic.data.fetch_google_traffic --output_dir=traffic_data/

See netanalysis/traffic/README.md for details.

python -m netanalysis.ip.ip_info 8.8.8.8

python -m netanalysis.tls.domain_ip_validator jigsaw.google.com 172.217.10.78

See Development Setup.

We welcome your contributions! See CONTRIBUTING.md for details and wishlist.