5i3'dZddlmZmZmZmZddlZddlmZddlm Z ddl m Z dd l mZdd Zd Zd Zd ZddZdZdZdZy)a These functions provide shorthand functional interfaces for actions such as getting a :class:`~dxpy.bindings.DXDataObject` handler from an ID or `link `_, or creating a link from a handler. In addition, there are functions for performing simple actions with an ID or link as input without creating a full object handler. )print_functionunicode_literalsdivisionabsolute_importN) DXDataObject)__dict__)DXError) basestringct|r|St|tr|j}t ||fsd|iS|rt j |dd||diSd||diS)a6 :param object_id: Object ID or the object handler itself :type object_id: string or :class:`~dxpy.bindings.DXDataObject` :param project_id: A project ID, if creating a cross-project DXLink :type project_id: string :param field: A field name, if creating a job-based object reference :type field: string :returns: A dict formatted as a symbolic DNAnexus object reference :rtype: dict Creates a DXLink to the specified object. If `object_id` is already a link, it is returned without modification. If `object_id is a `~dxpy.bindings.DXDataObject`, the object ID is retrieved via its `get_id()` method. If `field` is not `None`, `object_id` is expected to be of class 'job' and the link created is a Job Based Object Reference (JBOR), which is of the form:: {'$dnanexus_link': {'job': object_id, 'field': field}} If `field` is `None` and `project_id` is not `None`, the link created is a project-specific link of the form:: {'$dnanexus_link': {'project': project_id, 'id': object_id}} $dnanexus_linkjob)rfield)projectid) is_dxlink isinstancerget_idanydxpyverify_string_dxid) object_id project_idrs /home/marpiech/ifpan-abm-pgxpred/analysis/marpiech-gwas-test/venv/lib/python3.12/site-packages/dxpy/bindings/dxdataobject_functions.pydxlinkr%su:)\*$$&  E" # ),,   51 )e"DEE j "JKKct|tsyd|vry|dttryttrtfddDSy)z :param x: A potential DNAnexus link Returns whether *x* appears to be a DNAnexus link (is a dict with key ``"$dnanexus_link"``) with a referenced data object. FrTc3&K|]}|v ywN).0keylinks r zis_dxlink..]s833$;8s)rr)rdictr r)xr$s @rrrNsS a q   D$ # D$ 8-888 rct|std|zt|dtr|ddfSd|dvr|dd|dj dfS|dd|ddfS)a  :param link: A DNAnexus link :type link: dict :returns: (Object ID, Project ID) if the link is to a data object (or :const:`None` if no project specified in the link), or (Job ID, Field) if the link is a job-based object reference (JBOR). :rtype: tuple Get the object ID and detail from a link. There are three types of links: * Simple link of the form ``{"$dnanexus_link": "file-XXXX"}`` returns ``("file-XXXX", None)``. * Data object link of the form ``{"$dnanexus_link': {"id": "file-XXXX", "project": "project-XXXX"}}`` returns ``("file-XXXX", "project-XXXX")``. * Job-based object reference (JBOR) of the form ``{"$dnanexus_link": {"job": "job-XXXX", "field": "foo"}}`` returns ``("job-XXXX", "foo")``. zInvalid link: %rrNrrrr)rr rr get)r$s rget_dxlink_idsr*`s$ T?(4/00$'(*5$%t++ &' '$%d+T2B-C-G-G -RRR$%e,d3C.DW.MMMrct|rt|dn|}d|jdddjz}|tvrddij |}|tvr t d|t|}|S)NrDX-rDXGlobalworkflowDXGlobalWorkflowzInvalid class name: %s)rr*split capitalize all_bindingsr)r ) id_or_linkr class_nameclss r_guess_link_target_typer6{s1::1Fz*1-JI Q/2==??J%  2 #j/ %. ;; z "C JrcX t|}|tj tj fvr}tjjj|r||S|jd}|jd}|dk(r|||dzdS|||dz|||dzdS|@|tjtjtjtjfvr||S||| S#t$r }tdj||d}~wwxYw) a :param id_or_link: String containing an object ID or dict containing a DXLink :type id_or_link: string or dict :param project: String project ID to use as the context if the the object is a data object :type project: string :rtype: :class:`~dxpy.bindings.DXObject`, :class:`~dxpy.bindings.DXApp`, or :class:`~dxpy.bindings.DXGlobalWorkflow` Parses a string or DXLink dict. Creates and returns an object handler for it. Example:: get_handler("file-1234") zCould not parse link {}: {}N/r-r)name)r:alias)r)r6 Exceptionr formatrDXAppr/utilsresolver is_hashidfindDXJob DXAnalysis DXProject DXContainer)r3rr5e slash_posdash_poss r get_handlerrJsK%j1 tzz40011 ::   ( ( 4z? "",I!s+HB 8A:; 788 8A:i @!+IMN!;== CDJJQUQaQa#bb::w//- K3:::qIJJKs D D) D$$D)c .t|ts t|rt|}|jd i|Sg}|D]?}t|r!t|dtr|d}n|dd}|j |A|j dgrt|dDcgc]}|dfc}nd}|Dcgc]}||d }}d|i}d|vr|d|d<tjj|} | dD cgc]} | d  c} Scc}wcc}wcc} w) a :param id_or_link: String containing an object ID or dict containing a DXLink, or a list of object IDs or dicts containing a DXLink. Given an object ID, calls :meth:`~dxpy.bindings.DXDataObject.describe` on the object. Example:: describe("file-1234") Given a list of object IDs, calls :meth:`~dxpy.api.system_describe_data_objects`. Example:: describe(["file-1234", "workflow-5678"]) Note: If id_or_link is a list and **kwargs contains a "fields" parameter, these fields will be returned in the response for each data object in addition to the fields included by default. Additionally, describe options can be provided for each data object class in the "classDescribeOptions" kwargs argument. See https://documentation.dnanexus.com/developer/api/system-methods#api-method-system-describedataobjects for input parameters used with the multiple object describe method. rrfieldsT)rdescribeobjectsclassDescribeOptionsresultsrMr!) rr rrJrMappendr)r&rapisystem_describe_data_objects) r3kwargshandlerlinksr$rdescribe_inputdescribe_links_inputbulk_describe_inputdata_object_descriptionsdescs rrMrMs;4*j)Yz-Bj)w)&)) Dd#34jA 01D 01$7D LL  DJ::hXZC[DVH-=>E5$-> ?ae UZ[Tt H[[(*>? !V +:@AW:X  6 7#'88#H#HI\#] -Ei-PQTZ QQ?[Rs D5 D 9 Dc <t|}|jdi|S)z :param id_or_link: String containing an object ID or dict containing a DXLink Given an object ID, calls :meth:`~dxpy.bindings.DXDataObject.get_details` on the object. Example:: get_details("file-1234") r!)rJ get_detailsr3rTrUs rr]r]s$*%G 7   ( ((rc <t|}|jdi|S)z :param id_or_link: String containing an object ID or dict containing a DXLink Given an object ID, calls :meth:`~dxpy.bindings.DXDataObject.remove` on the object. Example:: remove("file-1234") r!)rJremover^s rr`r`s"*%G 7>> #F ##r)NNr )__doc__ __future__rrrrrrr r2 exceptionsr compatr rrr*r6rJrMr]r`r!rrrfsP" SR & 'LR$N6 &0P5Rn ) $r