1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
# cmd2 Examples
The [examples](https://github.com/python-cmd2/cmd2/tree/main/examples) directory within the `cmd2`
repository contains a number of simple self-contained examples which each demonstrate a few
particular features of `cmd2`. None of them are representative of a full real-world complex `cmd2`
application, if you are looking for that then see
[Projects using cmd2](https://github.com/python-cmd2/cmd2?tab=readme-ov-file#projects-using-cmd2).
## List of cmd2 examples
Here is the list of examples in alphabetical order by filename along with a brief description of
each:
- [argparse_completion.py](https://github.com/python-cmd2/cmd2/blob/main/examples/argparse_completion.py)
- Shows how to integrate tab-completion with argparse-based commands
- [argparse_example.py](https://github.com/python-cmd2/cmd2/blob/main/examples/argparse_example.py)
- Comprehensive example demonstrating various aspects of using
[argparse](https://docs.python.org/3/library/argparse.html) for command argument processing
via the `cmd2.with_argparser` decorator
- [async_call.py](https://github.com/python-cmd2/cmd2/blob/main/examples/async_call.py)
- Shows how to make a call to an async function from a cmd2 command.
- [async_printing.py](https://github.com/python-cmd2/cmd2/blob/main/examples/async_printing.py)
- Shows how to asynchronously print alerts, update the prompt in realtime, and change the window
title
- [basic_completion.py](https://github.com/python-cmd2/cmd2/blob/main/examples/basic_completion.py)
- Show how to enable custom tab completion by assigning a completer function to `do_*` commands
- [cmd2_as_argument.py](https://github.com/python-cmd2/cmd2/blob/main/examples/cmd_as_argument.py)
- Demonstrates how to accept and parse command-line arguments when invoking a cmd2 application
- [color.py](https://github.com/python-cmd2/cmd2/blob/main/examples/color.py)
- Show the numerous colors available to use in your cmd2 applications
- [command_sets.py](https://github.com/python-cmd2/cmd2/blob/main/examples/command_sets.py)
- Example that demonstrates the `CommandSet` features for modularizing commands and demonstrates
all main capabilities including basic CommandSets, dynamic loading an unloading, using
subcommands, etc.
- [custom_parser.py](https://github.com/python-cmd2/cmd2/blob/main/examples/custom_parser.py)
- Demonstrates how to create your own custom `Cmd2ArgumentParser`
- [custom_types.py](https://github.com/python-cmd2/cmd2/blob/main/examples/custom_types.py)
- Some useful custom argument types
- [default_categories.py](https://github.com/python-cmd2/cmd2/blob/main/examples/default_categories.py)
- Demonstrates usage of `@with_default_category` decorator to group and categorize commands and
`CommandSet` use
- [dynamic_commands.py](https://github.com/python-cmd2/cmd2/blob/main/examples/dynamic_commands.py)
- Shows how `do_*` commands can be dynamically created programatically at runtime
- [environment.py](https://github.com/python-cmd2/cmd2/blob/main/examples/environment.py)
- Shows how to create custom `cmd2.Settable` parameters which serve as internal environment
variables
- [event_loops.py](https://github.com/python-cmd2/cmd2/blob/main/examples/event_loops.py)
- Shows how to integrate a `cmd2` application with an external event loop which isn't managed by
`cmd2`
- [exit_code.py](https://github.com/python-cmd2/cmd2/blob/main/examples/exit_code.py)
- Show how to emit a non-zero exit code from your `cmd2` application when it exits
- [getting_started.py](https://github.com/python-cmd2/cmd2/blob/main/examples/getting_started.py)
- Short application that demonstrates many key features of cmd2
- [hello_cmd2.py](https://github.com/python-cmd2/cmd2/blob/main/examples/hello_cmd2.py)
- Completely bare-bones `cmd2` application suitable for rapid testing and debugging of `cmd2`
itself
- [help_categories.py](https://github.com/python-cmd2/cmd2/blob/main/examples/help_categories.py)
- Demonstrates command categorization and its impact on the output of the built-in `help`
command
- [hooks.py](https://github.com/python-cmd2/cmd2/blob/main/examples/hooks.py)
- Shows how to use various `cmd2` application lifecycle hooks
- [migrating.py](https://github.com/python-cmd2/cmd2/blob/main/examples/migrating.py)
- A simple `cmd` application that you can migrate to `cmd2` by changing one line
- [modular_commands.py](https://github.com/python-cmd2/cmd2/blob/main/examples/modular_commands.py)
- Complex example demonstrating a variety of methods to load `CommandSets` using a mix of
command decorators
- [paged_output.py](https://github.com/python-cmd2/cmd2/blob/main/examples/paged_output.py)
- Shows how to use output pagination within `cmd2` apps via the `ppaged` method
- [persistent_history.py](https://github.com/python-cmd2/cmd2/blob/main/examples/persistent_history.py)
- Shows how to enable persistent history in your `cmd2` application
- [pretty_print.py](https://github.com/python-cmd2/cmd2/blob/main/examples/pretty_print.py)
- Demonstrates use of rich within cmd2 for pretty-printing arbitrary Python data structures like
dictionaries.
- [python_scripting.py](https://github.com/python-cmd2/cmd2/blob/main/examples/python_scripting.py)
- Shows how cmd2's built-in `run_pyscript` command can provide advanced Python scripting of cmd2
applications
- [read_input.py](https://github.com/python-cmd2/cmd2/blob/main/examples/read_input.py)
- Demonstrates the various ways to call `cmd2.Cmd.read_input()` for input history and tab
completion
- [remove_builtin_commands.py](https://github.com/python-cmd2/cmd2/blob/main/examples/remove_builtin_commands.py)
- Shows how to remove any built-in cmd2 commands you do not want to be present in your cmd2
application
- [remove_settable.py](https://github.com/python-cmd2/cmd2/blob/main/examples/remove_settable.py)
- Shows how to remove any of the built-in cmd2 `Settables` you do not want in your cmd2
application
- [rich_tables.py](https://github.com/python-cmd2/cmd2/blob/main/examples/rich_tables.py)
- Example of using Rich Tables within a cmd2 application for displaying tabular data
- [rich_theme.py](https://github.com/python-cmd2/cmd2/blob/main/examples/rich_theme.py)
- Demonstrates how to create a custom theme for a cmd2 application
- [tmux_launch.sh](https://github.com/python-cmd2/cmd2/blob/main/examples/tmux_launch.sh)
- Shell script that launches two applications using tmux in different windows/tabs
- [tmux_split.sh](https://github.com/python-cmd2/cmd2/blob/main/examples/tmux_split.sh)
- Shell script that launches two applications using tmux in a split pane view
- [transcript_example.py](https://github.com/python-cmd2/cmd2/blob/main/examples/transcript_example.py)
- This example is intended to demonstrate `cmd2's` build-in transcript testing capability
- [unicode_commands.py](https://github.com/python-cmd2/cmd2/blob/main/examples/unicode_commands.py)
- Shows that cmd2 supports unicode everywhere, including within command names
|
