a !fQ@sXdZddlmZddlmZddlmZddlm Z GdddeZGdd d eZ d S) z7A Client for interacting with the Resource Manager API.)Client)Iterator) ConnectionProjectc@s0eZdZdZeZd ddZddZd ddZdS) raClient to bundle configuration needed for API requests. See https://cloud.google.com/resource-manager/reference/rest/ for more information on this API. Automatically get credentials:: >>> from gcloud import resource_manager >>> client = resource_manager.Client() :type credentials: :class:`oauth2client.client.OAuth2Credentials` or :class:`NoneType` :param credentials: The OAuth2 Credentials to use for the connection owned by this client. If not passed (and if no ``http`` object is passed), falls back to the default inferred from the environment. :type http: :class:`httplib2.Http` or class that defines ``request()``. :param http: An optional HTTP object to make requests. If not passed, an ``http`` object is created that is bound to the ``credentials`` for the current object. NcCst||||dS)aCreates a :class:`.Project` bound to the current client. Use :meth:`Project.reload() ` to retrieve project metadata after creating a :class:`.Project` instance. .. note: This does not make an API call. :type project_id: str :param project_id: The ID for this project. :type name: string :param name: The display name of the project. :type labels: dict :param labels: A list of labels associated with the project. :rtype: :class:`.Project` :returns: A new instance of a :class:`.Project` **without** any metadata loaded. ) project_idclientnamelabelsr)selfrr r r _/var/www/html/python-backend/venv/lib/python3.9/site-packages/gcloud/resource_manager/client.py new_project3szClient.new_projectcCs||}||S)aFetch an existing project and it's relevant metadata by ID. .. note:: If the project does not exist, this will raise a :class:`NotFound ` error. :type project_id: str :param project_id: The ID for this project. :rtype: :class:`.Project` :returns: A :class:`.Project` with metadata fetched from the API. )rreload)r rprojectr r r fetch_projectNs zClient.fetch_projectcCs0i}|dur||d<|dur$||d<t||dS)aList the projects visible to this client. Example:: >>> from gcloud import resource_manager >>> client = resource_manager.Client() >>> for project in client.list_projects(): ... print project.project_id List all projects with label ``'environment'`` set to ``'prod'`` (filtering by labels):: >>> from gcloud import resource_manager >>> client = resource_manager.Client() >>> env_filter = {'labels.environment': 'prod'} >>> for project in client.list_projects(env_filter): ... print project.project_id See: https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects/list Complete filtering example:: >>> project_filter = { # Return projects with... ... 'name': 'My Project', # name set to 'My Project'. ... 'id': 'my-project-id', # id set to 'my-project-id'. ... 'labels.stage': 'prod', # the label 'stage' set to 'prod' ... 'labels.color': '*' # a label 'color' set to anything. ... } >>> client.list_projects(project_filter) :type filter_params: dict :param filter_params: (Optional) A dictionary of filter options where each key is a property to filter on, and each value is the (case-insensitive) value to check (or the glob ``*`` to check for existence of the property). See the example above for more details. :type page_size: int :param page_size: (Optional) Maximum number of projects to return in a single page. If not passed, defaults to a value set by the API. :rtype: :class:`_ProjectIterator` :returns: A project iterator. The iterator will make multiple API requests if you continue iterating and there are more pages of results. Each item returned will be a. :class:`.Project`. NZpageSizefilter) extra_params)_ProjectIterator)r Z filter_paramsZ page_sizerr r r list_projects`s 3zClient.list_projects)NN)NN) __name__ __module__ __qualname____doc__rZ_connection_classrrrr r r r rs  rcs*eZdZdZdfdd ZddZZS)raAn iterator over a list of Project resources. You shouldn't have to use this directly, but instead should use the helper methods on :class:`gcloud.resource_manager.client.Client` objects. :type client: :class:`gcloud.resource_manager.client.Client` :param client: The client to use for making connections. :type extra_params: dict :param extra_params: (Optional) Extra query string parameters for the API call. Ncstt|j|d|ddS)Nz /projects)rpathr)superr__init__)r rr __class__r r rsz_ProjectIterator.__init__ccs,|dgD]}tj||jd}|Vq dS)zYield :class:`.Project` items from response. :type response: dict :param response: The JSON API response for a page of projects. Zprojects)rN)getrZ from_api_reprr)r responseresourceitemr r r get_items_from_responsesz(_ProjectIterator.get_items_from_response)N)rrrrrr# __classcell__r r rr rsrN) rZ gcloud.clientrZ BaseClientZgcloud.iteratorrZ"gcloud.resource_manager.connectionrZgcloud.resource_manager.projectrrr r r r s