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
98
99
100
101
|
package metacmd
import (
"fmt"
"io"
"strings"
)
// Desc holds information about a command or alias description.
type Desc struct {
Name string
Params string
Desc string
}
// Section is a meta command section.
type Section string
// Meta command section types.
const (
SectionGeneral Section = "General"
SectionQueryExecute Section = "Query Execute"
SectionQueryBuffer Section = "Query Buffer"
SectionHelp Section = "Help"
SectionTransaction Section = "Transaction"
SectionInputOutput Section = "Input/Output"
SectionInformational Section = "Informational"
SectionFormatting Section = "Formatting"
SectionConnection Section = "Connection"
SectionOperatingSystem Section = "Operating System"
SectionVariables Section = "Variables"
// SectionLargeObjects Section = "Large Objects"
)
// String satisfies stringer.
func (s Section) String() string {
return string(s)
}
// SectionOrder is the order of sections to display via Listing.
var SectionOrder = []Section{
SectionGeneral,
SectionQueryExecute,
SectionQueryBuffer,
SectionHelp,
SectionInputOutput,
SectionInformational,
SectionFormatting,
SectionTransaction,
SectionConnection,
SectionOperatingSystem,
SectionVariables,
}
// Listing writes the formatted command listing to w, separated into different
// sections for all known commands.
func Listing(w io.Writer) {
sectionDescs := make(map[Section][][]string, len(SectionOrder))
var plen int
for _, section := range SectionOrder {
var descs [][]string
for _, c := range sectMap[section] {
cmd := cmds[c]
for i, d := range cmd.Descs {
if d.Desc == "" && d.Params == "" {
continue
}
s, opts := optText(cmd.Descs[i])
descs, plen = add(descs, ` \`+strings.TrimSpace(d.Name)+opts, s, plen)
}
}
sectionDescs[section] = descs
}
for i, section := range SectionOrder {
if i != 0 {
fmt.Fprintln(w)
}
fmt.Fprintln(w, section)
for _, line := range sectionDescs[section] {
fmt.Fprintln(w, rpad(line[0], plen), "", line[1])
}
}
}
// rpad right pads a string.
func rpad(s string, l int) string {
return s + strings.Repeat(" ", l-len(s))
}
// add adds b, c to a, returning the max of pad or len(b).
func add(a [][]string, b, c string, pad int) ([][]string, int) {
return append(a, []string{b, c}), max(pad, len(b))
}
// optText returns a string and the opt text.
func optText(desc Desc) (string, string) {
if desc.Params != "" {
return desc.Desc, " " + desc.Params
}
return desc.Desc, desc.Params
}
|
