pycaption 2.3.10__tar.gz → 2.3.12__tar.gz

{pycaption-2.3.10/pycaption.egg-info → pycaption-2.3.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycaption
-Version: 2.3.10
+Version: 2.3.12
 Summary: Closed caption converter
 Author: Joe Norton
 Author-email: joey@nortoncrew.com

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/__init__.py

@@ -21,6 +21,7 @@ from .srt import SRTReader, SRTWriter
 from .transcript import TranscriptWriter
 from .webvtt import WebVTTReader, WebVTTWriter
 
+
 __all__ = [
     "CaptionConverter",
     "DFXPReader",

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/base.py

@@ -7,11 +7,13 @@ CaptionConverter orchestrator and base classes for readers/writers.
 
 import logging
 import os
+
 from datetime import timedelta
 from numbers import Number
 
 from .exceptions import CaptionReadError, CaptionReadTimingError, InvalidInputError
 
+
 logger = logging.getLogger(__name__)
 
 # `und` a special identifier for an undetermined language according to ISO 639-2
@@ -40,8 +42,7 @@ class CaptionConverter:
         """
         if not hasattr(caption_reader, "read"):
             raise InvalidInputError(
-                "The caption_reader must be a BaseReader instance "
-                "with a read() method."
+                "The caption_reader must be a BaseReader instance with a read() method."
             )
         self.captions = caption_reader.read(content)
         return self

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/dfxp/constants.py

@@ -8,6 +8,7 @@ import re
 
 from ..geometry import Alignment, HorizontalAlignmentEnum, Layout, VerticalAlignmentEnum
 
+
 DFXP_BASE_MARKUP = """
 <tt xmlns="http://www.w3.org/ns/ttml"
     xmlns:tts="http://www.w3.org/ns/ttml#styling">

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/dfxp/extras.py

@@ -13,6 +13,7 @@ from ..base import BaseWriter, CaptionNode, merge_concurrent_captions
 from .constants import DFXP_DEFAULT_REGION
 from .writer import DFXPWriter
 
+
 LEGACY_DFXP_BASE_MARKUP = """
 <tt xmlns="http://www.w3.org/ns/ttml"
     xmlns:tts="http://www.w3.org/ns/ttml#styling">
@@ -255,7 +256,7 @@ class LegacyDFXPWriter(BaseWriter):
 
         return line
 
-    def _recreate_style(self, content, dfxp):
+    def _recreate_style(self, content, dfxp):  # noqa: C901
         """Convert an internal style dict to DFXP/TTS attributes.
 
         :type content: dict

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/dfxp/reader.py

@@ -47,6 +47,7 @@ from .constants import (
     VERTICAL_ALIGNMENT_TO_DFXP,
 )
 
+
 _LEADING_WHITESPACE_RE = re.compile("^(?:[\n\r]+\\s*)?(.+)")
 
 _DFXP_WRITING_MODE_MAP = {
@@ -147,7 +148,8 @@ class DFXPReader(BaseReader):
                     style_dict[id_] = self._convert_style(style)
 
         caption_set = CaptionSet(
-            caption_dict, styles=style_dict,
+            caption_dict,
+            styles=style_dict,
             visual_alignment_default=HorizontalAlignmentEnum.START,
         )
 
@@ -179,8 +181,7 @@ class DFXPReader(BaseReader):
             tickrate = float(tt_attrs["ttp:tickrate"])
         except ValueError:
             raise CaptionReadSyntaxError(
-                f"ttp:tickRate must be a number, "
-                f"got '{tt_attrs['ttp:tickrate']}'"
+                f"ttp:tickRate must be a number, got '{tt_attrs['ttp:tickrate']}'"
             )
         if tickrate <= 0:
             raise CaptionReadSyntaxError(
@@ -203,8 +204,7 @@ class DFXPReader(BaseReader):
             framerate_int = int(framerate_str)
         except ValueError:
             raise CaptionReadSyntaxError(
-                f"ttp:frameRate must be a positive integer, "
-                f"got '{framerate_str}'"
+                f"ttp:frameRate must be a positive integer, got '{framerate_str}'"
             )
         self.tickrate = float(framerate_int * sub_framerate)
 
@@ -396,7 +396,7 @@ class DFXPReader(BaseReader):
                 self._convert_tag_to_node(a)
 
     @staticmethod
-    def _convert_style(tag):
+    def _convert_style(tag):  # noqa: C901
         """Convert DFXP/TTS style attributes on a tag to an internal style dict.
 
         Maps tts:fontStyle, tts:fontWeight, tts:textDecoration, tts:textAlign,

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/dfxp/writer.py

@@ -5,6 +5,7 @@ including style elements, region-based positioning, and writing direction.
 """
 
 import re
+
 from copy import deepcopy
 from xml.sax.saxutils import escape
 
@@ -26,6 +27,7 @@ from .constants import (
     _create_external_alignment,
 )
 
+
 _WRITING_DIRECTION_TO_DFXP = {
     WritingDirectionEnum.VERTICAL_RL: "tbrl",
     WritingDirectionEnum.VERTICAL_LR: "tblr",
@@ -213,7 +215,7 @@ class DFXPWriter(BaseWriter):
 
         return p
 
-    def _recreate_text(self, caption, dfxp, caption_set=None, lang=None):
+    def _recreate_text(self, caption, dfxp, caption_set=None, lang=None):  # noqa: C901
         """Serialize all nodes of a caption into DFXP inline markup.
 
         Handles text nodes, line breaks (<br/>), and style spans.  Nodes are
@@ -756,7 +758,7 @@ def _text_shadow_to_outline(value):
     return thickness
 
 
-def _recreate_style(content, dfxp):
+def _recreate_style(content, dfxp):  # noqa: C901
     """Convert an internal style dict to DFXP/TTS style attributes.
 
     Maps pycaption's internal keys (class, italics, bold, underline, color,
@@ -807,7 +809,7 @@ def _recreate_style(content, dfxp):
     return dfxp_style
 
 
-def _convert_layout_to_attributes(layout, fallback_alignment=None):
+def _convert_layout_to_attributes(layout, fallback_alignment=None):  # noqa: C901
     """Convert a Layout object to a dict of DFXP region attributes.
 
     Maps origin, extent, padding, alignment, and writing_direction to their

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/geometry.py

@@ -7,12 +7,15 @@ CONVENTIONS:
   responsible for the recalculation should return a new object with the
   necessary modifications.
 """
+
 import re
+
 from enum import Enum
 from functools import total_ordering
 
 from .exceptions import CaptionReadSyntaxError, RelativizationError
 
+
 _UNIT_MISMATCH_MSG = "The sizes should have the same measure units."
 
 

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/microdvd.py

@@ -5,6 +5,7 @@ A special line {0}{0}fps_value sets the framerate (default 25 fps).
 """
 
 import re
+
 from copy import deepcopy
 
 from .base import (

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/sami/constants.py

@@ -10,6 +10,7 @@ from cssutils import log
 
 from ..geometry import HorizontalAlignmentEnum
 
+
 log.setLevel(FATAL)
 
 SAMI_BASE_MARKUP = """

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/sami/reader.py

@@ -11,6 +11,7 @@ from ..exceptions import CaptionReadNoCaptions, CaptionReadTimingError
 from ..geometry import Alignment, HorizontalAlignmentEnum, Layout, Padding, Size
 from .parser import SAMIParser
 
+
 _TAG_TO_STYLE = {"i": "italics", "b": "bold", "u": "underline"}
 
 

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/sami/writer.py

@@ -13,6 +13,7 @@ from ..base import BaseWriter, CaptionNode
 from ..geometry import HorizontalAlignmentEnum
 from .constants import HORIZONTAL_ALIGNMENT_MAP, SAMI_BASE_MARKUP
 
+
 _NON_CSS_KEYS = frozenset(
     {
         "classes",

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/scc/__init__.py

@@ -3,4 +3,5 @@
 from .reader import SCCReader
 from .writer import SCC_TOKENS_PER_CAPTION_MAX, SCCWriter
 
+
 __all__ = ["SCCReader", "SCCWriter", "SCC_TOKENS_PER_CAPTION_MAX"]

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/scc/constants.py

@@ -7,8 +7,10 @@ background color codes, and derived inverse lookup tables.
 """
 
 import re as _re
+
 from itertools import product
 
+
 COMMANDS = {
     "9420": "",
     "9429": "",
@@ -1317,6 +1319,9 @@ SPECIAL_OR_EXTENDED_CHAR_TO_CODE = {
 SPECIAL_OR_EXTENDED_CHAR_TO_CODE.update(
     {character: code for code, character in SPECIAL_CHARS.items()}
 )
+# A non-breaking space is what CEA-608's transparent space is: a blank column
+# that is not a break opportunity. Unmapped, it fell back to the pound sign.
+SPECIAL_OR_EXTENDED_CHAR_TO_CODE["\xa0"] = "91b9"
 
 # Time to transmit a single codeword = 1 second / 29.97
 MICROSECONDS_PER_CODEWORD = 1000.0 * 1000.0 / (30.0 * 1000.0 / 1001.0)

{pycaption-2.3.10 → pycaption-2.3.12}/pycaption/scc/reader.py

@@ -78,6 +78,7 @@ http://www.theneitherworld.com/mcpoodle/SCC_TOOLS/DOCS/SCC_FORMAT.HTML
 """
 
 import re
+
 from collections import deque
 from copy import deepcopy
 
@@ -108,6 +109,7 @@ from .specialized_collections import (
 )
 from .state_machines import DefaultProvidingPositionTracker
 
+
 _TIMECODE_RE = re.compile(r"\d{2}:\d{2}:\d{2}[:;](\d{1,2})")
 
 
@@ -242,7 +244,7 @@ class SCCReader(BaseReader):
     def _validate_line_lengths(self):
         """Raise CaptionLineLengthError if any line exceeds 32 characters."""
         violations = [
-            f"around {cap.format_start()} - {line} - Length {len(line)}"
+            f"around {cap.format_start()} - {self._describe_line_length(line)}"
             for cap in (c.to_real_caption() for c in self.caption_stash._collection)
             for line in cap.get_text().split("\n")
             if len(line) > 32
@@ -253,6 +255,19 @@ class SCCReader(BaseReader):
                 "Lines longer than 32:\n" + "\n".join(violations)
             )
 
+    @staticmethod
+    def _describe_line_length(line):
+        """Describe a line too long for the row, separating the text from the
+        indentation that places it, which can be what pushes it off the row.
+        """
+        text = line.lstrip("\xa0")
+        indent = len(line) - len(text)
+        if not indent:
+            return f"{line} - Length {len(line)}"
+        return (
+            f"{text} - Length {len(text)} plus a {indent}-column indent = {len(line)}"
+        )
+
     @staticmethod
     def _fix_last_captions_without_ending(caption_list):
         """Set end = start + 4s for trailing captions that were never ended."""
@@ -364,7 +379,11 @@ class SCCReader(BaseReader):
         if self._is_doubled_type(word) and word == self.last_command:
             if word in CUE_STARTING_COMMAND:
                 self.double_starter = True
-            self.last_command = ""
+            # A doubled PAC stays on record so that a Tab Offset following it is
+            # still recognised as belonging to a PAC and applied; clearing it
+            # would leave the offset looking like a stray duplicate and drop the
+            # indentation it carries.
+            self.last_command = word if self._is_pac_command(word) else ""
             return True
 
         if self._is_pac_command(word) and word in self.last_command: