Update dependabot config and enhance data fetching

Author: joshday

.github/dependabot.yml

@@ -1,7 +1,10 @@
-# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
 version: 2
 updates:
   - package-ecosystem: "github-actions"
-    directory: "/" # Location of package manifests
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "julia"
+    directory: "/"
     schedule:
       interval: "weekly"

.github/workflows/CompatHelper.yml

@@ -14,11 +14,18 @@ function __init__()
 end
 
 #-----------------------------------------------------------------------------# RAPDataset
-# Products:
-# pgrb: Pressure Levels
-# sfcbf: Surface Fields
-# isobf: Isentropic
-
+"""
+    RAPDataset(; date, cycle_time, grid, product, forecast)
+
+NOAA Rapid Refresh (RAP) dataset descriptor.
+
+# Fields
+- `date::Date`: Forecast initialization date (default: today)
+- `cycle_time::String`: Model run time - "t00z", "t06z", "t12z", or "t18z" (default: "t00z")
+- `grid::String`: Grid resolution - "awp130" (~13km) or "awp252" (~32km) (default: "awp130")
+- `product::String`: Data type - "pgrb" (pressure), "sfcbf" (surface), or "isobf" (isentropic) (default: "pgrb")
+- `forecast::String`: Forecast hour - "f00" to "f18" (default: "f00")
+"""
 @kwdef struct RAPDataset
     date::Date = today()
     cycle_time::String = "t00z"
@@ -43,33 +50,65 @@ function Base.parse(::Type{RAPDataset}, local_path::String)
     return RAPDataset(; date, cycle_time, grid, forecast)
 end
 
+"""
+    url(dset::RAPDataset) -> String
+
+Generate AWS S3 URL for the RAP dataset.
+"""
 function url(dset::RAPDataset)
     "$rap_base_url$(Dates.format(dset.date, "yyyymmdd"))/rap.$(dset.cycle_time).$(dset.grid)pgrb$(dset.forecast).grib2"
 end
 
+"""
+    local_path(dset::RAPDataset) -> String
+
+Get local cache path for the RAP dataset.
+"""
 function local_path(dset::RAPDataset)
     joinpath(dir, "rap_$(Dates.format(dset.date, "yyyymmdd"))_$(dset.cycle_time)_$(dset.grid)_$(dset.forecast).grib2")
 end
 
+"""
+    get(dset::RAPDataset) -> String
+
+Download RAP dataset to cache (if needed) and return filepath.
+"""
 function Base.get(dset::RAPDataset)
     isfile(local_path(dset)) ? local_path(dset) : Base.download(url(dset), local_path(dset))
 end
 
+"""
+    local_datasets(RAPDataset) -> Vector{RAPDataset}
+
+List all cached RAP datasets.
+"""
 function local_datasets(::Type{RAPDataset})
     files = filter(f -> startswith(f, "rap_") && endswith(f, ".grib2"), readdir(dir))
     parse.(RAPDataset, files)
 end
 
+"""
+    clear_local_dataset!(dset::RAPDataset)
+
+Remove RAP dataset from local cache.
+"""
 function clear_local_dataset!(dset::RAPDataset)
     isfile(local_path(dset)) && rm(local_path(dset))
 end
 
 #-----------------------------------------------------------------------------# GFSDataset
-# GFS (Global Forecast System) from NOAA
-# Resolutions: 0p25 (0.25°), 0p50 (0.50°), 1p00 (1.00°)
-# Products: atmos, wave
-# Forecast: f000 to f384 (hourly to 120h, then 3-hourly to 384h)
-
+"""
+    GFSDataset(; date, cycle, resolution, product, forecast)
+
+NOAA Global Forecast System (GFS) dataset descriptor.
+
+# Fields
+- `date::Date`: Forecast initialization date (default: today)
+- `cycle::String`: Model run time - "00", "06", "12", or "18" (default: "00")
+- `resolution::String`: Grid resolution - "0p25" (0.25°), "0p50" (0.50°), or "1p00" (1.00°) (default: "0p25")
+- `product::String`: Product type - "atmos" or "wave" (default: "atmos")
+- `forecast::String`: Forecast hour - "f000" to "f384" (default: "f000")
+"""
 @kwdef struct GFSDataset
     date::Date = today()
     cycle::String = "00"  # "00", "06", "12", "18"
@@ -95,23 +134,48 @@ function Base.parse(::Type{GFSDataset}, local_path::String)
     return GFSDataset(; date, cycle, resolution, product, forecast)
 end
 
+"""
+    url(dset::GFSDataset) -> String
+
+Generate AWS S3 URL for the GFS dataset.
+"""
 function url(dset::GFSDataset)
     "$(gfs_base_url)gfs.$(Dates.format(dset.date, "yyyymmdd"))/$(dset.cycle)/$(dset.product)/gfs.t$(dset.cycle)z.pgrb2.$(dset.resolution).$(dset.forecast)"
 end
 
+"""
+    local_path(dset::GFSDataset) -> String
+
+Get local cache path for the GFS dataset.
+"""
 function local_path(dset::GFSDataset)
     joinpath(dir, "gfs_$(Dates.format(dset.date, "yyyymmdd"))_$(dset.cycle)_$(dset.resolution)_$(dset.product)_$(dset.forecast).grib2")
 end
 
+"""
+    get(dset::GFSDataset) -> String
+
+Download GFS dataset to cache (if needed) and return filepath.
+"""
 function Base.get(dset::GFSDataset)
     isfile(local_path(dset)) ? local_path(dset) : Base.download(url(dset), local_path(dset))
 end
 
+"""
+    local_datasets(GFSDataset) -> Vector{GFSDataset}
+
+List all cached GFS datasets.
+"""
 function local_datasets(::Type{GFSDataset})
     files = filter(f -> startswith(f, "gfs_"), readdir(dir))
     parse.(GFSDataset, files)
 end
 
+"""
+    clear_local_dataset!(dset::GFSDataset)
+
+Remove GFS dataset from local cache.
+"""
 function clear_local_dataset!(dset::GFSDataset)
     isfile(local_path(dset)) && rm(local_path(dset))
 end