as1605 / iitd-bot

Discord bot to administer IITD Study Servers (unofficial)

IITD-Bot

Discord bot to administer IITD'20 Acad Server

Commands

• hello to check if bot is online
• ?help to display this message
• ?set <kerberos> to set your kerberos and automatically assign role for branch, hostel and courses
• ?courses (self) or ?courses <kerberos> or ?courses @User to list courses
• ?slot <course> to get slot for a course
• ?info <course> to get info for a course (name, credits, pre reqs, overlaps, description). Uses IITD Course Planner
• ?tt (self) or ?tt <kerberos> or ?tt @User to get yours or someone else's timetable (excluding labs for now)
• ?mess (self)(today) or ?mess @User or ?mess <hostel> -<day> to get mess menu for the hostel on that day. Uses data from BHM records
• ?yt to launch a YouTube Together session, where you can watch youtube videos or lectures together in a voice channel
• ?major (self) or ?major <kerberos> or ?major @User to get yours or someone else's major date sheet. Uses Majors API by Adit Malhotra
• Works for multiple inputs too! Try ?slot COL106 COL202

Manager only

• ?edit <kerberos> @User to edit kerberos for some user
• ?checkmail <mail-to> #Channel to track circular emails on that channel every minute
• ?update to update roles for all registered users
• ?reload to reload the database from .csv and .json files
• ?fetchldap to fetch courses data from ldap and reload

Configure

• Install python then clone this repo and switch into the directory
• Install dependencies discord, bs4, dotenv, requests
• Put BOT_TOKEN, IITD_EMAIL, IITD_PASS in .env file in the same directory
• Requires files kerberos.csv, hostels.csv, branches.csv, courses.csv in the same directory to store configuration and data for the batch of your server. These are excluded in .gitignore for privacy reasons. Contact me if you need them for configuration.
• course_lists.json can be generated from get_course_lists() function of utils.py if you are connected to IIT Delhi Internal Network
• discord_ids.json will be generated and updated by the script
• log.txt is a temporary file generated by ?update command
• Run python bot.py

iitd-bot's Issues

Course information command

?info CLL231 returns:

CLL231 - Fluid Mechanics for Chemical Engineers
4 Credits (3-1-0)
Pre-requisites: CLL110
Overlap: APL107, APL106, APL105

Introduction to fluids, Forces on fluids, Fluid statics, Hydrostatic force on submerged bodies, Rigid body motion, Kinematics of flow - Eulerian and Lagrangian descriptions, Flow visualization, Integral analysis - mass and momentum balances, Bernoulli equation, Flow through pipes and ducts, Flow measurement, Flow transportation - pumps, blowers and compressors, Differential analysis of flow, Conservation of mass, linear and angular momentum, Navier-Stokes equation, Unidirectional flows, Viscous flows, Skin friction and form friction, Lubrication approximation, Potential flows, Boundary layer theory, Blasius equation for flow over a flat plate, Boundary layer separation, Drag and lift force on immersed bodies, Similitude analysis, Turbulent flows.

(The whole thing will be in a code block? do code blocks in discord wrap text as well? they don't on GitHub).