Cumulusci

Issues fixed:

- When generating package.xml, translate `___NAMESPACE___` tokens in
filenames into `%%%NAMESPACE%%%` tokens in package.xml (1104).
- Avoid extraneous output when `--json` output was requested (1103).
- Display OS notification when a task or flow completes even if it
failed.
- Robot Framework: Added logic to retry the initial page load if it is
not loading successfully.
- Internal API change: Errors while processing a response from the
Metadata API are now raised as MetadataParseError.

Issues fixed:

- Fixed `cci service connect` when run outside of a directory
containing a CumulusCI project.

Breaking changes:

- We reorganized the flows for setting up a package for regression
testing for better symmetry with other flows. If you were running
the `install_regression` flow before, you now probably want
`regression_org`.

Details: The `install_regression` flow now installs the package
_without_ configuring it. There is a new `config_regression`
flow to configure the package (it defaults to calling
`config_managed`) and a `regression_org` flow that includes both
`install_regression` and `config_regression`.

New features:

- CumulusCI now has experimental support for deploying projects in [DX
source
format](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_source_file_format.htm).
To enable this, set `source_format: sfdx` in the project section of
`cumulusci.yml`. CumulusCI will deploy DX-format projects to scratch
orgs using `sfdx force:source:push` and to other orgs using the
Metadata API (by converting to metadata source format in a temporary
directory).
- Setting a default org in CumulusCI (using `cci org default` or the
`--default` flag when creating a scratch org) will now also update
the sfdx `defaultusername`. (868)
- When connecting to GitHub using `cci service connect github`,
CumulusCI will now check to make sure the credentials are valid
before saving them.
- Robot Framework:
- Added a framework for creating "page object" classes to
contain keywords related to a particular page or component.
- The `robot` task now takes a `name` option to control the name
of the robot suite in output.
- Updates to the keyword `Open Test Browser`:
- It allows you to open more than one browser in a single test
case. (1068)
- It sets the default size for the browser window to
1280x1024.
- Added a new keyword argument `size` to override the default
size.
- Added a new keyword argument `alias` to let you assign an
alias to multiple browser windows.

Issues fixed:

- Robot Framework: Fixed a bug where the `Delete Session Records`
keyword would skip deleting some records. (973)
- If Salesforce returns an error response while refreshing an OAuth
token, CumulusCI will now show the response instead of just the HTTP
status code.
- Fixed a bug in reporting errors from the Metadata API if the
response contains `componentFailures` with no `problem` or
`problemType`.

New features:

- Added tasks `list_changes` and `retrieve_changes` which interact
with source tracking in scratch orgs to handle retrieving changed
metadata as Metadata API format source.
- Added task `EnsureRecordTypes` to generate a Record Type and
optional Business Process for a specific sObject and deploy the
metadata, if the object does not already have Record Types.
- The `update_admin_profile` task now uses Python string formatting on
the `package.xml` file used for retrieve. This allows injection of
namespace prefixes using `{managed}` and `{namespaced_org}`.

Issues fixed:

- If CumulusCI gets a connection error while trying to call the
Salesforce Metadata API, it will now retry several times before
giving up.
- The GitHub release notes parser now recognizes Issues Closed if they
are linked in Markdown format.
- Robot Framework: Fixed a locator used by the
`Select App Launcher App` keyword to work in Summer '19.
- The `cci project init` command now uses an updated repository URL
when extending EDA.

- Allow configuration of the email address assigned to scratch org
users, with the order of priority being (1) any `adminEmail` key in
the scratch org definition; (2) the `email_address` property on the
scratch org configuration in `cumulusci.yml`; (3) the `user.email`
configuration property in Git.
- CumulusCI can now handle building static resource bundles
(`*.resource`) while deploying using the Metadata API. To use this
option, specify the `static_resource_path` option for the deploy
task. Any subdirectory in this path will be turned into a resource
file and added to the package during deployment. There must be a
corresponding `*.resource-meta.xml` file for each static resource
bundle.
- Bulk data tasks: Fixed a bug that added extra underscores to field
names when processing lookups.
- Robot Framework: The Salesforce library now has the ability to
switch between different sets of locators based on the Salesforce
version, and thanks to it we've fixed the robot so it can click on
modal buttons in the Summer '19 release.
- The `cci project init` command now generates projects with a
different preferred structure for Robot Framework tests and
resources, with everything inside the `robot` directory. Existing
projects with tests in the `tests` directory should continue to
work.

- The `purgeOnDelete` flag for the `deploy` task will now
automatically be set to false when deploying metadata to production
orgs (previously deployment would fail on production orgs if this
flag was true).
- The installation documentation now recommends using `pipx` to
install CumulusCI on Windows, so that you don't have to set up a
virtualenv manually.