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
|
cmd2.parsing
===============
Classes for parsing and storing user input.
.. autoclass:: cmd2.parsing.StatementParser
:members:
.. automethod:: __init__
.. autoclass:: cmd2.Statement
:members:
.. attribute:: command
The name of the command after shortcuts and macros have been expanded
.. attribute:: args
The arguments to the command as a string with spaces between the words,
excluding output redirection and command terminators. If the user used
quotes in their input, they remain here, and you will have to handle them
on your own.
.. attribute:: arg_list
The arguments to the command as a list, excluding output
redirection and command terminators. Each argument is represented as an
element in the list. Quoted arguments remain quoted. If you want to
remove the quotes, use :func:`cmd2.utils.strip_quotes` or use
``argv[1:]``
.. attribute:: raw
If you want full access to exactly what the user typed at the input
prompt you can get it, but you'll have to parse it on your own,
including:
- shortcuts and aliases
- quoted commands and arguments
- output redirection
- multi-line command terminator handling
If you use multiline commands, all the input will be passed to you in
this string, but there will be embedded newlines where the user hit
return to continue the command on the next line.
.. attribute:: multiline_command
If the command is a multi-line command, the name of the command will be
in this attribute. Otherwise, it will be an empty string.
.. attribute:: terminator
If the command is a multi-line command, this attribute contains the
termination character entered by the user to signal the end of input
.. attribute:: suffix
Any characters present between the input terminator and the output
redirection tokens.
.. attribute:: pipe_to
If the user piped the output to a shell command, this attribute contains
the entire shell command as a string. Otherwise it is an empty string.
.. attribute:: output
If output was redirected by the user, this contains the redirection
token, i.e. ``>>``.
.. attribute:: output_to
If output was redirected by the user, this contains the requested destination with
quotes preserved.
|
