Bump version

And fix minor things

README.md

@@ -36,6 +36,8 @@
 
 With this program, it's possible to use a MuC `XMPP` room to talk to a group on `Telegram` and vice versa. The aim of this program is to be just a simple gateway, just pass text from one way to the other. Once it's stable, it probably won't have more improvements, since I don't need them.
 
+Since version 0.1.6, Jabbergram has HTTP Upload support. If the server supports it, it will automatically upload all the files sent to the Telegram group.
+
 ### Installation<a id="orgheadline2"></a>
 
 As with any program that uses python, it should be used a virtual environment (virtualenv), but that is user selectable. It's possible to use one of the next installation methods:
@@ -46,7 +48,7 @@ Install via pip:
 
 Clone the repository:
 
-    $ git clone git://daemons.cf/jabbergram
+    $ git clone https://git.daemons.it/drymer/jabbergram
     $ cd jabbergram
     $ su -c "pip3 install -r requirements.txt"
     $ su -c "python3 setup.py install"
@@ -81,10 +83,17 @@ There's no easy way to see this from telegram, so you can use the separate utili
 
 ### Usage<a id="orgheadline4"></a>
 
-You can create all config files you want. You will only need to pass it as parameter, but if you don't it will try to grab `config.ini` by default, and it will fail if it doesn't exist:
+There only can be one configuration file. This is because it can only be one bot connection, when there's more than one, message are lost. Therefore, for linking more rooms you must "link" them in the configuration. This is done simply by hooking jabber rooms with Telegram:
 
-    # it's advisable to use tmux or screen to execute the next order
+    [Config]
-    $ jabbergram.py example.ini
+    JID = exampleJid@nope.org
+    password = difficultPassword
+    muc_room = exampleMuc@muc.nope.org segunda@muc.sip.org
+    nick = jabbergram
+    token = jabbergramBotTokken
+    group = -10293943920 120301203
+
+Thus, the example's muc "exampleMuc@muc.nope.org" syncs with the group "-10293943920" and "segunda@muc.sip.org" with "120 301203".
 
 ### License<a id="orgheadline5"></a>
 
@@ -107,6 +116,8 @@ You can create all config files you want. You will only need to pass it as param
 
 Con este programa es posible utilizar una sala `XMPP` para hablar con un grupo de `Telegram` y viceversa. El objetivo de este programa es el de ser sólo una pasarela sencilla, sólo tiene que pasar el texto de un lado al otro. Una vez que sea estable, probablemente no tendrá más mejoras, ya que yo no las necesito.
 
+Desde la versión 0.1.6, Jabbergram tiene soporte HTTP Upload. Si el servidor lo soporta, subirá automáticamente todos los archivos enviados desde el grupo de Telegram.
+
 ### Instalación<a id="orgheadline8"></a>
 
 Como con cualquier programa escrito en `Python`, deberia ser usado en un entorno virtual (virtualenv), pero eso queda a la elección del usuario. Es posible utilizar uno de los siguientes métodos de instalación:
@@ -117,14 +128,14 @@ Instalar a través de `pip`:
 
 Clonar el repositorio:
 
-    $ git clone git://daemons.cf/jabbergram
+    $ git clone https://git.daemons.it/drymer/jabbergram
     $ cd jabbergram
-    $ su -c "pip3 instalar requirements.txt -r"
+    $ su -c "pip3 install -r requirements.txt"
-    $ su -c "python3 setup.py instalar"
+    $ su -c "python3 setup.py install"
 
 ### Configuración<a id="orgheadline9"></a>
 
-Este programa es simple, no tiene ni un menú de `ayuda`. Lo primero que hay que hacer es crear el bot de `Telegrama`. Para ello, hay que tener una cuenta de `Telegram` y hablar con [BotFather](https://telegram.me/botfather). A continuación, ejecuta:
+Este programa es simple, no tiene ni un menú de `ayuda`. Lo primero que hay que hacer es crear el bot de `Telegram`. Para ello, hay que tener una cuenta de `Telegram` y hablar con [BotFather](https://telegram.me/botfather). A continuación, ejecuta:
 
     /start
     /newbot
@@ -134,7 +145,7 @@ Este programa es simple, no tiene ni un menú de `ayuda`. Lo primero que hay que
     NombreDelBot
     # Ahora hay que pulsar desactivar
 
-La opción `/setprivacy` es para hacer que el robot pueda leer todo lo que se dice en el grupo, no sólo cuando se utilizan los comandos. Es necesario para hacer que `jabbergram` funcione. Más información sobre la creación los bots de `Telegrama` en su [página web](https://core.telegram.org/bots).
+La opción `/setprivacy` es para hacer que el robot pueda leer todo lo que se dice en el grupo, no sólo cuando se utilizan los comandos. Es necesario para hacer que `jabbergram` funcione. Más información sobre la creación los bots de `Telegram` en su [página web](https://core.telegram.org/bots).
 
 A continuación, hay que crear un archivo de configuración, que llamaremos `config.ini`. En ese archivo, introduce los siguientes parámetros:
 
@@ -152,10 +163,17 @@ No hay manera fácil de ver el ID desde `Telegram`, por lo que se puede utilizar
 
 ### Uso<a id="orgheadline10"></a>
 
-Se pueden crear todos los archivos de configuración que se deseen. Sólo tendrás que pasarlo como parámetro al programa,  si no se hace se intentará coger el archivo `config.ini` por defecto, y se producirá un error si no existe:
+Sólo puede haber un archivo de configuración. Esto es debido a que sólo puede haber una conexión del bot, cuando hay más de una se pierden mensajes. Por lo tanto, para linkear más salas hay que "linkearlas" en la configuración. Esto se hace, simplemente, enganchando las salas de jabber con las de telegram:
 
-    # Es recomendable utilizar tmux o la pantalla para ejecutar la siguiente orden
+    [Config]
-    $ jabbergram.py example.ini
+    JID = exampleJid@nope.org
+    password = difficultPassword
+    muc_room = exampleMuc@muc.nope.org segunda@muc.sip.org
+    nick = jabbergram
+    token = jabbergramBotTokken
+    group = -10293943920 120301203
+
+De este modo, el muc "exampleMuc@muc.nope.org" se sincronizará con el grupo "-10293943920", y "segunda@muc.sip.org" con "120301203". Hecho esto, solo queda ejecutarlo en la terminal: `python3 jabbergram.py config.ini`. Hay que tenerla activa siempre que se quiera que funcione, obviamente.
 
 ### Licencia<a id="orgheadline11"></a>
 

README.org

@@ -2,6 +2,8 @@
 ** English
 *** About
     With this program, it's possible to use a MuC =XMPP= room to talk to a group on =Telegram= and vice versa. The aim of this program is to be just a simple gateway, just pass text from one way to the other. Once it's stable, it probably won't have more improvements, since I don't need them.
+
+    Since version 0.1.6, Jabbergram has HTTP Upload support. If the server supports it, it will automatically upload all the files sent to the Telegram group.
 *** Installation
     As with any program that uses python, it should be used a virtual environment (virtualenv), but that is user selectable. It's possible to use one of the next installation methods:
 
@@ -12,7 +14,7 @@
 
      Clone the repository:
      #+BEGIN_SRC sh
-       $ git clone git://daemons.cf/jabbergram
+       $ git clone https://git.daemons.it/drymer/jabbergram
        $ cd jabbergram
        $ su -c "pip3 install -r requirements.txt"
        $ su -c "python3 setup.py install"
@@ -48,12 +50,19 @@
 
     There's no easy way to see this from telegram, so you can use the separate utility called =seeIdGroups.py=. To execute it, you only need to set the =token= parameter in the config file. You will need that somebody invite the bot to the group. Also, people on that group must send some messages, so the utility can grab it's id. It may take a couple. When you have the group ID you want, just press Ctrl-c, copy it to the config file (even the minus symbol), and the configuration will be done.
 *** Usage
-    You can create all config files you want. You will only need to pass it as parameter, but if you don't it will try to grab =config.ini= by default, and it will fail if it doesn't exist:
+    There only can be one configuration file. This is because it can only be one bot connection, when there's more than one, message are lost. Therefore, for linking more rooms you must "link" them in the configuration. This is done simply by hooking jabber rooms with Telegram:
 
     #+BEGIN_SRC sh
-      # it's advisable to use tmux or screen to execute the next order
+      [Config]
-      $ jabbergram.py example.ini
+      JID = exampleJid@nope.org
+      password = difficultPassword
+      muc_room = exampleMuc@muc.nope.org segunda@muc.sip.org
+      nick = jabbergram
+      token = jabbergramBotTokken
+      group = -10293943920 120301203
     #+END_SRC
+
+    Thus, the example's muc "exampleMuc@muc.nope.org" syncs with the group "-10293943920" and "segunda@muc.sip.org" with "120 301203".
 *** License
     #+BEGIN_SRC text
       This program is free software: you can redistribute it and / or modify
@@ -72,6 +81,8 @@
 ** Castellano
 *** Acerca de
     Con este programa es posible utilizar una sala =XMPP= para hablar con un grupo de =Telegram= y viceversa. El objetivo de este programa es el de ser sólo una pasarela sencilla, sólo tiene que pasar el texto de un lado al otro. Una vez que sea estable, probablemente no tendrá más mejoras, ya que yo no las necesito.
+
+    Desde la versión 0.1.6, Jabbergram tiene soporte HTTP Upload. Si el servidor lo soporta, subirá automáticamente todos los archivos enviados desde el grupo de Telegram.
 *** Instalación
     Como con cualquier programa escrito en =Python=, deberia ser usado en un entorno virtual (virtualenv), pero eso queda a la elección del usuario. Es posible utilizar uno de los siguientes métodos de instalación:
 
@@ -82,13 +93,13 @@
 
      Clonar el repositorio:
      #+BEGIN_SRC sh
-       $ git clone git://daemons.cf/jabbergram
+       $ git clone https://git.daemons.it/drymer/jabbergram
        $ cd jabbergram
-       $ su -c "pip3 instalar requirements.txt -r"
+       $ su -c "pip3 install -r requirements.txt"
-       $ su -c "python3 setup.py instalar"
+       $ su -c "python3 setup.py install"
      #+END_SRC
 *** Configuración
-    Este programa es simple, no tiene ni un menú de =ayuda=. Lo primero que hay que hacer es crear el bot de =Telegrama=. Para ello, hay que tener una cuenta de =Telegram= y hablar con [[https://telegram.me/botfather][BotFather]]. A continuación, ejecuta:
+    Este programa es simple, no tiene ni un menú de =ayuda=. Lo primero que hay que hacer es crear el bot de =Telegram=. Para ello, hay que tener una cuenta de =Telegram= y hablar con [[https://telegram.me/botfather][BotFather]]. A continuación, ejecuta:
 
     #+BEGIN_SRC sh
       /start
@@ -100,7 +111,7 @@
       # Ahora hay que pulsar desactivar
     #+END_SRC
 
-    La opción =/setprivacy= es para hacer que el robot pueda leer todo lo que se dice en el grupo, no sólo cuando se utilizan los comandos. Es necesario para hacer que =jabbergram= funcione. Más información sobre la creación los bots de =Telegrama= en su [[https://core.telegram.org/bots][página web]].
+    La opción =/setprivacy= es para hacer que el robot pueda leer todo lo que se dice en el grupo, no sólo cuando se utilizan los comandos. Es necesario para hacer que =jabbergram= funcione. Más información sobre la creación los bots de =Telegram= en su [[https://core.telegram.org/bots][página web]].
 
     A continuación, hay que crear un archivo de configuración, que llamaremos =config.ini=. En ese archivo, introduce los siguientes parámetros:
 
@@ -118,12 +129,19 @@
 
     No hay manera fácil de ver el ID desde =Telegram=, por lo que se puede utilizar el programa llamado =seeIdGroups.py=. Para ejecutarlo sólo es necesario establecer el parámetro =token= del archivo de configuración. Necesitarás que alguien invite al bot al grupo. Además, las personas de ese grupo deben enviar algunos mensajes, para que el programa pueda coger su ID. Puede llevar unos segundos el que aparezcan los mensajes. Cuando se tenga el ID de grupo que se quiere, sólo hay que pulsar Ctrl-c, copiarlo en el archivo de configuración (incluido el simbolo menos), y la configuración estará terminada.
 *** Uso
-    Se pueden crear todos los archivos de configuración que se deseen. Sólo tendrás que pasarlo como parámetro al programa,  si no se hace se intentará coger el archivo =config.ini= por defecto, y se producirá un error si no existe:
+    Sólo puede haber un archivo de configuración. Esto es debido a que sólo puede haber una conexión del bot, cuando hay más de una se pierden mensajes. Por lo tanto, para linkear más salas hay que "linkearlas" en la configuración. Esto se hace, simplemente, enganchando las salas de jabber con las de telegram:
 
-    #+BEGIN_SRC sh
+#+BEGIN_SRC text
-      # Es recomendable utilizar tmux o la pantalla para ejecutar la siguiente orden
+      [Config]
-      $ jabbergram.py example.ini
+      JID = exampleJid@nope.org
+      password = difficultPassword
+      muc_room = exampleMuc@muc.nope.org segunda@muc.sip.org
+      nick = jabbergram
+      token = jabbergramBotTokken
+      group = -10293943920 120301203
 #+END_SRC
+
+De este modo, el muc "exampleMuc@muc.nope.org" se sincronizará con el grupo "-10293943920", y "segunda@muc.sip.org" con "120301203". Hecho esto, solo queda ejecutarlo en la terminal: =python3 jabbergram.py config.ini=. Hay que tenerla activa siempre que se quiera que funcione, obviamente.
 *** Licencia
     #+BEGIN_SRC text
       This program is free software: you can redistribute it and / or modify

README.rst

@@ -1,66 +1,48 @@
--  `jabbergram <#jabbergram>`__
--  `English <#english>`__
 
-   -  `About <#about>`__
+.. contents::
-   -  `Installation <#installation>`__
-   -  `Configuration <#configuration>`__
-   -  `Usage <#usage>`__
-   -  `License <#license>`__
 
--  `Castellano <#castellano>`__
+1 jabbergram
+------------
 
-   -  `Acerca de <#acerca-de>`__
+1.1 English
-   -  `Instalación <#instalación>`__
+~~~~~~~~~~~
-   -  `Configuración <#configuración>`__
-   -  `Uso <#uso>`__
-   -  `Licencia <#licencia>`__
 
-jabbergram
+1.1.1 About
-==========
+^^^^^^^^^^^
 
-English
+With this program, it's possible to use a MuC ``XMPP`` room to talk to a group on ``Telegram`` and vice versa. The aim of this program is to be just a simple gateway, just pass text from one way to the other. Once it's stable, it probably won't have more improvements, since I don't need them.
--------
 
-About
+Since version 0.1.6, Jabbergram has HTTP Upload support. If the server supports it, it will automatically upload all the files sent to the Telegram group.
-~~~~~
 
-With this program, it's possible to use a MuC ``XMPP`` room to talk to a
+1.1.2 Installation
-group on ``Telegram`` and vice versa. The aim of this program is to be
+^^^^^^^^^^^^^^^^^^
-just a simple gateway, just pass text from one way to the other. Once
-it's stable, it probably won't have more improvements, since I don't
-need them.
 
-Installation
+As with any program that uses python, it should be used a virtual environment (virtualenv), but that is user selectable. It's possible to use one of the next installation methods:
-~~~~~~~~~~~~
-
-As with any program that uses python, it should be used a virtual
-environment (virtualenv), but that is user selectable. It's possible to
-use one of the next installation methods:
 
 Install via pip:
 
-::
+.. code-block:: sh
+    :number-lines: 0
 
     $ su -c "pip3 install jabbergram"
 
 Clone the repository:
 
-::
+.. code-block:: sh
+    :number-lines: 0
 
-    $ git clone git://daemons.cf/jabbergram
+    $ git clone https://git.daemons.it/drymer/jabbergram
     $ cd jabbergram
     $ su -c "pip3 install -r requirements.txt"
     $ su -c "python3 setup.py install"
 
-Configuration
+1.1.3 Configuration
-~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^
 
-This program is simple, it even doesn't have a ``help`` menu. First
+This program is simple, it even doesn't have a ``help`` menu. First thing you need to do is to create ``Telegram`` Bot. To do so, you must have a telegram account and talk to `BotFather <https://telegram.me/botfather>`_. Then, execute:
-thing you need to do is to create ``Telegram`` Bot. To do so, you must
-have a telegram account and talk to
-`BotFather <https://telegram.me/botfather>`__. Then, execute:
 
-::
+.. code-block:: sh
+    :number-lines: 0
 
     /start
     /newbot
@@ -70,15 +52,12 @@ have a telegram account and talk to
     YourNameBot
     # now press Disable
 
-The ``/setprivacy`` option is to make the bot read all what it's said to
+The ``/setprivacy`` option is to make the bot read all what it's said to him, not only when using commands. It's necessary to make ``jabbergram`` work. More info on creating ``Telegram`` bots at their `webpage <https://core.telegram.org/bots>`_.
-him, not only when using commands. It's necessary to make ``jabbergram``
-work. More info on creating ``Telegram`` bots at their
-`webpage <https://core.telegram.org/bots>`__.
 
-Then, you will have to create a config file. We'll call it
+Then, you will have to create a config file. We'll call it ``config.ini``. In that file, enter the next parameters:
-``config.ini``. In that file, enter the next parameters:
 
-::
+.. code-block:: text
+    :number-lines: 0
 
     [config]
     jid = exampleJid@nope.org
@@ -88,35 +67,33 @@ Then, you will have to create a config file. We'll call it
     token = jabbergramBotTokken
     group = -10293943920
 
-The only thing worth mentioning is the ``token`` section, which is said
+The only thing worth mentioning is the ``token`` section, which is said to you when creating the bot, and the ``group``, that is the ``Telegram`` group ID.
-to you when creating the bot, and the ``group``, that is the
-``Telegram`` group ID.
 
-There's no easy way to see this from telegram, so you can use the
+There's no easy way to see this from telegram, so you can use the separate utility called ``seeIdGroups.py``. To execute it, you only need to set the ``token`` parameter in the config file. You will need that somebody invite the bot to the group. Also, people on that group must send some messages, so the utility can grab it's id. It may take a couple. When you have the group ID you want, just press Ctrl-c, copy it to the config file (even the minus symbol), and the configuration will be done.
-separate utility called ``seeIdGroups.py``. To execute it, you only need
-to set the ``token`` parameter in the config file. You will need that
-somebody invite the bot to the group. Also, people on that group must
-send some messages, so the utility can grab it's id. It may take a
-couple. When you have the group ID you want, just press Ctrl-c, copy it
-to the config file (even the minus symbol), and the configuration will
-be done.
 
-Usage
+1.1.4 Usage
-~~~~~
+^^^^^^^^^^^
 
-You can create all config files you want. You will only need to pass it
+There only can be one configuration file. This is because it can only be one bot connection, when there's more than one, message are lost. Therefore, for linking more rooms you must "link" them in the configuration. This is done simply by hooking jabber rooms with Telegram:
-as parameter, but if you don't it will try to grab ``config.ini`` by
-default, and it will fail if it doesn't exist:
 
-::
+.. code-block:: sh
+    :number-lines: 0
 
-    # it's advisable to use tmux or screen to execute the next order
+    [Config]
-    $ jabbergram.py example.ini
+    JID = exampleJid@nope.org
+    password = difficultPassword
+    muc_room = exampleMuc@muc.nope.org segunda@muc.sip.org
+    nick = jabbergram
+    token = jabbergramBotTokken
+    group = -10293943920 120301203
 
-License
+Thus, the example's muc "exampleMuc@muc.nope.org" syncs with the group "-10293943920" and "segunda@muc.sip.org" with "120 301203".
-~~~~~~~
 
-::
+1.1.5 License
+^^^^^^^^^^^^^
+
+.. code-block:: text
+    :number-lines: 0
 
     This program is free software: you can redistribute it and / or modify
     it under the terms of the GNU General Public License as published by
@@ -131,50 +108,45 @@ License
     You should have received a copy of the GNU General Public License
     Along With This Program. If not, see <http://www.gnu.org/licenses/>.
 
-Castellano
+1.2 Castellano
-----------
+~~~~~~~~~~~~~~
 
-Acerca de
+1.2.1 Acerca de
-~~~~~~~~~
+^^^^^^^^^^^^^^^
 
-Con este programa es posible utilizar una sala ``XMPP`` para hablar con
+Con este programa es posible utilizar una sala ``XMPP`` para hablar con un grupo de ``Telegram`` y viceversa. El objetivo de este programa es el de ser sólo una pasarela sencilla, sólo tiene que pasar el texto de un lado al otro. Una vez que sea estable, probablemente no tendrá más mejoras, ya que yo no las necesito.
-un grupo de ``Telegram`` y viceversa. El objetivo de este programa es el
-de ser sólo una pasarela sencilla, sólo tiene que pasar el texto de un
-lado al otro. Una vez que sea estable, probablemente no tendrá más
-mejoras, ya que yo no las necesito.
 
-Instalación
+Desde la versión 0.1.6, Jabbergram tiene soporte HTTP Upload. Si el servidor lo soporta, subirá automáticamente todos los archivos enviados desde el grupo de Telegram.
-~~~~~~~~~~~
 
-Como con cualquier programa escrito en ``Python``, deberia ser usado en
+1.2.2 Instalación
-un entorno virtual (virtualenv), pero eso queda a la elección del
+^^^^^^^^^^^^^^^^^
-usuario. Es posible utilizar uno de los siguientes métodos de
+
-instalación:
+Como con cualquier programa escrito en ``Python``, deberia ser usado en un entorno virtual (virtualenv), pero eso queda a la elección del usuario. Es posible utilizar uno de los siguientes métodos de instalación:
 
 Instalar a través de ``pip``:
 
-::
+.. code-block:: sh
+    :number-lines: 0
 
     $ su -c "pip3 instalar jabbergram"
 
 Clonar el repositorio:
 
-::
+.. code-block:: sh
+    :number-lines: 0
 
-    $ git clone git://daemons.cf/jabbergram
+    $ git clone https://git.daemons.it/drymer/jabbergram
     $ cd jabbergram
-    $ su -c "pip3 instalar requirements.txt -r"
+    $ su -c "pip3 instalar -r requirements.txt"
-    $ su -c "python3 setup.py instalar"
+    $ su -c "python3 setup.py install"
 
-Configuración
+1.2.3 Configuración
-~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^
 
-Este programa es simple, no tiene ni un menú de ``ayuda``. Lo primero
+Este programa es simple, no tiene ni un menú de ``ayuda``. Lo primero que hay que hacer es crear el bot de ``Telegram``. Para ello, hay que tener una cuenta de ``Telegram`` y hablar con `BotFather <https://telegram.me/botfather>`_. A continuación, ejecuta:
-que hay que hacer es crear el bot de ``Telegrama``. Para ello, hay que
-tener una cuenta de ``Telegram`` y hablar con
-`BotFather <https://telegram.me/botfather>`__. A continuación, ejecuta:
 
-::
+.. code-block:: sh
+    :number-lines: 0
 
     /start
     /newbot
@@ -184,17 +156,12 @@ tener una cuenta de ``Telegram`` y hablar con
     NombreDelBot
     # Ahora hay que pulsar desactivar
 
-La opción ``/setprivacy`` es para hacer que el robot pueda leer todo lo
+La opción ``/setprivacy`` es para hacer que el robot pueda leer todo lo que se dice en el grupo, no sólo cuando se utilizan los comandos. Es necesario para hacer que ``jabbergram`` funcione. Más información sobre la creación los bots de ``Telegrama`` en su `página web <https://core.telegram.org/bots>`_.
-que se dice en el grupo, no sólo cuando se utilizan los comandos. Es
-necesario para hacer que ``jabbergram`` funcione. Más información sobre
-la creación los bots de ``Telegrama`` en su `página
-web <https://core.telegram.org/bots>`__.
 
-A continuación, hay que crear un archivo de configuración, que
+A continuación, hay que crear un archivo de configuración, que llamaremos ``config.ini``. En ese archivo, introduce los siguientes parámetros:
-llamaremos ``config.ini``. En ese archivo, introduce los siguientes
-parámetros:
 
-::
+.. code-block:: text
+    :number-lines: 0
 
     [Config]
     JID = exampleJid@nope.org
@@ -204,37 +171,33 @@ parámetros:
     token = jabbergramBotTokken
     group = -10,293,943,920
 
-La única cosa que vale la pena mencionar es la sección del ``token``
+La única cosa que vale la pena mencionar es la sección del ``token`` (que es la que nos da cuando se crea el robot) y el ``group``, que es ID del grupo de ``Telegram``.
-(que es la que nos da cuando se crea el robot) y el ``group``, que es ID
-del grupo de ``Telegram``.
 
-No hay manera fácil de ver el ID desde ``Telegram``, por lo que se puede
+No hay manera fácil de ver el ID desde ``Telegram``, por lo que se puede utilizar el programa llamado ``seeIdGroups.py``. Para ejecutarlo sólo es necesario establecer el parámetro ``token`` del archivo de configuración. Necesitarás que alguien invite al bot al grupo. Además, las personas de ese grupo deben enviar algunos mensajes, para que el programa pueda coger su ID. Puede llevar unos segundos el que aparezcan los mensajes. Cuando se tenga el ID de grupo que se quiere, sólo hay que pulsar Ctrl-c, copiarlo en el archivo de configuración (incluido el simbolo menos), y la configuración estará terminada.
-utilizar el programa llamado ``seeIdGroups.py``. Para ejecutarlo sólo es
-necesario establecer el parámetro ``token`` del archivo de
-configuración. Necesitarás que alguien invite al bot al grupo. Además,
-las personas de ese grupo deben enviar algunos mensajes, para que el
-programa pueda coger su ID. Puede llevar unos segundos el que aparezcan
-los mensajes. Cuando se tenga el ID de grupo que se quiere, sólo hay que
-pulsar Ctrl-c, copiarlo en el archivo de configuración (incluido el
-simbolo menos), y la configuración estará terminada.
 
-Uso
+1.2.4 Uso
-~~~
+^^^^^^^^^
 
-Se pueden crear todos los archivos de configuración que se deseen. Sólo
+Sólo puede haber un archivo de configuración. Esto es debido a que sólo puede haber una conexión del bot, cuando hay más de una se pierden mensajes. Por lo tanto, para linkear más salas hay que "linkearlas" en la configuración. Esto se hace, simplemente, enganchando las salas de jabber con las de telegram:
-tendrás que pasarlo como parámetro al programa, si no se hace se
-intentará coger el archivo ``config.ini`` por defecto, y se producirá un
-error si no existe:
 
-::
+.. code-block:: text
+    :number-lines: 0
 
-    # Es recomendable utilizar tmux o la pantalla para ejecutar la siguiente orden
+    [Config]
-    $ jabbergram.py example.ini
+    JID = exampleJid@nope.org
+    password = difficultPassword
+    muc_room = exampleMuc@muc.nope.org segunda@muc.sip.org
+    nick = jabbergram
+    token = jabbergramBotTokken
+    group = -10293943920 120301203
 
-Licencia
+De este modo, el muc "exampleMuc@muc.nope.org" se sincronizará con el grupo "-10293943920", y "segunda@muc.sip.org" con "120301203".
-~~~~~~~~
 
-::
+1.2.5 Licencia
+^^^^^^^^^^^^^^
+
+.. code-block:: text
+    :number-lines: 0
 
     This program is free software: you can redistribute it and / or modify
     it under the terms of the GNU General Public License as published by

jabbergram.py

@@ -1,32 +1,72 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 
+import configparser
+import logging
+from sys import argv
+from threading import Thread
+from time import sleep
+from xml.dom import minidom
+
 import sleekxmpp
 import telegram
-import configparser
+from sleekxmpp.xmlstream.stanzabase import ElementBase
-from threading import Thread
-from queue import Queue
 from telegram.error import NetworkError, Unauthorized
-from time import sleep
-from sys import argv
-from sys import exit
 
 
-class EchoBot(sleekxmpp.ClientXMPP):
+try:
-    def __init__(self, jid, password, room, nick, token, group):
+    import requests
+except:
+    logging.error("HTTP Upload support disabled.")
+
+
+class Request(ElementBase):
+    """Special class to create http_upload requests."""
+    namespace = 'urn:xmpp:http:upload'
+    name = 'request'
+    plugin_attrib = 'request'
+    interfaces = set(('filename', 'size'))
+    sub_interfaces = interfaces
+
+
+class Jabbergram(sleekxmpp.ClientXMPP):
+    """Main object."""
+    def __init__(self, jid, password, rooms, nick, token, groups, verify_ssl):
+        """
+        Executed when the class is initialized. It adds session handlers, muc
+        handlers and send the telegram reading function and the HTTP upload
+        initializing functions to their respective threads.
+        """
         # XMPP
-        super(EchoBot, self).__init__(jid, password)
+        super(Jabbergram, self).__init__(jid, password)
         self.add_event_handler('session_start', self.start)
         self.add_event_handler('groupchat_message', self.muc_message)
-        self.muc_room = room
+
+        self.muc_rooms = rooms.split()
         self.nick = nick
         self.token = token
+        self.xmpp_users = {}
+        self.jid = jid
+        self.verify_ssl = verify_ssl
+
+        for muc in self.muc_rooms:
+            self.add_event_handler("muc::%s::got_online" % muc,
+                                   self.muc_online)
+            self.add_event_handler("muc::%s::got_offline" % muc,
+                                   self.muc_offline)
 
         # Telegram
-        self.group = group
+        self.groups = groups.split()
         self.bot = telegram.Bot(self.token)
+        self.telegram_users = {}
 
-        # meter el conecto del tg en un hilo
+        # initialize http upload on a thread since its needed to be connected
+        # to xmpp
+        t = Thread(target=self.init_http)
+        t.daemon = True
+        t.start()
+
+        # put tg connector in a thread
         t = Thread(target=self.read_tg)
         t.daemon = True
         t.start()
@@ -34,46 +74,338 @@ class EchoBot(sleekxmpp.ClientXMPP):
         print('Please wait a couple of minutes until it\'s correctly '
               'connected')
 
+    def init_http(self):
+        """
+        Initializes HTTP upload support. Sends a discovery stanza to the server
+        to find the HTTP upload component and asks for the max size a file can
+        be.
+        """
+        self.http_upload = self.HttpUpload(self)
+        self.component = self.http_upload.discovery()
+
+        if self.component:
+            xml = self.http_upload.disco_info(self.component)
+            xml = minidom.parseString(str(xml))
+            self.max_size = int(xml.getElementsByTagName('value')
+                                [1].firstChild.data)
+        else:
+            try:
+                self.component = self.jid.split('@')[1]
+                xml = self.http_upload.disco_info(self.component)
+                xml = minidom.parseString(str(xml))
+                self.max_size = int(xml.getElementsByTagName('value')
+                                    [1].firstChild.data)
+            except:
+                self.max_size = None
+
     def read_tg(self):
+        """Main telegram function."""
         update_id = 0
 
+        # wait until http_upload has been tested
+        sleep(5)
         while True:
             try:
                 for update in self.bot.getUpdates(offset=update_id,
                                                   timeout=10):
-                    message = update.message.text
+                    name = ''
-                    user = str(update.message.from_user.username)
+                    size = 0
 
+                    if update.edited_message:
+                        update_id = update.update_id + 1
+                        continue
+
+                    if update.message.from_user:
+                        user = update.message.from_user.username
+
+                        # sometimes there's no user. weird, but it happens
                         if not user:
-                        user = str(update.message.from_user.first_name)
+                            user = update.message.from_user.first_name
 
-                    mensaje = user + ": " + message
+                    # sometimes there's no user. weird, but it happens
-                    chat_id = update.message.chat_id
+                    elif update.message['from']:
+                        user = str(update.message['from'].first_name)
 
-                    if message and chat_id == self.group:
+                    if update.message.audio or update.message.document or \
-                        self.send_message(mto=self.muc_room,
+                       update.message.photo or update.message.video \
-                                              mbody=mensaje,
+                       or update.message.voice or update.message.sticker:
+                        # proceed only if http upload is available
+
+                        if self.max_size is not None:
+                            if update.message.audio:
+                                d_file = update.message.audio
+                                ext = '.ogg'
+                                size = d_file.file_size
+                            elif update.message.document:
+                                d_file = update.message.document
+                                ext = ''
+                                size = d_file.file_size
+                            elif update.message.photo:
+                                d_file = update.message.photo[-1]
+                                ext = '.jpg'
+                                size = d_file.file_size
+                            elif update.message.video:
+                                d_file = update.message.video[-1]
+                                ext = '.mp4'
+                                size = d_file.file_size
+                            elif update.message.voice:
+                                d_file = update.message.voice
+                                ext = '.ogg'
+                                size = d_file.file_size
+                            elif update.message.sticker:
+                                d_file = update.message.sticker
+                                ext = '.png'
+                                size = d_file.file_size
+                            if self.max_size >= int(size):
+                                t_file = self.bot.getFile(d_file.file_id)
+                                f_name = '/tmp/' + d_file.file_id + ext
+                                t_file.download(f_name)
+                                url = self.http_upload.upload(
+                                    self.component,
+                                    self.verify_ssl,
+                                    f_name, size)
+
+                                if update.message.caption:
+                                    message = update.message.caption + ' '
+                                else:
+                                    message = 'File uploaded: '
+
+                                message += url
+                            else:
+                                message = 'A file has been uploaded to Telegr'\
+                                          'am, but is too big.'
+                        else:
+                            message = 'A file has been uploaded to Telegram,'\
+                                      'but the XMPP server doesn\'t support H'\
+                                      'TTP Upload.'
+
+                    elif update.message.new_chat_members:
+                        message = 'This user has joined the group.'
+                    elif update.message.left_chat_member:
+                        message = 'This user has left the group.'
+                    elif update.message.new_chat_title:
+                        message = 'The group\'s title has changed: ' + \
+                          update.message.new_chat_title
+                    elif update.message.new_chat_photo:
+                        message = 'The group\'s photo has changed.'
+                    else:
+                        if update.message.reply_to_message:
+                            name = update.message.reply_to_message.from_user\
+                                                                  .username
+                            if name != self.bot.username:
+                                message = name + ': ' + \
+                                          update.message.reply_to_message.text
+                            else:
+                                message = update.message.reply_to_message.text
+                        else:
+                            message = update.message.text
+
+                    if name:
+                        msg = message + ' <- ' + user + ": " + \
+                              update.message.text
+                    else:
+                        msg = user + ": " + message
+
+                    if update.message.chat.type == 'supergroup' and \
+                       update.message.chat.username:
+                        chat = '@' + update.message.chat.username
+                    else:
+                        chat = str(update.message.chat.id)
+
+                    if chat not in self.groups:
+                        chat = str(update.message.chat_id)
+
+                    if message and chat in self.groups:
+                        index = self.groups.index(chat)
+                        receiver = self.muc_rooms[index]
+
+                        if chat in self.telegram_users:
+                            if user not in self.telegram_users[chat]:
+                                self.telegram_users[chat] += ' ' + user
+                        else:
+                            self.telegram_users[chat] = ' ' + user
+
+                        if message == '.users':
+                            self.say_users('telegram', receiver, chat)
+                        elif message == '.help':
+                            self.say_help('telegram', receiver, chat)
+                        elif message == '.where':
+                            self.say_where('telegram', receiver, chat)
+                        else:
+                            self.send_message(mto=receiver, mbody=msg,
                                               mtype='groupchat')
                     update_id = update.update_id + 1
 
-            except NetworkError:
+            except NetworkError as e:
+                print(e)
                 sleep(1)
-            except Unauthorized:
+
+            except Unauthorized as e:
+                print(e)
                 sleep(1)
 
+            except Exception as e:
+                update_id += 1
+                print(e)
+
     def start(self, event):
+        """Does some initial setup for XMPP and joins all mucs."""
         self.get_roster()
         self.send_presence()
-        self.plugin['xep_0045'].joinMUC(self.muc_room, self.nick, wait=True)
+
+        for muc in self.muc_rooms:
+            self.plugin['xep_0045'].joinMUC(muc, self.nick, wait=True)
 
     def muc_message(self, msg):
-        if msg['mucnick'] != self.nick:
+        """Muc message's handler."""
-            mensaje = str(msg['from']).split('/')[1] + ': ' + str(msg['body'])
+        muc_room = str(msg['from']).split('/')[0]
-            self.bot.sendMessage(self.group, text=mensaje)
+        index = self.muc_rooms.index(muc_room)
+        tg_group = self.groups[index]
+
+        if msg['body'] == '.users':
+            self.say_users('xmpp', muc_room, tg_group)
+        elif msg['body'] == '.help':
+            self.say_help('xmpp', muc_room, tg_group)
+        elif msg['body'] == '.where':
+            self.say_where('xmpp', muc_room, tg_group)
+        elif msg['mucnick'] != self.nick:
+            message = str(msg['from']).split('/')[1] + ': ' + str(msg['body'])
+            self.bot.sendMessage(tg_group, text=message)
+
+    def muc_online(self, presence):
+        """Muc presence's handler."""
+        user = presence['muc']['nick']
+        muc = presence['from'].bare
+
+        if user != self.nick:
+            if muc in self.xmpp_users:
+                self.xmpp_users[muc].append(presence['muc']['nick'])
+            else:
+                self.xmpp_users[muc] = [presence['muc']['nick']]
+
+    def muc_offline(self, presence):
+        """Muc presence's handler."""
+        user = presence['muc']['nick']
+        muc = presence['from'].bare
+
+        if user != self.nick:
+            self.xmpp_users[muc].remove(presence['muc']['nick'])
+
+    def say_users(self, service, muc, group):
+        """It returns the users on XMPP or Telegram."""
+        if service == 'xmpp':
+            if group in self.telegram_users:
+                tg_users = self.telegram_users[group]
+            else:
+                tg_users = ""
+
+            msg = 'Telegram Users:' + tg_users
+
+            self.send_message(mto=muc, mbody=msg, mtype='groupchat')
+
+        elif service == 'telegram':
+            xmpp_users = ""
+            if muc in self.xmpp_users:
+                for i in self.xmpp_users[muc]:
+                    xmpp_users = xmpp_users + ' ' + i
+            else:
+                xmpp_users = ""
+
+            msg = 'XMPP Users:' + xmpp_users
+            self.bot.sendMessage(group, text=msg)
+
+    def say_help(self, service, muc, group):
+        """Help command."""
+        msg = 'Hi, I\'m ' + self.bot.username + '. I have two commands : ".us'\
+              'ers" and ".where".'
+        if service == 'xmpp':
+            self.send_message(mto=muc, mbody=msg, mtype='groupchat')
+        elif service == 'telegram':
+            self.bot.sendMessage(group, text=msg)
+
+    def say_where(self, service, muc, group):
+        """Returns Telegram's group location if it's public."""
+        if service == 'xmpp':
+            if '@' in group:
+                msg = 'I\'m on http://telegram.me/' + group.split('@')[1] + '.'
+            else:
+                msg = 'Sorry, I\'m on a private group, you\'ll have to ask fo'\
+                      'r an invitation.'
+            self.send_message(mto=muc, mbody=msg, mtype='groupchat')
+        elif service == 'telegram':
+            msg = 'I\'m on ' + muc + '.'
+            self.bot.sendMessage(group, text=msg)
+
+    class HttpUpload():
+        """HTTP upload main class."""
+        def __init__(self, parent_self):
+            """Init... Yep."""
+            self.parent_self = parent_self
+
+        def discovery(self):
+            """Discovers all server's components."""
+            disco = sleekxmpp.basexmpp.BaseXMPP.Iq(self.parent_self)
+            disco['query'] = "http://jabber.org/protocol/disco#items"
+            disco['type'] = 'get'
+            disco['from'] = self.parent_self.jid
+            disco['to'] = self.parent_self.jid.split('@')[1]
+
+            d = disco.send(timeout=30)
+            xml = minidom.parseString(str(d))
+            item = xml.getElementsByTagName('item')
+
+            for component in item:
+                component = component.getAttribute('jid')
+                info = self.disco_info(component)
+
+                if "urn:xmpp:http:upload" in info:
+                    http_upload_component = component
+                    break
+                else:
+                    http_upload_component = ""
+
+            return http_upload_component
+
+        def disco_info(self, component):
+            """Discovers HTTP upload components attributes."""
+            info = sleekxmpp.basexmpp.BaseXMPP.Iq(self.parent_self)
+            info['query'] = "http://jabber.org/protocol/disco#info"
+            info['type'] = 'get'
+            info['from'] = self.parent_self.jid
+            info['to'] = component
+            response = str(info.send(timeout=30))
+
+            return response
+
+        def upload(self, component, verify_ssl, u_file, size):
+            """Uploads to HTTP upload."""
+            peticion = Request()
+            peticion['filename'] = u_file.split('/')[-1]
+            peticion['size'] = str(size)
+
+            iq = sleekxmpp.basexmpp.BaseXMPP.Iq(self.parent_self)
+            iq.set_payload(peticion)
+            iq['type'] = 'get'
+            iq['to'] = component
+            iq['from'] = self.parent_self.jid
+
+            send = iq.send(timeout=30)
+
+            xml = minidom.parseString(str(send))
+            put_url = xml.getElementsByTagName('put')[0].firstChild.data
+
+            if verify_ssl == 'False':
+                req = requests.put(put_url, data=open(u_file, 'rb'),
+                                   verify=False)
+            else:
+                req = requests.put(put_url, data=open(u_file, 'rb'))
+
+            return put_url
+
 
 if __name__ == '__main__':
 
-    # parsear config
+    # parse config
     config = []
     parser = configparser.SafeConfigParser()
 
@@ -85,15 +417,17 @@ if __name__ == '__main__':
     for name, value in parser.items('config'):
         config.append(value)
 
-    # asignar valores para el bot
+    # assign values for the bot
     jid = config[0]
     password = config[1]
-    muc_room = config[2]
+    muc_rooms = config[2]
     nick = config[3]
     token = config[4]
-    group = int(config[5])
+    groups = config[5]
+    verify_ssl = config[6]
 
-    xmpp = EchoBot(jid, password, muc_room, nick, token, group)
+    xmpp = Jabbergram(jid, password, muc_rooms, nick, token, groups,
+                      verify_ssl)
     xmpp.register_plugin('xep_0045')
 
     if xmpp.connect():
@@ -101,5 +435,3 @@ if __name__ == '__main__':
         print("Done")
     else:
         print("Unable to connect.")
-
-    # Vols un gram nen?

requirements.txt

@@ -1,2 +1,3 @@
-sleekxmpp >= 1.3.1
+sleekxmpp >= 1.3.2
-python-telegram-bot >= 4.0.3
+python-telegram-bot >= 6.1.0
+requests >= 2.11.1

seeIdGroups.py

@@ -30,6 +30,9 @@ printed = []
 while True:
     try:
         for update in bot.getUpdates(offset=update_id, timeout=10):
+            if update.edited_message:
+                update_id = update.update_id + 1
+                continue
             chat_id = update.message.chat_id
             chat_title = update.message
             if chat_id not in printed:

setup.py

@@ -2,7 +2,7 @@
 
 from setuptools import setup
 
-VERSION = '0.1.4'
+VERSION = '0.1.8'
 
 setup(name='jabbergram',
       version=VERSION,
@@ -10,13 +10,14 @@ setup(name='jabbergram',
       long_description=open('README.rst', encoding='utf-8').read(),
       author='drymer',
       author_email='drymer@autistici.org',
-      url='http://daemons.cf/cgit/jabbergram/about/',
+      url='http://git.daemons.it/drymer/jabbergram/about/',
-      download_url='http://daemons.cf/cgit/jabbergram/snapshot/jabbergram-' + VERSION + '.tar.gz',
+      download_url='https://git.daemons.it/drymer/jabbergram/archive/' + VERSION + '.tar.gz',
       scripts=['jabbergram.py'],
       license="GPLv3",
       install_requires=[
           "sleekxmpp>=1.3.1",
-          "python-telegram-bot>=4.0.3",
+          "python-telegram-bot>=6.0.1",
+          "requests>=2.11.1",
           ],
       classifiers=["Development Status :: 4 - Beta",
                    "Programming Language :: Python",