GaianCalendar 0.1.0__tar.gz

gaiancalendar-0.1.0/GaianCalendar.egg-info/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: GaianCalendar
+Version: 0.1.0
+Summary: Python library for the Gaian Calendar — a perpetual 13-month solar calendar based on ISO week-year arithmetic.
+Author: Immanuelle
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Emma-Leonhart/GaianCalendar
+Project-URL: Issues, https://github.com/Emma-Leonhart/GaianCalendar/issues
+Keywords: calendar,gaian,date,alternative calendar,perpetual calendar,ISO week,zodiac
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# GaianCalendar
+
+A pure-Python library for the **Gaian Calendar** — a perpetual 13-month solar calendar based on ISO week-year arithmetic.
+
+```python
+from gaian_calendar import GaianDate
+
+today = GaianDate.today()
+print(today)                    # e.g. "Aquarius 22, 12026 GE"
+print(today.day_of_year)        # e.g. 78
+print(today.is_leap_year)       # True
+print(today.format("WWWW, MMMM d, yyyy GE"))  # "Sunday, Aquarius 22, 12026 GE"
+```
+
+---
+
+## Status
+
+**Pre-release — planning phase.** See [`planning/`](planning/) for design documents.
+
+---
+
+## What is the Gaian Calendar?
+
+The Gaian Calendar is a perpetual reform calendar with these properties:
+
+- **13 regular months** of exactly 28 days (4 weeks × 7 days), named after zodiac constellations
+- **1 intercalary month** (Horus, 7 days) in leap years only — years with ISO week 53
+- **Perpetual**: every calendar date always falls on the same weekday, every year
+- **Year numbering**: Gaian year = ISO week-year + 10,000 (so 2026 CE = 12026 GE)
+- **Zero weekday drift**: recurring events stay on the same day of week indefinitely
+
+The 13 months in order: Sagittarius · Capricorn · Aquarius · Pisces · Aries · Taurus · Gemini · Cancer · Leo · Virgo · Libra · Scorpius · Ophiuchus · (Horus in leap years)
+
+---
+
+## Installation
+
+```bash
+pip install gaian-calendar
+```
+
+*(Not yet published — coming soon)*
+
+---
+
+## Usage
+
+```python
+from datetime import date, timedelta
+from gaian_calendar import GaianDate, GaianMonth, is_leap_year
+
+# Today
+d = GaianDate.today()
+
+# From Gregorian
+d = GaianDate.from_gregorian(date(2026, 2, 22))
+print(d)                  # "Aquarius 22, 12026 GE"
+print(d.to_gregorian())   # 2026-02-22
+
+# Properties
+print(d.year)             # 12026
+print(d.month)            # 3
+print(d.day)              # 22
+print(d.month_name)       # "Aquarius"
+print(d.month_symbol)     # "♒"
+print(d.weekday_name)     # "Sunday"
+print(d.weekday_symbol)   # "☉"
+print(d.day_of_year)      # 78
+print(d.is_leap_year)     # True
+
+# Arithmetic
+next_week = d + timedelta(weeks=1)
+yesterday = d - timedelta(days=1)
+delta = d - GaianDate(12026, 1, 1)   # timedelta
+
+# Parsing
+d = GaianDate.parse("Aquarius 22, 12026")
+d = GaianDate.parse("12026-03-22")
+d = GaianDate.parse("3/22/12026")
+
+# Formatting
+d.format("MMMM d, yyyy GE")          # "Aquarius 22, 12026 GE"
+d.format("MMM* DDD")                 # "♒ 078"
+d.format("yyyy-MM-dd")               # "12026-03-22"
+d.format("ddd")                      # "22nd"
+
+# Leap year check
+is_leap_year(12026)    # True
+is_leap_year(12025)    # False
+
+# Month info
+from gaian_calendar import GaianMonth
+m = GaianMonth.AQUARIUS
+print(m.symbol)    # "♒"
+print(m.element)   # "Air"
+```
+
+---
+
+## Similar Libraries
+
+This library is modeled after:
+- [`hijridate`](https://pypi.org/project/hijridate/) — Islamic Hijri calendar
+- [`pyluach`](https://pypi.org/project/pyluach/) — Hebrew calendar
+
+---
+
+## License
+
+MIT

gaiancalendar-0.1.0/GaianCalendar.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+LICENSE
+README.md
+pyproject.toml
+GaianCalendar.egg-info/PKG-INFO
+GaianCalendar.egg-info/SOURCES.txt
+GaianCalendar.egg-info/dependency_links.txt
+GaianCalendar.egg-info/top_level.txt
+gaian_calendar/__init__.py
+gaian_calendar/_convert.py
+gaian_calendar/_data.py
+gaian_calendar/_format.py
+gaian_calendar/date.py
+gaian_calendar/month.py
+gaian_calendar/weekday.py
+tests/test_convert.py
+tests/test_date.py
+tests/test_format.py
+tests/test_month_weekday.py

gaiancalendar-0.1.0/GaianCalendar.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

gaiancalendar-0.1.0/GaianCalendar.egg-info/top_level.txt

@@ -0,0 +1 @@
+gaian_calendar

gaiancalendar-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Immanuelle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gaiancalendar-0.1.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: GaianCalendar
+Version: 0.1.0
+Summary: Python library for the Gaian Calendar — a perpetual 13-month solar calendar based on ISO week-year arithmetic.
+Author: Immanuelle
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Emma-Leonhart/GaianCalendar
+Project-URL: Issues, https://github.com/Emma-Leonhart/GaianCalendar/issues
+Keywords: calendar,gaian,date,alternative calendar,perpetual calendar,ISO week,zodiac
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# GaianCalendar
+
+A pure-Python library for the **Gaian Calendar** — a perpetual 13-month solar calendar based on ISO week-year arithmetic.
+
+```python
+from gaian_calendar import GaianDate
+
+today = GaianDate.today()
+print(today)                    # e.g. "Aquarius 22, 12026 GE"
+print(today.day_of_year)        # e.g. 78
+print(today.is_leap_year)       # True
+print(today.format("WWWW, MMMM d, yyyy GE"))  # "Sunday, Aquarius 22, 12026 GE"
+```
+
+---
+
+## Status
+
+**Pre-release — planning phase.** See [`planning/`](planning/) for design documents.
+
+---
+
+## What is the Gaian Calendar?
+
+The Gaian Calendar is a perpetual reform calendar with these properties:
+
+- **13 regular months** of exactly 28 days (4 weeks × 7 days), named after zodiac constellations
+- **1 intercalary month** (Horus, 7 days) in leap years only — years with ISO week 53
+- **Perpetual**: every calendar date always falls on the same weekday, every year
+- **Year numbering**: Gaian year = ISO week-year + 10,000 (so 2026 CE = 12026 GE)
+- **Zero weekday drift**: recurring events stay on the same day of week indefinitely
+
+The 13 months in order: Sagittarius · Capricorn · Aquarius · Pisces · Aries · Taurus · Gemini · Cancer · Leo · Virgo · Libra · Scorpius · Ophiuchus · (Horus in leap years)
+
+---
+
+## Installation
+
+```bash
+pip install gaian-calendar
+```
+
+*(Not yet published — coming soon)*
+
+---
+
+## Usage
+
+```python
+from datetime import date, timedelta
+from gaian_calendar import GaianDate, GaianMonth, is_leap_year
+
+# Today
+d = GaianDate.today()
+
+# From Gregorian
+d = GaianDate.from_gregorian(date(2026, 2, 22))
+print(d)                  # "Aquarius 22, 12026 GE"
+print(d.to_gregorian())   # 2026-02-22
+
+# Properties
+print(d.year)             # 12026
+print(d.month)            # 3
+print(d.day)              # 22
+print(d.month_name)       # "Aquarius"
+print(d.month_symbol)     # "♒"
+print(d.weekday_name)     # "Sunday"
+print(d.weekday_symbol)   # "☉"
+print(d.day_of_year)      # 78
+print(d.is_leap_year)     # True
+
+# Arithmetic
+next_week = d + timedelta(weeks=1)
+yesterday = d - timedelta(days=1)
+delta = d - GaianDate(12026, 1, 1)   # timedelta
+
+# Parsing
+d = GaianDate.parse("Aquarius 22, 12026")
+d = GaianDate.parse("12026-03-22")
+d = GaianDate.parse("3/22/12026")
+
+# Formatting
+d.format("MMMM d, yyyy GE")          # "Aquarius 22, 12026 GE"
+d.format("MMM* DDD")                 # "♒ 078"
+d.format("yyyy-MM-dd")               # "12026-03-22"
+d.format("ddd")                      # "22nd"
+
+# Leap year check
+is_leap_year(12026)    # True
+is_leap_year(12025)    # False
+
+# Month info
+from gaian_calendar import GaianMonth
+m = GaianMonth.AQUARIUS
+print(m.symbol)    # "♒"
+print(m.element)   # "Air"
+```
+
+---
+
+## Similar Libraries
+
+This library is modeled after:
+- [`hijridate`](https://pypi.org/project/hijridate/) — Islamic Hijri calendar
+- [`pyluach`](https://pypi.org/project/pyluach/) — Hebrew calendar
+
+---
+
+## License
+
+MIT

gaiancalendar-0.1.0/README.md

@@ -0,0 +1,111 @@
+# GaianCalendar
+
+A pure-Python library for the **Gaian Calendar** — a perpetual 13-month solar calendar based on ISO week-year arithmetic.
+
+```python
+from gaian_calendar import GaianDate
+
+today = GaianDate.today()
+print(today)                    # e.g. "Aquarius 22, 12026 GE"
+print(today.day_of_year)        # e.g. 78
+print(today.is_leap_year)       # True
+print(today.format("WWWW, MMMM d, yyyy GE"))  # "Sunday, Aquarius 22, 12026 GE"
+```
+
+---
+
+## Status
+
+**Pre-release — planning phase.** See [`planning/`](planning/) for design documents.
+
+---
+
+## What is the Gaian Calendar?
+
+The Gaian Calendar is a perpetual reform calendar with these properties:
+
+- **13 regular months** of exactly 28 days (4 weeks × 7 days), named after zodiac constellations
+- **1 intercalary month** (Horus, 7 days) in leap years only — years with ISO week 53
+- **Perpetual**: every calendar date always falls on the same weekday, every year
+- **Year numbering**: Gaian year = ISO week-year + 10,000 (so 2026 CE = 12026 GE)
+- **Zero weekday drift**: recurring events stay on the same day of week indefinitely
+
+The 13 months in order: Sagittarius · Capricorn · Aquarius · Pisces · Aries · Taurus · Gemini · Cancer · Leo · Virgo · Libra · Scorpius · Ophiuchus · (Horus in leap years)
+
+---
+
+## Installation
+
+```bash
+pip install gaian-calendar
+```
+
+*(Not yet published — coming soon)*
+
+---
+
+## Usage
+
+```python
+from datetime import date, timedelta
+from gaian_calendar import GaianDate, GaianMonth, is_leap_year
+
+# Today
+d = GaianDate.today()
+
+# From Gregorian
+d = GaianDate.from_gregorian(date(2026, 2, 22))
+print(d)                  # "Aquarius 22, 12026 GE"
+print(d.to_gregorian())   # 2026-02-22
+
+# Properties
+print(d.year)             # 12026
+print(d.month)            # 3
+print(d.day)              # 22
+print(d.month_name)       # "Aquarius"
+print(d.month_symbol)     # "♒"
+print(d.weekday_name)     # "Sunday"
+print(d.weekday_symbol)   # "☉"
+print(d.day_of_year)      # 78
+print(d.is_leap_year)     # True
+
+# Arithmetic
+next_week = d + timedelta(weeks=1)
+yesterday = d - timedelta(days=1)
+delta = d - GaianDate(12026, 1, 1)   # timedelta
+
+# Parsing
+d = GaianDate.parse("Aquarius 22, 12026")
+d = GaianDate.parse("12026-03-22")
+d = GaianDate.parse("3/22/12026")
+
+# Formatting
+d.format("MMMM d, yyyy GE")          # "Aquarius 22, 12026 GE"
+d.format("MMM* DDD")                 # "♒ 078"
+d.format("yyyy-MM-dd")               # "12026-03-22"
+d.format("ddd")                      # "22nd"
+
+# Leap year check
+is_leap_year(12026)    # True
+is_leap_year(12025)    # False
+
+# Month info
+from gaian_calendar import GaianMonth
+m = GaianMonth.AQUARIUS
+print(m.symbol)    # "♒"
+print(m.element)   # "Air"
+```
+
+---
+
+## Similar Libraries
+
+This library is modeled after:
+- [`hijridate`](https://pypi.org/project/hijridate/) — Islamic Hijri calendar
+- [`pyluach`](https://pypi.org/project/pyluach/) — Hebrew calendar
+
+---
+
+## License
+
+MIT

gaiancalendar-0.1.0/gaian_calendar/__init__.py

@@ -0,0 +1,21 @@
+"""
+gaian_calendar — Python library for the Gaian Calendar.
+
+A perpetual 13-month solar calendar based on ISO week-year arithmetic.
+Gaian year = ISO week-year + 10,000.
+"""
+
+__version__ = "0.1.0"
+
+from .date import GaianDate
+from .month import GaianMonth
+from .weekday import GaianWeekday
+from ._convert import is_leap_year
+
+__all__ = [
+    "GaianDate",
+    "GaianMonth",
+    "GaianWeekday",
+    "is_leap_year",
+    "__version__",
+]

gaiancalendar-0.1.0/gaian_calendar/_convert.py

@@ -0,0 +1,83 @@
+"""
+Core Gaian Calendar arithmetic: conversions, validation, derived properties.
+All functions work with plain ints and datetime.date — no class dependencies.
+"""
+from datetime import date
+
+
+# ---------------------------------------------------------------------------
+# Leap year
+# ---------------------------------------------------------------------------
+
+def _iso_weeks_in_year(iso_year: int) -> int:
+    """Return 52 or 53: the number of ISO weeks in the given ISO week-year."""
+    # Dec 28 is always in the last real ISO week of the year (never week 1 of next)
+    return date(iso_year, 12, 28).isocalendar()[1]
+
+
+def is_leap_year(gaian_year: int) -> bool:
+    """Return True if the Gaian year has a Horus month (53 ISO weeks)."""
+    return _iso_weeks_in_year(gaian_year - 10_000) == 53
+
+
+# ---------------------------------------------------------------------------
+# Validation
+# ---------------------------------------------------------------------------
+
+def validate_date(year: int, month: int, day: int) -> None:
+    """Raise ValueError if (year, month, day) is not a valid Gaian date."""
+    if year < 10_001 or year > 19_999:
+        raise ValueError(f"Year {year} out of supported range (10001–19999)")
+    leap = is_leap_year(year)
+    max_month = 14 if leap else 13
+    if month < 1 or month > max_month:
+        if month == 14 and not leap:
+            raise ValueError(
+                f"Month 14 (Horus) only exists in leap years; {year} is not a leap year"
+            )
+        raise ValueError(f"Month {month} out of range (1–{max_month}) for year {year}")
+    max_day = 7 if month == 14 else 28
+    if day < 1 or day > max_day:
+        raise ValueError(
+            f"Day {day} out of range for month {month} "
+            f"({'Horus, max 7' if month == 14 else 'max 28'})"
+        )
+
+
+# ---------------------------------------------------------------------------
+# Conversion: Gregorian ↔ Gaian
+# ---------------------------------------------------------------------------
+
+def gregorian_to_gaian(d: date) -> tuple[int, int, int]:
+    """Convert a Gregorian date to a (gaian_year, month, day) tuple."""
+    iso_year, iso_week, iso_weekday = d.isocalendar()
+    month = (iso_week - 1) // 4 + 1          # 1–14
+    week_in_month = (iso_week - 1) % 4        # 0–3
+    day = week_in_month * 7 + iso_weekday     # 1–28 (or 1–7 for Horus)
+    gaian_year = iso_year + 10_000
+    return gaian_year, month, day
+
+
+def gaian_to_gregorian(year: int, month: int, day: int) -> date:
+    """Convert a Gaian date to a Gregorian datetime.date."""
+    iso_year = year - 10_000
+    iso_week = (month - 1) * 4 + (day - 1) // 7 + 1   # 1–53
+    iso_weekday = (day - 1) % 7 + 1                    # 1–7
+    return date.fromisocalendar(iso_year, iso_week, iso_weekday)
+
+
+# ---------------------------------------------------------------------------
+# Derived properties
+# ---------------------------------------------------------------------------
+
+def day_of_year(month: int, day: int) -> int:
+    """Return the day-of-year (1–364, or up to 371 for Horus days)."""
+    if month <= 13:
+        return (month - 1) * 28 + day
+    else:  # Horus (month 14)
+        return 364 + day
+
+
+def day_of_week(day: int) -> int:
+    """Return ISO weekday (1=Monday … 7=Sunday). Same for all years — perpetual."""
+    return (day - 1) % 7 + 1

gaiancalendar-0.1.0/gaian_calendar/_data.py

@@ -0,0 +1,80 @@
+"""
+Static data: month and weekday metadata for the Gaian Calendar.
+"""
+
+MONTHS: list[dict] = [
+    {"number": 1,  "name": "Sagittarius", "abbrev": "Sag", "symbol": "♐", "element": "Fire",    "iso_weeks": (1,  4)},
+    {"number": 2,  "name": "Capricorn",   "abbrev": "Cap", "symbol": "♑", "element": "Earth",   "iso_weeks": (5,  8)},
+    {"number": 3,  "name": "Aquarius",    "abbrev": "Aqu", "symbol": "♒", "element": "Air",     "iso_weeks": (9,  12)},
+    {"number": 4,  "name": "Pisces",      "abbrev": "Pis", "symbol": "♓", "element": "Water",   "iso_weeks": (13, 16)},
+    {"number": 5,  "name": "Aries",       "abbrev": "Ari", "symbol": "♈", "element": "Fire",    "iso_weeks": (17, 20)},
+    {"number": 6,  "name": "Taurus",      "abbrev": "Tau", "symbol": "♉", "element": "Earth",   "iso_weeks": (21, 24)},
+    {"number": 7,  "name": "Gemini",      "abbrev": "Gem", "symbol": "♊", "element": "Air",     "iso_weeks": (25, 28)},
+    {"number": 8,  "name": "Cancer",      "abbrev": "Can", "symbol": "♋", "element": "Water",   "iso_weeks": (29, 32)},
+    {"number": 9,  "name": "Leo",         "abbrev": "Leo", "symbol": "♌", "element": "Fire",    "iso_weeks": (33, 36)},
+    {"number": 10, "name": "Virgo",       "abbrev": "Vir", "symbol": "♍", "element": "Earth",   "iso_weeks": (37, 40)},
+    {"number": 11, "name": "Libra",       "abbrev": "Lib", "symbol": "♎", "element": "Air",     "iso_weeks": (41, 44)},
+    {"number": 12, "name": "Scorpius",    "abbrev": "Sco", "symbol": "♏", "element": "Water",   "iso_weeks": (45, 48)},
+    {"number": 13, "name": "Ophiuchus",   "abbrev": "Oph", "symbol": "⛎", "element": "Healing", "iso_weeks": (49, 52)},
+    {"number": 14, "name": "Horus",       "abbrev": "Hor", "symbol": "𓅃", "element": None,      "iso_weeks": (53, 53)},
+]
+
+WEEKDAYS: list[dict] = [
+    {"number": 1, "name": "Monday",    "abbrev": "Mon", "symbol": "☽", "planet": "Moon"},
+    {"number": 2, "name": "Tuesday",   "abbrev": "Tue", "symbol": "♂", "planet": "Mars"},
+    {"number": 3, "name": "Wednesday", "abbrev": "Wed", "symbol": "☿", "planet": "Mercury"},
+    {"number": 4, "name": "Thursday",  "abbrev": "Thu", "symbol": "♃", "planet": "Jupiter"},
+    {"number": 5, "name": "Friday",    "abbrev": "Fri", "symbol": "♀", "planet": "Venus"},
+    {"number": 6, "name": "Saturday",  "abbrev": "Sat", "symbol": "♄", "planet": "Saturn"},
+    {"number": 7, "name": "Sunday",    "abbrev": "Sun", "symbol": "☉", "planet": "Sun"},
+]
+
+# Ordinal suffixes for days 1–28
+_ORDINAL_SUFFIXES = {1: "st", 2: "nd", 3: "rd"}
+
+def ordinal(n: int) -> str:
+    """Return ordinal string: 1 → '1st', 2 → '2nd', 15 → '15th'."""
+    suffix = _ORDINAL_SUFFIXES.get(n % 10, "th")
+    # Special case: 11th, 12th, 13th (not 11st, 12nd, 13rd)
+    if 11 <= n % 100 <= 13:
+        suffix = "th"
+    return f"{n}{suffix}"
+
+_NUMBER_WORDS = [
+    "", "First", "Second", "Third", "Fourth", "Fifth", "Sixth", "Seventh",
+    "Eighth", "Ninth", "Tenth", "Eleventh", "Twelfth", "Thirteenth",
+    "Fourteenth", "Fifteenth", "Sixteenth", "Seventeenth", "Eighteenth",
+    "Nineteenth", "Twentieth", "Twenty-first", "Twenty-second", "Twenty-third",
+    "Twenty-fourth", "Twenty-fifth", "Twenty-sixth", "Twenty-seventh", "Twenty-eighth",
+]
+
+def number_word(n: int) -> str:
+    """Return word form: 1 → 'First', 15 → 'Fifteenth'."""
+    if 1 <= n <= 28:
+        return _NUMBER_WORDS[n]
+    raise ValueError(f"number_word only supports 1–28, got {n}")
+
+# Fast lookup maps
+_MONTH_BY_NUMBER: dict[int, dict] = {m["number"]: m for m in MONTHS}
+_MONTH_BY_NAME: dict[str, dict] = {}
+for _m in MONTHS:
+    _MONTH_BY_NAME[_m["name"].lower()] = _m
+    _MONTH_BY_NAME[_m["abbrev"].lower()] = _m
+
+_WEEKDAY_BY_NUMBER: dict[int, dict] = {w["number"]: w for w in WEEKDAYS}
+
+def get_month(number: int) -> dict:
+    if number not in _MONTH_BY_NUMBER:
+        raise ValueError(f"Invalid month number: {number}")
+    return _MONTH_BY_NUMBER[number]
+
+def get_month_by_name(name: str) -> dict:
+    key = name.lower().rstrip(".")
+    if key not in _MONTH_BY_NAME:
+        raise ValueError(f"Unknown month name: {name!r}")
+    return _MONTH_BY_NAME[key]
+
+def get_weekday(number: int) -> dict:
+    if number not in _WEEKDAY_BY_NUMBER:
+        raise ValueError(f"Invalid weekday number: {number}")
+    return _WEEKDAY_BY_NUMBER[number]