2023-11-22 21:40:26 -06:00
|
|
|
|
|
|
|
|
Overview
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
The command line interface is an important part of app automation and
|
|
|
|
|
may be thought of in a couple ways:
|
|
|
|
|
|
|
|
|
|
First there is the :term:`ad hoc script` which is a single file and
|
2023-11-24 15:49:57 -06:00
|
|
|
can be placed anywhere, but is not installed as part of a
|
|
|
|
|
:term:`package`. See :doc:`scripts`.
|
2023-11-22 21:40:26 -06:00
|
|
|
|
|
|
|
|
But the "real" command line interface uses :term:`commands<command>`
|
|
|
|
|
and :term:`subcommands<subcommand>`; these are installed as part of a
|
|
|
|
|
package.
|
|
|
|
|
|
|
|
|
|
Top-level commands are mostly just a way to group subcommands. Most
|
|
|
|
|
custom apps would define their own top-level command as well as
|
|
|
|
|
multiple subcommands. See :doc:`commands` for top-level details.
|
|
|
|
|
|
|
|
|
|
Subcommands on the other hand are the real workhorse since they define
|
|
|
|
|
the action logic. See :doc:`subcommands` for more about those.
|
