ciclopibot

CicloPiBot

@CicloPiBot is a Telegram bot based on davtelepot which provides information about CicloPi, the public bike-sharing service in Pisa.

Usage

Client side

Send /start @CicloPiBot, all you need is a Telegram account.

Commands

• /start the bot
• Ask for /help for further information
• Ask for /ciclopi information

"Server" side

You may choose between method 1 (pip) and method 2 (git).

1. Using pip
   • Install ciclopibot

   pip install ciclopibot
   

   • Run ciclopibot as module

   python -m ciclopibot -h  # Get help 
   python -m ciclopibot <your_token_here>
   

2. Using git
   • Clone this repository

   git clone ssh://[e-mail]:8445/Davte/ciclopibot.git
   # git clone https://gogs.davte.it/Davte/ciclopibot.git
   # git clone [e-mail]:Davte/ciclopibot.git
   # git clone https://github.com/Davte/ciclopibot.git
   

   • Run install.sh: it will help you perform the following operations.
     • Put a Telegram bot token in gitignored data/passwords.py module.
       • To get a token, ask @BotFather.
       • The bot whose token you use will act as @CicloPiBot as long as you run the script.
     • Create a python3.5+ virtual environment and install requirements.
     • Specify python_virtual_environment and python_script variables in my_config.sh
   • Run run_me.sh

   bash run_me.sh;
   

   • You may edit the file and test your code with your bot.
   • Should you be satisfied of your edits enough, you may fork this repository and open a pull request.

Credits

• Davte is the creator and the main author of this repository.
• All data are obtained from CicloPi website and are meant to help users save time when using their service. Misuse is discouraged.
• Minala inspired the idea and gave a first version of this service many years ago with a different implementation.