Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add versioning traits/specifications #51

Merged
merged 5 commits into from
Aug 3, 2023

Conversation

foundrytom
Copy link
Contributor

Part of #48, examples will come separately.

Not saying this is the best solution, but it is the easy one to maintain
for now.

Signed-off-by: Tom Cowland <[email protected]>
Ensures that we're not inadvertently hard-wrapping docstrings and such
in the wrong places. Many YAML is confusing in this respect.

Signed-off-by: Tom Cowland <[email protected]>
@foundrytom foundrytom self-assigned this Jul 19, 2023
@foundrytom foundrytom requested a review from a team as a code owner July 19, 2023 13:06
@foundrytom foundrytom changed the title Add versioning traits/specification Add versioning traits/specifications Jul 19, 2023
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Show resolved Hide resolved
Copy link
Member

@feltech feltech left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WIP review, haven't gone through it all yet

traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Show resolved Hide resolved
@foundrytom
Copy link
Contributor Author

@feltech updated the name of tag to specifiedTag here.

@foundrytom foundrytom requested a review from feltech August 3, 2023 12:25
Copy link
Member

@feltech feltech left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a few typos, otherwise LGTM

traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
traits.yml Outdated Show resolved Hide resolved
Adds traits and specifications that can be used to replicate the old
"versioning" API methods from the core API. These were recently removed
in favour of domain specific definitions such as these.

We opted to add base traits for 'usage' to the package. These should be
composed with the other relevant traits when defining a specification to
allow runtime introspection of the trait set. Amongst other uses, this
helps managers in their implementation of methods such as
`managementPolicy` where they need to be able to determine the nature of
the query.

For relationships, this also adds traits that define the expected
cardinality of the result references. This helps inform a host whether
they should be using the paged API methods.

Part of OpenAssetIO#48

Signed-off-by: Tom Cowland <[email protected]>
@foundrytom foundrytom merged commit b20b012 into OpenAssetIO:main Aug 3, 2023
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants