o wiq#@sdZddlmZddlmZddlmZmZmZddl m Z ddl m Z ddl mZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZerhddlmZddlm Z ddl!m"Z"GdddedZ#GdddeZ$dS)a3W&B Public API for Project objects. This module provides classes for interacting with W&B projects and their associated data. Example: ```python from wandb.apis.public import Api # Get all projects for an entity projects = Api().projects("entity") # Access project data for project in projects: print(f"Project: {project.name}") print(f"URL: {project.url}") # Get artifact types for artifact_type in project.artifacts_types(): print(f"Artifact Type: {artifact_type.name}") # Get sweeps for sweep in project.sweeps(): print(f"Sweep ID: {sweep.id}") print(f"State: {sweep.state}") ``` Note: This module is part of the W&B Public API and provides methods to access and manage projects. For creating new projects, use wandb.init() with a new project name. ) annotations)Mapping) TYPE_CHECKINGAnyClassVar)override)gql)nameof)public)Attrs)normalize_exceptions)RelayPaginator)RetryingClient)Sweeps)ipython)Document Connection)ProjectFragmentcsjeZdZUdZdZded<ded< ddfdd ZedddZe dddZ d ddZ ddZ Z S)!ProjectsaAn lazy iterator of `Project` objects. An iterable interface to access projects created and saved by the entity. Args: client (`wandb.apis.internal.Api`): The API client instance to use. entity (str): The entity name (username or team) to fetch projects for. per_page (int): Number of projects to fetch per request (default is 50). Example: ```python from wandb.apis.public.api import Api # Find projects that belong to this entity projects = Api().projects(entity="entity") # Iterate over files for project in projects: print(f"Project: {project.name}") print(f"- URL: {project.url}") print(f"- Created at: {project.created_at}") print(f"- Is benchmark: {project.is_benchmark}") ``` NzClassVar[Document | None]QUERYz"Connection[ProjectFragment] | None last_response2clientrentitystrper_pageintreturncsD|jdurddlm}t|t|_||_tj|d|i|ddS)aAn iterable collection of `Project` objects. Args: client: The API client used to query W&B. entity: The entity which owns the projects. per_page: The number of projects to fetch per request to the API. Nr)GET_PROJECTS_GQLr) variablesr)rwandb.apis._generatedrrtypersuper__init__)selfrrrr __class__N/home/ubuntu/.local/lib/python3.10/site-packages/wandb/apis/public/projects.pyr$Ws zProjects.__init__NonecCspddlm}ddlm}m}|jj|j|jd}| |}|j }s.t dt t |d|| ||_dS)z:Fetch and validate the response data for the current page.rr) GetProjectsr)variable_valueszUnable to parse z response dataN)wandb._pydanticrr!r+rrexecuterr model_validatemodels ValueErrorr r"r)r%rr+rdataresultconnr(r(r)_update_responsels   zProjects._update_responsecCsdS)zReturns the total number of projects. Note: This property is not available for projects. Nr(r%r(r(r)lengthxs zProjects.lengthnoderProjectcCst|j|j|j|SN)r9rrname model_dump)r%r8r(r(r)_convertszProjects._convertcCsd|jdS)Nz )rr6r(r(r)__repr__szProjects.__repr__r)rrrrrrrrrr*)r8rrr9)__name__ __module__ __qualname____doc__r__annotations__r$rr5propertyr7r=r? __classcell__r(r(r&r)r:s     r)rr9cseZdZdZd9fd d Zd:d dZed;ddZedd?ddZ d=dd Z d!d"Z e d@dAd&d'Ze ( ( #dBdCd.d/Ze d@dDd1d2Zed=d3d4ZedEfd7d8 ZZS)Fr9zA project is a namespace for runs. Args: client: W&B API client instance. name (str): The name of the project. entity (str): The entity name that owns the project. rrrrprojectattrsMapping[str, Any]rcs,t|t||_||_||_||_dS)aA single project associated with an entity. Args: client: The API client used to query W&B. entity: The entity which owns the project. project: The name of the project to query. attrs: The attributes of the project. N)r#r$bool _is_loadedrr;r)r%rrrIrJr&r(r)r$s   zProject.__init__r*c Csddlm}ddlm}m}|j|jd}z |jt ||}Wn|y4}zt d||d}~ww| |j }|rA| ni|_d|_dS)Nr) HTTPError)GET_PROJECT_GQL GetProject)r;rzUnable to fetch project ID: T)requestsrNr!rOrPr;rrr.rr1r/rIr<_attrsrM)r%rNrOrPgql_varsr2erIr(r(r)_loads   z Project._load public.UsercCs<|js|d|jvrtd|jt|j|jdS)zReturns the project owner as a User object. Raises: ValueError: when no user information is found for the project. userzNo user found for project )rMrUrRr1r;r Userrr6r(r(r)owners  z Project.owner list[str]cCs |j|jgS)zcReturns the path of the project. The path is a list containing the entity and project name.)rr;r6r(r(r)paths z Project.pathcCs|jjd|jdgS)zReturns the URL of the project./ workspace)rapp_urljoinr[r6r(r(r)urlsz Project.urlFheightrhiddenrLcCsF|jd}d|d}d}|r|d7}td}|d|d|d S) zoGenerate HTML containing an iframe displaying this project. z ?jupyter=truezborder:none;width:100%;height:zpx;z display:none;rIz )r`r toggle_button)r%rbrcr`styleprefixr(r(r)to_htmls   zProject.to_htmlcCs|Sr:)rhr6r(r(r) _repr_html_szProject._repr_html_cCsdd|jS)Nz r\)formatr_r[r6r(r(r)r?szProject.__repr__rrpublic.ArtifactTypescCst|j|j|jS)z8Returns all artifact types associated with this project.)r ArtifactTypesrrr;r%rr(r(r)artifacts_typesszProject.artifacts_typesNfiltersMapping[str, Any] | Noneorder str | None!public.ProjectArtifactCollectionscCstj|j|j|j|||dS)aReturns all artifact collections associated with this project. Args: filters: Optional mapping of filters to apply to the query. order: Optional string to specify the order of the results. If you prepend order with a + order is ascending (default). If you prepend order with a - order is descending. per_page: The number of artifact collections to fetch per page. Default is 50. )rorqr)r ProjectArtifactCollectionsrrr;)r%rorqrr(r(r) collectionsszProject.collectionsrcCst|j|j|j|dS)aReturn a paginated collection of sweeps in this project. Args: per_page: The number of sweeps to fetch per request to the API. Returns: A `Sweeps` object, which is an iterable collection of `Sweep` objects. )r)rrrr;rmr(r(r)sweepss zProject.sweepscCs4|js|d|jvrtd|jd|jdS)NidzProject z not found)rMrUrRr1r;r6r(r(r)rw s   z Project.idr;rcs|js|t|Sr:)rMrUr# __getattr__)r%r;r&r(r)rxs zProject.__getattr__) rrrrrIrrJrKrr9rA)rrV)rrZ)rr)raF)rbrrcrLrrr@)rrrrk)NNr)rorprqrrrrrrs)rrrr)r;rrr)rBrCrDrEr$rUrGrYr[r`rhrir?r rnrurvrwrrxrHr(r(r&r)r9s4        r9N)%rE __future__rcollections.abcrtypingrrrtyping_extensionsr wandb_gqlrwandb._strutilsr wandb.apisr wandb.apis.attrsr wandb.apis.normalizer wandb.apis.paginatorr wandb.apis.public.apirwandb.apis.public.sweepsr wandb.sdk.librwandb_graphql.language.astrr-rr!rrr9r(r(r(r)s( !              P