Hands-on 05-anime-absolute-numbering-and-multi-episode: Lab

scope

This lab uses zero-byte mock media files. Every created, copied, written, or deleted object is confined to /opt/lab-classroom/class44/.

preflight

Run: test -d /opt/lab-classroom && test -w /opt/lab-classroom
Run: test ! -e /opt/lab-classroom/class44
If the second command fails, stop and use the rollback procedure or have an instructor review the existing directory.

steps

step

1

title

Create the isolated workspace

commands

mkdir /opt/lab-classroom/class44
mkdir /opt/lab-classroom/class44/incoming /opt/lab-classroom/class44/library /opt/lab-classroom/class44/manifests
mkdir -p '/opt/lab-classroom/class44/library/Star Harbor/Season 00' '/opt/lab-classroom/class44/library/Star Harbor/Season 01'

step

2

title

Create fictional zero-byte source files

commands

touch '/opt/lab-classroom/class44/incoming/Star Harbor - S01E01-E02 - Twin Arrival [WEB-1080p].mkv'
touch '/opt/lab-classroom/class44/incoming/Star Harbor - 003 - Beacon [WEB-1080p].mkv'
touch '/opt/lab-classroom/class44/incoming/Star Harbor - S00E01 - Prologue [BD-1080p].mkv'
touch '/opt/lab-classroom/class44/incoming/Star Harbor - 004-005 - Cloud Gate Pair [WEB-1080p].mkv'

note

These are empty test files and are not playable media.

step

3

title

Record the explicit episode mapping

commands

printf '%s\n' 'absolute,season,episode,title' '001,01,01,Twin Arrival Part One' '002,01,02,Twin Arrival Part Two' '003,01,03,Beacon' '004,01,04,Cloud Gate Part One' '005,01,05,Cloud Gate Part Two' > /opt/lab-classroom/class44/manifests/episode-map.csv

note

The prologue is already identified as S00E01 and is intentionally excluded from the numeric absolute map.

step

4

title

Create and run a dry-run normalization tool

commands

cat > /opt/lab-classroom/class44/normalize.py <<'PY'
from pathlib import Path
import csv
import re

root = Path('/opt/lab-classroom/class44').resolve()
incoming = root / 'incoming'
map_path = root / 'manifests' / 'episode-map.csv'
report_path = root / 'manifests' / 'normalization-report.txt'

mapping = {}
with map_path.open(newline='', encoding='utf-8') as handle:
for row in csv.DictReader(handle):
key = int(row['absolute'])
value = (int(row['season']), int(row['episode']), row['title'])
if key in mapping:
raise SystemExit(f'Duplicate absolute number in map: {key:03d}')
mapping[key] = value

season_pattern = re.compile(r' - S(?P\d{2})E(?P\d{2})(?:-E(?P\d{2}))? - ')
absolute_pattern = re.compile(r' - (?P\d{3})(?:-(?P\d{3}))? - ')
lines = []
errors = []

for path in sorted(incoming.iterdir()):
name = path.name
season_match = season_pattern.search(name)
if season_match:
first = int(season_match.group('first'))
last = int(season_match.group('last') or first)
if last < first:
errors.append(f'ERROR reversed season range: {name}')
else:
lines.append(f'KEEP {name}')
continue

absolute_match = absolute_pattern.search(name)
if not absolute_match:
    errors.append(f'ERROR unrecognized numbering: {name}')
    continue

first_absolute = int(absolute_match.group('first'))
last_absolute = int(absolute_match.group('last') or first_absolute)
absolute_numbers = list(range(first_absolute, last_absolute + 1))
missing = [number for number in absolute_numbers if number not in mapping]
if missing:
    errors.append(f"ERROR unmapped absolute numbers {','.join(f'{number:03d}' for number in missing)}: {name}")
    continue

mapped = [mapping[number] for number in absolute_numbers]
seasons = {item[0] for item in mapped}
episodes = [item[1] for item in mapped]
if len(seasons) != 1:
    errors.append(f'ERROR range crosses provider seasons: {name}')
    continue
if episodes != list(range(episodes[0], episodes[-1] + 1)):
    errors.append(f'ERROR range is not contiguous in provider order: {name}')
    continue

season = mapped[0][0]
token = f'S{season:02d}E{episodes[0]:02d}'
if len(episodes) > 1:
    token += f'-E{episodes[-1]:02d}'
target = name[:absolute_match.start()] + f' - {token} - ' + name[absolute_match.end():]
lines.append(f'RENAME {name} -> {target}')

report_path.write_text('\n'.join(lines + errors) + '\n', encoding='utf-8')
if errors:
raise SystemExit(1)
PY
python3 /opt/lab-classroom/class44/normalize.py
cat /opt/lab-classroom/class44/manifests/normalization-report.txt

step

5

title

Stage the reviewed canonical names

commands

cp -- '/opt/lab-classroom/class44/incoming/Star Harbor - S00E01 - Prologue [BD-1080p].mkv' '/opt/lab-classroom/class44/library/Star Harbor/Season 00/Star Harbor - S00E01 - Prologue [BD-1080p].mkv'
cp -- '/opt/lab-classroom/class44/incoming/Star Harbor - S01E01-E02 - Twin Arrival [WEB-1080p].mkv' '/opt/lab-classroom/class44/library/Star Harbor/Season 01/Star Harbor - S01E01-E02 - Twin Arrival [WEB-1080p].mkv'
cp -- '/opt/lab-classroom/class44/incoming/Star Harbor - 003 - Beacon [WEB-1080p].mkv' '/opt/lab-classroom/class44/library/Star Harbor/Season 01/Star Harbor - S01E03 - Beacon [WEB-1080p].mkv'
cp -- '/opt/lab-classroom/class44/incoming/Star Harbor - 004-005 - Cloud Gate Pair [WEB-1080p].mkv' '/opt/lab-classroom/class44/library/Star Harbor/Season 01/Star Harbor - S01E04-E05 - Cloud Gate Pair [WEB-1080p].mkv'

note

The source files remain unchanged. Copying models a reviewable staging workflow rather than an in-place bulk rename.

step

6

title

Inspect the staged result

commands

find /opt/lab-classroom/class44 -type f -printf '%P\n' | sort
find /opt/lab-classroom/class44/library -type f -size +0c -print

note

The final command should print nothing because all mock media files are zero bytes.