cumulusci-plus 5.0.21__py3-none-any.whl → 5.0.43__py3-none-any.whl

cumulusci/core/tests/test_flowrunner.py

@@ -542,6 +542,106 @@ class TestSimpleTestFlowCoordinator(AbstractFlowCoordinatorTest):
         flow.run(self.org_config)
         assert len(flow.results) == 0
 
+    def test_run__when_condition_with_env_var_true(self):
+        """A flow step runs when env var condition evaluates to True"""
+        import os
+
+        with mock.patch.dict(os.environ, {"RUN_TASK": "true"}):
+            flow_config = FlowConfig(
+                {
+                    "steps": {
+                        1: {
+                            "task": "pass_name",
+                            "when": "env.get('RUN_TASK') == 'true'",
+                        }
+                    }
+                }
+            )
+            flow = FlowCoordinator(self.project_config, flow_config)
+            flow.run(self.org_config)
+            assert len(flow.results) == 1
+
+    def test_run__when_condition_with_env_var_false(self):
+        """A flow step is skipped when env var condition evaluates to False"""
+        import os
+
+        with mock.patch.dict(os.environ, {"RUN_TASK": "false"}):
+            flow_config = FlowConfig(
+                {
+                    "steps": {
+                        1: {
+                            "task": "pass_name",
+                            "when": "env.get('RUN_TASK') == 'true'",
+                        }
+                    }
+                }
+            )
+            flow = FlowCoordinator(self.project_config, flow_config)
+            flow.run(self.org_config)
+            assert len(flow.results) == 0
+
+    def test_run__when_condition_with_env_var_default(self):
+        """A flow step uses default value when env var is not set"""
+        import os
+
+        # Make sure the env var is not set
+        if "UNDEFINED_VAR" in os.environ:
+            del os.environ["UNDEFINED_VAR"]
+        flow_config = FlowConfig(
+            {
+                "steps": {
+                    1: {
+                        "task": "pass_name",
+                        "when": "env.get('UNDEFINED_VAR', 'default') == 'default'",
+                    }
+                }
+            }
+        )
+        flow = FlowCoordinator(self.project_config, flow_config)
+        flow.run(self.org_config)
+        assert len(flow.results) == 1
+
+    def test_run__when_condition_with_env_var_and_org_config(self):
+        """A flow step can combine env vars with org_config in when condition"""
+        import os
+
+        with mock.patch.dict(os.environ, {"DEPLOY_TO_SCRATCH": "true"}):
+            flow_config = FlowConfig(
+                {
+                    "steps": {
+                        1: {
+                            "task": "pass_name",
+                            "when": "org_config.scratch and env.get('DEPLOY_TO_SCRATCH') == 'true'",
+                        }
+                    }
+                }
+            )
+            flow = FlowCoordinator(self.project_config, flow_config)
+            # Set org_config.scratch to True
+            self.org_config.config["scratch"] = True
+            flow.run(self.org_config)
+            assert len(flow.results) == 1
+
+    def test_run__when_condition_with_missing_env_var_is_none(self):
+        """A flow step can check if env var exists using 'is not none'"""
+        import os
+
+        # Test when var is set
+        with mock.patch.dict(os.environ, {"MY_VAR": "value"}):
+            flow_config = FlowConfig(
+                {
+                    "steps": {
+                        1: {
+                            "task": "pass_name",
+                            "when": "env.get('MY_VAR') is not none",
+                        }
+                    }
+                }
+            )
+            flow = FlowCoordinator(self.project_config, flow_config)
+            flow.run(self.org_config)
+            assert len(flow.results) == 1
+
     def test_run__task_raises_exception_fail(self):
         """A flow aborts when a task raises an exception"""
 

cumulusci/core/tests/test_tasks.py

@@ -147,6 +147,71 @@ class TestBaseTaskCallable:
         task = BaseTask(self.project_config, self.task_config, self.org_config)
         assert task.options["test_option"] == "before baz after"
 
