Package: nekbot
NekBot######Nekbot, a modular and multiprocol bot written in Python.Supported protocols===================- Telegram.- IRC.- Jabber/XMPP (coming soon).Prerequisitos instalación (Pip)===============================Pip es un gestor de paquetes en y para Python. Si no tuvieses en tu sistema pip, deberás instalarlo::sudo apt-get install python-pip # Debian y ubuntusudo pacman -S python2-pip # Arch Linuxsudo yum install python-pio # Fedora# Otros: https://pip.pypa.io/en/latest/installing.htmlInstalación en 5 minutos con virtualenvwrapper (recomendado)============================================================Virtualenvwrapper te permite crear entornos virtuales de Python de forma fácil y sencilla. No te preocupes, aunque sellamen "entornos virtuales", no existe virtualización alguna. Sólo son entornos separados a los del sistema paraevitar conflictos en las dependencias y poder instalar y actualizar paquetes sin preocupaciones.Instala virtualenvwrapper.nekbot con pip::sudo pip install virtualenvwrapper.nekbotCrea un directorio en tu directorio personal para los proyectos de Virtualenvwrapper (donde residirán los bots). Porejemplo, puedes crearlo como::mkdir ~/ProjectsAñade al final de tu .bashrc las siguientes líneas::cat <<EOT >> ~/.bashrc# Donde residirá el virtualenv (bibliotecas). Se crea automáticamente.export WORKON_HOME=$HOME/.virtualenvs# Directorio de los proyectos. Donde estarán tus bots. Debes crearlo.export PROJECT_HOME=$HOME/Workspace# Permite usar virtualenvwrapper con este usuario. En ocasiones /usr/bin# en vez de /usr/local/bin. Mira donde se ha creado.source /usr/local/bin/virtualenvwrapper.shEOTRecarga tu consola para poder usar virtualenvwrapper::source ~/.bashrcCrea el nuevo proyecto con el nombre que tú quieras::mkproject -t nekbot minuevobotEn algunos sistemas como Arch, la versión por defecto de Python es la 3. NekBot no está probado con dicha versión(pero podría funcionar). Para usar Python2 con dichos sistemas::mkproject -t nekbot -p /usr/bin/python2 minuevobot¡¡Y listo!! Ya tienes tu nuevo bot.Instalación en 3 minutos con el sistema=======================================También puedes instalar NekBot a nivel del sistema::sudo pip install nekbotTras acabar de instalarse, podrás crear un nuevo bot con el comando del sistema nekbot-admin::nekbot-admin createbot <nombre bot>*¡Aviso!* Siempre es más recomendable instalar NekBot con un virtualenv para facilitar la instalación de dependencias ysu actualización. Instalándolo a nivel del sistema, significa que necesitarás permisos de root para instalarcualquier plugin, o que ciertas versiones de determinadas dependencias podrían ser incompatibles con las de otrospaquetes de tu sistema.¡Necesitas protocolos!======================NekBot no hace nada de por sí. Necesita protocolos, y son todos opcionales. Por favor, instala alguno o varios de lossiguientes en función de tus necesidades:* https://bitbucket.org/Nekmo/nekbot.protocols.irc/* https://bitbucket.org/Nekmo/nekbot.protocols.telegram/* (XMPP próximamente).Sigue las recomendaciones de instalación de los protocolos y de su configuración.Configuración=============A parte de la configuración de los protocolos, te recomendamos añadir y quitar plugins según lo necesites. Para ellodeberás modificar el archivo settings.py de tu proyecto::PLUGINS = ['bot','hello',# Añade más plugins aquí separados por comas y entre comillas]Cómo ejecutarlo===============Para su ejecución, tan solo necesitas usar el ejecutable de nekbot incluido::chmod +x nekbot # Por si no tuviese permisos./nekbot startTambién puedes usar nekbot-admin::nekbot-admin startPor supuesto, en el directorio del bot. Con virtualenvwrapper hay algunas diferencias. Míralas a continuaciónUso con virtualenvwrapper=========================Por defecto, al crear un nuevo virtualenvwrapper te encontrarás ya en el directorio del bot, y dentro de su entornovirtual. Notarás esto por el comienzo del prompt::(minuevobot)[nekmo@homura ~/Projects/minuevobot]$Para salir de un entorno virtual::deactivatePara volver a entrar en el mismo::workon <nombre proyecto>Para borrar un virtualenv::rmvirtualenv <nombre proyecto>Y esto es cuanto necesitas saber. Para más información: https://virtualenvwrapper.readthedocs.org/en/latest/command_ref.htmlCreate plugins easily!======================Create plugins is very easy! Here's an example::from nekbot.core.commands import command@commanddef hello(message):return 'Hello world! Your message: %s' % messageFor more information, see the documentation.