Queer European MD passionate about IT

README.md 2.2 KB

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://git@gogs.davte.it:8445/Davte/ciclopibot.git
      # git clone https://gogs.davte.it/Davte/ciclopibot.git
      # git clone git@github.com: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.