nextmv 0.38.0.dev0__tar.gz → 0.39.0.dev0__tar.gz

{nextmv-0.38.0.dev0 → nextmv-0.39.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextmv
-Version: 0.38.0.dev0
+Version: 0.39.0.dev0
 Summary: The all-purpose Python SDK for Nextmv
 Project-URL: Homepage, https://www.nextmv.io
 Project-URL: Documentation, https://nextmv-py.docs.nextmv.io/en/latest/nextmv/
@@ -221,6 +221,7 @@ Requires-Python: >=3.10
 Requires-Dist: pydantic>=2.5.2
 Requires-Dist: pyyaml>=6.0.1
 Requires-Dist: requests>=2.31.0
+Requires-Dist: typer>=0.20.1
 Requires-Dist: urllib3>=2.1.0
 Provides-Extra: all
 Requires-Dist: folium>=0.20.0; extra == 'all'

nextmv-0.39.0.dev0/nextmv/__about__.py

@@ -0,0 +1 @@
+__version__ = "v0.39.0.dev0"

nextmv-0.39.0.dev0/nextmv/cli/main.py

@@ -0,0 +1,11 @@
+import typer
+
+from nextmv.cli.version import app as version_app
+
+app = typer.Typer(
+    help="The Nextmv Command Line Interface (CLI).",
+    epilog="[italic]:rabbit: Made with :heart: by Nextmv.[/italic]",
+    rich_markup_mode="rich",
+    context_settings={"help_option_names": ["--help", "-h"]},
+)
+app.add_typer(version_app)

nextmv-0.39.0.dev0/nextmv/cli/version.py

@@ -0,0 +1,14 @@
+import typer
+from rich import print
+
+from nextmv.__about__ import __version__
+
+app = typer.Typer()
+
+
+@app.command()
+def version() -> str:
+    """
+    Show the current version of the Nextmv CLI.
+    """
+    print(__version__)

{nextmv-0.38.0.dev0 → nextmv-0.39.0.dev0}/nextmv/cloud/application.py

@@ -2548,7 +2548,7 @@ class Application:
 
         Retrieves a list of assets associated with a specific run. This method ONLY
         returns the asset metadata, the content needs to be fetched via the
-        `download_asset` method.
+        `download_asset_content` method.
 
         Parameters
         ----------
@@ -2582,9 +2582,13 @@ class Application:
             asset_data["run_id"] = run_id
         return [RunAsset.from_dict(asset) for asset in assets_data]
 
-    def download_asset(self, asset: RunAsset, destination: str | pathlib.Path | io.BytesIO | None = None) -> Any | None:
+    def download_asset_content(
+        self,
+        asset: RunAsset,
+        destination: str | pathlib.Path | io.BytesIO | None = None,
+    ) -> Any | None:
         """
-        Downloads an asset to a specified destination.
+        Downloads an asset's content to a specified destination.
 
         Parameters
         ----------
@@ -2599,10 +2603,10 @@ class Application:
         Returns
         -------
         Any or None
-            If ``destination`` is None, returns the asset content: for JSON assets, a
-            ``dict`` parsed from the JSON response; for other asset types, the raw
-            ``bytes`` content. If ``destination`` is provided, the content is written
-            to the given destination and the method returns ``None``.
+            If `destination` is None, returns the asset content: for JSON assets, a
+            `dict` parsed from the JSON response; for other asset types, the raw
+            `bytes` content. If `destination` is provided, the content is written
+            to the given destination and the method returns `None`.
 
         Raises
         ------
@@ -2614,13 +2618,13 @@ class Application:
         >>> assets = app.list_assets("run-123")
         >>> asset = assets[0]  # Assume we want to download the first asset
         >>> # Download to a file path
-        >>> app.download_asset(asset, "polygons.geojson")
+        >>> app.download_asset_content(asset, "polygons.geojson")
         >>> # Download to an in-memory bytes buffer
         >>> import io
         >>> buffer = io.BytesIO()
-        >>> app.download_asset(asset, buffer)
+        >>> app.download_asset_content(asset, buffer)
         >>> # Download and get content directly (for JSON assets)
-        >>> content = app.download_asset(asset)
+        >>> content = app.download_asset_content(asset)
         >>> print(content)
         {'type': 'FeatureCollection', 'features': [...]}
         """

{nextmv-0.38.0.dev0 → nextmv-0.39.0.dev0}/pyproject.toml

@@ -20,6 +20,7 @@ dependencies = [
     "urllib3>=2.1.0",
     "requests>=2.31.0",
     "pyyaml>=6.0.1",
+    "typer>=0.20.1",
 ]
 description = "The all-purpose Python SDK for Nextmv"
 dynamic = [
@@ -49,6 +50,9 @@ Homepage = "https://www.nextmv.io"
 Documentation = "https://nextmv-py.docs.nextmv.io/en/latest/nextmv/"
 Repository = "https://github.com/nextmv-io/nextmv-py"
 
+[project.scripts]
+nextmv = "nextmv.cli.main:app"
+
 [project.optional-dependencies]
 all = [
     "folium>=0.20.0",

nextmv-0.38.0.dev0/nextmv/__about__.py

@@ -1 +0,0 @@
-__version__ = "v0.38.0.dev0"