Skip to main content

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.

More: https://github.com/grootismore/mv-academic-calendar

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)

Source distribution for mv-academic-calendar 0.1.0
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)

Table of built distributions (wheels) for mv-academic-calendar 0.1.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page