GH-6 Version Labels

[bosschaert]

Description

Make it possible to provide a version display name on the initial version POST/PUT.

Related Issue

6

How Has This Been Tested?

• Tested locally with da-collab and da-live
• Unit tests for all changes

Types of changes

• [X] Bug fix (non-breaking change which fixes an issue)
• [ ] New feature (non-breaking change which adds functionality)
• [ ] Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

• [X] I have signed the Adobe Open Source CLA.
• [X] My code follows the code style of this project.
• [ ] My change requires a change to the documentation.
• [ ] I have updated the documentation accordingly.
• [X] I have read the CONTRIBUTING document.
• [X] I have added tests to cover my changes.
• [X] All new and existing tests passed.

Release notes

1. Ability to add a label to a version upon creation.

Additional context

Version labels provide a humane context to what a version represents. They can also be helpful for larger larger content projects. Changes happen over a series of days, weeks, or even months. This disjointed nature of content creation makes snapshot-style versions difficult to impossible to use. Being able to label versions provides a way to say in human terms, "rollback to a pre-Adobe MAX 2024 state."

DA Admin is built on top of object storage technologies. This provides a no-nonsense approach to data storage, but it lacks the granular nature of something like a NoSQL database. Object storage metadata is also immutable. What this effectively means is that if you want to update metadata, you must re-write the entire file. Moving version label creation to the POST handler ensures that we can perform one operation to create the version and label.

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 79.56%. Comparing base (8eabefd) to head (fd8357d).

Additional details and impacted files

```diff @@ Coverage Diff @@ ## main #38 +/- ## ========================================== + Coverage 77.03% 79.56% +2.52% ========================================== Files 14 14 Lines 897 915 +18 ========================================== + Hits 691 728 +37 + Misses 206 187 -19 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

[bosschaert]

Thanks @auniverseaway I agree label is better so I changed it to that and also added comment.

[auniverseaway]

@bosschaert I approved, but I would remove the comment part. I wouldn't build that out until someone asks for it. Label should do for the foreseeable future and we can always add comment back in later.