cumulusci-plus 5.0.18__py3-none-any.whl → 5.0.20__py3-none-any.whl

cumulusci/tasks/salesforce/SfDataCommands.py

@@ -164,3 +164,237 @@ class DataDeleteRecordTask(SfDataToolingAPISupportedCommands):
 
     def _run_task(self):
         return super()._run_task()
+
+
+class DataUpdateRecordTask(SfDataToolingAPISupportedCommands):
+    class Options(SfDataToolingAPISupportedCommands.Options):
+        sobject: str = Field(
+            ...,
+            description="API name of the Salesforce or Tooling API object that you're updating a record from.",
+        )
+        record_id: str = Field(None, description="ID of the record you’re updating.")
+        where: str = Field(
+            None,
+            description="List of <fieldName>=<value> pairs that identify the record you want to update.",
+        )
+        values: str = Field(
+            ...,
+            description="Values for the flags in the form <fieldName>=<value>, separate multiple pairs with spaces.",
+        )
+
+    def _init_task(self):
+        super()._init_task()
+        self.data_command += "update record"
+
+    def _init_options(self, kwargs):
+        super()._init_options(kwargs)
+        if self.parsed_options.sobject:
+            self.args.extend(["--sobject", self.parsed_options.sobject])
+        if self.parsed_options.record_id:
+            self.args.extend(["--record-id", self.parsed_options.record_id])
+        if self.parsed_options.where:
+            self.args.extend(["--where", self.parsed_options.where])
+        if self.parsed_options.values:
+            self.args.extend(["--values", self.parsed_options.values])
+
+    def _run_task(self):
+        return super()._run_task()
+
+
+class DataGetRecordTask(SfDataToolingAPISupportedCommands):
+    class Options(SfDataToolingAPISupportedCommands.Options):
+        sobject: str = Field(
+            ...,
+            description="API name of the Salesforce or Tooling API object that you're fetching a record from.",
+        )
+        record_id: str = Field(None, description="ID of the record you’re fetching.")
+        where: str = Field(
+            None,
+            description="List of <fieldName>=<value> pairs that identify the record you want to fetch.",
+        )
+
+    def _init_task(self):
+        super()._init_task()
+        self.data_command += "get record"
+
+    def _init_options(self, kwargs):
+        super()._init_options(kwargs)
+        if self.parsed_options.sobject:
+            self.args.extend(["--sobject", self.parsed_options.sobject])
+        if self.parsed_options.record_id:
+            self.args.extend(["--record-id", self.parsed_options.record_id])
+        if self.parsed_options.where:
+            self.args.extend(["--where", self.parsed_options.where])
+
+    def _run_task(self):
+        return super()._run_task()
+
+
+class DataQueryResumeTask(SfDataToolingAPISupportedCommands):
+    class Options(SfDataToolingAPISupportedCommands.Options):
+        bulk_query_id: str = Field(
+            ...,
+            description="The 18-character ID of the bulk query to resume.",
+        )
+        result_format: str = Field(
+            None,
+            description="Format to display the results; the --json_output flag overrides this flag. Permissible values are: human, csv, json.",
+        )
+
+    def _init_task(self):
+        super()._init_task()
+        self.data_command += "query resume"
+
+    def _init_options(self, kwargs):
+        super()._init_options(kwargs)
+        if self.parsed_options.bulk_query_id:
+            self.args.extend(["--bulk-query-id", self.parsed_options.bulk_query_id])
+        if self.parsed_options.result_format:
+            self.args.extend(["--result-format", self.parsed_options.result_format])
+
+    def _run_task(self):
+        return super()._run_task()
+
+
+class DataDeleteBulkTask(SfDataCommands):
+    class Options(SfDataCommands.Options):
+        sobject: str = Field(
+            ...,
+            description="The API name of the object for the bulk job.",
+        )
+        file: str = Field(
+            ...,
+            description="The path to the CSV file that contains the IDs of the records to delete.",
+        )
+        wait: int = Field(
+            None,
+            description="The number of minutes to wait for the command to complete.",
+        )
+
+    def _init_task(self):
+        super()._init_task()
+        self.data_command += "delete bulk"
+
+    def _init_options(self, kwargs):
+        super()._init_options(kwargs)
+        if self.parsed_options.sobject:
+            self.args.extend(["--sobject", self.parsed_options.sobject])
+        if self.parsed_options.file:
+            self.args.extend(["--file", self.parsed_options.file])
+        if self.parsed_options.wait:
+            self.args.extend(["--wait", str(self.parsed_options.wait)])
+
+    def _run_task(self):
+        return super()._run_task()
+
+
+class DataUpsertBulkTask(SfDataCommands):
+    class Options(SfDataCommands.Options):
+        sobject: str = Field(
+            ...,
+            description="The API name of the object for the bulk job.",
+        )
+        file: str = Field(
+            ...,
+            description="The path to the CSV file that contains the records to upsert.",
+        )
+        external_id_field: str = Field(
+            ...,
+            description="The API name of the external ID field for the upsert.",
+        )
+        wait: int = Field(
+            None,
+            description="The number of minutes to wait for the command to complete.",
+        )
+
+    def _init_task(self):
+        super()._init_task()
+        self.data_command += "upsert bulk"
+
+    def _init_options(self, kwargs):
+        super()._init_options(kwargs)
+        if self.parsed_options.sobject:
+            self.args.extend(["--sobject", self.parsed_options.sobject])
+        if self.parsed_options.file:
+            self.args.extend(["--file", self.parsed_options.file])
+        if self.parsed_options.external_id_field:
+            self.args.extend(
+                ["--external-id-field", self.parsed_options.external_id_field]
+            )
+        if self.parsed_options.wait:
+            self.args.extend(["--wait", str(self.parsed_options.wait)])
+
+    def _run_task(self):
+        return super()._run_task()
+
+
+class DataImportTreeTask(SfDataCommands):
+    class Options(SfDataCommands.Options):
+        files: list = Field(
+            None,
+            description="A list of paths to sObject Tree API plan definition files.",
+        )
+        plan: str = Field(
+            None,
+            description="The path to a plan definition file.",
+        )
+        content_type_map: str = Field(
+            None,
+            description="A mapping of file extensions to content types.",
+        )
+
+    def _init_task(self):
+        super()._init_task()
+        self.data_command += "import tree"
+
+    def _init_options(self, kwargs):
+        super()._init_options(kwargs)
+        if self.parsed_options.files:
+            self.args.extend(["--files", ",".join(self.parsed_options.files)])
+        if self.parsed_options.plan:
+            self.args.extend(["--plan", self.parsed_options.plan])
+        if self.parsed_options.content_type_map:
+            self.args.extend(
+                ["--content-type-map", self.parsed_options.content_type_map]
+            )
+
+    def _run_task(self):
+        return super()._run_task()
+
+
+class DataExportTreeTask(SfDataCommands):
+    class Options(SfDataCommands.Options):
+        query: str = Field(
+            ...,
+            description="A SOQL query that retrieves the records you want to export.",
+        )
+        plan: bool = Field(
+            False,
+            description="Generate a plan definition file.",
+        )
+        prefix: str = Field(
+            None,
+            description="The prefix for the exported data files.",
+        )
+        output_dir: str = Field(
+            None,
+            description="The directory to store the exported files.",
+        )
+
+    def _init_task(self):
+        super()._init_task()
+        self.data_command += "export tree"
+
+    def _init_options(self, kwargs):
+        super()._init_options(kwargs)
+        if self.parsed_options.query:
+            self.args.extend(["--query", self.parsed_options.query])
+        if self.parsed_options.plan:
+            self.args.extend(["--plan"])
+        if self.parsed_options.prefix:
+            self.args.extend(["--prefix", self.parsed_options.prefix])
+        if self.parsed_options.output_dir:
+            self.args.extend(["--output-dir", self.parsed_options.output_dir])
+
+    def _run_task(self):
+        return super()._run_task()

