Skip to content

Commit

Permalink
Doc Attributes (ansible-collections#555)
Browse files Browse the repository at this point in the history
* Added Attributes section

* Added Attributes section
  • Loading branch information
elpavel authored and laurent-indermuehle committed Oct 3, 2023
1 parent 8df844b commit fca60f8
Show file tree
Hide file tree
Showing 8 changed files with 28 additions and 9 deletions.
3 changes: 3 additions & 0 deletions plugins/doc_fragments/mysql.py
Original file line number Diff line number Diff line change
Expand Up @@ -110,4 +110,7 @@ class ModuleDocFragment(object):
- Alternatively, to avoid using I(login_unix_socket) argument on each invocation you can specify the socket path
using the `socket` option in your MySQL config file (usually C(~/.my.cnf)) on the destination host, for
example C(socket=/var/lib/mysql/mysql.sock).
attributes:
check_mode:
description: Can run in check_mode and return changed status prediction without modifying target.
'''
5 changes: 3 additions & 2 deletions plugins/modules/mysql_db.py
Original file line number Diff line number Diff line change
Expand Up @@ -188,13 +188,14 @@
- mysql (command line binary)
- mysqldump (command line binary)
notes:
- Supports C(check_mode).
- Requires the mysql and mysqldump binaries on the remote host.
- This module is B(not idempotent) when I(state) is C(import),
and will import the dump file each time if run more than once.
attributes:
check_mode:
support: full
extends_documentation_fragment:
- community.mysql.mysql
'''

EXAMPLES = r'''
Expand Down
5 changes: 4 additions & 1 deletion plugins/modules/mysql_info.py
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,10 @@
notes:
- Calculating the size of a database might be slow, depending on the number and size of tables in it.
To avoid this, use I(exclude_fields=db_size).
- Supports C(check_mode).
attributes:
check_mode:
support: full
seealso:
- module: community.mysql.mysql_variables
Expand Down
3 changes: 3 additions & 0 deletions plugins/modules/mysql_query.py
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,9 @@
- Where passed queries run in a single transaction (C(yes)) or commit them one-by-one (C(no)).
type: bool
default: false
attributes:
check_mode:
support: none
seealso:
- module: community.mysql.mysql_db
author:
Expand Down
5 changes: 4 additions & 1 deletion plugins/modules/mysql_replication.py
Original file line number Diff line number Diff line change
Expand Up @@ -190,10 +190,13 @@
notes:
- If an empty value for the parameter of string type is needed, use an empty string.
attributes:
check_mode:
support: none
extends_documentation_fragment:
- community.mysql.mysql
seealso:
- module: community.mysql.mysql_info
- name: MySQL replication reference
Expand Down
5 changes: 4 additions & 1 deletion plugins/modules/mysql_role.py
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,10 @@
- Pay attention that the module runs C(SET DEFAULT ROLE ALL TO)
all the I(members) passed by default when the state has changed.
If you want to avoid this behavior, set I(set_default_role_all) to C(no).
- Supports C(check_mode).
attributes:
check_mode:
support: full
seealso:
- module: community.mysql.mysql_user
Expand Down
6 changes: 4 additions & 2 deletions plugins/modules/mysql_user.py
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,10 @@
2) drop a C(~/.my.cnf) file containing the new root credentials.
Subsequent runs of the playbook will then succeed by reading the new credentials from the file."
- Currently, there is only support for the C(mysql_native_password) encrypted password hash module.
- Supports (check_mode).
attributes:
check_mode:
support: full
seealso:
- module: community.mysql.mysql_info
Expand All @@ -180,7 +183,6 @@
- Lukasz Tomaszkiewicz (@tomaszkiewicz)
extends_documentation_fragment:
- community.mysql.mysql
'''

EXAMPLES = r'''
Expand Down
5 changes: 3 additions & 2 deletions plugins/modules/mysql_variables.py
Original file line number Diff line number Diff line change
Expand Up @@ -44,8 +44,9 @@
default: global
version_added: '0.1.0'
notes:
- Does not support C(check_mode).
attributes:
check_mode:
support: none
seealso:
- module: community.mysql.mysql_info
Expand Down

0 comments on commit fca60f8

Please sign in to comment.