chore: define the package version in source code (#96)

### what

define the version in the package source code

### why

it's easier to access and can be extracted by the packaging tool

### testing

n/a

### docs

n/a

Author: albertodonato

pyproject.toml

@@ -4,13 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "stacklet.client.platform"
-version = "2025.11.0"
 description = "Stacklet Platform Client"
-authors = [{ name = "Sonny Shi", email = "sonny@stacklet.io" }]
+authors = [{ name = "Stacklet Engineering", email = "foss+stacklet-admin@stacklet.io" }]
+maintainers = [{ name = "Stacklet Engineering", email = "foss+stacklet-admin@stacklet.io" }]
 requires-python = ">=3.9,<=3.14"
 readme = "README.md"
 license = "Apache-2.0"
-maintainers = [{ name = "Stacklet", email = "hello@stacklet.io" }]
 dependencies = [
     "click>=8.0.1,<9",
     "requests>=2.32.4,<3",
@@ -21,6 +20,7 @@ dependencies = [
     "charset_normalizer>=3.4.2,<4",
     "jmespath>=1.0.1,<2",
 ]
+dynamic = [ "version" ]
 
 [project.scripts]
 stacklet-admin = "stacklet.client.platform.cli:cli"
@@ -39,6 +39,9 @@ dev = [
     "deptry>=0.23.1,<0.24",
 ]
 
+[tool.hatch.version]
+path = "stacklet/client/platform/__init__.py"
+
 [tool.hatch.build.targets.sdist]
 include = [
     "stacklet",

stacklet/client/platform/__init__.py

@@ -1,2 +1,4 @@
 # Copyright Stacklet, Inc.
 # SPDX-License-Identifier: Apache-2.0
+
+__version__ = "2025.11.0"

stacklet/client/platform/commands/cube.py

@@ -14,7 +14,7 @@
 
 from ..context import StackletContext
 from ..exceptions import MissingToken
-from ..utils import get_user_agent
+from ..utils import USER_AGENT
 
 
 @click.group()
@@ -72,7 +72,7 @@ def _request(context: StackletContext, method: str, path: str, payload: Any = No
         headers={
             "Authorization": f"Bearer {token}",
             "Content-Type": "application/json",
-            "User-Agent": get_user_agent(),
+            "User-Agent": USER_AGENT,
         },
         json=payload,
     )

stacklet/client/platform/executor.py

@@ -9,7 +9,7 @@
 from .context import StackletContext
 from .exceptions import MissingToken
 from .registry import PluginRegistry
-from .utils import PAGINATION_OPTIONS, get_user_agent, wrap_command
+from .utils import PAGINATION_OPTIONS, USER_AGENT, wrap_command
 
 
 class StackletGraphqlExecutor:
@@ -31,7 +31,7 @@ def __init__(self, context: StackletContext):
         self.session.headers.update(
             {
                 "Authorization": f"Bearer {token}",
-                "User-Agent": get_user_agent(),
+                "User-Agent": USER_AGENT,
             }
         )
 

stacklet/client/platform/utils.py

@@ -1,12 +1,15 @@
 # Copyright Stacklet, Inc.
 # SPDX-License-Identifier: Apache-2.0
 
-import importlib.metadata
 import logging
 from pathlib import Path
 
 import click
 
+from . import __version__
+
+USER_AGENT = f"stacklet.client.platform/{__version__}"
+
 
 def expand_user_path(ctx, param, value):
     """Callback for click options to expand user paths."""
@@ -79,9 +82,3 @@ def setup_logging(level):
     root_handler = logging.getLogger()
     if level:
         root_handler.setLevel(level=get_log_level(level))
-
-
-def get_user_agent():
-    package = "stacklet.client.platform"
-    version = importlib.metadata.version(package)
-    return f"{package}/{version}"