collection 교체

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

@@ -1,8 +1,9 @@
 #!/usr/bin/python
 # -*- coding: utf-8 -*-
 
-# Copyright: (c) 2017, Ted Trask <ttrask01@yahoo.com>
-# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+# Copyright (c) 2017, Ted Trask <ttrask01@yahoo.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
@@ -14,9 +15,16 @@ module: awall
 short_description: Manage awall policies
 author: Ted Trask (@tdtrask) <ttrask01@yahoo.com>
 description:
-  - This modules allows for enable/disable/activate of I(awall) policies.
-  - Alpine Wall (I(awall)) generates a firewall configuration from the enabled policy files
+  - This modules allows for enable/disable/activate of C(awall) policies.
+  - Alpine Wall (C(awall)) generates a firewall configuration from the enabled policy files
     and activates the configuration on the system.
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
 options:
   name:
     description:
@@ -33,8 +41,11 @@ options:
     description:
       - Activate the new firewall rules.
       - Can be run with other steps or on its own.
+      - Idempotency is affected if O(activate=true), as the module will always report a changed state.
     type: bool
-    default: no
+    default: false
+notes:
+    - At least one of O(name) and O(activate) is required.
 '''
 
 EXAMPLES = r'''
@@ -49,11 +60,11 @@ EXAMPLES = r'''
     - foo
     - bar
     state: disabled
-    activate: no
+    activate: false
 
 - name: Activate currently enabled firewall rules
   community.general.awall:
-    activate: yes
+    activate: true
 '''
 
 RETURN = ''' # '''