cloudnet-api-client 0.8.0__tar.gz → 0.9.1__tar.gz

{cloudnet_api_client-0.8.0 → cloudnet_api_client-0.9.1}/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.9.1 – 2025-06-19
+
+- Support mobile sites without latitude and longitude
+- Fix metadata fetching when `instrument_pid` defined
+
+## 0.9.0 – 2025-05-14
+
+- By default download to current folder
+
 ## 0.8.0 – 2025-05-14
 
 - Add site to metadata responses

{cloudnet_api_client-0.8.0 → cloudnet_api_client-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloudnet-api-client
-Version: 0.8.0
+Version: 0.9.1
 Summary: Cloudnet API client
 Author-email: Simo Tukiainen <simo.tukiainen@fmi.fi>
 License-File: LICENSE
@@ -48,11 +48,17 @@ client = APIClient()
 sites = client.sites(type="cloudnet")
 products = client.products()
 
-metadata = client.metadata("hyytiala", "2021-01-01", product=["mwr", "radar"])
-client.download(metadata, "data/")
+metadata = client.metadata(site_id="hyytiala", date="2021-01-01", product=["mwr", "radar"])
+file_paths = client.download(metadata, "data/")
 
-raw_metadata = client.raw_metadata("granada", date="2024-01", instrument_id="parsivel")
-client.download(raw_metadata, "data_raw/")
+raw_metadata = client.raw_metadata(site_id="granada", date="2024-01", instrument_id="parsivel")
+file_paths = client.download(raw_metadata, "data_raw/")
+```
+
+When downloading files inside Jupyter notebook (or similar environment), you have to use the asynchronous version:
+
+```python
+file_paths = await client.adownload(metadata)
 ```
 
 ## Documentation
@@ -152,13 +158,13 @@ Download files from the fetched metadata.
 
 Parameters:
 
-| name              | type                                           | default |
-| ----------------- | ---------------------------------------------- | ------- |
-| metadata          | `list[RawMetadata]` or `list[ProductMetadata]` |         |
-| output_directory  | `PathLike` or `str`                            |         |
-| concurrency_limit | `int`                                          | 5       |
-| progress          | `bool` or `None`                               | `None`  |
-| validate_checksum | `bool`                                         | `False` |
+| name              | type                                           | default           |
+| ----------------- | ---------------------------------------------- | ----------------- |
+| metadata          | `list[RawMetadata]` or `list[ProductMetadata]` |                   |
+| output_directory  | `PathLike` or `str`                            | Current directory |
+| concurrency_limit | `int`                                          | 5                 |
+| progress          | `bool` or `None`                               | `None`            |
+| validate_checksum | `bool`                                         | `False`           |
 
 There's also an asynchronous version of this function:
 `cloudnet_api_client.adownload`. It's useful for usage inside Jupyter notebook.

{cloudnet_api_client-0.8.0 → cloudnet_api_client-0.9.1}/README.md

@@ -21,11 +21,17 @@ client = APIClient()
 sites = client.sites(type="cloudnet")
 products = client.products()
 
-metadata = client.metadata("hyytiala", "2021-01-01", product=["mwr", "radar"])
-client.download(metadata, "data/")
+metadata = client.metadata(site_id="hyytiala", date="2021-01-01", product=["mwr", "radar"])
+file_paths = client.download(metadata, "data/")
 
-raw_metadata = client.raw_metadata("granada", date="2024-01", instrument_id="parsivel")
-client.download(raw_metadata, "data_raw/")
+raw_metadata = client.raw_metadata(site_id="granada", date="2024-01", instrument_id="parsivel")
+file_paths = client.download(raw_metadata, "data_raw/")
+```
+
+When downloading files inside Jupyter notebook (or similar environment), you have to use the asynchronous version:
+
+```python
+file_paths = await client.adownload(metadata)
 ```
 
 ## Documentation
@@ -125,13 +131,13 @@ Download files from the fetched metadata.
 
 Parameters:
 
-| name              | type                                           | default |
-| ----------------- | ---------------------------------------------- | ------- |
-| metadata          | `list[RawMetadata]` or `list[ProductMetadata]` |         |
-| output_directory  | `PathLike` or `str`                            |         |
-| concurrency_limit | `int`                                          | 5       |
-| progress          | `bool` or `None`                               | `None`  |
-| validate_checksum | `bool`                                         | `False` |
+| name              | type                                           | default           |
+| ----------------- | ---------------------------------------------- | ----------------- |
+| metadata          | `list[RawMetadata]` or `list[ProductMetadata]` |                   |
+| output_directory  | `PathLike` or `str`                            | Current directory |
+| concurrency_limit | `int`                                          | 5                 |
+| progress          | `bool` or `None`                               | `None`            |
+| validate_checksum | `bool`                                         | `False`           |
 
 There's also an asynchronous version of this function:
 `cloudnet_api_client.adownload`. It's useful for usage inside Jupyter notebook.

{cloudnet_api_client-0.8.0 → cloudnet_api_client-0.9.1}/cloudnet_api_client/client.py

@@ -111,17 +111,18 @@ class APIClient:
 
         _check_params(params, ("showLegacy",))
 
-        no_instrument = not instrument_id or instrument_pid
-        if no_instrument and (not product and model_id):
+        no_instrument = instrument_id is None and instrument_pid is None
+
+        if no_instrument and (product is None and model_id is not None):
             files_res = []
         else:
             files_res = self._get_response("files", params)
 
         # Add model files if requested
         if (
-            (not product and no_instrument)
-            or (product and "model" in product)
-            or (model_id and (not product or "model" in product))
+            (product is None and no_instrument)
+            or (product is not None and "model" in product)
+            or (model_id is not None and (product is None or "model" in product))
         ):
             for key in ("showLegacy", "product", "instrument", "instrumentPid"):
                 del params[key]
@@ -193,7 +194,7 @@ class APIClient:
     def download(
         self,
         metadata: MetadataList,
-        output_directory: str | PathLike,
+        output_directory: str | PathLike = ".",
         concurrency_limit: int = 5,
         progress: bool | None = None,
         validate_checksum: bool = False,
@@ -211,7 +212,7 @@ class APIClient:
     async def adownload(
         self,
         metadata: MetadataList,
-        output_directory: str | PathLike,
+        output_directory: str | PathLike = ".",
         concurrency_limit: int = 5,
         progress: bool | None = None,
         validate_checksum: bool = False,
@@ -482,9 +483,9 @@ def _create_site_object(metadata: dict) -> Site:
         id=metadata["id"],
         human_readable_name=metadata["humanReadableName"],
         station_name=metadata["stationName"],
-        latitude=float(metadata["latitude"]),
-        longitude=float(metadata["longitude"]),
-        altitude=float(metadata["altitude"]),
+        latitude=metadata["latitude"],
+        longitude=metadata["longitude"],
+        altitude=metadata["altitude"],
         dvas_id=metadata["dvasId"],
         actris_id=metadata["actrisId"],
         country=metadata["country"],

{cloudnet_api_client-0.8.0 → cloudnet_api_client-0.9.1}/cloudnet_api_client/containers.py

@@ -13,9 +13,9 @@ class Site:
     id: str
     human_readable_name: str
     station_name: str | None
-    latitude: float
-    longitude: float
-    altitude: float
+    latitude: float | None
+    longitude: float | None
+    altitude: int
     dvas_id: str | None
     actris_id: int | None
     country: str

cloudnet_api_client-0.9.1/cloudnet_api_client/version.py

@@ -0,0 +1 @@
+__version__ = "0.9.1"

cloudnet_api_client-0.8.0/cloudnet_api_client/version.py

@@ -1 +0,0 @@
-__version__ = "0.8.0"