todayjuliandate 0.1.0__tar.gz

todayjuliandate-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ordinal Date Notes
+
+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.

todayjuliandate-0.1.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: todayjuliandate
+Version: 0.1.0
+Summary: Today's Julian date helpers: YYDDD / CYYDDD ordinal lot codes, Julian Day (JD), and MJD converters.
+Author: Ordinal Date Notes
+License-Expression: MIT
+Project-URL: Homepage, https://todayjuliandate.com/
+Project-URL: Documentation, https://todayjuliandate.com/code/
+Project-URL: Live converter, https://todayjuliandate.com/
+Keywords: julian-date,todays-julian-date,ordinal-date,yyddd,cyyddd,mjd,lot-code
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# todayjuliandate
+
+Helpers for **today's Julian date** and related ordinal lot codes: YYDDD, CYYDDD, Julian Day (JD), and Modified Julian Day (MJD).
+
+Companion library for [todayjuliandate.com](https://todayjuliandate.com/) — converters and code samples for egg-carton / food-lot stamps and calendar math.
+
+## Install
+
+```bash
+pip install todayjuliandate
+```
+
+## Quick use
+
+```python
+from datetime import date
+from todayjuliandate import to_yyddd, from_yyddd, to_cyyddd, julian_day, mjd
+
+d = date(2024, 7, 1)
+print(to_yyddd(d))      # "24183"
+print(from_yyddd("24183"))
+print(to_cyyddd(d))     # "2024183"
+print(julian_day(d))
+print(mjd(d))
+```
+
+CLI:
+
+```bash
+todayjuliandate 2024-07-01
+todayjuliandate --from-yyddd 24183
+```
+
+## Sources
+
+- [USNO Julian Date](https://aa.usno.navy.mil/data/JulianDate) — astronomical JD definitions
+- [todayjuliandate.com](https://todayjuliandate.com/) — today's Julian date converter and code
+- [NIST time and frequency](https://www.nist.gov/pml/time-and-frequency-division) — civil time context
+
+## License
+
+MIT

todayjuliandate-0.1.0/README.md

@@ -0,0 +1,42 @@
+# todayjuliandate
+
+Helpers for **today's Julian date** and related ordinal lot codes: YYDDD, CYYDDD, Julian Day (JD), and Modified Julian Day (MJD).
+
+Companion library for [todayjuliandate.com](https://todayjuliandate.com/) — converters and code samples for egg-carton / food-lot stamps and calendar math.
+
+## Install
+
+```bash
+pip install todayjuliandate
+```
+
+## Quick use
+
+```python
+from datetime import date
+from todayjuliandate import to_yyddd, from_yyddd, to_cyyddd, julian_day, mjd
+
+d = date(2024, 7, 1)
+print(to_yyddd(d))      # "24183"
+print(from_yyddd("24183"))
+print(to_cyyddd(d))     # "2024183"
+print(julian_day(d))
+print(mjd(d))
+```
+
+CLI:
+
+```bash
+todayjuliandate 2024-07-01
+todayjuliandate --from-yyddd 24183
+```
+
+## Sources
+
+- [USNO Julian Date](https://aa.usno.navy.mil/data/JulianDate) — astronomical JD definitions
+- [todayjuliandate.com](https://todayjuliandate.com/) — today's Julian date converter and code
+- [NIST time and frequency](https://www.nist.gov/pml/time-and-frequency-division) — civil time context
+
+## License
+
+MIT

todayjuliandate-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "todayjuliandate"
+version = "0.1.0"
+description = "Today's Julian date helpers: YYDDD / CYYDDD ordinal lot codes, Julian Day (JD), and MJD converters."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [{ name = "Ordinal Date Notes" }]
+keywords = ["julian-date", "todays-julian-date", "ordinal-date", "yyddd", "cyyddd", "mjd", "lot-code"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Topic :: Software Development :: Libraries",
+  "Topic :: Scientific/Engineering",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://todayjuliandate.com/"
+Documentation = "https://todayjuliandate.com/code/"
+"Live converter" = "https://todayjuliandate.com/"
+
+[project.scripts]
+todayjuliandate = "todayjuliandate.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

todayjuliandate-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

todayjuliandate-0.1.0/src/todayjuliandate/__init__.py

@@ -0,0 +1,99 @@
+"""Ordinal / Julian lot-code helpers (YYDDD, CYYDDD) and JD/MJD."""
+from __future__ import annotations
+
+from datetime import date, datetime, timezone
+from typing import Union
+
+DateLike = Union[date, datetime]
+
+__all__ = [
+    "to_yyddd",
+    "from_yyddd",
+    "to_cyyddd",
+    "from_cyyddd",
+    "julian_day",
+    "mjd",
+    "__version__",
+]
+
+__version__ = "0.1.0"
+
+
+def _as_date(value: DateLike) -> date:
+    if isinstance(value, datetime):
+        return value.date()
+    if isinstance(value, date):
+        return value
+    raise TypeError("expected datetime.date or datetime.datetime")
+
+
+def to_yyddd(value: DateLike) -> str:
+    """Return YYDDD lot code (2-digit year + day-of-year, zero-padded)."""
+    d = _as_date(value)
+    return f"{d.year % 100:02d}{d.timetuple().tm_yday:03d}"
+
+
+def from_yyddd(code: str, *, century: int | None = None) -> date:
+    """Parse YYDDD into a date.
+
+    If ``century`` is omitted, years 00–69 map to 2000–2069 and 70–99 to 1970–1999
+    (common manufacturing default). Pass ``century`` as 1900 or 2000 to force it.
+    """
+    s = str(code).strip()
+    if len(s) != 5 or not s.isdigit():
+        raise ValueError("YYDDD must be exactly 5 digits")
+    yy, doy = int(s[:2]), int(s[2:])
+    if not 1 <= doy <= 366:
+        raise ValueError("day-of-year out of range")
+    if century is None:
+        year = 2000 + yy if yy < 70 else 1900 + yy
+    else:
+        year = century + yy
+    # Validate doy against the year (handles leap)
+    try:
+        return date.fromordinal(date(year, 1, 1).toordinal() + doy - 1)
+    except ValueError as e:
+        raise ValueError(f"invalid YYDDD for year {year}") from e
+
+
+def to_cyyddd(value: DateLike) -> str:
+    """Return CYYDDD (4-digit year + day-of-year)."""
+    d = _as_date(value)
+    return f"{d.year:04d}{d.timetuple().tm_yday:03d}"
+
+
+def from_cyyddd(code: str) -> date:
+    """Parse CYYDDD (YYYYDDD) into a date."""
+    s = str(code).strip()
+    if len(s) != 7 or not s.isdigit():
+        raise ValueError("CYYDDD must be exactly 7 digits")
+    year, doy = int(s[:4]), int(s[4:])
+    if not 1 <= doy <= 366:
+        raise ValueError("day-of-year out of range")
+    try:
+        return date.fromordinal(date(year, 1, 1).toordinal() + doy - 1)
+    except ValueError as e:
+        raise ValueError(f"invalid CYYDDD for year {year}") from e
+
+
+def julian_day(value: DateLike) -> float:
+    """Astronomical Julian Day number at 0h UTC for the civil date.
+
+    Uses the standard Fliegel–Van Flandern / USNO civil-to-JD algorithm for
+    the Gregorian calendar (noon-based JD; this returns the JD for 00:00 UTC,
+    i.e. JD at previous noon + 0.5).
+    """
+    d = _as_date(value)
+    y, m, day = d.year, d.month, d.day
+    # Algorithm for JD at 0h UT (Gregorian)
+    a = (14 - m) // 12
+    y2 = y + 4800 - a
+    m2 = m + 12 * a - 3
+    jdn = day + (153 * m2 + 2) // 5 + 365 * y2 + y2 // 4 - y2 // 100 + y2 // 400 - 32045
+    # jdn is Julian Day Number at noon; for 0h UT subtract 0.5
+    return float(jdn) - 0.5
+
+
+def mjd(value: DateLike) -> float:
+    """Modified Julian Day (JD − 2400000.5) at 0h UTC."""
+    return julian_day(value) - 2400000.5

todayjuliandate-0.1.0/src/todayjuliandate/cli.py

@@ -0,0 +1,34 @@
+"""Minimal CLI for yyddd."""
+from __future__ import annotations
+
+import argparse
+from datetime import date
+
+from todayjuliandate import from_cyyddd, from_yyddd, julian_day, mjd, to_cyyddd, to_yyddd
+
+
+def main(argv: list[str] | None = None) -> int:
+    p = argparse.ArgumentParser(prog="todayjuliandate", description="Ordinal / Julian lot-code converter")
+    g = p.add_mutually_exclusive_group(required=True)
+    g.add_argument("iso_date", nargs="?", help="Gregorian date YYYY-MM-DD")
+    g.add_argument("--from-yyddd", dest="yyddd", help="5-digit YYDDD code")
+    g.add_argument("--from-cyyddd", dest="cyyddd", help="7-digit CYYDDD code")
+    args = p.parse_args(argv)
+
+    if args.yyddd:
+        d = from_yyddd(args.yyddd)
+    elif args.cyyddd:
+        d = from_cyyddd(args.cyyddd)
+    else:
+        d = date.fromisoformat(args.iso_date)
+
+    print(f"date:    {d.isoformat()}")
+    print(f"YYDDD:   {to_yyddd(d)}")
+    print(f"CYYDDD:  {to_cyyddd(d)}")
+    print(f"JD:      {julian_day(d)}")
+    print(f"MJD:     {mjd(d)}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

todayjuliandate-0.1.0/src/todayjuliandate.egg-info/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: todayjuliandate
+Version: 0.1.0
+Summary: Today's Julian date helpers: YYDDD / CYYDDD ordinal lot codes, Julian Day (JD), and MJD converters.
+Author: Ordinal Date Notes
+License-Expression: MIT
+Project-URL: Homepage, https://todayjuliandate.com/
+Project-URL: Documentation, https://todayjuliandate.com/code/
+Project-URL: Live converter, https://todayjuliandate.com/
+Keywords: julian-date,todays-julian-date,ordinal-date,yyddd,cyyddd,mjd,lot-code
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# todayjuliandate
+
+Helpers for **today's Julian date** and related ordinal lot codes: YYDDD, CYYDDD, Julian Day (JD), and Modified Julian Day (MJD).
+
+Companion library for [todayjuliandate.com](https://todayjuliandate.com/) — converters and code samples for egg-carton / food-lot stamps and calendar math.
+
+## Install
+
+```bash
+pip install todayjuliandate
+```
+
+## Quick use
+
+```python
+from datetime import date
+from todayjuliandate import to_yyddd, from_yyddd, to_cyyddd, julian_day, mjd
+
+d = date(2024, 7, 1)
+print(to_yyddd(d))      # "24183"
+print(from_yyddd("24183"))
+print(to_cyyddd(d))     # "2024183"
+print(julian_day(d))
+print(mjd(d))
+```
+
+CLI:
+
+```bash
+todayjuliandate 2024-07-01
+todayjuliandate --from-yyddd 24183
+```
+
+## Sources
+
+- [USNO Julian Date](https://aa.usno.navy.mil/data/JulianDate) — astronomical JD definitions
+- [todayjuliandate.com](https://todayjuliandate.com/) — today's Julian date converter and code
+- [NIST time and frequency](https://www.nist.gov/pml/time-and-frequency-division) — civil time context
+
+## License
+
+MIT

todayjuliandate-0.1.0/src/todayjuliandate.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/todayjuliandate/__init__.py
+src/todayjuliandate/cli.py
+src/todayjuliandate.egg-info/PKG-INFO
+src/todayjuliandate.egg-info/SOURCES.txt
+src/todayjuliandate.egg-info/dependency_links.txt
+src/todayjuliandate.egg-info/entry_points.txt
+src/todayjuliandate.egg-info/top_level.txt
+tests/test_todayjuliandate.py

todayjuliandate-0.1.0/src/todayjuliandate.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

todayjuliandate-0.1.0/src/todayjuliandate.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+todayjuliandate = todayjuliandate.cli:main

todayjuliandate-0.1.0/src/todayjuliandate.egg-info/top_level.txt

@@ -0,0 +1 @@
+todayjuliandate

todayjuliandate-0.1.0/tests/test_todayjuliandate.py

@@ -0,0 +1,16 @@
+from datetime import date
+from todayjuliandate import from_cyyddd, from_yyddd, julian_day, mjd, to_cyyddd, to_yyddd
+
+def test_yyddd_roundtrip():
+    d = date(2024, 7, 1)
+    assert to_yyddd(d) == "24183"
+    assert from_yyddd("24183") == d
+
+def test_cyyddd():
+    d = date(2024, 1, 1)
+    assert to_cyyddd(d) == "2024001"
+    assert from_cyyddd("2024001") == d
+
+def test_jd_known():
+    assert julian_day(date(2000, 1, 1)) == 2451544.5
+    assert mjd(date(2000, 1, 1)) == 51544.0