o 2j @sUdZddlZddlZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z ddlmZddlmZmZmZmZmZmZddlZddlZddlmZmZddlmZmZmZdd l m!Z!dd l"m#Z#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)d d l*m+Z+d dl,m-Z-m.Z.e&/Z0dZ1erddl2m3Z3dde4dBddfddZ5dZ6dde7e4de4dBde4fddZ8ede4BZ9e e7e4e:e4ge;dBfZd ej?ddfd!d"Z@eAd#ZBGd$d%d%eZCgd&ZDe7eEe4e4feFd'<d ej?ddfd(d)ZGd*ejHdeIfd+d,ZJd*ejHd-e7e4ddfd.d/ZKd-e7e4deIfd0d1ZLd-e7e4d2eId3eIddfd4d5ZMd6e4dd7fd8d9ZNd:ejOd;e4dZP dd?eOsz"generate_epilog..z Examples zk Learn more Use `hf --help` for more information about a command. Read the documentation at )CLI_REFERENCE_URLjoin)r'r(docs_url examples_strr$r$r%generate_epilogDs r1)mainhelpExpandPropertyT)boundepilogctx formattercCs.|r||dD] }||q dSdS)z%Write the epilog without indentation.r)N)write_paragraphsplit write_text)r6r7r8liner$r$r%_format_epilog_no_indent_s  r=z\s*\|\s*cseZdZdZeZdejddffdd Zdejde e de ffdd Z e d ejde e ddfd d Zdejd e dejdBffdd Zdee e e ffddZdejdejddfddZdejdejddfddZdejde e fddZZS)HFCliTyperGroupa Typer Group that: - lists commands alphabetically within sections. - separates commands by topic (main, help, etc.). - formats epilog without extra indentation. - supports aliases via pipe-separated names (e.g. ``name="list | ls"``). - consumes the global formatting flags (``--format``, ``--json``, ``-q`` / ``--quiet``, ``--no-truncate``) anywhere in the args of a leaf command and applies them to ``out``, so leaf commands don't need to declare these options themselves. - rewrites ``spaces/user/repo`` to ``user/repo --type space`` for commands that accept ``--type``. - enriches "No such option" / "No such command" errors with available options or commands. r7r Nc szt|WStjyTz@jdurOjjdurOjjttjr;fddjD}t d|fdd jD}t d|dww)atEnrich unknown-option errors with available options or subcommands. Catches `NoSuchOption` raised during subcommand `make_context()` (option parsing). For leaf commands (e.g. `hf repos create --test`) we list the command's options; for groups (e.g. `hf cache --test`) we list subcommands since groups have no user-facing options. Ncs8g|]}j|durjs|jddfqSNPlimit) get_commandr7hiddenget_short_help_strr*name)cmdesubr$r% s z*HFCliTyperGroup.invoke..commandscs2g|]}t|tjr|js|jrqSr$) isinstanceclickOptionrDget_help_recordr7r*p)rIrecordr$r%rKs options) superinvokerN NoSuchOptionr7commandrMGroup list_commands_enrich_usage_error get_params)selfr7items __class__)rHrIrSrJr%rVzs$     zHFCliTyperGroup.invokeargsc s.|r |dds |dnd}|r|nd}|dur#||z t|\}}}WnStjy}zF|dur}|dur}ddjD} t || } | rid dd| D} |j dd | d |_ fd dD} t|d | d}~ww|durt|tjst|||||fS) Nr-cSs*g|]\}}|jst|D]}|qqSr$)rD _ALIAS_SPLITr:)r*key registeredaliasr$r$r%rKsz3HFCliTyperGroup.resolve_command.., css|] }d|dVqdS)'Nr$r*mr$r$r%r,sz2HFCliTyperGroup.resolve_command...z. Did you mean ?cs6g|]}|durjs|jddfqSr?)rCrDrErFr7r]rJr$r%rKs rL) startswithrC_rewrite_repo_type_prefixrUresolve_commandrN UsageErrorrLr^difflibget_close_matchesr.messagerstriprZr[rMrY_consume_format_flags_for_leaf) r]r7racmd_namerHrG resolved_cmdsub_argsrI visible_namesmatches suggestionsr^r_rmr%rps2     zHFCliTyperGroup.resolve_commandrHcCs2tdd|jD}|sdSt}d}|jD]}t|tjr,|jdvr(|||d7}q|s1dSt}|jD]}t|tjrS|j sSg|j |j RD]}||qKq7d}g} d} | t |kr|| } | dkrin.| drd | vsv| |vr{| d7} n| d 7} n||vr| | |d7}| d7} | t |ks`| sdSd} d} g}| D]I}||d d }t |d ks|dtjvrq|d}tj|}| dur|| krtd | d|d|} |} |||dd |d fq|sdStdd|Drtd| d|D] \}}|||<q|d| gdS)uRewrite prefixed repo IDs (e.g. ``spaces/user/repo``) to ``user/repo --type space``. Only applies to commands that have a ``--type`` / ``--repo-type`` option and at least one repo-ID positional argument (any ``click.Argument`` whose name ends with ``_id``, e.g. ``repo_id``, ``from_id``, ``to_id``). When the token that maps to such an argument matches ``{prefix}/org/repo`` (where *prefix* is one of ``spaces``, ``datasets``, or ``models``), the prefix is stripped and an implicit ``--type {type}`` is appended. An error is raised if ``--type`` is also provided explicitly or if multiple prefixed arguments disagree on the repo type. Only repo-ID positional slots are inspected so that other positional arguments (filenames, local paths, patterns …) are never misinterpreted as prefixed repo IDs. css&|]}t|tjod|jvVqdS)--typeN)rMrNrOopts)r*paramr$r$r%r,s$z.Nr)repo_idfrom_idto_idr--rb=/z!Conflicting repo type prefixes: 'z/' and 'z/'.css4|]}|dkp|dp|dkp|dVqdS)r}z--type= --repo-typez --repo-type=Nrnr*argr$r$r%r,s " z!Ambiguous repo type: got prefix 'z8/' in repo ID and explicit --type. Use one or the other.r})anyparamssetrMrNArgumentrGaddrOis_flagr~secondary_optslenrnappendr:rREPO_TYPES_MAPPINGrqextend)rHrahas_type_optionrepo_id_positionsarg_idxr value_optionsoptpositional_countrepo_id_arg_indicesir inferred_type first_prefixrewrites arg_indexpartsprefix mapped_type new_valuer$r$r%ros|             "    z)HFCliTyperGroup._rewrite_repo_type_prefixrwcsLt||}|dur |S|jD]\}}t|}||vr#|SqdSN)rUrCrLr^rcr:)r]r7rwrHregistered_nameregistered_cmdaliasesr_r$r%rC!s zHFCliTyperGroup.get_commandcCs6i}|jD]}t|}|d}|dd||<q|S)zBBuild a mapping from primary command name to its aliases (if any).rrN)rLrcr:)r]resultrrprimaryr$r$r% _alias_map.s   zHFCliTyperGroup._alias_mapr8c Cs(i}|}||D];}|||}|dus|jrq |j|jd}||g}|r5|dd|d}t|dd} | | g ||fq | d| |dWdn1s^wYt |D](} | dkrpqi| | d| || Wdn1swYqidS) NrAz [alias: rg]topicr2z Main commandsz commands)rrZrCrDrEwidthgetr.getattr setdefaultrsectionwrite_dlsortedkeys capitalize) r]r7r8topics alias_maprGrH help_textrrr$r$r%format_commands7s.    zHFCliTyperGroup.format_commandscCsg}||D]}|||}|dus|jrqt|dg}|r&||dq|r5t|}t|||dS|jrAt|j||dSdS)Nr'r)rZrCrDrrr1r=r6)r]r7r8 all_examplesrGrH cmd_examplesr6r$r$r% format_epilogNs  zHFCliTyperGroup.format_epilogcCs0g}|jD]}t|d}||qt|S)Nr)rLrcr:rr)r]r7 primary_namesrGrr$r$r%rZ`s   zHFCliTyperGroup.list_commands)__name__ __module__ __qualname____doc__r context_classrNContextrVliststrtuplerp staticmethodCommandrorCdictr HelpFormatterrrrZ __classcell__r$r$r_r%r>js  '"`   r>))z&--format [auto|human|agent|json|quiet]zWOutput format. Defaults to 'auto' which picks 'agent' or 'human' based on the terminal.)--jsonz+JSON output. Equivalent to '--format json'.)z -q, --quietz?Quiet output (one ID per line). Equivalent to '--format quiet'.) --no-truncatezQDo not truncate scalar values in human tables (list/dict columns stay shortened). _FORMATTING_OPTIONS_HELP_RECORDScCs:|d|tWddS1swYdS)NzFormatting options)rrr)r8r$r$r%"_format_formatting_options_sectionts  "rrHcCsV|jD]%}t|tjs qg|j|jR}d|vs%d|vs%d|vs%d|vr(dSqdS)aReturn True if the command defines its own --format, --json or --quiet / -q. Used to skip the global formatting flag pre-processor and the duplicated "Formatting options" help section for legacy commands like 'hf jobs ps' that have their own format/quiet options. --formatr--quiet-qTF)rrMrNrOr~r)rHrr~r$r$r%_has_local_formatting_optionys   rrac s|jdrdSt|}t|d}d}d}|jD](}t|tjs#qg|j |j R}d|vr2d}d|vs:d|vr' / '--json' / '--quiet' / '-q' are stripped from 'args' and applied to the singleton 'out'. '--no-truncate' is stripped for all non-pass-through commands; when present, human table cells are not truncated. Raises click.UsageError if multiple conflicting flags are supplied (e.g. '--json' together with '--format table'). ignore_unknown_optionsNFrTrrr) rewrite_json rewrite_quietnew_flagr cs$durtdd|ddS)Nrhz' and 'z' are mutually exclusive.)rNrq)r chosen_flagr$r%_check_conflictsz7_consume_format_flags_for_leaf.._check_conflictrrrz#Option '--format' requires a value.r --format=)rr)context_settingsr_consume_no_truncate_flagsrset_no_truncaterrMrNrOr~r_rewrite_legacy_shorthandsrautorrrq_parse_format_valuernjsonquietset_mode) rHra no_truncatehas_local_formathas_local_quiethas_local_jsonrr~ chosen_moderrrr$rr%rvst         rvcCsrd}d}|t|kr7||}|dkr |S|dkr#d}|||d=q|dr-td|d7}|t|ks |S) zSStrip all global --no-truncate flags from args and return whether any was provided.FrrrTrz--no-truncate=z-Option '--no-truncate' does not take a value.)rrnrNrq)rarrrr$r$r%rs      rrrcCstdd|D}|r'd|vr'|rtd|d}ddg|||d<d}|rWd |vr/d nd |vr5d nd }|d urY|rFtd |d ||}ddg|||d<d Sd Sd S)aRewrite --json / -q / --quiet to --format ... for legacy commands. Used for commands like 'hf jobs ps' that still own their '--format' option. The rewrite lets users keep using the global shorthand while click parses '--format ' locally. css"|] }|dkp |dVqdS)rrNrrr$r$r%r, z-_rewrite_legacy_shorthands..rz/'--json' and '--format' are mutually exclusive.rrrTrrNrhz(' and '--format' are mutually exclusive.r)rrNrqindex)rarrhas_format_in_argsidxflagr$r$r%rs     rvaluerc CsHzt|WSty#dddtD}td|d|ddw)Nrgcss|]}|jVqdSrrrir$r$r%r,sz&_parse_format_value..zInvalid value for '--format': 'z'. Valid values: rk)r ValueErrorr.rNrq)rvalidr$r$r%r s   rerrorlabelr^cCs|r|jdusd|d|jvrdS|jj}d|d|dg}|D]\}}|d|dd |q"|d |d t|tjrW|jrW|d d t |jdg|_|jd|7_dS)zHAppend a list of available options or commands to a usage error message.Nz Available z forz Available z for 'z':z 30s z Run 'z --help' for full details.z Did you mean: rgrlr)) r7rt command_pathrrMrNrW possibilitiesr.r)rrr^cmd_pathlinesrGrr$r$r%r[s  r[fallback_handlerextra_commands_providercsGfdddt}|S)zRReturn a Typer group class that runs a fallback handler before command resolution.csReZdZdejdeedeffdd Zdejdej ddffdd Z Z S) z8fallback_typer_group_factory..FallbackTyperGroupr7rar cs2|t|j}|durt|t||Sr)rrLr SystemExitrUrp)r]r7rafallback_exit_code)r`rr$r%rp*szHfallback_typer_group_factory..FallbackTyperGroup.resolve_commandr8Ncsbt||dur-}|r/|d||WddS1s&wYdSdSdS)NzExtension commands)rUrrr)r]r7r8entries)r`rr$r%r0s  "zHfallback_typer_group_factory..FallbackTyperGroup.format_commands) rrrrNrrrrrprrrr$rrr_r%FallbackTyperGroup)s"(r)r>)rrrr$rr%fallback_typer_group_factory#srrc Csdtjdtjdtjddfdd}dtdtjdtjddfdd}dtjdtjd ttdttfd d }td |tft ||p@g|||d S)Nr]r7r8r cSst|j||dSr)r=r6r]r7r8r$r$r%r<sz#HFCliCommand..format_epilogcSs6t|||t|r dS|jdrdSt|dS)Nr)r format_optionsrrrrrr$r$r%r?s   z$HFCliCommand..format_optionsracSsH|s|jstdd|jDrtj||jd|t |||S)Ncss"|] }t|tjo |jVqdSr)rMrNrrequiredrQr$r$r%r,Mrz3HFCliCommand..parse_args..)color) resilient_parsingrrrNechoget_helpr exitr parse_args)r]r7rar$r$r%rIs z HFCliCommand..parse_argsr )rrr'rrr) rNrrrr rrtyperr)rr'rrrr$r$r% HFCliCommand;s &  rc"seZdZdZ dddddddddddddd dedBd ed eedBd eeefdBd edBd edBdedBdede de de de dedBde e defge deffffddZ Z S)HFCliAppz&Custom Typer app for Hugging Face CLI.Nr2z [OPTIONS]TF) rr'rr3r6 short_helpoptions_metavaradd_help_optionno_args_is_helprD deprecatedrich_help_panelrGrr'rr3r6rrrrrDrrr .c sZdur r tdtdtfdtdtff fdd }|S)Nfunc.r cs2tt jt   d |S)N) clsrr3r6rrrrrDrr)rUrrXr)r)r`rrrr6r'r3rDrGrrrr]rrr$r%_innerxs  z HFCliApp.command.._inner)r1rr)r]rGrr'rr3r6rrrrrDrrrr_)rrrr6r'r3rDrGrrrr]rrr%rXcs BzHFCliApp.commandr) rrrrrTOPIC_TrrrboolrrXrr$r$r_r%r`sZ      rr3rc Cs2|durt}t||dd|dddddddgdd S) a+Create a Typer app with consistent settings. Args: help: Help text for the app. epilog: Optional epilog text (use `generate_epilog` to create one). cls: Optional Click group class to use (defaults to `HFCliTyperGroup`). Returns: A configured Typer app. NTFxz-hz--help)max_content_widthhelp_option_names) r3r6add_completionrrrich_markup_moderpretty_exceptions_enablesuggest_commandsr)r>r)r3r6rr$r$r% typer_factorys  r$cs`eZdZdZdeeeeBddffdd Zde de j dBd e j dBdeffd d Z ZS) SoftChoiceaA click Choice that suggests choices for autocompletion/docs but accepts any string. Unlike `click.Choice`, unknown values are passed through as-is instead of raising an error. This makes CLI options future-compatible when new server-side values are added. Accepts either a sequence of strings or an Enum class: ```python SoftChoice(SpaceHardware) # from an enum SoftChoice(["a", "b", "c"]) # from a list ``` choicesr Ncs>t|trt|trdd|Dnt|}tj|dddS)NcSsg|]}|jqSr$rrir$r$r%rKsz'SoftChoice.__init__..T)case_sensitive)rMr issubclassrrrU__init__)r]r&valuesr_r$r%r)s(zSoftChoice.__init__rrr7cs2z t|||WStjjyt|YSwr)rUconvertrN exceptions BadParameterr)r]rrr7r_r$r%r+s  zSoftChoice.convert)rrrrrrrrr)rrN Parameterrr+rr$r$r_r%r%s" 2r%c@seZdZdZdZdZdS)RepoTypemodeldatasetspaceN)rrrr0r1r2r$r$r$r%r/sr/zNThe ID of the repo (e.g. `username/repo-name` or `spaces/username/repo-name`).)r3r}rz2The type of repository (model, dataset, or space).r0)r3 show_defaultzJA User Access Token generated from https://huggingface.co/settings/tokens.zfWhether to create a private repo if repo doesn't exist on the Hub. Ignored if the repo already exists.zDGit revision id which can be a branch name, a tag, or a commit hash.zLimit the number of results.z!Filter by author or organization.zHFilter by tags (e.g. 'text-classification'). Can be used multiple times.z Search query.z-ez--envz/Set environment variables. E.g. --env ENV=valuez-sz --secretszvSet secret environment variables. E.g. --secrets SECRET=value or `--secrets HF_TOKEN` to pass your Hugging Face token.z --env-filez(Read in a file of environment variables.z/Read in a file of secret environment variables.cCs0ddlm}tj}|}dur||d<|S)zQReturn a copy of ``os.environ`` with the user's HF token injected (if available).r) get_tokenNHF_TOKEN)huggingface_hubr4osenvironcopy)r4extended_environrr$r$r%_get_extended_environ>s  r;envenv_filecCsLt}i}|r|tt||d|pgD] }|t||dq|S)zParse ``-e``/``--env``/``-s``/``--secrets`` and ``--env-file``/``--secrets-file`` CLI args into a dict. Uses an extended environment that includes the user's HF token so that bare ``--secrets HF_TOKEN`` resolves correctly. )r8)r;updaterr read_text)r<r=r:env_map env_valuer$r$r% parse_env_mapHs  rBr@cCs|sdSdd|DS)z_Convert an env/secrets dict to the ``[{"key": ..., "value": ...}]`` format used by the Hub API.NcSsg|] \}}||p ddqS))rdrr$)r*kvr$r$r%rK^sz-env_map_to_key_value_list..)r^)r@r$r$r%env_map_to_key_value_listZsrFz-vz--volumeaVMount one or more volumes. Format: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE is one of: models, datasets, spaces, buckets. TYPE defaults to models if omitted. models, datasets and spaces are always mounted read-only. buckets are read+write by default. E.g. -v hf://org/m:/data or -v hf://datasets/org/ds:/data or -v hf://buckets/org/b:/mnt:rovolumeszlist[Volume] | Nonec CsX|sdSg}|D]!}t|}|t|jj|jj|j|j|jjp d|jj p%ddq|S)a_Parse volume specs from CLI arguments. Format: hf://[TYPE/]SOURCE[/PATH]:/MOUNT_PATH[:ro|:rw] Where TYPE is one of: models, datasets, spaces, buckets (defaults to models if omitted). SOURCE is the repo/bucket identifier (e.g. 'username/my-model'). PATH is an optional subfolder inside the repo/bucket. MOUNT_PATH starts with '/'. Optional ':ro' or ':rw' suffix for read-only or read-write. Examples: hf://my-org/my-model:/data (model, implicit type) hf://models/my-org/my-model:/data (model, explicit type) hf://datasets/my-org/my-dataset:/data:ro hf://buckets/my-org/my-bucket:/mnt hf://spaces/my-org/my-space:/app hf://datasets/org/ds/train:/data (with path inside repo) hf://buckets/org/b/sub/dir:/mnt (with path inside bucket) N)rsource mount_path read_onlypathrevision) rrrrHridrIrJ path_in_reporL)rGrraw_specmountr$r$r% parse_volumesos    rQvalid_propertiescs&dtdBdttdBffdd }|S)zJCreate a callback to parse and validate comma-separated expand properties.rNr c s\|durdSdd|dD}|D]}|vr&td|ddqdd|DS)NcSsg|]}|qSr$)striprQr$r$r%rKszSmake_expand_properties_parser.._parse_expand_properties..,zInvalid expand property: 'z'. Valid values are: rgcSsg|]}tt|qSr$)r r4)r*propr$r$r%rKs)r:typerr-r.)r propertiesrUrRr$r%_parse_expand_propertiessz?make_expand_properties_parser.._parse_expand_properties)rrr4)rRrYr$rXr%make_expand_properties_parsers" rZlibrary)r6 transformerscCs2zt|WdStytjdddYdSw)a Check whether a newer version of a library is available on PyPI. If a newer version is found, print a hint pointing at `hf update`. If current version is a pre-release (e.g. `1.0.0.rc1`), or a dev version (e.g. `1.0.0.dev1`), no check is performed. If `HF_HUB_DISABLE_UPDATE_CHECK` is set, the check is skipped entirely. This function is called at the entry point of the CLI. It only performs the check once every 24 hours, and any error during the check is caught and logged, to avoid breaking the CLI. Args: library: The library to check for updates. Currently supports "huggingface_hub" and "transformers". z$Error while checking for CLI update.Texc_infoN)_check_cli_update Exceptionloggerdebug)r[r$r$r%check_cli_updates  rccs&tjrdStj|tfdddDrdStjtj r0tj tj }t |dkr0dSt tj j jdddt tj |dkrOtdkrOt}nt|}|dus[|kr]dS|dkret}nt}d |d |d d }|dur|dkr|d 7}n |dd|7}t|dS)Nc3s|]}|vVqdSrr$)r*tagcurrent_versionr$r%r,sz$_check_cli_update..)rcdeviQT)parentsexist_okr6brewzA new version of z (z&) is available! You are using version rkz To update, run: hf updatez To update, run: r)rHF_HUB_DISABLE_UPDATE_CHECK importlibmetadataversionrr7rKexistsCHECK_FOR_UPDATE_DONE_PATHgetmtimetimerparentmkdirtouchr_fetch_latest_brew_version_fetch_latest_pypi_version#_get_huggingface_hub_update_command _get_transformers_update_commandr.rhint)r[mtimelatest_versionupdate_commandrtr$rer%r_s6  r_cCsVztjd|ddd}t||ddWSty*tjddd Yd Sw) zSFetch the latest version of a library from PyPI. Returns None if the request fails.zhttps://pypi.org/pypi/z/jsonrtimeoutinforoz.Error while fetching latest version from PyPI.Tr]Nrrrrr`rarb)r[responser$r$r%rxs rxcCsNztjddd}t||ddWSty&tjdddYd Sw) zkFetch the latest version of the `hf` formula from the Homebrew registry. Returns None if the request fails.z,https://formulae.brew.sh/api/formula/hf.jsonrrversionsstablez2Error while fetching latest version from Homebrew.Tr]Nr)rr$r$r%rws rwcCs t}|dur tdt|S)zRun the install-method-appropriate update command for the `hf` CLI. Raises CLIError if the installation method can't be determined. Returns the subprocess exit code on success/failure of the update itself. NzeCannot determine how to update huggingface_hub (unknown installation method). Please update manually.)ryr subprocesscall)rHr$r$r% run_updates  rcCsbtdkr gdSdkrtjdkrgdSdkr"gdSdkr.tjddd d d gS d S) zlReturn the command to update huggingface_hub as an argv list, or None if the installation method is unknown.rk)rkupgradehf hf_installernt) powershell -NoProfile-Commandz-iwr -useb https://hf.co/cli/install.ps1 | iex)bash-cz0curl -LsSf https://hf.co/cli/install.sh | bash -pip-minstall-Ur6Nrr7rGsys executabler$r$r$r%rys  rycCsPtdkrtjdkrgdSdkrgdSdkr%tjddddd gS d S) ziReturn the command to update transformers as an argv list, or None if the installation method is unknown.rr)rrrz?iwr -useb https://hf.co/cli/install.ps1 | iex -WithTransformers)rrzHcurl -LsSf https://hf.co/cli/install.sh | bash -s -- --with-transformersrrrrr\Nrr$r$r$r%rzs rzr)NN)xrrrimportlib.metadatarmr7rerrrscollections.abcrrenumrpathlibrtypingrrrr r r rNrV typer.corer r r6rrrhuggingface_hub.errorsrhuggingface_hub.utilsrrrrrhuggingface_hub.utils._dotenvr_help_formatterr_outputrr get_loggerraREPO_LIST_DEFAULT_LIMITr#rrr&r-rr1rrintFallbackHandlerTr4rrr=compilercr>rr__annotations__rrrrrvrrrrqr[rrrTyperrr$Choicer%r/r RepoIdArgrO RepoTypeOptRepoTypeOptionalOptTokenOpt PrivateOpt RevisionOptLimitOpt AuthorOpt FilterOpt SearchOptEnvOpt SecretsOpt EnvFileOptSecretsFileOptrr;rBrF VolumesOptrQrZrcr_rxrwrryrzr$r$r$r%st           "  Y( $%(+#             . &+