doc(macdefaults): Add ..versionadded::

This commit is contained in:
Carlos Álvaro 2024-07-03 10:15:07 +01:00 committed by Daniel Wozniak
parent 83225aca7d
commit 18ca4fdfa9
2 changed files with 15 additions and 0 deletions

View file

@ -74,6 +74,8 @@ def write(
The separator to use when splitting the key into a list of keys.
If None, the key will not be split (Default).
.. versionadded:: 3008.0
value
The value to write to the given key.
Dates should be in the format 'YYYY-MM-DDTHH:MM:SSZ'
@ -108,11 +110,15 @@ def write(
If current value is not a dictionary this option will be ignored.
This option will be set to True if vtype is dict-add.
.. versionadded:: 3008.0
array_add
Append the value to the array.
If current value is not a list this option will be ignored.
This option will be set to True if vtype is array-add.
.. versionadded:: 3008.0
Raises:
KeyError: When the key is not found in the domain
IndexError: When the key is not a valid array index
@ -195,6 +201,8 @@ def read(domain, key, user=None, key_separator=None):
The separator to use when splitting the key into a list of keys.
If None, the key will not be split (Default).
.. versionadded:: 3008.0
user
The user to read the defaults from
@ -236,6 +244,8 @@ def delete(domain, key, user=None, key_separator=None):
The separator to use when splitting the key into a list of keys.
If None, the key will not be split (Default).
.. versionadded:: 3008.0
user
The user to delete the defaults with
@ -303,6 +313,7 @@ def cast_value_to_vtype(value, vtype):
Returns:
The converted value
.. versionadded:: 3008.0
"""
# Boolean
if vtype in ("bool", "boolean"):

View file

@ -30,6 +30,8 @@ def write(name, domain, value, vtype=None, name_separator=None, user=None):
The separator to use when splitting the name into a list of keys.
If None, the name will not be split (Default).
.. versionadded:: 3008.0
domain
The name of the domain to write to
@ -91,6 +93,8 @@ def absent(name, domain, user=None, name_separator=None):
The separator to use when splitting the name into a list of keys.
If None, the name will not be split (Default).
.. versionadded:: 3008.0
domain
The name of the domain to remove from