31 Commits

Author SHA1 Message Date
Jamie Hardt
6da04b2c07 Nudged version 2025-01-07 11:52:26 -08:00
Jamie Hardt
89b6cde808 Merge pull request #12 from iluvcapra/feat-adobe
Added support for Adobe Premiere EDLs > 999 events
2025-01-07 11:49:54 -08:00
Jamie Hardt
5e4dde5aa2 Merge branch 'master' of https://github.com/iluvcapra/pycmx into feat-adobe 2025-01-05 22:34:30 -08:00
Jamie Hardt
b6379ec1fe tweaking doc version method 2025-01-05 12:44:03 -08:00
Jamie Hardt
04731d634f Updated version read logic 2025-01-05 12:37:56 -08:00
Jamie Hardt
2dcfdabf01 Merge branch 'master' of https://github.com/iluvcapra/pycmx into feat-adobe 2025-01-05 12:26:03 -08:00
Jamie Hardt
7ed423deaf Dropping max-complexity argument 2025-01-05 12:19:22 -08:00
Jamie Hardt
2be779fe53 Flake8 for docs, test, bin 2025-01-05 12:16:16 -08:00
Jamie Hardt
2adff6dd01 Flake8 lints, flake8 linting fully activated. 2025-01-05 12:03:38 -08:00
Jamie Hardt
7871acdfd0 Merge branch 'master' of https://github.com/iluvcapra/pycmx into feat-adobe 2025-01-05 11:33:57 -08:00
Jamie Hardt
8bb6dad1da Some documentation and autopep 2025-01-05 11:32:23 -08:00
Jamie Hardt
f88b82e8fb README updated 2025-01-05 10:47:57 -08:00
Jamie Hardt
a86ef7ed2e Added support for Adobe Premiere EDLs > 999 events 2025-01-04 13:20:21 -08:00
Jamie Hardt
1e1331eadb Adding a test case for #11 2025-01-02 22:07:20 -08:00
Jamie Hardt
7a0481dbf9 Update bsky_test.yml 2024-11-26 11:50:10 -08:00
Jamie Hardt
20ad04e862 Update bsky_test.yml 2024-11-26 11:43:39 -08:00
Jamie Hardt
9e54aa5fcf Update bsky_test.yml 2024-11-26 11:34:16 -08:00
Jamie Hardt
71aff9baf7 Update bsky_test.yml 2024-11-26 11:33:37 -08:00
Jamie Hardt
ab55cab160 Create bsky_test.yml 2024-11-26 11:29:43 -08:00
Jamie Hardt
a717589683 Bumped version and tweaked Bluesky message 2024-11-26 11:19:01 -08:00
Jamie Hardt
f48c164e1b Merge pull request #10 from iluvcapra/maint-poetry
Sprucing-up Build System and Workflows
2024-11-26 11:17:10 -08:00
Jamie Hardt
be1dc99e94 Update pyproject.toml
Fixed typo
2024-11-26 11:16:33 -08:00
Jamie Hardt
fbdfcddfff Re-activated Bluesky posting
Updated classifiers in pyproject.toml
2024-11-26 11:15:08 -08:00
Jamie Hardt
156828b648 Update pythonpublish.yml 2024-11-26 11:11:25 -08:00
Jamie Hardt
1894a143b1 Removed second dependencies block 2024-11-26 11:02:53 -08:00
Jamie Hardt
c0d278e079 Removing 3.7 support 2024-11-26 11:01:49 -08:00
Jamie Hardt
7d3a58bff8 Small change 2024-11-26 10:57:01 -08:00
Jamie Hardt
f1381f5f46 Merge branch 'maint-poetry' of https://github.com/iluvcapra/pycmx into maint-poetry 2024-11-26 10:54:37 -08:00
Jamie Hardt
dc00b52b61 Merge branch 'master' of https://github.com/iluvcapra/pycmx into maint-poetry 2024-11-26 10:53:39 -08:00
Jamie Hardt
571ffdefd7 Merge branch 'master' into maint-poetry 2024-11-26 10:52:55 -08:00
Jamie Hardt
a79cb02139 Updating workflows
Added 3.13 support, publish to Bluesky, Poetry build system
2024-11-26 10:50:38 -08:00
19 changed files with 14364 additions and 348 deletions

5
.flake8 Normal file
View File

@@ -0,0 +1,5 @@
[flake8]
per-file-ignores =
pycmx/__init__.py: F401
tests/__init__.py: F401

25
.github/workflows/bsky_test.yml vendored Normal file
View File

@@ -0,0 +1,25 @@
name: Test Post to Bluesky
on:
workflow_dispatch:
# permissions:
# contents: read
# id-token: write
jobs:
deploy:
runs-on: ubuntu-latest
environment:
name: release
steps:
- name: Send Bluesky Post
uses: myConsciousness/bluesky-post@v5
with:
text: |
This is a test post!
link-preview-url: ${{ github.server_url }}/${{ github.repository }}
identifier: ${{ secrets.BLUESKY_APP_USER }}
password: ${{ secrets.BLUESKY_APP_PASSWORD }}
service: bsky.social
retry-count: 1

View File

@@ -16,8 +16,7 @@ jobs:
strategy: strategy:
fail-fast: false fail-fast: false
matrix: matrix:
python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12"] python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
steps: steps:
- uses: actions/checkout@v3 - uses: actions/checkout@v3
- name: Set up Python ${{ matrix.python-version }} - name: Set up Python ${{ matrix.python-version }}
@@ -28,14 +27,12 @@ jobs:
run: | run: |
python -m pip install --upgrade pip python -m pip install --upgrade pip
python -m pip install flake8 pytest python -m pip install flake8 pytest
python3 -m pip install -e . python -m pip install -e .
# if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
- name: Lint with flake8 - name: Lint with flake8
run: | run: |
# stop the build if there are Python syntax errors or undefined names # stop the build if there are Python syntax errors or undefined names
flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
# exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide flake8 . --count --max-line-length=79 --statistics
flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
- name: Test with pytest - name: Test with pytest
run: | run: |
pytest pytest

