Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/arionmiles/mis-bot

Telegram bot to pull attendance from SJCET website, plus more features like bunk calculator, test reports, etc. https://mis-bot.readthedocs.io/
https://github.com/arionmiles/mis-bot

aldel aldel-mis bot sjcet telegram-bot

Last synced: 5 days ago
JSON representation

Telegram bot to pull attendance from SJCET website, plus more features like bunk calculator, test reports, etc. https://mis-bot.readthedocs.io/

Host: GitHub
URL: https://github.com/arionmiles/mis-bot
Owner: ArionMiles
License: mit
Created: 2017-09-28T15:41:32.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2022-11-22T02:18:40.000Z (almost 2 years ago)
Last Synced: 2024-08-02T13:34:45.160Z (3 months ago)
Topics: aldel, aldel-mis, bot, sjcet, telegram-bot
Language: Python
Homepage:
Size: 378 KB
Stars: 21
Watchers: 3
Forks: 8
Open Issues: 4
Metadata Files:
- Readme: README.md
- License: LICENSE.md

Awesome Lists containing this project

README

        # MIS Bot

[![Telegram Bot](https://img.shields.io/badge/Telegram-Bot-blue.svg)](https://t.me/SJCET_MIS_BOT)

[![Telegram Channel](https://img.shields.io/badge/Telegram-Channel-blue.svg)](https://t.me/joinchat/AAAAAEzdjHzLCzMiKpUw6w)

# About

I created this bot as a means to avoid Defaulter's List, and I hope this bot can help others avoid it, too. The bot is hosted on the Google Cloud Platform (GCP). 

## Features

  * **CAPTCHA Bypass**

  

    The bot can automatically answer the captcha code for logging in. Uses [securimage_solver](https://github.com/sampritipanda/securimage_solver) library.

  * **Bunk Calculator**

  

    Calculate rise/drop in your overall percentage.

    [![Bunk calculator formula](media/bunk_func.png)]()

    where 

          a = Total lectures attended

          b = Total lectures conducted on the day of bunk

          c = Total lectures conducted so far

          n = number of lectures to bunk

  * **Until80**

    Shows the number of lectures one must consecutively attend in order to get their Overall Attendance to 80%. It is the minimum percentage of overall lectures one must attend to avoid the defaulter's list.

    [![Until80 formula](media/until80_func.png)]()

    where 

          a = Total lectures attended

          c = Total lectures conducted so far

          x = number of lectures to attend

    **Note:** We calculate `x` from this equation. Value of `x` can be negative too, when your attendance is already over 80.

  * **Until X**

  

    Like Until80 but you specify the percentage.

  

  * **Target Attendance**

    Set a target of attendance percentage for yourself and we'll remind you how long you've left to go before fulfilling your target.

  * **Results**

    Fetch results of Class Tests. Uses scrapy-splash library.

  

## Installation and Documentation

Read the documentation at mis-bot.readthedocs.io on getting this bot up and running for yourself.

# Roadmap

 * ~Attendance scraper~

 * ~Bunk/Until80 functions~

 * ~Allow registration~

 * ~Results scraper~

 * ~Store attendance data in a database~

# Contributors

 * [Arush Ahuja (arush15june)](https://github.com/arush15june)

 * [Vikas Yadav (v1k45)](https://github.com/v1k45)

 * [Sampriti Panda](https://github.com/sampritipanda)

 * [Sabine Wieluch (bleeptrack)](https://github.com/bleeptrack) (Gave us a really cute [Profile Photo](media/avatar.png)!)

 * [Amey Khale (Noctis0712)](https://github.com/Noctis0712)

# License

MIT License. Please see [License](LICENSE.md) file for more information.