Metadata-Version: 2.3
Name: qums-fetch
Version: 0.4.4.dev1
Summary: Login and fetch data from QUMS-ERP Dashboard
Author: Ishaan Gupta
Author-email: Ishaan Gupta <ishaan.ishu@proton.me>
Requires-Dist: beautifulsoup4>=4.15.0
Requires-Dist: pillow>=12.3.0
Requires-Dist: pytesseract>=0.3.13
Requires-Dist: python-dotenv>=1.2.2
Requires-Dist: requests>=2.34.2
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# qums.py

Automatically fetch student data from QUMS

## Prerequisites

[Tesseract OCR](https://github.com/tesseract-ocr/tesseract) must be installed on your system for captcha solving:

```bash
# Ubuntu/Debian
sudo apt-get install tesseract-ocr

# macOS
brew install tesseract

# Windows
scoop install tesseract
```

## Quick start

Create a `.env` file with:

```env
QUMS_USERNAME=your_username
QUMS_PASSWORD=your_password
```

Then install the package:

```bash
pip install qums-fetch
```

## Usage

```python
from qums_fetch import Client

client = Client(USERNAME, PASSWORD)
print(client.student_details)
print(client.today_attendance)
```

## Development

See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions.
Check [TODO.md](TODO.md) for open tasks and API coverage.

## Credits

The captcha solving approach in this project is based on [Kyun-UMS](https://github.com/24kaushik/Kyun-UMS) by [24kaushik](https://github.com/24kaushik).
