To help you get started, we've collected the most common ways that cumulusci is being used within popular public projects.

SFDO-Tooling / CumulusCI / cumulusci / tasks / apex / testrunner.py View on Github

self.options["json_output"] = self.options.get(
            "json_output", "test_results.json"
        )

        self.options["managed"] = process_bool_arg(self.options.get("managed", False))

        self.options["retry_failures"] = process_list_arg(
            self.options.get("retry_failures", [])
        )
        compiled_res = []
        for regex in self.options["retry_failures"]:
            try:
                compiled_res.append(re.compile(regex))
            except re.error as e:
                raise TaskOptionsError(
                    "An invalid regular expression ({}) was provided ({})".format(
                        regex, e
                    )
                )
        self.options["retry_failures"] = compiled_res
        self.options["retry_always"] = process_bool_arg(
            self.options.get("retry_always", False)
        )

        self.counts = {}

View more ways to use cumulusci

CumulusCI

CumulusCI helps build great applications on the Salesforce platform by automating org setup, testing, and deployment for everyone --- from developers and admins to testers and product managers.

Best practices, proven at scale. CumulusCI provides a complete development and release process created by Salesforce.org to build and release applications to thousands of users on the Salesforce platform. It's easy to start new projects with a standard set of tasks (single actions) and flows (sequences of tasks), or customize by adding your own.

Batteries included. Out-of-the-box features help you quickly:

• Build sophisticated orgs with automatic installation of dependencies.
• Load and capture sample datasets to make your orgs feel real.
• Apply transformations to existing metadata to tailor orgs to your specific requirements.
• Run builds in continuous integration systems.
• Create end-to-end browser tests and setup automation using Robot Framework.
• Generate synthetic data on any scale, from a single record to a million, using Snowfakery.

Build anywhere. Automation defined using CumulusCI is portable. It is stored in a source repository and can be run from your local command line, from a continuous integration system, or from a customer-facing MetaDeploy installer. CumulusCI can run automation on scratch orgs created using the Salesforce CLI, or on persistent orgs like sandboxes, production orgs, and Developer Edition orgs.

Learn more

For a tutorial introduction to CumulusCI, complete the Build Applications with CumulusCI trail on Trailhead.

To go in depth, read the full documentation.

If you just want a quick intro, watch these screencast demos of using CumulusCI to configure a Salesforce project from a GitHub repository.

For a live demo with voiceover, please see Jason Lantz's PyCon 2020 presentation from minute 36 through minute 54.

Questions?

Ask in the CumulusCI (CCI) group in the Trailblazer Community.

Please note: CumulusCI is distributed under an open source license and is not covered by the Salesforce Master Subscription Agreement.

v4.0.1 (2024-11-18)

Issues Fixed 🩴

• Fixed a ModuleNotFoundError for docutils by adding the dependency docutils by @jstvz in #3558.

Full Changelog: https://github.com/SFDO-Tooling/CumulusCI/compare/v4.0.0...v4.0.1