pulp_python_client 3.3.0 → 3.4.0

data/pulpcore/client/pulp_python/rest.py

@@ -0,0 +1,292 @@
+# coding: utf-8
+
+"""
+    Pulp 3 API
+
+    Fetch, Upload, Organize, and Distribute Software Packages  # noqa: E501
+
+    The version of the OpenAPI document: v3
+    Contact: pulp-list@redhat.com
+    Generated by: https://openapi-generator.tech
+"""
+
+
+from __future__ import absolute_import
+
+import io
+import json
+import logging
+import re
+import ssl
+
+import certifi
+# python 2 and python 3 compatibility library
+import six
+from six.moves.urllib.parse import urlencode
+import urllib3
+
+from pulpcore.client.pulp_python.exceptions import ApiException, ApiValueError
+
+
+logger = logging.getLogger(__name__)
+
+
+class RESTResponse(io.IOBase):
+
+    def __init__(self, resp):
+        self.urllib3_response = resp
+        self.status = resp.status
+        self.reason = resp.reason
+        self.data = resp.data
+
+    def getheaders(self):
+        """Returns a dictionary of the response headers."""
+        return self.urllib3_response.getheaders()
+
+    def getheader(self, name, default=None):
+        """Returns a given response header."""
+        return self.urllib3_response.getheader(name, default)
+
+
+class RESTClientObject(object):
+
+    def __init__(self, configuration, pools_size=4, maxsize=None):
+        # urllib3.PoolManager will pass all kw parameters to connectionpool
+        # https://github.com/shazow/urllib3/blob/f9409436f83aeb79fbaf090181cd81b784f1b8ce/urllib3/poolmanager.py#L75  # noqa: E501
+        # https://github.com/shazow/urllib3/blob/f9409436f83aeb79fbaf090181cd81b784f1b8ce/urllib3/connectionpool.py#L680  # noqa: E501
+        # maxsize is the number of requests to host that are allowed in parallel  # noqa: E501
+        # Custom SSL certificates and client certificates: http://urllib3.readthedocs.io/en/latest/advanced-usage.html  # noqa: E501
+
+        # cert_reqs
+        if configuration.verify_ssl:
+            cert_reqs = ssl.CERT_REQUIRED
+        else:
+            cert_reqs = ssl.CERT_NONE
+
+        # ca_certs
+        if configuration.ssl_ca_cert:
+            ca_certs = configuration.ssl_ca_cert
+        else:
+            # if not set certificate file, use Mozilla's root certificates.
+            ca_certs = certifi.where()
+
+        addition_pool_args = {}
+        if configuration.assert_hostname is not None:
+            addition_pool_args['assert_hostname'] = configuration.assert_hostname  # noqa: E501
+
+        if configuration.retries is not None:
+            addition_pool_args['retries'] = configuration.retries
+
+        if maxsize is None:
+            if configuration.connection_pool_maxsize is not None:
+                maxsize = configuration.connection_pool_maxsize
+            else:
+                maxsize = 4
+
+        # https pool manager
+        if configuration.proxy:
+            self.pool_manager = urllib3.ProxyManager(
+                num_pools=pools_size,
+                maxsize=maxsize,
+                cert_reqs=cert_reqs,
+                ca_certs=ca_certs,
+                cert_file=configuration.cert_file,
+                key_file=configuration.key_file,
+                proxy_url=configuration.proxy,
+                proxy_headers=configuration.proxy_headers,
+                **addition_pool_args
+            )
+        else:
+            self.pool_manager = urllib3.PoolManager(
+                num_pools=pools_size,
+                maxsize=maxsize,
+                cert_reqs=cert_reqs,
+                ca_certs=ca_certs,
+                cert_file=configuration.cert_file,
+                key_file=configuration.key_file,
+                **addition_pool_args
+            )
+
+    def request(self, method, url, query_params=None, headers=None,
+                body=None, post_params=None, _preload_content=True,
+                _request_timeout=None):
+        """Perform requests.
+
+        :param method: http request method
+        :param url: http request url
+        :param query_params: query parameters in the url
+        :param headers: http request headers
+        :param body: request json body, for `application/json`
+        :param post_params: request post parameters,
+                            `application/x-www-form-urlencoded`
+                            and `multipart/form-data`
+        :param _preload_content: if False, the urllib3.HTTPResponse object will
+                                 be returned without reading/decoding response
+                                 data. Default is True.
+        :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.
+        """
+        method = method.upper()
+        assert method in ['GET', 'HEAD', 'DELETE', 'POST', 'PUT',
+                          'PATCH', 'OPTIONS']
+
+        if post_params and body:
+            raise ApiValueError(
+                "body parameter cannot be used with post_params parameter."
+            )
+
+        post_params = post_params or {}
+        headers = headers or {}
+
+        timeout = None
+        if _request_timeout:
+            if isinstance(_request_timeout, (int, ) if six.PY3 else (int, long)):  # noqa: E501,F821
+                timeout = urllib3.Timeout(total=_request_timeout)
+            elif (isinstance(_request_timeout, tuple) and
+                  len(_request_timeout) == 2):
+                timeout = urllib3.Timeout(
+                    connect=_request_timeout[0], read=_request_timeout[1])
+
+        if 'Content-Type' not in headers:
+            headers['Content-Type'] = 'application/json'
+
+        try:
+            # For `POST`, `PUT`, `PATCH`, `OPTIONS`, `DELETE`
+            if method in ['POST', 'PUT', 'PATCH', 'OPTIONS', 'DELETE']:
+                if query_params:
+                    url += '?' + urlencode(query_params)
+                if re.search('json', headers['Content-Type'], re.IGNORECASE):
+                    request_body = None
+                    if body is not None:
+                        request_body = json.dumps(body)
+                    r = self.pool_manager.request(
+                        method, url,
+                        body=request_body,
+                        preload_content=_preload_content,
+                        timeout=timeout,
+                        headers=headers)
+                elif headers['Content-Type'] == 'application/x-www-form-urlencoded':  # noqa: E501
+                    r = self.pool_manager.request(
+                        method, url,
+                        fields=post_params,
+                        encode_multipart=False,
+                        preload_content=_preload_content,
+                        timeout=timeout,
+                        headers=headers)
+                elif headers['Content-Type'] == 'multipart/form-data':
+                    # must del headers['Content-Type'], or the correct
+                    # Content-Type which generated by urllib3 will be
+                    # overwritten.
+                    del headers['Content-Type']
+                    r = self.pool_manager.request(
+                        method, url,
+                        fields=post_params,
+                        encode_multipart=True,
+                        preload_content=_preload_content,
+                        timeout=timeout,
+                        headers=headers)
+                # Pass a `string` parameter directly in the body to support
+                # other content types than Json when `body` argument is
+                # provided in serialized form
+                elif isinstance(body, str) or isinstance(body, bytes):
+                    request_body = body
+                    r = self.pool_manager.request(
+                        method, url,
+                        body=request_body,
+                        preload_content=_preload_content,
+                        timeout=timeout,
+                        headers=headers)
+                else:
+                    # Cannot generate the request from given parameters
+                    msg = """Cannot prepare a request message for provided
+                             arguments. Please check that your arguments match
+                             declared content type."""
+                    raise ApiException(status=0, reason=msg)
+            # For `GET`, `HEAD`
+            else:
+                r = self.pool_manager.request(method, url,
+                                              fields=query_params,
+                                              preload_content=_preload_content,
+                                              timeout=timeout,
+                                              headers=headers)
+        except urllib3.exceptions.SSLError as e:
+            msg = "{0}\n{1}".format(type(e).__name__, str(e))
+            raise ApiException(status=0, reason=msg)
+
+        if _preload_content:
+            r = RESTResponse(r)
+
+            # log response body
+            logger.debug("response body: %s", r.data)
+
+        if not 200 <= r.status <= 299:
+            raise ApiException(http_resp=r)
+
+        return r
+
+    def GET(self, url, headers=None, query_params=None, _preload_content=True,
+            _request_timeout=None):
+        return self.request("GET", url,
+                            headers=headers,
+                            _preload_content=_preload_content,
+                            _request_timeout=_request_timeout,
+                            query_params=query_params)
+
+    def HEAD(self, url, headers=None, query_params=None, _preload_content=True,
+             _request_timeout=None):
+        return self.request("HEAD", url,
+                            headers=headers,
+                            _preload_content=_preload_content,
+                            _request_timeout=_request_timeout,
+                            query_params=query_params)
+
+    def OPTIONS(self, url, headers=None, query_params=None, post_params=None,
+                body=None, _preload_content=True, _request_timeout=None):
+        return self.request("OPTIONS", url,
+                            headers=headers,
+                            query_params=query_params,
+                            post_params=post_params,
+                            _preload_content=_preload_content,
+                            _request_timeout=_request_timeout,
+                            body=body)
+
+    def DELETE(self, url, headers=None, query_params=None, body=None,
+               _preload_content=True, _request_timeout=None):
+        return self.request("DELETE", url,
+                            headers=headers,
+                            query_params=query_params,
+                            _preload_content=_preload_content,
+                            _request_timeout=_request_timeout,
+                            body=body)
+
+    def POST(self, url, headers=None, query_params=None, post_params=None,
+             body=None, _preload_content=True, _request_timeout=None):
+        return self.request("POST", url,
+                            headers=headers,
+                            query_params=query_params,
+                            post_params=post_params,
+                            _preload_content=_preload_content,
+                            _request_timeout=_request_timeout,
+                            body=body)
+
+    def PUT(self, url, headers=None, query_params=None, post_params=None,
+            body=None, _preload_content=True, _request_timeout=None):
+        return self.request("PUT", url,
+                            headers=headers,
+                            query_params=query_params,
+                            post_params=post_params,
+                            _preload_content=_preload_content,
+                            _request_timeout=_request_timeout,
+                            body=body)
+
+    def PATCH(self, url, headers=None, query_params=None, post_params=None,
+              body=None, _preload_content=True, _request_timeout=None):
+        return self.request("PATCH", url,
+                            headers=headers,
+                            query_params=query_params,
+                            post_params=post_params,
+                            _preload_content=_preload_content,
+                            _request_timeout=_request_timeout,
+                            body=body)

