qbraid-cli 0.8.1a0__py3-none-any.whl → 0.8.2__py3-none-any.whl

qbraid_cli/_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.8.1a0'
-__version_tuple__ = version_tuple = (0, 8, 1)
+__version__ = version = '0.8.2'
+__version_tuple__ = version_tuple = (0, 8, 2)

qbraid_cli/admin/__init__.py

@@ -7,3 +7,5 @@ Module defining the qbraid admin namespace
 """
 
 from .app import admin_app
+
+__all__ = ["admin_app"]

qbraid_cli/admin/app.py

@@ -3,21 +3,20 @@
 
 """
 Module defining commands in the 'qbraid admin' namespace.
-
 """
 
 from typing import List
 
 import typer
 
+from qbraid_cli.admin.buildlogs import buildlogs_app
 from qbraid_cli.admin.headers import check_and_fix_headers
 from qbraid_cli.admin.validation import validate_header_type, validate_paths_exist
 
-# disable pretty_exceptions_show_locals to avoid printing sensative information in the traceback
 admin_app = typer.Typer(
-    help="CI/CD commands for qBraid maintainers.",
-    pretty_exceptions_show_locals=False,
+    help="CI/CD commands for qBraid maintainers.", pretty_exceptions_show_locals=False
 )
+admin_app.add_typer(buildlogs_app, name="buildlogs")
 
 
 @admin_app.command(name="headers")

qbraid_cli/admin/buildlogs.py

@@ -0,0 +1,114 @@
+# Copyright (c) 2024, qBraid Development Team
+# All rights reserved.
+
+"""
+Module defining commands in the 'qbraid admin buildlogs' namespace.
+
+This module uses the Typer library to create CLI commands for managing Docker builds and logs
+in an administrative context.
+"""
+
+import json
+
+import typer
+from qbraid_core.exceptions import RequestsApiError
+from qbraid_core.services.admin.client import AdminClient
+from rich.console import Console
+
+from qbraid_cli.handlers import handle_error
+
+buildlogs_app = typer.Typer(
+    help="Manage qBraid containerized services logs.", pretty_exceptions_show_locals=False
+)
+console = Console()
+
+
+@buildlogs_app.command(name="get")
+def get_docker_build_logs(
+    build_id: str = typer.Option(None, "--build_id", "-b", help="Name of the build ID")
+) -> None:
+    """
+    Fetches and displays Docker build logs for a specified build ID.
+
+    Args:
+        build_id (str, optional): The unique identifier for the Docker build.
+
+    This function queries the administrative backend to retrieve and display build logs.
+    If a build ID is provided, it will retrieve and display logs specific to that build ID.
+    If build ID not provided, fetches all logs.
+    """
+    client = AdminClient()
+
+    build_log = client.get_docker_build_logs(build_id)
+    if build_id and "buildLogs" in build_log and build_log["buildLogs"]:
+        log_entry = build_log["buildLogs"][0]
+        console.print(log_entry)
+    else:
+        console.print(build_log)
+
+
+@buildlogs_app.command(name="post")
+def post_docker_build_log(
+    data: str = typer.Option(..., "--data", "-d", help="Data to post to Docker logs")
+) -> None:
+    """
+    Posts a new Docker build log entry.
+
+    Args:
+        data (str): JSON string containing the data to be logged.
+
+    This command converts a JSON string into a dictionary and sends it to the backend service
+    to create a new Docker build log.
+    """
+    client = AdminClient()
+
+    try:
+        data_dict = json.loads(data)
+        console.print(client.post_docker_build_logs(data_dict))
+    except RequestsApiError:
+        handle_error(message="Couldn't post a build_log.")
+
+
+@buildlogs_app.command(name="put")
+def put_docker_build_log(
+    build_id: str = typer.Option(..., "--build_id", "-b", help="Name of the build ID"),
+    data: str = typer.Option(..., "--data", "-d", help="Data to post to Docker logs"),
+) -> None:
+    """
+    Updates an existing Docker build log entry by a given build ID.
+
+    Args:
+        build_id (str): The unique identifier of the Docker build to update.
+        data (str): JSON string containing the updated data for the log.
+
+    This command updates a Docker build log entry, identified by the provided build ID,
+    with the new data provided in JSON format.
+    """
+    client = AdminClient()
+
+    try:
+        data_dict = json.loads(data)
+        console.print(client.put_docker_build_logs(build_id, data_dict))
+    except RequestsApiError:
+        handle_error(message="Couldn't post a build_log.")
+
+
+@buildlogs_app.command(name="delete")
+def delete_docker_build_log(
+    build_id: str = typer.Option(..., "--build_id", "-b", help="ID of the build log to delete")
+) -> None:
+    """
+    Deletes a Docker build log entry by a specified build ID.
+
+    Args:
+        build_id (str): The unique identifier of the Docker build log to delete.
+
+    This command sends a request to delete a Docker build log identified by the provided build ID.
+    """
+    client = AdminClient()
+
+    console.print(client.delete_docker_build_logs(build_id))
+
+
+if __name__ == "__main__":
+    buildlogs_app()

qbraid_cli/configure/__init__.py

@@ -7,3 +7,5 @@ Module defining the qbraid configure namespace
 """
 
 from .app import configure_app
+
+__all__ = ["configure_app"]

qbraid_cli/credits/__init__.py

