crc-pulp-npm-client 20250819.1__py3-none-any.whl

crc-pulp_npm-client/exceptions.py

@@ -0,0 +1,200 @@
+# coding: utf-8
+
+"""
+    Pulp 3 API
+
+    Fetch, Upload, Organize, and Distribute Software Packages
+
+    The version of the OpenAPI document: v3
+    Contact: pulp-list@redhat.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+from typing import Any, Optional
+from typing_extensions import Self
+
+class OpenApiException(Exception):
+    """The base exception class for all OpenAPIExceptions"""
+
+
+class ApiTypeError(OpenApiException, TypeError):
+    def __init__(self, msg, path_to_item=None, valid_classes=None,
+                 key_type=None) -> None:
+        """ Raises an exception for TypeErrors
+
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (list): a list of keys an indices to get to the
+                                 current_item
+                                 None if unset
+            valid_classes (tuple): the primitive classes that current item
+                                   should be an instance of
+                                   None if unset
+            key_type (bool): False if our value is a value in a dict
+                             True if it is a key in a dict
+                             False if our item is an item in a list
+                             None if unset
+        """
+        self.path_to_item = path_to_item
+        self.valid_classes = valid_classes
+        self.key_type = key_type
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiTypeError, self).__init__(full_msg)
+
+
+class ApiValueError(OpenApiException, ValueError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (list) the path to the exception in the
+                received_data dict. None if unset
+        """
+
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiValueError, self).__init__(full_msg)
+
+
+class ApiAttributeError(OpenApiException, AttributeError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Raised when an attribute reference or assignment fails.
+
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (None/list) the path to the exception in the
+                received_data dict
+        """
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiAttributeError, self).__init__(full_msg)
+
+
+class ApiKeyError(OpenApiException, KeyError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (None/list) the path to the exception in the
+                received_data dict
+        """
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiKeyError, self).__init__(full_msg)
+
+
+class ApiException(OpenApiException):
+
+    def __init__(
+        self, 
+        status=None, 
+        reason=None, 
+        http_resp=None,
+        *,
+        body: Optional[str] = None,
+        data: Optional[Any] = None,
+    ) -> None:
+        self.status = status
+        self.reason = reason
+        self.body = body
+        self.data = data
+        self.headers = None
+
+        if http_resp:
+            if self.status is None:
+                self.status = http_resp.status
+            if self.reason is None:
+                self.reason = http_resp.reason
+            if self.body is None:
+                try:
+                    self.body = http_resp.data.decode('utf-8')
+                except Exception:
+                    pass
+            self.headers = http_resp.getheaders()
+
+    @classmethod
+    def from_response(
+        cls, 
+        *, 
+        http_resp, 
+        body: Optional[str], 
+        data: Optional[Any],
+    ) -> Self:
+        if http_resp.status == 400:
+            raise BadRequestException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 401:
+            raise UnauthorizedException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 403:
+            raise ForbiddenException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 404:
+            raise NotFoundException(http_resp=http_resp, body=body, data=data)
+
+        if 500 <= http_resp.status <= 599:
+            raise ServiceException(http_resp=http_resp, body=body, data=data)
+        raise ApiException(http_resp=http_resp, body=body, data=data)
+
+    def __str__(self):
+        """Custom error messages for exception"""
+        error_message = "({0})\n"\
+                        "Reason: {1}\n".format(self.status, self.reason)
+        if self.headers:
+            error_message += "HTTP response headers: {0}\n".format(
+                self.headers)
+
+        if self.data or self.body:
+            error_message += "HTTP response body: {0}\n".format(self.data or self.body)
+
+        return error_message
+
+
+class BadRequestException(ApiException):
+    pass
+
+
+class NotFoundException(ApiException):
+    pass
+
+
+class UnauthorizedException(ApiException):
+    pass
+
+
+class ForbiddenException(ApiException):
+    pass
+
+
+class ServiceException(ApiException):
+    pass
+
+
+def render_path(path_to_item):
+    """Returns a string representation of a path"""
+    result = ""
+    for pth in path_to_item:
+        if isinstance(pth, int):
+            result += "[{0}]".format(pth)
+        else:
+            result += "['{0}']".format(pth)
+    return result

crc-pulp_npm-client/models/__init__.py

@@ -0,0 +1,44 @@
+# coding: utf-8
+
+# flake8: noqa
+"""
+    Pulp 3 API
+
+    Fetch, Upload, Organize, and Distribute Software Packages
+
+    The version of the OpenAPI document: v3
+    Contact: pulp-list@redhat.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+# import models into model package
+from crc-pulp_npm-client.models.async_operation_response import AsyncOperationResponse
+from crc-pulp_npm-client.models.content_summary_response import ContentSummaryResponse
+from crc-pulp_npm-client.models.npm_npm_distribution import NpmNpmDistribution
+from crc-pulp_npm-client.models.npm_npm_distribution_response import NpmNpmDistributionResponse
+from crc-pulp_npm-client.models.npm_npm_remote import NpmNpmRemote
+from crc-pulp_npm-client.models.npm_npm_remote_response import NpmNpmRemoteResponse
+from crc-pulp_npm-client.models.npm_npm_remote_response_hidden_fields_inner import NpmNpmRemoteResponseHiddenFieldsInner
+from crc-pulp_npm-client.models.npm_npm_repository import NpmNpmRepository
+from crc-pulp_npm-client.models.npm_npm_repository_response import NpmNpmRepositoryResponse
+from crc-pulp_npm-client.models.npm_package_response import NpmPackageResponse
+from crc-pulp_npm-client.models.paginated_repository_version_response_list import PaginatedRepositoryVersionResponseList
+from crc-pulp_npm-client.models.paginatednpm_npm_distribution_response_list import PaginatednpmNpmDistributionResponseList
+from crc-pulp_npm-client.models.paginatednpm_npm_remote_response_list import PaginatednpmNpmRemoteResponseList
+from crc-pulp_npm-client.models.paginatednpm_npm_repository_response_list import PaginatednpmNpmRepositoryResponseList
+from crc-pulp_npm-client.models.paginatednpm_package_response_list import PaginatednpmPackageResponseList
+from crc-pulp_npm-client.models.patchednpm_npm_distribution import PatchednpmNpmDistribution
+from crc-pulp_npm-client.models.patchednpm_npm_remote import PatchednpmNpmRemote
+from crc-pulp_npm-client.models.patchednpm_npm_repository import PatchednpmNpmRepository
+from crc-pulp_npm-client.models.policy_enum import PolicyEnum
+from crc-pulp_npm-client.models.repair import Repair
+from crc-pulp_npm-client.models.repository_add_remove_content import RepositoryAddRemoveContent
+from crc-pulp_npm-client.models.repository_sync_url import RepositorySyncURL
+from crc-pulp_npm-client.models.repository_version_response import RepositoryVersionResponse
+from crc-pulp_npm-client.models.set_label import SetLabel
+from crc-pulp_npm-client.models.set_label_response import SetLabelResponse
+from crc-pulp_npm-client.models.unset_label import UnsetLabel
+from crc-pulp_npm-client.models.unset_label_response import UnsetLabelResponse

crc-pulp_npm-client/models/async_operation_response.py

@@ -0,0 +1,88 @@
+# coding: utf-8
+
+"""
+    Pulp 3 API
+
+    Fetch, Upload, Organize, and Distribute Software Packages
+
+    The version of the OpenAPI document: v3
+    Contact: pulp-list@redhat.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List
+from typing import Optional, Set
+from typing_extensions import Self
+
+class AsyncOperationResponse(BaseModel):
+    """
+    Serializer for asynchronous operations.
+    """ # noqa: E501
+    task: StrictStr = Field(description="The href of the task.")
+    __properties: ClassVar[List[str]] = ["task"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of AsyncOperationResponse from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of AsyncOperationResponse from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "task": obj.get("task")
+        })
+        return _obj
+
+

crc-pulp_npm-client/models/content_summary_response.py

@@ -0,0 +1,92 @@
+# coding: utf-8
+
+"""
+    Pulp 3 API
+
+    Fetch, Upload, Organize, and Distribute Software Packages
+
+    The version of the OpenAPI document: v3
+    Contact: pulp-list@redhat.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict
+from typing import Any, ClassVar, Dict, List
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ContentSummaryResponse(BaseModel):
+    """
+    Serializer for the RepositoryVersion content summary
+    """ # noqa: E501
+    added: Dict[str, Dict[str, Any]]
+    removed: Dict[str, Dict[str, Any]]
+    present: Dict[str, Dict[str, Any]]
+    __properties: ClassVar[List[str]] = ["added", "removed", "present"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ContentSummaryResponse from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ContentSummaryResponse from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "added": obj.get("added"),
+            "removed": obj.get("removed"),
+            "present": obj.get("present")
+        })
+        return _obj
+
+

crc-pulp_npm-client/models/npm_npm_distribution.py

@@ -0,0 +1,116 @@
+# coding: utf-8
+
+"""
+    Pulp 3 API
+
+    Fetch, Upload, Organize, and Distribute Software Packages
+
+    The version of the OpenAPI document: v3
+    Contact: pulp-list@redhat.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from typing import Optional, Set
+from typing_extensions import Self
+
+class NpmNpmDistribution(BaseModel):
+    """
+    Serializer for NPM Distributions.
+    """ # noqa: E501
+    base_path: Annotated[str, Field(min_length=1, strict=True)] = Field(description="The base (relative) path component of the published url. Avoid paths that                     overlap with other distribution base paths (e.g. \"foo\" and \"foo/bar\")")
+    content_guard: Optional[StrictStr] = Field(default=None, description="An optional content-guard.")
+    hidden: Optional[StrictBool] = Field(default=False, description="Whether this distribution should be shown in the content app.")
+    pulp_labels: Optional[Dict[str, Optional[StrictStr]]] = None
+    name: Annotated[str, Field(min_length=1, strict=True)] = Field(description="A unique name. Ex, `rawhide` and `stable`.")
+    repository: Optional[StrictStr] = Field(default=None, description="The latest RepositoryVersion for this Repository will be served.")
+    remote: Optional[StrictStr] = Field(default=None, description="Remote that can be used to fetch content when using pull-through caching.")
+    __properties: ClassVar[List[str]] = ["base_path", "content_guard", "hidden", "pulp_labels", "name", "repository", "remote"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of NpmNpmDistribution from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # set to None if content_guard (nullable) is None
+        # and model_fields_set contains the field
+        if self.content_guard is None and "content_guard" in self.model_fields_set:
+            _dict['content_guard'] = None
+
+        # set to None if repository (nullable) is None
+        # and model_fields_set contains the field
+        if self.repository is None and "repository" in self.model_fields_set:
+            _dict['repository'] = None
+
+        # set to None if remote (nullable) is None
+        # and model_fields_set contains the field
+        if self.remote is None and "remote" in self.model_fields_set:
+            _dict['remote'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of NpmNpmDistribution from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "base_path": obj.get("base_path"),
+            "content_guard": obj.get("content_guard"),
+            "hidden": obj.get("hidden") if obj.get("hidden") is not None else False,
+            "pulp_labels": obj.get("pulp_labels"),
+            "name": obj.get("name"),
+            "repository": obj.get("repository"),
+            "remote": obj.get("remote")
+        })
+        return _obj
+
+

