satnogs-predict 1.1__tar.gz → 1.2__tar.gz

{satnogs_predict-1.1 → satnogs_predict-1.2}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.2
+
+### Added
+
+- `generate_fake_tle()` encodes catalog numbers 100000–339999 in Alpha-5 format.
+
+### Fixed
+
+- `generate_fake_tle()` raises `ValueError` for catalog numbers outside 0–339999. Previously 6-digit numbers were silently truncated to their first five digits.
+
+## 1.1
+
+### Fixed
+
+- `generate_fake_tle()` writes the epoch year as the last two digits of the year. Previously it used the first two digits (e.g. `20` for 2026), so every generated TLE had an epoch in 2020.
+
 ## 1.0
 
 ### Breaking Changes

{satnogs_predict-1.1 → satnogs_predict-1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: satnogs-predict
-Version: 1.1
+Version: 1.2
 Summary: A package for calculating passes and observation windows for satellites.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{satnogs_predict-1.1 → satnogs_predict-1.2}/src/satnogs_predict/tle.py

@@ -29,6 +29,19 @@ class FakeTLEParameters:
 
 DEFAULT_FAKE_TLE_PARAMETERS = FakeTLEParameters()
 
+# Alpha-5 prefix letters for 10..33; I and O are skipped to avoid confusion with 1 and 0.
+_ALPHA5_LETTERS = "ABCDEFGHJKLMNPQRSTUVWXYZ"
+_MAX_ALPHA5_CATALOG_NUM = 339_999
+
+
+def _format_catalog_number(catalog_num: int) -> str:
+    if 0 <= catalog_num <= 99_999:
+        return f"{catalog_num:05d}"
+    if 100_000 <= catalog_num <= _MAX_ALPHA5_CATALOG_NUM:
+        prefix, remainder = divmod(catalog_num, 10_000)
+        return f"{_ALPHA5_LETTERS[prefix - 10]}{remainder:04d}"
+    raise ValueError(f"catalog_num must be between 0 and {_MAX_ALPHA5_CATALOG_NUM}")
+
 
 def _tle_checksum(line_without_checksum: str) -> int:
     total = 0
@@ -71,6 +84,7 @@ def generate_fake_tle(
     right_ascension = (observer_location.lst_hours_at(skyfield_time) * 15.0) % 360.0
     mean_anomaly = latitude % 360.0
 
+    catalog_number = _format_catalog_number(params.catalog_num)
     epoch_year = epoch.year % 100
     epoch_day = _epoch_day_of_year_fraction(epoch)
 
@@ -78,7 +92,7 @@ def generate_fake_tle(
 
     line1_no_checksum = (
         "1 {:5.5}{:.1} {:8.8} {:02d}{:012.8f} {:>10.10} {:>8.8} {:>8.8} 0 {:>4.4}".format(
-            f"{params.catalog_num:05d}",
+            catalog_number,
             params.classifier,
             params.cospar_id,
             epoch_year,
@@ -92,7 +106,7 @@ def generate_fake_tle(
 
     line2_no_checksum = (
         "2 {:>5.5} {:>8.8} {:>8.4f} {:>7.7} {:>8.8} {:>8.4f} {:>11.11}{:>5.5}".format(
-            f"{params.catalog_num:05d}",
+            catalog_number,
             params.inclination,
             right_ascension,
             params.eccentricity,

{satnogs_predict-1.1 → satnogs_predict-1.2}/src/satnogs_predict.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: satnogs-predict
-Version: 1.1
+Version: 1.2
 Summary: A package for calculating passes and observation windows for satellites.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

satnogs_predict-1.2/src/satnogs_predict.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "1.2",
+  "distance": 0,
+  "node": "g536f81b75ea7f5aed4ff17646823a9e6a9aa2c9a",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-10-23"
+}

{satnogs_predict-1.1 → satnogs_predict-1.2}/tests/test_tle.py

@@ -6,6 +6,7 @@ import pytest
 from skyfield.api import EarthSatellite, load  # type: ignore[import-untyped]
 
 from satnogs_predict import generate_fake_tle
+from satnogs_predict.tle import FakeTLEParameters
 
 ts = load.timescale()
 
@@ -71,3 +72,43 @@ class TestGenerateFakeTle:
                 longitude=0.0,
                 date=datetime(2026, 3, 6, 12, 0, 0),
             )
+
+    @pytest.mark.parametrize(
+        ("catalog_num", "expected_field"),
+        [
+            (0, "00000"),
+            (25544, "25544"),
+            (99999, "99999"),
+            (100000, "A0000"),
+            (148493, "E8493"),
+            (182345, "J2345"),
+            (234567, "P4567"),
+            (339999, "Z9999"),
+        ],
+    )
+    def test_given_catalog_num_when_generated_then_encodes_alpha5(
+        self, catalog_num: int, expected_field: str
+    ) -> None:
+        tle = generate_fake_tle(
+            latitude=0.0,
+            longitude=0.0,
+            date=datetime(2026, 3, 6, 12, 0, 0, tzinfo=timezone.utc),
+            params=FakeTLEParameters(catalog_num=catalog_num),
+        )
+
+        assert tle.line1[2:7] == expected_field
+        assert tle.line2[2:7] == expected_field
+        sat = EarthSatellite(tle.line1, tle.line2, tle.line0, ts)
+        assert sat.model.satnum == catalog_num
+
+    @pytest.mark.parametrize("catalog_num", [-1, 340000, 1000000])
+    def test_given_out_of_range_catalog_num_when_generated_then_raises(
+        self, catalog_num: int
+    ) -> None:
+        with pytest.raises(ValueError, match="catalog_num"):
+            generate_fake_tle(
+                latitude=0.0,
+                longitude=0.0,
+                date=datetime(2026, 3, 6, 12, 0, 0, tzinfo=timezone.utc),
+                params=FakeTLEParameters(catalog_num=catalog_num),
+            )

satnogs_predict-1.1/src/satnogs_predict.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "1.1",
-  "distance": 0,
-  "node": "gc483a54c922a0e8c97e89fa9fd0c1dc4190ffd17",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-10-01"
-}