#1677 otiotool verify ranges

src/py-opentimelineio/opentimelineio/console/otiotool.py

@@ -137,7 +137,8 @@ def main():
  args.list_media or
  args.verify_media or
  args.list_tracks or
- args.list_markers)
+ args.list_markers or
+ args.verify_ranges)
  if should_summarize:
  for timeline in timelines:
  summarize_timeline(
@@ -146,6 +147,7 @@ def main():
  args.list_media,
  args.verify_media,
  args.list_markers,
+ args.verify_ranges,
  timeline)
 
  # Final Phase: Output
@@ -207,8 +209,8 @@ def parse_arguments():
 
 6. Inspect
  Options such as --stats, --list-clips, --list-tracks, --list-media,
- --verify-media, --list-markers, and --inspect will examine the OTIO and
- print information to standard output.
+ --verify-media, --list-markers, --verify-ranges, and --inspect
+ will examine the OTIO and print information to standard output.
 
 7. Output
  Finally, if the "--output <filename>" option is specified, the resulting
@@ -397,6 +399,12 @@ def parse_arguments():
  action='store_true',
  help="List summary of all markers"
  )
+ parser.add_argument(
+ "--verify-ranges",
+ action='store_true',
+ help="""Verify that each clip in a timeline has a source range
+ within the available range of media"""
+ )
  parser.add_argument(
  "--inspect",
  type=str,
@@ -852,7 +860,7 @@ def inspect_timelines(name_regex, timeline):
 
 
 def summarize_timeline(list_tracks, list_clips, list_media, verify_media,
- list_markers, timeline):
+ list_markers, verify_ranges, timeline):
  """Print a summary of a timeline, optionally listing the tracks, clips, media,
  and/or markers inside it."""
  print("TIMELINE:", timeline.name)
@@ -861,8 +869,29 @@ def summarize_timeline(list_tracks, list_clips, list_media, verify_media,
  if list_tracks:
  print(f"TRACK: {child.name} ({child.kind})")
  if isinstance(child, otio.schema.Clip):
- if list_clips:
- print(" CLIP:", child.name)
+ if list_clips or verify_ranges:
+ if verify_ranges:
+ range_msg = ""
+ try:
+ source = child.source_range
+ available = child.available_range()
+
+ src_start = source.start_time.value
+ src_dur = source.duration.value
+ avail_start = available.start_time.value
+ avail_dur = available.duration.value
+
+ starts_early = src_start < avail_start
+ ends_late = (src_dur - src_start) > (avail_dur - avail_start)
+ if starts_early or ends_late:
+ range_msg = "SOURCE MEDIA OUT OF BOUNDS"
+ else:
+ range_msg = "IN BOUNDS"
+ except Exception: # available range is, well, unavailable
+ pass
+ print(" CLIP:", child.name, range_msg)
+ else:
+ print(" CLIP:", child.name)
  if list_media or verify_media:
  try:
  url = child.media_reference.target_url