[convertdate] Add stubs (#14646)

Author: donbarbos

stubs/convertdate/METADATA.toml

@@ -0,0 +1,2 @@
+version = "2.4.*"
+upstream_repository = "https://github.com/fitnr/convertdate"

stubs/convertdate/convertdate/__init__.pyi

@@ -0,0 +1,48 @@
+from typing import Final
+
+from . import (
+    armenian as armenian,
+    bahai as bahai,
+    coptic as coptic,
+    daycount as daycount,
+    dublin as dublin,
+    french_republican as french_republican,
+    gregorian as gregorian,
+    hebrew as hebrew,
+    holidays as holidays,
+    indian_civil as indian_civil,
+    islamic as islamic,
+    iso as iso,
+    julian as julian,
+    julianday as julianday,
+    mayan as mayan,
+    ordinal as ordinal,
+    persian as persian,
+    positivist as positivist,
+    utils as utils,
+)
+
+__version__: Final[str]
+
+__all__ = [
+    "holidays",
+    "armenian",
+    "bahai",
+    "coptic",
+    "dublin",
+    "daycount",
+    "french_republican",
+    "gregorian",
+    "hebrew",
+    "indian_civil",
+    "islamic",
+    "iso",
+    "julian",
+    "julianday",
+    "mayan",
+    "persian",
+    "positivist",
+    "mayan",
+    "ordinal",
+    "utils",
+]

stubs/convertdate/convertdate/armenian.pyi

@@ -0,0 +1,24 @@
+from typing import Final, Literal
+
+EPOCH: Final = 1922501.5
+EPOCH_SARKAWAG: Final = 2117210.5
+MONTHS: Final[list[str]]
+MONTHS_ARM: Final[list[str]]
+
+def leap(year: int) -> bool: ...
+def to_jd(year: int, month: int, day: int, method: Literal["sarkawag", "moveable"] | None = None) -> float: ...
+def from_jd(jd: float, method: Literal["sarkawag", "moveable"] | None = None) -> tuple[int, int, int]: ...
+def to_julian(year: int, month: int, day: int, method: Literal["sarkawag", "moveable"] | None = None) -> tuple[int, int, int]: ...
+def from_julian(
+    year: int, month: int, day: int, method: Literal["sarkawag", "moveable"] | None = None
+) -> tuple[int, int, int]: ...
+def to_gregorian(
+    year: int, month: int, day: int, method: Literal["sarkawag", "moveable"] | None = None
+) -> tuple[int, int, int]: ...
+def from_gregorian(
+    year: int, month: int, day: int, method: Literal["sarkawag", "moveable"] | None = None
+) -> tuple[int, int, int]: ...
+def month_length(year: int, month: int, method: Literal["sarkawag", "moveable"] | None = None) -> Literal[5, 6, 30]: ...
+def monthcalendar(year: int, month: int, method: Literal["sarkawag", "moveable"] | None = None) -> list[list[int | None]]: ...
+def format(year: int, month: int, day: int, lang: str | None = None) -> str: ...
+def tostring(year: int, month: int, day: int, lang: str | None = None) -> str: ...

stubs/convertdate/convertdate/bahai.pyi

@@ -0,0 +1,37 @@
+from typing import Final
+
+EPOCH: Final = 2394646.5
+EPOCH_GREGORIAN_YEAR: Final = 1844
+TEHRAN: Final = 51.4215, 35.6944
+WEEKDAYS: Final = ("Jamál", "Kamál", "Fidál", "Idál", "Istijlál", "Istiqlál", "Jalál")
+MONTHS: Final[tuple[str, ...]]
+ENGLISH_MONTHS: Final[tuple[str, ...]]
+BAHA: Final = 1
+JALAL: Final = 2
+JAMAL: Final = 3
+AZAMAT: Final = 4
+NUR: Final = 5
+RAHMAT: Final = 6
+KALIMAT: Final = 7
+KAMAL: Final = 8
+ASMA: Final = 9
+IZZAT: Final = 10
+MASHIYYAT: Final = 11
+ILM: Final = 12
+QUDRAT: Final = 13
+QAWL: Final = 14
+MASAIL: Final = 15
+SHARAF: Final = 16
+SULTAN: Final = 17
+MULK: Final = 18
+AYYAMIHA: Final = 19
+ALA: Final = 20
+
+def gregorian_nawruz(year: int) -> tuple[int, int]: ...
+def to_jd(year: int, month: int, day: int) -> float: ...
+def from_jd(jd: float) -> tuple[int, int, int]: ...
+def from_gregorian(year: int, month: int, day: int) -> tuple[int, int, int]: ...
+def to_gregorian(year: int, month: int, day: int) -> tuple[int, int, int]: ...
+def month_length(year: int, month: int) -> int: ...
+def monthcalendar(year: int, month: int) -> list[list[int | None]]: ...
+def format(year: int, month: int, day: int, lang: str | None = None) -> str: ...

stubs/convertdate/convertdate/coptic.pyi

@@ -0,0 +1,14 @@
+from typing import Final, Literal
+
+EPOCH: Final = 1825029.5
+MONTHS: Final[list[str]]
+WEEKDAYS: Final = ["Tkyriaka", "Pesnau", "Pshoment", "Peftoou", "Ptiou", "Psoou", "Psabbaton"]
+
+def is_leap(year: int) -> bool: ...
+def to_jd(year: int, month: int, day: int) -> float: ...
+def from_jd(jdc: float) -> tuple[int, int, int]: ...
+def to_gregorian(year: int, month: int, day: int) -> tuple[int, int, int]: ...
+def from_gregorian(year: int, month: int, day: int) -> tuple[int, int, int]: ...
+def month_length(year: int, month: int) -> Literal[5, 6, 30]: ...
+def monthcalendar(year: int, month: int) -> list[list[int | None]]: ...
+def format(year: int, month: int, day: int) -> str: ...

stubs/convertdate/convertdate/data/__init__.pyi

@@ -0,0 +1,3 @@
+from typing import Final
+
+french_republican_days: Final[dict[int, list[str]]]

stubs/convertdate/convertdate/data/french_republican_days.pyi

@@ -0,0 +1,6 @@
+from typing import Final
+
+DAY_NAMES: Final[tuple[str, ...]]
+leap_day_replacements: Final[dict[int, str]]
+DAY_NAMES_LEAP: Final[list[str]]
+FESTIVALS: Final[dict[tuple[int, int], str]]

stubs/convertdate/convertdate/data/positivist.pyi

@@ -0,0 +1,13 @@
+import datetime
+
+class DayCount:
+    epoch: float
+    def __init__(self, epoch: float) -> None: ...
+    def to_gregorian(self, dc: int) -> tuple[int, int, int]: ...
+    def from_gregorian(self, year: int, month: int, day: int) -> float: ...
+    def to_jd(self, dc: int) -> float: ...
+    def from_jd(self, jdc: float) -> float: ...
+    def from_julian(self, year: int, month: int, day: int) -> float: ...
+    def to_julian(self, dc: int) -> tuple[int, int, int]: ...
+    def to_datetime(self, dc: int) -> datetime.datetime: ...
+    def from_datetime(self, date: datetime.datetime) -> float: ...

stubs/convertdate/convertdate/daycount.pyi

@@ -0,0 +1,13 @@
+import datetime
+from typing import Final
+
+EPOCH: Final = 2415020
+
+def to_gregorian(dc: int) -> tuple[int, int, int]: ...
+def from_gregorian(year: int, month: int, day: int) -> float: ...
+def to_jd(dc: int) -> float: ...
+def from_jd(jdc: float) -> float: ...
+def from_julian(year: int, month: int, day: int) -> float: ...
+def to_julian(dc: int) -> tuple[int, int, int]: ...
+def to_datetime(dc: int) -> datetime.datetime: ...
+def from_datetime(date: datetime.datetime) -> float: ...