collection 교체

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

@@ -1,8 +1,9 @@
 #!/usr/bin/python
 # -*- coding: utf-8 -*-
 #
-# Copyright: Ansible Team
-# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+# Copyright Ansible Team
+# 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,10 +15,17 @@ module: github_release
 short_description: Interact with GitHub Releases
 description:
     - Fetch metadata about GitHub Releases
+extends_documentation_fragment:
+    - community.general.attributes
+attributes:
+    check_mode:
+        support: full
+    diff_mode:
+        support: none
 options:
     token:
         description:
-            - GitHub Personal Access Token for authenticating. Mutually exclusive with C(password).
+            - GitHub Personal Access Token for authenticating. Mutually exclusive with O(password).
         type: str
     user:
         description:
@@ -26,7 +34,7 @@ options:
         required: true
     password:
         description:
-            - The GitHub account password for the user. Mutually exclusive with C(token).
+            - The GitHub account password for the user. Mutually exclusive with O(token).
         type: str
     repo:
         description:
@@ -41,7 +49,7 @@ options:
         choices: [ 'latest_release', 'create_release' ]
     tag:
         description:
-            - Tag name when creating a release. Required when using action is set to C(create_release).
+            - Tag name when creating a release. Required when using O(action=create_release).
         type: str
     target:
         description:
@@ -58,13 +66,13 @@ options:
     draft:
         description:
             - Sets if the release is a draft or not. (boolean)
-        type: 'bool'
-        default: 'no'
+        type: bool
+        default: false
     prerelease:
         description:
             - Sets if the release is a prerelease or not. (boolean)
         type: bool
-        default: 'no'
+        default: false
 
 author:
     - "Adrian Moisey (@adrianmoisey)"
@@ -86,7 +94,7 @@ EXAMPLES = '''
     repo: testrepo
     action: latest_release
 
-- name: Get latest release of test repo using username and password. Ansible 2.4.
+- name: Get latest release of test repo using username and password
   community.general.github_release:
     user: testuser
     password: secret123
@@ -107,17 +115,8 @@ EXAMPLES = '''
 '''
 
 RETURN = '''
-create_release:
-    description:
-    - Version of the created release
-    - "For Ansible version 2.5 and later, if specified release version already exists, then State is unchanged"
-    - "For Ansible versions prior to 2.5, if specified release version already exists, then State is skipped"
-    type: str
-    returned: success
-    sample: 1.1.0
-
-latest_release:
-    description: Version of the latest release
+tag:
+    description: Version of the created/latest release.
     type: str
     returned: success
     sample: 1.1.0