Server : Apache/2.4.41 (Ubuntu) System : Linux absol.cf 5.4.0-198-generic #218-Ubuntu SMP Fri Sep 27 20:18:53 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory :  /proc/thread-self/root/usr/lib/python3/dist-packages/uaclient/api/u/pro/version/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

from uaclient import messages
from uaclient.api.api import APIEndpoint
from uaclient.api.data_types import AdditionalInfo
from uaclient.api.errors import APIError
from uaclient.config import UAConfig
from uaclient.data_types import DataObject, Field, StringDataValue
from uaclient.version import get_version


class VersionError(APIError):
    _formatted_msg = messages.E_API_VERSION_ERROR


class VersionResult(DataObject, AdditionalInfo):
    fields = [
        Field(
            "installed_version",
            StringDataValue,
            doc="The current installed version",
        ),
    ]

    def __init__(self, *, installed_version: str):
        self.installed_version = installed_version


def version() -> VersionResult:
    return _version(UAConfig())


def _version(cfg: UAConfig) -> VersionResult:
    """
    This endpoint shows the installed Pro Client version.
    """
    try:
        version = get_version()
    except Exception as e:
        raise VersionError(error_msg=str(e))
    return VersionResult(installed_version=version)


endpoint = APIEndpoint(
    version="v1",
    name="Version",
    fn=_version,
    options_cls=None,
)

_doc = {
    "introduced_in": "27.11",
    "requires_network": False,
    "example_python": """
from uaclient.api.u.pro.version.v1 import version

result = version()
""",
    "result_class": VersionResult,
    "exceptions": [
        (VersionError, "Raised if the Client cannot determine the version.")
    ],
    "example_cli": "pro api u.pro.version.v1",
    "example_json": """
{
    "installed_version": "32.3~24.04"
}
""",
}