bsad-converter 1.0.0__tar.gz

bsad_converter-1.0.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.pyc
+dist/
+build/
+*.egg-info/
+.pytest_cache/

bsad_converter-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Government of Nepal — Office of the Prime Minister and Council of Ministers (OPMCM)
+
+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.

bsad_converter-1.0.0/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: bsad-converter
+Version: 1.0.0
+Summary: Bikram Sambat (BS) <-> Gregorian (AD) date conversion and the Nepali calendar. Offline, zero-dependency, bilingual.
+Project-URL: Homepage, https://nepal.gov.np/calendar
+Author: Government of Nepal — OPMCM
+License-Expression: MIT
+License-File: LICENSE
+Keywords: bikram-sambat,calendar,converter,date,nepal,nepali,patro
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# bsad-converter (Python)
+
+Bikram Sambat <-> Gregorian conversion. `pip install bsad-converter`.
+
+```python
+import bsad_converter as p
+p.ad_to_bs(__import__("datetime").date(2026,6,25))["formatted_ne"]  # असार ११, २०८३ बि.सं.
+```

bsad_converter-1.0.0/README.md

@@ -0,0 +1,8 @@
+# bsad-converter (Python)
+
+Bikram Sambat <-> Gregorian conversion. `pip install bsad-converter`.
+
+```python
+import bsad_converter as p
+p.ad_to_bs(__import__("datetime").date(2026,6,25))["formatted_ne"]  # असार ११, २०८३ बि.सं.
+```

bsad_converter-1.0.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "bsad-converter"
+version = "1.0.0"
+description = "Bikram Sambat (BS) <-> Gregorian (AD) date conversion and the Nepali calendar. Offline, zero-dependency, bilingual."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+authors = [{ name = "Government of Nepal — OPMCM" }]
+keywords = ["nepali", "bikram-sambat", "date", "patro", "nepal", "calendar", "converter"]
+
+[project.scripts]
+bsad = "bsad_converter.cli:main"
+
+[project.urls]
+Homepage = "https://nepal.gov.np/calendar"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/bsad_converter"]

bsad_converter-1.0.0/src/bsad_converter/__init__.py

@@ -0,0 +1,9 @@
+"""bsad-converter — Bikram Sambat (BS) <-> Gregorian (AD) conversion + Nepali calendar.
+Offline, zero-dependency, bilingual. Verified medic/bikram-sambat data; 1970-2090 BS."""
+from ._core import (
+    ad_to_bs, bs_to_ad, today_bs, month_calendar, year_calendar,
+    DateConversionError, MIN_BS_YEAR, MAX_BS_YEAR, AD_MIN, AD_MAX, BS_MONTHS,
+)
+__all__ = ["ad_to_bs", "bs_to_ad", "today_bs", "month_calendar", "year_calendar",
+           "DateConversionError", "MIN_BS_YEAR", "MAX_BS_YEAR", "AD_MIN", "AD_MAX", "BS_MONTHS"]
+__version__ = "1.0.0"

bsad_converter-1.0.0/src/bsad_converter/_core.py

