l jSdZddlmZddlZddlmZddlmZmZddl Z ddl m Z dgZ erddl mZmZGd de jZdS) a``DefaultGroup`` allows a subcommand to act as the main command. In particular, this class is what allows ``manim`` to act as ``manim render``. .. note:: This is a vendored version of https://github.com/click-contrib/click-default-group/ under the BSD 3-Clause "New" or "Revised" License. This library isn't used as a dependency, as we need to inherit from :class:`cloup.Group` instead of :class:`click.Group`. ) annotationsN)Callable) TYPE_CHECKINGAny) deprecated DefaultGroup)CommandContextcleZdZdZdfd Zdd Zdfd Zdfd Zdfd Ze dfd Z xZ S)raInvokes a subcommand marked with ``default=True`` if any subcommand is not chosen. Parameters ---------- *args Positional arguments to forward to :class:`cloup.Group`. **kwargs Keyword arguments to forward to :class:`cloup.Group`. The keyword ``ignore_unknown_options`` must be set to ``False``. Attributes ---------- default_cmd_name : str | None The name of the default command, if specified through the ``default`` keyword argument. Otherwise, this is set to ``None``. default_if_no_args : bool Whether to include or not the default command, if no command arguments are supplied. This can be specified through the ``default_if_no_args`` keyword argument. Default is ``False``. argsrkwargsc|ddstdd|_|dd|_|dd|_t j|i|dS)Nignore_unknown_optionsTz%Default group accepts unknown optionsdefaultdefault_if_no_argsF)get ValueErrorrpopdefault_cmd_namersuper__init__)selfr r __class__s R/home/agentuser/manim-venv/lib/python3.11/site-packages/manim/cli/default_group.pyrzDefaultGroup.__init__4szz2D99 FDEE E&*#,2JJy$,G,G(. 3G(O(O$)&)))))commandr returnNonecL|j}||||_dS)zSets a command function as the default command. Parameters ---------- command The command to set as default. N)name add_commandr)rrcmd_names rset_default_commandz DefaultGroup.set_default_command=s-< !!! (rctxr list[str]c|s)|jr"|jr|d|jt||}|S)a}Parses the list of ``args`` by forwarding it to :meth:`cloup.Group.parse_args`. Before doing so, if :attr:`default_if_no_args` is set to ``True`` and ``args`` is empty, this function appends to it the name of the default command specified by :attr:`default_cmd_name`. Parameters ---------- ctx The Click context. args A list of arguments. If it's empty and :attr:`default_if_no_args` is ``True``, append the name of the default command to it. Returns ------- list[str] The parsed arguments. r)rrinsertr parse_args)rr$r parsed_argsrs rr(zDefaultGroup.parse_argsIsW( 2/ 2D4I 2 KK40 1 1 1!&!3!3C!>!> rr"strCommand | Nonec||jvr|jr||jd<|j}t||S)a Get a command function by its name, by forwarding the arguments to :meth:`cloup.Group.get_command`. If ``cmd_name`` does not match any of the command names in :attr:`commands`, attempt to get the default command instead. Parameters ---------- ctx The Click context. cmd_name The name of the command to get. Returns ------- :class:`click.Command` | None The command, if found. Otherwise, ``None``. arg0)commandsrmetar get_command)rr$r"rs rr0zDefaultGroup.get_commandbsH$ 4= ( (T-B ('CHV ,Hww""3111r,tuple[str | None, Command | None, list[str]]ct||\}}}d|jvr*|d|jd||j}|||fS)aGiven a list of ``args`` given by a CLI, find a command which matches the first element, and return its name (``cmd_name``), the command function itself (``cmd``) and the rest of the arguments which shall be passed to the function (``cmd_args``). If not found, return ``None``, ``None`` and the rest of the arguments. After resolving the command, if the Click context given by ``ctx`` contains an ``arg0`` attribute in its :attr:`click.Context.meta` dictionary, insert it as the first element of the returned ``cmd_args``. Parameters ---------- ctx The Click context. cmd_name The name of the command to get. Returns ------- cmd_name : str | None The command name, if found. Otherwise, ``None``. cmd : :class:`click.Command` | None The command, if found. Otherwise, ``None``. cmd_args : list[str] The rest of the arguments to be passed to ``cmd``. r-r)rresolve_commandr/r'r )rr$r r"cmdrs rr3zDefaultGroup.resolve_commandzsf<$gg55c4@@#t SX   KK38F+ , , ,8d""r*Callable[[Callable[..., object]], Command]c|dd}tj|i||sStjdt dd fd }|S) aReturn a decorator which converts any function into the default subcommand for this :class:`DefaultGroup`. .. warning:: This method is deprecated. Use the ``default`` parameter of :class:`DefaultGroup` or :meth:`set_default_command` instead. Parameters ---------- *args Positional arguments to pass to :meth:`cloup.Group.command`. **kwargs Keyword arguments to pass to :meth:`cloup.Group.command`. Returns ------- Callable[[Callable[..., object]], click.Command] A decorator which transforms its input into this :class:`DefaultGroup`'s default subcommand. rFzBUse default param of DefaultGroup or set_default_command() instead) stacklevelfrrr cH|}||S)N)r#)r9r4 decoratorrs r _decoratorz(DefaultGroup.command.._decorators))A,,C  $ $S ) ) )Jr)r9rrr )rrrwarningswarnDeprecationWarning)rr r rr<r;rs` @rrzDefaultGroup.commands0**Y..@O A A A    P             r)r rr r)rr rr)r$r r r%rr%)r$r r"r*rr+)r$r r r%rr1)r rr rrr5) __name__ __module__ __qualname____doc__rr#r(r0r3rr __classcell__)rs@rrrs,****** ) ) ) )22222220############J(((((Z(((((r)rC __future__rr=collections.abcrtypingrrcloupmanim.utils.deprecationr__all__clickr r GrouprrrrNs  #"""""$$$$$$%%%%%%%% ......  '&&&&&&&&kkkkk5;kkkkkr