+    def test_init_options__org_config_substitution(self):
+        self.task_config.config["options"] = {"test_option": "$org_config.username"}
+        task = BaseTask(self.project_config, self.task_config, self.org_config)
+        assert task.options["test_option"] == USERNAME
+
+    def test_init_options__org_config_substitution_org_id(self):
+        self.task_config.config["options"] = {"test_option": "$org_config.org_id"}
+        task = BaseTask(self.project_config, self.task_config, self.org_config)
+        assert task.options["test_option"] == ORG_ID
+
+    def test_init_options__org_config_substitution_nested(self):
+        self.task_config.config["options"] = {
+            "test_option": "$org_config.username",
+            "nested": [
+                {"user": "$org_config.username"},
+                {"org": "$org_config.org_id"},
+            ],
+        }
+        task = BaseTask(self.project_config, self.task_config, self.org_config)
+        assert task.options["test_option"] == USERNAME
+        assert task.options["nested"][0]["user"] == USERNAME
+        assert task.options["nested"][1]["org"] == ORG_ID
+
+    def test_init_options__org_config_substitution__substring(self):
+        self.task_config.config["options"] = {
+            "test_option": "User: $org_config.username, Org: $org_config.org_id"
+        }
+        task = BaseTask(self.project_config, self.task_config, self.org_config)
+        assert task.options["test_option"] == f"User: {USERNAME}, Org: {ORG_ID}"
+
+    def test_init_options__org_config_substitution__no_org(self):
+        """Test that $org_config substitution is skipped when org_config is None"""
+        self.task_config.config["options"] = {"test_option": "$org_config.username"}
+        task = BaseTask(self.project_config, self.task_config, org_config=None)
+        # Should remain unchanged when org_config is None
+        assert task.options["test_option"] == "$org_config.username"
+
+    def test_init_options__mixed_substitution(self):
+        """Test that both $project_config and $org_config work together"""
+        self.project_config.config["foo"] = {"bar": "baz"}
+        self.task_config.config["options"] = {
+            "test_option": "Project: $project_config.foo__bar, User: $org_config.username"
+        }
+        task = BaseTask(self.project_config, self.task_config, self.org_config)
+        assert task.options["test_option"] == f"Project: baz, User: {USERNAME}"
+
+    def test_init_options__mixed_substitution_nested(self):
+        """Test mixed substitution in nested structures"""
+        self.project_config.config["project"] = {"name": "TestProject"}
+        self.task_config.config["options"] = {
+            "config": {
+                "project_name": "$project_config.project__name",
+                "username": "$org_config.username",
+                "items": [
+                    "$project_config.project__name",
+                    "$org_config.org_id",
+                ],
+            }
+        }
+        task = BaseTask(self.project_config, self.task_config, self.org_config)
+        assert task.options["config"]["project_name"] == "TestProject"
+        assert task.options["config"]["username"] == USERNAME
+        assert task.options["config"]["items"][0] == "TestProject"
+        assert task.options["config"]["items"][1] == ORG_ID
+
     def test_validates_missing_options(self):
         class Task(BaseTask):
             task_options = {"test_option": {"required": True}}

cumulusci/core/utils.py