@@ -0,0 +1,309 @@
+"""Bikram Sambat (BS) ↔ Gregorian (AD) date conversion — sovereign, offline, no deps.
+
+Why this exists: NIHIS stores DOB in both AD and BS (`dob`, `dob_bs`) and the portal
+shows BS dates, but conversion was manual / display-only. This is the one shared,
+verified converter for both directions.
+
+Calendar data: per-BS-year month lengths, decoded from the **medic/bikram-sambat**
+dataset — the same verified source nepal.gov.np already uses (it agrees with the
+portal table; a third library, sharingapples/nepali-date, disagreed on 2081–2083 and
+was rejected). Epoch: 1 Baishakh 1970 BS = 13 April 1913 AD. Range: 1970–2090 BS.
+
+Verified 2026-06-24: every year's month-sum is plausible; Baishakh-1 anchors for
+2000/2080/2081/2082/2083 BS are exact against their known AD dates; a full round-trip
+over all 44,196 days in range is identity; today 24 Jun 2026 AD = 10 Asar 2083 BS.
+"""
+from __future__ import annotations
+
+from datetime import date, datetime, timedelta, timezone
+
+EPOCH_AD = date(1913, 4, 13)      # 1 Baishakh 1970 BS
+BS_YEAR_ZERO = 1970
+NPT = timezone(timedelta(hours=5, minutes=45))   # Asia/Kathmandu (no DST)
+
+MONTHS_EN = ["Baishakh", "Jestha", "Ashadh", "Shrawan", "Bhadra", "Ashwin",
+             "Kartik", "Mangsir", "Poush", "Magh", "Falgun", "Chaitra"]
+MONTHS_NE = ["बैशाख", "जेठ", "असार", "साउन", "भदौ", "असोज",
+             "कात्तिक", "मंसिर", "पुस", "माघ", "फागुन", "चैत"]
+WEEKDAYS_NE = ["सोमबार", "मंगलबार", "बुधबार", "बिहीबार", "शुक्रबार", "शनिबार", "आइतबार"]
+_NE_DIGITS = str.maketrans("0123456789", "०१२३४५६७८९")
+
+
+class DateConversionError(ValueError):
+    """Input date is malformed or outside the supported BS/AD range."""
+
+
+# Month lengths (days) per BS year. Source: medic/bikram-sambat (verified).
+BS_MONTHS: dict[int, list[int]] = {
+    1970: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    1971: [31, 31, 32, 31, 32, 30, 30, 29, 30, 29, 30, 30],
+    1972: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    1973: [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    1974: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    1975: [31, 31, 32, 32, 30, 31, 30, 29, 30, 29, 30, 30],
+    1976: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    1977: [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    1978: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    1979: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    1980: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    1981: [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+    1982: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    1983: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    1984: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    1985: [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+    1986: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    1987: [31, 32, 31, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    1988: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    1989: [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+    1990: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    1991: [31, 32, 31, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    1992: [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    1993: [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+    1994: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    1995: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 30],
+    1996: [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    1997: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    1998: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    1999: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2000: [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    2001: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2002: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2003: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2004: [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    2005: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2006: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2007: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2008: [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 29, 31],
+    2009: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2010: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2011: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2012: [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+    2013: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2014: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2015: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2016: [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+    2017: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2018: [31, 32, 31, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2019: [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    2020: [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+    2021: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2022: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 30],
+    2023: [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    2024: [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+    2025: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2026: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2027: [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    2028: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2029: [31, 31, 32, 31, 32, 30, 30, 29, 30, 29, 30, 30],
+    2030: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2031: [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    2032: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2033: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2034: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2035: [30, 32, 31, 32, 31, 31, 29, 30, 30, 29, 29, 31],
+    2036: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2037: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2038: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2039: [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+    2040: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2041: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2042: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2043: [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+    2044: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2045: [31, 32, 31, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2046: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2047: [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+    2048: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2049: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 30],
+    2050: [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    2051: [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+    2052: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2053: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 30],
+    2054: [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    2055: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2056: [31, 31, 32, 31, 32, 30, 30, 29, 30, 29, 30, 30],
+    2057: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2058: [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    2059: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2060: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2061: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2062: [30, 32, 31, 32, 31, 31, 29, 30, 29, 30, 29, 31],
+    2063: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2064: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2065: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2066: [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 29, 31],
+    2067: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2068: [31, 31, 32, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2069: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2070: [31, 31, 31, 32, 31, 31, 29, 30, 30, 29, 30, 30],
+    2071: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2072: [31, 32, 31, 32, 31, 30, 30, 29, 30, 29, 30, 30],
+    2073: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 31],
+    2074: [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+    2075: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2076: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 30],
+    2077: [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    2078: [31, 31, 31, 32, 31, 31, 30, 29, 30, 29, 30, 30],
+    2079: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2080: [31, 32, 31, 32, 31, 30, 30, 30, 29, 29, 30, 30],
+    2081: [31, 32, 31, 32, 31, 30, 30, 30, 29, 30, 29, 31],
+    2082: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2083: [31, 31, 32, 31, 31, 31, 30, 29, 30, 29, 30, 30],
+    2084: [31, 31, 32, 31, 31, 30, 30, 30, 29, 30, 30, 30],
+    2085: [31, 32, 31, 32, 30, 31, 30, 30, 29, 30, 30, 30],
+    2086: [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 30, 30],
+    2087: [31, 31, 32, 31, 31, 31, 30, 30, 29, 30, 30, 30],
+    2088: [30, 31, 32, 32, 30, 31, 30, 30, 29, 30, 30, 30],
+    2089: [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 30, 30],
+    2090: [30, 32, 31, 32, 31, 30, 30, 30, 29, 30, 30, 30],
+}
+
+MIN_BS_YEAR = min(BS_MONTHS)
+MAX_BS_YEAR = max(BS_MONTHS)
+
+# Precompute days from EPOCH to 1 Baishakh of each year (offsets), and the AD bounds.
+_CUM: dict[int, int] = {}
+_acc = 0
+for _y in range(BS_YEAR_ZERO, MAX_BS_YEAR + 1):
+    _CUM[_y] = _acc
+    _acc += sum(BS_MONTHS[_y])
+AD_MIN = EPOCH_AD
+AD_MAX = EPOCH_AD + timedelta(days=_acc - 1)
+
+
+def _ne_num(n: int | str) -> str:
+    return str(n).translate(_NE_DIGITS)
+
+
+def _bs_payload(y: int, m: int, d: int) -> dict:
+    return {
+        "year": y, "month": m, "day": d,
+        "month_en": MONTHS_EN[m - 1], "month_ne": MONTHS_NE[m - 1],
+        "iso": f"{y:04d}-{m:02d}-{d:02d}",
+        "formatted_en": f"{MONTHS_EN[m - 1]} {d}, {y} BS",
+        "formatted_ne": f"{MONTHS_NE[m - 1]} {_ne_num(d)}, {_ne_num(y)} बि.सं.",
+    }
+
+
+def ad_to_bs(d: date) -> dict:
+    """Gregorian date → Bikram Sambat (payload with both EN and NE formatting)."""
+    if not (AD_MIN <= d <= AD_MAX):
+        raise DateConversionError(f"AD {d.isoformat()} is outside supported range "
+                                  f"{AD_MIN.isoformat()}..{AD_MAX.isoformat()}")
+    days = (d - EPOCH_AD).days
+    y = BS_YEAR_ZERO
+    while y < MAX_BS_YEAR and _CUM[y + 1] <= days:
+        y += 1
+    days -= _CUM[y]
+    for m in range(12):
+        dim = BS_MONTHS[y][m]
+        if days < dim:
+            res = _bs_payload(y, m + 1, days + 1)
+            _wd = _weekday_sun0(d)
+            res["weekday_en"] = WEEKDAYS_EN_SUN[_wd]
+            res["weekday_ne"] = WEEKDAYS_NE_SUN[_wd]
+            res["events"] = _events_for(m + 1, days + 1, d)
+            return res
+        days -= dim
+    raise DateConversionError("internal conversion overflow")  # unreachable if table is sound
+
+
+def bs_to_ad(y: int, m: int, d: int) -> date:
+    """Bikram Sambat (year, month 1-12, day) → Gregorian date."""
+    if y not in BS_MONTHS:
+        raise DateConversionError(f"BS year {y} is outside supported range "
+                                  f"{MIN_BS_YEAR}..{MAX_BS_YEAR}")
+    if not 1 <= m <= 12:
+        raise DateConversionError(f"BS month {m} invalid (must be 1..12)")
+    dim = BS_MONTHS[y][m - 1]
+    if not 1 <= d <= dim:
+        raise DateConversionError(f"BS day {d} invalid for {y}-{m:02d} (this month has {dim} days)")
+    return EPOCH_AD + timedelta(days=_CUM[y] + sum(BS_MONTHS[y][:m - 1]) + (d - 1))
+
+
+def today_bs() -> dict:
+    """Today's date in Nepal (Asia/Kathmandu) as BS, with the AD date alongside."""
+    now = datetime.now(NPT).date()
+    bs = ad_to_bs(now)
+    bs["weekday_en"] = now.strftime("%A")
+    bs["weekday_ne"] = WEEKDAYS_NE[now.weekday()]
+    return {"ad": now.isoformat(), "bs": bs}
+
+
+# ── Calendar (month grid / full year) + known fixed national days ─────────────
+# Nepali calendars run Sunday-first. WEEKDAYS_NE above is Monday-first (matches
+# Python's date.weekday()); these are Sunday-indexed for grid layout.
+WEEKDAYS_EN_SUN = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]
+WEEKDAYS_NE_SUN = ["आइतबार", "सोमबार", "मंगलबार", "बुधबार", "बिहीबार", "शुक्रबार", "शनिबार"]
+
+
+def _weekday_sun0(d: date) -> int:
+    return (d.weekday() + 1) % 7   # Python Mon=0..Sun=6  ->  Sun=0..Sat=6
+
+
+# FIXED national days only — these recur on the SAME Bikram Sambat month/day (solar)
+# or the same Gregorian date every year, so they are safe to compute. Movable / lunar
+# festivals (Dashain, Tihar, Holi, Buddha Jayanti, Shivaratri, Eid, Lhosar, …) shift
+# each year and require the official Nepal Panchanga — they are deliberately NOT
+# guessed here. See EVENTS_NOTE.
+EVENTS_NOTE = ("Fixed national days only (recur on the same BS or AD date). Movable "
+               "lunar festivals (Dashain, Tihar, Holi, Buddha Jayanti, etc.) are not "
+               "included — they require the official Nepal Panchanga.")
+
+FIXED_EVENTS_BS: dict[tuple[int, int], list[dict]] = {
+    (1, 1):   [{"en": "Nepali New Year", "ne": "नयाँ वर्ष"}],
+    (2, 15):  [{"en": "Republic Day", "ne": "गणतन्त्र दिवस"}],
+    (6, 3):   [{"en": "Constitution Day", "ne": "संविधान दिवस"}],
+    (9, 27):  [{"en": "Prithvi Jayanti / National Unity Day", "ne": "पृथ्वी जयन्ती / राष्ट्रिय एकता दिवस"}],
+    (10, 1):  [{"en": "Maghe Sankranti", "ne": "माघे संक्रान्ति"}],
+    (10, 16): [{"en": "Martyrs' Day", "ne": "शहीद दिवस"}],
+    (11, 7):  [{"en": "Democracy Day", "ne": "प्रजातन्त्र दिवस"}],
+}
+FIXED_EVENTS_AD: dict[tuple[int, int], list[dict]] = {
+    (1, 1):   [{"en": "English New Year", "ne": "अंग्रेजी नयाँ वर्ष"}],
+    (3, 8):   [{"en": "International Women's Day", "ne": "अन्तर्राष्ट्रिय नारी दिवस"}],
+    (5, 1):   [{"en": "International Labour Day", "ne": "अन्तर्राष्ट्रिय श्रमिक दिवस"}],
+    (12, 25): [{"en": "Christmas", "ne": "क्रिसमस"}],
+}
+
+
+def _events_for(m: int, d: int, ad: date) -> list[dict]:
+    return FIXED_EVENTS_BS.get((m, d), []) + FIXED_EVENTS_AD.get((ad.month, ad.day), [])
+
+
+def month_calendar(y: int, m: int) -> dict:
+    """One BS month as a calendar: every day with its AD date, weekday (EN+NE) and
+    any fixed national-day events. `first_weekday` lets a UI offset the day-1 cell."""
+    if y not in BS_MONTHS:
+        raise DateConversionError(f"BS year {y} is outside supported range {MIN_BS_YEAR}..{MAX_BS_YEAR}")
+    if not 1 <= m <= 12:
+        raise DateConversionError(f"BS month {m} invalid (must be 1..12)")
+    n = BS_MONTHS[y][m - 1]
+    day_list: list[dict] = []
+    for d in range(1, n + 1):
+        ad = bs_to_ad(y, m, d)
+        w = _weekday_sun0(ad)
+        day_list.append({
+            "day": d, "day_ne": _ne_num(d), "ad": ad.isoformat(),
+            "weekday": w, "weekday_en": WEEKDAYS_EN_SUN[w], "weekday_ne": WEEKDAYS_NE_SUN[w],
+            "events": _events_for(m, d, ad),
+        })
+    first = day_list[0]
+    return {
+        "month": m, "month_en": MONTHS_EN[m - 1], "month_ne": MONTHS_NE[m - 1], "days": n,
+        "first_weekday": {"index": first["weekday"], "en": first["weekday_en"], "ne": first["weekday_ne"]},
+        "day_list": day_list,
+    }
+
+
+def year_calendar(y: int) -> dict:
+    """A full BS year — all 12 months, each a `month_calendar`."""
+    if y not in BS_MONTHS:
+        raise DateConversionError(f"BS year {y} is outside supported range {MIN_BS_YEAR}..{MAX_BS_YEAR}")
+    return {
+        "bs_year": y, "bs_year_ne": _ne_num(y),
+        "total_days": sum(BS_MONTHS[y]),
+        "weekday_header_en": WEEKDAYS_EN_SUN, "weekday_header_ne": WEEKDAYS_NE_SUN,
+        "events_note": EVENTS_NOTE,
+        "months": [month_calendar(y, m) for m in range(1, 13)],
+    }

bsad_converter-1.0.0/src/bsad_converter/cli.py

@@ -0,0 +1,28 @@
+"""CLI: bsad today | ad2bs YYYY-MM-DD | bs2ad YYYY-MM-DD [--en]"""
+import sys
+from datetime import date
+from . import ad_to_bs, bs_to_ad, today_bs, DateConversionError
+
+def main(argv=None):
+    argv = list(sys.argv[1:] if argv is None else argv)
+    en = "--en" in argv
+    pos = [a for a in argv if not a.startswith("--")]
+    cmd = (pos[0] if pos else "today").lower()
+    try:
+        if cmd == "today":
+            t = today_bs()["bs"]; print(t["formatted_en"] if en else t["formatted_ne"])
+        elif cmd == "ad2bs":
+            d = date.fromisoformat(pos[1]); b = ad_to_bs(d)
+            print(b["formatted_en"] if en else b["formatted_ne"])
+        elif cmd == "bs2ad":
+            y, m, dd = (int(x) for x in pos[1].split("-")); print(bs_to_ad(y, m, dd).isoformat())
+        elif cmd in ("help", "--help"):
+            print("bsad today | ad2bs YYYY-MM-DD | bs2ad YYYY-MM-DD  [--en]")
+        else:
+            print(f"unknown command '{cmd}'", file=sys.stderr); return 1
+    except (IndexError, ValueError, DateConversionError) as e:
+        print(f"error: {e}", file=sys.stderr); return 1
+    return 0
+
+if __name__ == "__main__":
+    raise SystemExit(main())

bsad_converter-1.0.0/tests/test_patro.py

@@ -0,0 +1,27 @@
+from datetime import date, timedelta
+import bsad_converter as p
+import pytest
+
+def test_anchors():
+    assert p.bs_to_ad(2000, 1, 1).isoformat() == "1943-04-14"
+    assert p.bs_to_ad(2080, 1, 1).isoformat() == "2023-04-14"
+    assert p.bs_to_ad(2083, 1, 1).isoformat() == "2026-04-14"
+    assert p.ad_to_bs(date(2026, 4, 14))["iso"] == "2083-01-01"
+
+def test_format_events():
+    bs = p.ad_to_bs(date(2026, 6, 25))
+    assert bs["formatted_en"] == "Ashadh 11, 2083 BS"
+    assert bs["formatted_ne"] == "असार ११, २०८३ बि.सं."
+    assert p.ad_to_bs(date(2026, 4, 14))["events"] == [{"en": "Nepali New Year", "ne": "नयाँ वर्ष"}]
+
+def test_round_trip():
+    d, end, n = date(1913, 4, 13), date(2034, 4, 13), 0
+    while d <= end:
+        bs = p.ad_to_bs(d)
+        assert p.bs_to_ad(bs["year"], bs["month"], bs["day"]) == d
+        d += timedelta(days=1); n += 1
+    assert n > 40000
+
+def test_validation():
+    with pytest.raises(p.DateConversionError): p.ad_to_bs(date(2099, 1, 1))
+    with pytest.raises(p.DateConversionError): p.bs_to_ad(2083, 13, 1)