tor-browser

The Tor Browser
git clone https://git.dasho.dev/tor-browser.git
Log | Files | Refs | README | LICENSE

README (1580B)


      1 autospider.py is intended both as the harness for running automation builds, as
      2 well as a way to easily reproduce automation builds on a developer workstation.
      3 Some brave souls also use it as the basis for doing their normal local builds.
      4 
      5 Basic usage:
      6 
      7   ./js/src/devtools/automation/autospider.py plain
      8 
      9 The script may be run from any directory. This will configure and build the
     10 source, then run a series of tests. See the --help message for many different
     11 ways of suppressing various actions or changing the output.
     12 
     13 The different possible build+test configurations are controlled mostly by JSON
     14 files in a variants/ directory (eg there is a .../variants/plain file for the
     15 above command).
     16 
     17 In automation, the test jobs will run with a dynamically loaded library that
     18 catches crashes and generates minidumps, so that autospider.py can produce a
     19 readable stack trace at the end of the run. Currently this library is only
     20 available on linux64, and is built via the following procedure:
     21 
     22     % git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
     23     % export PATH=$PATH:$(pwd)/depot_tools
     24     % mkdir breakpad
     25     % cd breakpad
     26     # python must be python2.7
     27     % fetch breakpad
     28     % cd src
     29     % git fetch https://github.com/hotsphink/breakpad injector
     30     % git checkout FETCH_HEAD
     31     % cd ..
     32     % mkdir obj
     33     % cd obj
     34     # Possibly set $PATH to include a recent gcc
     35     % ../src/configure --enable-static
     36     % mkdir ../root
     37     % make install DESTDIR=$(pwd)/../root
     38 
     39 The shared library will now be in root/usr/local/lib64/libbreakpadinjector.so