collection 교체

collection/community/general/plugins/modules/zfs_facts.py

@@ -1,8 +1,9 @@
 #!/usr/bin/python
 # -*- coding: utf-8 -*-
 
-# (c) 2016, Adam Števko <adam.stevko@gmail.com>
-# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+# Copyright (c) 2016, Adam Števko <adam.stevko@gmail.com>
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
 
 from __future__ import absolute_import, division, print_function
 __metaclass__ = type
@@ -11,15 +12,19 @@ __metaclass__ = type
 DOCUMENTATION = '''
 ---
 module: zfs_facts
-short_description: Gather facts about ZFS datasets.
+short_description: Gather facts about ZFS datasets
 description:
   - Gather facts from ZFS dataset properties.
 author: Adam Števko (@xen0l)
+extends_documentation_fragment:
+  - community.general.attributes
+  - community.general.attributes.facts
+  - community.general.attributes.facts_module
 options:
     name:
         description:
             - ZFS dataset name.
-        required: yes
+        required: true
         aliases: [ "ds", "dataset" ]
         type: str
     recurse:
@@ -27,13 +32,13 @@ options:
             - Specifies if properties for any children should be recursively
               displayed.
         type: bool
-        default: 'no'
+        default: false
     parsable:
         description:
             - Specifies if property values should be displayed in machine
               friendly format.
         type: bool
-        default: 'no'
+        default: false
     properties:
         description:
             - Specifies which dataset properties should be queried in comma-separated format.
@@ -51,6 +56,7 @@ options:
         description:
             - Specifies recursion depth.
         type: int
+        default: 0
 '''
 
 EXAMPLES = '''
@@ -61,7 +67,7 @@ EXAMPLES = '''
 - name: Report space usage on ZFS filesystems under data/home
   community.general.zfs_facts:
     name: data/home
-    recurse: yes
+    recurse: true
     type: filesystem
 
 - ansible.builtin.debug:
@@ -79,12 +85,12 @@ parsable:
     description: if parsable output should be provided in machine friendly format.
     returned: if 'parsable' is set to True
     type: bool
-    sample: True
+    sample: true
 recurse:
     description: if we should recurse over ZFS dataset
     returned: if 'recurse' is set to True
     type: bool
-    sample: True
+    sample: true
 zfs_datasets:
     description: ZFS dataset facts
     returned: always