ugurkap / kontenjanci-public

İTÜ Kontenjan İzlemcisi is a Telegram bot which users can use to track a different number of courses and get notified if there are any available seats in those courses. Only available on add-drop period.

kontenjanci-public

Public version of Telegram bot "İTÜ Kontenjan İzlemcisi". (This repo doesn't include the bot token) https://telegram.me/ITUKontenjanBot

How does it work?

Istanbul Technical University updates its course information page every 15 minutes. Scraper, which is available in scraper.py, scrapes the webpage and adds a CRN(Unique course number) to a list if (course capacity > enrollment).

Then, in application.py, we have the application which uses the Scraper every 15 minutes and saves the list in a file called available_courses.txt. To do that, I am using a library called schedule.

Finally, we have bot.py which is a Telegram bot. User is able to add course numbers s/he wants and then start the "watch" which notifies the user when the course number s/he follows is added to available_courses.txt. To do that, I have used python-telegram-bot library.

kontenjanci-public's Issues

Refactor scraper.py

I've selected scraper.py for refactoring, which is a module that has 1 instance(s) of code in comments (1). Addressing this will make our codebase more maintainable and improve Better Code Hub's Write Clean Code guideline rating! 👍

Here's the gist of this guideline:

• Definition 📖
  Apply The Boy Scout Rule and fix "code smells" in the codebase.
• Why❓
  Clean code is maintainable code.
• How 🔧
  Remove useless comments, commented code blocks, and dead code. Refactor poorly handled exceptions, magic constants, and poorly named units or variables.

You can find more info about this guideline in Building Maintainable Software. 📖

---

ℹ️ To know how many other refactoring candidates need addressing to get a guideline compliant, select some by clicking on the 🔲 next to them. The risk profile below the candidates signals (✅) when it's enough! 🏁

---

Good luck and happy coding! ✨ 💯

Use multithreaded requests

Right now, scraper checks every webpage sequentially using a for loop and it takes almost 1 minute to update the list. Multi-threaded approach will be faster.

Scraper kills itself

This one is random and needs deeper inspection. I might add auto-restart.

Refactor bot.py

I've selected bot.py for refactoring, which is a module that has 2 instance(s) of code in comments (1, 2). Addressing this will make our codebase more maintainable and improve Better Code Hub's Write Clean Code guideline rating! 👍

Here's the gist of this guideline:

• Definition 📖
  Apply The Boy Scout Rule and fix "code smells" in the codebase.
• Why❓
  Clean code is maintainable code.
• How 🔧
  Remove useless comments, commented code blocks, and dead code. Refactor poorly handled exceptions, magic constants, and poorly named units or variables.

You can find more info about this guideline in Building Maintainable Software. 📖

---

ℹ️ To know how many other refactoring candidates need addressing to get a guideline compliant, select some by clicking on the 🔲 next to them. The risk profile below the candidates signals (✅) when it's enough! 🏁

---

Good luck and happy coding! ✨ 💯

Check response code

Sometimes website doesn't work, so we should check the response code.

Migrate to sqlite

Instead of text files, I will use sqlite.