data/requirements.txt

@@ -0,0 +1,6 @@
+certifi >= 14.05.14
+future; python_version<="2.7"
+six >= 1.10
+python_dateutil >= 2.5.3
+setuptools >= 21.0.0
+urllib3 >= 1.15.1

data/setup.cfg

@@ -0,0 +1,2 @@
+[flake8]
+max-line-length=99

data/setup.py

@@ -0,0 +1,42 @@
+# coding: utf-8
+
+"""
+    Pulp 3 API
+
+    Fetch, Upload, Organize, and Distribute Software Packages  # noqa: E501
+
+    The version of the OpenAPI document: v3
+    Contact: pulp-list@redhat.com
+    Generated by: https://openapi-generator.tech
+"""
+
+
+from setuptools import setup, find_packages  # noqa: H301
+
+NAME = "pulp_python-client"
+VERSION = "3.4.0"
+# To install the library, run the following
+#
+# python setup.py install
+#
+# prerequisite: setuptools
+# http://pypi.python.org/pypi/setuptools
+
+REQUIRES = ["urllib3 >= 1.15", "six >= 1.10", "certifi", "python-dateutil"]
+setup(
+    name=NAME,
+    version=VERSION,
+    description="Pulp 3 API",
+    author="Pulp Team",
+    author_email="pulp-list@redhat.com",
+    url="",
+    keywords=["pulp", "pulpcore", "client", "Pulp 3 API"],
+    install_requires=REQUIRES,
+    python_requires='>=3.4',  # restrict client usage to Python 3 only
+    packages=find_packages(exclude=["test", "tests"]),
+    include_package_data=True,
+    license="GPLv2+",
+    long_description="""\
+    Fetch, Upload, Organize, and Distribute Software Packages  # noqa: E501
+    """
+)