cumulusci/tasks/salesforce/profiles.py

@@ -23,6 +23,10 @@ class CreateBlankProfile(BaseSalesforceMetadataApiTask):
             "description": "The description of the the new profile",
             "required": False,
         },
+        "skip_if_exists": {
+            "description": "Skip if the profile already exists in the target org. Defaults to True",
+            "required": False,
+        },
     }
 
     def _init_options(self, kwargs):
@@ -32,6 +36,7 @@ class CreateBlankProfile(BaseSalesforceMetadataApiTask):
                 "Either the name or the ID of the user license must be set."
             )
         self.license = self.options.get("license", "Salesforce")
+        self.sf = None
 
     def _run_task(self):
 
@@ -39,6 +44,18 @@ class CreateBlankProfile(BaseSalesforceMetadataApiTask):
         self.description = self.options.get("description") or ""
         self.license_id = self.options.get("license_id")
 
+        profile_id = self._get_profile_id(self.name)
+        if profile_id:
+            if not self.options.get("skip_if_exists", True):
+                raise TaskOptionsError(
+                    f"Profile '{self.name}' already exists with id: {profile_id}"
+                )
+            self.logger.info(
+                f"Profile '{self.name}' already exists with id: {profile_id}"
+            )
+            self.return_values = {"profile_id": profile_id}
+            return profile_id
+
         if not self.license_id:
             self.license_id = self._get_user_license_id(self.license)
 
