V|h, S r SSKrSSKrSSKJrJr " S S5 r " S S\5 r " S S
\5 r \R " S 5 r \R " S 5 r \R " S
5 r
\R " S5 r\R " S5 rS rS r " S S5 r " S S\5 r " S S\5 r " S S\5 r " S S\5 r " S S \5 r " S S \5 rS rg)!u
A partial parser for WebVTT segments. Interprets enough of the WebVTT stream
to be able to assemble a single stand-alone subtitle file, suitably adjusting
timestamps on the way, while everything else is passed through unmodified.
Regular expressions based on the W3C WebVTT specification
. The X-TIMESTAMP-MAP extension is described
in RFC 8216 §3.5 .
N ) int_or_nonetimetuple_from_msecc 6 \ rS rSrSrS rS rS rS rS r Sr
g )
_MatchParser z
An object that maintains the current parsing position and allows
conveniently advancing it as syntax elements are successfully parsed.
c Xl SU l g Nr _data_pos)selfstrings G/home/james-whalen/.local/lib/python3.13/site-packages/yt_dlp/webvtt.py__init___MatchParser.__init__ s
c 8 [ U[ R 5 ( a& UR U R U R
5 $ [ U[ 5 ( a6 U R R XR
5 ( a [ U5 $ g [ U5 eN)
isinstancerePatternmatchr r
str
startswithlen
ValueErrorr rs r r _MatchParser.match sh a $ $774::tyy1 1 a zz$$Q 221v
mr c 8 Uc SnO~[ U[ R 5 ( a [ UR S5 5 nOD[ U[
5 ( a [ U5 nO#[ U[ 5 ( a UnO [ U5 eU =R U-
sl U$ r
) r r Matchr groupr intr r
)r byamts r advance_MatchParser.advance$ st
:C
BHH
%
%bhhqk"C
C
b'C
C
C R. S r c B U R U R U5 5 $ r )r' r r s r consume_MatchParser.consume2 s ||DJJqM**r c [ U 5 $ r )_MatchChildParserr s r child_MatchParser.child5 s
&&r r N) __name__
__module__ __qualname____firstlineno____doc__r r r' r* r/ __static_attributes__ r r r r s
+'r r c 2 ^ \ rS rSrSrU 4S jrS rSrU =r$ )r- 9 z
A child parser state, which advances through the same data as
its parent, but has an independent position. This is useful when
advancing through syntax elements we might later want to backtrack
from.
c f > [ TU ] UR 5 Xl UR U l g r )superr r _MatchChildParser__parentr
)r parent __class__s r r _MatchChildParser.__init__A s$
&
KK r c P U R U R l U R $ )zG
Advance the parent state to the current position of this child state.
)r
r< r. s r commit_MatchChildParser.commitF s "YY
}} r )__parentr
) r1 r2 r3 r4 r5 r rA r6
__classcell__r> s @r r- r- 9 s
r r- c ( ^ \ rS rSrU 4S jrSrU =r$ )
ParseErrorN c > UR UR UR S- n[ TU ]
SUR SU< S35 g )Nd zParse error at position z (near ))r r
r; r )r parserdatar> s r r ParseError.__init__O sA ||FKK c(9:
3FKK=xqQRr r7 )r1 r2 r3 r4 r r6 rD rE s @r rG rG N s S Sr rG zL(?x)
(?:([0-9]{1,}):)?
([0-9]{2}):
([0-9]{2})\.
([0-9]{3})?
z\Zz(?:\r\n|[\r\n]|$)z(?:\r\n|[\r\n])+z[ \t]*c \ S[ S [ U R 5 S5 5 5 - $ )z
Convert a parsed WebVTT timestamp (a re.Match obtained from _REGEX_TS)
into an MPEG PES timestamp: a tick counter at 90 kHz resolution.
Z c 3 T # U H u p[ U=( d S 5 U- v M g7f)r N)r$ ).0partmults r _parse_ts..i s$ _0]*$DIA 0]s &()i6 i` i r )sumzipgroupstss r _parse_tsr\ d s8
_03BIIKA\0]_ _ _ _r c < S[ [ U S- S- 5 5 - $ )zb
Convert an MPEG PES timestamp into a WebVTT timestamp.
This will lose sub-millisecond precision.
z%02u:%02u:%02u.%03u- rP )r r$ rZ s r
_format_tsr_ m s"
!#6sBG?7K#L LLr c 4 \ rS rSrSrS r\S 5 rS rSr g)Blocku z
An abstract WebVTT block.
c N UR 5 H u p#[ XU5 M g r )itemssetattr)r kwargskeyvals r r Block.__init__z s HC Ds # 'r c UR U R 5 nU( d g UR U5 U " UR S5 S9$ )Nr )raw)r _REGEXr' r# )clsrL ms r parse Block.parse~ s9 LL $qqwwqz""r c : UR U R 5 g r )writerk r streams r
write_intoBlock.write_into s TXX r r7 N)
r1 r2 r3 r4 r5 r classmethodro ru r6 r7 r r ra ra u s% $ # # r ra c \ rS rSrSrSrg) HeaderBlock za
A WebVTT block that may only appear in the header part of the file,
i.e. before any cue blocks.
r7 N)r1 r2 r3 r4 r5 r6 r7 r r ry ry s r ry c \ rS rSr\R
" S5 r\R
" S5 r\R
" S5 r\R
" S5 r \R
" S5 r
\R
" S5 r \ S 5 r
\ S 5 rS
rS rg )
Magic z,\ufeff?WEBVTT([ \t][^\r\n]*)?(?:\r\n|[\r\n])zX-TIMESTAMP-MAP=zLOCAL:zMPEGTS:([0-9]+)z
[ \t]*,[ \t]*z6(?:(?!-->)[^\r\n])+:(?:(?!-->)[^\r\n])+(?:\r\n|[\r\n])c F UR 5 n UR U R 5 nU( a= UR [ 5 nUc [ U5 e[ U5 nUc [ U5 eOVUR U R 5 nU( a) [ UR S5 5 nUc [ U5 eO [ U5 eUR U R 5 ( a M UR [ 5 ( a O [ U5 eUR 5 WW4$ )Nr ) r/ r* _REGEX_TSMAP_LOCAL _REGEX_TSrG r\ _REGEX_TSMAP_MPEGTSr r# _REGEX_TSMAP_SEP _REGEX_NLrA )rm rL rn localmpegtss r
__parse_tsmapMagic.__parse_tsmap s s 5 56ANN9-9$V,,!! =$V,, ! NN3#:#:; ( 4F ~ ( 00 & %V,,~~c 2 233~~i(( V$ $
f} r c UR 5 nUR U R 5 nU( d [ U5 eUR S5 nSu pEnUR [
5 ( dw UR U R 5 ( a U R U5 u pEMO UR U R 5 nU( a XbR S5 -
nM [ U5 eUR 5 U " X5XFS9$ )Nr )NN r )extrar r meta)
r/ r* rl rG r# r _REGEX_TSMAP_Magic__parse_tsmap _REGEX_METArA )rm rL rn r r r r s r ro Magic.parse s NN3:: & V$ $
,t..++~~c . .// # 1 1& 9
s/A
" V$ $
UFFr c UR S5 U R b UR U R 5 UR S5 U R ( d U R ( a UR S5 UR [ U R b U R OS5 5 UR S5 UR [ U R b U R OS5 5 UR S5 U R ( a UR U R 5 UR S5 g )NWEBVTT
zX-TIMESTAMP-MAP=LOCAL:r z,MPEGTS:)rr r r r r_ r r rs s r ru Magic.write_into s X :: ! LL $ T :: LL1 2 LL$**2HDJJaP Q LL $ LLDKK,CT[[K L LL 99 LL # Tr r7 N)r1 r2 r3 r4 r compilerl r r r r r rw r ro ru r6 r7 r r r| r| s
ZZG
HF :: 12LI. **%78zz"23 ** VWK : G G*
r r| c 8 \ rS rSr\R
" S5 rSrg)
StyleBlock zs(?x)
STYLE[\ \t]*(?:\r\n|[\r\n])
((?:(?!-->)[^\r\n])+(?:\r\n|[\r\n]))*
(?:\r\n|[\r\n])
r7 Nr1 r2 r3 r4 r r rl r6 r7 r r r r
ZZ Fr r c 8 \ rS rSr\R
" S5 rSrg) RegionBlock ze(?x)
REGION[\ \t]*
((?:(?!-->)[^\r\n])+(?:\r\n|[\r\n]))*
(?:\r\n|[\r\n])
r7 Nr r7 r r r r r r r c 8 \ rS rSr\R
" S5 rSrg) CommentBlock zo(?x)
NOTE(?:\r\n|[\ \t\r\n])
((?:(?!-->)[^\r\n])+(?:\r\n|[\r\n]))*
(?:\r\n|[\r\n])
r7 Nr r7 r r r r r r r c \ rS rSrSr\R " S5 r\R " S5 r\R " S5 r \R " S5 r
\ S 5 r S r
\S 5 rS
r\ S 5 rS rS
rg)CueBlocki z.
A cue block. The payload is not interpreted.
z$((?:(?!-->)[^\r\n])+)(?:\r\n|[\r\n])z[ \t]+-->[ \t]+z[ \t]+((?:(?!-->)[^\r\n])+)z[^\r\n]+(?:\r\n|[\r\n])?c 4 UR 5 nS nUR U R 5 nU( a UR S5 nUR [ 5 nU( d g UR U R
5 ( d g UR [ 5 nU( d g UR U R 5 nUR [ 5 UR [ 5 ( d g [ U5 n[ U5 nUb UR S5 OS n [ R " 5 n
UR U R 5 nU( d O"U
R UR S5 5 ME UR 5 U " UXxU U
R 5 S9$ )Nr r )idstartendsettingstext)r/ r* _REGEX_IDr# r _REGEX_ARROW_REGEX_SETTINGS_REGEX_OPTIONAL_WHITESPACEr r\ ioStringIO_REGEX_PAYLOADrr rA getvalue) rm rL id_rn m0m1m2r r r r s r ro CueBlock.parse s6 NN3== ) ''!*C
^^I
&~~c . .//
^^I
&
^^C / /
012~~i(("
m"$.288A;d{{}s 1 12A JJqwwqz "
8
r c U R b, UR U R 5 UR S5 UR [ U R 5 5 UR S5 UR [ U R 5 5 U R
b, UR S5 UR U R
5 UR S5 UR U R 5 UR S5 g )Nr z --> )r rr r_ r r r r rs s r ru CueBlock.write_into7 s 77 LL ! LL Z
+, W Z)* == $ LL LL ' T TYY Tr c v U R U R U R U R U R S.$ )Nr r r r r r r. s r as_jsonCueBlock.as_jsonE s1 ''ZZ88II
r c 4 U R UR :H $ r )r r others r __eq__CueBlock.__eq__O s ||u}},,r c 4 U " US US US US US S9$ )Nr r r r r r r7 )rm jsons r from_jsonCueBlock.from_jsonR s3 Dzw-U f *%
r c U R UR :w a gU R UR :w a gU R U R s=:* =( a& UR s=:H =( a UR :* $ s $ )NF)r r r r r s r hingesCueBlock.hinges\ sY 99
" ==ENN *zzTXXAAAA AAAAr r7 N)r1 r2 r3 r4 r5 r r r r r r rw ro ru propertyr r r r r6 r7 r r r r s
BCI:: 01Ljj!?@OZZ ;>, ' ' !!&) K ( K ""6* K
ll:&& >>, ' ' ""6* K v& K 's EE)r5 r r utilsr r r r- ExceptionrG r r r r r r r\ r_ ra ry r| r r r r r r7 r r r s
3%' %'P *S S
JJ
ZZ
JJ+ , zz-. ZZ 2 _M * % XK Xv + 5 \Bu \B~*!r