August 2013 - tor-commits - lists.torproject.org

[stem/master] Explaining python's 'with' keyword
by atagar＠torproject.org 29 Aug '13

29 Aug '13

commit a7ec700c1b366b5cd96ba894916ad0a6e6fa0b4c Author: Damian Johnson <atagar(a)torproject.org> Date: Thu Aug 29 10:13:48 2013 -0700 Explaining python's 'with' keyword We've had a couple stem newcomers that saw the 'with' keyword in our examples then misused it in their scripts. Adding a little tutorial on the keyword and the common mistake they've been making. --- docs/faq.rst | 62 ++++++++++++++++++++++++ docs/tutorials/the_little_relay_that_could.rst | 4 +- 2 files changed, 65 insertions(+), 1 deletion(-) diff --git a/docs/faq.rst b/docs/faq.rst index f1edeee..76e7c91 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -14,6 +14,7 @@ Frequently Asked Questions * :ref:`how_do_i_request_a_new_identity_from_tor` * :ref:`how_do_i_get_information_about_my_exits` * :ref:`how_do_i_reload_my_torrc` + * :ref:`what_is_that_with_keyword_i_keep_seeing_in_the_tutorials` * **Development** @@ -180,6 +181,67 @@ Tor is configured through its `torrc <https://www.torproject.org/docs/faq.html.e controller.authenticate() controller.signal(Signal.SIGHUP) +.. _what_is_that_with_keyword_i_keep_seeing_in_the_tutorials: + +What is that 'with' keyword I keep seeing in the tutorials? +----------------------------------------------------------- + +Python's '**with**' keyword is shorthand for a try/finally block. With a :class:`~stem.control.Controller` the following... + +:: + + with Controller.from_port(port = 9051) as controller: + # do my stuff + +... is equivialnt to... + +:: + + controller = Controller.from_port(port = 9051) + + try: + # do my stuff + finally: + controller.close() + +This helps to make sure that regardless of if your code raises an exception or not the control connection will be cleaned up afterward. Note that this means that if you leave the 'with' scope your :class:`~stem.control.Controller` will be closed. For instance... + +:: + + class BandwidthReporter(object): + def __init__(self, controller): + self.controller = controller + + def print_bandwidth(self): + bytes_read = self.controller.get_info("traffic/read") + bytes_written = self.controller.get_info("traffic/written") + + print "My Tor relay has read %s bytes and written %s." % (bytes_read, bytes_written) + + if __name__ == '__main__': + with Controller.from_port(port = 9051) as controller: + reporter = BandwidthReporter(controller) + + # The following line is broken because the 'controller' we initialised + # above was disconnected once we left the 'with' scope. + + reporter.print_bandwidth() + +To fix this we could either move the print_bandwidth() call into the 'with' scope, or simply avoid using 'with' all together... + +:: + + if __name__ == '__main__': + controller = Controller.from_port(port = 9051) + + try: + reporter = BandwidthReporter(controller) + reporter.print_bandwidth() + finally: + controller.close() + +For more information about the 'with' keyword see `here <http://effbot.org/zone/python-with-statement.htm>`_. + Development =========== diff --git a/docs/tutorials/the_little_relay_that_could.rst b/docs/tutorials/the_little_relay_that_could.rst index 74fbe46..c30ae55 100644 --- a/docs/tutorials/the_little_relay_that_could.rst +++ b/docs/tutorials/the_little_relay_that_could.rst @@ -42,7 +42,9 @@ the following configuration options... When you change your torrc you'll need to either restart Tor is issue a SIGHUP for the new settings to take effect. Now let's write a script that tells us how -many bytes Tor has sent and received since it started... +many bytes Tor has sent and received since it started. If you're unfamiliar +with the '**with**' keyword then see `here +<../faq.html#what-is-that-with-keyword-i-keep-seeing-in-the-tutorials>`_... ::

1 0

[arm/master] Typo correction (transferInBystes)
by atagar＠torproject.org 29 Aug '13

29 Aug '13

commit e1953147143466cf1878b4b0f1718f42e8f77dde Author: Damian Johnson <atagar(a)torproject.org> Date: Thu Aug 29 09:21:15 2013 -0700 Typo correction (transferInBystes) Fixing a typo spotted by Roger. Luckily this typo just existed in a comment, not the actual config value. --- armrc.sample | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/armrc.sample b/armrc.sample index 6c119ca..8c57d33 100644 --- a/armrc.sample +++ b/armrc.sample @@ -183,7 +183,7 @@ features.graph.showIntermediateBounds true # prepopulate # attempts to use tor's state file to prepopulate the bandwidth graph at the # 15-minute interval (this requires the minimum of a day's worth of uptime) -# transferInBystes +# transferInBytes # shows rate measurments in bytes if true, bits otherwise # accounting.show # provides accounting stats if AccountingMax was set

1 0

[translation/https_everywhere_completed] Update translations for https_everywhere_completed
by translation＠torproject.org 29 Aug '13

29 Aug '13

commit e7526b2ff27249c73bf4dc662ed0add3dfd119b1 Author: Translation commit bot <translation(a)torproject.org> Date: Thu Aug 29 14:16:23 2013 +0000 Update translations for https_everywhere_completed --- ar/https-everywhere.dtd | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/ar/https-everywhere.dtd b/ar/https-everywhere.dtd index 6990425..1f9f471 100644 --- a/ar/https-everywhere.dtd +++ b/ar/https-everywhere.dtd @@ -34,4 +34,9 @@ <!ENTITY https-everywhere.source.filename "اسم الملف"> <!ENTITY https-everywhere.source.unable_to_download "تعذّر تنزيل المصدر."> - +<!ENTITY https-everywhere.popup.title "HTTPS Everywhere 4.0development.11 notification"> +<!ENTITY https-everywhere.popup.paragraph1 "عذراً. انت كنت تستخدم اصدار مستقر من HTTPS Everywhere، ولكن تم تحديث اصدارك إلي الاصدار التجريبي عن طريق الخطء."> +<!ENTITY https-everywhere.popup.paragraph2 "هل ترغب في العودة للاصدار المستقر؟"> +<!ENTITY https-everywhere.popup.paragraph3 "كنا نحب لو واصلت استخدام الاصدار التجريبي من HTTPS Everywhere لان ذلك يساعدنا علي جعل البرنامج أفضل! قد تجد في الاصدار التجريبي بعض الأخطاء التي يمكنك ان تبلغ عنها بمراسلة https-everywhere(a)eff.org. نآسف على الإزعاج و شكراً لأستخدامك HTTPS Everywhere."> +<!ENTITY https-everywhere.popup.keep "ابقني علي الاصدار التجريبي"> +<!ENTITY https-everywhere.popup.revert "حمل الاصدار المستقر الاخير">

1 0

[translation/https_everywhere] Update translations for https_everywhere
by translation＠torproject.org 29 Aug '13

29 Aug '13

commit 2bdce426fa7d415d549b2590f0c5444eb26fce6c Author: Translation commit bot <translation(a)torproject.org> Date: Thu Aug 29 14:16:17 2013 +0000 Update translations for https_everywhere --- ar/https-everywhere.dtd | 10 +++++----- el/https-everywhere.dtd | 8 ++++---- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/ar/https-everywhere.dtd b/ar/https-everywhere.dtd index c9d3f54..1f9f471 100644 --- a/ar/https-everywhere.dtd +++ b/ar/https-everywhere.dtd @@ -35,8 +35,8 @@ <!ENTITY https-everywhere.source.unable_to_download "تعذّر تنزيل المصدر."> <!ENTITY https-everywhere.popup.title "HTTPS Everywhere 4.0development.11 notification"> -<!ENTITY https-everywhere.popup.paragraph1 ""> -<!ENTITY https-everywhere.popup.paragraph2 ""> -<!ENTITY https-everywhere.popup.paragraph3 ""> -<!ENTITY https-everywhere.popup.keep ""> -<!ENTITY https-everywhere.popup.revert ""> +<!ENTITY https-everywhere.popup.paragraph1 "عذراً. انت كنت تستخدم اصدار مستقر من HTTPS Everywhere، ولكن تم تحديث اصدارك إلي الاصدار التجريبي عن طريق الخطء."> +<!ENTITY https-everywhere.popup.paragraph2 "هل ترغب في العودة للاصدار المستقر؟"> +<!ENTITY https-everywhere.popup.paragraph3 "كنا نحب لو واصلت استخدام الاصدار التجريبي من HTTPS Everywhere لان ذلك يساعدنا علي جعل البرنامج أفضل! قد تجد في الاصدار التجريبي بعض الأخطاء التي يمكنك ان تبلغ عنها بمراسلة https-everywhere(a)eff.org. نآسف على الإزعاج و شكراً لأستخدامك HTTPS Everywhere."> +<!ENTITY https-everywhere.popup.keep "ابقني علي الاصدار التجريبي"> +<!ENTITY https-everywhere.popup.revert "حمل الاصدار المستقر الاخير"> diff --git a/el/https-everywhere.dtd b/el/https-everywhere.dtd index c2faa65..92abc43 100644 --- a/el/https-everywhere.dtd +++ b/el/https-everywhere.dtd @@ -35,8 +35,8 @@ <!ENTITY https-everywhere.source.unable_to_download "Αδυναμί λήψης πηγαίου κώδικα."> <!ENTITY https-everywhere.popup.title "HTTPS Everywhere 4.0development.11 ειδοποίηση"> -<!ENTITY https-everywhere.popup.paragraph1 ""> -<!ENTITY https-everywhere.popup.paragraph2 ""> +<!ENTITY https-everywhere.popup.paragraph1 "Ωχ. Χρησιμοποιούσατε τη σταθερή έκδοση του HTTPS Everywhere, αλλά μπορεί κατά λάθος να σας αναβαθμίσαμε στην δοκιμαστική έκδοση κατά τη τελευταία ενημέρωση."> +<!ENTITY https-everywhere.popup.paragraph2 "Θα θέλατε να πάτε πίσω στη σταθερή έκδοση;"> <!ENTITY https-everywhere.popup.paragraph3 ""> -<!ENTITY https-everywhere.popup.keep ""> -<!ENTITY https-everywhere.popup.revert ""> +<!ENTITY https-everywhere.popup.keep "Αφήστε με, με τη δοκιμαστική έκδοση"> +<!ENTITY https-everywhere.popup.revert "Μεταφόρτωση της τελευταίας σταθερής έκδοσης">

1 0

[translation/torbirdy_completed] Update translations for torbirdy_completed
by translation＠torproject.org 29 Aug '13

29 Aug '13

commit 1e36b3d053d4a44d5f59a3ad584be9e02d4be0b2 Author: Translation commit bot <translation(a)torproject.org> Date: Thu Aug 29 13:46:29 2013 +0000 Update translations for torbirdy_completed --- el/torbirdy.dtd | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/el/torbirdy.dtd b/el/torbirdy.dtd index 884483b..c55f3dc 100644 --- a/el/torbirdy.dtd +++ b/el/torbirdy.dtd @@ -12,7 +12,9 @@ <!ENTITY torbirdy.prefs.save.button "Αποθήκευση"> <!ENTITY torbirdy.prefs.save.key "s"> <!ENTITY torbirdy.prefs.cancel.button "Ακύρωση"> -<!ENTITY torbirdy.prefs.extra2.button "Έλεγχος ρυθμίσεων"> +<!ENTITY torbirdy.prefs.extra1.button "Επαναφορά προεπιλεγμένων"> +<!ENTITY torbirdy.prefs.extra1.key "d"> +<!ENTITY torbirdy.prefs.extra2.button "Έλεγχος Ρυθμίσεων Proxy"> <!ENTITY torbirdy.prefs.extra2.key "g"> <!ENTITY torbirdy.prefs.proxy.label "Ρυθμίσεις Proxy"> <!ENTITY torbirdy.prefs.privacy.label "Ρυθμίσεις απορρήτου"> @@ -32,17 +34,19 @@ <!ENTITY torbirdy.prefs.torification.key "t"> <!ENTITY torbirdy.prefs.global "Παγκόσμια"> <!ENTITY torbirdy.prefs.imap.label "Ενεργοποίηση push email για υποστήριξη IMAP λογαριασμών [προεπιλογή: απενεργοποιημένο]"> -<!ENTITY torbirdy.prefs.imap.key "i"> +<!ENTITY torbirdy.prefs.imap.key "p"> <!ENTITY torbirdy.prefs.startup_folder.label "Επιλογή τελευταίου προσβάσιμου φακέλου e-mail κατά την εκκίνηση [προεπιλογή: απενεργοποιημένο, θα επιλεγούν τοπικοί φάκελοι]"> <!ENTITY torbirdy.prefs.startup_folder.key "l"> <!ENTITY torbirdy.prefs.timezone.label "Μην ορίσετε τη ζώνη ώρας του Thunderbird σε UTC [προεπιλογή: ορίστηκε σε UTC]"> <!ENTITY torbirdy.prefs.timezone.key "ζ"> <!ENTITY torbirdy.prefs.enigmail_throwkeyid.label "Απενεργοποίηση GPG '--throw-keyids' [προεπιλογή: ενεργοποιημένο]"> -<!ENTITY torbirdy.prefs.enigmail_throwkeyid.key "g"> +<!ENTITY torbirdy.prefs.enigmail_throwkeyid.key "ρ"> <!ENTITY torbirdy.prefs.confirmemail.label "Επιβεβαιωση πριν την αποστολη του email αν το Enigmail ειναι ενεργοποιημενο [προκαθορισμος: καμμια επιβεβαιωση]"> -<!ENTITY torbirdy.prefs.confirmemail.key "μ"> +<!ENTITY torbirdy.prefs.confirmemail.key "c"> <!ENTITY torbirdy.prefs.emailwizard.label "Ενεργοποίηση αυτόματης ρύθμισης παραμέτρων ηλεκτρονικού ταχυδρομείου Thunderbird του οδηγού [προεπιλογή: απενεργοποιημένο]"> <!ENTITY torbirdy.prefs.emailwizard.key "β"> +<!ENTITY torbirdy.prefs.automatic.label "Αυτόματος έλεγχος νέων μηνυμάτων για όλους τους λογαριασμούς [προεπιλογή: απενεργοποιημένο]"> +<!ENTITY torbirdy.prefs.automatic.key "f"> <!ENTITY torbirdy.prefs.renegotiation.label "Να επιτρέπονται συνδέσεις σε διακομιστές που δεν υποστηρίζουν SSL / TLS με ασφαλή επαναδιαπραγμάτευση [προεπιλογή: να μην επιτρέπονται] "> <!ENTITY torbirdy.prefs.renegotiation.key "ρ"> <!ENTITY torbirdy.prefs.account_specific "Ειδικός λογαριασμός">

1 0

[translation/torbirdy] Update translations for torbirdy
by translation＠torproject.org 29 Aug '13

29 Aug '13

commit 73a4bb6039e49727c510d68c9dda49f797d801e6 Author: Translation commit bot <translation(a)torproject.org> Date: Thu Aug 29 13:46:25 2013 +0000 Update translations for torbirdy --- el/torbirdy.dtd | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/el/torbirdy.dtd b/el/torbirdy.dtd index 39ef173..c55f3dc 100644 --- a/el/torbirdy.dtd +++ b/el/torbirdy.dtd @@ -14,7 +14,7 @@ <!ENTITY torbirdy.prefs.cancel.button "Ακύρωση"> <!ENTITY torbirdy.prefs.extra1.button "Επαναφορά προεπιλεγμένων"> <!ENTITY torbirdy.prefs.extra1.key "d"> -<!ENTITY torbirdy.prefs.extra2.button ""> +<!ENTITY torbirdy.prefs.extra2.button "Έλεγχος Ρυθμίσεων Proxy"> <!ENTITY torbirdy.prefs.extra2.key "g"> <!ENTITY torbirdy.prefs.proxy.label "Ρυθμίσεις Proxy"> <!ENTITY torbirdy.prefs.privacy.label "Ρυθμίσεις απορρήτου"> @@ -45,8 +45,8 @@ <!ENTITY torbirdy.prefs.confirmemail.key "c"> <!ENTITY torbirdy.prefs.emailwizard.label "Ενεργοποίηση αυτόματης ρύθμισης παραμέτρων ηλεκτρονικού ταχυδρομείου Thunderbird του οδηγού [προεπιλογή: απενεργοποιημένο]"> <!ENTITY torbirdy.prefs.emailwizard.key "β"> -<!ENTITY torbirdy.prefs.automatic.label ""> -<!ENTITY torbirdy.prefs.automatic.key ""> +<!ENTITY torbirdy.prefs.automatic.label "Αυτόματος έλεγχος νέων μηνυμάτων για όλους τους λογαριασμούς [προεπιλογή: απενεργοποιημένο]"> +<!ENTITY torbirdy.prefs.automatic.key "f"> <!ENTITY torbirdy.prefs.renegotiation.label "Να επιτρέπονται συνδέσεις σε διακομιστές που δεν υποστηρίζουν SSL / TLS με ασφαλή επαναδιαπραγμάτευση [προεπιλογή: να μην επιτρέπονται] "> <!ENTITY torbirdy.prefs.renegotiation.key "ρ"> <!ENTITY torbirdy.prefs.account_specific "Ειδικός λογαριασμός">

1 0

[translation/https_everywhere] Update translations for https_everywhere
by translation＠torproject.org 29 Aug '13

29 Aug '13

commit 8d8d51c1176a5f9e3ae911a43f7c1a137b2a3c7f Author: Translation commit bot <translation(a)torproject.org> Date: Thu Aug 29 13:46:08 2013 +0000 Update translations for https_everywhere --- el/https-everywhere.dtd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/el/https-everywhere.dtd b/el/https-everywhere.dtd index 9641bcb..c2faa65 100644 --- a/el/https-everywhere.dtd +++ b/el/https-everywhere.dtd @@ -34,7 +34,7 @@ <!ENTITY https-everywhere.source.filename "Όνομα αρχείου"> <!ENTITY https-everywhere.source.unable_to_download "Αδυναμί λήψης πηγαίου κώδικα."> -<!ENTITY https-everywhere.popup.title ""> +<!ENTITY https-everywhere.popup.title "HTTPS Everywhere 4.0development.11 ειδοποίηση"> <!ENTITY https-everywhere.popup.paragraph1 ""> <!ENTITY https-everywhere.popup.paragraph2 ""> <!ENTITY https-everywhere.popup.paragraph3 "">

1 0

[translation/https_everywhere_completed] Update translations for https_everywhere_completed
by translation＠torproject.org 29 Aug '13

29 Aug '13

commit 3acced52dbb4ef0d2fb20f6b18f3ecea677defbd Author: Translation commit bot <translation(a)torproject.org> Date: Thu Aug 29 07:16:19 2013 +0000 Update translations for https_everywhere_completed --- ro/https-everywhere.dtd | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/ro/https-everywhere.dtd b/ro/https-everywhere.dtd index 5f862b0..8114383 100644 --- a/ro/https-everywhere.dtd +++ b/ro/https-everywhere.dtd @@ -34,4 +34,10 @@ <!ENTITY https-everywhere.source.filename "Numele fisierului"> <!ENTITY https-everywhere.source.unable_to_download "Nu poate descarca sursa fisierului."> - +<!ENTITY https-everywhere.popup.title "Notificare HTTPS Everywhere 4.0development.11"> +<!ENTITY https-everywhere.popup.paragraph1 "Foloseai versiunea stabilă de HTTPS Everywhere dar accidental te-am actualizat la versiunea de dezvoltare la ultima noastră lansare."> +<!ENTITY https-everywhere.popup.paragraph2 "Vrei să te întorci la versiunea stabilă?"> +<!ENTITY https-everywhere.popup.paragraph3 "Ne-ar plăcea dacă ai continua să folosești versiunea de dezvoltare, ajutându-ne să facem HTTPS Everywhere mai bună! Ai putea găsi câteva hibe pe alocuri pe care le poți raporta la https-everywhere(a)eff.org. +Ne pare rău de neplăcerea produsă și îți mulțumim pentru că folosești HTTPS Everywhere."> +<!ENTITY https-everywhere.popup.keep "Ține-mă pe versiunea de dezvoltare"> +<!ENTITY https-everywhere.popup.revert "Descarcă ultima versiune stabilă">

