pulumi-github 6.11.0a1768542226__py3-none-any.whl → 6.12.0__py3-none-any.whl

pulumi_github/pulumi-plugin.json

@@ -1,5 +1,5 @@
 {
   "resource": true,
   "name": "github",
-  "version": "6.11.0-alpha.1768542226"
+  "version": "6.12.0"
 }

pulumi_github/repository.py

@@ -22,6 +22,7 @@ __all__ = ['RepositoryArgs', 'Repository']
 class RepositoryArgs:
     def __init__(__self__, *,
                  allow_auto_merge: Optional[pulumi.Input[_builtins.bool]] = None,
+                 allow_forking: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_merge_commit: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_rebase_merge: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_squash_merge: Optional[pulumi.Input[_builtins.bool]] = None,
@@ -62,6 +63,7 @@ class RepositoryArgs:
         """
         The set of arguments for constructing a Repository resource.
         :param pulumi.Input[_builtins.bool] allow_auto_merge: Set to `true` to allow auto-merging pull requests on the repository.
+        :param pulumi.Input[_builtins.bool] allow_forking: Configure private forking for organization owned private and internal repositories; set to `true` to enable, `false` to disable, and leave unset for the default behaviour. Configuring this requires that private forking is not being explicitly configured at the organization level.
         :param pulumi.Input[_builtins.bool] allow_merge_commit: Set to `false` to disable merge commits on the repository.
         :param pulumi.Input[_builtins.bool] allow_rebase_merge: Set to `false` to disable rebase merges on the repository.
         :param pulumi.Input[_builtins.bool] allow_squash_merge: Set to `false` to disable squash merges on the repository.
@@ -77,14 +79,14 @@ class RepositoryArgs:
         :param pulumi.Input[_builtins.str] fork: Set to `true` to create a fork of an existing repository. When set to `true`, both `source_owner` and `source_repo` must also be specified.
         :param pulumi.Input[_builtins.str] gitignore_template: Use the [name of the template](https://github.com/github/gitignore) without the extension. For example, "Haskell".
         :param pulumi.Input[_builtins.bool] has_discussions: Set to `true` to enable GitHub Discussions on the repository. Defaults to `false`.
-        :param pulumi.Input[_builtins.bool] has_downloads: Set to `true` to enable the (deprecated) downloads features on the repository.
+        :param pulumi.Input[_builtins.bool] has_downloads: (Optional) Set to `true` to enable the (deprecated) downloads features on the repository. This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See [this discussion](https://github.com/orgs/community/discussions/102145#discussioncomment-8351756).
         :param pulumi.Input[_builtins.bool] has_issues: Set to `true` to enable the GitHub Issues features
                on the repository.
         :param pulumi.Input[_builtins.bool] has_projects: Set to `true` to enable the GitHub Projects features on the repository. Per the GitHub [documentation](https://developer.github.com/v3/repos/#create) when in an organization that has disabled repository projects it will default to `false` and will otherwise default to `true`. If you specify `true` when it has been disabled it will return an error.
         :param pulumi.Input[_builtins.bool] has_wiki: Set to `true` to enable the GitHub Wiki features on
                the repository.
         :param pulumi.Input[_builtins.str] homepage_url: URL of a page describing the project.
-        :param pulumi.Input[_builtins.bool] ignore_vulnerability_alerts_during_read: Set to `true` to not call the vulnerability alerts endpoint so the resource can also be used without admin permissions during read.
+        :param pulumi.Input[_builtins.bool] ignore_vulnerability_alerts_during_read: (Optional) - This is ignored as the provider now handles lack of permissions automatically.
         :param pulumi.Input[_builtins.bool] is_template: Set to `true` to tell GitHub that this is a template repository.
         :param pulumi.Input[_builtins.str] license_template: Use the [name of the template](https://github.com/github/choosealicense.com/tree/gh-pages/_licenses) without the extension. For example, "mit" or "mpl-2.0".
         :param pulumi.Input[_builtins.str] merge_commit_message: Can be `PR_BODY`, `PR_TITLE`, or `BLANK` for a default merge commit message. Applicable only if `allow_merge_commit` is `true`.
@@ -101,11 +103,13 @@ class RepositoryArgs:
         :param pulumi.Input['RepositoryTemplateArgs'] template: Use a template repository to create this resource. See Template Repositories below for details.
         :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] topics: The list of topics of the repository.
         :param pulumi.Input[_builtins.str] visibility: Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be `internal`. The `visibility` parameter overrides the `private` parameter.
-        :param pulumi.Input[_builtins.bool] vulnerability_alerts: Set to `true` to enable security alerts for vulnerable dependencies. Enabling requires alerts to be enabled on the owner level. (Note for importing: GitHub enables the alerts on public repos but disables them on private repos by default.) See [GitHub Documentation](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for details. Note that vulnerability alerts have not been successfully tested on any GitHub Enterprise instance and may be unavailable in those settings.
+        :param pulumi.Input[_builtins.bool] vulnerability_alerts: Configure [Dependabot security alerts](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for vulnerable dependencies; set to `true` to enable, set to `false` to disable, and leave unset for the default behavior. Configuring this requires that alerts are not being explicitly configured at the organization level.
         :param pulumi.Input[_builtins.bool] web_commit_signoff_required: Require contributors to sign off on web-based commits. See more [here](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-commit-signoff-policy-for-your-repository). Defaults to `false`.
         """
         if allow_auto_merge is not None:
             pulumi.set(__self__, "allow_auto_merge", allow_auto_merge)
+        if allow_forking is not None:
+            pulumi.set(__self__, "allow_forking", allow_forking)
         if allow_merge_commit is not None:
             pulumi.set(__self__, "allow_merge_commit", allow_merge_commit)
         if allow_rebase_merge is not None:
@@ -137,6 +141,9 @@ class RepositoryArgs:
             pulumi.set(__self__, "gitignore_template", gitignore_template)
         if has_discussions is not None:
             pulumi.set(__self__, "has_discussions", has_discussions)
+        if has_downloads is not None:
+            warnings.warn("""This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See https://github.com/orgs/community/discussions/102145#discussioncomment-8351756""", DeprecationWarning)
+            pulumi.log.warn("""has_downloads is deprecated: This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See https://github.com/orgs/community/discussions/102145#discussioncomment-8351756""")
         if has_downloads is not None:
             pulumi.set(__self__, "has_downloads", has_downloads)
         if has_issues is not None:
@@ -147,6 +154,9 @@ class RepositoryArgs:
             pulumi.set(__self__, "has_wiki", has_wiki)
         if homepage_url is not None:
             pulumi.set(__self__, "homepage_url", homepage_url)
+        if ignore_vulnerability_alerts_during_read is not None:
+            warnings.warn("""This is ignored as the provider now handles lack of permissions automatically.""", DeprecationWarning)
+            pulumi.log.warn("""ignore_vulnerability_alerts_during_read is deprecated: This is ignored as the provider now handles lack of permissions automatically.""")
         if ignore_vulnerability_alerts_during_read is not None:
             pulumi.set(__self__, "ignore_vulnerability_alerts_during_read", ignore_vulnerability_alerts_during_read)
         if is_template is not None:
@@ -199,6 +209,18 @@ class RepositoryArgs:
     def allow_auto_merge(self, value: Optional[pulumi.Input[_builtins.bool]]):
         pulumi.set(self, "allow_auto_merge", value)
 
+    @_builtins.property
+    @pulumi.getter(name="allowForking")
+    def allow_forking(self) -> Optional[pulumi.Input[_builtins.bool]]:
+        """
+        Configure private forking for organization owned private and internal repositories; set to `true` to enable, `false` to disable, and leave unset for the default behaviour. Configuring this requires that private forking is not being explicitly configured at the organization level.
+        """
+        return pulumi.get(self, "allow_forking")
+
+    @allow_forking.setter
+    def allow_forking(self, value: Optional[pulumi.Input[_builtins.bool]]):
+        pulumi.set(self, "allow_forking", value)
+
     @_builtins.property
     @pulumi.getter(name="allowMergeCommit")
     def allow_merge_commit(self) -> Optional[pulumi.Input[_builtins.bool]]:
@@ -369,9 +391,10 @@ class RepositoryArgs:
 
     @_builtins.property
     @pulumi.getter(name="hasDownloads")
+    @_utilities.deprecated("""This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See https://github.com/orgs/community/discussions/102145#discussioncomment-8351756""")
     def has_downloads(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
-        Set to `true` to enable the (deprecated) downloads features on the repository.
+        (Optional) Set to `true` to enable the (deprecated) downloads features on the repository. This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See [this discussion](https://github.com/orgs/community/discussions/102145#discussioncomment-8351756).
         """
         return pulumi.get(self, "has_downloads")
 
@@ -431,9 +454,10 @@ class RepositoryArgs:
 
     @_builtins.property
     @pulumi.getter(name="ignoreVulnerabilityAlertsDuringRead")
+    @_utilities.deprecated("""This is ignored as the provider now handles lack of permissions automatically.""")
     def ignore_vulnerability_alerts_during_read(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
-        Set to `true` to not call the vulnerability alerts endpoint so the resource can also be used without admin permissions during read.
+        (Optional) - This is ignored as the provider now handles lack of permissions automatically.
         """
         return pulumi.get(self, "ignore_vulnerability_alerts_during_read")
 
@@ -627,7 +651,7 @@ class RepositoryArgs:
     @pulumi.getter(name="vulnerabilityAlerts")
     def vulnerability_alerts(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
-        Set to `true` to enable security alerts for vulnerable dependencies. Enabling requires alerts to be enabled on the owner level. (Note for importing: GitHub enables the alerts on public repos but disables them on private repos by default.) See [GitHub Documentation](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for details. Note that vulnerability alerts have not been successfully tested on any GitHub Enterprise instance and may be unavailable in those settings.
+        Configure [Dependabot security alerts](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for vulnerable dependencies; set to `true` to enable, set to `false` to disable, and leave unset for the default behavior. Configuring this requires that alerts are not being explicitly configured at the organization level.
         """
         return pulumi.get(self, "vulnerability_alerts")
 
@@ -652,6 +676,7 @@ class RepositoryArgs:
 class _RepositoryState:
     def __init__(__self__, *,
                  allow_auto_merge: Optional[pulumi.Input[_builtins.bool]] = None,
+                 allow_forking: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_merge_commit: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_rebase_merge: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_squash_merge: Optional[pulumi.Input[_builtins.bool]] = None,
@@ -701,6 +726,7 @@ class _RepositoryState:
         """
         Input properties used for looking up and filtering Repository resources.
         :param pulumi.Input[_builtins.bool] allow_auto_merge: Set to `true` to allow auto-merging pull requests on the repository.
+        :param pulumi.Input[_builtins.bool] allow_forking: Configure private forking for organization owned private and internal repositories; set to `true` to enable, `false` to disable, and leave unset for the default behaviour. Configuring this requires that private forking is not being explicitly configured at the organization level.
         :param pulumi.Input[_builtins.bool] allow_merge_commit: Set to `false` to disable merge commits on the repository.
         :param pulumi.Input[_builtins.bool] allow_rebase_merge: Set to `false` to disable rebase merges on the repository.
         :param pulumi.Input[_builtins.bool] allow_squash_merge: Set to `false` to disable squash merges on the repository.
@@ -718,7 +744,7 @@ class _RepositoryState:
         :param pulumi.Input[_builtins.str] git_clone_url: URL that can be provided to `git clone` to clone the repository anonymously via the git protocol.
         :param pulumi.Input[_builtins.str] gitignore_template: Use the [name of the template](https://github.com/github/gitignore) without the extension. For example, "Haskell".
         :param pulumi.Input[_builtins.bool] has_discussions: Set to `true` to enable GitHub Discussions on the repository. Defaults to `false`.
-        :param pulumi.Input[_builtins.bool] has_downloads: Set to `true` to enable the (deprecated) downloads features on the repository.
+        :param pulumi.Input[_builtins.bool] has_downloads: (Optional) Set to `true` to enable the (deprecated) downloads features on the repository. This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See [this discussion](https://github.com/orgs/community/discussions/102145#discussioncomment-8351756).
         :param pulumi.Input[_builtins.bool] has_issues: Set to `true` to enable the GitHub Issues features
                on the repository.
         :param pulumi.Input[_builtins.bool] has_projects: Set to `true` to enable the GitHub Projects features on the repository. Per the GitHub [documentation](https://developer.github.com/v3/repos/#create) when in an organization that has disabled repository projects it will default to `false` and will otherwise default to `true`. If you specify `true` when it has been disabled it will return an error.
@@ -727,7 +753,7 @@ class _RepositoryState:
         :param pulumi.Input[_builtins.str] homepage_url: URL of a page describing the project.
         :param pulumi.Input[_builtins.str] html_url: The absolute URL (including scheme) of the rendered GitHub Pages site e.g. `https://username.github.io`.
         :param pulumi.Input[_builtins.str] http_clone_url: URL that can be provided to `git clone` to clone the repository via HTTPS.
-        :param pulumi.Input[_builtins.bool] ignore_vulnerability_alerts_during_read: Set to `true` to not call the vulnerability alerts endpoint so the resource can also be used without admin permissions during read.
+        :param pulumi.Input[_builtins.bool] ignore_vulnerability_alerts_during_read: (Optional) - This is ignored as the provider now handles lack of permissions automatically.
         :param pulumi.Input[_builtins.bool] is_template: Set to `true` to tell GitHub that this is a template repository.
         :param pulumi.Input[_builtins.str] license_template: Use the [name of the template](https://github.com/github/choosealicense.com/tree/gh-pages/_licenses) without the extension. For example, "mit" or "mpl-2.0".
         :param pulumi.Input[_builtins.str] merge_commit_message: Can be `PR_BODY`, `PR_TITLE`, or `BLANK` for a default merge commit message. Applicable only if `allow_merge_commit` is `true`.
@@ -749,11 +775,13 @@ class _RepositoryState:
         :param pulumi.Input['RepositoryTemplateArgs'] template: Use a template repository to create this resource. See Template Repositories below for details.
         :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] topics: The list of topics of the repository.
         :param pulumi.Input[_builtins.str] visibility: Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be `internal`. The `visibility` parameter overrides the `private` parameter.
-        :param pulumi.Input[_builtins.bool] vulnerability_alerts: Set to `true` to enable security alerts for vulnerable dependencies. Enabling requires alerts to be enabled on the owner level. (Note for importing: GitHub enables the alerts on public repos but disables them on private repos by default.) See [GitHub Documentation](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for details. Note that vulnerability alerts have not been successfully tested on any GitHub Enterprise instance and may be unavailable in those settings.
+        :param pulumi.Input[_builtins.bool] vulnerability_alerts: Configure [Dependabot security alerts](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for vulnerable dependencies; set to `true` to enable, set to `false` to disable, and leave unset for the default behavior. Configuring this requires that alerts are not being explicitly configured at the organization level.
         :param pulumi.Input[_builtins.bool] web_commit_signoff_required: Require contributors to sign off on web-based commits. See more [here](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-commit-signoff-policy-for-your-repository). Defaults to `false`.
         """
         if allow_auto_merge is not None:
             pulumi.set(__self__, "allow_auto_merge", allow_auto_merge)
+        if allow_forking is not None:
+            pulumi.set(__self__, "allow_forking", allow_forking)
         if allow_merge_commit is not None:
             pulumi.set(__self__, "allow_merge_commit", allow_merge_commit)
         if allow_rebase_merge is not None:
@@ -789,6 +817,9 @@ class _RepositoryState:
             pulumi.set(__self__, "gitignore_template", gitignore_template)
         if has_discussions is not None:
             pulumi.set(__self__, "has_discussions", has_discussions)
+        if has_downloads is not None:
+            warnings.warn("""This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See https://github.com/orgs/community/discussions/102145#discussioncomment-8351756""", DeprecationWarning)
+            pulumi.log.warn("""has_downloads is deprecated: This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See https://github.com/orgs/community/discussions/102145#discussioncomment-8351756""")
         if has_downloads is not None:
             pulumi.set(__self__, "has_downloads", has_downloads)
         if has_issues is not None:
@@ -803,6 +834,9 @@ class _RepositoryState:
             pulumi.set(__self__, "html_url", html_url)
         if http_clone_url is not None:
             pulumi.set(__self__, "http_clone_url", http_clone_url)
+        if ignore_vulnerability_alerts_during_read is not None:
+            warnings.warn("""This is ignored as the provider now handles lack of permissions automatically.""", DeprecationWarning)
+            pulumi.log.warn("""ignore_vulnerability_alerts_during_read is deprecated: This is ignored as the provider now handles lack of permissions automatically.""")
         if ignore_vulnerability_alerts_during_read is not None:
             pulumi.set(__self__, "ignore_vulnerability_alerts_during_read", ignore_vulnerability_alerts_during_read)
         if is_template is not None:
@@ -865,6 +899,18 @@ class _RepositoryState:
     def allow_auto_merge(self, value: Optional[pulumi.Input[_builtins.bool]]):
         pulumi.set(self, "allow_auto_merge", value)
 
+    @_builtins.property
+    @pulumi.getter(name="allowForking")
+    def allow_forking(self) -> Optional[pulumi.Input[_builtins.bool]]:
+        """
+        Configure private forking for organization owned private and internal repositories; set to `true` to enable, `false` to disable, and leave unset for the default behaviour. Configuring this requires that private forking is not being explicitly configured at the organization level.
+        """
+        return pulumi.get(self, "allow_forking")
+
+    @allow_forking.setter
+    def allow_forking(self, value: Optional[pulumi.Input[_builtins.bool]]):
+        pulumi.set(self, "allow_forking", value)
+
     @_builtins.property
     @pulumi.getter(name="allowMergeCommit")
     def allow_merge_commit(self) -> Optional[pulumi.Input[_builtins.bool]]:
@@ -1059,9 +1105,10 @@ class _RepositoryState:
 
     @_builtins.property
     @pulumi.getter(name="hasDownloads")
+    @_utilities.deprecated("""This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See https://github.com/orgs/community/discussions/102145#discussioncomment-8351756""")
     def has_downloads(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
-        Set to `true` to enable the (deprecated) downloads features on the repository.
+        (Optional) Set to `true` to enable the (deprecated) downloads features on the repository. This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See [this discussion](https://github.com/orgs/community/discussions/102145#discussioncomment-8351756).
         """
         return pulumi.get(self, "has_downloads")
 
@@ -1145,9 +1192,10 @@ class _RepositoryState:
 
     @_builtins.property
     @pulumi.getter(name="ignoreVulnerabilityAlertsDuringRead")
+    @_utilities.deprecated("""This is ignored as the provider now handles lack of permissions automatically.""")
     def ignore_vulnerability_alerts_during_read(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
-        Set to `true` to not call the vulnerability alerts endpoint so the resource can also be used without admin permissions during read.
+        (Optional) - This is ignored as the provider now handles lack of permissions automatically.
         """
         return pulumi.get(self, "ignore_vulnerability_alerts_during_read")
 
@@ -1401,7 +1449,7 @@ class _RepositoryState:
     @pulumi.getter(name="vulnerabilityAlerts")
     def vulnerability_alerts(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
-        Set to `true` to enable security alerts for vulnerable dependencies. Enabling requires alerts to be enabled on the owner level. (Note for importing: GitHub enables the alerts on public repos but disables them on private repos by default.) See [GitHub Documentation](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for details. Note that vulnerability alerts have not been successfully tested on any GitHub Enterprise instance and may be unavailable in those settings.
+        Configure [Dependabot security alerts](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for vulnerable dependencies; set to `true` to enable, set to `false` to disable, and leave unset for the default behavior. Configuring this requires that alerts are not being explicitly configured at the organization level.
         """
         return pulumi.get(self, "vulnerability_alerts")
 
@@ -1429,6 +1477,7 @@ class Repository(pulumi.CustomResource):
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
                  allow_auto_merge: Optional[pulumi.Input[_builtins.bool]] = None,
+                 allow_forking: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_merge_commit: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_rebase_merge: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_squash_merge: Optional[pulumi.Input[_builtins.bool]] = None,
@@ -1527,12 +1576,13 @@ class Repository(pulumi.CustomResource):
         Repositories can be imported using the `name`, e.g.
 
         ```sh
-        $ pulumi import github:index/repository:Repository terraform terraform
+        $ pulumi import github:index/repository:Repository terraform myrepo
         ```
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[_builtins.bool] allow_auto_merge: Set to `true` to allow auto-merging pull requests on the repository.
+        :param pulumi.Input[_builtins.bool] allow_forking: Configure private forking for organization owned private and internal repositories; set to `true` to enable, `false` to disable, and leave unset for the default behaviour. Configuring this requires that private forking is not being explicitly configured at the organization level.
         :param pulumi.Input[_builtins.bool] allow_merge_commit: Set to `false` to disable merge commits on the repository.
         :param pulumi.Input[_builtins.bool] allow_rebase_merge: Set to `false` to disable rebase merges on the repository.
         :param pulumi.Input[_builtins.bool] allow_squash_merge: Set to `false` to disable squash merges on the repository.
@@ -1548,14 +1598,14 @@ class Repository(pulumi.CustomResource):
         :param pulumi.Input[_builtins.str] fork: Set to `true` to create a fork of an existing repository. When set to `true`, both `source_owner` and `source_repo` must also be specified.
         :param pulumi.Input[_builtins.str] gitignore_template: Use the [name of the template](https://github.com/github/gitignore) without the extension. For example, "Haskell".
         :param pulumi.Input[_builtins.bool] has_discussions: Set to `true` to enable GitHub Discussions on the repository. Defaults to `false`.
-        :param pulumi.Input[_builtins.bool] has_downloads: Set to `true` to enable the (deprecated) downloads features on the repository.
+        :param pulumi.Input[_builtins.bool] has_downloads: (Optional) Set to `true` to enable the (deprecated) downloads features on the repository. This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See [this discussion](https://github.com/orgs/community/discussions/102145#discussioncomment-8351756).
         :param pulumi.Input[_builtins.bool] has_issues: Set to `true` to enable the GitHub Issues features
                on the repository.
         :param pulumi.Input[_builtins.bool] has_projects: Set to `true` to enable the GitHub Projects features on the repository. Per the GitHub [documentation](https://developer.github.com/v3/repos/#create) when in an organization that has disabled repository projects it will default to `false` and will otherwise default to `true`. If you specify `true` when it has been disabled it will return an error.
         :param pulumi.Input[_builtins.bool] has_wiki: Set to `true` to enable the GitHub Wiki features on
                the repository.
         :param pulumi.Input[_builtins.str] homepage_url: URL of a page describing the project.
-        :param pulumi.Input[_builtins.bool] ignore_vulnerability_alerts_during_read: Set to `true` to not call the vulnerability alerts endpoint so the resource can also be used without admin permissions during read.
+        :param pulumi.Input[_builtins.bool] ignore_vulnerability_alerts_during_read: (Optional) - This is ignored as the provider now handles lack of permissions automatically.
         :param pulumi.Input[_builtins.bool] is_template: Set to `true` to tell GitHub that this is a template repository.
         :param pulumi.Input[_builtins.str] license_template: Use the [name of the template](https://github.com/github/choosealicense.com/tree/gh-pages/_licenses) without the extension. For example, "mit" or "mpl-2.0".
         :param pulumi.Input[_builtins.str] merge_commit_message: Can be `PR_BODY`, `PR_TITLE`, or `BLANK` for a default merge commit message. Applicable only if `allow_merge_commit` is `true`.
@@ -1572,7 +1622,7 @@ class Repository(pulumi.CustomResource):
         :param pulumi.Input[Union['RepositoryTemplateArgs', 'RepositoryTemplateArgsDict']] template: Use a template repository to create this resource. See Template Repositories below for details.
         :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] topics: The list of topics of the repository.
         :param pulumi.Input[_builtins.str] visibility: Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be `internal`. The `visibility` parameter overrides the `private` parameter.
-        :param pulumi.Input[_builtins.bool] vulnerability_alerts: Set to `true` to enable security alerts for vulnerable dependencies. Enabling requires alerts to be enabled on the owner level. (Note for importing: GitHub enables the alerts on public repos but disables them on private repos by default.) See [GitHub Documentation](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for details. Note that vulnerability alerts have not been successfully tested on any GitHub Enterprise instance and may be unavailable in those settings.
+        :param pulumi.Input[_builtins.bool] vulnerability_alerts: Configure [Dependabot security alerts](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for vulnerable dependencies; set to `true` to enable, set to `false` to disable, and leave unset for the default behavior. Configuring this requires that alerts are not being explicitly configured at the organization level.
         :param pulumi.Input[_builtins.bool] web_commit_signoff_required: Require contributors to sign off on web-based commits. See more [here](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-commit-signoff-policy-for-your-repository). Defaults to `false`.
         """
         ...
@@ -1641,7 +1691,7 @@ class Repository(pulumi.CustomResource):
         Repositories can be imported using the `name`, e.g.
 
         ```sh
-        $ pulumi import github:index/repository:Repository terraform terraform
+        $ pulumi import github:index/repository:Repository terraform myrepo
         ```
 
         :param str resource_name: The name of the resource.
@@ -1660,6 +1710,7 @@ class Repository(pulumi.CustomResource):
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
                  allow_auto_merge: Optional[pulumi.Input[_builtins.bool]] = None,
+                 allow_forking: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_merge_commit: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_rebase_merge: Optional[pulumi.Input[_builtins.bool]] = None,
                  allow_squash_merge: Optional[pulumi.Input[_builtins.bool]] = None,
@@ -1707,6 +1758,7 @@ class Repository(pulumi.CustomResource):
             __props__ = RepositoryArgs.__new__(RepositoryArgs)
 
             __props__.__dict__["allow_auto_merge"] = allow_auto_merge
+            __props__.__dict__["allow_forking"] = allow_forking
             __props__.__dict__["allow_merge_commit"] = allow_merge_commit
             __props__.__dict__["allow_rebase_merge"] = allow_rebase_merge
             __props__.__dict__["allow_squash_merge"] = allow_squash_merge
@@ -1764,6 +1816,7 @@ class Repository(pulumi.CustomResource):
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
             allow_auto_merge: Optional[pulumi.Input[_builtins.bool]] = None,
+            allow_forking: Optional[pulumi.Input[_builtins.bool]] = None,
             allow_merge_commit: Optional[pulumi.Input[_builtins.bool]] = None,
             allow_rebase_merge: Optional[pulumi.Input[_builtins.bool]] = None,
             allow_squash_merge: Optional[pulumi.Input[_builtins.bool]] = None,
@@ -1818,6 +1871,7 @@ class Repository(pulumi.CustomResource):
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[_builtins.bool] allow_auto_merge: Set to `true` to allow auto-merging pull requests on the repository.
+        :param pulumi.Input[_builtins.bool] allow_forking: Configure private forking for organization owned private and internal repositories; set to `true` to enable, `false` to disable, and leave unset for the default behaviour. Configuring this requires that private forking is not being explicitly configured at the organization level.
         :param pulumi.Input[_builtins.bool] allow_merge_commit: Set to `false` to disable merge commits on the repository.
         :param pulumi.Input[_builtins.bool] allow_rebase_merge: Set to `false` to disable rebase merges on the repository.
         :param pulumi.Input[_builtins.bool] allow_squash_merge: Set to `false` to disable squash merges on the repository.
@@ -1835,7 +1889,7 @@ class Repository(pulumi.CustomResource):
         :param pulumi.Input[_builtins.str] git_clone_url: URL that can be provided to `git clone` to clone the repository anonymously via the git protocol.
         :param pulumi.Input[_builtins.str] gitignore_template: Use the [name of the template](https://github.com/github/gitignore) without the extension. For example, "Haskell".
         :param pulumi.Input[_builtins.bool] has_discussions: Set to `true` to enable GitHub Discussions on the repository. Defaults to `false`.
-        :param pulumi.Input[_builtins.bool] has_downloads: Set to `true` to enable the (deprecated) downloads features on the repository.
+        :param pulumi.Input[_builtins.bool] has_downloads: (Optional) Set to `true` to enable the (deprecated) downloads features on the repository. This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See [this discussion](https://github.com/orgs/community/discussions/102145#discussioncomment-8351756).
         :param pulumi.Input[_builtins.bool] has_issues: Set to `true` to enable the GitHub Issues features
                on the repository.
         :param pulumi.Input[_builtins.bool] has_projects: Set to `true` to enable the GitHub Projects features on the repository. Per the GitHub [documentation](https://developer.github.com/v3/repos/#create) when in an organization that has disabled repository projects it will default to `false` and will otherwise default to `true`. If you specify `true` when it has been disabled it will return an error.
@@ -1844,7 +1898,7 @@ class Repository(pulumi.CustomResource):
         :param pulumi.Input[_builtins.str] homepage_url: URL of a page describing the project.
         :param pulumi.Input[_builtins.str] html_url: The absolute URL (including scheme) of the rendered GitHub Pages site e.g. `https://username.github.io`.
         :param pulumi.Input[_builtins.str] http_clone_url: URL that can be provided to `git clone` to clone the repository via HTTPS.
-        :param pulumi.Input[_builtins.bool] ignore_vulnerability_alerts_during_read: Set to `true` to not call the vulnerability alerts endpoint so the resource can also be used without admin permissions during read.
+        :param pulumi.Input[_builtins.bool] ignore_vulnerability_alerts_during_read: (Optional) - This is ignored as the provider now handles lack of permissions automatically.
         :param pulumi.Input[_builtins.bool] is_template: Set to `true` to tell GitHub that this is a template repository.
         :param pulumi.Input[_builtins.str] license_template: Use the [name of the template](https://github.com/github/choosealicense.com/tree/gh-pages/_licenses) without the extension. For example, "mit" or "mpl-2.0".
         :param pulumi.Input[_builtins.str] merge_commit_message: Can be `PR_BODY`, `PR_TITLE`, or `BLANK` for a default merge commit message. Applicable only if `allow_merge_commit` is `true`.
@@ -1866,7 +1920,7 @@ class Repository(pulumi.CustomResource):
         :param pulumi.Input[Union['RepositoryTemplateArgs', 'RepositoryTemplateArgsDict']] template: Use a template repository to create this resource. See Template Repositories below for details.
         :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] topics: The list of topics of the repository.
         :param pulumi.Input[_builtins.str] visibility: Can be `public` or `private`. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be `internal`. The `visibility` parameter overrides the `private` parameter.
-        :param pulumi.Input[_builtins.bool] vulnerability_alerts: Set to `true` to enable security alerts for vulnerable dependencies. Enabling requires alerts to be enabled on the owner level. (Note for importing: GitHub enables the alerts on public repos but disables them on private repos by default.) See [GitHub Documentation](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for details. Note that vulnerability alerts have not been successfully tested on any GitHub Enterprise instance and may be unavailable in those settings.
+        :param pulumi.Input[_builtins.bool] vulnerability_alerts: Configure [Dependabot security alerts](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for vulnerable dependencies; set to `true` to enable, set to `false` to disable, and leave unset for the default behavior. Configuring this requires that alerts are not being explicitly configured at the organization level.
         :param pulumi.Input[_builtins.bool] web_commit_signoff_required: Require contributors to sign off on web-based commits. See more [here](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-commit-signoff-policy-for-your-repository). Defaults to `false`.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -1874,6 +1928,7 @@ class Repository(pulumi.CustomResource):
         __props__ = _RepositoryState.__new__(_RepositoryState)
 
         __props__.__dict__["allow_auto_merge"] = allow_auto_merge
+        __props__.__dict__["allow_forking"] = allow_forking
         __props__.__dict__["allow_merge_commit"] = allow_merge_commit
         __props__.__dict__["allow_rebase_merge"] = allow_rebase_merge
         __props__.__dict__["allow_squash_merge"] = allow_squash_merge
@@ -1930,6 +1985,14 @@ class Repository(pulumi.CustomResource):
         """
         return pulumi.get(self, "allow_auto_merge")
 
+    @_builtins.property
+    @pulumi.getter(name="allowForking")
+    def allow_forking(self) -> pulumi.Output[_builtins.bool]:
+        """
+        Configure private forking for organization owned private and internal repositories; set to `true` to enable, `false` to disable, and leave unset for the default behaviour. Configuring this requires that private forking is not being explicitly configured at the organization level.
+        """
+        return pulumi.get(self, "allow_forking")
+
     @_builtins.property
     @pulumi.getter(name="allowMergeCommit")
     def allow_merge_commit(self) -> pulumi.Output[Optional[_builtins.bool]]:
@@ -2060,9 +2123,10 @@ class Repository(pulumi.CustomResource):
 
     @_builtins.property
     @pulumi.getter(name="hasDownloads")
+    @_utilities.deprecated("""This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See https://github.com/orgs/community/discussions/102145#discussioncomment-8351756""")
     def has_downloads(self) -> pulumi.Output[Optional[_builtins.bool]]:
         """
-        Set to `true` to enable the (deprecated) downloads features on the repository.
+        (Optional) Set to `true` to enable the (deprecated) downloads features on the repository. This attribute is no longer in use, but it hasn't been removed yet. It will be removed in a future version. See [this discussion](https://github.com/orgs/community/discussions/102145#discussioncomment-8351756).
         """
         return pulumi.get(self, "has_downloads")
 
@@ -2118,9 +2182,10 @@ class Repository(pulumi.CustomResource):
 
     @_builtins.property
     @pulumi.getter(name="ignoreVulnerabilityAlertsDuringRead")
+    @_utilities.deprecated("""This is ignored as the provider now handles lack of permissions automatically.""")
     def ignore_vulnerability_alerts_during_read(self) -> pulumi.Output[Optional[_builtins.bool]]:
         """
-        Set to `true` to not call the vulnerability alerts endpoint so the resource can also be used without admin permissions during read.
+        (Optional) - This is ignored as the provider now handles lack of permissions automatically.
         """
         return pulumi.get(self, "ignore_vulnerability_alerts_during_read")
 
@@ -2290,7 +2355,7 @@ class Repository(pulumi.CustomResource):
     @pulumi.getter(name="vulnerabilityAlerts")
     def vulnerability_alerts(self) -> pulumi.Output[_builtins.bool]:
         """
-        Set to `true` to enable security alerts for vulnerable dependencies. Enabling requires alerts to be enabled on the owner level. (Note for importing: GitHub enables the alerts on public repos but disables them on private repos by default.) See [GitHub Documentation](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for details. Note that vulnerability alerts have not been successfully tested on any GitHub Enterprise instance and may be unavailable in those settings.
+        Configure [Dependabot security alerts](https://help.github.com/en/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies) for vulnerable dependencies; set to `true` to enable, set to `false` to disable, and leave unset for the default behavior. Configuring this requires that alerts are not being explicitly configured at the organization level.
         """
         return pulumi.get(self, "vulnerability_alerts")
 

pulumi_github/repository_custom_property.py

@@ -190,7 +190,7 @@ class RepositoryCustomProperty(pulumi.CustomResource):
 
         ## Import
 
-        GitHub Repository Custom Property can be imported using an ID made up of a comibnation of the names of the organization, repository, custom property separated by a `:` character, e.g.
+        GitHub Repository Custom Property can be imported using an ID made up of a combination of the names of the organization, repository, custom property separated by a `:` character, e.g.
 
         ```sh
         $ pulumi import github:index/repositoryCustomProperty:RepositoryCustomProperty example organization-name:repo-name:custom-property-name
@@ -232,7 +232,7 @@ class RepositoryCustomProperty(pulumi.CustomResource):
 
         ## Import
 
-        GitHub Repository Custom Property can be imported using an ID made up of a comibnation of the names of the organization, repository, custom property separated by a `:` character, e.g.
+        GitHub Repository Custom Property can be imported using an ID made up of a combination of the names of the organization, repository, custom property separated by a `:` character, e.g.
 
         ```sh
         $ pulumi import github:index/repositoryCustomProperty:RepositoryCustomProperty example organization-name:repo-name:custom-property-name

pulumi_github/repository_environment.py

@@ -32,7 +32,7 @@ class RepositoryEnvironmentArgs:
         The set of arguments for constructing a RepositoryEnvironment resource.
         :param pulumi.Input[_builtins.str] environment: The name of the environment.
         :param pulumi.Input[_builtins.str] repository: The repository of the environment.
-        :param pulumi.Input[_builtins.bool] can_admins_bypass: Can repository admins bypass the environment protections.  Defaults to `true`.
+        :param pulumi.Input[_builtins.bool] can_admins_bypass: Can repository admins bypass the environment protections. Defaults to `true`.
         :param pulumi.Input['RepositoryEnvironmentDeploymentBranchPolicyArgs'] deployment_branch_policy: The deployment branch policy configuration
         :param pulumi.Input[_builtins.bool] prevent_self_review: Whether or not a user who created the job is prevented from approving their own job. Defaults to `false`.
         :param pulumi.Input[Sequence[pulumi.Input['RepositoryEnvironmentReviewerArgs']]] reviewers: The environment reviewers configuration.
@@ -79,7 +79,7 @@ class RepositoryEnvironmentArgs:
     @pulumi.getter(name="canAdminsBypass")
     def can_admins_bypass(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
-        Can repository admins bypass the environment protections.  Defaults to `true`.
+        Can repository admins bypass the environment protections. Defaults to `true`.
         """
         return pulumi.get(self, "can_admins_bypass")
 
@@ -148,7 +148,7 @@ class _RepositoryEnvironmentState:
                  wait_timer: Optional[pulumi.Input[_builtins.int]] = None):
         """
         Input properties used for looking up and filtering RepositoryEnvironment resources.
-        :param pulumi.Input[_builtins.bool] can_admins_bypass: Can repository admins bypass the environment protections.  Defaults to `true`.
+        :param pulumi.Input[_builtins.bool] can_admins_bypass: Can repository admins bypass the environment protections. Defaults to `true`.
         :param pulumi.Input['RepositoryEnvironmentDeploymentBranchPolicyArgs'] deployment_branch_policy: The deployment branch policy configuration
         :param pulumi.Input[_builtins.str] environment: The name of the environment.
         :param pulumi.Input[_builtins.bool] prevent_self_review: Whether or not a user who created the job is prevented from approving their own job. Defaults to `false`.
@@ -175,7 +175,7 @@ class _RepositoryEnvironmentState:
     @pulumi.getter(name="canAdminsBypass")
     def can_admins_bypass(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
-        Can repository admins bypass the environment protections.  Defaults to `true`.
+        Can repository admins bypass the environment protections. Defaults to `true`.
         """
         return pulumi.get(self, "can_admins_bypass")
 
@@ -298,15 +298,15 @@ class RepositoryEnvironment(pulumi.CustomResource):
 
         ## Import
 
-        GitHub Repository Environment can be imported using an ID made up of `name` of the repository combined with the `environment` name of the environment, separated by a `:` character, e.g.
+        This resource can be imported using an ID made of the repository name, and environment name (any `:` in the name need to be escaped as `??`) separated by a `:`.
 
         ```sh
-        $ pulumi import github:index/repositoryEnvironment:RepositoryEnvironment daily terraform:daily
+        $ pulumi import github:index/repositoryEnvironment:RepositoryEnvironment example myrepo:myenv
         ```
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[_builtins.bool] can_admins_bypass: Can repository admins bypass the environment protections.  Defaults to `true`.
+        :param pulumi.Input[_builtins.bool] can_admins_bypass: Can repository admins bypass the environment protections. Defaults to `true`.
         :param pulumi.Input[Union['RepositoryEnvironmentDeploymentBranchPolicyArgs', 'RepositoryEnvironmentDeploymentBranchPolicyArgsDict']] deployment_branch_policy: The deployment branch policy configuration
         :param pulumi.Input[_builtins.str] environment: The name of the environment.
         :param pulumi.Input[_builtins.bool] prevent_self_review: Whether or not a user who created the job is prevented from approving their own job. Defaults to `false`.
@@ -348,10 +348,10 @@ class RepositoryEnvironment(pulumi.CustomResource):
 
         ## Import
 
-        GitHub Repository Environment can be imported using an ID made up of `name` of the repository combined with the `environment` name of the environment, separated by a `:` character, e.g.
+        This resource can be imported using an ID made of the repository name, and environment name (any `:` in the name need to be escaped as `??`) separated by a `:`.
 
         ```sh
-        $ pulumi import github:index/repositoryEnvironment:RepositoryEnvironment daily terraform:daily
+        $ pulumi import github:index/repositoryEnvironment:RepositoryEnvironment example myrepo:myenv
         ```
 
         :param str resource_name: The name of the resource.
@@ -420,7 +420,7 @@ class RepositoryEnvironment(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[_builtins.bool] can_admins_bypass: Can repository admins bypass the environment protections.  Defaults to `true`.
+        :param pulumi.Input[_builtins.bool] can_admins_bypass: Can repository admins bypass the environment protections. Defaults to `true`.
         :param pulumi.Input[Union['RepositoryEnvironmentDeploymentBranchPolicyArgs', 'RepositoryEnvironmentDeploymentBranchPolicyArgsDict']] deployment_branch_policy: The deployment branch policy configuration
         :param pulumi.Input[_builtins.str] environment: The name of the environment.
         :param pulumi.Input[_builtins.bool] prevent_self_review: Whether or not a user who created the job is prevented from approving their own job. Defaults to `false`.
@@ -445,7 +445,7 @@ class RepositoryEnvironment(pulumi.CustomResource):
     @pulumi.getter(name="canAdminsBypass")
     def can_admins_bypass(self) -> pulumi.Output[Optional[_builtins.bool]]:
         """
-        Can repository admins bypass the environment protections.  Defaults to `true`.
+        Can repository admins bypass the environment protections. Defaults to `true`.
         """
         return pulumi.get(self, "can_admins_bypass")
 

pulumi_github/repository_environment_deployment_policy.py

@@ -226,10 +226,10 @@ class RepositoryEnvironmentDeploymentPolicy(pulumi.CustomResource):
 
         ## Import
 
-        GitHub Repository Environment Deployment Policy can be imported using an ID made up of `name` of the repository combined with the `environment` name of the environment with the `Id` of the deployment policy, separated by a `:` character, e.g.
+        This resource can be imported using an ID made of the repository name, environment name (any `:` in the name need to be escaped as `??`), and deployment policy ID all separated by a `:`.
 
         ```sh
-        $ pulumi import github:index/repositoryEnvironmentDeploymentPolicy:RepositoryEnvironmentDeploymentPolicy daily terraform:daily:123456
+        $ pulumi import github:index/repositoryEnvironmentDeploymentPolicy:RepositoryEnvironmentDeploymentPolicy example myrepo:myenv:123456
         ```
 
         :param str resource_name: The name of the resource.
@@ -302,10 +302,10 @@ class RepositoryEnvironmentDeploymentPolicy(pulumi.CustomResource):
 
         ## Import
 
-        GitHub Repository Environment Deployment Policy can be imported using an ID made up of `name` of the repository combined with the `environment` name of the environment with the `Id` of the deployment policy, separated by a `:` character, e.g.
+        This resource can be imported using an ID made of the repository name, environment name (any `:` in the name need to be escaped as `??`), and deployment policy ID all separated by a `:`.
 
         ```sh
-        $ pulumi import github:index/repositoryEnvironmentDeploymentPolicy:RepositoryEnvironmentDeploymentPolicy daily terraform:daily:123456
+        $ pulumi import github:index/repositoryEnvironmentDeploymentPolicy:RepositoryEnvironmentDeploymentPolicy example myrepo:myenv:123456
         ```
 
         :param str resource_name: The name of the resource.