crc-pulp_npm-client/models/npm_npm_distribution_response.py

@@ -0,0 +1,140 @@
+# coding: utf-8
+
+"""
+    Pulp 3 API
+
+    Fetch, Upload, Organize, and Distribute Software Packages
+
+    The version of the OpenAPI document: v3
+    Contact: pulp-list@redhat.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from datetime import datetime
+from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+
+class NpmNpmDistributionResponse(BaseModel):
+    """
+    Serializer for NPM Distributions.
+    """ # noqa: E501
+    pulp_href: Optional[StrictStr] = None
+    prn: Optional[StrictStr] = Field(default=None, description="The Pulp Resource Name (PRN).")
+    pulp_created: Optional[datetime] = Field(default=None, description="Timestamp of creation.")
+    pulp_last_updated: Optional[datetime] = Field(default=None, description="Timestamp of the last time this resource was updated. Note: for immutable resources - like content, repository versions, and publication - pulp_created and pulp_last_updated dates will be the same.")
+    base_path: StrictStr = Field(description="The base (relative) path component of the published url. Avoid paths that                     overlap with other distribution base paths (e.g. \"foo\" and \"foo/bar\")")
+    base_url: Optional[StrictStr] = Field(default=None, description="The URL for accessing the publication as defined by this distribution.")
+    content_guard: Optional[StrictStr] = Field(default=None, description="An optional content-guard.")
+    no_content_change_since: Optional[StrictStr] = Field(default=None, description="Timestamp since when the distributed content served by this distribution has not changed. If equals to `null`, no guarantee is provided about content changes.")
+    hidden: Optional[StrictBool] = Field(default=False, description="Whether this distribution should be shown in the content app.")
+    pulp_labels: Optional[Dict[str, Optional[StrictStr]]] = None
+    name: StrictStr = Field(description="A unique name. Ex, `rawhide` and `stable`.")
+    repository: Optional[StrictStr] = Field(default=None, description="The latest RepositoryVersion for this Repository will be served.")
+    remote: Optional[StrictStr] = Field(default=None, description="Remote that can be used to fetch content when using pull-through caching.")
+    __properties: ClassVar[List[str]] = ["pulp_href", "prn", "pulp_created", "pulp_last_updated", "base_path", "base_url", "content_guard", "no_content_change_since", "hidden", "pulp_labels", "name", "repository", "remote"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of NpmNpmDistributionResponse from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        """
+        excluded_fields: Set[str] = set([
+            "pulp_href",
+            "prn",
+            "pulp_created",
+            "pulp_last_updated",
+            "base_url",
+            "no_content_change_since",
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # set to None if content_guard (nullable) is None
+        # and model_fields_set contains the field
+        if self.content_guard is None and "content_guard" in self.model_fields_set:
+            _dict['content_guard'] = None
+
+        # set to None if repository (nullable) is None
+        # and model_fields_set contains the field
+        if self.repository is None and "repository" in self.model_fields_set:
+            _dict['repository'] = None
+
+        # set to None if remote (nullable) is None
+        # and model_fields_set contains the field
+        if self.remote is None and "remote" in self.model_fields_set:
+            _dict['remote'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of NpmNpmDistributionResponse from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "pulp_href": obj.get("pulp_href"),
+            "prn": obj.get("prn"),
+            "pulp_created": obj.get("pulp_created"),
+            "pulp_last_updated": obj.get("pulp_last_updated"),
+            "base_path": obj.get("base_path"),
+            "base_url": obj.get("base_url"),
+            "content_guard": obj.get("content_guard"),
+            "no_content_change_since": obj.get("no_content_change_since"),
+            "hidden": obj.get("hidden") if obj.get("hidden") is not None else False,
+            "pulp_labels": obj.get("pulp_labels"),
+            "name": obj.get("name"),
+            "repository": obj.get("repository"),
+            "remote": obj.get("remote")
+        })
+        return _obj
+
+