B ‹æ@\ûã@sfdZddlmZmZmZmZddlZe e¡Z ddl m Z m Z ddl mZdZGdd„dee ƒƒZdS) zX Provides a base class for defining subcommands of the Bokeh command line application. é)Úabsolute_importÚdivisionÚprint_functionÚunicode_literalsN)ÚABCMetaÚabstractmethod)Úwith_metaclass)Ú Subcommandc@s$eZdZdZdd„Zedd„ƒZdS)r a 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', dict( 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', dict( 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. cCsN||_t|ddƒ}x6|D].}|d}t|tƒs4|f}|jj||dŽqWdS)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``. Úargs©réN)ÚparserÚgetattrÚ isinstanceÚtupleÚ add_argument)Úselfr r ÚargÚflagsr r ú7lib/python3.7/site-packages/bokeh/command/subcommand.pyÚ__init__bs    zSubcommand.__init__cCs tdƒ‚dS)a Takes over main program flow to perform the subcommand. *This method must be implemented by subclasses.* Args: args (seq) : command line arguments for the subcommand to parse Raises: NotImplementedError zimplement invoke()N)ÚNotImplementedError)rr r r rÚinvokevs zSubcommand.invokeN)Ú__name__Ú __module__Ú __qualname__Ú__doc__rrrr r r rr 0s0r )rZ __future__rrrrZloggingZ getLoggerrÚlogÚabcrrZbokeh.util.futurerÚ__all__r r r r rÚ s