From b69960de083831cb98eb94f982e146c6b38f18d1 Mon Sep 17 00:00:00 2001 From: drymer Date: Thu, 13 Oct 2016 22:11:57 +0200 Subject: [PATCH] Add http support --- README.md | 8 +- README.org | 8 +- README.rst | 307 +++++++++++++++++++++++++++-------------------- jabbergram.py | 7 +- requirements.txt | 1 + setup.py | 3 +- 6 files changed, 196 insertions(+), 138 deletions(-) diff --git a/README.md b/README.md index 61f6b41..1bd87d8 100644 --- a/README.md +++ b/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 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: @@ -114,6 +116,8 @@ Thus, the example's muc "exampleMuc@muc.nope.org" syncs with the group "-1029394 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: @@ -126,8 +130,8 @@ Clonar el repositorio: $ git clone git://daemons.cf/jabbergram $ cd jabbergram - $ su -c "pip3 instalar requirements.txt -r" - $ su -c "python3 setup.py instalar" + $ su -c "pip3 instalar -r requirements.txt" + $ su -c "python3 setup.py install" ### Configuración diff --git a/README.org b/README.org index 4c1c94f..cd9eb94 100644 --- a/README.org +++ b/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: @@ -79,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: @@ -91,8 +95,8 @@ #+BEGIN_SRC sh $ git clone git://daemons.cf/jabbergram $ cd jabbergram - $ su -c "pip3 instalar requirements.txt -r" - $ su -c "python3 setup.py instalar" + $ su -c "pip3 instalar -r requirements.txt" + $ 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 =Telegram=. Para ello, hay que tener una cuenta de =Telegram= y hablar con [[https://telegram.me/botfather][BotFather]]. A continuación, ejecuta: diff --git a/README.rst b/README.rst index 4671315..d54ef65 100644 --- a/README.rst +++ b/README.rst @@ -1,168 +1,213 @@ -- `ended in bot, always <#ended-in-bot,-always>`__ -- `+BEGIN\_SRC text <#+begin_src-text>`__ -- `+END\_SRC <#+end_src>`__ -ended in bot, always -==================== +.. contents:: -:: +1 jabbergram +------------ - # then it will show your bot token, save it - /setprivacy - YourNameBot - # now press Disable - #+END_SRC +1.1 English +~~~~~~~~~~~ - 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 [[https://core.telegram.org/bots][webpage]]. +1.1.1 About +^^^^^^^^^^^ - Then, you will have to create a config file. We'll call it =config.ini=. In that file, enter the next parameters: +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. - #+BEGIN_SRC text - [config] - jid = exampleJid@nope.org - password = difficultPassword - muc_room = exampleMuc@muc.nope.org - nick = jabbergram - token = jabbergramBotTokken - group = -10293943920 - #+END_SRC +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. - 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. +1.1.2 Installation +^^^^^^^^^^^^^^^^^^ - 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. +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: -\*\*\* Usage 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: +Install via pip: -:: +.. code-block:: sh + :number-lines: 0 - #+BEGIN_SRC sh - [Config] - 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 + $ su -c "pip3 install jabbergram" - Thus, the example's muc "exampleMuc@muc.nope.org" syncs with the group "-10293943920" and "segunda@muc.sip.org" with "120 301203". +Clone the repository: -\*\*\* License #+BEGIN\_SRC text 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 the Free Software Foundation, Either -version 3 of the License, or (At your option) any later version. +.. code-block:: sh + :number-lines: 0 -:: + $ git clone git://daemons.cf/jabbergram + $ cd jabbergram + $ su -c "pip3 install -r requirements.txt" + $ su -c "python3 setup.py install" - This program is distributed in the hope That it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. +1.1.3 Configuration +^^^^^^^^^^^^^^^^^^^ - You should have received a copy of the GNU General Public License - Along With This Program. If not, see . - #+END_SRC +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 `_. Then, execute: -\*\* 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. \*\*\* -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: +.. code-block:: sh + :number-lines: 0 -:: + /start + /newbot + YourNameBot # ended in bot, always + # then it will show your bot token, save it + /setprivacy + YourNameBot + # now press Disable - Instalar a través de =pip=: - #+BEGIN_SRC sh - $ su -c "pip3 instalar jabbergram" - #+END_SRC +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 `_. - Clonar el repositorio: - #+BEGIN_SRC sh - $ git clone git://daemons.cf/jabbergram - $ cd jabbergram - $ su -c "pip3 instalar requirements.txt -r" - $ su -c "python3 setup.py instalar" - #+END_SRC +Then, you will have to create a config file. We'll call it ``config.ini``. In that file, enter the next parameters: -\*\*\* Configuración 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: +.. code-block:: text + :number-lines: 0 -:: + [config] + jid = exampleJid@nope.org + password = difficultPassword + muc_room = exampleMuc@muc.nope.org + nick = jabbergram + token = jabbergramBotTokken + group = -10293943920 - #+BEGIN_SRC sh - /start - /newbot - NombreDelBot # terminado en bot, siempre - # A continuación, se mostrará el token del bot, hay que guardarlo - /setprivacy - NombreDelBot - # Ahora hay que pulsar desactivar - #+END_SRC +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. - 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]]. +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. - A continuación, hay que crear un archivo de configuración, que llamaremos =config.ini=. En ese archivo, introduce los siguientes parámetros: +1.1.4 Usage +^^^^^^^^^^^ - #+BEGIN_SRC text - [Config] - JID = exampleJid@nope.org - password = difficultPassword - muc_room = exampleMuc@muc.nope.org - nick = jabbergram - token = jabbergramBotTokken - group = -10,293,943,920 - #+END_SRC +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: - 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=. +.. code-block:: sh + :number-lines: 0 - 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. + [Config] + JID = exampleJid@nope.org + password = difficultPassword + muc_room = exampleMuc@muc.nope.org segunda@muc.sip.org + nick = jabbergram + token = jabbergramBotTokken + group = -10293943920 120301203 -\*\*\* Uso 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: +Thus, the example's muc "exampleMuc@muc.nope.org" syncs with the group "-10293943920" and "segunda@muc.sip.org" with "120 301203". -+BEGIN\_SRC text -================ +1.1.5 License +^^^^^^^^^^^^^ -:: +.. code-block:: text + :number-lines: 0 - [Config] - JID = exampleJid@nope.org - password = difficultPassword - muc_room = exampleMuc@muc.nope.org segunda@muc.sip.org - nick = jabbergram - token = jabbergramBotTokken - group = -10293943920 120301203 + 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 + the Free Software Foundation, Either version 3 of the License, or + (At your option) any later version. -+END\_SRC -========= + This program is distributed in the hope That it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. -De este modo, el muc "exampleMuc@muc.nope.org" se sincronizará con el -grupo "-10293943920", y "segunda@muc.sip.org" con "120301203". \*\*\* -Licencia #+BEGIN\_SRC text 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 the Free Software Foundation, Either -version 3 of the License, or (At your option) any later version. + You should have received a copy of the GNU General Public License + Along With This Program. If not, see . -:: +1.2 Castellano +~~~~~~~~~~~~~~ - This program is distributed in the hope That it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. +1.2.1 Acerca de +^^^^^^^^^^^^^^^ - You should have received a copy of the GNU General Public License - Along With This Program. If not, see . - #+END_SRC +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. + +1.2.2 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 + $ cd jabbergram + $ su -c "pip3 instalar -r requirements.txt" + $ su -c "python3 setup.py install" + +1.2.3 Configuración +^^^^^^^^^^^^^^^^^^^ + +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 `_. A continuación, ejecuta: + +.. code-block:: sh + :number-lines: 0 + + /start + /newbot + NombreDelBot # terminado en bot, siempre + # A continuación, se mostrará el token del bot, hay que guardarlo + /setprivacy + 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 `_. + +A continuación, hay que crear un archivo de configuración, que llamaremos ``config.ini``. En ese archivo, introduce los siguientes parámetros: + +.. code-block:: text + :number-lines: 0 + + [Config] + JID = exampleJid@nope.org + password = difficultPassword + muc_room = exampleMuc@muc.nope.org + nick = jabbergram + token = jabbergramBotTokken + group = -10,293,943,920 + +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``. + +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. + +1.2.4 Uso +^^^^^^^^^ + +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: + +.. code-block:: text + :number-lines: 0 + + [Config] + 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". + +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 + the Free Software Foundation, Either version 3 of the License, or + (At your option) any later version. + + This program is distributed in the hope That it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + Along With This Program. If not, see . diff --git a/jabbergram.py b/jabbergram.py index 49c0c53..3d13fe2 100755 --- a/jabbergram.py +++ b/jabbergram.py @@ -1,10 +1,13 @@ #!/usr/bin/env python3 # -*- coding: utf-8 -*- +try: + import requests +except: + print("HTTP Upload support disabled.") import sleekxmpp import telegram import configparser -import requests from threading import Thread from queue import Queue from telegram.error import NetworkError, Unauthorized @@ -313,7 +316,7 @@ class Jabbergram(sleekxmpp.ClientXMPP): xml = minidom.parseString(str(send)) put_url = xml.getElementsByTagName('put')[0].firstChild.data - verify_ssl = 'False' + verify_ssl = '' if verify_ssl == 'False': req = requests.put(put_url, data=open(u_file, 'rb'), verify=False) diff --git a/requirements.txt b/requirements.txt index efd4a19..8a7ccd6 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,2 +1,3 @@ sleekxmpp >= 1.3.1 python-telegram-bot >= 4.0.3 +requests >= 2.11.1 diff --git a/setup.py b/setup.py index 4bffd60..c4ea6b1 100644 --- a/setup.py +++ b/setup.py @@ -2,7 +2,7 @@ from setuptools import setup -VERSION = '0.1.5' +VERSION = '0.1.6' setup(name='jabbergram', version=VERSION, @@ -17,6 +17,7 @@ setup(name='jabbergram', install_requires=[ "sleekxmpp>=1.3.1", "python-telegram-bot>=4.0.3", + "requests>=2.11.1", ], classifiers=["Development Status :: 4 - Beta", "Programming Language :: Python",