File: tutorials.rst

package info (click to toggle)
python-stem 1.2.2-1.1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 4,568 kB
  • ctags: 2,036
  • sloc: python: 20,108; makefile: 127; sh: 3
file content (122 lines) | stat: -rw-r--r-- 5,103 bytes parent folder | download | duplicates (2)
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.