@@ -7,3 +7,5 @@ Module defining the qbraid credits namespace
 """
 
 from .app import credits_app
+
+__all__ = ["credits_app"]

qbraid_cli/devices/__init__.py

@@ -7,3 +7,5 @@ Module defining the qbraid devices namespace
 """
 
 from .app import devices_app
+
+__all__ = ["devices_app"]

qbraid_cli/envs/__init__.py

@@ -7,3 +7,5 @@ Module defining the qbraid envs namespace
 """
 
 from .app import envs_app
+
+__all__ = ["envs_app"]

qbraid_cli/envs/app.py

@@ -10,14 +10,19 @@ import shutil
 import subprocess
 import sys
 from pathlib import Path
-from typing import Any, Dict, Optional, Tuple
+from typing import TYPE_CHECKING, Optional, Tuple
 
 import typer
 from rich.console import Console
 
-from qbraid_cli.envs.data_handling import installed_envs_data, request_delete_env, validate_env_name
+from qbraid_cli.envs.create import create_qbraid_env_assets, create_venv
+from qbraid_cli.envs.data_handling import get_envs_data as installed_envs_data
+from qbraid_cli.envs.data_handling import validate_env_name
 from qbraid_cli.handlers import QbraidException, run_progress_task
 
+if TYPE_CHECKING:
+    from qbraid_core.services.environments.client import EnvironmentManagerClient as EMC
+
 envs_app = typer.Typer(help="Manage qBraid environments.")
 
 
@@ -34,25 +39,14 @@ def envs_create(  # pylint: disable=too-many-statements
     ),
 ) -> None:
     """Create a new qBraid environment."""
-    from .create import create_qbraid_env_assets, create_venv
-
-    def request_new_env(req_body: Dict[str, str]) -> Dict[str, Any]:
-        """Send request to create new environment and return the slug."""
-        from qbraid_core import QbraidSession, RequestsApiError
-
-        session = QbraidSession()
-
-        try:
-            env_data = session.post("/environments/create", json=req_body).json()
-        except RequestsApiError as err:
-            raise QbraidException("Create environment request failed") from err
+    env_description = description or ""
 
-        if env_data is None or len(env_data) == 0 or env_data.get("slug") is None:
-            raise QbraidException(
-                "Create environment request responsed with invalid environment data"
-            )
+    def create_environment(*args, **kwargs) -> "Tuple[dict, EMC]":
+        """Create a qBraid environment."""
+        from qbraid_core.services.environments.client import EnvironmentManagerClient
 
-        return env_data
+        client = EnvironmentManagerClient()
+        return client.create_environment(*args, **kwargs), client
 
     def gather_local_data() -> Tuple[Path, str]:
         """Gather environment data and return the slug."""
@@ -71,20 +65,10 @@ def envs_create(  # pylint: disable=too-many-statements
 
         return env_path, python_version
 
-    req_body = {
-        "name": name,
-        "description": description or "",
-        "tags": "",  # comma separated list of tags
-        "code": "",  # newline separated list of packages
-        "visibility": "private",
-        "kernelName": "",
-        "prompt": "",
-        "origin": "CLI",
-    }
-
-    environment = run_progress_task(
-        request_new_env,
-        req_body,
+    environment, emc = run_progress_task(
+        create_environment,
+        name,
+        env_description,
         description="Validating request...",
         error_message="Failed to create qBraid environment",
     )
@@ -94,7 +78,6 @@ def envs_create(  # pylint: disable=too-many-statements
         description="Solving environment...",
         error_message="Failed to create qBraid environment",
     )
-
     slug = environment.get("slug")
     display_name = environment.get("displayName")
     prompt = environment.get("prompt")
@@ -120,7 +103,7 @@ def envs_create(  # pylint: disable=too-many-statements
     user_confirmation = auto_confirm or typer.confirm("Proceed", default=True)
     typer.echo("")
     if not user_confirmation:
-        request_delete_env(slug)
+        emc.delete_environment(slug)
         typer.echo("qBraidSystemExit: Exiting.")
         raise typer.Exit()
 
@@ -165,6 +148,13 @@ def envs_remove(
 ) -> None:
     """Delete a qBraid environment."""
 
+    def delete_environment(slug: str) -> None:
+        """Delete a qBraid environment."""
+        from qbraid_core.services.environments.client import EnvironmentManagerClient
+
+        emc = EnvironmentManagerClient()
+        emc.delete_environment(slug)
+
     def gather_local_data(env_name: str) -> Tuple[Path, str]:
         """Get environment path and slug from name (alias)."""
         installed, aliases = installed_envs_data()
@@ -190,7 +180,7 @@ def envs_remove(
     if auto_confirm or typer.confirm(confirmation_message, abort=True):
         typer.echo("")
         run_progress_task(
-            request_delete_env,
+            delete_environment,
             slug,
             description="Deleting remote environment data...",
             error_message="Failed to delete qBraid environment",

qbraid_cli/envs/create.py

@@ -5,93 +5,29 @@
 Module supporting 'qbraid envs create' command.
 
 """
-
 import json
 import os
 import shutil
-import subprocess
 import sys
