[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]
[tor-commits] [ooni-probe/master] Update HACKING file to reflect directory structure changes
commit 5eddf83fa5d9bc97f439bc0be7152aed1a204a55
Author: Arturo Filastò <hellais@xxxxxxxxxxxxxx>
Date: Tue May 29 01:35:22 2012 +0200
Update HACKING file to reflect directory structure changes
---
HACKING | 36 +++++++++++++++++++++++-------------
1 files changed, 23 insertions(+), 13 deletions(-)
diff --git a/HACKING b/HACKING
index ed8d5dc..821d524 100644
--- a/HACKING
+++ b/HACKING
@@ -36,45 +36,55 @@ Code Structure
- HACKING
The document you are currently reading.
-- assets/
+- oonib/
+ Contains the OONI probe backend to be run on the ooni-net
+
+- oonid/
+ Contains the OONI daemon that can be used to interrogated from the cli to
+ run tests.
+
+- ooni/
+ Contains the main ooni probe comand line client
+
+- ooni/assets/
Where we store all the asset files that are
used when running OONI tests.
-- config.py
+- ooni/config.py
Parts of the code related to parsing OONI
configuration files and making them accessible
to other components of the software.
-- logo.py
+- ooni/logo.py
File containing some funny ASCII art. Yes, we
do enjoy ASCII art and are not afraid to admit it!
-- nodes.conf
+- ooni/nodes.conf
The configuration file for nodes. This contains the
list of network and code execution nodes that can be
used to run tests off of.
-- ooniprobe.py
+- ooni/ooniprobe.py
The main OONI-probe command line interface. This is
responsible for parsing the command line arguments and
passing the arguments to the underlying components.
-- ooni-probe.conf
+- ooni/ooni-probe.conf
The main OONI-probe configuration file. This can be used
to configure your OONI CLI, tell it where it should report
to, where the asset files are located, what should be used
for control, etc.
-- plugoo/__init__.py
+- ooni/plugoo/__init__.py
All the necessary "goo" for making OONI probe work. This
means loading Assets, creating Reports, running Tests,
interacting with Nodes.
-- plugoo/assets.py
+- ooni/plugoo/assets.py
This is a python object representation of the data that is
located inside the asset directory.
-- plugoo/nodes.py
+- ooni/plugoo/nodes.py
The part of code responsible for interacting with OONI Nodes.
Nodes can be Network or Code Execution. Network nodes are
capable of receiving packets and fowarding them onto their
@@ -83,19 +93,19 @@ Code Structure
of work, they are therefore capable of receiving a set of tests
that should be completed by a set of Network nodes or run locally.
-- plugoo/reports.py
+- ooni/plugoo/reports.py
Takes care of transforming the output of a test into a report. This
may mean pushing the result data to a remote backend or simply writing
a local file.
-- plugoo/tests.py
+- ooni/plugoo/tests.py
The main OONI probe test class. This provides all the necessary scaffold
to write your own test based on the OONI paradigm.
-- tests/
+- ooni/oonitests/
Contains all the "offical" OONI tests that are shipped.
-- utils.py
+- ooni/utils.py
Helper functions that don't fit into any place, but are not big enough to
be a dependency by themselves.
_______________________________________________
tor-commits mailing list
tor-commits@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits