octostar-python-client 0.1.759__py3-none-any.whl

octostar/api/apps/get_apps_url.py

@@ -0,0 +1,188 @@
+"""Get app URLs from the FastAPI backend."""
+
+from http import HTTPStatus
+from typing import Any, Dict, List, Optional
+from warnings import warn
+
+import httpx
+import attr
+
+from ...client import Client, get_default_client
+from ...types import Response
+from ... import errors
+from ...models.get_apps_url_json_body import GetAppsUrlJsonBody
+
+
+client_missing_msg = """No client was passed to this function. The default admin client will be used, but this is deprecated and will be removed soon.
+Please create a client using octostar.client.make_client() and run the function via client.execute()."""
+
+
+@attr.s(auto_attribs=True)
+class AppUrlInfo:
+    """URL information for a single app."""
+
+    app_id: str
+    app_url: str
+    additional_properties: Dict[str, Any] = attr.ib(init=False, factory=dict)
+
+    @classmethod
+    def from_dict(cls, src_dict: Dict[str, Any]) -> "AppUrlInfo":
+        d = src_dict.copy()
+        app_id = d.pop("app_id")
+        app_url = d.pop("app_url")
+        info = cls(app_id=app_id, app_url=app_url)
+        info.additional_properties = d
+        return info
+
+
+def _get_kwargs(
+    *,
+    client: Client = None,
+    json_body: GetAppsUrlJsonBody = None,
+) -> Dict[str, Any]:
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    base_url = client.get_base_url_v1()
+    url = f"{base_url}/api/v1/apps/urls"
+
+    headers: Dict[str, str] = client.get_headers()
+    headers["Content-Type"] = "application/json"
+    cookies: Dict[str, Any] = client.get_cookies()
+
+    if not json_body:
+        raise ValueError("json_body is required for getting app URLs")
+
+    # Convert to new format
+    json_data = {"app_ids": json_body.app_ids}
+
+    return {
+        "method": "post",
+        "url": url,
+        "headers": headers,
+        "cookies": cookies,
+        "timeout": client.get_timeout(),
+        "follow_redirects": client.follow_redirects,
+        "json": json_data,
+    }
+
+
+def _parse_response(
+    *, client: Client = None, response: httpx.Response
+) -> Optional[List[AppUrlInfo]]:
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    if response.status_code == HTTPStatus.OK:
+        data = response.json()
+        urls = data.get("urls", [])
+        return [AppUrlInfo.from_dict(item) for item in urls]
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    return None
+
+
+def _build_response(
+    *, client: Client = None, response: httpx.Response
+) -> Response[List[AppUrlInfo]]:
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: Client = None,
+    json_body: GetAppsUrlJsonBody = None,
+) -> Response[List[AppUrlInfo]]:
+    """Get URLs for multiple apps.
+
+    Args:
+        client: The Client with which to connect to Octostar.
+        json_body: GetAppsUrlJsonBody with list of app IDs.
+
+    Returns:
+        Response with list of AppUrlInfo objects.
+    """
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    kwargs = _get_kwargs(client=client, json_body=json_body)
+
+    response = httpx.request(verify=client.verify_ssl, **kwargs)
+    if response.is_error:
+        print(
+            f"{response.status_code} Error: {response.text} for request",
+            str(kwargs),
+        )
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: Client = None,
+    json_body: GetAppsUrlJsonBody = None,
+) -> Optional[List[AppUrlInfo]]:
+    """Get URLs for multiple apps.
+
+    Args:
+        client: The Client with which to connect to Octostar.
+        json_body: GetAppsUrlJsonBody with list of app IDs.
+
+    Returns:
+        List of AppUrlInfo objects or None if request failed.
+    """
+    return sync_detailed(client=client, json_body=json_body).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: Client = None,
+    json_body: GetAppsUrlJsonBody = None,
+) -> Response[List[AppUrlInfo]]:
+    """Get URLs for multiple apps asynchronously.
+
+    Args:
+        client: The Client with which to connect to Octostar.
+        json_body: GetAppsUrlJsonBody with list of app IDs.
+
+    Returns:
+        Response with list of AppUrlInfo objects.
+    """
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    kwargs = _get_kwargs(client=client, json_body=json_body)
+
+    async with httpx.AsyncClient(verify=client.verify_ssl) as _client:
+        response = await _client.request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: Client = None,
+    json_body: GetAppsUrlJsonBody = None,
+) -> Optional[List[AppUrlInfo]]:
+    """Get URLs for multiple apps asynchronously.
+
+    Args:
+        client: The Client with which to connect to Octostar.
+        json_body: GetAppsUrlJsonBody with list of app IDs.
+
+    Returns:
+        List of AppUrlInfo objects or None if request failed.
+    """
+    return (await asyncio_detailed(client=client, json_body=json_body)).parsed

octostar/api/apps/get_job_logs.py

@@ -0,0 +1,210 @@
+"""Get job logs from the FastAPI backend."""
+
+from http import HTTPStatus
+from typing import Any, Dict, Optional, Union
+from warnings import warn
+
+import httpx
+
+from ...client import Client, get_default_client
+from ...types import Response, UNSET, Unset
+from ... import errors
+
+
+client_missing_msg = """No client was passed to this function. The default admin client will be used, but this is deprecated and will be removed soon.
+Please create a client using octostar.client.make_client() and run the function via client.execute()."""
+
+
+def _get_kwargs(
+    job_id: str,
+    *,
+    client: Client = None,
+    since_seconds: Union[Unset, None, int] = UNSET,
+    tail_lines: Union[Unset, None, int] = UNSET,
+) -> Dict[str, Any]:
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    base_url = client.get_base_url_v1()
+    url = f"{base_url}/api/v1/apps/jobs/{job_id}/logs"
+
+    headers: Dict[str, str] = client.get_headers()
+    cookies: Dict[str, Any] = client.get_cookies()
+
+    params: Dict[str, Any] = {}
+    if not isinstance(since_seconds, Unset) and since_seconds is not None:
+        params["since_seconds"] = since_seconds
+    if not isinstance(tail_lines, Unset) and tail_lines is not None:
+        params["tail_lines"] = tail_lines
+
+    return {
+        "method": "get",
+        "url": url,
+        "headers": headers,
+        "cookies": cookies,
+        "params": params,
+        "timeout": client.get_timeout(),
+        "follow_redirects": client.follow_redirects,
+    }
+
+
+def _parse_response(
+    *, client: Client = None, response: httpx.Response
+) -> Optional[bytes]:
+    """Parse response - returns raw bytes for log content."""
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    if response.status_code == HTTPStatus.OK:
+        return response.content
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    return None
+
+
+def _build_response(
+    *, client: Client = None, response: httpx.Response
+) -> Response[bytes]:
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    job_id: str,
+    *,
+    client: Client = None,
+    since_seconds: Union[Unset, None, int] = UNSET,
+    tail_lines: Union[Unset, None, int] = UNSET,
+) -> Response[bytes]:
+    """Get job logs.
+
+    Args:
+        job_id: The job ID to get logs for.
+        client: The Client with which to connect to Octostar.
+        since_seconds: Only return logs from the last N seconds.
+        tail_lines: Only return the last N lines.
+
+    Returns:
+        Response with raw log content in bytes.
+    """
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    kwargs = _get_kwargs(
+        job_id=job_id,
+        client=client,
+        since_seconds=since_seconds,
+        tail_lines=tail_lines,
+    )
+
+    response = httpx.request(verify=client.verify_ssl, **kwargs)
+    if response.is_error:
+        print(
+            f"{response.status_code} Error: {response.text} for request",
+            str(kwargs),
+        )
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    job_id: str,
+    *,
+    client: Client = None,
+    since_seconds: Union[Unset, None, int] = UNSET,
+    tail_lines: Union[Unset, None, int] = UNSET,
+) -> Optional[bytes]:
+    """Get job logs.
+
+    Args:
+        job_id: The job ID to get logs for.
+        client: The Client with which to connect to Octostar.
+        since_seconds: Only return logs from the last N seconds.
+        tail_lines: Only return the last N lines.
+
+    Returns:
+        Raw log content or None if request failed.
+    """
+    response = sync_detailed(
+        job_id=job_id,
+        client=client,
+        since_seconds=since_seconds,
+        tail_lines=tail_lines,
+    )
+    if response.status_code == HTTPStatus.OK:
+        return response.content
+    return None
+
+
+async def asyncio_detailed(
+    job_id: str,
+    *,
+    client: Client = None,
+    since_seconds: Union[Unset, None, int] = UNSET,
+    tail_lines: Union[Unset, None, int] = UNSET,
+) -> Response[bytes]:
+    """Get job logs asynchronously.
+
+    Args:
+        job_id: The job ID to get logs for.
+        client: The Client with which to connect to Octostar.
+        since_seconds: Only return logs from the last N seconds.
+        tail_lines: Only return the last N lines.
+
+    Returns:
+        Response with raw log content.
+    """
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    kwargs = _get_kwargs(
+        job_id=job_id,
+        client=client,
+        since_seconds=since_seconds,
+        tail_lines=tail_lines,
+    )
+
+    async with httpx.AsyncClient(verify=client.verify_ssl) as _client:
+        response = await _client.request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    job_id: str,
+    *,
+    client: Client = None,
+    since_seconds: Union[Unset, None, int] = UNSET,
+    tail_lines: Union[Unset, None, int] = UNSET,
+) -> Optional[bytes]:
+    """Get job logs asynchronously.
+
+    Args:
+        job_id: The job ID to get logs for.
+        client: The Client with which to connect to Octostar.
+        since_seconds: Only return logs from the last N seconds.
+        tail_lines: Only return the last N lines.
+
+    Returns:
+        Raw log content or None if request failed.
+    """
+    response = await asyncio_detailed(
+        job_id=job_id,
+        client=client,
+        since_seconds=since_seconds,
+        tail_lines=tail_lines,
+    )
+    if response.status_code == HTTPStatus.OK:
+        return response.content
+    return None

octostar/api/apps/get_job_progress.py

@@ -0,0 +1,162 @@
+"""Get job progress from the FastAPI backend."""
+
+from http import HTTPStatus
+from typing import Any, Dict, Optional
+from warnings import warn
+
+import httpx
+
+from ...client import Client, get_default_client
+from ...types import Response
+from ... import errors
+
+
+client_missing_msg = """No client was passed to this function. The default admin client will be used, but this is deprecated and will be removed soon.
+Please create a client using octostar.client.make_client() and run the function via client.execute()."""
+
+
+def _get_kwargs(
+    job_id: str,
+    *,
+    client: Client = None,
+) -> Dict[str, Any]:
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    base_url = client.get_base_url_v1()
+    url = f"{base_url}/api/v1/apps/jobs/{job_id}/progress"
+
+    headers: Dict[str, str] = client.get_headers()
+    cookies: Dict[str, Any] = client.get_cookies()
+
+    return {
+        "method": "get",
+        "url": url,
+        "headers": headers,
+        "cookies": cookies,
+        "timeout": client.get_timeout(),
+        "follow_redirects": client.follow_redirects,
+    }
+
+
+def _parse_response(
+    *, client: Client = None, response: httpx.Response
+) -> Optional[Dict[str, Any]]:
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    if response.status_code == HTTPStatus.OK:
+        return response.json()
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    return None
+
+
+def _build_response(
+    *, client: Client = None, response: httpx.Response
+) -> Response[Dict[str, Any]]:
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    job_id: str,
+    *,
+    client: Client = None,
+) -> Response[Dict[str, Any]]:
+    """Get job progress.
+
+    Args:
+        job_id: The job ID to get progress for.
+        client: The Client with which to connect to Octostar.
+
+    Returns:
+        Response with job progress data including:
+        - job_id: The job ID
+        - progress: Progress value (0.0 to 1.0), or None if not set
+        - status: Job status
+        - message: Optional progress message
+    """
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    kwargs = _get_kwargs(job_id=job_id, client=client)
+
+    response = httpx.request(verify=client.verify_ssl, **kwargs)
+    if response.is_error:
+        print(
+            f"{response.status_code} Error: {response.text} for request",
+            str(kwargs),
+        )
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    job_id: str,
+    *,
+    client: Client = None,
+) -> Optional[Dict[str, Any]]:
+    """Get job progress.
+
+    Args:
+        job_id: The job ID to get progress for.
+        client: The Client with which to connect to Octostar.
+
+    Returns:
+        Job progress data or None if request failed.
+    """
+    return sync_detailed(job_id=job_id, client=client).parsed
+
+
+async def asyncio_detailed(
+    job_id: str,
+    *,
+    client: Client = None,
+) -> Response[Dict[str, Any]]:
+    """Get job progress asynchronously.
+
+    Args:
+        job_id: The job ID to get progress for.
+        client: The Client with which to connect to Octostar.
+
+    Returns:
+        Response with job progress data.
+    """
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    kwargs = _get_kwargs(job_id=job_id, client=client)
+
+    async with httpx.AsyncClient(verify=client.verify_ssl) as _client:
+        response = await _client.request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    job_id: str,
+    *,
+    client: Client = None,
+) -> Optional[Dict[str, Any]]:
+    """Get job progress asynchronously.
+
+    Args:
+        job_id: The job ID to get progress for.
+        client: The Client with which to connect to Octostar.
+
+    Returns:
+        Job progress data or None if request failed.
+    """
+    return (await asyncio_detailed(job_id=job_id, client=client)).parsed

octostar/api/apps/kill_job.py

@@ -0,0 +1,160 @@
+"""Kill a job via the FastAPI backend."""
+
+from http import HTTPStatus
+from typing import Any, Dict, Optional
+from warnings import warn
+
+import httpx
+
+from ...client import Client, get_default_client
+from ...types import Response
+from ... import errors
+
+
+client_missing_msg = """No client was passed to this function. The default admin client will be used, but this is deprecated and will be removed soon.
+Please create a client using octostar.client.make_client() and run the function via client.execute()."""
+
+
+def _get_kwargs(
+    job_id: str,
+    *,
+    client: Client = None,
+) -> Dict[str, Any]:
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    base_url = client.get_base_url_v1()
+    url = f"{base_url}/api/v1/apps/jobs/{job_id}"
+
+    headers: Dict[str, str] = client.get_headers()
+    cookies: Dict[str, Any] = client.get_cookies()
+
+    return {
+        "method": "delete",
+        "url": url,
+        "headers": headers,
+        "cookies": cookies,
+        "timeout": client.get_timeout(),
+        "follow_redirects": client.follow_redirects,
+    }
+
+
+def _parse_response(
+    *, client: Client = None, response: httpx.Response
+) -> Optional[Dict[str, Any]]:
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    if response.status_code == HTTPStatus.OK:
+        return response.json()
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    return None
+
+
+def _build_response(
+    *, client: Client = None, response: httpx.Response
+) -> Response[Dict[str, Any]]:
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    job_id: str,
+    *,
+    client: Client = None,
+) -> Response[Dict[str, Any]]:
+    """Kill a running job.
+
+    Args:
+        job_id: The job ID to kill.
+        client: The Client with which to connect to Octostar.
+
+    Returns:
+        Response with kill confirmation including:
+        - status: Operation status
+        - job_id: The killed job ID
+    """
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    kwargs = _get_kwargs(job_id=job_id, client=client)
+
+    response = httpx.request(verify=client.verify_ssl, **kwargs)
+    if response.is_error:
+        print(
+            f"{response.status_code} Error: {response.text} for request",
+            str(kwargs),
+        )
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    job_id: str,
+    *,
+    client: Client = None,
+) -> Optional[Dict[str, Any]]:
+    """Kill a running job.
+
+    Args:
+        job_id: The job ID to kill.
+        client: The Client with which to connect to Octostar.
+
+    Returns:
+        Kill confirmation data or None if request failed.
+    """
+    return sync_detailed(job_id=job_id, client=client).parsed
+
+
+async def asyncio_detailed(
+    job_id: str,
+    *,
+    client: Client = None,
+) -> Response[Dict[str, Any]]:
+    """Kill a running job asynchronously.
+
+    Args:
+        job_id: The job ID to kill.
+        client: The Client with which to connect to Octostar.
+
+    Returns:
+        Response with kill confirmation.
+    """
+    if not client:
+        warn(client_missing_msg, FutureWarning, stacklevel=2)
+        client = get_default_client()
+
+    kwargs = _get_kwargs(job_id=job_id, client=client)
+
+    async with httpx.AsyncClient(verify=client.verify_ssl) as _client:
+        response = await _client.request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    job_id: str,
+    *,
+    client: Client = None,
+) -> Optional[Dict[str, Any]]:
+    """Kill a running job asynchronously.
+
+    Args:
+        job_id: The job ID to kill.
+        client: The Client with which to connect to Octostar.
+
+    Returns:
+        Kill confirmation data or None if request failed.
+    """
+    return (await asyncio_detailed(job_id=job_id, client=client)).parsed