-from typing import Optional
-
-
-def replace_str(target: str, replacement: str, file_path: str) -> None:
-    """Replace all instances of string in file"""
-    with open(file_path, "r", encoding="utf-8") as file:
-        content = file.read()
-
-    content = content.replace(target, replacement)
-
-    with open(file_path, "w", encoding="utf-8") as file:
-        file.write(content)
-
-
-def update_state_json(
-    slug_path: str,
-    install_complete: int,
-    install_success: int,
-    message: Optional[str] = None,
-    env_name: Optional[str] = None,
-) -> None:
-    """Update environment's install status values in a JSON file.
-    Truth table values: 0 = False, 1 = True, -1 = Unknown
-    """
-    # Set default message if none provided
-    message = "" if message is None else message.replace("\n", " ")
-
-    # File path for state.json
-    state_json_path = os.path.join(slug_path, "state.json")
 
-    # Read existing data or use default structure
-    if os.path.exists(state_json_path):
-        with open(state_json_path, "r", encoding="utf-8") as f:
-            data = json.load(f)
-    else:
-        data = {"install": {}}
-
-    # Update the data
-    data["install"]["complete"] = install_complete
-    data["install"]["success"] = install_success
-    data["install"]["message"] = message
-
-    if env_name is not None:
-        data["name"] = env_name
-
-    # Write updated data back to state.json
-    with open(state_json_path, "w", encoding="utf-8") as f:
-        json.dump(data, f, indent=4)
 
+def create_venv(*args, **kwargs) -> None:
+    """Create a python virtual environment for the qBraid environment."""
+    from qbraid_core.services.environments import create_local_venv
 
-def create_venv(slug_path: str, prompt: str) -> None:
-    """Create virtual environment and swap PS1 display name."""
-    venv_path = os.path.join(slug_path, "pyenv")
-    subprocess.run([sys.executable, "-m", "venv", venv_path], check=True)
+    return create_local_venv(*args, **kwargs)
 
-    # Determine the correct directory for activation scripts based on the operating system
-    if sys.platform == "win32":
-        scripts_path = os.path.join(venv_path, "Scripts")
-        activate_files = ["activate.bat", "Activate.ps1"]
-    else:
-        scripts_path = os.path.join(venv_path, "bin")
-        activate_files = ["activate", "activate.csh", "activate.fish"]
 
-    for file in activate_files:
-        file_path = os.path.join(scripts_path, file)
-        if os.path.isfile(file_path):
-            replace_str("(pyenv)", f"({prompt})", file_path)
+def update_state_json(*ags, **kwargs) -> None:
+    """Update the state.json file for the qBraid environment."""
+    from qbraid_core.services.environments.state import update_install_status
 
-    replace_str(
-        "include-system-site-packages = false",
-        "include-system-site-packages = true",
-        os.path.join(venv_path, "pyvenv.cfg"),
-    )
-
-    update_state_json(slug_path, 1, 1)
+    return update_install_status(*ags, **kwargs)
 
 
 def create_qbraid_env_assets(slug: str, alias: str, kernel_name: str, slug_path: str) -> None:
     """Create a qBraid environment including python venv, PS1 configs,
     kernel resource files, and qBraid state.json."""
-    # pylint: disable-next=import-outside-toplevel
     from jupyter_client.kernelspec import KernelSpecManager
 
     local_resource_dir = os.path.join(slug_path, "kernels", f"python3_{slug}")