1 0

[translation/https_everywhere] Update translations for https_everywhere
by translation＠torproject.org 29 Aug '13

29 Aug '13

commit 3b773310f532036080ce4b1e6c115a841c154994 Author: Translation commit bot <translation(a)torproject.org> Date: Thu Aug 29 07:16:13 2013 +0000 Update translations for https_everywhere --- ro/https-everywhere.dtd | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/ro/https-everywhere.dtd b/ro/https-everywhere.dtd index 10a9671..8114383 100644 --- a/ro/https-everywhere.dtd +++ b/ro/https-everywhere.dtd @@ -34,9 +34,10 @@ <!ENTITY https-everywhere.source.filename "Numele fisierului"> <!ENTITY https-everywhere.source.unable_to_download "Nu poate descarca sursa fisierului."> -<!ENTITY https-everywhere.popup.title ""> -<!ENTITY https-everywhere.popup.paragraph1 ""> -<!ENTITY https-everywhere.popup.paragraph2 ""> -<!ENTITY https-everywhere.popup.paragraph3 ""> -<!ENTITY https-everywhere.popup.keep ""> -<!ENTITY https-everywhere.popup.revert ""> +<!ENTITY https-everywhere.popup.title "Notificare HTTPS Everywhere 4.0development.11"> +<!ENTITY https-everywhere.popup.paragraph1 "Foloseai versiunea stabilă de HTTPS Everywhere dar accidental te-am actualizat la versiunea de dezvoltare la ultima noastră lansare."> +<!ENTITY https-everywhere.popup.paragraph2 "Vrei să te întorci la versiunea stabilă?"> +<!ENTITY https-everywhere.popup.paragraph3 "Ne-ar plăcea dacă ai continua să folosești versiunea de dezvoltare, ajutându-ne să facem HTTPS Everywhere mai bună! Ai putea găsi câteva hibe pe alocuri pe care le poți raporta la https-everywhere(a)eff.org. +Ne pare rău de neplăcerea produsă și îți mulțumim pentru că folosești HTTPS Everywhere."> +<!ENTITY https-everywhere.popup.keep "Ține-mă pe versiunea de dezvoltare"> +<!ENTITY https-everywhere.popup.revert "Descarcă ultima versiune stabilă">

1 0

[torbirdy/master] Update the ChangeLog (again)
by sukhbir＠torproject.org 29 Aug '13

29 Aug '13

commit 541e93f679ddac7199304074aae9b609b2c37448 Author: Sukhbir Singh <sukhbir(a)torproject.org> Date: Wed Aug 28 18:30:08 2013 -0400 Update the ChangeLog (again) --- ChangeLog | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index 7eaf204..3dcb27b 100644 --- a/ChangeLog +++ b/ChangeLog @@ -2,7 +2,7 @@ New options: restore default TorBirdy settings toggle checking of new messages automatically for all accounts - The minimum supported version of Thunderbird we now support is 10.0 + The minimum version of Thunderbird we now support is 10.0 Add Persian translation (thanks to Nima) Add Czech translation (thanks to dope) Add Esperanto translation (thanks to Michael Moroni)

1 0