Awesome

bilbot

Un bot del DCC para Telegram.
Un bot de Telegram para el DCC.
Para el DCC, de Telegram, un bot.
Porque todo eso... es bilbot.

(Ya, no tenía idea qué escribir acá.)

Receta

Ingredientes

:snake: Python será nuestra herramienta de trabajo.
:warning: Para evitar posibles fallas de compatibilidad, se deberá usar una versión de Python superior a 3.3.

Archivos

Los archivos del repositorio están resumidos en la siguiente tabla.

Nombre	Descripción
`bilbot`	(véase la tabla de abajo)
`.gitignore`	Archivos ignorados por Git.
`.pylintrc`	Config-file de `pylint`.
`LICENSE`	Documento con el Mozilla Public License.
`README.md`	`self`
`requirements.txt`	Archivo de dependencias para `pip`.
`tox.ini`	Config-file de `flake8`.

En `bilbot/`

Nombre	Descripción
`bilbot.cfg`	Config-file de `bilbot`.
`bilbot.py`	Módulo esencial de Bilbot.
`changelog.py`	Módulo con el changelog.
`commands.py`	Módulo con todos los comandos de `bilbot`.
`messages.py`	Módulo con los mensajes para los usuarios.
`settings.py`	Módulo con los ajustes de `bilbot`.

Librerías de Python

Las librerías utilizadas están resumidas en la siguiente tabla.

Nombre	Descripción	Versión
python-telegram-bot	Un wrapper del API de Telegram Bot.	5.3.0
flake8	Un linter para hacer respetar el PEP8.	2.6.2
pylint	Un linter que impone buenas prácticas.	1.6.4

Estas librerías también aparecen en requirements.txt. Luego, se deberá usar este archivo para instalarlas con pip.
Esto nos permitirá trabajar con las mismas versiones, consiguiendo instalaciones replicables, sin hacer esfuerzo.
Bueno, un poco: debemos escribir...

$ pip install -r requirements.txt

En efecto, esto es... as easy as py. :grinning:

Preparación

Para utilizar a Bilbot localmente, debes seguir los siguientes pasos.

:sheep: Clona el repositorio. Luego, accede.

$ git clone https://github.com/nkawasg/bilbot.git
$ cd bilbot

:wrench: Genera un entorno virtual de Python v3.X con virtualenv. En este caso, se llamará venv.
No olvides que X debe ser: {3, 4, 5, 6}.
```
$ virtualenv --python=python3.X venv
```
:arrow_forward: Activa el entorno virtual.
```
$ source venv/bin/activate
```
:white_check_mark: Instala las dependencias con pip.
```
$ pip install -r requirements.txt
```
:wrench: Configura el archivo bilbot/bilbot.cfg con el token de tu bot.
:snake: Ejecuta el script.
```
$ python3 bilbot/bilbot.py
```
:tada: Voilà!
Ahora, Bilbot debería estar encendido.