pulumi-azuredevops 3.1.0a1710568843__py3-none-any.whl → 3.6.0a1736832240__py3-none-any.whl

pulumi_azuredevops/_utilities.py

@@ -4,6 +4,7 @@
 
 
 import asyncio
+import functools
 import importlib.metadata
 import importlib.util
 import inspect
@@ -11,14 +12,19 @@ import json
 import os
 import sys
 import typing
+import warnings
+import base64
 
 import pulumi
 import pulumi.runtime
 from pulumi.runtime.sync_await import _sync_await
+from pulumi.runtime.proto import resource_pb2
 
 from semver import VersionInfo as SemverVersion
 from parver import Version as PEP440Version
 
+C = typing.TypeVar("C", bound=typing.Callable)
+
 
 def get_env(*args):
     for v in args:
@@ -96,10 +102,6 @@ def _get_semver_version():
 _version = _get_semver_version()
 _version_str = str(_version)
 
-
-def get_version():
-    return _version_str
-
 def get_resource_opts_defaults() -> pulumi.ResourceOptions:
     return pulumi.ResourceOptions(
         version=get_version(),
@@ -262,7 +264,7 @@ def call_plain(
     output = pulumi.runtime.call(tok, props, res, typ)
 
     # Ingoring deps silently. They are typically non-empty, r.f() calls include r as a dependency.
-    result, known, secret, _ = _sync_await(asyncio.ensure_future(_await_output(output)))
+    result, known, secret, _ = _sync_await(asyncio.create_task(_await_output(output)))
 
     problem = None
     if not known:
@@ -287,5 +289,39 @@ async def _await_output(o: pulumi.Output[typing.Any]) -> typing.Tuple[object, bo
         await o._resources,
     )
 
+
+# This is included to provide an upgrade path for users who are using a version
+# of the Pulumi SDK (<3.121.0) that does not include the `deprecated` decorator.
+def deprecated(message: str) -> typing.Callable[[C], C]:
+    """
+    Decorator to indicate a function is deprecated.
+
+    As well as inserting appropriate statements to indicate that the function is
+    deprecated, this decorator also tags the function with a special attribute
+    so that Pulumi code can detect that it is deprecated and react appropriately
+    in certain situations.
+
+    message is the deprecation message that should be printed if the function is called.
+    """
+
+    def decorator(fn: C) -> C:
+        if not callable(fn):
+            raise TypeError("Expected fn to be callable")
+
+        @functools.wraps(fn)
+        def deprecated_fn(*args, **kwargs):
+            warnings.warn(message)
+            pulumi.warn(f"{fn.__name__} is deprecated: {message}")
+
+            return fn(*args, **kwargs)
+
+        deprecated_fn.__dict__["_pulumi_deprecated_callable"] = fn
+        return typing.cast(C, deprecated_fn)
+
+    return decorator
+
 def get_plugin_download_url():
 	return None
+
+def get_version():
+     return _version_str

pulumi_azuredevops/area_permissions.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = ['AreaPermissionsArgs', 'AreaPermissions']
@@ -255,16 +260,16 @@ class AreaPermissions(pulumi.CustomResource):
 
         ## Example Usage
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_azuredevops as azuredevops
 
         example = azuredevops.Project("example",
+            name="Example Project",
             work_item_template="Agile",
             version_control="Git",
             visibility="private",
-            description="Managed by Terraform")
+            description="Managed by Pulumi")
         example_project_readers = azuredevops.get_group_output(project_id=example.id,
             name="Readers")
         example_root_permissions = azuredevops.AreaPermissions("example-root-permissions",
@@ -278,7 +283,6 @@ class AreaPermissions(pulumi.CustomResource):
                 "WORK_ITEM_READ": "Allow",
             })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Relevant Links
 
@@ -330,16 +334,16 @@ class AreaPermissions(pulumi.CustomResource):
 
         ## Example Usage
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_azuredevops as azuredevops
 
         example = azuredevops.Project("example",
+            name="Example Project",
             work_item_template="Agile",
             version_control="Git",
             visibility="private",
-            description="Managed by Terraform")
+            description="Managed by Pulumi")
         example_project_readers = azuredevops.get_group_output(project_id=example.id,
             name="Readers")
         example_root_permissions = azuredevops.AreaPermissions("example-root-permissions",
@@ -353,7 +357,6 @@ class AreaPermissions(pulumi.CustomResource):
                 "WORK_ITEM_READ": "Allow",
             })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Relevant Links
 