View File

@@ -3,7 +3,6 @@ name: Upload Python Package
on: on:
release: release:
types: [published] types: [published]
workflow_dispatch:
permissions: permissions:
contents: read contents: read
@@ -15,9 +14,9 @@ jobs:
environment: environment:
name: release name: release
steps: steps:
- uses: actions/checkout@v3.5.2 - uses: actions/checkout@v4.2.2
- name: Set up Python - name: Set up Python
uses: actions/setup-python@v4.6.0 uses: actions/setup-python@v5.3.0
with: with:
python-version: '3.x' python-version: '3.x'
- name: Install dependencies - name: Install dependencies
@@ -25,16 +24,19 @@ jobs:
python -m pip install --upgrade pip python -m pip install --upgrade pip
pip install build pip install build
- name: Build package - name: Build package
run: python -m build run: python -m build .
- name: pypi-publish - name: Publish to Pypi
uses: pypa/gh-action-pypi-publish@v1.8.6 uses: pypa/gh-action-pypi-publish@v1.12.2
- name: Report to Mastodon
uses: cbrgm/mastodon-github-action@v1.0.1
with: with:
message: | password: ${{ secrets.PYPI_APIKEY }}
I just released a new version of pycmx, my library for reading CMX EDLs! - name: Send Bluesky Post
#sounddesign #filmmaking #python uses: myConsciousness/bluesky-post@v5
${{ github.server_url }}/${{ github.repository }} with:
env: text: |
MASTODON_URL: ${{ secrets.MASTODON_URL }} I've released a new version of pycmx, my python module for
MASTODON_ACCESS_TOKEN: ${{ secrets.MASTODON_ACCESS_TOKEN }} reading CMX EDLs.
link-preview-url: ${{ github.server_url }}/${{ github.repository }}
identifier: ${{ secrets.BLUESKY_APP_USER }}
password: ${{ secrets.BLUESKY_APP_PASSWORD }}
service: bsky.social
retry-count: 1

View File

@@ -5,12 +5,14 @@
# pycmx # pycmx
The `pycmx` package provides a basic interface for parsing a CMX 3600 EDL and its most most common variations. The `pycmx` package provides a basic interface for parsing a CMX 3600 EDL and
its most most common variations.
## Features ## Features
* The major variations of the CMX 3600: the standard, "File32" and "File128" * The major variations of the CMX 3600: the standard, "File32", "File128" and
formats are automatically detected and properly read. long Adobe Premiere event numbers are automatically detected and properly
read.
* Preserves relationship between events and individual edits/clips. * Preserves relationship between events and individual edits/clips.
* Remark or comment fields with common recognized forms are read and * Remark or comment fields with common recognized forms are read and
available to the client, including clip name and source file data. available to the client, including clip name and source file data.
@@ -83,5 +85,3 @@ Audio channel 7 is present
>>> events[2].edits[0].channels.video >>> events[2].edits[0].channels.video
False False
``` ```

View File

@@ -12,6 +12,7 @@ logging.basicConfig(format=FORMAT)
log = logging.getLogger(__name__) log = logging.getLogger(__name__)
def all_video_edits(edl): def all_video_edits(edl):
for event in edl.events: for event in edl.events:
for edit in event.edits: for edit in event.edits:
@@ -30,19 +31,22 @@ def get_scene_name(edit, pattern):
else: else:
return edit.clip_name return edit.clip_name
def output_cmx(outfile, out_list): def output_cmx(outfile, out_list):
outfile.write("TITLE: SCENE LIST\r\n") outfile.write("TITLE: SCENE LIST\r\n")
outfile.write("FCM: NON-DROP FRAME\r\n") outfile.write("FCM: NON-DROP FRAME\r\n")
for o in out_list: for i, o in enumerate(out_list):
line = "%03i AX V C 00:00:00:00 00:00:00:00 %s %s\r\n" % (0, o['start'],o['end']) line = '%03i AX V C ' % (i)
line += '00:00:00:00 00:00:00:00 %s %s\r\n' % (o['start'], o['end'])
outfile.write(line) outfile.write(line)
outfile.write("* FROM CLIP NAME: %s\r\n" % (o['scene'])) outfile.write("* FROM CLIP NAME: %s\r\n" % (o['scene']))
def output_cols(outfile, out_list): def output_cols(outfile, out_list):
for o in out_list: for o in out_list:
outfile.write("%-12s\t%-12s\t%s\n" % (o['start'], o['end'], o['scene'] )) outfile.write("%-12s\t%-12s\t%s\n" %
(o['start'], o['end'], o['scene']))
def scene_list(infile, outfile, out_format, pattern): def scene_list(infile, outfile, out_format, pattern):
@@ -80,22 +84,28 @@ def scene_list(infile, outfile, out_format, pattern):
def scene_list_cli(): def scene_list_cli():
parser = argparse.ArgumentParser(description= parser = argparse.ArgumentParser(
'Read video events from an input CMX EDL and output events merged into scenes.') description='Read video events from an input CMX EDL and output '
parser.add_argument('-o','--outfile', default=sys.stdout, type=argparse.FileType('w'), 'events merged into scenes.')
parser.add_argument('-o', '--outfile', default=sys.stdout,
type=argparse.FileType('w'),
help='Output file. Default is stdout.') help='Output file. Default is stdout.')
parser.add_argument('-f', '--format', default='cmx', type=str, parser.add_argument('-f', '--format', default='cmx', type=str,
help='Output format. Options are cols and cmx, cmx is the default.') help='Output format. Options are cols and cmx, cmx '
'is the default.')
parser.add_argument('-p', '--pattern', default='V?([A-Z]*[0-9]+)', parser.add_argument('-p', '--pattern', default='V?([A-Z]*[0-9]+)',
help='RE pattern for extracting scene name from clip name. The default is "V?([A-Z]*[0-9]+)". ' + \ help='RE pattern for extracting scene name from clip '
'name. The default is "V?([A-Z]*[0-9]+)". ' +
'This pattern will be matched case-insensitively.') 'This pattern will be matched case-insensitively.')
parser.add_argument('input_edl', default=sys.stdin, type=argparse.FileType('r'), nargs='?', parser.add_argument('input_edl', default=sys.stdin,
type=argparse.FileType('r'), nargs='?',
help='Input file. Default is stdin.') help='Input file. Default is stdin.')
args = parser.parse_args() args = parser.parse_args()
infile = args.input_edl infile = args.input_edl
scene_list(infile=infile, outfile=args.outfile , out_format=args.format, pattern=args.pattern) scene_list(infile=infile, outfile=args.outfile,
out_format=args.format, pattern=args.pattern)
if __name__ == '__main__': if __name__ == '__main__':

