A :simple-python: Python package for building powerful command-line interpreter (CLI) programs. Extends the Python Standard Library's cmd package.

The basic use of cmd2 is identical to that of cmd.

1. Create a subclass of [cmd2.Cmd][]. Define attributes and do_* methods to control its behavior. Throughout this documentation, we will assume that you are naming your subclass App:

from cmd2 import Cmd
class App(Cmd):
   # customized attributes and methods here

2. Instantiate App and start the command loop:

from cmd2 import Cmd
class App(Cmd):
   # customized attributes and methods here

app = App()
app.cmdloop()

See the Getting Started section for info on how to get started building a cmd2 application.

See the Migrating from cmd2 section for info on how to migrate a cmd application to cmd2.

See the Features section for a detailed guide to the features available within cmd2.

See the Examples section for various examples of using cmd2.

See the Mixins section for info on how to extend cmd2 using mixins.

See the Testing section for special considerations when writing unit or integration tests for a cmd2 application.

See the API Reference for detailed information on the public API of cmd2.

See the Documentation Conventions for info on conventions used in this documentation.