commit 34d99b79d2e04e89b117a5cc0c95eb3b8265a3c6 Author: Arturo Filastò <art@fuffa.org> Date: Wed Sep 11 18:15:06 2013 +0200 Update documentation and test decks to use shorthand for tests. (cherry picked from commit 86a7df4cef32f68e145e24ef815fe9793f88c9ae) --- README.md | 2 +- Vagrantfile | 2 +- decks/basic.deck | 4 ++-- decks/before_i_commit.testdeck | 8 ++++---- decks/short_no_root.deck | 10 +++++----- docs/source/index.rst | 16 ++++++++-------- docs/source/tests/dnsconsistency.rst | 4 ++-- docs/source/tests/http_requests.rst | 6 +++--- 8 files changed, 26 insertions(+), 26 deletions(-) diff --git a/README.md b/README.md index 0ffb096..53bff52 100644 --- a/README.md +++ b/README.md @@ -62,7 +62,7 @@ ooniprobe will be installed in `/ooni`. 3) You can run tests with: ``` -ooniprobe /usr/share/ooni/nettests/blocking/http_requests.py -f /ooni/inputs/input-pack/alexa-top-1k.txt +ooniprobe blocking/http_requests -f /ooni/inputs/input-pack/alexa-top-1k.txt ``` ## The easy way to prep your system for running ooniprobe diff --git a/Vagrantfile b/Vagrantfile index 9099960..76ce70c 100644 --- a/Vagrantfile +++ b/Vagrantfile @@ -36,7 +36,7 @@ echo "You may now visit http://localhost:8042/ to start running some ooniprobe t echo "" echo "Or if you are a bit more h4x0r you can ssh into the box and use the ooniprobe CLI" echo "Login using 'vagrant ssh', and dont forget to run ooniprobe as root." -echo "First run: 'sudo su; cd /usr/share/ooni; ./bin/ooniprobe -i decks/before_i_commit.testdeck'" +echo "First run: 'sudo su; cd /usr/share/ooni; ooniprobe -i decks/before_i_commit.testdeck'" SCRIPT diff --git a/decks/basic.deck b/decks/basic.deck index 84a8f9d..b2ede99 100644 --- a/decks/basic.deck +++ b/decks/basic.deck @@ -8,7 +8,7 @@ reportfile: null resume: 0 subargs: [-f, 'httpo://amcq5ldf3vwg22ze.onion/input/37e60e13536f6afe47a830bfb6b371b5cf65da66d7ad65137344679b24fdccd1'] - test_file: data/nettests/blocking/http_requests.py + test_file: blocking/http_requests testdeck: null - options: collector: null @@ -20,5 +20,5 @@ reportfile: null resume: 0 subargs: [-b, 'http://93.95.227.200'] - test_file: data/nettests/manipulation/http_header_field_manipulation.py + test_file: manipulation/http_header_field_manipulation testdeck: null diff --git a/decks/before_i_commit.testdeck b/decks/before_i_commit.testdeck index 1159a0d..69ef16c 100644 --- a/decks/before_i_commit.testdeck +++ b/decks/before_i_commit.testdeck @@ -5,7 +5,7 @@ pcapfile: null reportfile: reports/captive_portal_test.yamloo subargs: [] - test_file: data/nettests/manipulation/captiveportal.py + test_file: manipulation/captiveportal - options: collector: null help: 0 @@ -13,7 +13,7 @@ pcapfile: null reportfile: reports/dns_tamper_test.yamloo subargs: [-T, example_inputs/dns_tamper_test_resolvers.txt, -f, example_inputs/dns_tamper_file.txt] - test_file: data/nettests/blocking/dnsconsistency.py + test_file: blocking/dnsconsistency - options: collector: null help: 0 @@ -21,7 +21,7 @@ pcapfile: null reportfile: reports/http_host.yamloo subargs: [-b, 'http://93.95.227.200', -f, example_inputs/http_host_file.txt] - test_file: data/nettests/manipulation/http_host.py + test_file: manipulation/http_host - options: collector: null help: 0 @@ -29,4 +29,4 @@ pcapfile: null reportfile: reports/header_field_manipulation.yamloo subargs: [-b, 'http://93.95.227.200'] - test_file: data/nettests/manipulation/http_header_field_manipulation.py + test_file: manipulation/http_header_field_manipulation diff --git a/decks/short_no_root.deck b/decks/short_no_root.deck index fbc8f7b..ddd157a 100644 --- a/decks/short_no_root.deck +++ b/decks/short_no_root.deck @@ -8,7 +8,7 @@ reportfile: null resume: 0 subargs: [] - test_file: data/nettests/manipulation/captiveportal.py + test_file: manipulation/captiveportal testdeck: null - options: collector: null @@ -20,7 +20,7 @@ reportfile: null resume: 0 subargs: [-f, example_inputs/url_lists_file.txt] - test_file: data/nettests/blocking/http_requests.py + test_file: blocking/http_requests testdeck: null - options: collector: null @@ -32,7 +32,7 @@ reportfile: null resume: 0 subargs: [-f, example_inputs/tcpconnect_host_file.txt] - test_file: data/nettests/blocking/tcpconnect.py + test_file: blocking/tcpconnect testdeck: null - options: collector: null @@ -44,7 +44,7 @@ reportfile: null resume: 0 subargs: [-f, example_inputs/http_host_file.txt, -T, example_inputs/dns_tamper_test_resolvers.txt] - test_file: data/nettests/blocking/dnsconsistency.py + test_file: blocking/dnsconsistency testdeck: null - options: collector: null @@ -56,5 +56,5 @@ reportfile: null resume: 0 subargs: [-b, 'http://93.95.227.200'] - test_file: data/nettests/manipulation/http_header_field_manipulation.py + test_file: manipulation/http_header_field_manipulation testdeck: null diff --git a/docs/source/index.rst b/docs/source/index.rst index b74799c..b6c9894 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -39,9 +39,9 @@ Core ooniprobe Tests -------------------- The source for `Content blocking tests -<https://gitweb.torproject.org/ooni-probe.git/tree/HEAD:/data/nettests/blocking>`_ +<https://gitweb.torproject.org/ooni-probe.git/tree/HEAD:/ooni/nettests/blocking>`_ and `Traffic Manipulation tests -<https://gitweb.torproject.org/ooni-probe.git/tree/HEAD:/data/nettests/blocking>`_ +<https://gitweb.torproject.org/ooni-probe.git/tree/HEAD:/ooni/nettests/blocking>`_ can be found in the nettests/blocking and nettests/manipulation directories respectively. @@ -76,18 +76,18 @@ being experimented with. You can find these in: - * `data/nettests/experimental - <https://gitweb.torproject.org/ooni-probe.git/tree/HEAD:/data/nettests/experimental>`_ + * `ooni/nettests/experimental + <https://gitweb.torproject.org/ooni-probe.git/tree/HEAD:/ooni/nettests/experimental>`_ Tests that don't do a measurement but are useful for scanning can be found in: - * `data/nettests/scanning - <https://gitweb.torproject.org/ooni-probe.git/tree/HEAD:/data/nettests/scanning>`_ + * `ooni/nettests/scanning + <https://gitweb.torproject.org/ooni-probe.git/tree/HEAD:/ooni/nettests/scanning>`_ Tests that involve running third party tools may be found in: - * `data/nettests/third_party - <https://gitweb.torproject.org/ooni-probe.git/tree/HEAD:/data/nettests/third_party>`_ + * `ooni/nettests/third_party + <https://gitweb.torproject.org/ooni-probe.git/tree/HEAD:/ooni/nettests/third_party>`_ oonib ***** diff --git a/docs/source/tests/dnsconsistency.rst b/docs/source/tests/dnsconsistency.rst index 673661c..a667067 100644 --- a/docs/source/tests/dnsconsistency.rst +++ b/docs/source/tests/dnsconsistency.rst @@ -28,7 +28,7 @@ Youtube, etc. How to run the test =================== -`./bin/ooniprobe nettests/core/dnsconsistency.py [-t <test resolvers>|-T <test resolver file>-f <input file> -b IP:PORT` +`ooniprobe blocking/dnsconsistency [-t <test resolvers>|-T <test resolver file>-f <input file> -b IP:PORT` *test resolvers* is a single test resolver (IP address) @@ -42,7 +42,7 @@ Sample report ============= From running: -`./bin/ooniprobe nettests/core/dnsconsistency.py -T test_inputs/dns_tamper_test_resolvers.txt -f test_inputs/http_host_file.txt` +`ooniprobe blocking/dnsconsistency -T test_inputs/dns_tamper_test_resolvers.txt -f test_inputs/http_host_file.txt` :: diff --git a/docs/source/tests/http_requests.rst b/docs/source/tests/http_requests.rst index 6eb0d0a..6178072 100644 --- a/docs/source/tests/http_requests.rst +++ b/docs/source/tests/http_requests.rst @@ -32,17 +32,17 @@ How to run the test To test a single site run: -`./bin/ooniprobe nettests/blocking/http_requests.py -u http://<test_site>/` +`ooniprobe blocking/http_requests -u http://<test_site>/` To test a set of sites from a list containing sites to test run: -`./bin/ooniprobe nettests/blocking/http_requests.py -f <input_file>` +`ooniprobe blocking/http_requests -f <input_file>` Sample report ============= -`./bin/ooniprobe nettests/blocking/http_requests.py -f example_inputs/url_lists_file.txt` +`ooniprobe blocking/http_requests -f example_inputs/url_lists_file.txt` ::