pulumi_azuredevops/branch_policy_auto_reviewers.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 from . import outputs
 from ._inputs import *
@@ -163,44 +168,43 @@ class BranchPolicyAutoReviewers(pulumi.CustomResource):
                  blocking: Optional[pulumi.Input[bool]] = None,
                  enabled: Optional[pulumi.Input[bool]] = None,
                  project_id: Optional[pulumi.Input[str]] = None,
-                 settings: Optional[pulumi.Input[pulumi.InputType['BranchPolicyAutoReviewersSettingsArgs']]] = None,
+                 settings: Optional[pulumi.Input[Union['BranchPolicyAutoReviewersSettingsArgs', 'BranchPolicyAutoReviewersSettingsArgsDict']]] = None,
                  __props__=None):
         """
         Manages required reviewer policy branch policy within Azure DevOps.
 
         ## Example Usage
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_azuredevops as azuredevops
 
-        example_project = azuredevops.Project("exampleProject")
-        example_git = azuredevops.Git("exampleGit",
-            project_id=example_project.id,
-            initialization=azuredevops.GitInitializationArgs(
-                init_type="Clean",
-            ))
-        example_user = azuredevops.User("exampleUser",
+        example = azuredevops.Project("example", name="Example Project")
+        example_git = azuredevops.Git("example",
+            project_id=example.id,
+            name="Example Repository",
+            initialization={
+                "init_type": "Clean",
+            })
+        example_user = azuredevops.User("example",
             principal_name="mail@email.com",
             account_license_type="basic")
-        example_branch_policy_auto_reviewers = azuredevops.BranchPolicyAutoReviewers("exampleBranchPolicyAutoReviewers",
-            project_id=example_project.id,
+        example_branch_policy_auto_reviewers = azuredevops.BranchPolicyAutoReviewers("example",
+            project_id=example.id,
             enabled=True,
             blocking=True,
-            settings=azuredevops.BranchPolicyAutoReviewersSettingsArgs(
-                auto_reviewer_ids=[example_user.id],
-                submitter_can_vote=False,
-                message="Auto reviewer",
-                path_filters=["*/src/*.ts"],
-                scopes=[azuredevops.BranchPolicyAutoReviewersSettingsScopeArgs(
-                    repository_id=example_git.id,
-                    repository_ref=example_git.default_branch,
-                    match_type="Exact",
-                )],
-            ))
+            settings={
+                "auto_reviewer_ids": [example_user.id],
+                "submitter_can_vote": False,
+                "message": "Auto reviewer",
+                "path_filters": ["*/src/*.ts"],
+                "scopes": [{
+                    "repository_id": example_git.id,
+                    "repository_ref": example_git.default_branch,
+                    "match_type": "Exact",
+                }],
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Relevant Links
 
@@ -219,7 +223,7 @@ class BranchPolicyAutoReviewers(pulumi.CustomResource):
         :param pulumi.Input[bool] blocking: A flag indicating if the policy should be blocking. This relates to the Azure DevOps terms "optional" and "required" reviewers. Defaults to `true`.
         :param pulumi.Input[bool] enabled: A flag indicating if the policy should be enabled. Defaults to `true`.
         :param pulumi.Input[str] project_id: The ID of the project in which the policy will be created.
-        :param pulumi.Input[pulumi.InputType['BranchPolicyAutoReviewersSettingsArgs']] settings: Configuration for the policy. This block must be defined exactly once.
+        :param pulumi.Input[Union['BranchPolicyAutoReviewersSettingsArgs', 'BranchPolicyAutoReviewersSettingsArgsDict']] settings: Configuration for the policy. This block must be defined exactly once.
         """
         ...
     @overload
@@ -232,37 +236,36 @@ class BranchPolicyAutoReviewers(pulumi.CustomResource):
 
         ## Example Usage
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_azuredevops as azuredevops
 