data/spec/api/content_packages_api_spec.rb

@@ -40,8 +40,10 @@ describe 'ContentPackagesApi' do
   # @option opts [String] :artifact Artifact file representing the physical content
   # @option opts [File] :file An uploaded file that may be turned into the artifact of the content unit.
   # @option opts [String] :repository A URI of a repository the new content unit should be associated with.
+  # @option opts [String] :sha256 The SHA256 digest of this package.
   # @option opts [String] :summary A one-line summary of what the package does.
   # @option opts [String] :description A longer description of the package that can run to several paragraphs.
+  # @option opts [String] :description_content_type A string stating the markup syntax (if any) used in the distribution’s description, so that tools can intelligently render the description.
   # @option opts [String] :keywords Additional keywords to be used to assist searching for the package in a larger catalog.
   # @option opts [String] :home_page The URL for the package's home page.
   # @option opts [String] :download_url Legacy field denoting the URL from which this package can be downloaded.
@@ -52,6 +54,7 @@ describe 'ContentPackagesApi' do
   # @option opts [String] :license Text indicating the license covering the distribution
   # @option opts [String] :requires_python The Python version(s) that the distribution is guaranteed to be compatible with.
   # @option opts [String] :project_url A browsable URL for the project and a label for it, separated by a comma.
+  # @option opts [Object] :project_urls A dictionary of labels and URLs for the project.
   # @option opts [String] :platform A comma-separated list of platform specifications, summarizing the operating systems supported by the package.
   # @option opts [String] :supported_platform Field to specify the OS and CPU for which the binary package was compiled. 
   # @option opts [Object] :requires_dist A JSON list containing names of some other distutils project required by this distribution.

