eolas-data 1.3.0__tar.gz → 1.5.0__tar.gz

{eolas_data-1.3.0 → eolas_data-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eolas-data
-Version: 1.3.0
+Version: 1.5.0
 Summary: Python client for the eolas.fyi statistical data API (NZ, Australia, OECD)
 Project-URL: Homepage, https://eolas.fyi
 Project-URL: Documentation, https://docs.eolas.fyi/

{eolas_data-1.3.0 → eolas_data-1.5.0}/eolas_data/client.py

@@ -203,6 +203,29 @@ class Client:
         """Fetch a WorkSafe NZ dataset."""
         return self._get_source(name, "WorkSafe NZ", **kwargs)
 
+    def immigration(self, name, **kwargs) -> Dataset:
+        """Fetch an Immigration NZ dataset."""
+        return self._get_source(name, "Immigration NZ", **kwargs)
+
+    def lris(self, name, **kwargs) -> Dataset:
+        """Fetch a Manaaki Whenua LRIS dataset (land cover, soil, protected areas).
+
+        Examples::
+
+            client.lris("lcdb_v6_mainland")   # current NZ land cover (~543k polygons)
+            client.lris("nzlum_v03")           # NZ Land Use Management v0.3
+            client.lris("pan_nz_2025_draft")   # protected areas (Draft, 2025)
+
+        Notes:
+            LCDB v3.0–v4.1 are deprecated vintages, retained for longitudinal
+            analysis. LCDB v5 is superseded by v6 but still served.
+            PAN-NZ 2025 was marked Draft at the time of ingestion (2026-05-12).
+            Source: https://lris.scinfo.org.nz
+            Licence: CC-BY 4.0 International (LCDB v5/v6, NZLUM, PBC, PAN-NZ);
+            CC-BY 3.0 NZ (LCDB v3/v4 vintages). Attribution: Manaaki Whenua.
+        """
+        return self._get_source(name, "Manaaki Whenua / LRIS", **kwargs)
+
     def _get_source(self, name, source: str, **kwargs) -> Dataset:
         df = self.get(name, **kwargs)
         df.eolas_source = source
@@ -271,6 +294,11 @@ class Client:
             if "date" in df.columns:
                 df["date"] = pd.to_datetime(df["date"])
 
+        # API streams from Iceberg in file order, not chronological — sort here so
+        # callers can `df.plot(x="date", y="value")` without seeing zigzag lines.
+        if "date" in df.columns:
+            df = df.sort_values("date", kind="stable").reset_index(drop=True)
+
         result = Dataset(df)
         result.eolas_name   = name
         result.eolas_source = ""

{eolas_data-1.3.0 → eolas_data-1.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "eolas-data"
-version = "1.3.0"
+version = "1.5.0"
 description = "Python client for the eolas.fyi statistical data API (NZ, Australia, OECD)"
 readme = "README.md"
 license = { text = "MIT" }

{eolas_data-1.3.0 → eolas_data-1.5.0}/tests/test_client.py

@@ -101,6 +101,19 @@ def test_get_returns_dataset(client):
     assert df.eolas_name == "nz_cpi"
 
 
+@resp_lib.activate
+def test_get_sorts_rows_by_date(client):
+    # API streams Iceberg in file order, not chronological — client must sort.
+    unsorted = [
+        {"date": "2023-04-01", "period": "2023Q2", "value": 101.5},
+        {"date": "2022-01-01", "period": "2022Q1", "value": 99.0},
+        {"date": "2023-01-01", "period": "2023Q1", "value": 100.0},
+    ]
+    resp_lib.add(resp_lib.GET, f"{BASE}/v1/datasets/nz_cpi/data", json={"data": unsorted})
+    df = client.get("nz_cpi")
+    assert list(df["date"].dt.strftime("%Y-%m-%d")) == ["2022-01-01", "2023-01-01", "2023-04-01"]
+
+
 @resp_lib.activate
 def test_get_passes_date_params(client):
     resp_lib.add(resp_lib.GET, f"{BASE}/v1/datasets/nz_cpi/data", json={"data": RECORDS})