refactor: Use a valid date and time and avoid the need for user changes in the examples (#94)

Co-authored-by: kikocorreoso <kiko@example.com>
Co-authored-by: terraputix <terraputix@mailbox.org>

Author: 3 people

README.md

@@ -55,19 +55,27 @@ reader.close() # Close the reader to release resources
 ### Reading Hierarchical Files, e.g. S3 Spatial Files
 
 ```python
+import datetime as dt
+
 import fsspec
 import numpy as np
 from omfiles import OmFileReader
 
 # Example: URI for a spatial data file in the `data_spatial` S3 bucket
 # See data organization details: https://github.com/open-meteo/open-data?tab=readme-ov-file#data-organization
-# Note: Spatial data is only retained for 7 days. The example file below may no longer exist.
-# Please update the URI to match a currently available file.
-s3_uri = "s3://openmeteo/data_spatial/dwd_icon/2025/09/23/0000Z/2025-09-30T0000.om"
+MODEL_DOMAIN = "dwd_icon"
+# Note: Spatial data is only retained for 7 days. The script uses one file within this period.
+date_time = dt.datetime.now(dt.timezone.utc) - dt.timedelta(days=2)
+S3_URI = (
+    f"s3://openmeteo/data_spatial/{MODEL_DOMAIN}/{date_time.year}/"
+    f"{date_time.month:02}/{date_time.day:02}/0000Z/"
+    f"{date_time.strftime('%Y-%m-%d')}T0000.om"
+)
+print(f"Using om file: {S3_URI}")
 
 # Create and open filesystem, wrapping it in a blockcache
 backend = fsspec.open(
-    f"blockcache::{s3_uri}",
+    f"blockcache::{S3_URI}",
     mode="rb",
     s3={"anon": True, "default_block_size": 65536},  # s3 settings
     blockcache={"cache_storage": "cache"},  # blockcache settings

examples/plot_map.py

@@ -9,6 +9,8 @@
 # ]
 # ///
 
+import datetime as dt
+
 import cartopy.crs as ccrs
 import cartopy.feature as cfeature
 import fsspec
@@ -21,10 +23,14 @@
 VARIABLE = "relative_humidity_2m"
 # Example: URI for a spatial data file in the `data_spatial` S3 bucket
 # See data organization details: https://github.com/open-meteo/open-data?tab=readme-ov-file#data-organization
-# Note: Spatial data is only retained for 7 days. The example file below may no longer exist.
-# Please update the URI to match a currently available file.
-S3_URI = f"s3://openmeteo/data_spatial/{MODEL_DOMAIN}/2026/01/10/0000Z/2026-01-12T0000.om"
-
+# Note: Spatial data is only retained for 7 days. The script uses one file within this period.
+date_time = dt.datetime.now(dt.timezone.utc) - dt.timedelta(days=2)
+S3_URI = (
+    f"s3://openmeteo/data_spatial/{MODEL_DOMAIN}/{date_time.year}/"
+    f"{date_time.month:02}/{date_time.day:02}/0000Z/"
+    f"{date_time.strftime('%Y-%m-%d')}T0000.om"
+)
+print(f"Using om file: {S3_URI}")
 backend = fsspec.open(
     f"blockcache::{S3_URI}",
     mode="rb",

examples/readme_example.py

@@ -7,6 +7,8 @@
 # ]
 # ///
 
+import datetime as dt
+
 import fsspec
 import numpy as np
 from omfiles import OmFileReader
@@ -15,10 +17,14 @@
 VARIABLE = "temperature_2m"
 # Example: URI for a spatial data file in the `data_spatial` S3 bucket
 # See data organization details: https://github.com/open-meteo/open-data?tab=readme-ov-file#data-organization
-# Note: Spatial data is only retained for 7 days. The example file below may no longer exist.
-# Please update the URI to match a currently available file.
-S3_URI = f"s3://openmeteo/data_spatial/{MODEL_DOMAIN}/2026/01/10/0000Z/2026-01-12T0000.om"
-
+# Note: Spatial data is only retained for 7 days. The script uses one file within this period.
+date_time = dt.datetime.now(dt.timezone.utc) - dt.timedelta(days=2)
+S3_URI = (
+    f"s3://openmeteo/data_spatial/{MODEL_DOMAIN}/{date_time.year}/"
+    f"{date_time.month:02}/{date_time.day:02}/0000Z/"
+    f"{date_time.strftime('%Y-%m-%d')}T0000.om"
+)
+print(f"Using om file: {S3_URI}")
 # Create and open filesystem, wrapping it in a blockcache
 backend = fsspec.open(
     f"blockcache::{S3_URI}",

examples/regrid_ecmwf_ifs_hres_gaussian_O1280_to_0.1_degree.py

@@ -10,6 +10,8 @@
 # ]
 # ///
 
+import datetime as dt
+
 import cartopy.crs as ccrs
 import cartopy.feature as cfeature
 import fsspec
@@ -22,9 +24,14 @@
 VARIABLE = "temperature_2m"
 # Example: URI for a spatial data file in the `data_spatial` S3 bucket
 # See data organization details: https://github.com/open-meteo/open-data?tab=readme-ov-file#data-organization
-# Note: Spatial data is only retained for 7 days. The example file below may no longer exist.
-# Please update the URI to match a currently available file.
-S3_URI = f"s3://openmeteo/data_spatial/{MODEL_DOMAIN}/2026/01/10/0000Z/2026-01-12T0000.om"
+# Note: Spatial data is only retained for 7 days. The script uses one file within this period.
+date_time = dt.datetime.now(dt.timezone.utc) - dt.timedelta(days=2)
+S3_URI = (
+    f"s3://openmeteo/data_spatial/{MODEL_DOMAIN}/{date_time.year}/"
+    f"{date_time.month:02}/{date_time.day:02}/0000Z/"
+    f"{date_time.strftime('%Y-%m-%d')}T0000.om"
+)
+print(f"Using om file: {S3_URI}")
 
 backend = fsspec.open(
     f"blockcache::{S3_URI}",

examples/regrid_subset_of_projected_domain.py

@@ -10,6 +10,8 @@
 # ]
 # ///
 
+import datetime as dt
+
 import cartopy.crs as ccrs
 import cartopy.feature as cfeature
 import fsspec
@@ -23,9 +25,14 @@
 VARIABLE = "temperature_2m"
 # Example: URI for a spatial data file in the `data_spatial` S3 bucket
 # See data organization details: https://github.com/open-meteo/open-data?tab=readme-ov-file#data-organization
-# Note: Spatial data is only retained for 7 days. The example file below may no longer exist.
-# Please update the URI to match a currently available file.
-S3_URI = f"s3://openmeteo/data_spatial/{MODEL_DOMAIN}/2026/01/17/0000Z/2026-01-19T0000.om"
+# Note: Spatial data is only retained for 7 days. The script uses one file within this period.
+date_time = dt.datetime.now(dt.timezone.utc) - dt.timedelta(days=2)
+S3_URI = (
+    f"s3://openmeteo/data_spatial/{MODEL_DOMAIN}/{date_time.year}/"
+    f"{date_time.month:02}/{date_time.day:02}/0000Z/"
+    f"{date_time.strftime('%Y-%m-%d')}T0000.om"
+)
+print(f"Using om file: {S3_URI}")
 
 LON_MIN = -130.0
 LON_MAX = -100.0

examples/select_by_coordinates.py

@@ -110,3 +110,4 @@
 
 # Save the figure
 plt.savefig(f"{VARIABLE}_comparison.png", dpi=300)
+print(f"\nPlot saved as: {VARIABLE}_comparison.png")

examples/spatial_xarray.py

@@ -9,6 +9,8 @@
 # ]
 # ///
 
+import datetime as dt
+
 import cartopy.crs as ccrs
 import cartopy.feature as cfeature
 import fsspec
@@ -22,9 +24,14 @@
 
 # Example: URI for a spatial data file in the `data_spatial` S3 bucket
 # See data organization details: https://github.com/open-meteo/open-data?tab=readme-ov-file#data-organization
-# Note: Spatial data is only retained for 7 days. The example file below may no longer exist.
-# Please update the URI to match a currently available file.
-S3_URI = f"s3://openmeteo/data_spatial/{MODEL_DOMAIN}/2026/01/10/0000Z/2026-01-12T0000.om"
+# Note: Spatial data is only retained for 7 days. The script uses one file within this period.
+date_time = dt.datetime.now(dt.timezone.utc) - dt.timedelta(days=2)
+S3_URI = (
+    f"s3://openmeteo/data_spatial/{MODEL_DOMAIN}/{date_time.year}/"
+    f"{date_time.month:02}/{date_time.day:02}/0000Z/"
+    f"{date_time.strftime('%Y-%m-%d')}T0000.om"
+)
+print(f"Using om file: {S3_URI}")
 
 backend = fsspec.open(
     f"blockcache::{S3_URI}",