1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122
|
Tutorial
========
.. Image Sources:
* The Little Relay That Could - train.png
Source: https://openclipart.org/detail/140185/tren-train-by-antroares
Author: Antroares
License: Public Domain
Alternate: https://openclipart.org/detail/1128/train-roadsign-by-ryanlerch
* To Russia With Love - soviet.png
Source: https://openclipart.org/detail/146017/flag-of-the-soviet-union-by-marxist-leninist
Author: Unknown
License: Public Domain (not a subject of copyright according the Russian civil code)
Alternate: https://openclipart.org/detail/85555/communist-sabbatarian-ribbon-by-rones-85555
* Tortoise and the Hare - tortoise.png
Source: https://openclipart.org/detail/27911/green-tortoise-%28cartoon%29-by-arking-27911
Author: arking
License: Public Domain
* Mirror Mirror On The Wall - mirror.png
Source: https://openclipart.org/detail/152155/mirror-frame-by-gsagri04
Author: Unknown (gsagri04?)
License: Public Domain
Alternate: https://openclipart.org/detail/174179/miroir-rectangulaire-by-defaz36-174179
* East of the Sun & West of the Moon - windrose.png
Source: https://commons.wikimedia.org/wiki/File:Compass_card_%28sl%29.svg
Author: Andrejj
License: CC0 (https://creativecommons.org/publicdomain/zero/1.0/deed.en)
* Mad Hatter - mad_hatter.png
Source: http://www.krepcio.com/vitreosity/archives/MadHatter-ALL-illus600.jpg
Author: John Tenniel
License: Public Doman
Augmented: Colored by me, and used the card from...
https://openclipart.org/detail/1892/mad-hatter-with-label-on-hat-by-nayrhcrel
* Double Double Toil and Trouble - cauldron.png
Source: https://openclipart.org/detail/174099/cauldron-by-jarda-174099
Author: Unknown (jarda?)
License: Public Domain
Getting started with any new library can be rather daunting, so let's get our
feet wet by jumping straight in with some tutorials...
.. list-table::
:widths: 1 10
:header-rows: 0
* - .. image:: /_static/section/tutorials/train.png
:target: tutorials/the_little_relay_that_could.html
- .. image:: /_static/label/the_little_relay_that_could.png
:target: tutorials/the_little_relay_that_could.html
Basics for talking with Tor. This will step you through configuring Tor
and writing your first script to talk with it.
* - .. image:: /_static/section/tutorials/soviet.png
:target: tutorials/to_russia_with_love.html
- .. image:: /_static/label/to_russia_with_love.png
:target: tutorials/to_russia_with_love.html
Rather than talking to Tor, we'll now talk **through** it. In this
tutorial we'll programmatically start Tor then use it to read a site
through mother Russia!
* - .. image:: /_static/section/tutorials/tortoise.png
:target: tutorials/tortoise_and_the_hare.html
- .. image:: /_static/label/tortoise_and_the_hare.png
:target: tutorials/tortoise_and_the_hare.html
As Tor runs it generates a variety of **events** that controllers can
subscribe to be notified of. In this tutorial we'll do just that,
writing a curses application that graphs the bandwidth usage of Tor.
* - .. image:: /_static/section/tutorials/mirror.png
:target: tutorials/mirror_mirror_on_the_wall.html
- .. image:: /_static/label/mirror_mirror_on_the_wall.png
:target: tutorials/mirror_mirror_on_the_wall.html
Getting and acting upon information about relays in the Tor network.
Relay information is provided through documents called **descriptors**.
This walks you through both where to get them and a small script to tell
you the fastest Tor exits.
* - .. image:: /_static/section/tutorials/windrose.png
:target: tutorials/east_of_the_sun.html
- .. image:: /_static/label/east_of_the_sun.png
:target: tutorials/east_of_the_sun.html
Stem provides several utility modules frequently useful for Tor
controller applications. Here we introduce some of them.
* - .. image:: /_static/section/tutorials/mad_hatter.png
:target: tutorials/down_the_rabbit_hole.html
- .. image:: /_static/label/down_the_rabbit_hole.png
:target: tutorials/down_the_rabbit_hole.html
Interactive interpreter for Tor that provides you with direct access to
Tor's `control interface
<https://gitweb.torproject.org/torspec.git/blob/HEAD:/control-spec.txt>`_
via either python or direct requests. This is an easy way of
experimenting with Stem and learning what Tor can do.
* - .. image:: /_static/section/tutorials/cauldron.png
:target: tutorials/double_double_toil_and_trouble.html
- .. image:: /_static/label/double_double_toil_and_trouble.png
:target: tutorials/double_double_toil_and_trouble.html
Sometimes it's easiest to learn a library by seeing how it's used in the
wild. This is a directory of scripts and applications that use Stem.
|