@@ -123,6 +59,3 @@ def create_qbraid_env_assets(slug: str, alias: str, kernel_name: str, slug_path:
         loc_path = os.path.join(local_resource_dir, file)
         if os.path.isfile(sys_path):
             shutil.copy(sys_path, loc_path)
-
-    # create python venv
-    create_venv(slug_path, alias)

qbraid_cli/envs/data_handling.py

@@ -6,85 +6,23 @@ Module for handling data related to qBraid environments.
 
 """
 
-import json
-import keyword
-import re
-from pathlib import Path
-from typing import Dict, List, Tuple
-
 import typer
 
 from qbraid_cli.handlers import QbraidException
 
 
-def is_valid_env_name(env_name: str) -> bool:  # pylint: disable=too-many-return-statements
-    """
-    Validates a Python virtual environment name against best practices.
-
-    This function checks if the given environment name is valid based on certain
-    criteria, including length, use of special characters, reserved names, and
-    operating system-specific restrictions.
-
-    Args:
-        env_name (str): The name of the Python virtual environment to validate.
-
-    Returns:
-        bool: True if the name is valid, False otherwise.
-
-    Raises:
-        ValueError: If the environment name is not a string or is empty.
-    """
-    # Basic checks for empty names or purely whitespace names
-    if not env_name or env_name.isspace():
-        return False
-
-    # Check for invalid characters, including shell metacharacters and spaces
-    if re.search(r'[<>:"/\\|?*\s&;()$[\]#~!{}]', env_name):
-        return False
-
-    if env_name.startswith("tmp"):
-        return False
-
-    # Reserved names for Windows (example list, can be expanded)
-    reserved_names = [
-        "CON",
-        "PRN",
-        "AUX",
-        "NUL",
-        "COM1",
-        "COM2",
-        "COM3",
-        "COM4",
-        "COM5",
-        "COM6",
-        "COM7",
-        "COM8",
-        "COM9",
-        "LPT1",
-        "LPT2",
-        "LPT3",
-        "LPT4",
-        "LPT5",
-        "LPT6",
-        "LPT7",
-        "LPT8",
-        "LPT9",
-    ]
-    if env_name.upper() in reserved_names:
-        return False
-
-    if len(env_name) > 20:
-        return False
-
-    # Check against Python reserved words
-    if keyword.iskeyword(env_name):
-        return False
-
-    # Check if it starts with a number, which is not a good practice
-    if env_name[0].isdigit():
-        return False
-
-    return True
+def get_envs_data(*args, **kwargs) -> dict:
+    """Get data for installed environments."""
+    from qbraid_core.services.environments.paths import installed_envs_data
+
+    return installed_envs_data(*args, **kwargs)
+
+
+def is_valid_env_name(value: str) -> bool:
+    """Check if a given string is a valid Python environment name."""
+    from qbraid_core.services.environments.validate import is_valid_env_name as is_valid
+
+    return is_valid(value)
 
 
 def validate_env_name(value: str) -> str:
@@ -96,38 +34,6 @@ def validate_env_name(value: str) -> str:
     return value
 
 
-def installed_envs_data() -> Tuple[Dict[str, Path], Dict[str, str]]:
-    """Gather paths and aliases for all installed qBraid environments."""
-    from qbraid_core.services.environments.paths import get_default_envs_paths, is_valid_slug
-
-    installed = {}
-    aliases = {}
-
-    qbraid_env_paths: List[Path] = get_default_envs_paths()
-
-    for env_path in qbraid_env_paths:
-        for entry in env_path.iterdir():
-            if entry.is_dir() and is_valid_slug(entry.name):
-                installed[entry.name] = entry
-
-                if entry.name == "qbraid_000000":
-                    aliases["default"] = entry.name
-                    continue
-
-                state_json_path = entry / "state.json"
-                if state_json_path.exists():
-                    try:
-                        with open(state_json_path, "r", encoding="utf-8") as f:
-                            data = json.load(f)
-                        aliases[data.get("name", entry.name[:-7])] = entry.name
-                    # pylint: disable-next=broad-exception-caught
-                    except (json.JSONDecodeError, Exception):
-                        aliases[entry.name[:-7]] = entry.name
-                else:
-                    aliases[entry.name[:-7]] = entry.name
-    return installed, aliases
-
-
 def request_delete_env(slug: str) -> str:
     """Send request to delete environment given slug."""
     from qbraid_core import QbraidSession, RequestsApiError

qbraid_cli/jobs/__init__.py

@@ -7,3 +7,5 @@ Module defining the qbraid jobs namespace
 """
 
 from .app import jobs_app
+
+__all__ = ["jobs_app"]

qbraid_cli/jobs/toggle_braket.py

@@ -36,13 +36,10 @@ def get_package_data(package: str) -> Tuple[str, str, str, str]:
 
     """
     # pylint: disable=import-outside-toplevel
-    from qbraid_core.system import (
-        QbraidSystemError,
-        get_active_python_path,
-        get_active_site_packages_path,
-        get_latest_package_version,
-        get_local_package_version,
-    )
+    from qbraid_core.system.exceptions import QbraidSystemError
+    from qbraid_core.system.executables import get_active_python_path
+    from qbraid_core.system.packages import get_active_site_packages_path
+    from qbraid_core.system.versions import get_latest_package_version, get_local_package_version
 
     try:
         python_pathlib = get_active_python_path()

qbraid_cli/kernels/__init__.py

@@ -7,3 +7,5 @@ Module defining the qbraid kernels namespace
 """
 
 from .app import kernels_app
+
+__all__ = ["kernels_app"]

qbraid_cli/kernels/app.py

@@ -12,7 +12,6 @@ import typer
 from jupyter_client.kernelspec import KernelSpecManager
 from rich.console import Console
 
-from qbraid_cli.envs.data_handling import installed_envs_data
 from qbraid_cli.handlers import handle_error
 
 kernels_app = typer.Typer(help="Manage qBraid kernels.")
@@ -20,6 +19,9 @@ kernels_app = typer.Typer(help="Manage qBraid kernels.")
 
 def _get_kernels_path(environment: str) -> Path:
     """Get the path to the kernels directory for the given environment."""
+    # pylint: disable-next=import-outside-toplevel
+    from qbraid_core.services.environments.paths import installed_envs_data
+
     slug_to_path, name_to_slug = installed_envs_data()
 
     if environment in name_to_slug:

qbraid_cli/main.py

@@ -15,6 +15,7 @@ from qbraid_cli.devices.app import devices_app
 from qbraid_cli.envs.app import envs_app
 from qbraid_cli.jobs.app import jobs_app
 from qbraid_cli.kernels.app import kernels_app
+from qbraid_cli.pip.app import pip_app
 
 app = typer.Typer(context_settings={"help_option_names": ["-h", "--help"]})
 
@@ -25,6 +26,7 @@ app.add_typer(devices_app, name="devices")
 app.add_typer(envs_app, name="envs")
 app.add_typer(jobs_app, name="jobs")
 app.add_typer(kernels_app, name="kernels")
+app.add_typer(pip_app, name="pip")
 
 
 def version_callback(value: bool):

qbraid_cli/pip/__init__.py

@@ -0,0 +1,11 @@
+# Copyright (c) 2024, qBraid Development Team
+# All rights reserved.
+
+"""
+Module defining the qbraid pip namespace
+
+"""
+
+from .app import pip_app
+
+__all__ = ["pip_app"]

qbraid_cli/pip/app.py

@@ -0,0 +1,50 @@
+# Copyright (c) 2024, qBraid Development Team
+# All rights reserved.
+
+"""
+Module defining commands in the 'qbraid pip' namespace.
+
+"""
+import subprocess
+import sys
+
+import typer
+from qbraid_core.system.exceptions import QbraidSystemError
+from qbraid_core.system.executables import get_active_python_path
+
+from qbraid_cli.handlers import handle_error
+from qbraid_cli.pip.hooks import get_env_cfg_path, safe_set_include_sys_packages
+
+# disable pretty_exceptions_show_locals to avoid printing sensative information in the traceback
+pip_app = typer.Typer(help="Run pip command in active qBraid environment.")
+
+
+@pip_app.command(
+    "install", context_settings={"allow_extra_args": True, "ignore_unknown_options": True}
+)
+def pip_install(ctx: typer.Context):
+    """
+    Perform pip install action with open-ended arguments and options.
+
+    """
+    try:
+        python_exe = get_active_python_path()
+        cfg_path = get_env_cfg_path(python_exe)
+    except QbraidSystemError:
+        python_exe = sys.executable
+        cfg_path = None
+
+    safe_set_include_sys_packages(False, cfg_path)
+
+    command = [str(python_exe), "-m", "pip", "install"] + ctx.args
+
+    try:
+        subprocess.check_call(command)
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        handle_error(message="Failed carry-out pip command.")
+    finally:
+        safe_set_include_sys_packages(True, cfg_path)
+
+
+if __name__ == "__main__":
+    pip_app()

qbraid_cli/pip/hooks.py

@@ -0,0 +1,73 @@
+# Copyright (c) 2024, qBraid Development Team
+# All rights reserved.
+
+"""
+Module defining pre- and post-command hooks for the 'qbraid pip' namespace.
+
+"""
+import sys
+from pathlib import Path
+from typing import Optional, Union
+
+from qbraid_core.services.environments import get_default_envs_paths
+from qbraid_core.system.executables import python_paths_equivalent
+from qbraid_core.system.packages import (
+    extract_include_sys_site_pkgs_value,
+    set_include_sys_site_pkgs_value,
+)
+
+
+def safe_set_include_sys_packages(value: bool, file_path: Optional[Union[str, Path]]) -> None:
+    """Set include-system-site-packages value safely"""
+    if not file_path:
+        return None
+
+    try:
+        set_include_sys_site_pkgs_value(value, file_path)
+    except Exception:  # pylint: disable=broad-exception-caught
+        pass
+
+    return None
+
+
+def find_matching_prefix(python_executable: Path, path_list: list[Path]) -> Optional[Path]:
+    """
+    Finds and returns the first path in the list that is a prefix of the Python executable path.
+
+    Args:
+        python_executable (Path): The path to the Python executable.
+        path_list (List[Path]): A list of paths to check against the Python executable path.
+
+    Returns:
+        Optional[Path]: The first matching path that is a prefix of the Python executable path,
+                        or None if no match is found.
+    """
+    python_executable_str = str(python_executable.resolve())
+    for path in path_list:
+        if python_executable_str.startswith(str(path.resolve())):
+            return path
+    return None
+
+
+def get_env_cfg_path(python_exe: Path) -> Optional[Path]:
+    """Get the path to the pyvenv.cfg file."""
+    is_sys_python = python_paths_equivalent(python_exe, sys.executable)
+
+    if is_sys_python:
+        return None
+
+    all_envs_paths = get_default_envs_paths()
+
+    env_path = find_matching_prefix(python_exe, all_envs_paths)
+
+    if not env_path:
+        return None
+
+    cfg_path = env_path / "pyvenv.cfg"
+
+    should_flip = extract_include_sys_site_pkgs_value(cfg_path)
+
+    if should_flip:
+        return cfg_path
+
+    return None

qbraid_cli-0.8.2.dist-info/LICENSE

@@ -0,0 +1,41 @@
+qBraid Closed-Source Software License
+
+Copyright (c) 2024, qBraid Development Team
+
+All rights reserved.
+
+This license agreement ("License") is between the qBraid Development Team ("Author") and you, the Licensee. By using or distributing the qBraid ("Software"), you agree to the following terms:
+
+1. Grant of License.
+
+   Subject to the terms of this License, the Author grants you a non-exclusive, non-transferable license to use the Software for personal, academic, and educational purposes. Use of the Software for commercial purposes is strictly prohibited unless express permission is granted by the Author.
+
+2. Distribution.
+
+   You may distribute the Software to others, provided that any such distribution is made under the same terms of this License. Modifications to the Software may not be distributed.
+
+3. Modification.
+
+   You are permitted to modify the Software for personal use. You may contribute improvements or bug fixes back to the Author or the community, but you may not distribute the modifications.
+
+4. Commercial Use.
+
+   The Software may not be used for commercial purposes without explicit, prior written permission from the Author. Permissions for commercial use will be considered on a case-by-case basis.
+
+5. Attribution
+
+   If the Software is used in a non-private setting, including but not limited to academic work, commercial settings, or published literature, attribution must be given to the "qBraid Jupyter Environment Manager authored by the qBraid Development Team."
+
+6. Disclaimer of Warranty.
+
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+7. Limitation of Liability.
+
+   IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+8. Termination.
+
+   This License is effective until terminated. Your rights under this License will terminate automatically without notice from the Author if you fail to comply with any term(s) of this License.
+
+By using the Software, you agree to be bound by the terms of this License. Redistribution of the Software or use of the Software other than as specifically authorized under this License is prohibited and may result in severe civil and criminal penalties.

{qbraid_cli-0.8.1a0.dist-info → qbraid_cli-0.8.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: qbraid-cli
-Version: 0.8.1a0
+Version: 0.8.2
 Summary: Command Line Interface for interacting with all parts of the qBraid platform.
 Author-email: qBraid Development Team <contact@qbraid.com>
 License: Proprietary
@@ -26,24 +26,17 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: typer >=0.12.1
 Requires-Dist: rich >=10.11.0
 Requires-Dist: jupyter-client <9.0.0,>=7.0.0
 Requires-Dist: ipykernel
-Requires-Dist: qbraid-core >=0.1.4
+Requires-Dist: qbraid-core >=0.1.13
 Provides-Extra: dev
-Requires-Dist: black ; extra == 'dev'
+Requires-Dist: ruff ; extra == 'dev'
 Requires-Dist: isort ; extra == 'dev'
-Requires-Dist: pylint ; extra == 'dev'
+Requires-Dist: black ; extra == 'dev'
 Requires-Dist: pytest ; extra == 'dev'
-Provides-Extra: docs
-Requires-Dist: sphinx <7.4.0,>=7.2.6 ; extra == 'docs'
-Requires-Dist: sphinx-rtd-theme <2.1,>=1.3 ; extra == 'docs'
-Requires-Dist: docutils <0.22 ; extra == 'docs'
-Requires-Dist: toml ; extra == 'docs'
-Requires-Dist: build ; extra == 'docs'
-Requires-Dist: m2r ; extra == 'docs'
-Requires-Dist: typer ; extra == 'docs'
 Provides-Extra: jobs
 Requires-Dist: amazon-braket-sdk >=1.48.1 ; extra == 'jobs'
 
@@ -54,7 +47,6 @@ Requires-Dist: amazon-braket-sdk >=1.48.1 ; extra == 'jobs'
 [![Python verions](https://img.shields.io/pypi/pyversions/qbraid-cli.svg?color=blue)](https://pypi.org/project/qbraid-cli/)
 [![Downloads](https://static.pepy.tech/badge/qbraid-cli)](https://pepy.tech/project/qbraid-cli)
 [![GitHub](https://img.shields.io/badge/issue_tracking-github-blue?logo=github)](https://github.com/qBraid/qBraid-Lab/issues)
-[![Discord](https://img.shields.io/discord/771898982564626445.svg?color=pink)](https://discord.gg/KugF6Cnncm)
 
 Command Line Interface for interacting with all parts of the qBraid platform.
 
@@ -71,7 +63,7 @@ For help, see qBraid Lab User Guide: [Getting Started](https://docs.qbraid.com/p
 
 You can also install the qBraid-CLI from PyPI with:
 
-```shell
+```bash
 pip install qbraid-cli
 ```
 
@@ -85,13 +77,13 @@ After installation, you must configure your account credentials to use the CLI l
     your [account page](https://account.qbraid.com/):
 3. Save your API key from step 2 in local configuration file `~/.qbraid/qbraidrc` using:
 
-```shell
+```bash
 $ qbraid configure
 ```
 
 ## Basic Commands
 
-```shell
+```bash
 $ qbraid
 ----------------------------------
   * Welcome to the qBraid CLI! * 
@@ -114,19 +106,19 @@ Reference Docs: https://docs.qbraid.com/projects/cli/en/stable/guide/overview.ht
 
 A qBraid CLI command has the following structure:
 
-```shell
+```bash
 $ qbraid <command> <subcommand> [options and parameters]
 ```
 
 For example, to list installed environments, the command would be:
 
-```shell
+```bash
 $ qbraid envs list
 ```
 
 To view help documentation, use one of the following:
 
-```shell
+```bash
 $ qbraid --help
 $ qbraid <command> --help
 $ qbraid <command> <subcommand> --help
@@ -134,7 +126,7 @@ $ qbraid <command> <subcommand> --help
 
 For example:
 
-```shell
+```bash
 $ qbraid --help
 
 Usage: qbraid [OPTIONS] COMMAND [ARGS]...
@@ -158,7 +150,7 @@ Commands
 
 To get the version of the qBraid CLI:
 
-```shell
+```bash
 $ qbraid --version
 ```
 
@@ -166,7 +158,7 @@ $ qbraid --version
 
 You can also access the CLI directly from within [Notebooks](https://docs.qbraid.com/projects/lab/en/latest/lab/notebooks.html) using IPython [magic commands](https://ipython.readthedocs.io/en/stable/interactive/magics.html). First, configure the qBraid magic commands extension using:
 
-```shell
+```bash
 $ qbraid configure magic
 ```
 

qbraid_cli-0.8.2.dist-info/RECORD

@@ -0,0 +1,39 @@
+qbraid_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+qbraid_cli/_version.py,sha256=t6tJJG56wlBKsg_0M1Q4l1ir09jgXRw1tolMbDalW9g,411
+qbraid_cli/exceptions.py,sha256=KjlhYJhSHMVazaNiBjD_Ur06w4sekP8zRsFzBdyIpno,672
+qbraid_cli/handlers.py,sha256=glxTEwxax3zKgYl9qsZ2evZXgrWQrseJS_OGyHTMFeA,7040
+qbraid_cli/main.py,sha256=eRgBEYj9WPxHqTbSQvlV39yaDje-6yvZdrTnw5UQbQY,2638
+qbraid_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+qbraid_cli/admin/__init__.py,sha256=qcWD5mQEUCtr49mrUpZmk7eGDe0L_Gtc8RwZmzIXSwo,175
+qbraid_cli/admin/app.py,sha256=ZyTBkEvlAR-xK3fbC32yntsE3rywzL4WHjJzRTFTlzs,1454
+qbraid_cli/admin/buildlogs.py,sha256=1i7CRpkIHIcKgGvHesPr9duCkyV7M-MESaHI5Z3ZdD0,3578
+qbraid_cli/admin/headers.py,sha256=E6mE3odZL57VfHHZxYtRUkqMKmrmT4zuUoINzI7eJF8,6435
+qbraid_cli/admin/validation.py,sha256=LkAVXlHtM0MhCa34MIWrfX59wGXMVlZmdVB4-AQ8fBk,1003
+qbraid_cli/configure/__init__.py,sha256=YaJ74Ztz2vl3eYp8_jVBucWkXscxz7EZEIzr70OfuOM,187
+qbraid_cli/configure/actions.py,sha256=3rrWHaCAsogyx0Ll-lcjbSzldD4kPuz1z6VQiWebSWw,3203
+qbraid_cli/configure/app.py,sha256=1uRe2lkUA4TtYb5b4mbD4LH-cKCbsZGT3Wfk7fpNzX0,2414
+qbraid_cli/credits/__init__.py,sha256=MJhgWgpFT1_886sB-_POlRs1y3SRy23HIrKVBkp0X-Y,181
+qbraid_cli/credits/app.py,sha256=AY3qtveO50KeQ2XREiEVqUcTrESgRuoqt9pt2Z8t4Y0,866
+qbraid_cli/devices/__init__.py,sha256=hiScO-px6jCL5cJj5Hbty55EUfNejTO4bmqUZuS3aqc,181
+qbraid_cli/devices/app.py,sha256=zxSxrEQn7irkJoME4S_CBnRqWeB8cqPaBsIMfpdYFk0,2530
+qbraid_cli/devices/validation.py,sha256=YhShyUufgrKnx2XjXOXF-PqFJYklJT9CgeqIwKcNam4,809
+qbraid_cli/envs/__init__.py,sha256=1-cMvrATsddYxcetPJWxq6bEOqJWMktGdhoZ4qm8euA,172
+qbraid_cli/envs/activate.py,sha256=VpvVYSfQDlcmlNWJOgkLIQ2p8YXPPLG8Jbl5t8GHUDw,2140
+qbraid_cli/envs/app.py,sha256=PD7U-zdQeoWPXPRpmKC3nwDVOfa69dk5GCIsE3mpla8,8411
+qbraid_cli/envs/create.py,sha256=HxNciItDoGC5jqiruHm0oUfNSqtuDfzE-ro4ztGUh5Q,2185
+qbraid_cli/envs/data_handling.py,sha256=Ibnp2yJoUDpivb_sNqi0suYgJZNat_LmM6Ya0Ovez5s,1288
+qbraid_cli/jobs/__init__.py,sha256=qVLRHYIzP4XHpx_QWP_vCzd3LsCscCORaEx-Vcbx29U,172
+qbraid_cli/jobs/app.py,sha256=kmg9mYla3Nd7EdjQlFu7IOvm7sejLNfPPA6Qeet-IfE,4898
+qbraid_cli/jobs/toggle_braket.py,sha256=QVW69MkFyhMZWg_Cl48GgScC084aAG3EgYbyy-PGkqI,6756
+qbraid_cli/jobs/validation.py,sha256=xNbjUggMhUs4wzkuRm4PuFPi_wrElYicUgYXLznHz3U,2983
+qbraid_cli/kernels/__init__.py,sha256=jORS9vV17s5laQyq8gSVB18EPBImgEIbMZ1wKC094DA,181
+qbraid_cli/kernels/app.py,sha256=eELxcuYV_d0wNR5t3IYznEcjqGmRM1j7GeHqVgcvDqs,3439
+qbraid_cli/pip/__init__.py,sha256=tJtU0rxn-ODogNh5Y4pp_BgDQXMN-3JY1QGj0OZHwjQ,169
+qbraid_cli/pip/app.py,sha256=Cer_Tteo_k26bTNiLUX2k-XhdSU3wKuj9ZLubbGv7r4,1439
+qbraid_cli/pip/hooks.py,sha256=KuDHmntPXVK8tSb4MLk9VANhL-eINswhLd8_g_25WMY,2123
+qbraid_cli-0.8.2.dist-info/LICENSE,sha256=P1gi-ofB8lmkRt_mxDoJpcgQq9Ckq9WhRAS1oYk-G1s,2506
+qbraid_cli-0.8.2.dist-info/METADATA,sha256=QEXfGgrGrx2CzzgSARRfrIEv-wogBV0EgYXO-50gLTg,6732
+qbraid_cli-0.8.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+qbraid_cli-0.8.2.dist-info/entry_points.txt,sha256=c5ZJ7NjbxhDqMpou9q5F03_b_KG34HzFDijIDmEIwgQ,47
+qbraid_cli-0.8.2.dist-info/top_level.txt,sha256=LTYJgeYSCHo9Il8vZu0yIPuGdGyNaIw6iRy6BeoZo8o,11
+qbraid_cli-0.8.2.dist-info/RECORD,,

qbraid_cli-0.8.1a0.dist-info/RECORD

@@ -1,33 +0,0 @@
-qbraid_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-qbraid_cli/_version.py,sha256=uh6qRUKYp5CUuk-ID8cyEoLnsVpY7iGTUwo68466d6k,413
-qbraid_cli/exceptions.py,sha256=KjlhYJhSHMVazaNiBjD_Ur06w4sekP8zRsFzBdyIpno,672
-qbraid_cli/handlers.py,sha256=glxTEwxax3zKgYl9qsZ2evZXgrWQrseJS_OGyHTMFeA,7040
-qbraid_cli/main.py,sha256=R26PkxijuuCzcW_PVREHb11oNlNN2rWDcRY7BmiDV0Q,2564
-qbraid_cli/admin/__init__.py,sha256=Suo_L1_yBodCvLM_fpw8gRIhD4mVVOXKObtxeoMaBVo,150
-qbraid_cli/admin/app.py,sha256=__6lo-iFsbfz-ayD1-AS8X1z_gYhCad1NK17hnrL7HY,1451
-qbraid_cli/admin/headers.py,sha256=E6mE3odZL57VfHHZxYtRUkqMKmrmT4zuUoINzI7eJF8,6435
-qbraid_cli/admin/validation.py,sha256=LkAVXlHtM0MhCa34MIWrfX59wGXMVlZmdVB4-AQ8fBk,1003
-qbraid_cli/configure/__init__.py,sha256=6GU7vR6JYRGcMsmdrpFbwLO5VSUmnLgwSbtmGWMQND4,158
-qbraid_cli/configure/actions.py,sha256=3rrWHaCAsogyx0Ll-lcjbSzldD4kPuz1z6VQiWebSWw,3203
-qbraid_cli/configure/app.py,sha256=1uRe2lkUA4TtYb5b4mbD4LH-cKCbsZGT3Wfk7fpNzX0,2414
-qbraid_cli/credits/__init__.py,sha256=t-3XAJFAXiu_jI4sgjaIOuNne_AoSYaSEsi-SSRkvPw,154
-qbraid_cli/credits/app.py,sha256=AY3qtveO50KeQ2XREiEVqUcTrESgRuoqt9pt2Z8t4Y0,866
-qbraid_cli/devices/__init__.py,sha256=_PU3eMQRV4DkPw-oCmfCPh8EbVmgG76ieEKuNsY9Xqc,154
-qbraid_cli/devices/app.py,sha256=zxSxrEQn7irkJoME4S_CBnRqWeB8cqPaBsIMfpdYFk0,2530
-qbraid_cli/devices/validation.py,sha256=YhShyUufgrKnx2XjXOXF-PqFJYklJT9CgeqIwKcNam4,809
-qbraid_cli/envs/__init__.py,sha256=YgIoMWxfGqzmwfypO5JHYuCOu6BfFwb9NHgQel1IJM8,148
-qbraid_cli/envs/activate.py,sha256=VpvVYSfQDlcmlNWJOgkLIQ2p8YXPPLG8Jbl5t8GHUDw,2140
-qbraid_cli/envs/app.py,sha256=t6bRwJGy-M3PAu870ZsttsM8tpSB0OFasgCJiV9nTSA,8620
-qbraid_cli/envs/create.py,sha256=uCRex_TcFYw26jUOU06Ta5I8Mq5pRqLVaOE6MxrrExs,4337
-qbraid_cli/envs/data_handling.py,sha256=mTVzsj6KleeeYDKGhgD-IesF9KQQMSszKFSEo8Wrv9w,4001
-qbraid_cli/jobs/__init__.py,sha256=bj9XmZ4JL8OtMMZbHIu-DPhpOMXGLSB-W1b0wO7wKro,148
-qbraid_cli/jobs/app.py,sha256=kmg9mYla3Nd7EdjQlFu7IOvm7sejLNfPPA6Qeet-IfE,4898
-qbraid_cli/jobs/toggle_braket.py,sha256=d5C_Di80jWMFlh-77eH8YY9pjMKWXK5abenUDtPlE_I,6662
-qbraid_cli/jobs/validation.py,sha256=xNbjUggMhUs4wzkuRm4PuFPi_wrElYicUgYXLznHz3U,2983
-qbraid_cli/kernels/__init__.py,sha256=VhpBota_v7OoiGxrPCqJU4XBVcolf81mbCYGSxXzVhc,154
-qbraid_cli/kernels/app.py,sha256=ZJWVdKzCDfzGnA1pqp01vDbE7fh8p84jC-y6DDgWlxc,3373
-qbraid_cli-0.8.1a0.dist-info/METADATA,sha256=KVpOOlMih6hukKoS6rXu6ybRv0oN9NWsU2zb5ilxJHE,7170
-qbraid_cli-0.8.1a0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-qbraid_cli-0.8.1a0.dist-info/entry_points.txt,sha256=c5ZJ7NjbxhDqMpou9q5F03_b_KG34HzFDijIDmEIwgQ,47
-qbraid_cli-0.8.1a0.dist-info/top_level.txt,sha256=LTYJgeYSCHo9Il8vZu0yIPuGdGyNaIw6iRy6BeoZo8o,11
-qbraid_cli-0.8.1a0.dist-info/RECORD,,