collection 교체

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

@@ -1,8 +1,9 @@
 #!/usr/bin/python
 # -*- coding: utf-8 -*-
 
-# Copyright: (c) 2018, Martin Migasiewicz <migasiew.nk@gmail.com>
-# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+# Copyright (c) 2018, Martin Migasiewicz <migasiew.nk@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,11 +12,18 @@ DOCUMENTATION = r'''
 ---
 module: launchd
 author:
-- Martin Migasiewicz (@martinm82)
-short_description:  Manage macOS services
+  - Martin Migasiewicz (@martinm82)
+short_description: Manage macOS services
 version_added: 1.0.0
 description:
-- Manage launchd services on target macOS hosts.
+  - Manage launchd services on target macOS hosts.
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+    check_mode:
+      support: full
+    diff_mode:
+      support: none
 options:
     name:
       description:
@@ -24,14 +32,14 @@ options:
       required: true
     state:
       description:
-      - C(started)/C(stopped) are idempotent actions that will not run
+      - V(started)/V(stopped) are idempotent actions that will not run
         commands unless necessary.
-      - Launchd does not support C(restarted) nor C(reloaded) natively.
+      - Launchd does not support V(restarted) nor V(reloaded) natively.
         These will trigger a stop/start (restarted) or an unload/load
         (reloaded).
-      - C(restarted) unloads and loads the service before start to ensure
+      - V(restarted) unloads and loads the service before start to ensure
         that the latest job definition (plist) is used.
-      - C(reloaded) unloads and loads the service to ensure that the latest
+      - V(reloaded) unloads and loads the service to ensure that the latest
         job definition (plist) is used. Whether a service is started or
         stopped depends on the content of the definition file.
       type: str
@@ -46,9 +54,9 @@ options:
       - Whether the service should not be restarted automatically by launchd.
       - Services might have the 'KeepAlive' attribute set to true in a launchd configuration.
         In case this is set to true, stopping a service will cause that launchd starts the service again.
-      - Set this option to C(yes) to let this module change the 'KeepAlive' attribute to false.
+      - Set this option to V(true) to let this module change the 'KeepAlive' attribute to V(false).
       type: bool
-      default: no
+      default: false
 notes:
 - A user must privileged to manage services using this module.
 requirements:
@@ -81,7 +89,7 @@ EXAMPLES = r'''
   community.general.launchd:
     name: org.memcached
     state: stopped
-    force_stop: yes
+    force_stop: true
 
 - name: Restart memcached
   community.general.launchd: