daml/test-common/canton
azure-pipelines[bot] 4a9a89c4de
update canton to 3.0.0-snapshot.20240206.12490.0.vd8ee3dcc (#18407)
* update canton to 3.0.0-snapshot.20240206.12490.0.vd8ee3dcc

tell-slack: canton

* Handle removal of ErrorResource.SharedKey

---------

Co-authored-by: Azure Pipelines Daml Build <support@digitalasset.com>
Co-authored-by: Tudor Voicu <tudor.voicu@digitalasset.com>
2024-02-07 14:13:15 +01:00
..
it-lib remove unused deps in //test-common/canton/it-lib:it-lib (#18395) 2024-02-06 11:59:19 +00:00
.gitignore Move canton directory to let place for code drop (#17506) 2023-09-29 14:37:01 +00:00
BUILD.bazel update canton to 3.0.0-snapshot.20240206.12490.0.vd8ee3dcc (#18407) 2024-02-07 14:13:15 +01:00
README.md do not build canton as separate task (#18058) 2023-12-21 09:47:48 +01:00

Canton dependency

This folder contains the infrastructure to work with custom Canton Enterprise Edition versions.

By default, we rely on the Canton-EE artifact defined in BUILD.bazel. However, we have the ability to, rather than depend on a published version, depend on an arbitrary jar.

Local development

For local development, you can set the local_ee_canton variable in BUILD.bazel, and, rather than looking at the downloaded Canton-EE release, the Bazel build will then look for a local file under canton/lib/canton-ee.jar for its Canton source.

How you get that canton-ee jar there is entirely up to you; the assumption is that this would be the result of building a local checkout of Canton with your own local, uncommitted changes.

Once you have things working locally, you can push your Canton branch, and start building Daml against that even before the Canton branch gets merged.

Running Enterprise Edition Tests

Some situations may require running Canton Enterprise Edition, but this is an open-source repository so we cannot assume every contributor will have a Canton EE license key.

Tests that require Canton EE must be tagged with "canton-ee", which is disabled by default through .bazelrc. To run those tests locally, either explicitly target them or add --build_tag_filters= or --test_tag_filters= as appropriate (yes, these are the full options: by setting the "running" filters to empty for the current run, you overwrite the -canton-ee set in .bazelrc which excludes the Canton EE tests, thereby removing the exclusion and including the tests).

Those tests are run on CI.