Packaging: Use cloud extra to install relevant packages

I.e., don't always install the `croud` package.

.github/workflows/main.yml

@@ -65,7 +65,7 @@ jobs:
         pip install "setuptools>=64" --upgrade
 
         # Install package in editable mode.
-        pip install --use-pep517 --prefer-binary --editable=.[io,test,develop]
+        pip install --use-pep517 --prefer-binary --editable=.[cloud,io,test,develop]
 
     - name: Run linter and software tests
       run: |

CHANGES.md

@@ -2,6 +2,7 @@
 
 
 ## Unreleased
+- Packaging: Use `cloud` extra to install relevant packages
 
 
 ## 2024/12/18 v0.0.3

cratedb_toolkit/api/main.py

@@ -8,7 +8,6 @@
 from cratedb_toolkit.api.guide import GuidingTexts
 from cratedb_toolkit.cluster.util import get_cluster_info
 from cratedb_toolkit.exception import CroudException, OperationFailed
-from cratedb_toolkit.io.croud import CloudIo
 from cratedb_toolkit.model import ClusterInformation, DatabaseAddress, InputOutputResource, TableAddress
 
 logger = logging.getLogger(__name__)
@@ -44,6 +43,7 @@ def load_table(self, resource: InputOutputResource, target: t.Optional[TableAddr
 
         https://console.cratedb.cloud
         """
+        from cratedb_toolkit.io.croud import CloudIo
 
         target = target or TableAddress()
 

cratedb_toolkit/cluster/util.py

@@ -1,9 +1,13 @@
-from cratedb_toolkit.cluster.croud import CloudCluster
 from cratedb_toolkit.model import ClusterInformation
 
 
 def get_cluster_info(cluster_id: str) -> ClusterInformation:
     cluster_info = ClusterInformation()
-    cc = CloudCluster(cluster_id=cluster_id)
-    cluster_info.cloud = cc.get_info()
+    try:
+        from cratedb_toolkit.cluster.croud import CloudCluster
+
+        cc = CloudCluster(cluster_id=cluster_id)
+        cluster_info.cloud = cc.get_info()
+    except ImportError:
+        pass
     return cluster_info

cratedb_toolkit/job/cli.py

@@ -5,7 +5,10 @@
 from cratedb_toolkit.job.croud import jobs_list
 from cratedb_toolkit.util.croud import get_croud_output_formats
 
-output_formats = get_croud_output_formats()
+try:
+    output_formats = get_croud_output_formats()
+except ImportError:
+    output_formats = ["UNKNOWN"]
 
 
 @click.command(name="list-jobs")

cratedb_toolkit/util/croud.py

@@ -9,17 +9,20 @@
 from unittest.mock import patch
 
 import yaml
-from croud.parser import Argument
 
 from cratedb_toolkit.exception import CroudException
 
+if t.TYPE_CHECKING:
+    from croud.parser import Argument
+
+
 logger = logging.getLogger(__name__)
 
 
 @dataclasses.dataclass
 class CroudCall:
     fun: t.Callable
-    specs: t.List[Argument]
+    specs: t.List["Argument"]
     arguments: t.List[str]
 
 

pyproject.toml

@@ -91,15 +91,17 @@ dependencies = [
   "colorlog",
   "crash",
   "crate[sqlalchemy]>=0.34",
-  "croud==1.10.0",
   'importlib-metadata; python_version <= "3.7"',
   "python-dotenv<2",
   "sqlalchemy",
   "sqlparse<0.5",
 ]
 [project.optional-dependencies]
 all = [
-  "cratedb-toolkit[influxdb,io,mongodb]",
+  "cratedb-toolkit[cloud,influxdb,io,mongodb]",
+]
+cloud = [
+  "croud==1.10.0",
 ]
 develop = [
   "black[jupyter]<24",
@@ -271,7 +273,7 @@ format = [
   # Configure Ruff not to auto-fix (remove!):
   # unused imports (F401), unused variables (F841), `print` statements (T201), and commented-out code (ERA001).
   { cmd = "ruff --fix --ignore=ERA --ignore=F401 --ignore=F841 --ignore=T20 --ignore=ERA001 ." },
-  { cmd = "pyproject-fmt pyproject.toml" },
+  { cmd = "pyproject-fmt --keep-full-version pyproject.toml" },
 ]
 
 lint = [