Skip to content

Conversation

jminor
Copy link
Collaborator

@jminor jminor commented Aug 15, 2025

The otiotool command line utility has no documentation aside from it's built-in usage statement. This PR adds a documentation page with detailed examples and explanations. This PR also makes a minor improvement to the otiotool command line argument validation & usage statement.

@codecov-commenter
Copy link

codecov-commenter commented Aug 15, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 84.99%. Comparing base (c0e97b0) to head (1e2db8c).
⚠️ Report is 64 commits behind head on main.

❌ Your changes status has failed because you have indirect coverage changes. Learn more about Unexpected Coverage Changes and reasons for indirect coverage changes.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main    #1921      +/-   ##
==========================================
+ Coverage   84.11%   84.99%   +0.87%     
==========================================
  Files         198      181      -17     
  Lines       22241    13070    -9171     
  Branches     4687     1206    -3481     
==========================================
- Hits        18709    11109    -7600     
+ Misses       2610     1778     -832     
+ Partials      922      183     -739     
Flag Coverage Δ
py-unittests 84.99% <100.00%> (+0.87%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines Coverage Δ
...-opentimelineio/opentimelineio/console/otiotool.py 65.72% <100.00%> (-0.59%) ⬇️

... and 138 files with indirect coverage changes


Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 1b3ece1...1e2db8c. Read the comment docs.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@jminor
Copy link
Collaborator Author

jminor commented Aug 15, 2025

Hmmm.. How do I link to an anchor within a relative page?

/home/runner/work/OpenTimelineIO/OpenTimelineIO/docs/tutorials/otiotool.md:7: WARNING: 'myst' reference target not found: ./quickstart#install-otio]

Signed-off-by: Joshua Minor <[email protected]>
@jminor jminor merged commit 6b9d292 into AcademySoftwareFoundation:main Aug 19, 2025
47 checks passed
luzpaz pushed a commit to luzpaz/OpenTimelineIO that referenced this pull request Sep 10, 2025
* Added otiotool tutorial documentation
* Improved otiotool usage & argument validation

Signed-off-by: Joshua Minor <[email protected]>
Signed-off-by: luzpaz <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants