mirror of
https://salsa.debian.org/freeipa-team/freeipa.git
synced 2025-02-25 18:55:28 -06:00
371: Added examples to parse_param_spec() docstring and changed syntax guide into a reStructuredText table
This commit is contained in:
parent
7bbd81d831
commit
031daabcc4
@ -152,10 +152,25 @@ def parse_param_spec(spec):
|
|||||||
required, and whether the param is multivalue according the following
|
required, and whether the param is multivalue according the following
|
||||||
syntax:
|
syntax:
|
||||||
|
|
||||||
name => required=True, multivalue=False
|
====== ===== ======== ==========
|
||||||
name? => required=False, multivalue=False
|
Spec Name Required Multivalue
|
||||||
name+ => required=True, multivalue=True
|
====== ===== ======== ==========
|
||||||
name* => required=False, multivalue=True
|
'var' 'var' True False
|
||||||
|
'var?' 'var' False False
|
||||||
|
'var*' 'var' False True
|
||||||
|
'var+' 'var' True True
|
||||||
|
====== ===== ======== ==========
|
||||||
|
|
||||||
|
For example,
|
||||||
|
|
||||||
|
>>> parse_param_spec('login')
|
||||||
|
('login', {'required': True, 'multivalue': False})
|
||||||
|
>>> parse_param_spec('gecos?')
|
||||||
|
('gecos', {'required': False, 'multivalue': False})
|
||||||
|
>>> parse_param_spec('telephone_numbers*')
|
||||||
|
('telephone_numbers', {'required': False, 'multivalue': True})
|
||||||
|
>>> parse_param_spec('group+')
|
||||||
|
('group', {'required': True, 'multivalue': True})
|
||||||
|
|
||||||
:param spec: A spec string.
|
:param spec: A spec string.
|
||||||
"""
|
"""
|
||||||
|
Loading…
Reference in New Issue
Block a user