View File

@@ -12,22 +12,22 @@
# add these directories to sys.path here. If the directory is relative to the # add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here. # documentation root, use os.path.abspath to make it absolute, like shown here.
# #
import importlib
import os import os
import sys import sys
sys.path.insert(0, os.path.abspath('../..')) sys.path.insert(0, os.path.abspath('../..'))
import pycmx
# -- Project information ----------------------------------------------------- # -- Project information -----------------------------------------------------
project = u'pycmx' project = u'pycmx'
copyright = u'(c) 2023, Jamie Hardt' copyright = u'(c) 2025, Jamie Hardt'
author = u'Jamie Hardt' author = u'Jamie Hardt'
release = importlib.metadata.version("pycmx")
version = release
# The short X.Y version # The short X.Y version
version = pycmx.__version__
# The full version, including alpha/beta/rc tags # The full version, including alpha/beta/rc tags
release = pycmx.__version__
# -- General configuration --------------------------------------------------- # -- General configuration ---------------------------------------------------

View File

@@ -2,13 +2,11 @@
""" """
pycmx is a parser for CMX 3600-style EDLs. pycmx is a parser for CMX 3600-style EDLs.
This module (c) 2023 Jamie Hardt. For more information on your rights to This module (c) 2025 Jamie Hardt. For more information on your rights to
copy and reuse this software, refer to the LICENSE file included with the copy and reuse this software, refer to the LICENSE file included with the
distribution. distribution.
""" """
__version__ = '1.2.2'
from .parse_cmx_events import parse_cmx3600 from .parse_cmx_events import parse_cmx3600
from .transition import Transition from .transition import Transition
from .event import Event from .event import Event

View File

@@ -4,6 +4,7 @@
from re import (compile, match) from re import (compile, match)
from typing import Dict, Tuple, Generator from typing import Dict, Tuple, Generator
class ChannelMap: class ChannelMap:
""" """
Represents a set of all the channels to which an event applies. Represents a set of all the channels to which an event applies.
@@ -110,4 +111,3 @@ class ChannelMap:
out_a = self._audio_channel_set | other._audio_channel_set out_a = self._audio_channel_set | other._audio_channel_set
return ChannelMap(v=out_v, audio_channels=out_a) return ChannelMap(v=out_v, audio_channels=out_a)

View File

@@ -7,12 +7,16 @@ from .channel_map import ChannelMap
from typing import Optional from typing import Optional
class Edit: class Edit:
""" """
An individual source-to-record operation, with a source roll, source and An individual source-to-record operation, with a source roll, source and
recorder timecode in and out, a transition and channels. recorder timecode in and out, a transition and channels.
""" """
def __init__(self, edit_statement, audio_ext_statement, clip_name_statement, source_file_statement, trans_name_statement = None):
def __init__(self, edit_statement, audio_ext_statement,
clip_name_statement, source_file_statement,
trans_name_statement=None):
self.edit_statement = edit_statement self.edit_statement = edit_statement
self.audio_ext = audio_ext_statement self.audio_ext = audio_ext_statement
self.clip_name_statement = clip_name_statement self.clip_name_statement = clip_name_statement
@@ -35,7 +39,7 @@ class Edit:
""" """
cm = ChannelMap() cm = ChannelMap()
cm._append_event(self.edit_statement.channels) cm._append_event(self.edit_statement.channels)
if self.audio_ext != None: if self.audio_ext is not None:
cm._append_ext(self.audio_ext) cm._append_ext(self.audio_ext)
return cm return cm
@@ -45,9 +49,12 @@ class Edit:
Get the :obj:`Transition` object associated with this edit. Get the :obj:`Transition` object associated with this edit.
""" """
if self.trans_name_statement: if self.trans_name_statement:
return Transition(self.edit_statement.trans, self.edit_statement.trans_op, self.trans_name_statement.name) return Transition(self.edit_statement.trans,
self.edit_statement.trans_op,
self.trans_name_statement.name)
else: else:
return Transition(self.edit_statement.trans, self.edit_statement.trans_op, None) return Transition(self.edit_statement.trans,
self.edit_statement.trans_op, None)
@property @property
def source_in(self) -> str: def source_in(self) -> str:
@@ -124,5 +131,3 @@ class Edit:
return None return None
else: else:
return self.clip_name_statement.name return self.clip_name_statement.name

View File