-        example_project = azuredevops.Project("exampleProject")
-        example_git = azuredevops.Git("exampleGit",
-            project_id=example_project.id,
-            initialization=azuredevops.GitInitializationArgs(
-                init_type="Clean",
-            ))
-        example_user = azuredevops.User("exampleUser",
+        example = azuredevops.Project("example", name="Example Project")
+        example_git = azuredevops.Git("example",
+            project_id=example.id,
+            name="Example Repository",
+            initialization={
+                "init_type": "Clean",
+            })
+        example_user = azuredevops.User("example",
             principal_name="mail@email.com",
             account_license_type="basic")
-        example_branch_policy_auto_reviewers = azuredevops.BranchPolicyAutoReviewers("exampleBranchPolicyAutoReviewers",
-            project_id=example_project.id,
+        example_branch_policy_auto_reviewers = azuredevops.BranchPolicyAutoReviewers("example",
+            project_id=example.id,
             enabled=True,
             blocking=True,
-            settings=azuredevops.BranchPolicyAutoReviewersSettingsArgs(
-                auto_reviewer_ids=[example_user.id],
-                submitter_can_vote=False,
-                message="Auto reviewer",
-                path_filters=["*/src/*.ts"],
-                scopes=[azuredevops.BranchPolicyAutoReviewersSettingsScopeArgs(
-                    repository_id=example_git.id,
-                    repository_ref=example_git.default_branch,
-                    match_type="Exact",
-                )],
-            ))
+            settings={
+                "auto_reviewer_ids": [example_user.id],
+                "submitter_can_vote": False,
+                "message": "Auto reviewer",
+                "path_filters": ["*/src/*.ts"],
+                "scopes": [{
+                    "repository_id": example_git.id,
+                    "repository_ref": example_git.default_branch,
+                    "match_type": "Exact",
+                }],
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Relevant Links
 
@@ -294,7 +297,7 @@ class BranchPolicyAutoReviewers(pulumi.CustomResource):
                  blocking: Optional[pulumi.Input[bool]] = None,
                  enabled: Optional[pulumi.Input[bool]] = None,
                  project_id: Optional[pulumi.Input[str]] = None,
-                 settings: Optional[pulumi.Input[pulumi.InputType['BranchPolicyAutoReviewersSettingsArgs']]] = None,
+                 settings: Optional[pulumi.Input[Union['BranchPolicyAutoReviewersSettingsArgs', 'BranchPolicyAutoReviewersSettingsArgsDict']]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -325,7 +328,7 @@ class BranchPolicyAutoReviewers(pulumi.CustomResource):
             blocking: Optional[pulumi.Input[bool]] = None,
             enabled: Optional[pulumi.Input[bool]] = None,
             project_id: Optional[pulumi.Input[str]] = None,
-            settings: Optional[pulumi.Input[pulumi.InputType['BranchPolicyAutoReviewersSettingsArgs']]] = None) -> 'BranchPolicyAutoReviewers':
+            settings: Optional[pulumi.Input[Union['BranchPolicyAutoReviewersSettingsArgs', 'BranchPolicyAutoReviewersSettingsArgsDict']]] = None) -> 'BranchPolicyAutoReviewers':
         """
         Get an existing BranchPolicyAutoReviewers resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -336,7 +339,7 @@ class BranchPolicyAutoReviewers(pulumi.CustomResource):
         :param pulumi.Input[bool] blocking: A flag indicating if the policy should be blocking. This relates to the Azure DevOps terms "optional" and "required" reviewers. Defaults to `true`.
         :param pulumi.Input[bool] enabled: A flag indicating if the policy should be enabled. Defaults to `true`.
         :param pulumi.Input[str] project_id: The ID of the project in which the policy will be created.
-        :param pulumi.Input[pulumi.InputType['BranchPolicyAutoReviewersSettingsArgs']] settings: Configuration for the policy. This block must be defined exactly once.
+        :param pulumi.Input[Union['BranchPolicyAutoReviewersSettingsArgs', 'BranchPolicyAutoReviewersSettingsArgsDict']] settings: Configuration for the policy. This block must be defined exactly once.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 

pulumi_azuredevops/branch_policy_build_validation.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 from . import outputs
 from ._inputs import *
@@ -163,62 +168,63 @@ class BranchPolicyBuildValidation(pulumi.CustomResource):
                  blocking: Optional[pulumi.Input[bool]] = None,
                  enabled: Optional[pulumi.Input[bool]] = None,
                  project_id: Optional[pulumi.Input[str]] = None,
-                 settings: Optional[pulumi.Input[pulumi.InputType['BranchPolicyBuildValidationSettingsArgs']]] = None,
+                 settings: Optional[pulumi.Input[Union['BranchPolicyBuildValidationSettingsArgs', 'BranchPolicyBuildValidationSettingsArgsDict']]] = None,
                  __props__=None):
         """
         Manages a build validation branch policy within Azure DevOps.
 
         ## Example Usage
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_azuredevops as azuredevops
 
-        example_project = azuredevops.Project("exampleProject")
-        example_git = azuredevops.Git("exampleGit",
-            project_id=example_project.id,
-            initialization=azuredevops.GitInitializationArgs(
-                init_type="Clean",
-            ))
-        example_build_definition = azuredevops.BuildDefinition("exampleBuildDefinition",
-            project_id=example_project.id,
-            repository=azuredevops.BuildDefinitionRepositoryArgs(
-                repo_type="TfsGit",
-                repo_id=example_git.id,
-                yml_path="azure-pipelines.yml",
-            ))
-        example_branch_policy_build_validation = azuredevops.BranchPolicyBuildValidation("exampleBranchPolicyBuildValidation",
-            project_id=example_project.id,
+        example = azuredevops.Project("example", name="Example Project")
+        example_git = azuredevops.Git("example",
+            project_id=example.id,
+            name="Example Repository",
+            initialization={
+                "init_type": "Clean",
+            })
+        example_build_definition = azuredevops.BuildDefinition("example",
+            project_id=example.id,
+            name="Example Build Definition",
+            repository={
+                "repo_type": "TfsGit",
+                "repo_id": example_git.id,
+                "yml_path": "azure-pipelines.yml",
+            })
+        example_branch_policy_build_validation = azuredevops.BranchPolicyBuildValidation("example",
+            project_id=example.id,
             enabled=True,
             blocking=True,
-            settings=azuredevops.BranchPolicyBuildValidationSettingsArgs(
-                display_name="Example build validation policy",
-                build_definition_id=example_build_definition.id,
-                valid_duration=720,
-                filename_patterns=[
+            settings={
+                "display_name": "Example build validation policy",
+                "build_definition_id": example_build_definition.id,
+                "queue_on_source_update_only": True,
+                "valid_duration": 720,
+                "filename_patterns": [
                     "/WebApp/*",
                     "!/WebApp/Tests/*",
                     "*.cs",
                 ],
-                scopes=[
-                    azuredevops.BranchPolicyBuildValidationSettingsScopeArgs(
-                        repository_id=example_git.id,
-                        repository_ref=example_git.default_branch,
-                        match_type="Exact",
-                    ),
-                    azuredevops.BranchPolicyBuildValidationSettingsScopeArgs(
-                        repository_id=example_git.id,
-                        repository_ref="refs/heads/releases",
-                        match_type="Prefix",
-                    ),
-                    azuredevops.BranchPolicyBuildValidationSettingsScopeArgs(
-                        match_type="DefaultBranch",
-                    ),
+                "scopes": [
+                    {
+                        "repository_id": example_git.id,
+                        "repository_ref": example_git.default_branch,
+                        "match_type": "Exact",
+                    },
+                    {
+                        "repository_id": example_git.id,
+                        "repository_ref": "refs/heads/releases",
+                        "match_type": "Prefix",
+                    },
+                    {
+                        "match_type": "DefaultBranch",
+                    },
                 ],
-            ))
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Relevant Links
 
@@ -237,7 +243,7 @@ class BranchPolicyBuildValidation(pulumi.CustomResource):
         :param pulumi.Input[bool] blocking: A flag indicating if the policy should be blocking. Defaults to `true`.
         :param pulumi.Input[bool] enabled: A flag indicating if the policy should be enabled. Defaults to `true`.
         :param pulumi.Input[str] project_id: The ID of the project in which the policy will be created.
-        :param pulumi.Input[pulumi.InputType['BranchPolicyBuildValidationSettingsArgs']] settings: Configuration for the policy. This block must be defined exactly once.
+        :param pulumi.Input[Union['BranchPolicyBuildValidationSettingsArgs', 'BranchPolicyBuildValidationSettingsArgsDict']] settings: Configuration for the policy. This block must be defined exactly once.
         """
         ...
     @overload
@@ -250,55 +256,56 @@ class BranchPolicyBuildValidation(pulumi.CustomResource):
 
         ## Example Usage
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_azuredevops as azuredevops
 
-        example_project = azuredevops.Project("exampleProject")
-        example_git = azuredevops.Git("exampleGit",
-            project_id=example_project.id,
-            initialization=azuredevops.GitInitializationArgs(
-                init_type="Clean",
-            ))
-        example_build_definition = azuredevops.BuildDefinition("exampleBuildDefinition",
-            project_id=example_project.id,
-            repository=azuredevops.BuildDefinitionRepositoryArgs(
-                repo_type="TfsGit",
-                repo_id=example_git.id,
-                yml_path="azure-pipelines.yml",
-            ))
-        example_branch_policy_build_validation = azuredevops.BranchPolicyBuildValidation("exampleBranchPolicyBuildValidation",
-            project_id=example_project.id,
+        example = azuredevops.Project("example", name="Example Project")
+        example_git = azuredevops.Git("example",
+            project_id=example.id,
+            name="Example Repository",
+            initialization={
+                "init_type": "Clean",
+            })
+        example_build_definition = azuredevops.BuildDefinition("example",
+            project_id=example.id,
+            name="Example Build Definition",
+            repository={
+                "repo_type": "TfsGit",
+                "repo_id": example_git.id,
+                "yml_path": "azure-pipelines.yml",
+            })
+        example_branch_policy_build_validation = azuredevops.BranchPolicyBuildValidation("example",
+            project_id=example.id,
             enabled=True,
             blocking=True,
-            settings=azuredevops.BranchPolicyBuildValidationSettingsArgs(
-                display_name="Example build validation policy",
-                build_definition_id=example_build_definition.id,
-                valid_duration=720,
-                filename_patterns=[
+            settings={
+                "display_name": "Example build validation policy",
+                "build_definition_id": example_build_definition.id,
+                "queue_on_source_update_only": True,
+                "valid_duration": 720,
+                "filename_patterns": [
                     "/WebApp/*",
                     "!/WebApp/Tests/*",
                     "*.cs",
                 ],
-                scopes=[
-                    azuredevops.BranchPolicyBuildValidationSettingsScopeArgs(
-                        repository_id=example_git.id,
-                        repository_ref=example_git.default_branch,
-                        match_type="Exact",
-                    ),
-                    azuredevops.BranchPolicyBuildValidationSettingsScopeArgs(
-                        repository_id=example_git.id,
-                        repository_ref="refs/heads/releases",
-                        match_type="Prefix",
-                    ),
-                    azuredevops.BranchPolicyBuildValidationSettingsScopeArgs(
-                        match_type="DefaultBranch",
-                    ),
+                "scopes": [
+                    {
+                        "repository_id": example_git.id,
+                        "repository_ref": example_git.default_branch,
+                        "match_type": "Exact",
+                    },
+                    {
+                        "repository_id": example_git.id,
+                        "repository_ref": "refs/heads/releases",
+                        "match_type": "Prefix",
+                    },
+                    {
+                        "match_type": "DefaultBranch",
+                    },
                 ],
-            ))
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Relevant Links
 
@@ -330,7 +337,7 @@ class BranchPolicyBuildValidation(pulumi.CustomResource):
                  blocking: Optional[pulumi.Input[bool]] = None,
                  enabled: Optional[pulumi.Input[bool]] = None,
                  project_id: Optional[pulumi.Input[str]] = None,
-                 settings: Optional[pulumi.Input[pulumi.InputType['BranchPolicyBuildValidationSettingsArgs']]] = None,
+                 settings: Optional[pulumi.Input[Union['BranchPolicyBuildValidationSettingsArgs', 'BranchPolicyBuildValidationSettingsArgsDict']]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -363,7 +370,7 @@ class BranchPolicyBuildValidation(pulumi.CustomResource):
             blocking: Optional[pulumi.Input[bool]] = None,
             enabled: Optional[pulumi.Input[bool]] = None,
             project_id: Optional[pulumi.Input[str]] = None,
-            settings: Optional[pulumi.Input[pulumi.InputType['BranchPolicyBuildValidationSettingsArgs']]] = None) -> 'BranchPolicyBuildValidation':
+            settings: Optional[pulumi.Input[Union['BranchPolicyBuildValidationSettingsArgs', 'BranchPolicyBuildValidationSettingsArgsDict']]] = None) -> 'BranchPolicyBuildValidation':
         """
         Get an existing BranchPolicyBuildValidation resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -374,7 +381,7 @@ class BranchPolicyBuildValidation(pulumi.CustomResource):
         :param pulumi.Input[bool] blocking: A flag indicating if the policy should be blocking. Defaults to `true`.
         :param pulumi.Input[bool] enabled: A flag indicating if the policy should be enabled. Defaults to `true`.
         :param pulumi.Input[str] project_id: The ID of the project in which the policy will be created.
-        :param pulumi.Input[pulumi.InputType['BranchPolicyBuildValidationSettingsArgs']] settings: Configuration for the policy. This block must be defined exactly once.
+        :param pulumi.Input[Union['BranchPolicyBuildValidationSettingsArgs', 'BranchPolicyBuildValidationSettingsArgsDict']] settings: Configuration for the policy. This block must be defined exactly once.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))