João HenriqueandClaude Opus 5
4f5cf94443
O writer tinha 4.199 linhas, das quais 3.300 numa única classe com dezoito
assuntos dentro. Achar o trecho de zoom exigia rolar por marcadores,
velocidade e legendas.
Agora é o pacote fcpxml/writer/, com um arquivo por assunto e o
FCPXMLModifier montado por composição de mixins. Mixins, e não objetos
separados, porque todas essas operações mexem no mesmo documento e nos
mesmos índices — separá-las em objetos independentes transformaria toda
chamada interna em travessia de fronteira sem nada em troca. A divisão que
importa aqui é de leitura, não de estado.
Nenhuma mudança de comportamento e nenhuma alteração nos ~50 pontos que
importam do writer: o __init__ re-exporta tudo, inclusive os nomes com
underscore que a suíte já usava.
core 723 carga, índices, navegação na spine, save
titles 600 títulos e legendas dinâmicas
cut 333 dividir, cortar faixas, apagar
speed 297 velocidade e zoom
(+ 20 módulos menores)
Único ajuste de chamada: quatro testes faziam patch em
fcpxml.writer.subprocess, que agora mora em writer.document (ver
Engine/docs/05_EXPERIENCIAS.md #23).
Lint zerado, 1441 testes passando.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
56 lines
1.5 KiB
Python
56 lines
1.5 KiB
Python
"""Atalhos de uma linha para as operações mais comuns.
|
|
|
|
Extraído de writer.py — ver fcpxml/writer/__init__.py para o conjunto.
|
|
"""
|
|
|
|
from typing import Optional
|
|
|
|
from ..models import (
|
|
MarkerType,
|
|
)
|
|
from .modifier import FCPXMLModifier
|
|
|
|
# ============================================================================
|
|
# CONVENIENCE FUNCTIONS
|
|
# ============================================================================
|
|
|
|
def modify_fcpxml(filepath: str) -> FCPXMLModifier:
|
|
"""
|
|
Open an FCPXML file for modification.
|
|
|
|
Usage:
|
|
modifier = modify_fcpxml("project.fcpxml")
|
|
modifier.add_marker(...)
|
|
modifier.save("output.fcpxml")
|
|
"""
|
|
return FCPXMLModifier(filepath)
|
|
|
|
|
|
def add_marker_to_file(
|
|
filepath: str,
|
|
timecode: str,
|
|
name: str,
|
|
marker_type: str = "standard",
|
|
output_path: Optional[str] = None
|
|
) -> str:
|
|
"""Convenience function to add a marker to an FCPXML file."""
|
|
modifier = FCPXMLModifier(filepath)
|
|
modifier.add_marker_at_timeline(
|
|
timecode, name,
|
|
MarkerType.from_string(marker_type)
|
|
)
|
|
return modifier.save(output_path)
|
|
|
|
|
|
def trim_clip_in_file(
|
|
filepath: str,
|
|
clip_id: str,
|
|
trim_start: Optional[str] = None,
|
|
trim_end: Optional[str] = None,
|
|
output_path: Optional[str] = None
|
|
) -> str:
|
|
"""Convenience function to trim a clip in an FCPXML file."""
|
|
modifier = FCPXMLModifier(filepath)
|
|
modifier.trim_clip(clip_id, trim_start, trim_end)
|
|
return modifier.save(output_path)
|