timezonefinder-data 1.2026.3__py3-none-any.whl

timezonefinder_data/__init__.py

@@ -0,0 +1,32 @@
+"""The timezone boundary data ``timezonefinder`` answers lookups from.
+
+This distribution exists to give the ~63 MB dataset a release cadence of its own:
+an upstream boundary release ships as a new ``timezonefinder-data`` without a
+``timezonefinder`` release, and a user who needs the answers of a particular
+dataset can pin it without giving up code fixes.
+"""
+
+from importlib.metadata import PackageNotFoundError, version as _metadata_version
+from pathlib import Path
+
+# The packaged data directory. A real filesystem path rather than an
+# ``importlib.resources`` traversable, because ``FileCoordAccessor`` memory-maps the
+# coordinate files via ``fileno()`` - which is also why the data ships inside an
+# importable package instead of as bare package data.
+DATA_DIR: Path = Path(__file__).parent / "data"
+
+# The installed distribution's version, read the way ``timezonefinder.__version__``
+# reads its own: from the installed metadata rather than a hand-maintained constant,
+# which drifts from what is actually installed. A bug report wants both numbers, and
+# only the pair says which dataset answered. ``PackageNotFoundError`` bites when the
+# package is imported without being installed (a source checkout with no metadata),
+# where "unknown" is honest.
+try:
+    __version__ = _metadata_version("timezonefinder-data")
+except PackageNotFoundError:  # pragma: no cover - source checkout without install
+    __version__ = "unknown"
+
+__all__ = (
+    "DATA_DIR",
+    "__version__",
+)

timezonefinder_data/data/data_version.txt

@@ -0,0 +1 @@
+2026c

timezonefinder_data/data/hole_registry.json

@@ -0,0 +1,390 @@
+{
+  "1165": [
+    2,
+    270
+  ],
+  "1184": [
+    15,
+    272
+  ],
+  "1188": [
+    44,
+    287
+  ],
+  "1191": [
+    2,
+    331
+  ],
+  "1192": [
+    37,
+    333
+  ],
+  "1193": [
+    20,
+    370
+  ],
+  "1196": [
+    1,
+    390
+  ],
+  "1199": [
+    28,
+    391
+  ],
+  "1200": [
+    3,
+    419
+  ],
+  "1204": [
+    1,
+    422
+  ],
+  "1205": [
+    16,
+    423
+  ],
+  "1208": [
+    4,
+    439
+  ],
+  "1212": [
+    2,
+    443
+  ],
+  "1214": [
+    1,
+    445
+  ],
+  "1217": [
+    2,
+    446
+  ],
+  "1218": [
+    5,
+    448
+  ],
+  "1219": [
+    3,
+    453
+  ],
+  "1220": [
+    14,
+    456
+  ],
+  "1226": [
+    12,
+    470
+  ],
+  "1227": [
+    6,
+    482
+  ],
+  "1230": [
+    1,
+    488
+  ],
+  "1234": [
+    1,
+    489
+  ],
+  "1236": [
+    7,
+    490
+  ],
+  "1241": [
+    21,
+    497
+  ],
+  "1246": [
+    3,
+    518
+  ],
+  "1255": [
+    1,
+    521
+  ],
+  "1258": [
+    5,
+    522
+  ],
+  "1265": [
+    2,
+    527
+  ],
+  "1269": [
+    1,
+    529
+  ],
+  "1271": [
+    2,
+    530
+  ],
+  "1274": [
+    2,
+    532
+  ],
+  "1275": [
+    4,
+    534
+  ],
+  "1277": [
+    13,
+    538
+  ],
+  "1279": [
+    17,
+    551
+  ],
+  "1282": [
+    2,
+    568
+  ],
+  "1284": [
+    1,
+    570
+  ],
+  "1285": [
+    11,
+    571
+  ],
+  "1289": [
+    2,
+    582
+  ],
+  "1293": [
+    13,
+    584
+  ],
+  "1294": [
+    1,
+    597
+  ],
+  "1295": [
+    4,
+    598
+  ],
+  "1298": [
+    6,
+    602
+  ],
+  "1299": [
+    14,
+    608
+  ],
+  "1303": [
+    4,
+    622
+  ],
+  "1306": [
+    4,
+    626
+  ],
+  "1310": [
+    32,
+    630
+  ],
+  "1314": [
+    34,
+    662
+  ],
+  "1317": [
+    37,
+    696
+  ],
+  "1320": [
+    22,
+    733
+  ],
+  "1321": [
+    1,
+    755
+  ],
+  "16": [
+    4,
+    0
+  ],
+  "196": [
+    95,
+    19
+  ],
+  "248": [
+    1,
+    114
+  ],
+  "259": [
+    2,
+    115
+  ],
+  "26": [
+    1,
+    4
+  ],
+  "262": [
+    2,
+    117
+  ],
+  "280": [
+    1,
+    119
+  ],
+  "290": [
+    1,
+    120
+  ],
+  "291": [
+    3,
+    121
+  ],
+  "300": [
+    1,
+    124
+  ],
+  "33": [
+    1,
+    5
+  ],
+  "335": [
+    1,
+    125
+  ],
+  "358": [
+    1,
+    126
+  ],
+  "360": [
+    2,
+    127
+  ],
+  "370": [
+    1,
+    129
+  ],
+  "385": [
+    1,
+    130
+  ],
+  "406": [
+    1,
+    131
+  ],
+  "455": [
+    1,
+    132
+  ],
+  "457": [
+    3,
+    133
+  ],
+  "461": [
+    1,
+    136
+  ],
+  "471": [
+    1,
+    137
+  ],
+  "483": [
+    1,
+    138
+  ],
+  "497": [
+    19,
+    139
+  ],
+  "50": [
+    2,
+    6
+  ],
+  "509": [
+    2,
+    158
+  ],
+  "529": [
+    1,
+    160
+  ],
+  "535": [
+    1,
+    161
+  ],
+  "545": [
+    2,
+    162
+  ],
+  "597": [
+    45,
+    164
+  ],
+  "627": [
+    1,
+    209
+  ],
+  "677": [
+    8,
+    210
+  ],
+  "754": [
+    21,
+    218
+  ],
+  "765": [
+    2,
+    239
+  ],
+  "794": [
+    1,
+    241
+  ],
+  "795": [
+    1,
+    242
+  ],
+  "803": [
+    6,
+    243
+  ],
+  "804": [
+    1,
+    249
+  ],
+  "809": [
+    6,
+    250
+  ],
+  "84": [
+    11,
+    8
+  ],
+  "847": [
+    2,
+    256
+  ],
+  "862": [
+    1,
+    258
+  ],
+  "864": [
+    2,
+    259
+  ],
+  "877": [
+    1,
+    261
+  ],
+  "887": [
+    2,
+    262
+  ],
+  "891": [
+    3,
+    264
+  ],
+  "895": [
+    1,
+    267
+  ],
+  "915": [
+    2,
+    268
+  ]
+}

