- tor-commits - lists.torproject.org

[flashproxy/master] ChangeLog entries for man pages and Windows executables.
by dcf＠torproject.org 03 Dec '12

03 Dec '12

commit 688010d2de57f06d9becaea22d974bcca95d3222 Author: David Fifield <david(a)bamsoftware.com> Date: Sun Dec 2 18:46:44 2012 -0800 ChangeLog entries for man pages and Windows executables. --- ChangeLog | 10 +++++++++- 1 files changed, 9 insertions(+), 1 deletions(-) diff --git a/ChangeLog b/ChangeLog index c623787..7ad2f00 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,6 +1,14 @@ Changes in version 0.9 + o There are executable Windows packages of the client programs, so + that the programs can be run without Python being installed. Fixes + bug 7283. Alexandre Allaire and David Fifield. + + o There are now man pages for the client programs (flashproxy-client, + flashproxy-reg-email, and flashproxy-reg-http). Fixes bug 6453. + Alexandre Allaire. + o The proxy now tries to determine whether it is running in Tor - Browser, and disables itself if so. Fixes bug #6293. Patch by Jorge + Browser, and disables itself if so. Fixes bug 6293. Patch by Jorge Couchet. Changes in version 0.8

1 0

[flashproxy/master] Increase version to 0.9.
by dcf＠torproject.org 03 Dec '12

03 Dec '12

commit db78920a43effd6e47071eb1ff3727b7de3b616f Author: David Fifield <david(a)bamsoftware.com> Date: Sun Dec 2 18:39:38 2012 -0800 Increase version to 0.9. The point of this release is the Windows client packages. --- Makefile | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-) diff --git a/Makefile b/Makefile index fbc8a2e..52eb40a 100644 --- a/Makefile +++ b/Makefile @@ -1,4 +1,4 @@ -VERSION = 0.8 +VERSION = 0.9 PREFIX = /usr/local BINDIR = $(PREFIX)/bin

1 0

[translation/vidalia_help_completed] Update translations for vidalia_help_completed
by translation＠torproject.org 03 Dec '12

03 Dec '12

commit 6da8a55543a5f54fb39ed6eb840949fcd9fc1688 Author: Translation commit bot <translation(a)torproject.org> Date: Mon Dec 3 02:45:40 2012 +0000 Update translations for vidalia_help_completed --- es/server.po | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-) diff --git a/es/server.po b/es/server.po index a52384b..073fd4b 100644 --- a/es/server.po +++ b/es/server.po @@ -9,7 +9,7 @@ msgstr "" "Project-Id-Version: The Tor Project\n" "Report-Msgid-Bugs-To: https://trac.torproject.org/projects/tor\n" "POT-Creation-Date: 2010-06-26 17:00+0200\n" -"PO-Revision-Date: 2012-12-02 06:09+0000\n" +"PO-Revision-Date: 2012-12-03 02:16+0000\n" "Last-Translator: strel <strelnic(a)gmail.com>\n" "Language-Team: Spanish (http://www.transifex.com/projects/p/torproject/language/es/)\n" "MIME-Version: 1.0\n"

1 0

[translation/vidalia_help] Update translations for vidalia_help
by translation＠torproject.org 03 Dec '12

03 Dec '12

commit 3da5e7c67de46e429145f3356062299f1b1c6e6b Author: Translation commit bot <translation(a)torproject.org> Date: Mon Dec 3 02:45:33 2012 +0000 Update translations for vidalia_help --- es/server.po | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-) diff --git a/es/server.po b/es/server.po index a52384b..073fd4b 100644 --- a/es/server.po +++ b/es/server.po @@ -9,7 +9,7 @@ msgstr "" "Project-Id-Version: The Tor Project\n" "Report-Msgid-Bugs-To: https://trac.torproject.org/projects/tor\n" "POT-Creation-Date: 2010-06-26 17:00+0200\n" -"PO-Revision-Date: 2012-12-02 06:09+0000\n" +"PO-Revision-Date: 2012-12-03 02:16+0000\n" "Last-Translator: strel <strelnic(a)gmail.com>\n" "Language-Team: Spanish (http://www.transifex.com/projects/p/torproject/language/es/)\n" "MIME-Version: 1.0\n"

1 0

[translation/vidalia_alpha_completed] Update translations for vidalia_alpha_completed
by translation＠torproject.org 03 Dec '12

03 Dec '12

