github.com/technosophos/deis@v1.7.1-0.20150915173815-f9005256004b/docs/customizing_deis/cli-plugins.rst (about)

     1  :title: CLI Plugins
     2  :description: How to manage plugins for the Deis CLI.
     3  
     4  .. _cli_plugins:
     5  
     6  CLI Plugins
     7  ===========
     8  
     9  Plugins allow developers to extend the functionality of the :ref:`Deis Client <install-client>`,
    10  adding new commands or features.
    11  
    12  If an unknown command is specified, the Client will attempt to execute the command as a
    13  dash-separated command. In this case, ``deis resource:command`` will execute ``deis-resource`` with
    14  the argument list ``command``. In full form:
    15  
    16  .. code-block:: console
    17  
    18      $ # these two are identical
    19      $ deis accounts:list
    20      $ deis-accounts list
    21  
    22  Any flags after the command will also be sent to the plugin as an argument:
    23  
    24  .. code-block:: console
    25  
    26      $ # these two are identical
    27      $ deis accounts:list --debug
    28      $ deis-accounts list --debug
    29  
    30  But flags preceeding the command will not:
    31  
    32  .. code-block:: console
    33  
    34      $ # these two are identical
    35      $ deis --debug accounts:list
    36      $ deis-accounts list