前回は、cue 生成スクリプトの全体像を俯瞰し、最初に呼ばれる関数が input_metadata() であることを確認しました。
しかしこの関数の実コードはなかなかの長さで、いきなり読み始めると「ノーサンキュー！」となる読者もいるかと思います。
そこで今回は、まず “やりたいことだけを書いた最小構成” を示し、その後に“実際のコードはこう発展していく” という流れで説明してみます。
1. はじめに
Python 慣らし編として Python に慣れていない読者でも読み進められるよう、段階的に進めていく。
2. input_metadata() の目的は「共通情報を集める」だけ。
まずは、やりたいことを素直に書くとどうなるか。実は、これだけで十分に動く。
python
# ◆A: 最小構成（やりたいことだけ）
def input_metadata():
performer = input("アーティスト名: ")
album = input("アルバム名: ")
genre = input("ジャンル: ")
offset_seconds = float(input("オフセット時間（秒）: "))
total_tracks = int(input("総トラック数: "))
return {
"performer": performer,
"album": album,
"genre": genre,
"offset_frames": seconds_to_frames(offset_seconds),
"total_tracks": total_tracks
}
ここまでは Python 入門レベルであり、特別な文法は出てこない。「ユーザーに聞いて、辞書にまとめて返す」ただそれだけである。
3. しかし実際には「修正機能」が欲しくなる
ところが、最小構成には弱点がある。入力を間違えたら最初からやり直しになるのだ。
cue のように細かい入力が多い場面では、これはなかなかのストレスである。
そこで実コードでは、次のような改良が加えられている。
・入力内容を一覧表示して確認する（◆B）
・間違いがあれば該当項目だけ修正できる（◆C）
・すでに metadata がある場合はそれを初期値にする（◆D）
この“ユーザーに優しい仕様”が、完成形のコードを少し長くしている理由である。
4. 処理の流れ（フロー図）
ここで一度立ち止まり、処理の流れを図で把握しておくと理解が早い。
【フロー図】
この図を見れば、「入力 → 確認 → 修正 → 再確認」というループ構造であることが分かる。
5. 完成形コード（マーク付き）
さて、ここまで準備が整ったところで、ようやく完成形のコードを示す。
フロー図と対応するように、◆A, ◆B, ◆C, ◆D のマークを入れてある。
def input_metadata(existing: Metadata | None = None) -> Metadata:
# ◆D: 既存 metadata がある場合は初期値として使う
if existing:
performer = existing["performer"]
album = existing["album"]
genre = existing["genre"]
offset_frames = existing["offset_frames"]
total_tracks = existing["total_tracks"]
# ◆A: 既存が無ければユーザーに入力を求める
else:
performer = input("アーティスト名: ")
album = input("アルバム名: ")
genre = input("ジャンル: ")
offset_seconds = float(input("オフセット時間（秒、小数点以下可）: "))
offset_frames = seconds_to_frames(offset_seconds)
total_tracks = int(input("総トラック数: "))
while True:
# ◆B: 入力内容を一覧表示して確認
print("\n📜 入力内容確認:")
print(f" 1: アーティスト名 → {performer}")
print(f" 2: アルバム名 → {album}")
print(f" 3: ジャンル → {genre}")
print(f" 4: オフセット → {frames_to_mmss(offset_frames)}")
print(f" 5: 総トラック数 → {total_tracks}")
print(f" 対象ファイル → {album}.wav")
if confirm("この内容でよろしいですか"):
return {
"performer": performer,
"album": album,
"genre": genre,
"offset_frames": offset_frames,
"total_tracks": total_tracks
}
# ◆C: 修正したい項目だけ再入力
else:
try:
choice = int(input("修正したい項目番号（1〜5）: "))
if choice == 1:
new = input(f"アーティスト名（現在: {performer}）: ").strip()
if new: performer = new
elif choice == 2:
new = input(f"アルバム名（現在: {album}）: ").strip()
if new: album = new
elif choice == 3:
new = input(f"ジャンル（現在: {genre}）: ").strip()
if new: genre = new
elif choice == 4:
new = input(f"オフセット時間（秒、小数点以下可、現在: {frames_to_mmss(offset_frames)}）: ").strip()
if new: offset_frames = seconds_to_frames(float(new))
elif choice == 5:
new = input(f"総トラック数（現在: {total_tracks}）: ").strip()
if new: total_tracks = int(new)
else:
print("⚠️ 無効な番号です")
except ValueError:
print("⚠️ 数値で入力してください")
6. おわりに
今回は metadata のみを扱いましたが、
・最小構成（◆A）
・改良点（◆B, ◆C, ◆D）
・完成形コード
という流れで理解すると、初心者でも無理なく読み進められるのではないかと思う。
いかがでしょうか？是非前回までの記事と照らし合わせて見て下さい。
次回は input_tracks() を同じ流れで解説する予定です。
← にほんブログ村「科学」－「技術・工学」へ
↑ クリックをお願いします