Developed by Antonio Finocchiaro and Salvatore Alfio Sambataro, this project is part of the Quality Development course at the University of Catania.

Project Goal

This project involves the creation of a Telegram Bot aimed at delivering users the most recent music releases from the metal music scene. Users have the option to access this information using two distinct commands. They can choose to retrieve all the latest releases or specify a subset based on their preferences.

Technologies used

• Web Scraping: BeautifulSoup
• Parallel Tasks: Concurrent Futures
• Telegram API: Telegram

Project Structure

How to execute the project

To execute the Telegram Bot, you need to follow some steps.

Install requirements

Install the libraries needed first. Use pip or pip3 to install the dev requirements for the software usage and testing:

Source code requirements:

pip3 install -r requirements.txt

Testing code requirements:

pip3 install -r requirements_dev.txt

Start project

Execute python3 coreRadioBot.py in the /src folder.

To run this code, you need the Telegram Bot Token, stored within token_config.yaml in /src. It is hidden for security purpose, contact the authors to receive it and follow the instructions within config.py.

To interact with the Bot:

• Open Telegram.
• Search xCoreBot and start a conversation.
• Digit /help to obtain information about its usage.

Software Testing

Run the following command in the main directory to obtain a HTML report about the Pytest Coverage!

$ pytest --cov ./src ./tests --cov-report=html