a !f[)@s$dZddlmZGdddeZdS)zAUtility for managing projects via the Cloud Resource Manager API.)NotFoundc@seZdZdZdddZddZeddZd d Ze d d Z e d dZ ddZ dddZ d ddZd!ddZd"ddZd#ddZd$ddZdS)%Projecta Projects are containers for your work on Google Cloud Platform. .. note:: A :class:`Project` can also be created via :meth:`Client.new_project() ` To manage labels on a :class:`Project`:: >>> from gcloud import resource_manager >>> client = resource_manager.Client() >>> project = client.new_project('purple-spaceship-123') >>> project.labels = {'color': 'purple'} >>> project.labels['environment'] = 'production' >>> project.update() See: https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects :type project_id: string :param project_id: The globally unique ID of the project. :type client: :class:`gcloud.resource_manager.client.Client` :param client: The Client used with 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. NcCs,||_||_||_d|_|pi|_d|_dS)N)_client project_idnamenumberlabelsstatus)selfrclientrrr `/var/www/html/python-backend/venv/lib/python3.9/site-packages/gcloud/resource_manager/project.py__init__6s  zProject.__init__cCsd|j|jfS)Nz)rrr r r r __repr__>szProject.__repr__cCs||d|d}|||S)aFactory: construct a project given its API representation. :type resource: dict :param resource: project resource representation returned from the API :type client: :class:`gcloud.resource_manager.client.Client` :param client: The Client used with this project. :rtype: :class:`gcloud.resource_manager.project.Project` :returns: The project created. projectId)rr )set_properties_from_api_repr)clsresourcer projectr r r from_api_reprAs  zProject.from_api_reprcCs2|d|_|d|_|di|_|d|_dS)z7Update specific properties from its API representation.rZ projectNumberrZlifecycleStateN)getrrrr )r rr r r rRs  z$Project.set_properties_from_api_reprcCs|jstdd|jS)z?Fully-qualified name (ie, ``'projects/purple-spaceship-123'``).zMissing project ID.z projects/%s)r ValueErrorrr r r full_nameYszProject.full_namecCs d|jS)z?URL for the project (ie, ``'/projects/purple-spaceship-123'``).z/%s)rrr r r path`sz Project.pathcCs|dur|j}|S)aCheck client or verify over-ride. :type client: :class:`gcloud.resource_manager.client.Client` or ``NoneType`` :param client: the client to use. If not passed, falls back to the ``client`` stored on the current project. :rtype: :class:`gcloud.resource_manager.client.Client` :returns: The client passed in or the currently bound client. N)rr r r r r _require_clientes zProject._require_clientcCs>||}|j|j|jd}|jjdd|d}|j|ddS)aAPI call: create the project via a ``POST`` request. See https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects/create :type client: :class:`gcloud.resource_manager.client.Client` or :data:`NoneType ` :param client: the client to use. If not passed, falls back to the client stored on the current project. )rrrPOSTz /projectsmethodrdatarN)rrrr connection api_requestrr r r respr r r createts  zProject.createcCs,||}|jjd|jd}|j|ddS)aGAPI call: reload the project via a ``GET`` request. This method will reload the newest metadata for the project. If you've created a new :class:`Project` instance via :meth:`Client.new_project() `, this method will retrieve project metadata. .. warning:: This will overwrite any local changes you've made and not saved via :meth:`update`. See https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects/get :type client: :class:`gcloud.resource_manager.client.Client` or :data:`NoneType ` :param client: the client to use. If not passed, falls back to the client stored on the current project. GETrrr!N)rr"r#rr)r r r%r r r reloads zProject.reloadcCs>||}z|jjd|jdWnty4YdS0dSdS)a API call: test the existence of a project via a ``GET`` request. See https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects/get :type client: :class:`gcloud.resource_manager.client.Client` or :data:`NoneType ` :param client: the client to use. If not passed, falls back to the client stored on the current project. :rtype: bool :returns: Boolean indicating existence of the project. r'r(FTN)rr"r#rrrr r r existss   zProject.existscCs:||}|j|jd}|jjd|j|d}||dS)aAPI call: update the project via a ``PUT`` request. See https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects/update :type client: :class:`gcloud.resource_manager.client.Client` or :data:`NoneType ` :param client: the client to use. If not passed, falls back to the client stored on the current project. )rrPUTrN)rrrr"r#rrr$r r r updates  zProject.updateFcCs,||}|jjd|jd|r(|dS)aFAPI call: delete the project via a ``DELETE`` request. See: https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects/delete This actually changes the status (``lifecycleState``) from ``ACTIVE`` to ``DELETE_REQUESTED``. Later (it's not specified when), the project will move into the ``DELETE_IN_PROGRESS`` state, which means the deleting has actually begun. :type client: :class:`gcloud.resource_manager.client.Client` or :data:`NoneType ` :param client: the client to use. If not passed, falls back to the client stored on the current project. :type reload_data: bool :param reload_data: Whether to reload the project with the latest state. If you want to get the updated status, you'll want this set to :data:`True` as the DELETE method doesn't send back the updated project. Default: :data:`False`. DELETEr(Nrr"r#rr)r r Z reload_datar r r deletes zProject.deletecCs0||}|jjd|jdd|r,|dS)a>API call: undelete the project via a ``POST`` request. See https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects/undelete This actually changes the project status (``lifecycleState``) from ``DELETE_REQUESTED`` to ``ACTIVE``. If the project has already reached a status of ``DELETE_IN_PROGRESS``, this request will fail and the project cannot be restored. :type client: :class:`gcloud.resource_manager.client.Client` or :data:`NoneType ` :param client: the client to use. If not passed, falls back to the client stored on the current project. :type reload_data: bool :param reload_data: Whether to reload the project with the latest state. If you want to get the updated status, you'll want this set to :data:`True` as the DELETE method doesn't send back the updated project. Default: :data:`False`. rz :undeleter(Nr.r/r r r undeletes  zProject.undelete)NN)N)N)N)N)NF)NF)__name__ __module__ __qualname____doc__rr classmethodrrpropertyrrrr&r)r*r,r0r1r r r r rs"         rN)r5Zgcloud.exceptionsrobjectrr r r r s