-ePUdZddlmZddlZejeZddlmZm Z ddl m Z m Z ddl mZmZmZmZmZmZddlmZmZmZmZerdd lmZd ZeGd d Zeeeeed ffefZde d<eed fZ!de d<GddeZ"dS)zX Provides a base class for defining subcommands of the Bokeh command line application. ) annotationsN)ABCMetaabstractmethod)ArgumentParser Namespace) TYPE_CHECKINGAnyClassVarLiteralSequenceUnion) NotRequired Unspecified dataclassentries) TypeAlias) SubcommandceZdZUeZded<eZded<eZded<eZded<eZ ded <eZ d ed <eZ d ed <eZ ded<eZ ded<dS)ArgumentzzNotRequired[Literal['store', 'store_const', 'store_true', 'append', 'append_const', 'count', 'help', 'version', 'extend']]actionz0NotRequired[int | Literal['?', '*', '+', '...']]nargszNotRequired[Any]constdefaultzNotRequired[type[Any]]typezNotRequired[Sequence[Any]]choiceszNotRequired[bool]requiredzNotRequired[str]helpmetavarN)__name__ __module__ __qualname__rr__annotations__rrrrrrrr8lib/python3.11/site-packages/bokeh/command/subcommand.pyrr?sJUFUUUU>IEIIII)E)))) +G++++#.D....*5G5555"-H----(D(((( +G++++++r%r.rArgArgscVeZdZUdZded<ded<dZded<dd ZeddZdS)ra  Abstract base class for subcommands Subclasses should implement an ``invoke(self, args)`` method that accepts a set of argparse processed arguments as input. Subclasses should also define the following class attributes: * ``name`` a name for this subcommand * ``help`` a help string for argparse to use for this subcommand * ``args`` the parameters to pass to ``parser.add_argument`` The format of the ``args`` should be a sequence of tuples of the form: .. code-block:: python ('argname', Argument( metavar='ARGNAME', nargs='+', )) Example: A simple subcommand "foo" might look like this: .. code-block:: python class Foo(Subcommand): name = "foo" help = "performs the Foo action" args = ( ('--yell', Argument( action='store_true', help="Make it loud", )), ) def invoke(self, args): if args.yell: print("FOO!") else: print("foo") Then executing ``bokeh foo --yell`` would print ``FOO!`` at the console. z ClassVar[str]namerr$zClassVar[Args]argsparserrreturnNonec||_|jD]e}|\}}t|ts|f}t|tst t |}n|}|jj|i|fdS)at Initialize the subcommand with its parser Args: parser (Parser) : an Argparse ``Parser`` instance to configure with the args for this subcommand. This method will automatically add all the arguments described in ``self.args``. Subclasses can perform any additional customizations on ``self.parser``. N)r,r+ isinstancetupledictr add_argument)selfr,argflagsspeckwargss r&__init__zSubcommand.__init__s 9 7 7CKE4eU++ !dD)) gdmm,, $DK $e 6v 6 6 6 6 7 7r%r bool | Nonec td)a Takes over main program flow to perform the subcommand. *This method must be implemented by subclasses.* subclassed overwritten methods return different types: bool: Build None: FileOutput (subclassed by HTML, SVG and JSON. PNG overwrites FileOutput.invoke method), Info, Init, Sampledata, Secret, Serve, Static Args: args (argparse.Namespace) : command line arguments for the subcommand to parse Raises: NotImplementedError zimplement invoke())NotImplementedError)r4r+s r&invokezSubcommand.invokes$""6777r%N)r,rr-r.)r+rr-r:) r r!r"__doc__r#r+r9rr=r$r%r&rrNs//bD77770888^888r%r) metaclass)#r> __future__rlogging getLoggerr logabcrrargparserrtypingrr r r r r util.dataclassesrrrrtyping_extensionsr__all__rr1strr'r#r(rr$r%r&rKs#"""""g!!('''''''........,++++++    , , , , , , ,  ,uS%S/12H<=====S/!!!!`8`8`8`8`87`8`8`8`8`8`8r%