commit 288c9b38ca3da89bd8fe27f6b9a16fa375ce624e Author: Translation commit bot <translation(a)torproject.org> Date: Mon Dec 3 02:45:23 2012 +0000 Update translations for vidalia_alpha_completed --- es/vidalia_es.po | 48 ++++++++++++++++++++++++------------------------ 1 files changed, 24 insertions(+), 24 deletions(-) diff --git a/es/vidalia_es.po b/es/vidalia_es.po index 02f5e9d..94e5261 100644 --- a/es/vidalia_es.po +++ b/es/vidalia_es.po @@ -9,7 +9,7 @@ msgstr "" "Project-Id-Version: The Tor Project\n" "Report-Msgid-Bugs-To: https://trac.torproject.org/projects/tor\n" "POT-Creation-Date: 2012-03-21 17:46+0000\n" -"PO-Revision-Date: 2012-12-01 22:34+0000\n" +"PO-Revision-Date: 2012-12-03 02:45+0000\n" "Last-Translator: strel <strelnic(a)gmail.com>\n" "Language-Team: Spanish (http://www.transifex.com/projects/p/torproject/language/es/)\n" "MIME-Version: 1.0\n" @@ -62,7 +62,7 @@ msgstr "%1 no existe. ¿Desea crearlo?" msgctxt "AdvancedPage" msgid "Failed to Create File" -msgstr "Error al Crear Archivo" +msgstr "Error al crear el archivo" msgctxt "AdvancedPage" msgid "Unable to create %1 [%2]" @@ -70,15 +70,15 @@ msgstr "No se pudo crear %1 [%2]" msgctxt "AdvancedPage" msgid "Select a Directory to Use for Tor Data" -msgstr "Seleccione una Carpeta para Almacenar Datos de Tor" +msgstr "Seleccione una carpeta para almacenar datos de Tor" msgctxt "AdvancedPage" msgid "Unable to remove Tor Service" -msgstr "No se pudo eliminar el Servicio Tor" +msgstr "No se pudo eliminar el servicio Tor" msgctxt "AdvancedPage" msgid "Unable to install Tor Service" -msgstr "No se pudo instalar el Servicio Tor" +msgstr "No se pudo instalar el servicio Tor" msgctxt "AdvancedPage" msgid "Vidalia was unable to install the Tor service." @@ -130,7 +130,7 @@ msgstr "Examinar" msgctxt "AdvancedPage" msgid "Data Directory" -msgstr "Carpeta de Datos" +msgstr "Carpeta de datos" msgctxt "AdvancedPage" msgid "Store data for the Tor software in the following directory" @@ -172,13 +172,13 @@ msgctxt "AdvancedPage" msgid "" "The specified Tor configuration file location contains characters that " "cannot be represented in your system's current 8-bit character encoding." -msgstr "La ubicación especificada para el archivo de configuración de Tor (torrc) contiene caracteres que no se pueden representar en la actual codificación de caracteres de 8 bits de su sistema." +msgstr "La ubicación especificada para el archivo de configuración de Tor (torrc) contiene caracteres que no se pueden representar con la actual codificación de caracteres de 8 bits de su sistema." msgctxt "AdvancedPage" msgid "" "The specified Tor data directory location contains characters that cannot be" " represented in your system's current 8-bit character encoding." -msgstr "La ubicación especificada para la carpeta de datos de Tor contiene caracteres que no se puede representar en la actual codificación de caracteres de 8 bits de su sistema." +msgstr "La ubicación especificada para la carpeta de datos de Tor contiene caracteres que no se puede representar con la actual codificación de caracteres de 8 bits de su sistema." msgctxt "AdvancedPage" msgid "Warning" @@ -190,7 +190,7 @@ msgstr "Ha cambiado la ruta de torrc, ¿le gustaría reiniciar Tor?" msgctxt "AdvancedPage" msgid "Tor Configuration File (torrc);;All Files (*)" -msgstr "Archivo de Configuración Tor (torrc);;Todos los Archivos (*)" +msgstr "Archivo de configuración Tor (torrc);;Todos los archivos (*)" msgctxt "AdvancedPage" msgid "Select a file to use for Tor socket path" @@ -235,7 +235,7 @@ msgid "" "Vidalia was unable to remove the Tor service.\n" "\n" "You may need to remove it manually." -msgstr "Vidalia no fue capaz de eliminar el servicio de Tor.\n\nPuede que sea necesario eliminarlo de manera manual." +msgstr "Vidalia no fue capaz de eliminar el servicio de Tor.\n\nPuede ser necesario que lo elimine manualmente." msgctxt "AdvancedPage" msgid "Select a Directory to Use for Panic" @@ -296,15 +296,15 @@ msgstr "Reiniciar" msgctxt "BandwidthGraph" msgid "Receive Rate" -msgstr "Tasa de Recepción" +msgstr "Tasa de recepción" msgctxt "BandwidthGraph" msgid "Send Rate" -msgstr "Tasa de Envío" +msgstr "Tasa de envío" msgctxt "BandwidthGraph" msgid "Always on Top" -msgstr "Siempre Encima" +msgstr "Mostrar siempre encima" msgctxt "BandwidthGraph" msgid "Style" @@ -312,7 +312,7 @@ msgstr "Estilo" msgctxt "BandwidthGraph" msgid "Changes the transparency of the Bandwidth Graph" -msgstr "Cambia la transparencia del Gráfico de Ancho de Banda" +msgstr "Cambia la transparencia del Gráfico de ancho de banda" msgctxt "BandwidthGraph" msgid "100" @@ -332,11 +332,11 @@ msgstr "Cancelar" msgctxt "BandwidthGraph" msgid "Bandwidth Graph" -msgstr "Gráfico de Ancho de Banda" +msgstr "Gráfico de ancho de banda" msgctxt "BridgeDownloader" msgid "Starting HTTPS bridge request..." -msgstr "Iniciando solicitud de bridges (repetidores puente, entradas a Tor de propagación restringida) por HTTPS..." +msgstr "Iniciando solicitud de bridges (repetidores puente, entradas a Tor de publicidad restringida) por HTTPS..." msgctxt "BridgeDownloader" msgid "Connecting to %1:%2..." @@ -352,7 +352,7 @@ msgstr "Descargando una lista de bridges..." msgctxt "BridgeDownloaderProgressDialog" msgid "Downloading Bridges" -msgstr "Descargando Bridges (repetidores puente, entradas a Tor de propagación restringida)" +msgstr "Descargando bridges (repetidores puente. entradas a Tor de publicidad restringida)" msgctxt "BridgeDownloaderProgressDialog" msgid "Unable to download bridges: %1" @@ -372,15 +372,15 @@ msgstr "Nº. de Clientes" msgctxt "BridgeUsageDialog" msgid "Clients from the following countries have used your relay since %1" -msgstr "Clientes de los siguientes países han usado su repetidor bridge desde %1" +msgstr "Clientes de los siguientes países han usado su repetidor puente desde %1" msgctxt "BridgeUsageDialog" msgid "Bridge Usage Summary" -msgstr "Resumen de Uso del Bridge (repetidor puente, entrada a Tor de propagación reducida)" +msgstr "Resumen de uso del bridge (repetidor puente, entrada a Tor de publicidad restringida)" msgctxt "BridgeUsageDialog" msgid "Client Summary" -msgstr "Resumen del Cliente" +msgstr "Resumen del cliente" msgctxt "Circuit" msgid "New" @@ -396,7 +396,7 @@ msgstr "Construyendo" msgctxt "Circuit" msgid "Failed" -msgstr "Fallido" +msgstr "Fallo" msgctxt "Circuit" msgid "Closed" @@ -408,7 +408,7 @@ msgstr "Desconocido" msgctxt "CircuitItem" msgid "<Path Empty>" -msgstr "<Ruta Vacía>" +msgstr "<Ruta vacía>" msgctxt "CircuitListWidget" msgid "Connection" @@ -424,11 +424,11 @@ msgstr "Zoom al circuito" msgctxt "CircuitListWidget" msgid "Close Circuit (Del)" -msgstr "Cerrar Circuito (Del)" +msgstr "Cerrar circuito (Del)" msgctxt "CircuitListWidget" msgid "Close Stream (Del)" -msgstr "Cerrar Flujo (Del)" +msgstr "Cerrar flujo (Del)" msgctxt "ConfigDialog" msgid "General"

1 0

[translation/vidalia_alpha] Update translations for vidalia_alpha
by translation＠torproject.org 03 Dec '12

03 Dec '12

commit 853413ac25e4b19f5ebb7874f708beb04dd6fac0 Author: Translation commit bot <translation(a)torproject.org> Date: Mon Dec 3 02:45:20 2012 +0000 Update translations for vidalia_alpha --- es/vidalia_es.po | 48 ++++++++++++++++++++++++------------------------ 1 files changed, 24 insertions(+), 24 deletions(-) diff --git a/es/vidalia_es.po b/es/vidalia_es.po index 02f5e9d..94e5261 100644 --- a/es/vidalia_es.po +++ b/es/vidalia_es.po @@ -9,7 +9,7 @@ msgstr "" "Project-Id-Version: The Tor Project\n" "Report-Msgid-Bugs-To: https://trac.torproject.org/projects/tor\n" "POT-Creation-Date: 2012-03-21 17:46+0000\n" -"PO-Revision-Date: 2012-12-01 22:34+0000\n" +"PO-Revision-Date: 2012-12-03 02:45+0000\n" "Last-Translator: strel <strelnic(a)gmail.com>\n" "Language-Team: Spanish (http://www.transifex.com/projects/p/torproject/language/es/)\n" "MIME-Version: 1.0\n" @@ -62,7 +62,7 @@ msgstr "%1 no existe. ¿Desea crearlo?" msgctxt "AdvancedPage" msgid "Failed to Create File" -msgstr "Error al Crear Archivo" +msgstr "Error al crear el archivo" msgctxt "AdvancedPage" msgid "Unable to create %1 [%2]" @@ -70,15 +70,15 @@ msgstr "No se pudo crear %1 [%2]" msgctxt "AdvancedPage" msgid "Select a Directory to Use for Tor Data" -msgstr "Seleccione una Carpeta para Almacenar Datos de Tor" +msgstr "Seleccione una carpeta para almacenar datos de Tor" msgctxt "AdvancedPage" msgid "Unable to remove Tor Service" -msgstr "No se pudo eliminar el Servicio Tor" +msgstr "No se pudo eliminar el servicio Tor" msgctxt "AdvancedPage" msgid "Unable to install Tor Service" -msgstr "No se pudo instalar el Servicio Tor" +msgstr "No se pudo instalar el servicio Tor" msgctxt "AdvancedPage" msgid "Vidalia was unable to install the Tor service." @@ -130,7 +130,7 @@ msgstr "Examinar" msgctxt "AdvancedPage" msgid "Data Directory" -msgstr "Carpeta de Datos" +msgstr "Carpeta de datos" msgctxt "AdvancedPage" msgid "Store data for the Tor software in the following directory" @@ -172,13 +172,13 @@ msgctxt "AdvancedPage" msgid "" "The specified Tor configuration file location contains characters that " "cannot be represented in your system's current 8-bit character encoding." -msgstr "La ubicación especificada para el archivo de configuración de Tor (torrc) contiene caracteres que no se pueden representar en la actual codificación de caracteres de 8 bits de su sistema." +msgstr "La ubicación especificada para el archivo de configuración de Tor (torrc) contiene caracteres que no se pueden representar con la actual codificación de caracteres de 8 bits de su sistema." msgctxt "AdvancedPage" msgid "" "The specified Tor data directory location contains characters that cannot be" " represented in your system's current 8-bit character encoding." -msgstr "La ubicación especificada para la carpeta de datos de Tor contiene caracteres que no se puede representar en la actual codificación de caracteres de 8 bits de su sistema." +msgstr "La ubicación especificada para la carpeta de datos de Tor contiene caracteres que no se puede representar con la actual codificación de caracteres de 8 bits de su sistema." msgctxt "AdvancedPage" msgid "Warning" @@ -190,7 +190,7 @@ msgstr "Ha cambiado la ruta de torrc, ¿le gustaría reiniciar Tor?" msgctxt "AdvancedPage" msgid "Tor Configuration File (torrc);;All Files (*)" -msgstr "Archivo de Configuración Tor (torrc);;Todos los Archivos (*)" +msgstr "Archivo de configuración Tor (torrc);;Todos los archivos (*)" msgctxt "AdvancedPage" msgid "Select a file to use for Tor socket path" @@ -235,7 +235,7 @@ msgid "" "Vidalia was unable to remove the Tor service.\n" "\n" "You may need to remove it manually." -msgstr "Vidalia no fue capaz de eliminar el servicio de Tor.\n\nPuede que sea necesario eliminarlo de manera manual." +msgstr "Vidalia no fue capaz de eliminar el servicio de Tor.\n\nPuede ser necesario que lo elimine manualmente." msgctxt "AdvancedPage" msgid "Select a Directory to Use for Panic" @@ -296,15 +296,15 @@ msgstr "Reiniciar" msgctxt "BandwidthGraph" msgid "Receive Rate" -msgstr "Tasa de Recepción" +msgstr "Tasa de recepción" msgctxt "BandwidthGraph" msgid "Send Rate" -msgstr "Tasa de Envío" +msgstr "Tasa de envío" msgctxt "BandwidthGraph" msgid "Always on Top" -msgstr "Siempre Encima" +msgstr "Mostrar siempre encima" msgctxt "BandwidthGraph" msgid "Style" @@ -312,7 +312,7 @@ msgstr "Estilo" msgctxt "BandwidthGraph" msgid "Changes the transparency of the Bandwidth Graph" -msgstr "Cambia la transparencia del Gráfico de Ancho de Banda" +msgstr "Cambia la transparencia del Gráfico de ancho de banda" msgctxt "BandwidthGraph" msgid "100" @@ -332,11 +332,11 @@ msgstr "Cancelar" msgctxt "BandwidthGraph" msgid "Bandwidth Graph" -msgstr "Gráfico de Ancho de Banda" +msgstr "Gráfico de ancho de banda" msgctxt "BridgeDownloader" msgid "Starting HTTPS bridge request..." -msgstr "Iniciando solicitud de bridges (repetidores puente, entradas a Tor de propagación restringida) por HTTPS..." +msgstr "Iniciando solicitud de bridges (repetidores puente, entradas a Tor de publicidad restringida) por HTTPS..." msgctxt "BridgeDownloader" msgid "Connecting to %1:%2..." @@ -352,7 +352,7 @@ msgstr "Descargando una lista de bridges..." msgctxt "BridgeDownloaderProgressDialog" msgid "Downloading Bridges" -msgstr "Descargando Bridges (repetidores puente, entradas a Tor de propagación restringida)" +msgstr "Descargando bridges (repetidores puente. entradas a Tor de publicidad restringida)" msgctxt "BridgeDownloaderProgressDialog" msgid "Unable to download bridges: %1" @@ -372,15 +372,15 @@ msgstr "Nº. de Clientes" msgctxt "BridgeUsageDialog" msgid "Clients from the following countries have used your relay since %1" -msgstr "Clientes de los siguientes países han usado su repetidor bridge desde %1" +msgstr "Clientes de los siguientes países han usado su repetidor puente desde %1" msgctxt "BridgeUsageDialog" msgid "Bridge Usage Summary" -msgstr "Resumen de Uso del Bridge (repetidor puente, entrada a Tor de propagación reducida)" +msgstr "Resumen de uso del bridge (repetidor puente, entrada a Tor de publicidad restringida)" msgctxt "BridgeUsageDialog" msgid "Client Summary" -msgstr "Resumen del Cliente" +msgstr "Resumen del cliente" msgctxt "Circuit" msgid "New" @@ -396,7 +396,7 @@ msgstr "Construyendo" msgctxt "Circuit" msgid "Failed" -msgstr "Fallido" +msgstr "Fallo" msgctxt "Circuit" msgid "Closed" @@ -408,7 +408,7 @@ msgstr "Desconocido" msgctxt "CircuitItem" msgid "<Path Empty>" -msgstr "<Ruta Vacía>" +msgstr "<Ruta vacía>" msgctxt "CircuitListWidget" msgid "Connection" @@ -424,11 +424,11 @@ msgstr "Zoom al circuito" msgctxt "CircuitListWidget" msgid "Close Circuit (Del)" -msgstr "Cerrar Circuito (Del)" +msgstr "Cerrar circuito (Del)" msgctxt "CircuitListWidget" msgid "Close Stream (Del)" -msgstr "Cerrar Flujo (Del)" +msgstr "Cerrar flujo (Del)" msgctxt "ConfigDialog" msgid "General"