data/spec/api/distributions_pypi_api_spec.rb

@@ -58,7 +58,7 @@ describe 'DistributionsPypiApi' do
 
   # unit tests for list
   # List python distributions
-  #  Pulp Python Distributions are used to distribute Python Publications.  Pulp Python Distributions should not be confused with \"Python Distribution\" as defined by the Python community. In Pulp usage, Python content is refered to as Python Package Content.
+  #  Pulp Python Distributions are used to distribute Python content from Python Repositories or Python Publications.  Pulp Python Distributions should not be confused with \"Python Distribution\" as defined by the Python community. In Pulp usage, Python content is referred to as Python Package Content.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :base_path 
   # @option opts [String] :base_path__contains Filter results where base_path contains value
@@ -97,7 +97,7 @@ describe 'DistributionsPypiApi' do
 
   # unit tests for read
   # Inspect a python distribution
-  #  Pulp Python Distributions are used to distribute Python Publications.  Pulp Python Distributions should not be confused with \"Python Distribution\" as defined by the Python community. In Pulp usage, Python content is refered to as Python Package Content.
+  #  Pulp Python Distributions are used to distribute Python content from Python Repositories or Python Publications.  Pulp Python Distributions should not be confused with \"Python Distribution\" as defined by the Python community. In Pulp usage, Python content is referred to as Python Package Content.
   # @param python_python_distribution_href 
   # @param [Hash] opts the optional parameters
   # @option opts [String] :fields A list of fields to include in the response.

data/spec/api/publications_pypi_api_spec.rb

@@ -34,7 +34,7 @@ describe 'PublicationsPypiApi' do
 
   # unit tests for create
   # Create a python publication
-  # Trigger an asynchronous task to publish python content.
+  #  Dispatches a publish task, which generates metadata that will be used by pip.
   # @param python_python_publication 
   # @param [Hash] opts the optional parameters
   # @return [AsyncOperationResponse]

data/spec/api/pypi_api_spec.rb

@@ -0,0 +1,49 @@
+=begin
+#Pulp 3 API
+
+#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
+OpenAPI Generator version: 4.2.3
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for PulpPythonClient::PypiApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'PypiApi' do
+  before do
+    # run before each test
+    @api_instance = PulpPythonClient::PypiApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of PypiApi' do
+    it 'should create an instance of PypiApi' do
+      expect(@api_instance).to be_instance_of(PulpPythonClient::PypiApi)
+    end
+  end
+
+  # unit tests for read
+  # Get index summary
+  # Gets package summary stats of index.
+  # @param path 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :fields A list of fields to include in the response.
+  # @option opts [String] :exclude_fields A list of fields to exclude from the response.
+  # @return [SummaryResponse]
+  describe 'read test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+end

data/spec/api/pypi_legacy_api_spec.rb

@@ -0,0 +1,50 @@
+=begin
+#Pulp 3 API
+
+#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
+OpenAPI Generator version: 4.2.3
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for PulpPythonClient::PypiLegacyApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'PypiLegacyApi' do
+  before do
+    # run before each test
+    @api_instance = PulpPythonClient::PypiLegacyApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of PypiLegacyApi' do
+    it 'should create an instance of PypiLegacyApi' do
+      expect(@api_instance).to be_instance_of(PulpPythonClient::PypiLegacyApi)
+    end
+  end
+
+  # unit tests for create
+  # 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 
+  # @param content A Python package release file to upload to the index.
+  # @param sha256_digest SHA256 of package to validate upload integrity.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :action Defaults to `file_upload`, don't change it or request will fail!
+  # @return [PackageUploadTaskResponse]
+  describe 'create test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+end

data/spec/api/pypi_metadata_api_spec.rb

@@ -0,0 +1,50 @@
+=begin
+#Pulp 3 API
+
+#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
+OpenAPI Generator version: 4.2.3
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for PulpPythonClient::PypiMetadataApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'PypiMetadataApi' do
+  before do
+    # run before each test
+    @api_instance = PulpPythonClient::PypiMetadataApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of PypiMetadataApi' do
+    it 'should create an instance of PypiMetadataApi' do
+      expect(@api_instance).to be_instance_of(PulpPythonClient::PypiMetadataApi)
+    end
+  end
+
+  # unit tests for read
+  # Get package metadata
+  # Retrieves the package's core-metadata specified by https://packaging.python.org/specifications/core-metadata/. `meta` must be a path in form of `{package}/json/` or `{package}/{version}/json/`
+  # @param meta 
+  # @param path 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :fields A list of fields to include in the response.
+  # @option opts [String] :exclude_fields A list of fields to exclude from the response.
+  # @return [PackageMetadataResponse]
+  describe 'read test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+end

