o i@sHUdZddlZddlmZddlZddlZddlmZmZddl m Z ddl m Z ddl mZmZddlmZdaejdBed <d Zeed ed Zd ZdededefddZdedeeeeffddZdedeeeeffddZdejddfddZ e!ee ejgdffZ"de"fddZ#ddeedBddfddZ$dS) zPydicom command line interface program Each subcommand is a module within pydicom.cli, which defines an add_subparser(subparsers) function to set argparse attributes, and calls set_defaults(func=callback_function) N) entry_points)castAny)Callable)dcmread)get_charset_filesget_testdata_file)Dataset subparsersz\w+(\[(-)?\d+\])?z(\.z)*$a[File specification, in format [pydicom::]filename[::element]. If `pydicom::` prefix is present, then use the pydicom test file with that name. If `element` is given, use only that data element within the file. Examples: path/to/your_file.dcm, your_file.dcm::StudyDate, pydicom::rtplan.dcm::BeamSequence[0], yourplan.dcm::BeamSequence[0].BeamNumberdselementreturnc Csbz td|d|iWStytd|dty0}z td|d|d}~ww)Nzds.r zData element 'z' is not in the dataset'z' has an index error: )evalAttributeErrorargparseArgumentTypeError IndexError)r r erF/mnt/sdb/aimis/docanh/lib/python3.10/site-packages/pydicom/cli/main.py eval_element/s  rfilespeccCs^|d^}}|sd|dfS|ddkrdnd}|r |d|s'||dfS|d||fS)zParse the filespec format into prefix, filename, element Format is [prefix::filename::element] Note that ':' can also exist in valid filename, e.g. r'c: emp est.dcm' z::rpydicom)splitpopjoin)r prefix_filelastprefixrrrfilespec_parts:s   r!c Cs,t|\}}}z ttt|}Wn tyd}Ynw|s4z t|}|r)|d}Wn ty3Ynw|dkr:|}|rJt|sJt d|dzt |dd}Wn2t yn|rad|d nd}t d |d |t y}z t d |d |d}~ww|s|dfgSt||} || fgS)aiUtility to return a dataset and an optional data element value within it Note: this is used as an argparse 'type' for adding parsing arguments. Parameters ---------- filespec: str A filename with optional `pydicom::` prefix and optional data element, in format: [pydicom::][::] If an element is specified, it must be a path to a data element, sequence item (dataset), or a sequence. Examples: your_file.dcm your_file.dcm::StudyDate pydicom::rtplan.dcm::BeamSequence[0] pydicom::rtplan.dcm::BeamSequence[0].BeamLimitingDeviceSequence Returns ------- List[Tuple[Dataset, Any]] Matching pairs of (dataset, data element value) This usually is a single pair, but a list is returned for future ability to work across multiple files. Note ---- This function is meant to be used in a call to an `argparse` library's `add_argument` call for subparsers, with name="filespec" and `type=filespec_parser`. When used that way, the resulting args.filespec will contain the return values of this function (e.g. use `ds, element_val = args.filespec` after parsing arguments) See the `pydicom.cli.show` module for an example. Raises ------ argparse.ArgumentTypeError If the filename does not exist in local path or in pydicom test files, or if the optional element is not a valid expression, or if the optional element is a valid expression but does not exist within the dataset rrrz Component 'zD' is not valid syntax for a data element, sequence, or sequence itemT)forcez, but 'pydicom::z' test data file is availablezFile 'z ' not foundzError reading 'z': N)r!rstrr ValueErrorrNotImplementedErrorre_file_spec_objectmatchrrrFileNotFoundError Exceptionr) rr filenamer pydicom_filenamechar_filenamesr extrar data_elem_valrrrfilespec_parserRsJ+       r/argscCsptdur tddSttj}|jr#|j|vr#tj|jdStd|dtdd|dS)NzNo subcommands are availablez;Use pydicom help [subcommand] to show help for a subcommandhelpzAvailable subcommands: z, ) r printlistchoiceskeys subcommand print_helpremover)r0 subcommandsrrr help_commands r:cCs&i}tddD] }|||j<q|S)Npydicom_subcommands)group)rloadname)r9 entry_pointrrrget_subcommand_entry_pointssr@cCstjd}tjdd|dd}|jddatjdd d}|jd d d d |j t dt }| D]}|tq4| |}t|sJ|dS||dS)zEntry point for 'pydicom' command line interface Parameters ---------- args : List[str], optional Command-line arguments to parse. If ``None``, then :attr:`sys.argv` is used. rrz'pydicom command line utilities (Python ))prog descriptionzsubcommand help)r1r1zdisplay help for subcommandsr6?zSubcommand to show help for)nargsr1)funcN)sysversionrrArgumentParseradd_subparsersr add_parser add_argument set_defaultsr:r@values parse_argsvarsr7rF)r0 py_versionparser help_parserr9r6nsrrrmains$        rU)N)%__doc__rimportlib.metadatarrerGtypingrrcollections.abcrrrpydicom.data.data_managerrrpydicom.datasetr r _SubParsersAction__annotations__re_kywd_or_itemcompiler& filespec_helpr#rtupler!r3r/ Namespacer:dictSubCommandTyper@rUrrrrs.      [