pulp-python-client 3.12.5__py3-none-any.whl → 3.13.0__py3-none-any.whl

pulpcore/client/pulp_python/api/pypi_legacy_api.py

@@ -3,186 +3,359 @@
 """
     Pulp 3 API
 
-    Fetch, Upload, Organize, and Distribute Software Packages  # noqa: E501
+    Fetch, Upload, Organize, and Distribute Software Packages
 
     The version of the OpenAPI document: v3
     Contact: pulp-list@redhat.com
-    Generated by: https://openapi-generator.tech
-"""
-
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
 
-from __future__ import absolute_import
+    Do not edit the class manually.
+"""  # noqa: E501
 
-import re  # noqa: F401
+import warnings
+from pydantic import validate_call, Field, StrictFloat, StrictStr, StrictInt
+from typing import Any, Dict, List, Optional, Tuple, Union
+from typing_extensions import Annotated
 
-# python 2 and python 3 compatibility library
-import six
+from pydantic import Field, StrictBytes, StrictStr
+from typing import Optional, Tuple, Union
+from typing_extensions import Annotated
+from pulpcore.client.pulp_python.models.package_upload_task_response import PackageUploadTaskResponse
 
-from pulpcore.client.pulp_python.api_client import ApiClient
-from pulpcore.client.pulp_python.exceptions import (  # noqa: F401
-    ApiTypeError,
-    ApiValueError
-)
+from pulpcore.client.pulp_python.api_client import ApiClient, RequestSerialized
+from pulpcore.client.pulp_python.api_response import ApiResponse
+from pulpcore.client.pulp_python.rest import RESTResponseType
 
 
-class PypiLegacyApi(object):
+class PypiLegacyApi:
     """NOTE: This class is auto generated by OpenAPI Generator
     Ref: https://openapi-generator.tech
 
     Do not edit the class manually.
     """
 
-    def __init__(self, api_client=None):
+    def __init__(self, api_client=None) -> None:
         if api_client is None:
-            api_client = ApiClient()
+            api_client = ApiClient.get_default()
         self.api_client = api_client
 
-    def create(self, path, content, sha256_digest,  **kwargs):  # noqa: E501
-        """Upload a package  # noqa: E501
-
-        Upload package to the index.  This is the endpoint that tools like Twine and Poetry use for their upload commands.  # noqa: E501
-        This method makes a synchronous HTTP request by default. To make an
-        asynchronous HTTP request, please pass async_req=True
-        >>> thread = api.create(path, content, sha256_digest, async_req=True)
-        >>> result = thread.get()
-
-        :param async_req bool: execute request asynchronously
-        :param str path: (required)
-        :param file content: A Python package release file to upload to the index. (required)
-        :param str sha256_digest: SHA256 of package to validate upload integrity. (required)
-        :param str action: Defaults to `file_upload`, don't change it or request will fail!
-        :param _preload_content: if False, the urllib3.HTTPResponse object will
-                                 be returned without reading/decoding response
-                                 data. Default is True.
+
+    @validate_call
+    def create(
+        self,
+        path: StrictStr,
+        content: Annotated[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]], Field(description="A Python package release file to upload to the index.")],
+        sha256_digest: Annotated[str, Field(min_length=64, strict=True, max_length=64, description="SHA256 of package to validate upload integrity.")],
+        action: Annotated[Optional[Annotated[str, Field(min_length=1, strict=True)]], Field(description="Defaults to `file_upload`, don't change it or request will fail!")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> PackageUploadTaskResponse:
+        """Upload a package
+
+        Upload package to the index.  This is the endpoint that tools like Twine and Poetry use for their upload commands.
+
+        :param path: (required)
+        :type path: str
+        :param content: A Python package release file to upload to the index. (required)
+        :type content: bytearray
+        :param sha256_digest: SHA256 of package to validate upload integrity. (required)
+        :type sha256_digest: str
+        :param action: Defaults to `file_upload`, don't change it or request will fail!
+        :type action: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
                                  (connection, read) timeouts.
-        :return: PackageUploadTaskResponse
-                 If the method is called asynchronously,
-                 returns the request thread.
-        """
-        kwargs['_return_http_data_only'] = True
-        return self.create_with_http_info(path, content, sha256_digest,  **kwargs)  # noqa: E501
-
-    def create_with_http_info(self, path, content, sha256_digest,  **kwargs):  # noqa: E501
-        """Upload a package  # noqa: E501
-
-        Upload package to the index.  This is the endpoint that tools like Twine and Poetry use for their upload commands.  # noqa: E501
-        This method makes a synchronous HTTP request by default. To make an
-        asynchronous HTTP request, please pass async_req=True
-        >>> thread = api.create_with_http_info(path, content, sha256_digest, async_req=True)
-        >>> result = thread.get()
-
-        :param async_req bool: execute request asynchronously
-        :param str path: (required)
-        :param file content: A Python package release file to upload to the index. (required)
-        :param str sha256_digest: SHA256 of package to validate upload integrity. (required)
-        :param str action: Defaults to `file_upload`, don't change it or request will fail!
-        :param _return_http_data_only: response data without head status code
-                                       and headers
-        :param _preload_content: if False, the urllib3.HTTPResponse object will
-                                 be returned without reading/decoding response
-                                 data. Default is True.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._create_serialize(
+            path=path,
+            content=content,
+            sha256_digest=sha256_digest,
+            action=action,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "PackageUploadTaskResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def create_with_http_info(
+        self,
+        path: StrictStr,
+        content: Annotated[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]], Field(description="A Python package release file to upload to the index.")],
+        sha256_digest: Annotated[str, Field(min_length=64, strict=True, max_length=64, description="SHA256 of package to validate upload integrity.")],
+        action: Annotated[Optional[Annotated[str, Field(min_length=1, strict=True)]], Field(description="Defaults to `file_upload`, don't change it or request will fail!")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[PackageUploadTaskResponse]:
+        """Upload a package
+
+        Upload package to the index.  This is the endpoint that tools like Twine and Poetry use for their upload commands.
+
+        :param path: (required)
+        :type path: str
+        :param content: A Python package release file to upload to the index. (required)
+        :type content: bytearray
+        :param sha256_digest: SHA256 of package to validate upload integrity. (required)
+        :type sha256_digest: str
+        :param action: Defaults to `file_upload`, don't change it or request will fail!
+        :type action: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
                                  (connection, read) timeouts.
-        :return: tuple(PackageUploadTaskResponse, status_code(int), headers(HTTPHeaderDict))
-                 If the method is called asynchronously,
-                 returns the request thread.
-        """
-
-        local_var_params = locals()
-
-        all_params = [
-            'path',
-            'content',
-            'sha256_digest',
-            'action'
-        ]
-        all_params.extend(
-            [
-                'async_req',
-                '_return_http_data_only',
-                '_preload_content',
-                '_request_timeout'
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._create_serialize(
+            path=path,
+            content=content,
+            sha256_digest=sha256_digest,
+            action=action,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "PackageUploadTaskResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def create_without_preload_content(
+        self,
+        path: StrictStr,
+        content: Annotated[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]], Field(description="A Python package release file to upload to the index.")],
+        sha256_digest: Annotated[str, Field(min_length=64, strict=True, max_length=64, description="SHA256 of package to validate upload integrity.")],
+        action: Annotated[Optional[Annotated[str, Field(min_length=1, strict=True)]], Field(description="Defaults to `file_upload`, don't change it or request will fail!")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
             ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Upload a package
+
+        Upload package to the index.  This is the endpoint that tools like Twine and Poetry use for their upload commands.
+
+        :param path: (required)
+        :type path: str
+        :param content: A Python package release file to upload to the index. (required)
+        :type content: bytearray
+        :param sha256_digest: SHA256 of package to validate upload integrity. (required)
+        :type sha256_digest: str
+        :param action: Defaults to `file_upload`, don't change it or request will fail!
+        :type action: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._create_serialize(
+            path=path,
+            content=content,
+            sha256_digest=sha256_digest,
+            action=action,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "PackageUploadTaskResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
         )
+        return response_data.response
+
+
+    def _create_serialize(
+        self,
+        path,
+        content,
+        sha256_digest,
+        action,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
 
-        for key, val in six.iteritems(local_var_params['kwargs']):
-            if key not in all_params:
-                raise ApiTypeError(
-                    "Got an unexpected keyword argument '%s'"
-                    " to method create" % key
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if path is not None:
+            _path_params['path'] = path
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        if content is not None:
+            _files['content'] = content
+        if action is not None:
+            _form_params.append(('action', action))
+        if sha256_digest is not None:
+            _form_params.append(('sha256_digest', sha256_digest))
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json'
+                ]
+            )
+
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params['Content-Type'] = _content_type
+        else:
+            _default_content_type = (
+                self.api_client.select_header_content_type(
+                    [
+                        'multipart/form-data', 
+                        'application/x-www-form-urlencoded'
+                    ]
                 )
-            local_var_params[key] = val
-        del local_var_params['kwargs']
-        # verify the required parameter 'path' is set
-        if self.api_client.client_side_validation and ('path' not in local_var_params or  # noqa: E501
-                                                        local_var_params['path'] is None):  # noqa: E501
-            raise ApiValueError("Missing the required parameter `path` when calling `create`")  # noqa: E501
-        # verify the required parameter 'content' is set
-        if self.api_client.client_side_validation and ('content' not in local_var_params or  # noqa: E501
-                                                        local_var_params['content'] is None):  # noqa: E501
-            raise ApiValueError("Missing the required parameter `content` when calling `create`")  # noqa: E501
-        # verify the required parameter 'sha256_digest' is set
-        if self.api_client.client_side_validation and ('sha256_digest' not in local_var_params or  # noqa: E501
-                                                        local_var_params['sha256_digest'] is None):  # noqa: E501
-            raise ApiValueError("Missing the required parameter `sha256_digest` when calling `create`")  # noqa: E501
-
-        if self.api_client.client_side_validation and ('sha256_digest' in local_var_params and  # noqa: E501
-                                                        len(local_var_params['sha256_digest']) > 64):  # noqa: E501
-            raise ApiValueError("Invalid value for parameter `sha256_digest` when calling `create`, length must be less than or equal to `64`")  # noqa: E501
-        if self.api_client.client_side_validation and ('sha256_digest' in local_var_params and  # noqa: E501
-                                                        len(local_var_params['sha256_digest']) < 64):  # noqa: E501
-            raise ApiValueError("Invalid value for parameter `sha256_digest` when calling `create`, length must be greater than or equal to `64`")  # noqa: E501
-        if self.api_client.client_side_validation and ('action' in local_var_params and  # noqa: E501
-                                                        len(local_var_params['action']) < 1):  # noqa: E501
-            raise ApiValueError("Invalid value for parameter `action` when calling `create`, length must be greater than or equal to `1`")  # noqa: E501
-        collection_formats = {}
-
-        path_params = {}
-        if 'path' in local_var_params:
-            path_params['path'] = local_var_params['path']  # noqa: E501
-
-        query_params = []
-
-        header_params = {}
-
-        form_params = []
-        local_var_files = {}
-        if 'content' in local_var_params:
-            local_var_files['content'] = local_var_params['content']  # noqa: E501
-        if 'action' in local_var_params:
-            form_params.append(('action', local_var_params['action']))  # noqa: E501
-        if 'sha256_digest' in local_var_params:
-            form_params.append(('sha256_digest', local_var_params['sha256_digest']))  # noqa: E501
-
-        body_params = None
-        # HTTP header `Accept`
-        header_params['Accept'] = self.api_client.select_header_accept(
-            ['application/json'])  # noqa: E501
-
-        # HTTP header `Content-Type`
-        header_params['Content-Type'] = self.api_client.select_header_content_type(  # noqa: E501
-            ['multipart/form-data', 'application/x-www-form-urlencoded'])  # noqa: E501
-
-        # Authentication setting
-        auth_settings = ['basicAuth', 'cookieAuth']  # noqa: E501
-
-        return self.api_client.call_api(
-            '/pypi/{path}/legacy/', 'POST',
-            path_params,
-            query_params,
-            header_params,
-            body=body_params,
-            post_params=form_params,
-            files=local_var_files,
-            response_type='PackageUploadTaskResponse',  # noqa: E501
-            auth_settings=auth_settings,
-            async_req=local_var_params.get('async_req'),
-            _return_http_data_only=local_var_params.get('_return_http_data_only'),  # noqa: E501
-            _preload_content=local_var_params.get('_preload_content', True),
-            _request_timeout=local_var_params.get('_request_timeout'),
-            collection_formats=collection_formats)
+            )
+            if _default_content_type is not None:
+                _header_params['Content-Type'] = _default_content_type
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'basicAuth', 
+            'cookieAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='POST',
+            resource_path='/pypi/{path}/legacy/',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+