@@ -1,16 +1,20 @@
# pycmx # pycmx
# (c) 2018 Jamie Hardt # (c) 2018 Jamie Hardt
from .parse_cmx_statements import (StmtUnrecognized, StmtFCM, StmtEvent, StmtSourceUMID) from .parse_cmx_statements import (
StmtUnrecognized, StmtEvent, StmtSourceUMID)
from .event import Event from .event import Event
from .channel_map import ChannelMap from .channel_map import ChannelMap
from typing import Generator from typing import Generator
class EditList: class EditList:
""" """
Represents an entire edit decision list as returned by :func:`~pycmx.parse_cmx3600()`. Represents an entire edit decision list as returned by
:func:`~pycmx.parse_cmx3600()`.
""" """
def __init__(self, statements): def __init__(self, statements):
self.title_statement = statements[0] self.title_statement = statements[0]
self.event_statements = statements[1:] self.event_statements = statements[1:]
@@ -20,8 +24,11 @@ class EditList:
""" """
The detected format of the EDL. Possible values are: "3600", "File32", The detected format of the EDL. Possible values are: "3600", "File32",
"File128", and "unknown". "File128", and "unknown".
Adobe EDLs with more than 999 events will be reported as "3600".
""" """
first_event = next( (s for s in self.event_statements if type(s) is StmtEvent), None) first_event = next(
(s for s in self.event_statements if type(s) is StmtEvent), None)
if first_event: if first_event:
if first_event.format == 8: if first_event.format == 8:
@@ -35,7 +42,6 @@ class EditList:
else: else:
return 'unknown' return 'unknown'
@property @property
def channels(self) -> ChannelMap: def channels(self) -> ChannelMap:
""" """
@@ -49,7 +55,6 @@ class EditList:
return retval return retval
@property @property
def title(self) -> str: def title(self) -> str:
""" """
@@ -57,9 +62,9 @@ class EditList:
""" """
return self.title_statement.title return self.title_statement.title
@property @property
def unrecognized_statements(self) -> Generator[StmtUnrecognized, None, None]: def unrecognized_statements(self) -> Generator[StmtUnrecognized,
None, None]:
""" """
A generator for all the unrecognized statements in the list. A generator for all the unrecognized statements in the list.
""" """
@@ -67,17 +72,13 @@ class EditList:
if type(s) is StmtUnrecognized: if type(s) is StmtUnrecognized:
yield s yield s
@property @property
def events(self) -> Generator[Event, None, None]: def events(self) -> Generator[Event, None, None]:
'A generator for all the events in the edit list' 'A generator for all the events in the edit list'
is_drop = None
current_event_num = None current_event_num = None
event_statements = [] event_statements = []
for stmt in self.event_statements: for stmt in self.event_statements:
if type(stmt) is StmtFCM: if type(stmt) is StmtEvent:
is_drop = stmt.drop
elif type(stmt) is StmtEvent:
if current_event_num is None: if current_event_num is None:
current_event_num = stmt.event current_event_num = stmt.event
event_statements.append(stmt) event_statements.append(stmt)
@@ -105,5 +106,3 @@ class EditList:
for stmt in self.event_statements: for stmt in self.event_statements:
if type(stmt) is StmtSourceUMID: if type(stmt) is StmtSourceUMID:
yield stmt yield stmt

View File

@@ -1,15 +1,18 @@
# pycmx # pycmx
# (c) 2023 Jamie Hardt # (c) 2023 Jamie Hardt
from .parse_cmx_statements import (StmtEvent, StmtClipName, StmtSourceFile, StmtAudioExt, StmtUnrecognized, StmtEffectsName) from .parse_cmx_statements import (
StmtEvent, StmtClipName, StmtSourceFile, StmtAudioExt, StmtUnrecognized,
StmtEffectsName)
from .edit import Edit from .edit import Edit
from typing import List, Generator, Optional, Tuple, Any from typing import List, Generator, Optional, Tuple, Any
class Event: class Event:
""" """
Represents a collection of :class:`~pycmx.edit.Edit` s, all with the same event number. Represents a collection of :class:`~pycmx.edit.Edit` s, all with the same
""" event number. """
def __init__(self, statements): def __init__(self, statements):
self.statements = statements self.statements = statements
@@ -71,10 +74,12 @@ class Event:
audio_ext_statement=e1[1], audio_ext_statement=e1[1],
clip_name_statement=n1, clip_name_statement=n1,
source_file_statement=s1, source_file_statement=s1,
trans_name_statement=u1) for (e1,n1,s1,u1) in zip(*the_zip) ] trans_name_statement=u1)
for (e1, n1, s1, u1) in zip(*the_zip)]
@property @property
def unrecognized_statements(self) -> Generator[StmtUnrecognized, None, None]: def unrecognized_statements(self) -> Generator[StmtUnrecognized, None,
None]:
""" """
A generator for all the unrecognized statements in the event. A generator for all the unrecognized statements in the event.
""" """
@@ -94,11 +99,10 @@ class Event:
def _source_file_statements(self) -> List[StmtSourceFile]: def _source_file_statements(self) -> List[StmtSourceFile]:
return [s for s in self.statements if type(s) is StmtSourceFile] return [s for s in self.statements if type(s) is StmtSourceFile]
def _statements_with_audio_ext(self) -> Generator[Tuple[StmtEvent, Optional[StmtAudioExt]], None, None]: def _statements_with_audio_ext(self) -> Generator[
Tuple[StmtEvent, Optional[StmtAudioExt]], None, None]:
for (s1, s2) in zip(self.statements, self.statements[1:]): for (s1, s2) in zip(self.statements, self.statements[1:]):
if type(s1) is StmtEvent and type(s2) is StmtAudioExt: if type(s1) is StmtEvent and type(s2) is StmtAudioExt:
yield (s1, s2) yield (s1, s2)
elif type(s1) is StmtEvent: elif type(s1) is StmtEvent:
yield (s1, None) yield (s1, None)

View File

@@ -8,13 +8,13 @@ from .edit_list import EditList
from typing import TextIO from typing import TextIO
def parse_cmx3600(f: TextIO):
def parse_cmx3600(f: TextIO) -> EditList:
""" """
Parse a CMX 3600 EDL. Parse a CMX 3600 EDL.
:param TextIO f: a file-like object, anything that's readlines-able. :param TextIO f: a file-like object, an opened CMX 3600 .EDL file.
:returns: An :class:`pycmx.edit_list.EditList`. :returns: An :class:`pycmx.edit_list.EditList`.
""" """
statements = parse_cmx3600_statements(f) statements = parse_cmx3600_statements(f)
return EditList(statements) return EditList(statements)

View File

@@ -2,9 +2,7 @@
# (c) 2018 Jamie Hardt # (c) 2018 Jamie Hardt
import re import re
import sys
from collections import namedtuple from collections import namedtuple
from itertools import count
from typing import TextIO, List from typing import TextIO, List
@@ -12,8 +10,10 @@ from .util import collimate
StmtTitle = namedtuple("Title", ["title", "line_number"]) StmtTitle = namedtuple("Title", ["title", "line_number"])
StmtFCM = namedtuple("FCM", ["drop", "line_number"]) StmtFCM = namedtuple("FCM", ["drop", "line_number"])
StmtEvent = namedtuple("Event",["event","source","channels","trans",\ StmtEvent = namedtuple("Event", ["event", "source", "channels", "trans",
"trans_op","source_in","source_out","record_in","record_out","format","line_number"]) "trans_op", "source_in", "source_out",
"record_in", "record_out", "format",
"line_number"])
StmtAudioExt = namedtuple("AudioExt", ["audio3", "audio4", "line_number"]) StmtAudioExt = namedtuple("AudioExt", ["audio3", "audio4", "line_number"])
StmtClipName = namedtuple("ClipName", ["name", "affect", "line_number"]) StmtClipName = namedtuple("ClipName", ["name", "affect", "line_number"])
StmtSourceFile = namedtuple("SourceFile", ["filename", "line_number"]) StmtSourceFile = namedtuple("SourceFile", ["filename", "line_number"])
@@ -21,7 +21,8 @@ StmtRemark = namedtuple("Remark",["text","line_number"])
StmtEffectsName = namedtuple("EffectsName", ["name", "line_number"]) StmtEffectsName = namedtuple("EffectsName", ["name", "line_number"])
StmtSourceUMID = namedtuple("Source", ["name", "umid", "line_number"]) StmtSourceUMID = namedtuple("Source", ["name", "umid", "line_number"])
StmtSplitEdit = namedtuple("SplitEdit", ["video", "magnitude", "line_number"]) StmtSplitEdit = namedtuple("SplitEdit", ["video", "magnitude", "line_number"])
StmtMotionMemory = namedtuple("MotionMemory",["source","fps"]) # FIXME needs more fields StmtMotionMemory = namedtuple(
"MotionMemory", ["source", "fps"]) # FIXME needs more fields
StmtUnrecognized = namedtuple("Unrecognized", ["content", "line_number"]) StmtUnrecognized = namedtuple("Unrecognized", ["content", "line_number"])
@@ -30,11 +31,11 @@ def parse_cmx3600_statements(file: TextIO) -> List[object]:
Return a list of every statement in the file argument. Return a list of every statement in the file argument.
""" """
lines = file.readlines() lines = file.readlines()
line_numbers = count() return [_parse_cmx3600_line(line.strip(), line_number)
return [_parse_cmx3600_line(line.strip(), line_number) \ for (line_number, line) in enumerate(lines)]
for (line, line_number) in zip(lines,line_numbers)]
def _edl_column_widths(event_field_length, source_field_length):
def _edl_column_widths(event_field_length, source_field_length) -> List[int]:
return [event_field_length, 2, source_field_length, 1, return [event_field_length, 2, source_field_length, 1,
4, 2, # chans 4, 2, # chans
4, 1, # trans 4, 1, # trans
@@ -44,28 +45,39 @@ def _edl_column_widths(event_field_length, source_field_length):
11, 1, 11, 1,
11] 11]
def _edl_m2_column_widths(): # def _edl_m2_column_widths():
return [2, # "M2" # return [2, # "M2"
3,3, # # 3,3, #
8,8,1,4,2,1,4,13,3,1,1] # 8,8,1,4,2,1,4,13,3,1,1]
def _parse_cmx3600_line(line, line_number): def _parse_cmx3600_line(line: str, line_number: int) -> object:
"""
Parses a single CMX EDL line.
:param line: A single EDL line.
:param line_number: The index of this line in the file.
"""
long_event_num_p = re.compile("^[0-9]{6} ") long_event_num_p = re.compile("^[0-9]{6} ")
short_event_num_p = re.compile("^[0-9]{3} ") short_event_num_p = re.compile("^[0-9]{3} ")
x_event_form_p = re.compile("^([0-9]{4,5}) ")
if isinstance(line,str):
if line.startswith("TITLE:"): if line.startswith("TITLE:"):
return _parse_title(line, line_number) return _parse_title(line, line_number)
elif line.startswith("FCM:"): elif line.startswith("FCM:"):
return _parse_fcm(line, line_number) return _parse_fcm(line, line_number)
elif long_event_num_p.match(line) != None: elif long_event_num_p.match(line) is not None:
length_file_128 = sum(_edl_column_widths(6, 128)) length_file_128 = sum(_edl_column_widths(6, 128))
if len(line) < length_file_128: if len(line) < length_file_128:
return _parse_long_standard_form(line, 32, line_number) return _parse_long_standard_form(line, 32, line_number)
else: else:
return _parse_long_standard_form(line, 128, line_number) return _parse_long_standard_form(line, 128, line_number)
elif short_event_num_p.match(line) != None: elif (m := x_event_form_p.match(line)) is not None:
assert m is not None
event_field_length = len(m[1])
return _parse_columns_for_standard_form(line, event_field_length,
8, line_number)
elif short_event_num_p.match(line) is not None:
return _parse_standard_form(line, line_number) return _parse_standard_form(line, line_number)
elif line.startswith("AUD"): elif line.startswith("AUD"):
return _parse_extended_audio_channels(line, line_number) return _parse_extended_audio_channels(line, line_number)
@@ -83,23 +95,28 @@ def _parse_cmx3600_line(line, line_number):
return _parse_unrecognized(line, line_number) return _parse_unrecognized(line, line_number)
def _parse_title(line, line_num): def _parse_title(line, line_num) -> StmtTitle:
title = line[6:].strip() title = line[6:].strip()
return StmtTitle(title=title, line_number=line_num) return StmtTitle(title=title, line_number=line_num)
def _parse_fcm(line, line_num):
def _parse_fcm(line, line_num) -> StmtFCM:
val = line[4:].strip() val = line[4:].strip()
if val == "DROP FRAME": if val == "DROP FRAME":
return StmtFCM(drop=True, line_number=line_num) return StmtFCM(drop=True, line_number=line_num)
else: else:
return StmtFCM(drop=False, line_number=line_num) return StmtFCM(drop=False, line_number=line_num)
def _parse_long_standard_form(line, source_field_length, line_number): def _parse_long_standard_form(line, source_field_length, line_number):
return _parse_columns_for_standard_form(line, 6, source_field_length, line_number) return _parse_columns_for_standard_form(line, 6, source_field_length,
line_number)
def _parse_standard_form(line, line_number): def _parse_standard_form(line, line_number):
return _parse_columns_for_standard_form(line, 3, 8, line_number) return _parse_columns_for_standard_form(line, 3, 8, line_number)
def _parse_extended_audio_channels(line, line_number): def _parse_extended_audio_channels(line, line_number):
content = line.strip() content = line.strip()
if content == "AUD 3": if content == "AUD 3":
@@ -111,20 +128,26 @@ def _parse_extended_audio_channels(line, line_number):
else: else:
return StmtUnrecognized(content=line, line_number=line_number) return StmtUnrecognized(content=line, line_number=line_number)
def _parse_remark(line, line_number) -> object: def _parse_remark(line, line_number) -> object:
if line.startswith("FROM CLIP NAME:"): if line.startswith("FROM CLIP NAME:"):
return StmtClipName(name=line[15:].strip() , affect="from", line_number=line_number) return StmtClipName(name=line[15:].strip(), affect="from",
line_number=line_number)
elif line.startswith("TO CLIP NAME:"): elif line.startswith("TO CLIP NAME:"):
return StmtClipName(name=line[13:].strip(), affect="to", line_number=line_number) return StmtClipName(name=line[13:].strip(), affect="to",
line_number=line_number)
elif line.startswith("SOURCE FILE:"): elif line.startswith("SOURCE FILE:"):
return StmtSourceFile(filename=line[12:].strip() , line_number=line_number) return StmtSourceFile(filename=line[12:].strip(),
line_number=line_number)
else: else:
return StmtRemark(text=line, line_number=line_number) return StmtRemark(text=line, line_number=line_number)
def _parse_effects_name(line, line_number) -> StmtEffectsName: def _parse_effects_name(line, line_number) -> StmtEffectsName:
name = line[16:].strip() name = line[16:].strip()
return StmtEffectsName(name=name, line_number=line_number) return StmtEffectsName(name=name, line_number=line_number)
def _parse_split(line, line_number): def _parse_split(line, line_number):
split_type = line[10:21] split_type = line[10:21]
is_video = False is_video = False
@@ -132,7 +155,8 @@ def _parse_split(line, line_number):
is_video = True is_video = True
split_mag = line[24:35] split_mag = line[24:35]
return StmtSplitEdit(video=is_video, magnitude=split_mag, line_number=line_number) return StmtSplitEdit(video=is_video, magnitude=split_mag,
line_number=line_number)
def _parse_motion_memory(line, line_number): def _parse_motion_memory(line, line_number):
@@ -142,7 +166,9 @@ def _parse_motion_memory(line, line_number):
def _parse_unrecognized(line, line_number): def _parse_unrecognized(line, line_number):
return StmtUnrecognized(content=line, line_number=line_number) return StmtUnrecognized(content=line, line_number=line_number)
def _parse_columns_for_standard_form(line, event_field_length, source_field_length, line_number):
def _parse_columns_for_standard_form(line, event_field_length,
source_field_length, line_number):
col_widths = _edl_column_widths(event_field_length, source_field_length) col_widths = _edl_column_widths(event_field_length, source_field_length)
if sum(col_widths) > len(line): if sum(col_widths) > len(line):
@@ -159,11 +185,9 @@ def _parse_columns_for_standard_form(line, event_field_length, source_field_leng
source_out=column_strings[12].strip(), source_out=column_strings[12].strip(),
record_in=column_strings[14].strip(), record_in=column_strings[14].strip(),
record_out=column_strings[16].strip(), record_out=column_strings[16].strip(),
line_number=line_number, line_number=line_number, format=source_field_length)
format=source_field_length)
def _parse_source_umid_statement(line, line_number): def _parse_source_umid_statement(line, line_number):
trimmed = line[3:].strip() # trimmed = line[3:].strip()
return StmtSourceUMID(name=None, umid=None, line_number=line_number) return StmtSourceUMID(name=None, umid=None, line_number=line_number)

View File

@@ -3,6 +3,7 @@
from typing import Optional from typing import Optional
class Transition: class Transition:
""" """
A CMX transition: a wipe, dissolve or cut. A CMX transition: a wipe, dissolve or cut.
@@ -86,5 +87,3 @@ class Transition:
the key foreground and replaced with the key background. the key foreground and replaced with the key background.
""" """
return self.transition == Transition.KeyOut return self.transition == Transition.KeyOut

View File

@@ -28,4 +28,3 @@ def collimate(a_string, column_widths):
element = a_string[:width] element = a_string[:width]
rest = a_string[width:] rest = a_string[width:]
return [element] + collimate(rest, column_widths[1:]) return [element] + collimate(rest, column_widths[1:])

View File

@@ -1,49 +1,40 @@
[build-system] [tool.poetry]
requires = ["flit_core >=3.2,<4"]
build-backend = "flit_core.buildapi"
[project]
name = "pycmx" name = "pycmx"
authors = [{name = "Jamie Hardt", email = "jamiehardt@me.com"}] version = "1.3.0"
description = "Python CMX 3600 Edit Decision List Parser"
authors = ["Jamie Hardt <jamiehardt@me.com>"]
license = "MIT"
readme = "README.md" readme = "README.md"
dynamic = ["version", "description"] keywords = [
requires-python = "~=3.7" 'parser',
'film',
'broadcast'
]
classifiers = [ classifiers = [
'Development Status :: 5 - Production/Stable', 'Development Status :: 5 - Production/Stable',
'License :: OSI Approved :: MIT License', 'License :: OSI Approved :: MIT License',
'Topic :: Multimedia', 'Topic :: Multimedia',
'Topic :: Multimedia :: Video', 'Topic :: Multimedia :: Video',
'Topic :: Text Processing', 'Topic :: Text Processing',
'Programming Language :: Python :: 3.7',
'Programming Language :: Python :: 3.8', 'Programming Language :: Python :: 3.8',
'Programming Language :: Python :: 3.9', 'Programming Language :: Python :: 3.9',
'Programming Language :: Python :: 3.10', 'Programming Language :: Python :: 3.10',
'Programming Language :: Python :: 3.11', 'Programming Language :: Python :: 3.11',
'Programming Language :: Python :: 3.12' 'Programming Language :: Python :: 3.12',
'Programming Language :: Python :: 3.13'
] ]
dependencies = [ homepage = "https://github.com/iluvcapra/pycmx"
documentation = "https://pycmx.readthedocs.io/"
repository = "https://github.com/iluvcapra/pycmx.git"
urls.Tracker = "https://github.com/iluvcapra/pycmx/issues"
] [tool.poetry.extras]
keywords = [ doc = ['sphinx', 'sphinx_rtd_theme']
'parser',
'film',
'broadcast'
]
[tool.flit.module] [tool.poetry.dependencies]
name = "pycmx" python = "^3.8"
sphinx = { version='>= 5.3.0', optional=true}
[project.optional-dependencies] sphinx_rtd_theme = {version ='>= 1.1.1', optional=true}
doc = [
'sphinx >= 5.3.0',
'sphinx_rtd_theme >= 1.1.1',
]
[project.urls]
Home = "https://github.com/iluvcapra/pycmx"
Documentation = "https://pycmx.readthedocs.io/"
Source = "https://github.com/iluvcapra/pycmx.git"
Issues = "https://github.com/iluvcapra/pycmx/issues"
[tool.pyright] [tool.pyright]
typeCheckingMode = "basic" typeCheckingMode = "basic"
@@ -59,3 +50,7 @@ disable = [
"R0913", # (too-many-arguments) "R0913", # (too-many-arguments)
"W0105", # (pointless-string-statement) "W0105", # (pointless-string-statement)
] ]
[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"

File diff suppressed because it is too large Load Diff

View File

@@ -2,6 +2,7 @@ from unittest import TestCase
import pycmx import pycmx
class TestParse(TestCase): class TestParse(TestCase):
files = ["INS4_R1_010417.edl", files = ["INS4_R1_010417.edl",
@@ -22,7 +23,8 @@ class TestParse(TestCase):
edl = pycmx.parse_cmx3600(f) edl = pycmx.parse_cmx3600(f)
actual = len(list(edl.events)) actual = len(list(edl.events))
self.assertTrue(actual == count, self.assertTrue(actual == count,
"expected %i in file %s but found %i" % (count, fn, actual)) "expected %i in file %s but found %i"
% (count, fn, actual))
def test_list_sanity(self): def test_list_sanity(self):
for fn in type(self).files: for fn in type(self).files:
@@ -31,7 +33,6 @@ class TestParse(TestCase):
self.assertTrue(type(edl.title) is str) self.assertTrue(type(edl.title) is str)
self.assertTrue(len(edl.title) > 0) self.assertTrue(len(edl.title) > 0)
def test_event_sanity(self): def test_event_sanity(self):
for fn in type(self).files: for fn in type(self).files:
path = "tests/edls/" + fn path = "tests/edls/" + fn
@@ -41,8 +42,6 @@ class TestParse(TestCase):
self.assertTrue(len(event.edits) > 0) self.assertTrue(len(event.edits) > 0)
self.assertTrue(event.number == index + 1) self.assertTrue(event.number == index + 1)
def test_events(self): def test_events(self):
with open("tests/edls/TEST.edl", 'r') as f: with open("tests/edls/TEST.edl", 'r') as f:
edl = pycmx.parse_cmx3600(f) edl = pycmx.parse_cmx3600(f)
@@ -51,12 +50,14 @@ class TestParse(TestCase):
self.assertEqual(events[0].number, 1) self.assertEqual(events[0].number, 1)
self.assertEqual(events[0].edits[0].source, "OY_HEAD_") self.assertEqual(events[0].edits[0].source, "OY_HEAD_")
self.assertEqual(events[0].edits[0].clip_name, "HEAD LEADER MONO") self.assertEqual(events[0].edits[0].clip_name, "HEAD LEADER MONO")
self.assertEqual( events[0].edits[0].source_file , "OY_HEAD_LEADER.MOV") self.assertEqual(
events[0].edits[0].source_file, "OY_HEAD_LEADER.MOV")
self.assertEqual(events[0].edits[0].source_in, "00:00:00:00") self.assertEqual(events[0].edits[0].source_in, "00:00:00:00")
self.assertEqual(events[0].edits[0].source_out, "00:00:00:00") self.assertEqual(events[0].edits[0].source_out, "00:00:00:00")
self.assertEqual(events[0].edits[0].record_in, "01:00:00:00") self.assertEqual(events[0].edits[0].record_in, "01:00:00:00")
self.assertEqual(events[0].edits[0].record_out, "01:00:08:00") self.assertEqual(events[0].edits[0].record_out, "01:00:08:00")
self.assertTrue( events[0].edits[0].transition.kind == pycmx.Transition.Cut) self.assertTrue(
events[0].edits[0].transition.kind == pycmx.Transition.Cut)
def test_channel_map(self): def test_channel_map(self):
with open("tests/edls/TEST.edl", 'r') as f: with open("tests/edls/TEST.edl", 'r') as f:
@@ -68,7 +69,6 @@ class TestParse(TestCase):
self.assertTrue(events[2].edits[0].channels.get_audio_channel(7)) self.assertTrue(events[2].edits[0].channels.get_audio_channel(7))
self.assertTrue(events[2].edits[0].channels.audio) self.assertTrue(events[2].edits[0].channels.audio)
def test_multi_edit_events(self): def test_multi_edit_events(self):
with open("tests/edls/TEST.edl", 'r') as f: with open("tests/edls/TEST.edl", 'r') as f:
edl = pycmx.parse_cmx3600(f) edl = pycmx.parse_cmx3600(f)
@@ -78,20 +78,25 @@ class TestParse(TestCase):
self.assertEqual(len(events[42].edits), 2) self.assertEqual(len(events[42].edits), 2)
self.assertEqual(events[42].edits[0].source, "TC_R1_V1") self.assertEqual(events[42].edits[0].source, "TC_R1_V1")
self.assertEqual( events[42].edits[0].clip_name , "TC R1 V1.2 TEMP1 FX ST.WAV") self.assertEqual(events[42].edits[0].clip_name,
"TC R1 V1.2 TEMP1 FX ST.WAV")
self.assertEqual(events[42].edits[0].source_in, "00:00:00:00") self.assertEqual(events[42].edits[0].source_in, "00:00:00:00")
self.assertEqual(events[42].edits[0].source_out, "00:00:00:00") self.assertEqual(events[42].edits[0].source_out, "00:00:00:00")
self.assertEqual(events[42].edits[0].record_in, "01:08:56:09") self.assertEqual(events[42].edits[0].record_in, "01:08:56:09")
self.assertEqual(events[42].edits[0].record_out, "01:08:56:09") self.assertEqual(events[42].edits[0].record_out, "01:08:56:09")
self.assertTrue( events[42].edits[0].transition.kind == pycmx.Transition.Cut) self.assertTrue(
events[42].edits[0].transition.kind == pycmx.Transition.Cut)
self.assertEqual(events[42].edits[1].source, "TC_R1_V6") self.assertEqual(events[42].edits[1].source, "TC_R1_V6")
self.assertEqual( events[42].edits[1].clip_name , "TC R1 V6 TEMP2 ST FX.WAV") self.assertEqual(events[42].edits[1].clip_name,
"TC R1 V6 TEMP2 ST FX.WAV")
self.assertEqual(events[42].edits[1].source_in, "00:00:00:00") self.assertEqual(events[42].edits[1].source_in, "00:00:00:00")
self.assertEqual(events[42].edits[1].source_out, "00:00:00:00") self.assertEqual(events[42].edits[1].source_out, "00:00:00:00")
self.assertEqual(events[42].edits[1].record_in, "01:08:56:09") self.assertEqual(events[42].edits[1].record_in, "01:08:56:09")
self.assertEqual(events[42].edits[1].record_out, "01:08:56:11") self.assertEqual(events[42].edits[1].record_out, "01:08:56:11")
self.assertTrue( events[42].edits[1].transition.kind == pycmx.Transition.Dissolve) self.assertTrue(
events[42].edits[1].transition.kind ==
pycmx.Transition.Dissolve)
def test_line_numbers(self): def test_line_numbers(self):
with open("tests/edls/ToD_R4_LOCK3.1_030618_Video.edl") as f: with open("tests/edls/ToD_R4_LOCK3.1_030618_Video.edl") as f:
@@ -106,8 +111,12 @@ class TestParse(TestCase):
with open("tests/edls/test_25.edl", "r") as f: with open("tests/edls/test_25.edl", "r") as f:
edl = pycmx.parse_cmx3600(f) edl = pycmx.parse_cmx3600(f)
events = list(edl.events) events = list(edl.events)
self.assertEqual( events[4].edits[1].transition.name , "CROSS DISSOLVE" ) self.assertEqual(
events[4].edits[1].transition.name, "CROSS DISSOLVE")
# add test for edit_list.channels
def test_adobe_wide(self):
with open("tests/edls/adobe_dai109_test.txt", 'r',
encoding='ISO-8859-1') as f:
edl = pycmx.parse_cmx3600(f)
events = list(edl.events)
self.assertEqual(len(events), 2839)