HKUST-GZ Course Robota 📚

🤖 A powerful course information scraper for HKUST-GZ

简体中文 | English

✨ Features

• 🔄 Auto Scraping: Automatically fetch course information for any term
• 📋 Rich Data: Extract comprehensive course details including:
  • Course codes and names
  • Course descriptions and credits
  • Class schedules and locations
  • Instructor information
  • Quota and enrollment status
• 💾 Data Storage: Efficiently store data in SQLite database for easy access

🚀 Quick Start

Prerequisites

Before you begin, ensure you have:

• Python 3.6 or higher
• pip package manager

Installation

1. Clone the repository:

git clone https://github.com/AdAstraAbyssoque/HKUST-GZ-CourseRobota.git
cd HKUST-GZ-CourseRobota

2. Install dependencies:

pip install -r requirements.txt

For lower version python, please run pip install request.

📖 Usage

Basic Usage

Simply run:

python robot.py

Advanced Configuration

Specify a different term:

scraper = CourseScraper(termnumber=2340)  # 2340 represents Term 4 of 2023-24

💡 Data Structure

All course data is stored in SQLite database with the following structure:

courses_[termnumber].db
└── courses table
    ├── courseTitle
    ├── courseCode
    ├── courseName
    ├── courseDescription
    └── ... (other fields)

⚠️ Notes

• 🕒 Please use reasonable scraping intervals
• 📝 Data is for reference only
• 🔄 Regular updates may be needed

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new features
• Submit pull requests

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Contact

If you have any questions, feel free to open an issue.

LICENSE

This project is licensed under the Commons Clause + Apache 2.0 combined license. Free for personal use, commercial use requires authorization.