snapctl 0.49.4__py3-none-any.whl → 0.50.0__py3-none-any.whl

snapctl/commands/byogs.py

@@ -105,6 +105,16 @@ class ByoGs:
             pass
         return None
 
+    @staticmethod
+    def _docker_supports_buildkit():
+        try:
+            version = subprocess.check_output(
+                ["docker", "version", "--format", "{{.Server.Version}}"])
+            major, minor = map(int, version.decode().split(".")[:2])
+            return (major > 18) or (major == 18 and minor >= 9)
+        except Exception:
+            return False
+
     def _check_dependencies(self) -> None:
         progress = Progress(
             SpinnerColumn(),
@@ -200,6 +210,10 @@ class ByoGs:
         progress.add_task(
             description='Building your snap...', total=None)
         try:
+            env = os.environ.copy()
+            if ByoGs._docker_supports_buildkit():
+                info('Docker BuildKit is supported. Enabling it.')
+                env["DOCKER_BUILDKIT"] = "1"
             # image_tag = f'{ByoGs.SID}.{self.tag}'
             build_platform = ByoGs.DEFAULT_BUILD_PLATFORM
             if len(self.token_parts) == 4:
@@ -217,7 +231,7 @@ class ByoGs:
                     # f"docker build --no-cache -t {tag} {path}"
                     'docker', 'build', '--platform', build_platform, '-t', self.tag,
                     '-f', self.docker_path_filename,  self.path
-                ], shell=True, check=False)
+                ], shell=True, check=False, env=env)
                 # stdout=subprocess.DEVNULL, stderr=subprocess.STDOUT)
             else:
                 response = subprocess.run([
@@ -225,7 +239,7 @@ class ByoGs:
                     "docker build --platform " +
                     f"{build_platform} -t {self.tag} " +
                     f"-f {self.docker_path_filename} {self.path}"
-                ], shell=True, check=False)
+                ], shell=True, check=False, env=env)
                 # stdout=subprocess.DEVNULL, stderr=subprocess.STDOUT)
             if not response.returncode:
                 return snapctl_success(

snapctl/commands/byosnap.py

@@ -509,16 +509,19 @@ class ByoSnap:
                     outfile.write(line)
             return True
         except FileNotFoundError:
-            print(f"[ERROR] Could not find profile file: {resource_filename}")
+            warning(
+                f"[ERROR] Could not find profile file: {resource_filename}")
+            return False
+
+    @staticmethod
+    def _docker_supports_buildkit():
+        try:
+            version = subprocess.check_output(
+                ["docker", "version", "--format", "{{.Server.Version}}"])
+            major, minor = map(int, version.decode().split(".")[:2])
+            return (major > 18) or (major == 18 and minor >= 9)
+        except Exception:
             return False
-    # @staticmethod
-    # def _handle_output_file(input_filepath, output_filepath) -> bool:
-    #     file_written = False
-    #     with open(input_filepath, 'r') as in_file, open(output_filepath, 'w') as outfile:
-    #         for line in in_file:
-    #             outfile.write(line)
-    #         file_written = True
-    #     return file_written
 
     def _get_profile_contents(self) -> dict:
         """
@@ -588,13 +591,15 @@ class ByoSnap:
                 code=SNAPCTL_INPUT_ERROR
             )
         # IMPORTANT: This is where the profile data is set and validated
+        #
+        # Update: June 2, 2025 -  We removed the line that updated the self.platform_type
+        # self.platform_type = profile_data_obj['platform']
         self.profile_data = profile_data_obj
         ByoSnap._validate_byosnap_profile_data(self.profile_data)
         # End: IMPORTANT: This is where the profile data is set
         # Now apply the overrides
         self.name = self.profile_data['name']
         self.desc = self.profile_data['description']
-        self.platform_type = self.profile_data['platform']
         self.language = self.profile_data['language']
         self.prefix = self.profile_data['prefix']
         # Setup the final ingress external port
@@ -716,6 +721,10 @@ class ByoSnap:
         build_platform = ByoSnap.DEFAULT_BUILD_PLATFORM
         if len(self.token_parts) == 4:
             build_platform = self.token_parts[3]
+        if self.platform_type is not None:
+            build_platform = self.platform_type
+        # if len(self.token_parts) == 4:
+        #     build_platform = self.token_parts[3]
         progress = Progress(
             SpinnerColumn(),
             TextColumn("[progress.description]{task.description}"),
@@ -725,6 +734,10 @@ class ByoSnap:
         progress.add_task(
             description='Building your snap...', total=None)
         try:
+            env = os.environ.copy()
+            if ByoSnap._docker_supports_buildkit():
+                info('Docker BuildKit is supported. Enabling it.')
+                env["DOCKER_BUILDKIT"] = "1"
             # Warning check for architecture specific commands
             info(f'Building on system architecture {sys_platform.machine()}')
             check_response = check_dockerfile_architecture(
@@ -737,7 +750,7 @@ class ByoSnap:
                     # f"docker build --no-cache -t {remote_tag} {path}"
                     'docker', 'build', '--platform', build_platform, '-t', self.remote_tag,
                     '-f', self.docker_path_filename,  self.path
-                ], shell=True, check=False)
+                ], shell=True, check=False, env=env)
                 # stdout=subprocess.DEVNULL, stderr=subprocess.STDOUT)
             else:
                 response = subprocess.run([
@@ -745,7 +758,7 @@ class ByoSnap:
                     "docker build --platform " +
                     f"{build_platform} -t {self.remote_tag} " +
                     f"-f {self.docker_path_filename} {self.path}"
-                ], shell=True, check=False)
+                ], shell=True, check=False, env=env)
                 # stdout=subprocess.DEVNULL, stderr=subprocess.STDOUT)
             if not response.returncode:
                 return snapctl_success(
@@ -943,15 +956,21 @@ class ByoSnap:
             if self.path is None and self.resources_path is None:
                 snapctl_error(
                     "Missing one of: path or resources-path parameter", SNAPCTL_INPUT_ERROR)
-            if not self.tag:
-                snapctl_error("Missing tag", SNAPCTL_INPUT_ERROR)
-            if len(self.tag.split()) > 1 or \
-                    len(self.tag) > ByoSnap.TAG_CHARACTER_LIMIT:
-                snapctl_error(
-                    "Tag should be a single word with maximum of " +
-                    f"{ByoSnap.TAG_CHARACTER_LIMIT} characters",
-                    SNAPCTL_INPUT_ERROR
-                )
+            if not self.tag and not self.version:
+                snapctl_error("Missing tag or version", SNAPCTL_INPUT_ERROR)
+            if self.tag:
+                if len(self.tag.split()) > 1 or \
+                        len(self.tag) > ByoSnap.TAG_CHARACTER_LIMIT:
+                    snapctl_error(
+                        "Tag should be a single word with maximum of " +
+                        f"{ByoSnap.TAG_CHARACTER_LIMIT} characters",
+                        SNAPCTL_INPUT_ERROR
+                    )
+            if self.version:
+                pattern = r'^v\d+\.\d+\.\d+$'
+                if not re.match(pattern, self.version):
+                    snapctl_error(message="Version should be in the format vX.X.X",
+                                  code=SNAPCTL_INPUT_ERROR)
         elif self.subcommand == 'publish-version':
             # Setup
             self._setup_token_and_token_parts(
@@ -1127,6 +1146,9 @@ class ByoSnap:
         progress.add_task(
             description='Uploading your BYOSnap Docs...', total=None)
         try:
+            upload_tag = self.tag
+            if not upload_tag:
+                upload_tag = self.version
             if self.resources_path:
                 base_dir = self.resources_path
             else:
@@ -1141,7 +1163,7 @@ class ByoSnap:
                         info(f'Uploading swagger.json at {swagger_file}')
                         url = (
                             f"{self.base_url}/v1/snapser-api/byosnaps/"
-                            f"{self.byosnap_id}/docs/{self.tag}/openapispec"
+                            f"{self.byosnap_id}/docs/{upload_tag}/openapispec"
                         )
                         test_res = requests.post(
                             url, files={"attachment": attachment_file},
@@ -1181,7 +1203,7 @@ class ByoSnap:
                     with open(readme_file, "rb") as attachment_file:
                         url = (
                             f"{self.base_url}/v1/snapser-api/byosnaps/"
-                            f"{self.byosnap_id}/docs/{self.tag}/markdown"
+                            f"{self.byosnap_id}/docs/{upload_tag}/markdown"
                         )
                         test_res = requests.post(
                             url, files={"attachment": attachment_file},
@@ -1213,7 +1235,7 @@ class ByoSnap:
                             with open(file_path, "rb") as attachment_file:
                                 url = (
                                     f"{self.base_url}/v1/snapser-api/byosnaps/"
-                                    f"{self.byosnap_id}/docs/{self.tag}/tools"
+                                    f"{self.byosnap_id}/docs/{upload_tag}/tools"
                                 )
                                 test_res = requests.post(
                                     url, files={"attachment": attachment_file},
@@ -1370,7 +1392,11 @@ class ByoSnap:
                 "prod_template": prod_template,
                 # Currently not supported so we are just hardcoding an empty list
                 "egress": {"ports": []},
+                # Platform override
             }
+            if self.platform_type is not None:
+                payload['platform_override'] = self.platform_type
+
             res = requests.post(
                 f"{self.base_url}/v1/snapser-api/byosnaps/{self.byosnap_id}/versions",
                 json=payload, headers={'api-key': self.api_key},
@@ -1452,6 +1478,8 @@ class ByoSnap:
                 # Currently not supported so we are just hardcoding an empty list
                 "egress": {"ports": []},
             }
+            if self.platform_type is not None:
+                payload['platform_override'] = self.platform_type
             res = requests.patch(
                 f"{self.base_url}/v1/snapser-api/byosnaps/{self.byosnap_id}/versions/{self.version}",
                 json=payload, headers={'api-key': self.api_key},
@@ -1504,7 +1532,7 @@ class ByoSnap:
                 "service_id": self.byosnap_id,
                 "name": self.name,
                 "description": self.desc,
-                "platform": self.platform_type,
+                "platform": self.profile_data['platform'],
                 "language": self.language,
             }
             res = requests.post(

snapctl/commands/byows.py

@@ -99,12 +99,11 @@ class Byows:
     def _get_export_commands(snap_ids, port):
         '''
         Generate export commands for the given snap IDs and port.
-        Replace hyphens with underscores in environment variable names.
         '''
         env_vars = []
 
         for snap_id in snap_ids:
-            upper_id = snap_id.upper().replace("-", "_")
+            upper_id = snap_id.upper()
             env_vars.append(f"SNAPEND_{upper_id}_GRPC_URL=localhost:{port}")
             env_vars.append(
                 f"SNAPEND_{upper_id}_HTTP_URL=http://localhost:{port}")
@@ -122,12 +121,11 @@ class Byows:
     def _generate_env_file(snap_ids, port):
         '''
         Generate an environment file with the given snap IDs and port.
-        Replace hyphens with underscores in environment variable names.
         '''
         env_lines = []
 
         for snap_id in snap_ids:
-            upper_id = snap_id.upper().replace("-", "_")
+            upper_id = snap_id.upper()
             env_lines.append(
                 f"export SNAPEND_{upper_id}_GRPC_URL=localhost:{port}")
             env_lines.append(

snapctl/config/constants.py

@@ -3,7 +3,7 @@ Constants used by snapctl
 """
 COMPANY_NAME = 'Snapser'
 VERSION_PREFIX = 'beta-'
-VERSION = '0.49.4'
+VERSION = '0.50.0'
 CONFIG_FILE_MAC = '~/.snapser/config'
 CONFIG_FILE_WIN = '%homepath%\\.snapser\\config'
 

snapctl/data/releases/beta-0.50.0.mdx

@@ -0,0 +1,10 @@
+## beta-0.50.0
+##### June 5, 2025
+
+### Bug fix
+- Success, info or warning messages were sometimes getting truncated in the CLI output. This has been fixed.
+- Snapctl byosnap and byogs now support features that could only work with Buildkit.
+
+### Feature
+- The `snapctl byosnap upload-docs` command now supports `--version` to keep it consistent with all the new commands like `sync` and `publish`.
+

snapctl/main.py

@@ -3,7 +3,6 @@
 """
 import configparser
 import os
-import json
 from sys import platform
 from typing import Union
 import typer
@@ -403,7 +402,7 @@ def byosnap(
         help="(req: create) Language of your snap - " +
         ", ".join(ByoSnap.LANGUAGES) + "."
     ),
-    # publish-image, publish-version, publish, sync
+    # publish-image, publish-version, publish, sync, upload-docs
     tag: str = typer.Option(
         None, "--tag", help=(
             "(req: publish-image, publish-version, upload-docs) (optional: publish, sync) Tag for your snap"

snapctl/utils/echo.py

@@ -4,38 +4,49 @@ This module contains functions to print messages to the console.
 import json
 import typer
 from rich import print
+from rich.markup import escape
 from snapctl.config.constants import SNAPCTL_ERROR
 from snapctl.types.definitions import ErrorResponse
 # Run `python -m rich.emoji` to get a list of all emojis that are supported
 
 
-def error(msg: str, code: int = SNAPCTL_ERROR, data: object = None) -> None:
+def _stringify_message(msg: object) -> str:
+    if isinstance(msg, (dict, list)):
+        return json.dumps(msg, indent=2)
+    return str(msg)
+
+
+def error(msg: object, code: int = SNAPCTL_ERROR, data: object = None) -> None:
     """
     Prints an error message to the console.
     """
+    msg = _stringify_message(msg)
     error_response = ErrorResponse(
         error=True, code=code, msg=msg, data=data if data else ''
     )
-    print(f"[bold red]Error[/bold red] {msg}")
+    print(f"[bold red]Error[/bold red] {escape(msg)}")
     typer.echo(json.dumps(error_response.to_dict()), err=True)
 
 
-def warning(msg: str) -> None:
+def warning(msg: object) -> None:
     """
     Prints a warning message to the console.
     """
-    print(f"[bold yellow]Warning[/bold yellow] {msg}")
+    msg = _stringify_message(msg)
+    print(f"[bold yellow]Warning[/bold yellow] {escape(msg)}")
 
 
-def info(msg: str) -> None:
+def info(msg: object) -> None:
     """
     Prints an info message to the console.
     """
-    print(f"[bold blue]Info[/bold blue] {msg}")
+    msg = _stringify_message(msg)
+    print(f"[bold blue]Info[/bold blue] {escape(msg)}")
 
 
-def success(msg: str) -> None:
+def success(msg: object) -> None:
     """
     Prints a success message to the console.
     """
-    print(f"[bold green]Success[/bold green] {msg}")
+    msg = _stringify_message(msg)
+    print(f"[bold green]Success[/bold green] {escape(msg)}")

{snapctl-0.49.4.dist-info → snapctl-0.50.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: snapctl
-Version: 0.49.4
+Version: 0.50.0
 Summary: Snapser CLI Tool
 Author: Ajinkya Apte
 Author-email: aj@snapser.com

{snapctl-0.49.4.dist-info → snapctl-0.50.0.dist-info}/RECORD

@@ -1,15 +1,15 @@
 snapctl/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 snapctl/__main__.py,sha256=43jKoTk8b85hk_MT6499N3ruHdEfM8WBImd_-3VzjI8,116
 snapctl/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-snapctl/commands/byogs.py,sha256=WumLZRriCVF0SSnMn8TUL--iWhh3Yub3yQ-jz30faI0,19486
-snapctl/commands/byosnap.py,sha256=9Xe75VAi-KPFALSleUyMJsrvDJEG6cxBiGiF267PSJA,76897
-snapctl/commands/byows.py,sha256=xmvTsWGjp3CkIvMj3LdVJO02P5W0-HfWqsP2pf9tsXE,18519
+snapctl/commands/byogs.py,sha256=fwXM7X_IqkVPAByGWWxwNzJeZlDTsh_ApWNH3IhyVVM,20076
+snapctl/commands/byosnap.py,sha256=TAITdbB_FhGk7K94bPDDjykXbU9XwO9opW__qdeg0SQ,78187
+snapctl/commands/byows.py,sha256=XNornG5rOocALBtCeJ_9O91AHAFnR5v6CVr5Aen9l1o,18339
 snapctl/commands/game.py,sha256=lAABIWIibrwcqvpKvTy_7UzzLtbiP6gdk4_qPBHFKOI,5248
 snapctl/commands/generate.py,sha256=9-NlZVQllBT2LZT_t9S3ztwtHzTbM-C8_x0f6z70U3g,5606
 snapctl/commands/release_notes.py,sha256=QlhBlywLiRTKBs3SlaxHf-0E0OEU_47Xjld9gGtj4Zw,1943
 snapctl/commands/snapend.py,sha256=4hY4ffLtZ2mxbKRgwDPi8erc78nGl-6kxmCf56HODpk,39382
 snapctl/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-snapctl/config/constants.py,sha256=CTUzo_jPrVtXe7MrhiNESTTyQ4nHdRmTg2VHhaSsTVA,3716
+snapctl/config/constants.py,sha256=Tb1mxr4ySAciFpt896sjPs8rJSKKIIVa1S7YYyY0fzQ,3716
 snapctl/config/endpoints.py,sha256=jD0n5ocJBbIkrb97F2_r9hqAHzUuddAqzqqBAPUKDTI,477
 snapctl/config/hashes.py,sha256=3OKAyOxQPnn--_hvPIzFJnhC8NVfQK4WT-RH4PHEV1w,5242
 snapctl/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -28,15 +28,15 @@ snapctl/data/releases/beta-0.49.0.mdx,sha256=pqJP7NfM3ZMxs4SoeANCdDqTxjR9IBGbBI3
 snapctl/data/releases/beta-0.49.1.mdx,sha256=4EXupEegYffnL5bu_XWxGbzIPp9xOzl7t4xbmhq52fU,200
 snapctl/data/releases/beta-0.49.2.mdx,sha256=Vv_OIQyPieEGI9FgTUT0v5Gm0PC2JWa2FqcCUhnvx6s,176
 snapctl/data/releases/beta-0.49.3.mdx,sha256=XmSfpiH-LqvKS2REJ5FGDcLgyEN-OcSzwrXNI_EhiGc,234
-snapctl/data/releases/beta-0.49.4.mdx,sha256=olSEvzwrBgp6TfVYehYslhGrjLXz1EcybTmbXUmtA18,161
-snapctl/main.py,sha256=6EDEQlcF3GPSqH3-Ezl7bkI33ZKaFR_c55B0Dkt0pDM,25212
+snapctl/data/releases/beta-0.50.0.mdx,sha256=_w9f1HjHqukQ8IaTfUdk2W3gBcSwjMyMA8-rjuUxYTo,399
+snapctl/main.py,sha256=3J0rPUichWZ_q9vR6bxgrepGJWoZiVSBJFoTmiUFIm8,25213
 snapctl/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 snapctl/types/definitions.py,sha256=EQzLeiXkJ8ISRlCqHMviNVsWWpmhWjpKaOBLdlvOTmY,644
 snapctl/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-snapctl/utils/echo.py,sha256=V0qgjqqGXRiueMkq31enmNmdqciC8S90qGRcK8UupXA,1090
+snapctl/utils/echo.py,sha256=9fxrPW9kNJwiJvJBFy9RlAP4qGRcPTOHfQb3pQh3CMg,1446
 snapctl/utils/helper.py,sha256=7ugGs1GE7Rywf1-tQxrgqXUU97EQYFjS3JUDpk9SX_Q,6850
-snapctl-0.49.4.dist-info/LICENSE,sha256=6AcXm54KFSpmUI1ji9NIBd4Xl-DtjTqiyjBzfVb_CEk,2804
-snapctl-0.49.4.dist-info/METADATA,sha256=LDD9RPdA6elzjHoCx4qVnGl1YtVtOUtev61U2jvFU6k,36275
-snapctl-0.49.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-snapctl-0.49.4.dist-info/entry_points.txt,sha256=tkKW9MzmFdRs6Bgkv29G78i9WEBK4WIOWunPfe3t2Wg,44
-snapctl-0.49.4.dist-info/RECORD,,
+snapctl-0.50.0.dist-info/LICENSE,sha256=6AcXm54KFSpmUI1ji9NIBd4Xl-DtjTqiyjBzfVb_CEk,2804
+snapctl-0.50.0.dist-info/METADATA,sha256=Ay4j3Hyu0PhG7pVCDeT9XJQevCW-EJEWoTtOBV4X41s,36275
+snapctl-0.50.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+snapctl-0.50.0.dist-info/entry_points.txt,sha256=tkKW9MzmFdRs6Bgkv29G78i9WEBK4WIOWunPfe3t2Wg,44
+snapctl-0.50.0.dist-info/RECORD,,

snapctl/data/releases/beta-0.49.4.mdx

@@ -1,8 +0,0 @@
-## beta-0.49.4
-##### May 20, 2025
-
-### Bug Fixes
-
-#### Bring your own workstation (BYOW)
-- Environment exports no longer include hyphens in the variable names.
-