@@ -48,22 +65,38 @@ class CreateBlankProfile(BaseSalesforceMetadataApiTask):
         self.logger.info(f"Profile '{self.name}' created with id: {result}")
         return result
 
+    def _get_profile_id(self, profile_name):
+        """Returns the Id of a Profile from a given Name"""
+        res = self._query_sf(
+            f"SELECT Id, Name FROM Profile WHERE FullName = '{profile_name}' LIMIT 1"
+        )
+        if res["records"]:
+            return res["records"][0]["Id"]
+
+        self.logger.info(f"Profile name '{profile_name}' was not found.")
+        return None
+
     def _get_user_license_id(self, license_name):
         """Returns the Id of a UserLicense from a given Name"""
-        self.sf = get_simple_salesforce_connection(
-            self.project_config,
-            self.org_config,
-            api_version=self.org_config.latest_api_version,
-            base_url=None,
-        )
-        res = self.sf.query(
+        res = self._query_sf(
             f"SELECT Id, Name FROM UserLicense WHERE Name = '{license_name}' LIMIT 1"
         )
+
         if res["records"]:
             return res["records"][0]["Id"]
         else:
             raise TaskOptionsError(f"License name '{license_name}' was not found.")
 
+    def _query_sf(self, query):
+        self.sf = self.sf or get_simple_salesforce_connection(
+            self.project_config,
+            self.org_config,
+            api_version=self.org_config.latest_api_version,
+            base_url=None,
+        )
+        res = self.sf.query(query)
+        return res
+
     def _get_api(self):
         return self.api_class(
             self,

cumulusci/tasks/salesforce/tests/test_profiles.py

@@ -95,6 +95,15 @@ def test_run_task_success():
         json={
             "done": True,
             "totalSize": 1,
+            "records": [],
+        },
+    )
+    responses.add(
+        responses.GET,
+        query_url,
+        json={
+            "done": True,
+            "totalSize": 0,
             "records": [
                 {
                     "attributes": {
@@ -115,9 +124,12 @@ def test_run_task_success():
     result = task._run_task()
     assert result == "001R0000029IyDPIA0"
     assert responses.calls[0].request.params == {
+        "q": "SELECT Id, Name FROM Profile WHERE FullName = 'Test Profile Name' LIMIT 1"
+    }
+    assert responses.calls[1].request.params == {
         "q": "SELECT Id, Name FROM UserLicense WHERE Name = 'Foo' LIMIT 1"
     }
-    soap_body = responses.calls[1].request.body
+    soap_body = responses.calls[2].request.body
     assert "<Name>Test Profile Name</Name>" in str(soap_body)
     assert "<UserLicenseId>10056000000VGjUAAW</UserLicenseId>" in str(soap_body)
     assert "<Description>Have fun stormin da castle</Description>" in str(soap_body)
@@ -135,6 +147,15 @@ def test_run_task_fault():
     )
     task.org_config._latest_api_version = "53.0"
 
+    responses.add(
+        responses.GET,
+        "https://test.salesforce.com/services/data/v53.0/query/",
+        json={
+            "done": True,
+            "totalSize": 0,
+            "records": [],
+        },
+    )
     responses.add(
         responses.POST,
         "https://test.salesforce.com/services/Soap/u/53.0/ORG_ID",
@@ -157,6 +178,17 @@ def test_run_task_field_error():
         },
     )
     task.org_config._latest_api_version = "53.0"
+
+    responses.add(
+        responses.GET,
+        "https://test.salesforce.com/services/data/v53.0/query/",
+        json={
+            "done": True,
+            "totalSize": 0,
+            "records": [],
+        },
+    )
+
     responses.add(
         responses.POST,
         "https://test.salesforce.com/services/Soap/u/53.0/ORG_ID",
@@ -180,6 +212,16 @@ def test_run_task_error():
     )
     task.org_config._latest_api_version = "53.0"
 
+    responses.add(
+        responses.GET,
+        "https://test.salesforce.com/services/data/v53.0/query/",
+        json={
+            "done": True,
+            "totalSize": 0,
+            "records": [],
+        },
+    )
+
     responses.add(
         responses.POST,
         "https://test.salesforce.com/services/Soap/u/53.0/ORG_ID",
@@ -200,3 +242,125 @@ def test_task_options_error():
                 "description": "Foo",
             },
         )
+
+
+@responses.activate
+def test_run_task_success_with_skip_if_exists_false():
+    query_url = "https://test.salesforce.com/services/data/v53.0/query/"
+
+    task = create_task(
+        CreateBlankProfile,
+        {
+            "license": "Foo",
+            "name": "Test Profile Name",
+            "description": "Have fun stormin da castle",
+        },
+    )
+    task.org_config._latest_api_version = "53.0"
+
+    responses.add(
+        responses.GET,
+        query_url,
+        json={
+            "done": True,
+            "totalSize": 1,
+            "records": [
+                {
+                    "attributes": {
+                        "type": "Profile",
+                        "url": "/services/data/v53.0/sobjects/Profile/10056000000VGjUAAW",
+                    },
+                    "Id": "10056000000VGjUAAW",
+                    "Name": "Test Profile Name",
+                }
+            ],
+        },
+    )
+
+    result = task._run_task()
+
+    assert result == "10056000000VGjUAAW"
+    assert responses.calls[0].request.params == {
+        "q": "SELECT Id, Name FROM Profile WHERE FullName = 'Test Profile Name' LIMIT 1"
+    }
+
+
+@responses.activate
+def test_run_task_success_with_skip_if_exists_true():
+    query_url = "https://test.salesforce.com/services/data/v53.0/query/"
+
+    task = create_task(
+        CreateBlankProfile,
+        {
+            "license": "Foo",
+            "name": "Test Profile Name",
+            "description": "Have fun stormin da castle",
+            "skip_if_exists": False,
+        },
+    )
+    task.org_config._latest_api_version = "53.0"
+
+    responses.add(
+        responses.GET,
+        query_url,
+        json={
+            "done": True,
+            "totalSize": 1,
+            "records": [
+                {
+                    "attributes": {
+                        "type": "Profile",
+                        "url": "/services/data/v53.0/sobjects/Profile/10056000000VGjUAAW",
+                    },
+                    "Id": "10056000000VGjUAAW",
+                    "Name": "Test Profile Name",
+                }
+            ],
+        },
+    )
+
+    with pytest.raises(TaskOptionsError) as e:
+        task._run_task()
+    assert "10056000000VGjUAAW" in str(e)
+
+
+@responses.activate
+def test_run_task_with_invalid_license():
+    query_url = "https://test.salesforce.com/services/data/v53.0/query/"
+
+    task = create_task(
+        CreateBlankProfile,
+        {
+            "license": "Foo",
+            "name": "Test Profile Name",
+            "description": "Have fun stormin da castle",
+        },
+    )
+    task.org_config._latest_api_version = "53.0"
+
+    responses.add(
+        responses.GET,
+        query_url,
+        json={
+            "done": True,
+            "totalSize": 1,
+            "records": [],
+        },
+    )
+    responses.add(
+        responses.GET,
+        query_url,
+        json={
+            "done": True,
+            "totalSize": 0,
+            "records": [],
+        },
+    )
+    responses.add(
+        responses.POST,
+        "https://test.salesforce.com/services/Soap/u/53.0/ORG_ID",
+        RESPONSE_SUCCESS,
+    )
+    with pytest.raises(TaskOptionsError) as e:
+        task._run_task()
+    assert "License name 'Foo' was not found." in str(e)

cumulusci/tasks/salesforce/tests/test_update_dependencies.py

@@ -362,7 +362,7 @@ def test_install_dependency_installs_unmanaged():
 
     task._install_dependency(task.dependencies[0])
     task.dependencies[0].install.assert_called_once_with(
-        task.project_config, task.org_config
+        task.project_config, task.org_config, task.options
     )
 
 

cumulusci/tasks/salesforce/update_dependencies.py

@@ -64,6 +64,9 @@ class UpdateDependencies(BaseSalesforceTask):
         "base_package_url_format": {
             "description": "If `interactive` is set to True, display package Ids using a format string ({} will be replaced with the package Id)."
         },
+        "force_pre_post_install": {
+            "description": "Forces the pre-install and post-install steps to be run. Defaults to False."
+        },
         **{k: v for k, v in PACKAGE_INSTALL_TASK_OPTIONS.items() if k != "password"},
     }
 
@@ -220,8 +223,11 @@ class UpdateDependencies(BaseSalesforceTask):
             if not click.confirm("Continue to install dependencies?", default=True):
                 raise CumulusCIException("Dependency installation was canceled.")
 
-        for d in dependencies:
-            self._install_dependency(d)
+        if dependencies:
+            self.logger.info("Installing dependencies:")
+
+            for d in dependencies:
+                self._install_dependency(d)
 
         self.org_config.reset_installed_packages()
 
@@ -233,7 +239,7 @@ class UpdateDependencies(BaseSalesforceTask):
                 self.project_config, self.org_config, self.install_options
             )
         else:
-            dependency.install(self.project_config, self.org_config)
+            dependency.install(self.project_config, self.org_config, self.options)
 
     def freeze(self, step):
         if self.options["interactive"]:

{cumulusci_plus-5.0.18.dist-info → cumulusci_plus-5.0.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cumulusci-plus
-Version: 5.0.18
+Version: 5.0.20
 Summary: Build and release tools for Salesforce developers
 Project-URL: Homepage, https://github.com/jorgesolebur/CumulusCI
 Project-URL: Changelog, https://cumulusci.readthedocs.io/en/stable/history.html
@@ -127,7 +127,7 @@ license](https://github.com/SFDO-Tooling/CumulusCI/blob/main/LICENSE)
 and is not covered by the Salesforce Master Subscription Agreement.
 
 <!-- Changelog -->
-## v5.0.18 (2025-08-23)
+## v5.0.20 (2025-09-05)
 
 <!-- Release notes generated using configuration in .github/release.yml at main -->
 
@@ -135,6 +135,6 @@ and is not covered by the Salesforce Master Subscription Agreement.
 
 ### Changes
 
-- Add sf data command of create, query and delete. by [@rupeshjSFDC](https://github.com/rupeshjSFDC) in [#61](https://github.com/jorgesolebur/CumulusCI/pull/61)
+- Add Skil If Exists for create profile check by [@rupeshjSFDC](https://github.com/rupeshjSFDC) in [#65](https://github.com/jorgesolebur/CumulusCI/pull/65)
 
-**Full Changelog**: https://github.com/jorgesolebur/CumulusCI/compare/v5.0.17...v5.0.18
+**Full Changelog**: https://github.com/jorgesolebur/CumulusCI/compare/v5.0.19...v5.0.20