1 0

[stem/master] Base class for events
by atagar＠torproject.org 03 Dec '12

03 Dec '12

commit cac0c434ca9a4ed1f9bb6aa940dba1e006b92471 Author: Damian Johnson <atagar(a)torproject.org> Date: Sun Nov 4 18:38:28 2012 -0800 Base class for events Adding a base class for tor events which does the initial parsing of positional and keyword arguments. This is using a similar design to the TorCtl patch I wrote for #3679 (but a little better). --- stem/control.py | 4 +- stem/response/__init__.py | 3 ++ stem/response/events.py | 65 ++++++++++++++++++++++++++++++++++++++ test/integ/control/controller.py | 8 +++-- 4 files changed, 75 insertions(+), 5 deletions(-) diff --git a/stem/control.py b/stem/control.py index ca3730b..fdcf972 100644 --- a/stem/control.py +++ b/stem/control.py @@ -1410,11 +1410,11 @@ class Controller(BaseController): def _handle_event(self, event_message): # TODO: parse the event_message into a stem.response.events.Event class - event_message_type = str(event_message).split()[0] + stem.response.convert("EVENT", event_message, arrived_at=time.time()) with self._event_listeners_lock: for event_type, event_listeners in self._event_listeners.items(): - if event_type == event_message_type: + if event_type == event_message.type: for listener in event_listeners: listener(event_message) diff --git a/stem/response/__init__.py b/stem/response/__init__.py index 050ba02..2e9296d 100644 --- a/stem/response/__init__.py +++ b/stem/response/__init__.py @@ -26,6 +26,7 @@ Parses replies from the control socket. from __future__ import with_statement __all__ = [ + "events", "getinfo", "getconf", "protocolinfo", @@ -85,6 +86,7 @@ def convert(response_type, message, **kwargs): or response_type isn't supported """ + import stem.response.events import stem.response.getinfo import stem.response.getconf import stem.response.protocolinfo @@ -95,6 +97,7 @@ def convert(response_type, message, **kwargs): raise TypeError("Only able to convert stem.response.ControlMessage instances") response_types = { + "EVENT": stem.response.events.Event, "GETINFO": stem.response.getinfo.GetInfoResponse, "GETCONF": stem.response.getconf.GetConfResponse, "MAPADDRESS": stem.response.mapaddress.MapAddressResponse, diff --git a/stem/response/events.py b/stem/response/events.py new file mode 100644 index 0000000..32dd655 --- /dev/null +++ b/stem/response/events.py @@ -0,0 +1,65 @@ +import re + +import stem.response + +# Matches keyword=value arguments. This can't be a simple "(.*)=(.*)" pattern +# because some positional arguments, like circuit paths, can have an equal +# sign. + +KW_ARG = re.compile("([A-Za-z0-9_]+)=(.*)") + +class Event(stem.response.ControlMessage): + """ + Base for events we receive asynchronously, as described in section 4.1 of the + `control-spec + <https://gitweb.torproject.org/torspec.git/blob/HEAD:/control-spec.txt>`_. + """ + + _POSITIONAL_ARGS = () + _KEYWORD_ARGS = {} + + def _parse_message(self, arrived_at): + fields = str(self).split() + + if not fields: + raise stem.socket.ProtocolError("Received a blank tor event. Events must at the very least have a type.") + + self.type = fields.pop(0) + self.arrived_at = arrived_at + + # Tor events contain some number of positional arguments followed by + # key/value mappings. Parsing keyword arguments from the end until we hit + # something that isn't a key/value mapping. The rest are positional. + + self.positional_args = [] + self.keyword_args = {} + + while fields: + kw_match = KW_ARG.match(fields[-1]) + + if kw_match: + k, v = kw_match.groups() + self.keyword_args[k] = v + fields.pop() # remove the field + else: + # not a key/value mapping, the remaining fields are positional + self.positional_args = fields + break + + # Setting attributes for the fields that we recognize. Unrecognized fields + # only appear in our 'positional_args' and 'keyword_args' attributes. + + for i in xrange(len(self._POSITIONAL_ARGS)): + attr_name = self._POSITIONAL_ARGS[i] + attr_value = self.positional_args[i] if i < len(self.positional_args) else None + + setattr(self, attr_name, attr_value) + + for controller_attr_name, attr_name in self._KEYWORD_ARGS.items(): + setattr(self, attr_name, self.keyword_args.get(controller_attr_name)) + + # if we're a recognized event type then translate ourselves into that subclass + + #self.__class__ = response_class + #self._parse_message() + diff --git a/test/integ/control/controller.py b/test/integ/control/controller.py index e5d7782..8f93d53 100644 --- a/test/integ/control/controller.py +++ b/test/integ/control/controller.py @@ -74,9 +74,6 @@ class TestController(unittest.TestCase): # BW events occure at the rate of one per second, so wait a bit to let # some accumulate. - # TODO: check that the type of events in event_buffer1 are BandwidthEvent - # instances when we have proper event types - time.sleep(3) self.assertTrue(len(event_buffer1) >= 2) @@ -91,6 +88,11 @@ class TestController(unittest.TestCase): self.assertTrue(len(event_buffer1) >= 4) self.assertEqual(buffer2_size, len(event_buffer2)) + + for event in event_buffer1: + self.assertTrue(isinstance(event, stem.response.events.Event)) + self.assertEqual(2, len(event.positional_args)) + self.assertEqual({}, event.keyword_args) def test_getinfo(self): """

