mv-academic-calendar
Maldives school academic calendar data, 2015 to 2027: terms, exams, mid-term breaks and public holidays. Works offline, no dependencies. Unofficial, compiled from calendars published by the Ministry of Education.
pip install mv-academic-calendar
import mv_academic_calendar as mv
mv.is_public_holiday("2026-01-01") # True
mv.events_on("2026-05-27") # what is happening that day
mv.next_event("2026-02-01", category="public_holiday") # the next public holiday
mv.events(year=2026, category="exam_days") # filter by calendar, category, status, date range, text
mv.calendars() # which calendars exist, with their status
mv.ics("2026") # the iCalendar file as text
Events are frozen dataclasses with real date objects (start, end inclusive), a name, a category
(public_holiday, school_days, exam_days, term_holidays, other), and the calendar's status
(final, current, tentative). Academic years that run August to June are named like "2023-2024".
Dates have no time zone: pass a date, or a datetime (read as the local date it shows), or "YYYY-MM-DD".
The data is bundled with the package. mv_academic_calendar.updated tells you when it was last checked.
For the newest data between package releases, fetch it from the repository.
Licence
Code: MIT. The compiled data: CC BY 4.0. Please credit it, and say it is unofficial:
Maldives Academic Calendar, https://github.com/grootismore/mv-academic-calendar. Compiled from calendars published by the Ministry of Education, Republic of Maldives. Unofficial.
(mv_academic_calendar.attribution holds that text.) The package stores no Ministry documents, only the dates and names extracted from them.
Metadata
Release files for mv-academic-calendar 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mv_academic_calendar-0.1.0.tar.gz | 31.4 kB | With provenance | Details for mv_academic_calendar-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mv_academic_calendar-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for mv_academic_calendar-0.1.0-py3-none-any.whl |
Total release size: 65.1 kB
Release files / mv_academic_calendar-0.1.0.tar.gz
| Download URL | mv_academic_calendar-0.1.0.tar.gz |
|---|---|
| Size | 31.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
085934e7bcbae2697643a8e07a7d28ccf9e6fa034ddb4abe5584549d55eda9e5
|
|
BLAKE2b-256 checksum How to use checksums |
73fa3202784df19b27b5b71fe8690ed17eb2476acaff7e8f48d20ffe3eaffafa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.
Transparency logRelease files / mv_academic_calendar-0.1.0-py3-none-any.whl
| Download URL | mv_academic_calendar-0.1.0-py3-none-any.whl |
|---|---|
| Size | 33.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3594f3c11150c06835f320503a48af8f3e3c13d0ed9a3c4ca5f4dcc72f0e662c
|
|
BLAKE2b-256 checksum How to use checksums |
85591080ef28377105c5a9ebcd0c499a38b9614d9f4698a46f73e2dc0d37ab32
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.
Transparency logSecurity for mv-academic-calendar 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for mv_academic_calendar-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.