x/python-rsdclient
Code Issues Proposed changes

Fix python-openstackclient plugin doc build

Browse Source 
Some plugin command option help strings contained invalid-to-sphinx
bullet lists, causing building autoprogram-cliff from
python-openstackclient to break with errors like:

<ComposeNode>:1:Unexpected indentation.

This commit reformats the help strings to use the right newlines and
indents so they build properly.

Change-Id: Ia3fd6d5ec76e0e6d6aee87d8a8790a1ed2d38a26
This commit is contained in:
Eric Fried
2019-10-22 14:56:59 -05:00
parent 5e05430720
commit d5935fdae6
1 changed files with 96 additions and 94 deletions
Download Patch File Download Diff File Expand all files Collapse all files

88
rsdclient/osc/v2/node.py
View File

@@ -52,25 +52,26 @@ class ComposeNode(command.Command):
metavar='<processor requirements>',
help=('Array of requirements for processor for composed node. Each'
' processor requirement may contain one or more optional '
'attributes:\n'
'attributes:\n\n'
'- Model: Type String, Processor model that should be used '
' for composed node (exact model name)\n\n'
' - TotalCores: Type Int, Minimum number of processor cores'
'for composed node (exact model name)\n'
'- TotalCores: Type Int, Minimum number of processor '
'cores\n'
'- AchievableSpeedMHz: Type Int, Minimum achievable '
'processor operating frequency.\n\n'
'processor operating frequency.\n'
'- InstructionSet: Type String, Processor supported '
'instruction set, such as "x86", "x86-64", "IA-64", '
'"ARM-A32", "ARM-A64", "MIPS32", "MIPS64", "OEM"\n\n'
'"ARM-A32", "ARM-A64", "MIPS32", "MIPS64", "OEM"\n'
'- Resource: Object Reference to a particular processor '
'that should be used in composed node\n\n'
'that should be used in composed node\n'
'- Chassis: Object Link to chassis object within this '
'processor should be contained.\n\n'
'processor should be contained.\n'
'- Brand: Type String, Brand of CPU that should be used to '
' allocate node.'
'allocate node.\n'
'- Capabilities: Array of strings describing processor '
'capabilities (like reported in /proc/cpuinfo flags), such '
'as "sse", "avx", etc.\n\n'
'For example:\n'
'For example::\n\n'
' [{\n'
' "Model": "Multi-Core Intel(R) Xeon(R) processor 7xxx '
'Series",\n'
@@ -93,21 +94,21 @@ class ComposeNode(command.Command):
metavar='<memory requirements>',
help=('Array of requirements for memory for composed node. Each '
'memory requirement may contain one or more optional '
'attributes:\n'
'attributes:\n\n'
'- CapacityMiB: Type Int, Minimum memory capacity '
'requested for composed node\n\n'
'requested for composed node\n'
'- MemoryDeviceType: Type String, Type details of DIMM, '
'such as "DDR3", "DDR4"\n\n'
' - SpeedMHz: Type Int, Minimum supported memory speed\n\n'
'such as "DDR3", "DDR4"\n'
'- SpeedMHz: Type Int, Minimum supported memory speed\n'
'- Manufacturer: Type String, Requested memory '
'manufacturer\n\n'
'manufacturer\n'
'- DataWidthBits: Type Int, Requested memory data width in '
' bits\n\n'
'bits\n'
'- Resource: Object Reference to a particular memory '
'module that should be used in composed node\n\n'
'module that should be used in composed node\n'
'- Chassis: Object Link to chassis object within this '
'memory DIMM should be contained\n\n'
'For example:\n'
'For example::\n\n'
' [{\n'
' "CapacityMiB": 16000,\n'
' "MemoryDeviceType": "DDR3",\n'
@@ -129,20 +130,21 @@ class ComposeNode(command.Command):
metavar='<remote drives requirements>',
help=('Array of requirements for remote drives that should be '
'created/connected to composed node. Each remote drives '
'requirement may contain one or more optional attributes:\n'
'requirement may contain one or more optional '
'attributes:\n\n'
'- CapacityGiB: Positive value expected, required if '
'Master Drive supplied. Should be at least the size of '
'Logical Drive used as Master Drive\n\n'
'Logical Drive used as Master Drive\n'
'- Protocol: Defines protocol used to communicate with '
'attached drive. Currently supported: "iSCSI" '
'"NVMeOverFabrics"\n\n'
'"NVMeOverFabrics"\n'
'- Master -> Type: One of allowed enumerated values ('
'"Snapshot" "Clone"). Required if Master Drive supplied\n\n'
'"Snapshot" "Clone"). Required if Master Drive supplied\n'
'- Master -> Resource: URI of Master volume that should be '
' used for clone or snapshot operation\n\n'
'used for clone or snapshot operation\n'
'- Resource: Object Reference to particular local drive '
'that should be used in composed node\n\n'
'For example:\n\n'
'For example::\n\n'
' # Using existing NVMe over Fabrics Remote Drive\n'
' [{\n'
' "Protocol": "NVMeOverFabrics",\n'
@@ -170,24 +172,24 @@ class ComposeNode(command.Command):
metavar='<local drives requirements>',
help=('Array of requirements for local drives for composed node. '
'Each local drives requirement may contain one or more '
'optional attributes:\n'
'optional attributes:\n\n'
'- CapacityGiB: Type Int, Minimum drive capacity requested '
' for composed node\n\n'
' - Type: Type String, Drive type: "HDD", "SSD"\n\n'
'for composed node\n'
'- Type: Type String, Drive type: "HDD", "SSD"\n'
'- MinRPM: Type Int, Minimum rotation speed of requested '
'drive\n\n'
'drive\n'
'- SerialNumber: Type String, Serial number of requested '
'drive\n\n'
'drive\n'
'- Interface: Type String, Interface of requested drive: '
'"SAS", "SATA", "NVMe"\n\n'
'"SAS", "SATA", "NVMe"\n'
'- Resource: Object Reference to particular local drive '
'that should be used in composed node\n\n'
'that should be used in composed node\n'
'- Chassis: Object Link to chassis object within this '
'drive should be contained\n\n'
'drive should be contained\n'
'- FabricSwitch: Type Boolean, Determine if local drive '
'should be connected using fabric switch or local '
'connected\n\n'
'For example:\n'
'For example::\n\n'
' [{\n'
' "CapacityGiB": 500,\n'
' "Type": "HDD",\n'
@@ -206,21 +208,21 @@ class ComposeNode(command.Command):
metavar='<ethernet requirements>',
help=('Array of requirements for Ethernet interfaces of composed '
'node. Each Ethernet interface requirement may contain one '
'or more optional attributes:\n'
'or more optional attributes:\n\n'
'- SpeedMbps: Type Int, Minimum speed of Ethernet '
'interface requested for composed node\n\n'
'interface requested for composed node\n'
'- VLANs: Type Array, Array of VLANs that should be '
'configured on connected switch port for composed node for '
'given Ethernet interface in the following format: VLANId - '
'number indicating VLAN Id, Tagged - Boolean value '
'describing if given VLAN is tagged\n\n'
'describing if given VLAN is tagged\n'
'- PrimaryVLAN: Type Int, Primary VLAN ID that should be '
'set for a given Ethernet Interface\n\n'
'set for a given Ethernet Interface\n'
'- Resource: Object Reference to a particular Ethernet '
'interface that should be used in composed node\n\n'
'interface that should be used in composed node\n'
'- Chassis: Object Link to chassis object within this '
'network interface should be contained\n\n'
'For example:\n'
'For example::\n\n'
' [{\n'
' "SpeedMbps": 1000,\n'
' "PrimaryVLAN": 100,\n'
@@ -239,17 +241,17 @@ class ComposeNode(command.Command):
type=json.loads,
metavar='<security requirements>',
help=('The security requirements of composed node. It may contain '
'one or more optional attributes:\n'
'one or more optional attributes:\n\n'
'- TpmPresent: determine if Composed Node should be '
'equipped with TPM module\n\n'
'equipped with TPM module\n'
'- TpmInterfaceType: overrides TpmPresent parameter (if '
'specified TPM module expected). System must be equipped '
'with only defined TPM interface type.\n\n'
'with only defined TPM interface type.\n'
'- TxtEnabled: determine if Composed Node should have '
'Trusted Execution Technology (TXT) mode enabled.\n\n'
'Trusted Execution Technology (TXT) mode enabled.\n'
'- ClearTPMOnDelete: used to specify if TPM module should '
'be cleared on composed node DELETE request.\n\n'
'For example:\n'
'For example::\n\n'
' {\n'
' "TpmPresent": True,\n'
' "TpmInterfaceType": "TPM2_0",\n'