data/spec/api/pypi_simple_api_spec.rb

@@ -0,0 +1,79 @@
+=begin
+#Pulp 3 API
+
+#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
+OpenAPI Generator version: 4.2.3
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for PulpPythonClient::PypiSimpleApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'PypiSimpleApi' do
+  before do
+    # run before each test
+    @api_instance = PulpPythonClient::PypiSimpleApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of PypiSimpleApi' do
+    it 'should create an instance of PypiSimpleApi' do
+      expect(@api_instance).to be_instance_of(PulpPythonClient::PypiSimpleApi)
+    end
+  end
+
+  # unit tests for create
+  # Upload a package
+  # Upload package to the index. This endpoint has the same functionality as the upload endpoint at the `/legacy` url of the index. This is provided for convenience for users who want a single index url for all their Python tools. (pip, twine, poetry, pipenv, ...)
+  # @param path 
+  # @param content A Python package release file to upload to the index.
+  # @param sha256_digest SHA256 of package to validate upload integrity.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :action Defaults to `file_upload`, don't change it or request will fail!
+  # @return [PackageUploadTaskResponse]
+  describe 'create test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for read
+  # Get index simple page
+  # Gets the simple api html page for the index.
+  # @param path 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :fields A list of fields to include in the response.
+  # @option opts [String] :exclude_fields A list of fields to exclude from the response.
+  # @return [nil]
+  describe 'read test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for read_0
+  # Get package simple page
+  # Retrieves the simple api html page for a package.
+  # @param package 
+  # @param path 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :fields A list of fields to include in the response.
+  # @option opts [String] :exclude_fields A list of fields to exclude from the response.
+  # @return [nil]
+  describe 'read_0 test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+end

data/spec/api/remotes_python_api_spec.rb

@@ -58,11 +58,11 @@ describe 'RemotesPythonApi' do
 
   # unit tests for from_bandersnatch
   # Create from Bandersnatch
-  # Create a remote from a Bandersnatch config
+  #  Takes the fields specified in the Bandersnatch config and creates a Python Remote from it.
   # @param config A Bandersnatch config that may be used to construct a Python Remote.
   # @param name A unique name for this remote
   # @param [Hash] opts the optional parameters
-  # @option opts [PolicyEnum] :policy The policy to use when downloading content. The possible values include: 'immediate', 'on_demand', and 'cache_only'. 'immediate' is the default.
+  # @option opts [PolicyEnum] :policy The policy to use when downloading content. The possible values include: 'immediate', 'on_demand', and 'streamed'. 'on_demand' is the default.
   # @return [PythonPythonRemoteResponse]
   describe 'from_bandersnatch test' do
     it 'should work' do

data/spec/api/repositories_python_api_spec.rb

@@ -34,7 +34,7 @@ describe 'RepositoriesPythonApi' do
 
   # unit tests for create
   # Create a python repository
-  # A ViewSet for PythonRepository.
+  # PythonRepository represents a single Python repository, to which content can be synced, added, or removed.
   # @param python_python_repository 
   # @param [Hash] opts the optional parameters
   # @return [PythonPythonRepositoryResponse]
@@ -58,7 +58,7 @@ describe 'RepositoriesPythonApi' do
 
   # unit tests for list
   # List python repositorys
-  # A ViewSet for PythonRepository.
+  # PythonRepository represents a single Python repository, to which content can be synced, added, or removed.
   # @param [Hash] opts the optional parameters
   # @option opts [Integer] :limit Number of results to return per page.
   # @option opts [String] :name 
@@ -106,7 +106,7 @@ describe 'RepositoriesPythonApi' do
 
   # unit tests for read
   # Inspect a python repository
-  # A ViewSet for PythonRepository.
+  # PythonRepository represents a single Python repository, to which content can be synced, added, or removed.
   # @param python_python_repository_href 
   # @param [Hash] opts the optional parameters
   # @option opts [String] :fields A list of fields to include in the response.
@@ -120,7 +120,7 @@ describe 'RepositoriesPythonApi' do
 
   # unit tests for sync
   # Sync from remote
-  # Trigger an asynchronous task to sync Python content.
+  #  Trigger an asynchronous task to sync python content. The sync task will retrieve Python content from the specified `Remote` and update the specified `Respository`, creating a new  `RepositoryVersion`.
   # @param python_python_repository_href 
   # @param repository_sync_url 
   # @param [Hash] opts the optional parameters