chiark / gitweb /
mkm3u: Determine and write out accurate durations for episodes and chapters.
[epls] / mkm3u
1 #! /usr/bin/python3
2 ### -*- mode: python; coding: utf-8 -*-
3
4 from contextlib import contextmanager
5 import optparse as OP
6 import os as OS
7 import re as RX
8 import subprocess as SP
9 import sys as SYS
10
11 class ExpectedError (Exception): pass
12
13 @contextmanager
14 def location(loc):
15   global LOC
16   old, LOC = LOC, loc
17   yield loc
18   LOC = old
19
20 def filter(value, func = None, dflt = None):
21   if value is None: return dflt
22   elif func is None: return value
23   else: return func(value)
24
25 def check(cond, msg):
26   if not cond: raise ExpectedError(msg)
27
28 def lookup(dict, key, msg):
29   try: return dict[key]
30   except KeyError: raise ExpectedError(msg)
31
32 def forget(dict, key):
33   try: del dict[key]
34   except KeyError: pass
35
36 def getint(s):
37   if not s.isdigit(): raise ExpectedError("bad integer `%s'" % s)
38   return int(s)
39
40 class Words (object):
41   def __init__(me, s):
42     me._s = s
43     me._i, me._n = 0, len(s)
44   def _wordstart(me):
45     s, i, n = me._s, me._i, me._n
46     while i < n:
47       if not s[i].isspace(): return i
48       i += 1
49     return -1
50   def nextword(me):
51     s, n = me._s, me._n
52     begin = i = me._wordstart()
53     if begin < 0: return None
54     while i < n and not s[i].isspace(): i += 1
55     me._i = i
56     return s[begin:i]
57   def rest(me):
58     s, n = me._s, me._n
59     begin = me._wordstart()
60     if begin < 0: return None
61     else: return s[begin:].rstrip()
62
63 def program_output(*args, **kw):
64   try: return SP.check_output(*args, **kw)
65   except SP.CalledProcessError as e:
66     raise ExpectedError("program `%s' failed with code %d" %
67                           (e.cmd, e.returncode))
68
69 URL_SAFE_P = 256*[False]
70 for ch in \
71     b"ABCDEFGHIJKLMNOPQRSTUVWXYZ" \
72     b"abcdefghijklmnopqrstuvwxyz" \
73     b"0123456789" b"!$%-.,/":
74   URL_SAFE_P[ch] = True
75 def urlencode(s):
76   return "".join((URL_SAFE_P[ch] and chr(ch) or "%%%02x" % ch
77                   for ch in s.encode("UTF-8")))
78
79 PROG = OS.path.basename(SYS.argv[0])
80
81 class BaseLocation (object):
82   def report(me, exc):
83     SYS.stderr.write("%s: %s%s\n" % (PROG, me._loc(), exc))
84
85 class DummyLocation (BaseLocation):
86   def _loc(me): return ""
87
88 class FileLocation (BaseLocation):
89   def __init__(me, fn, lno = 1): me._fn, me._lno = fn, lno
90   def _loc(me): return "%s:%d: " % (me._fn, me._lno)
91   def stepline(me): me._lno += 1
92
93 LOC = DummyLocation()
94
95 class Source (object):
96   PREFIX = ""
97   TITLEP = CHAPTERP = False
98   def __init__(me, fn):
99     me.fn = fn
100     me.neps = None
101     me.used_titles = dict()
102     me.used_chapters = set()
103     me.nuses = 0
104   def _duration(me, title, start_chapter, end_chapter):
105     return -1
106   def url_and_duration(me, title = None,
107                        start_chapter = None, end_chapter = None):
108     if title == "-":
109       if me.TITLEP: raise ExpectedError("missing title number")
110       if start_chapter is not None or end_chapter is not None:
111         raise ExpectedError("can't specify chapter without title")
112       suffix = ""
113     elif not me.TITLEP:
114       raise ExpectedError("can't specify title with `%s'" % me.fn)
115     elif start_chapter is None:
116       if end_chapter is not None:
117         raise ExpectedError("can't specify end chapter without start chapter")
118       suffix = "#%d" % title
119     elif not me.CHAPTERP:
120       raise ExpectedError("can't specify chapter with `%s'" % me.fn)
121     elif end_chapter is None:
122       suffix = "#%d:%d" % (title, start_chapter)
123     else:
124       suffix = "#%d:%d-%d:%d" % (title, start_chapter, title, end_chapter - 1)
125
126     duration = me._duration(title, start_chapter, end_chapter)
127
128     if end_chapter is not None:
129       keys = [(title, ch) for ch in range(start_chapter, end_chapter)]
130       set = me.used_chapters
131     else:
132       keys, set = [title], me.used_titles
133     for k in keys:
134       if k in set:
135         if title == "-":
136           raise ExpectedError("`%s' already used" % me.fn)
137         elif end_chapter is None:
138           raise ExpectedError("`%s' title %d already used" % (me.fn, title))
139         else:
140           raise ExpectedError("`%s' title %d chapter %d already used" %
141                               (me.fn, title, k[1]))
142     if end_chapter is not None:
143       for ch in range(start_chapter, end_chapter):
144         me.used_chapters.add((title, ch))
145     return me.PREFIX + ROOT + urlencode(me.fn) + suffix, duration
146
147 class VideoDisc (Source):
148   PREFIX = "dvd://"
149   TITLEP = CHAPTERP = True
150
151   def __init__(me, fn, *args, **kw):
152     super().__init__(fn, *args, **kw)
153     me.neps = 0
154
155   def _duration(me, title, start_chapter, end_chapter):
156     path = OS.path.join(ROOT, me.fn)
157     ntitle = int(program_output(["dvd-info", path, "titles"]))
158     if not 1 <= title <= ntitle:
159       raise ExpectedError("bad title %d for `%s': must be in 1 .. %d" %
160                             (title, me.fn, ntitle))
161     if start_chapter is None:
162       durq = "duration:%d" % title
163     else:
164       nch = int(program_output(["dvd-info", path, "chapters:%d" % title]))
165       if end_chapter is None: end_chapter = nch
166       else: end_chapter -= 1
167       if not 1 <= start_chapter <= end_chapter <= nch:
168         raise ExpectedError("bad chapter range %d .. %d for `%s' title %d: "
169                             "must be in 1 .. %d" %
170                             (start_chapter, end_chapter, me.fn, title, nch))
171       durq = "duration:%d.%d-%d" % (title, start_chapter, end_chapter)
172     duration = int(program_output(["dvd-info", path, durq]))
173     return duration
174
175 class VideoSeason (object):
176   def __init__(me, i, title):
177     me.i = i
178     me.title = title
179     me.episodes = {}
180   def set_episode_disc(me, i, disc):
181     if i in me.episodes:
182       raise ExpectedError("season %d episode %d already taken" % (me.i, i))
183     me.episodes[i] = disc; disc.neps += 1
184
185 def match_group(m, *groups, dflt = None, mustp = False):
186   for g in groups:
187     try: s = m.group(g)
188     except IndexError: continue
189     if s is not None: return s
190   if mustp: raise ValueError("no match found")
191   else: return dflt
192
193 class VideoDir (object):
194
195   _R_ISO_PRE = list(map(lambda pats:
196                           list(map(lambda pat:
197                                      RX.compile("^" + pat + r"\.iso$", RX.X),
198                                    pats)),
199     [[r""" S (?P<si> \d+) \. \ (?P<stitle> .*) — (?: D \d+ \. \ )?
200            (?P<epex> .*) """,
201       r""" S (?P<si> \d+) (?: D \d+)? \. \ (?P<epex> .*) """,
202       r""" S (?P<si> \d+) \. \ (?P<epex> E \d+ .*) """,
203       r""" S (?P<si> \d+) (?P<epex> E \d+) \. \ .* """],
204      [r""" (?P<si> \d+) [A-Z]? \. \ (?P<stitle> .*) — (?P<epex> .*) """],
205      [r""" \d+ \. \ (?P<epex> [ES] \d+ .*) """],
206      [r""" (?P<epnum> \d+ ) \. \ .* """]]))
207
208   _R_ISO_EP = RX.compile(r""" ^
209         (?: S (?P<si> \d+) \ )?
210         E (?P<ei> \d+) (?: – (?P<ej> \d+))? $
211   """, RX.X)
212
213   def __init__(me, dir):
214     me.dir = dir
215     fns = OS.listdir(OS.path.join(ROOT, dir))
216     fns.sort()
217     season = None
218     seasons = {}
219     styles = me._R_ISO_PRE
220     for fn in fns:
221       path = OS.path.join(dir, fn)
222       if not fn.endswith(".iso"): continue
223       #print(";; `%s'" % path, file = SYS.stderr)
224       for sty in styles:
225         for r in sty:
226           m = r.match(fn)
227           if m: styles = [sty]; break
228         else:
229           continue
230         break
231       else:
232         #print(";;\tignored (regex mismatch)", file = SYS.stderr)
233         continue
234
235       si = filter(match_group(m, "si"), int)
236       stitle = match_group(m, "stitle")
237
238       check(si is not None or stitle is None,
239             "explicit season title without number in `%s'" % fn)
240       if si is not None:
241         if season is None or si != season.i:
242           check(season is None or si == season.i + 1,
243                 "season %d /= %d" %
244                   (si, season is None and -1 or season.i + 1))
245           check(si not in seasons, "season %d already seen" % si)
246           seasons[si] = season = VideoSeason(si, stitle)
247         else:
248           check(stitle == season.title,
249                 "season title `%s' /= `%s'" % (stitle, season.title))
250
251       disc = VideoDisc(path)
252       ts = season
253       any, bad = False, False
254       epnum = match_group(m, "epnum")
255       if epnum is not None: eplist = ["E" + epnum]
256       else: eplist = match_group(m, "epex", mustp = True).split(", ")
257       for eprange in eplist:
258         mm = me._R_ISO_EP.match(eprange)
259         if mm is None:
260           #print(";;\t`%s'?" % eprange, file = SYS.stderr)
261           bad = True; continue
262         if not any: any = True
263         i = filter(mm.group("si"), int)
264         if i is not None:
265           try: ts = seasons[i]
266           except KeyError: ts = seasons[i] = VideoSeason(i, None)
267         if ts is None:
268           ts = season = seasons[1] = VideoSeason(1, None)
269         start = filter(mm.group("ei"), int)
270         end = filter(mm.group("ej"), int, start)
271         for k in range(start, end + 1):
272           ts.set_episode_disc(k, disc)
273           #print(";;\tepisode %d.%d" % (ts.i, k), file = SYS.stderr)
274       if not any:
275         #print(";;\tignored", file = SYS.stderr)
276         pass
277       elif bad:
278         raise ExpectedError("bad ep list in `%s'", fn)
279     me.seasons = seasons
280
281 class AudioDisc (Source):
282   PREFIX = "file://"
283   TITLEP = CHAPTERP = False
284
285   def _duration(me, title, start_chapter, end_chaptwr):
286     out = program_output(["metaflac",
287                           "--show-total-samples", "--show-sample-rate",
288                           OS.path.join(ROOT, me.fn)])
289     nsamples, hz = map(float, out.split())
290     return int(nsamples/hz)
291
292 class AudioEpisode (AudioDisc):
293   def __init__(me, fn, i, *args, **kw):
294     super().__init__(fn, *args, **kw)
295     me.i = i
296
297 class AudioDir (object):
298
299   _R_FLAC = RX.compile(r""" ^
300           E (\d+)
301           (?: \. \ (.*))?
302           \. flac $
303   """, RX.X)
304
305   def __init__(me, dir):
306     me.dir = dir
307     fns = OS.listdir(OS.path.join(ROOT, dir))
308     fns.sort()
309     episodes = {}
310     last_i = 0
311     for fn in fns:
312       path = OS.path.join(dir, fn)
313       if not fn.endswith(".flac"): continue
314       m = me._R_FLAC.match(fn)
315       if not m: continue
316       i = filter(m.group(1), int)
317       etitle = m.group(2)
318       check(i == last_i + 1, "episode %d /= %d" % (i, last_i + 1))
319       episodes[i] = AudioEpisode(path, i)
320       last_i = i
321     me.episodes = episodes
322
323 class Chapter (object):
324   def __init__(me, episode, title, i):
325     me.title, me.i = title, i
326     me.url, me.duration = \
327       episode.source.url_and_duration(episode.tno, i, i + 1)
328
329 class Episode (object):
330   def __init__(me, season, i, neps, title, src, tno = None,
331                startch = None, endch = None):
332     me.season = season
333     me.i, me.neps, me.title = i, neps, title
334     me.chapters = []
335     me.source, me.tno = src, tno
336     me.url, me.duration = src.url_and_duration(tno, startch, endch)
337   def add_chapter(me, title, j):
338     ch = Chapter(me, title, j)
339     me.chapters.append(ch)
340     return ch
341   def label(me):
342     return me.season._eplabel(me.i, me.neps, me.title)
343
344 class BaseSeason (object):
345   def __init__(me, series, implicitp = False):
346     me.series = series
347     me.episodes = []
348     me.implicitp = implicitp
349     me.ep_i, episodes = 1, []
350   def add_episode(me, j, neps, title, src, tno, startch, endch):
351     ep = Episode(me, j, neps, title, src, tno, startch, endch)
352     me.episodes.append(ep)
353     src.nuses += neps; me.ep_i += neps
354     return ep
355   def _epnames(me, i, neps):
356     playlist = me.series.playlist
357     if neps == 1: return playlist.epname, "%d" % i
358     elif neps == 2: return playlist.epnames, "%d, %d" % (i, i + 1)
359     else: return playlist.epnames, "%d–%d" % (i, i + neps - 1)
360
361 class Season (BaseSeason):
362   def __init__(me, series, title, i, *args, **kw):
363     super().__init__(series, *args, **kw)
364     me.title, me.i = title, i
365   def _eplabel(me, i, neps, title):
366     epname, epn = me._epnames(i, neps)
367     if title is None:
368       if me.implicitp: label = "%s %s" % (epname, epn)
369       elif me.title is None: label = "%s %d.%s" % (epname, me.i, epn)
370       else: label = "%s—%s %s" % (me.title, epname, epn)
371     else:
372       if me.implicitp: label = "%s. %s" % (epn, title)
373       elif me.title is None: label = "%d.%s. %s" % (me.i, epn, title)
374       else: label = "%s—%s. %s" % (me.title, epn, title)
375     return label
376
377 class MovieSeason (BaseSeason):
378   def __init__(me, series, title, *args, **kw):
379     super().__init__(series, *args, **kw)
380     me.title = title
381     me.i = None
382   def add_episode(me, j, neps, title, src, tno, startch, endch):
383     if me.title is None and title is None:
384       raise ExpectedError("movie or movie season must have a title")
385     return super().add_episode(j, neps, title, src, tno, startch, endch)
386   def _eplabel(me, i, neps, title):
387     if me.title is None:
388       label = title
389     elif title is None:
390       epname, epn = me._epnames(i, neps)
391       label = "%s—%s %s" % (me.title, epname, epn)
392     else:
393       label = "%s—%s" % (me.title, title)
394     return label
395
396 class Series (object):
397   def __init__(me, playlist, name, title = None, wantedp = True):
398     me.playlist = playlist
399     me.name, me.title = name, title
400     me.cur_season = None
401     me.wantedp = wantedp
402   def _add_season(me, season):
403     me.cur_season = season
404   def add_season(me, title, i, implicitp = False):
405     me._add_season(Season(me, title, i, implicitp))
406   def add_movies(me, title = None):
407     me._add_season(MovieSeason(me, title))
408   def ensure_season(me):
409     if me.cur_season is None: me.add_season(None, 1, implicitp = True)
410     return me.cur_season
411   def end_season(me):
412     me.cur_season = None
413
414 class Playlist (object):
415   def __init__(me):
416     me.seasons = []
417     me.episodes = []
418     me.epname, me.epnames = "Episode", "Episodes"
419     me.nseries = 0
420   def add_episode(me, episode):
421     me.episodes.append(episode)
422   def done_season(me):
423     if me.episodes:
424       me.seasons.append(me.episodes)
425       me.episodes = []
426   def write(me, f):
427     f.write("#EXTM3U\n")
428     for season in me.seasons:
429       f.write("\n")
430       for ep in season:
431         label = ep.label()
432         if me.nseries > 1: label = ep.season.series.title + " " + label
433         if not ep.chapters:
434           f.write("#EXTINF:%d,,%s\n%s\n" % (ep.duration, label, ep.url))
435         else:
436           for ch in ep.chapters:
437             f.write("#EXTINF:%d,,%s: %s\n%s\n" %
438                     (ch.duration, label, ch.title, ch.url))
439
440 MODE_UNSET = 0
441 MODE_SINGLE = 1
442 MODE_MULTI = 2
443
444 class EpisodeListParser (object):
445
446   def __init__(me, series_wanted = None, chapters_wanted_p = False):
447     me._pl = Playlist()
448     me._cur_episode = me._cur_chapter = None
449     me._series = {}; me._vdirs = {}; me._audirs = {}; me._isos = {}
450     me._series_wanted = series_wanted
451     me._chaptersp = chapters_wanted_p
452     if series_wanted is None: me._mode = MODE_UNSET
453     else: me._mode = MODE_MULTI
454
455   def _bad_keyval(me, cmd, k, v):
456     raise ExpectedError("invalid `!%s' option `%s'" %
457                           (cmd, v if k is None else k))
458
459   def _keyvals(me, opts):
460     if opts is not None:
461       for kv in opts.split(","):
462         try: sep = kv.index("=")
463         except ValueError: yield None, kv
464         else: yield kv[:sep], kv[sep + 1:]
465
466   def _set_mode(me, mode):
467     if me._mode == MODE_UNSET:
468       me._mode = mode
469     elif me._mode != mode:
470       raise ExpectedError("inconsistent single-/multi-series usage")
471
472   def _get_series(me, name):
473     if name is None:
474       me._set_mode(MODE_SINGLE)
475       try: series = me._series[None]
476       except KeyError:
477         series = me._series[None] = Series(me._pl, None)
478         me._pl.nseries += 1
479     else:
480       me._set_mode(MODE_MULTI)
481       series = lookup(me._series, name, "unknown series `%s'" % name)
482     return series
483
484   def _opts_series(me, cmd, opts):
485     name = None
486     for k, v in me._keyvals(opts):
487       if k is None: name = v
488       else: me._bad_keyval(cmd, k, v)
489     return me._get_series(name)
490
491   def _auto_epsrc(me, series):
492     dir = lookup(me._vdirs, series.name, "no active video directory")
493     season = series.ensure_season()
494     check(season.i is not None, "must use explicit iso for movie seasons")
495     vseason = lookup(dir.seasons, season.i,
496                      "season %d not found in video dir `%s'" %
497                        (season.i, dir.dir))
498     src = lookup(vseason.episodes, season.ep_i,
499                  "episode %d.%d not found in video dir `%s'" %
500                    (season.i, season.ep_i, dir.dir))
501     return src
502
503   def _process_cmd(me, ww):
504
505     cmd = ww.nextword(); check(cmd is not None, "missing command")
506     try: sep = cmd.index(":")
507     except ValueError: opts = None
508     else: cmd, opts = cmd[:sep], cmd[sep + 1:]
509
510     if cmd == "series":
511       name = None
512       for k, v in me._keyvals(opts):
513         if k is None: name = v
514         else: me._bad_keyval(cmd, k, v)
515       check(name is not None, "missing series name")
516       check(name not in me._series, "series `%s' already defined" % name)
517       title = ww.rest(); check(title is not None, "missing title")
518       me._set_mode(MODE_MULTI)
519       me._series[name] = series = Series(me._pl, name, title,
520                                          me._series_wanted is None or
521                                            name in me._series_wanted)
522       if series.wantedp: me._pl.nseries += 1
523
524     elif cmd == "season":
525       series = me._opts_series(cmd, opts)
526       w = ww.nextword();
527       check(w is not None, "missing season number")
528       if w == "-":
529         if not series.wantedp: return
530         series.add_movies(ww.rest())
531       else:
532         title = ww.rest(); i = getint(w)
533         if not series.wantedp: return
534         series.add_season(ww.rest(), getint(w), implicitp = False)
535       me._cur_episode = me._cur_chapter = None
536       me._pl.done_season()
537
538     elif cmd == "epname":
539       for k, v in me._keyvals(opts): me._bad_keyval("epname", k, v)
540       name = ww.rest(); check(name is not None, "missing episode name")
541       try: sep = name.index(",")
542       except ValueError: names = name + "s"
543       else: name, names = name[:sep], name[sep + 1:]
544       me._pl.epname, me._pl.epnames = name, names
545
546     elif cmd == "epno":
547       series = me._opts_series(cmd, opts)
548       w = ww.rest(); check(w is not None, "missing episode number")
549       epi = getint(w)
550       if not series.wantedp: return
551       series.ensure_season().ep_i = epi
552
553     elif cmd == "iso":
554       series = me._opts_series(cmd, opts)
555       fn = ww.rest(); check(fn is not None, "missing filename")
556       if not series.wantedp: return
557       if fn == "-": forget(me._isos, series.name)
558       else:
559         check(OS.path.exists(OS.path.join(ROOT, fn)),
560               "iso file `%s' not found" % fn)
561         me._isos[series.name] = VideoDisc(fn)
562
563     elif cmd == "vdir":
564       series = me._opts_series(cmd, opts)
565       dir = ww.rest(); check(dir is not None, "missing directory")
566       if not series.wantedp: return
567       if dir == "-": forget(me._vdirs, series.name)
568       else: me._vdirs[series.name] = VideoDir(dir)
569
570     elif cmd == "adir":
571       series = me._opts_series(cmd, opts)
572       dir = ww.rest(); check(dir is not None, "missing directory")
573       if not series.wantedp: return
574       if dir == "-": forget(me._audirs, series.name)
575       else: me._audirs[series.name] = AudioDir(dir)
576
577     elif cmd == "displaced":
578       series = me._opts_series(cmd, opts)
579       w = ww.rest(); check(w is not None, "missing count"); n = getint(w)
580       src = me._auto_epsrc(series)
581       src.nuses += n
582     else:
583       raise ExpectedError("unknown command `%s'" % cmd)
584
585   def _process_episode(me, ww):
586
587     opts = ww.nextword(); check(opts is not None, "missing title/options")
588     ti = None; sname = None; neps = 1; epi = None; loch = hich = None
589     for k, v in me._keyvals(opts):
590       if k is None:
591         if v.isdigit(): ti = int(v)
592         elif v == "-": ti = "-"
593         else: sname = v
594       elif k == "s": sname = v
595       elif k == "n": neps = getint(v)
596       elif k == "ep": epi = getint(v)
597       elif k == "ch":
598         try: sep = v.index("-")
599         except ValueError: loch, hich = getint(v), None
600         else: loch, hich = getint(v[:sep]), getint(v[sep + 1:]) + 1
601       else: raise ExpectedError("unknown episode option `%s'" % k)
602     check(ti is not None, "missing title number")
603     series = me._get_series(sname)
604     me._cur_chapter = None
605
606     title = ww.rest()
607     if not series.wantedp: return
608     season = series.ensure_season()
609     if epi is None: epi = season.ep_i
610
611     if ti == "-":
612       check(season.implicitp, "audio source, but explicit season")
613       dir = lookup(me._audirs, series.name,
614                    "no title, and no audio directory")
615       src = lookup(dir.episodes, season.ep_i,
616                    "episode %d not found in audio dir `%s'" % (epi, dir.dir))
617
618     else:
619       try: src = me._isos[series.name]
620       except KeyError: src = me._auto_epsrc(series)
621
622     episode = season.add_episode(epi, neps, title, src, ti, loch, hich)
623     me._pl.add_episode(episode)
624     me._cur_episode = episode
625
626   def _process_chapter(me, ww):
627     check(me._cur_episode is not None, "no current episode")
628     check(me._cur_episode.source.CHAPTERP,
629           "episode source doesn't allow chapters")
630     if me._chaptersp:
631       if me._cur_chapter is None: i = 1
632       else: i = me._cur_chapter.i + 1
633       me._cur_chapter = me._cur_episode.add_chapter(ww.rest(), i)
634
635   def parse_file(me, fn):
636     with location(FileLocation(fn, 0)) as floc:
637       with open(fn, "r") as f:
638         for line in f:
639           floc.stepline()
640           sline = line.lstrip()
641           if sline == "" or sline.startswith(";"): continue
642
643           if line.startswith("!"): me._process_cmd(Words(line[1:]))
644           elif not line[0].isspace(): me._process_episode(Words(line))
645           else: me._process_chapter(Words(line))
646     me._pl.done_season()
647
648   def done(me):
649     discs = set()
650     for name, vdir in me._vdirs.items():
651       if not me._series[name].wantedp: continue
652       for s in vdir.seasons.values():
653         for d in s.episodes.values():
654           discs.add(d)
655     for adir in me._audirs.values():
656       for d in adir.episodes.values():
657         discs.add(d)
658     for d in sorted(discs, key = lambda d: d.fn):
659       if d.neps is not None and d.neps != d.nuses:
660         raise ExpectedError("disc `%s' has %d episodes, used %d times" %
661                             (d.fn, d.neps, d.nuses))
662     return me._pl
663
664 ROOT = "/mnt/dvd/archive/"
665
666 op = OP.OptionParser \
667   (usage = "%prog [-c] [-s SERIES] EPLS",
668    description = "Generate M3U playlists from an episode list.")
669 op.add_option("-c", "--chapters",
670               dest = "chaptersp", action = "store_true", default = False,
671               help = "Output individual chapter names")
672 op.add_option("-s", "--series",
673               dest = "series", type = "str", default = None,
674               help = "Output only the listed SERIES (comma-separated)")
675 opts, argv = op.parse_args()
676 if len(argv) != 1: op.print_usage(file = SYS.stderr); SYS.exit(2)
677 if opts.series is None:
678   series_wanted = None
679 else:
680   series_wanted = set()
681   for name in opts.series.split(","): series_wanted.add(name)
682 try:
683   ep = EpisodeListParser(series_wanted, opts.chaptersp)
684   ep.parse_file(argv[0])
685   pl = ep.done()
686   pl.write(SYS.stdout)
687 except (ExpectedError, IOError, OSError) as e:
688   LOC.report(e)
689   SYS.exit(2)