timezonefinder_data/data/schemas/hybrid_shortcuts_uint16.fbs

@@ -0,0 +1,46 @@
+namespace timezonefinder.flatbuf.generated.shortcuts_uint16;
+
+// Table representing a unique zone ID (when all polygons in hex share same zone)
+// Optimized for uint16 zone IDs (0-65535)
+table UniqueZone {
+  // Direct zone ID storage - 2 bytes per zone ID
+  zone_id: ushort;
+}
+
+// Table representing a list of polygon IDs (when hex contains multiple zones)
+table PolygonList {
+  // List of polygon IDs (fixed uint16 as per requirement)
+  poly_ids: [ushort];
+}
+
+// Union type for the shortcut value - either unique zone or polygon list
+union ShortcutValue {
+  UniqueZone,
+  PolygonList
+}
+
+// Individual shortcut entry mapping H3 hex ID to its value
+table HybridShortcutEntry {
+  // H3 hexagon ID (uint64)
+  hex_id: ulong;
+  // The value for this hex - either unique zone or polygon list
+  value: ShortcutValue;
+}
+
+// Root collection containing all shortcut entries
+// Optimized for uint16 zone IDs - no metadata overhead
+table HybridShortcutCollection {
+  // All shortcut entries
+  entries: [HybridShortcutEntry];
+  // encoding of the shortcut entries; see SHORTCUT_LAYOUT_VERSION in
+  // timezonefinder/flatbuf/io/hybrid_shortcuts.py. absent (= 0) in files written
+  // before the identifier and this marker were introduced.
+  layout_version: ushort;
+}
+
+root_type HybridShortcutCollection;
+
+// Distinct per zone id width on purpose: a uint16 buffer parsed under the other
+// schema decodes UniqueZone.zone_id at the wrong width and yields wrong zone ids
+// without failing, so the two must never be mistaken for one another.
+file_identifier "TZS2";

timezonefinder_data/data/schemas/hybrid_shortcuts_uint8.fbs

@@ -0,0 +1,46 @@
+namespace timezonefinder.flatbuf.generated.shortcuts_uint8;
+
+// Table representing a unique zone ID (when all polygons in hex share same zone)
+// Optimized for uint8 zone IDs (0-255)
+table UniqueZone {
+  // Direct zone ID storage - 1 byte per zone ID
+  zone_id: ubyte;
+}
+
+// Table representing a list of polygon IDs (when hex contains multiple zones)
+table PolygonList {
+  // List of polygon IDs (fixed uint16 as per requirement)
+  poly_ids: [ushort];
+}
+
+// Union type for the shortcut value - either unique zone or polygon list
+union ShortcutValue {
+  UniqueZone,
+  PolygonList
+}
+
+// Individual shortcut entry mapping H3 hex ID to its value
+table HybridShortcutEntry {
+  // H3 hexagon ID (uint64)
+  hex_id: ulong;
+  // The value for this hex - either unique zone or polygon list
+  value: ShortcutValue;
+}
+
+// Root collection containing all shortcut entries
+// Optimized for uint8 zone IDs - no metadata overhead
+table HybridShortcutCollection {
+  // All shortcut entries
+  entries: [HybridShortcutEntry];
+  // encoding of the shortcut entries; see SHORTCUT_LAYOUT_VERSION in
+  // timezonefinder/flatbuf/io/hybrid_shortcuts.py. absent (= 0) in files written
+  // before the identifier and this marker were introduced.
+  layout_version: ushort;
+}
+
+root_type HybridShortcutCollection;
+
+// Distinct per zone id width on purpose: a uint8 buffer parsed under the other
+// schema decodes UniqueZone.zone_id at the wrong width and yields wrong zone ids
+// without failing, so the two must never be mistaken for one another.
+file_identifier "TZS1";

timezonefinder_data/data/schemas/polygons.fbs

@@ -0,0 +1,17 @@
+namespace timezonefinder.flatbuf.generated.polygons;
+
+table Polygon {
+  // all x coordinates followed by all y coordinates, in a single vector
+  coords:[int];
+}
+
+table PolygonCollection {
+  polygons:[Polygon];
+  // encoding of the `coords` vectors; see POLYGON_LAYOUT_VERSION in
+  // timezonefinder/flatbuf/io/polygons.py. absent (= 0) in files written
+  // before the per-axis layout was introduced.
+  layout_version:ushort;
+}
+
+root_type PolygonCollection;
+file_identifier "TZFP";