Metadata-Version: 2.4
Name: prima-principia
Version: 0.1.0
Summary: Prerequisite-aware university course schedule generator. Development in progress.
License: MIT
Project-URL: Homepage, https://github.com/ShadowStrike-CTF/prima-principia
Project-URL: Bug Tracker, https://github.com/ShadowStrike-CTF/prima-principia/issues
Classifier: Development Status :: 1 - Planning
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Education
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# prima-principia

Prerequisite-aware university course schedule generator.

Work out the fastest valid path through your degree — given which units you want, when you can start, and how many units per trimester you can handle. Works backwards from your target units through the full prerequisite chain and outputs a trimester-by-trimester schedule.

**Status: development in progress.** The algorithm and Deakin JD dataset are built and validated. The full web app and Python package are in active development.

---

## What it does

- Takes your target electives and start trimester as input
- Resolves the full prerequisite chain automatically
- Schedules units trimester-by-trimester, respecting offering constraints (T2-only, T3-only, etc.)
- Flags units offered only in specific years so you don't miss a narrow window
- Warns when prerequisite data is unverified

## Current support

- Deakin JD (M729) — 2026 and 2027 handbooks

## Planned

- Multi-university support (UTS JD, UNSW JD, UNE LLB)
- Semester structure (not just trimesters)
- iOS / Android (React Native + Expo)
- User accounts — track completed units, update schedule live

---

## Install

```
pip install prima-principia
```

> Stub release only. Full implementation coming — star the repo to follow progress.

---

## Licence

MIT — see [LICENSE](LICENSE)

© 2026 ShadowStrike. Licensed under the MIT Licence.
