Skip to content

Latest commit

 

History

History
58 lines (41 loc) · 1.53 KB

README.md

File metadata and controls

58 lines (41 loc) · 1.53 KB

[WIP]

ooni

Tools to Access the Open Observatory of Network Interference (‘OONI’)

Description

The ‘Open Observatory of Network Interference’ (http://ooni.io/) is a free software, global observation network for detecting censorship, surveillance and traffic manipulation on the internet. Tools are provided to query the ‘API’ and download both bulk metadata and test observation data files.

NOTE

The OONI API is nice for cursory analysis or some integrations with other systems (e.g. OONI Explorer relies on it), but it’s currently not possible to run any dataset scan that runs for more than a minute using the OONI API. So the API is not the best option if the query does heavy scanning of metadata. Also, implementation of pagination in the OONI API next_url is far from perfect and may fail with greater than zero offsets.

The plan is to eventually support both API & S3 access from this package.

What’s Inside The Tin

The following functions are implemented:

  • ooni_get_measurement Retrieve an OONI measurement
  • ooni_list_files List measurement files
  • ooni_list_measurements List measurements
  • ooni_next_pg Retrieve the next page of results from an OONI paginated API endpoint
  • ooni_pg_info Retrieve pagination metadata for a current request result object

Installation

devtools::install_github("hrbrmstr/ooni")
# OR
devtools::install_git("git://gitlab.com/hrbrmstr/ooni")

Usage

library(ooni)

# current verison
packageVersion("ooni")
## [1] '0.1.0'