1 0

[stem/master] Unit test for add_event_listener() example
by atagar＠torproject.org 03 Dec '12

03 Dec '12

commit 1a6a4d55701aaa199c14e1ef1ee1b6455922d761 Author: Damian Johnson <atagar(a)torproject.org> Date: Mon Nov 5 08:02:15 2012 -0800 Unit test for add_event_listener() example Adding a unit test for the pydoc example in add_event_listener(). I really, really don't like how the tests for these documentation examples are turning out. The end result looks precious little like the example and is convoluted as hell. We should revisit how we do documentation example testing in the future, but that'll be a subproject in itself. --- run_tests.py | 2 + stem/control.py | 2 +- test/unit/response/__init__.py | 1 + test/unit/response/events.py | 43 ++++++++++++++++++++++++++++++++++++++++ 4 files changed, 47 insertions(+), 1 deletions(-) diff --git a/run_tests.py b/run_tests.py index b4f0c06..f490da7 100755 --- a/run_tests.py +++ b/run_tests.py @@ -27,6 +27,7 @@ import test.unit.descriptor.networkstatus.document_v2 import test.unit.descriptor.networkstatus.document_v3 import test.unit.response.control_line import test.unit.response.control_message +import test.unit.response.events import test.unit.response.getinfo import test.unit.response.getconf import test.unit.response.protocolinfo @@ -133,6 +134,7 @@ UNIT_TESTS = ( test.unit.tutorial.TestTutorial, test.unit.response.control_message.TestControlMessage, test.unit.response.control_line.TestControlLine, + test.unit.response.events.TestEvents, test.unit.response.getinfo.TestGetInfoResponse, test.unit.response.getconf.TestGetConfResponse, test.unit.response.singleline.TestSingleLineResponse, diff --git a/stem/control.py b/stem/control.py index e07658d..c2a94aa 100644 --- a/stem/control.py +++ b/stem/control.py @@ -1422,7 +1422,7 @@ class Controller(BaseController): return response.entries def _handle_event(self, event_message): - stem.response.convert("EVENT", event_message, arrived_at=time.time()) + stem.response.convert("EVENT", event_message, arrived_at = time.time()) with self._event_listeners_lock: for event_type, event_listeners in self._event_listeners.items(): diff --git a/test/unit/response/__init__.py b/test/unit/response/__init__.py index 530a5d3..51f3cd1 100644 --- a/test/unit/response/__init__.py +++ b/test/unit/response/__init__.py @@ -5,6 +5,7 @@ Unit tests for stem.response. __all__ = [ "control_message", "control_line", + "events", "getinfo", "getconf", "protocolinfo", diff --git a/test/unit/response/events.py b/test/unit/response/events.py new file mode 100644 index 0000000..b1111bc --- /dev/null +++ b/test/unit/response/events.py @@ -0,0 +1,43 @@ +""" +Unit tests for the stem.response.events classes. +""" + +import threading +import unittest + +import stem.response +import test.mocking as mocking + +class TestEvents(unittest.TestCase): + def test_example(self): + """ + Exercises the add_event_listener() pydoc example, but without the sleep(). + """ + + import time + from stem.control import Controller, EventType + + def print_bw(event): + msg = "sent: %i, received: %i" % (event.written, event.read) + self.assertEqual("sent: 25, received: 15", msg) + + def event_sender(): + for i in xrange(3): + controller_event = mocking.get_message("650 BW 15 25") + stem.response.convert("EVENT", controller_event, arrived_at = 25) + print_bw(controller_event) + time.sleep(0.05) + + controller = mocking.get_object(Controller, { + 'authenticate': mocking.no_op(), + 'add_event_listener': mocking.no_op(), + }) + + controller.authenticate() + controller.add_event_listener(print_bw, EventType.BW) + + events_thread = threading.Thread(target = event_sender) + events_thread.start() + time.sleep(0.2) + events_thread.join() +

1 0

[stem/master] Adding a add_event_listener() example
by atagar＠torproject.org 03 Dec '12

03 Dec '12

commit cc530bb2005f0e156c62fe322d5b43ffe16c3e99 Author: Damian Johnson <atagar(a)torproject.org> Date: Mon Nov 5 07:20:49 2012 -0800 Adding a add_event_listener() example On reflection the example that I included on ticket #7328 is pretty good at exemplifying the function's usage, so including it in our pydocs. --- stem/control.py | 16 +++++++++++++++- 1 files changed, 15 insertions(+), 1 deletions(-) diff --git a/stem/control.py b/stem/control.py index bfb907c..e07658d 100644 --- a/stem/control.py +++ b/stem/control.py @@ -563,7 +563,21 @@ class Controller(BaseController): """ Directs further tor controller events to a given function. The function is expected to take a single argument, which is a - :class:`~stem.response.events.Event` subclass. + :class:`~stem.response.events.Event` subclass. For instance the following + would would print the bytes sent and received by tor over five seconds... + + :: + + import time + from stem.control import Controller, EventType + + def print_bw(event): + print "sent: %i, received: %i" % (event.written, event.read) + + with Controller.from_port(control_port = 9051) as controller: + controller.authenticate() + controller.add_event_listener(print_bw, EventType.BW) + time.sleep(5) If a new control connection is initialized then this listener will be reattached.

1 0

[stem/master] BandwidthEvent class
by atagar＠torproject.org 03 Dec '12

03 Dec '12

commit c35a626af19a5d22b8cc1ca1cef5bae212e3a726 Author: Damian Johnson <atagar(a)torproject.org> Date: Sun Nov 4 21:06:05 2012 -0800 BandwidthEvent class Adding a class to handle BW events. This is the easiest type of tor event to test because it's emitted every second. The other event types we'll probably need to go with unit tests. --- stem/control.py | 2 -- stem/response/events.py | 34 +++++++++++++++++++++++++++++++--- test/integ/control/controller.py | 4 ++++ 3 files changed, 35 insertions(+), 5 deletions(-) diff --git a/stem/control.py b/stem/control.py index fdcf972..bfb907c 100644 --- a/stem/control.py +++ b/stem/control.py @@ -1408,8 +1408,6 @@ class Controller(BaseController): return response.entries def _handle_event(self, event_message): - # TODO: parse the event_message into a stem.response.events.Event class - stem.response.convert("EVENT", event_message, arrived_at=time.time()) with self._event_listeners_lock: diff --git a/stem/response/events.py b/stem/response/events.py index 32dd655..7a2f9da 100644 --- a/stem/response/events.py +++ b/stem/response/events.py @@ -1,6 +1,7 @@ import re import stem.response +import stem.socket # Matches keyword=value arguments. This can't be a simple "(.*)=(.*)" pattern # because some positional arguments, like circuit paths, can have an equal @@ -27,6 +28,11 @@ class Event(stem.response.ControlMessage): self.type = fields.pop(0) self.arrived_at = arrived_at + # if we're a recognized event type then translate ourselves into that subclass + + if self.type in EVENT_TYPE_TO_CLASS: + self.__class__ = EVENT_TYPE_TO_CLASS[self.type] + # Tor events contain some number of positional arguments followed by # key/value mappings. Parsing keyword arguments from the end until we hit # something that isn't a key/value mapping. The rest are positional. @@ -58,8 +64,30 @@ class Event(stem.response.ControlMessage): for controller_attr_name, attr_name in self._KEYWORD_ARGS.items(): setattr(self, attr_name, self.keyword_args.get(controller_attr_name)) - # if we're a recognized event type then translate ourselves into that subclass + self._parse() + + # method overwritten by our subclasses for special handling that they do + def _parse(self): + pass + +class BandwidthEvent(Event): + """ + Event emitted every second with the bytes sent and received by tor. + + :var long read: bytes received by tor that second + :var long written: bytes sent by tor that second + """ + + _POSITIONAL_ARGS = ("read", "written") + + def _parse(self): + if (self.read and not self.read.isdigit()) or (self.written and not self.written.isdigit()): + raise stem.socket.ProtocolError("A BW event's bytes sent and received values should be numeric, received: %s" % self) - #self.__class__ = response_class - #self._parse_message() + self.read = long(self.read) + self.written = long(self.written) + +EVENT_TYPE_TO_CLASS = { + "BW": BandwidthEvent, +} diff --git a/test/integ/control/controller.py b/test/integ/control/controller.py index 8f93d53..496028c 100644 --- a/test/integ/control/controller.py +++ b/test/integ/control/controller.py @@ -93,6 +93,10 @@ class TestController(unittest.TestCase): self.assertTrue(isinstance(event, stem.response.events.Event)) self.assertEqual(2, len(event.positional_args)) self.assertEqual({}, event.keyword_args) + + self.assertTrue(isinstance(event, stem.response.events.BandwidthEvent)) + self.assertTrue(hasattr(event, 'read')) + self.assertTrue(hasattr(event, 'written')) def test_getinfo(self): """

1 0