(parameter parser.Parameter)
| 21 | } |
| 22 | |
| 23 | func (f parameterFormatter) description(parameter parser.Parameter) string { |
| 24 | builder := strings.Builder{} |
| 25 | |
| 26 | builder.WriteString(f.humanReadableType(parameter.Type)) |
| 27 | |
| 28 | fields := f.descriptionFields(parameter) |
| 29 | if len(fields) > 0 { |
| 30 | builder.WriteString(" (") |
| 31 | builder.WriteString(f.commaSeparatedValues(fields)) |
| 32 | builder.WriteString(")") |
| 33 | } |
| 34 | |
| 35 | if parameter.Description != "" { |
| 36 | builder.WriteString("\n") |
| 37 | builder.WriteString(parameter.Description) |
| 38 | } |
| 39 | |
| 40 | if len(parameter.AllowedValues) > 0 { |
| 41 | f.writeSeparator(&builder, "\n\n") |
| 42 | builder.WriteString("Allowed values:") |
| 43 | for _, value := range parameter.AllowedValues { |
| 44 | builder.WriteString(fmt.Sprintf("\n- %v", value)) |
| 45 | } |
| 46 | } |
| 47 | |
| 48 | example := f.usageExample(parameter) |
| 49 | if example != "" { |
| 50 | f.writeSeparator(&builder, "\n\n") |
| 51 | builder.WriteString("Example:\n") |
| 52 | builder.WriteString(" " + example) |
| 53 | } |
| 54 | |
| 55 | return builder.String() |
| 56 | } |
| 57 | |
| 58 | func (f parameterFormatter) descriptionFields(parameter parser.Parameter) []interface{} { |
| 59 | fields := []interface{}{} |
no test coverage detected