@@ -379,7 +379,9 @@ def determine_managed_mode(options, project_config, org_config):
     Note: The changes allows multiple package development under same namespace.
     """
     if "managed" in options:
-        return process_bool_arg(options["managed"])
+        return process_bool_arg(
+            options["managed"] if options["managed"] is not None else False
+        )
 
     # Get package and namespace information
     package_name = getattr(project_config, "project__package__name", None)

cumulusci/core/versions.py

@@ -1,7 +1,7 @@
 import re
 from typing import Optional, Union
 
-from pydantic import BaseModel
+from pydantic.v1 import BaseModel
 
 from cumulusci.core.enums import StrEnum
 

cumulusci/cumulusci.yml

@@ -168,6 +168,10 @@ tasks:
         description: Inserts a record of any sObject using the REST API
         class_path: cumulusci.tasks.salesforce.insert_record.InsertRecord
         group: Data Operations
+    update_record:
+        description: Updates one or more records of any sObject using the REST API
+        class_path: cumulusci.tasks.salesforce.update_record.UpdateRecord
+        group: Data Operations
     create_package:
         description: Creates a package in the target org with the default package name for the project
         class_path: cumulusci.tasks.salesforce.CreatePackage
@@ -197,6 +201,10 @@ tasks:
             user_permissions:
                 - PermissionsBulkApiHardDelete
                 - PermissionsCreateAuditFields
+    assign_permission_set_to_psg:
+        group: Metadata Transformations
+        description: "Assigns specified Permission Sets to the specified Permission Set Groups using the Composite API."
+        class_path: cumulusci.tasks.salesforce.assign_ps_psg.AssignPermissionSetToPermissionSetGroup
     create_unmanaged_ee_src:
         description: Modifies the src directory for unmanaged deployment to an EE org
         class_path: cumulusci.tasks.metadata.ee_src.CreateUnmanagedEESrc
@@ -228,6 +236,10 @@ tasks:
         options:
             path: src
         group: Salesforce Metadata
+    deploy_unpackaged_metadata:
+        description: Deploys the unpackaged metadata from the project config to the target org. This is application of 2nd generation package metadata.
+        class_path: cumulusci.tasks.salesforce.DeployUnpackagedMetadata
+        group: Salesforce Metadata
     deploy_marketing_cloud_package:
         class_path: cumulusci.tasks.marketing_cloud.deploy.MarketingCloudDeployTask
         description: Deploys a package zip file to a Marketing Cloud Tenant via the Marketing Cloud Package Manager API.
@@ -653,6 +665,12 @@ tasks:
         class_path: cumulusci.tasks.metadata_etl.SetOrgWideDefaults
         options:
             namespace_inject: $project_config.project__package__namespace
+    add_applications_profile_action_overrides:
+        group: Metadata Transformations
+        description: Adds or updates profile action overrides to the Custom Applications.
+        class_path: cumulusci.tasks.metadata_etl.applications.AddProfileActionOverrides
+        options:
+            namespace_inject: $project_config.project__package__namespace
     strip_unwanted_components:
         description: Removes components from src folder which are not mentioned in given package.xml file
         class_path: cumulusci.tasks.metadata.package.RemoveUnwantedComponents
@@ -749,10 +767,33 @@ tasks:
         options:
             level: info
         group: Utilities
+    copy_file:
+        description: "Copy a file for src to dest with environment variable support, Ex: &TMPDIR&/src resolves to /tmp/src on linux or %TMPDIR%/src on windows."
+        class_path: cumulusci.tasks.util.CopyFile
+        group: Utilities
+        is_global: True
+    load_dot_env:
+        description: "Log the contents of the .env file"
+        class_path: cumulusci.tasks.util.LoadDotEnv
+        group: Utilities
+        is_global: True
     configure_env:
         description: Get or set environment variables.
         class_path: cumulusci.tasks.utility.env_management.EnvManagement
         group: Utilities
+    secrets_to_dotenv:
+        description: Get all environment variables from a target JSON file and generates a .env file that can be used to set up the environment variables for the deployment
+        class_path: cumulusci.tasks.utility.secretsToEnv.SecretsToEnv
+        group: Utilities
+        is_global: True
+    directory_recreator:
+        description: Remove and recreate a directory
+        class_path: cumulusci.tasks.utility.directoryRecreator.DirectoryRecreator
+        group: Utilities
+    consolidate_unpackaged_metadata:
+        description: Consolidate unpackaged metadata from multiple sources into a single directory
+        class_path: cumulusci.tasks.utility.copyContents.ConsolidateUnpackagedMetadata
+        group: Utilities
     download_extract:
         description: Downloads files and folders from a VCS repository.
         class_path: cumulusci.tasks.vcs.download_extract.DownloadExtract
@@ -787,6 +828,10 @@ tasks:
         description: Load Custom Settings specified in a YAML file to the target org
         class_path: cumulusci.tasks.salesforce.LoadCustomSettings
         group: "Data Operations"
+    sfdmu:
+        description: Execute SFDmu data migration with namespace injection support
+        class_path: cumulusci.tasks.sfdmu.sfdmu.SfdmuTask
+        group: "Data Operations"
     remove_metadata_xml_elements:
         description: Remove specified XML elements from one or more metadata files
         class_path: cumulusci.tasks.metadata.modify.RemoveElementsXPath
@@ -823,6 +868,30 @@ tasks:
         class_path: cumulusci.tasks.salesforce.SfDataCommands.DataCreateRecordTask
         description: "Executes the `sf data create` command against an org"
         group: SalesforceDX Data Commands
+    update_package_version:
+        class_path: cumulusci.tasks.salesforce.SfPackageCommands.PackageVersionUpdateTask
+        description: "Executes the `sf package version update` command against an org"
+        group: Salesforce Packages
+    get_package_version:
+        description: Get package version id from package name and version
+        class_path: cumulusci.tasks.salesforce.getPackageVersion.GetPackageVersion
+        group: Salesforce Packages
+        options:
+            package_name: $project_config.project__package__name
+            fail_on_error: False
+    update_named_credential:
+        class_path: cumulusci.tasks.salesforce.update_named_credential.UpdateNamedCredential
+        description: Update named credential parameters
+        group: Metadata Transformations
+    update_external_credential:
+        class_path: cumulusci.tasks.salesforce.update_external_credential.UpdateExternalCredential
+        description: Update external credential parameters
+        group: Metadata Transformations
+    update_external_auth_identity_provider:
+        class_path: cumulusci.tasks.salesforce.update_external_auth_identity_provider.UpdateExternalAuthIdentityProvider
+        description: Update external auth identity provider parameters and credentials
+        group: Metadata Transformations
+
 flows:
     ci_beta:
         group: Continuous Integration
@@ -1562,7 +1631,10 @@ project:
         namespace:
         install_class:
         uninstall_class:
-        api_version: "63.0"
+        apex_test_access:
+        package_metadata_access:
+        unpackaged_metadata_path:
+        api_version: "64.0"
     git:
         default_branch: master
         prefix_feature: feature/

cumulusci/oauth/client.py

@@ -19,7 +19,7 @@ from cryptography import x509
 from cryptography.hazmat.primitives import hashes, serialization
 from cryptography.hazmat.primitives.asymmetric import rsa
 from cryptography.x509.oid import NameOID
-from pydantic import BaseModel
+from pydantic.v1 import BaseModel
 
 from cumulusci.core.exceptions import CumulusCIUsageError
 from cumulusci.oauth.exceptions import OAuth2Error

cumulusci/plugins/plugin_base.py

@@ -11,7 +11,7 @@ from cumulusci.utils.yaml.cumulusci_yml import Plugin, cci_safe_load
 class PluginBase(ABC):
     plugin: Plugin
     plugin_config_file: str = "cumulusci_plugin.yml"
-    path: str = None
+    path: str
     plugin_project_config: Optional[dict] = None
 
     def __init__(self, **kwargs) -> None:
@@ -32,12 +32,14 @@ class PluginBase(ABC):
     @property
     def name(self) -> str:
         """Returns the name of the plugin."""
-        return self.plugin.name if self.plugin else "Unnamed Plugin"
+        return (
+            self.plugin.name if self.plugin and self.plugin.name else "Unnamed Plugin"
+        )
 
     @property
     def version(self) -> str:
         """Returns the version of the plugin."""
-        return self.plugin.version if self.plugin else "0.0.0"
+        return self.plugin.version if self.plugin and self.plugin.version else "0.0.0"
 
     def initialize(self) -> None:
         """Initialize the plugin. This method is called when the plugin is loaded."""

cumulusci/robotframework/pageobjects/ObjectManagerPageObject.py

@@ -203,7 +203,7 @@ class ObjectManagerPage(BasePage):
 
             except Exception as e:
                 self.builtin.log(
-                    f"on try #{tries+1} we caught this error: {e}", "DEBUG"
+                    f"on try #{tries + 1} we caught this error: {e}", "DEBUG"
                 )
                 self.builtin.sleep("1 second")
                 last_error = e

cumulusci/salesforce_api/rest_deploy.py

@@ -138,7 +138,7 @@ class RestDeploy:
 
     # Construct an error message from deployment failure details
     def _construct_error_message(self, failure):
-        error_message = f"{str.upper(failure['problemType'])} in file {failure['fileName'][len(PARENT_DIR_NAME)+len('/'):]}: {failure['problem']}"
+        error_message = f"{str.upper(failure['problemType'])} in file {failure['fileName'][len(PARENT_DIR_NAME) + len('/'):]}: {failure['problem']}"
 
         if failure["lineNumber"] and failure["columnNumber"]:
             error_message += (

cumulusci/schema/cumulusci.jsonschema.json

@@ -122,6 +122,11 @@
                 "name": {
                     "title": "Name",
                     "type": "string"
+                },
+                "is_global": {
+                    "title": "Is Global",
+                    "default": false,
+                    "type": "boolean"
                 }
             },
             "additionalProperties": false
@@ -246,6 +251,70 @@
                 "metadata_package_id": {
                     "title": "Metadata Package Id",
                     "type": "string"
+                },
+                "apex_test_access": {
+                    "title": "Apex Test Access",
+                    "type": "object",
+                    "additionalProperties": {
+                        "anyOf": [
+                            {
+                                "type": "string"
+                            },
+                            {
+                                "type": "array",
+                                "items": {
+                                    "type": "string"
+                                }
+                            }
+                        ]
+                    }
+                },
+                "package_metadata_access": {
+                    "title": "Package Metadata Access",
+                    "type": "object",
+                    "additionalProperties": {
+                        "anyOf": [
+                            {
+                                "type": "string"
+                            },
+                            {
+                                "type": "array",
+                                "items": {
+                                    "type": "string"
+                                }
+                            }
+                        ]
+                    }
+                },
+                "unpackaged_metadata_path": {
+                    "title": "Unpackaged Metadata Path",
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        },
+                        {
+                            "type": "object",
+                            "additionalProperties": {
+                                "anyOf": [
+                                    {
+                                        "type": "string"
+                                    },
+                                    {
+                                        "type": "array",
+                                        "items": {
+                                            "type": "string"
+                                        }
+                                    }
+                                ]
+                            }
+                        }
+                    ]
                 }
             },
             "additionalProperties": false

cumulusci/tasks/apex/anon.py

@@ -4,7 +4,7 @@ from cumulusci.core.exceptions import (
     SalesforceException,
     TaskOptionsError,
 )
-from cumulusci.core.utils import process_bool_arg, determine_managed_mode
+from cumulusci.core.utils import determine_managed_mode, process_bool_arg
 from cumulusci.tasks.salesforce import BaseSalesforceApiTask
 from cumulusci.utils import in_directory, inject_namespace
 from cumulusci.utils.http.requests_utils import safe_json_from_response