Skip to content

dragomirp/charm-relation-interfaces

This branch is 3 commits behind canonical/charm-relation-interfaces:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

7e04d8e · Feb 28, 2025
Nov 28, 2024
Feb 28, 2025
Feb 28, 2025
Sep 5, 2024
Mar 5, 2024
Feb 10, 2025
Apr 26, 2024
Apr 26, 2024
Apr 25, 2023
Sep 26, 2024
Sep 14, 2023
Dec 2, 2024
Apr 26, 2024
Dec 4, 2024
Feb 13, 2025
Sep 26, 2024

Repository files navigation

Charm Relation Interfaces

A catalogue of opinionated and standardized interface specifications for charmed operator relations.

Matrix badge

Purpose

The purpose of the repository is to outline the behavior and requirements for key interface names, ensuring that charms claiming to implement a certain interface actually are capable of being integrated with each other.

Contributing

Contributing a new interface specification is a lightweight process.

Interfaces

For the time being, to see available interfaces, their statuses, and schemas, browse the interfaces directory.

Relation interface testers

In order to automatically validate whether a charm satisfies a given relation interface, the relation interface maintainer(s) need to write one or more relation interface tests. A relation interface test is a scenario-based test case which checks that, given an initial context, when a relation event is triggered, the charm will do what the interface specifies. For example, most interface testers will check that, on relation changed, the charm will write a certain value into its (app/unit) databag and that that value matches a certain (Pydantic) schema.

See the tester documentation for more.

About

Opinionated and standardized interface specifications for charmed operator relations.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%