pic-archiver 0.1.0__tar.gz

pic_archiver-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: pic-archiver
+Version: 0.1.0
+Summary: Rename, sort, and safely archive exported picture and video files.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow
+Requires-Dist: piexif
+Requires-Dist: rawpy
+Requires-Dist: Send2Trash
+
+# PicArchiver
+
+Photos ライブラリなどから書き出した写真・動画をリネームし、`archive/` と `raw/` に安全に整理するためのツールです。
+
+## 1. ディレクトリ構成
+
+写真管理用の親ディレクトリを `PA_ROOT` と呼びます。`PA_ROOT` を指定しない場合は、`parc` を実行したカレントディレクトリが親になります。
+
+```text
+PA_ROOT/
+├── import/         # 処理対象ファイル
+├── archive/        # アーカイブ出力先（年/年-月-日 の階層で保存）
+├── raw/            # RAW ファイル出力先（拡張子ごとに分類）
+├── .stage/         # 反映前の作業コピー
+└── .backups/       # apply 時の退避先
+```
+
+## 2. 写真を書き出す
+
+1. 内蔵ライブラリを起動する
+2. すべての写真を選択する
+3. `PA_ROOT/import/` に書き出す
+
+## 3. ターミナルで実行する
+
+初回だけ、PyPI からインストールします。
+
+```bash
+pip install pic-archiver
+```
+
+PyPI に公開する前に GitHub から直接インストールする場合は、次のコマンドを使います。
+
+```bash
+pip install "git+https://github.com/Ryota-Nitto/PicArchiver.git"
+```
+
+最新版に更新したい場合は、再インストールします。
+
+```bash
+pip install --upgrade --force-reinstall pic-archiver
+```
+
+開発中にこのディレクトリの変更を即反映したい場合だけ、リポジトリのディレクトリで代わりに `pip install -e .` を使います。
+
+`parc` が見つからない場合は、`pip` の script 置き場に `PATH` を通します。Homebrew Python では `/opt/homebrew/bin`、ユーザーインストールでは `~/.local/bin` になることがあります。
+
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+以後は、どのディレクトリからでも実行できます。
+
+```bash
+# import, archive, raw を含む親ディレクトリを指定する場合（推奨）
+export PA_ROOT=/path/to/pictures-root
+
+# 変更をステージして、差分を確認
+parc stage
+
+# 問題なければ適用
+parc apply
+```
+
+`parc` 単体では使えるコマンド一覧を表示します。`parc stage` は作業コピーを作って整理処理を実行し、差分を表示します。`parc apply` は差分を反映し、上書き・削除される既存ファイルを `.backups/YYYYMMDD_HHMMSS/` に退避します。退避ファイルがなかった場合、今回分の空バックアップディレクトリは削除されます。成功後、`import/` の中身はゴミ箱へ移ります。`.stage` は次回を速くするため削除せずに残します。
+
+## 4. Option
+
+### 取り込みをやり直す
+
+`stage` したあとで、取り込みたくない画像や修正したい内容が見つかった場合は、`import/` を修正してから `parc stage` を再実行します。既存の `.stage` がある場合は、捨てずに同期して再利用します。
+
+完全に作り直したい場合だけ `--replace` を使います。
+
+```bash
+parc stage --replace
+```
+
+### ステージ後、即座に適用する
+
+```bash
+parc stage --apply
+```
+
+`parc apply` と同じ確認プロンプトが出ます。
+
+### Photos ライブラリを統合する
+
+1. 内蔵ライブラリを複製する
+2. 統合先の Photos ライブラリを起動する
+3. `ファイル > 読み込む` で複製した内蔵ライブラリを選択する
+4. すべての項目を読み込む
+5. ライブラリにすべての写真が読み込まれたことを確認する
+6. 内蔵ライブラリの写真・動画を全選択し、ゴミ箱へ移動する
+7. 複製した内蔵ライブラリを削除する
+
+### ディレクトリを個別に指定する
+
+`PA_ROOT` 配下の標準構成を使わない場合だけ指定します。
+
+```bash
+export PA_IMPORT_DIR=/path/to/import
+export PA_ARCHIVE_DIR=/path/to/archive
+export PA_RAW_DIR=/path/to/raw
+export PA_STAGE_ROOT=/path/to/stage
+export PA_BACKUP_ROOT=/path/to/backups
+```
+
+### 直接実行する（非推奨）
+
+`python main.py` を直接実行すると、指定した `PA_ROOT` または `PA_IMPORT_DIR` 内のファイルを直接リネーム・移動します。上書きされる対象はバックアップされません。
+
+```bash
+python main.py
+```
+
+### 出力例
+
+```text
+Processing files in: /path/to/project/import
+Processing: IMG_1234.JPG
+Moved: IMG_1234.JPG -> /path/to/project/archive/2026/2026-01-12/20260112_145828_001.jpg
+Done
+```
+
+## 主要ファイル
+
+- `main.py`: エントリーポイント
+- `parc`: どのディレクトリからでも実行するためのコマンド
+- `pic_archiver.py`: コア処理（日時抽出・リネーム・振り分け）
+- `config.py`: パス設定（デフォルトはこのリポジトリのディレクトリ、環境変数で上書き可）
+- `*.sh`: 作業コピーで確認してから反映するための一連のコマンド

pic_archiver-0.1.0/README.md

@@ -0,0 +1,132 @@
+# PicArchiver
+
+Photos ライブラリなどから書き出した写真・動画をリネームし、`archive/` と `raw/` に安全に整理するためのツールです。
+
+## 1. ディレクトリ構成
+
+写真管理用の親ディレクトリを `PA_ROOT` と呼びます。`PA_ROOT` を指定しない場合は、`parc` を実行したカレントディレクトリが親になります。
+
+```text
+PA_ROOT/
+├── import/         # 処理対象ファイル
+├── archive/        # アーカイブ出力先（年/年-月-日 の階層で保存）
+├── raw/            # RAW ファイル出力先（拡張子ごとに分類）
+├── .stage/         # 反映前の作業コピー
+└── .backups/       # apply 時の退避先
+```
+
+## 2. 写真を書き出す
+
+1. 内蔵ライブラリを起動する
+2. すべての写真を選択する
+3. `PA_ROOT/import/` に書き出す
+
+## 3. ターミナルで実行する
+
+初回だけ、PyPI からインストールします。
+
+```bash
+pip install pic-archiver
+```
+
+PyPI に公開する前に GitHub から直接インストールする場合は、次のコマンドを使います。
+
+```bash
+pip install "git+https://github.com/Ryota-Nitto/PicArchiver.git"
+```
+
+最新版に更新したい場合は、再インストールします。
+
+```bash
+pip install --upgrade --force-reinstall pic-archiver
+```
+
+開発中にこのディレクトリの変更を即反映したい場合だけ、リポジトリのディレクトリで代わりに `pip install -e .` を使います。
+
+`parc` が見つからない場合は、`pip` の script 置き場に `PATH` を通します。Homebrew Python では `/opt/homebrew/bin`、ユーザーインストールでは `~/.local/bin` になることがあります。
+
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+以後は、どのディレクトリからでも実行できます。
+
+```bash
+# import, archive, raw を含む親ディレクトリを指定する場合（推奨）
+export PA_ROOT=/path/to/pictures-root
+
+# 変更をステージして、差分を確認
+parc stage
+
+# 問題なければ適用
+parc apply
+```
+
+`parc` 単体では使えるコマンド一覧を表示します。`parc stage` は作業コピーを作って整理処理を実行し、差分を表示します。`parc apply` は差分を反映し、上書き・削除される既存ファイルを `.backups/YYYYMMDD_HHMMSS/` に退避します。退避ファイルがなかった場合、今回分の空バックアップディレクトリは削除されます。成功後、`import/` の中身はゴミ箱へ移ります。`.stage` は次回を速くするため削除せずに残します。
+
+## 4. Option
+
+### 取り込みをやり直す
+
+`stage` したあとで、取り込みたくない画像や修正したい内容が見つかった場合は、`import/` を修正してから `parc stage` を再実行します。既存の `.stage` がある場合は、捨てずに同期して再利用します。
+
+完全に作り直したい場合だけ `--replace` を使います。
+
+```bash
+parc stage --replace
+```
+
+### ステージ後、即座に適用する
+
+```bash
+parc stage --apply
+```
+
+`parc apply` と同じ確認プロンプトが出ます。
+
+### Photos ライブラリを統合する
+
+1. 内蔵ライブラリを複製する
+2. 統合先の Photos ライブラリを起動する
+3. `ファイル > 読み込む` で複製した内蔵ライブラリを選択する
+4. すべての項目を読み込む
+5. ライブラリにすべての写真が読み込まれたことを確認する
+6. 内蔵ライブラリの写真・動画を全選択し、ゴミ箱へ移動する
+7. 複製した内蔵ライブラリを削除する
+
+### ディレクトリを個別に指定する
+
+`PA_ROOT` 配下の標準構成を使わない場合だけ指定します。
+
+```bash
+export PA_IMPORT_DIR=/path/to/import
+export PA_ARCHIVE_DIR=/path/to/archive
+export PA_RAW_DIR=/path/to/raw
+export PA_STAGE_ROOT=/path/to/stage
+export PA_BACKUP_ROOT=/path/to/backups
+```
+
+### 直接実行する（非推奨）
+
+`python main.py` を直接実行すると、指定した `PA_ROOT` または `PA_IMPORT_DIR` 内のファイルを直接リネーム・移動します。上書きされる対象はバックアップされません。
+
+```bash
+python main.py
+```
+
+### 出力例
+
+```text
+Processing files in: /path/to/project/import
+Processing: IMG_1234.JPG
+Moved: IMG_1234.JPG -> /path/to/project/archive/2026/2026-01-12/20260112_145828_001.jpg
+Done
+```
+
+## 主要ファイル
+
+- `main.py`: エントリーポイント
+- `parc`: どのディレクトリからでも実行するためのコマンド
+- `pic_archiver.py`: コア処理（日時抽出・リネーム・振り分け）
+- `config.py`: パス設定（デフォルトはこのリポジトリのディレクトリ、環境変数で上書き可）
+- `*.sh`: 作業コピーで確認してから反映するための一連のコマンド

pic_archiver-0.1.0/config.py

@@ -0,0 +1,26 @@
+from pathlib import Path
+import os
+
+def _root_path():
+    """Return the parent directory containing import/archive/raw."""
+    value = os.environ.get("PA_ROOT")
+    if not value:
+        return Path.cwd().resolve()
+    return Path(value).expanduser().resolve()
+
+
+ARCHIVE_ROOT = _root_path()
+
+def _env_path(*names, default):
+    """Return the first existing env var among names, otherwise default."""
+    for name in names:
+        value = os.environ.get(name)
+        if value:
+            return Path(value).expanduser().resolve()
+    return Path(default).resolve()
+
+
+# Defaults point at the current working directory unless explicitly overridden.
+IMPORT_DIR = _env_path("PA_IMPORT_DIR", default=ARCHIVE_ROOT / "import")
+ARCHIVE_DIR = _env_path("PA_ARCHIVE_DIR", default=ARCHIVE_ROOT / "archive")
+RAW_DIR = _env_path("PA_RAW_DIR", default=ARCHIVE_ROOT / "raw")

pic_archiver-0.1.0/main.py

@@ -0,0 +1,7 @@
+"""
+メインエントリーポイント - 写真・動画の自動整理
+"""
+from pic_archiver import main
+
+if __name__ == '__main__':
+    main()

pic_archiver-0.1.0/parc_cli.py

@@ -0,0 +1,259 @@
+from __future__ import annotations
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+import time
+from datetime import datetime
+from pathlib import Path
+
+from send2trash import send2trash
+
+
+def _absolute_path(value: str | Path) -> Path:
+    path = Path(value).expanduser()
+    if not path.is_absolute():
+        path = Path.cwd() / path
+    return path.resolve()
+
+
+def _paths() -> dict[str, Path]:
+    root_value = os.environ.get("PA_ROOT") or Path.cwd()
+    pa_root = _absolute_path(root_value)
+    return {
+        "pa_root": pa_root,
+        "import": _absolute_path(os.environ.get("PA_IMPORT_DIR") or pa_root / "import"),
+        "archive": _absolute_path(os.environ.get("PA_ARCHIVE_DIR") or pa_root / "archive"),
+        "raw": _absolute_path(os.environ.get("PA_RAW_DIR") or pa_root / "raw"),
+        "stage": _absolute_path(os.environ.get("PA_STAGE_ROOT") or pa_root / ".stage"),
+        "backup": _absolute_path(os.environ.get("PA_BACKUP_ROOT") or pa_root / ".backups"),
+    }
+
+
+def _file_count(path: Path) -> int:
+    if not path.exists():
+        return 0
+    return sum(1 for child in path.rglob("*") if child.is_file())
+
+
+def _print_progress_bar(done_count: int, total_count: int) -> None:
+    width = 20
+    percent = 100 if total_count <= 0 else min(done_count * 100 // total_count, 100)
+    display_done = min(done_count, total_count)
+    filled = percent * width // 100
+    bar = "#" * filled + "-" * (width - filled)
+    print(f"\r[{bar}] {percent:3d}% ({display_done}/{total_count} files)", end="", flush=True)
+
+
+def _run(command: list[str]) -> None:
+    subprocess.run(command, check=True)
+
+
+def _copy_with_hardlinks(step: int, name: str, source_dir: Path, target_dir: Path, reuse_stage: bool) -> None:
+    source_dir.mkdir(parents=True, exist_ok=True)
+    target_dir.mkdir(parents=True, exist_ok=True)
+    action = "Refreshing" if reuse_stage else "Copying"
+    print(f"[{step}/3] {action} {name}: {source_dir} -> {target_dir}")
+
+    command = [
+        "rsync",
+        "-a",
+        "--delete",
+        f"--link-dest={source_dir}",
+        f"{source_dir}/",
+        f"{target_dir}/",
+    ]
+    if name != "archive":
+        _run(command)
+        return
+
+    total_files = _file_count(source_dir)
+    if total_files == 0:
+        _run(command)
+        return
+
+    print("Archive refresh progress:" if reuse_stage else "Archive copy progress:")
+    process = subprocess.Popen(command)
+    while process.poll() is None:
+        _print_progress_bar(_file_count(target_dir), total_files)
+        time.sleep(1)
+
+    _print_progress_bar(total_files, total_files)
+    print()
+    if process.returncode:
+        raise subprocess.CalledProcessError(process.returncode, command)
+
+
+def prepare_command(args: argparse.Namespace) -> int:
+    paths = _paths()
+    stage_root = paths["stage"]
+    reuse_stage = False
+
+    if args.replace:
+        shutil.rmtree(stage_root, ignore_errors=True)
+    elif stage_root.exists():
+        reuse_stage = True
+
+    stage_root.mkdir(parents=True, exist_ok=True)
+    _copy_with_hardlinks(1, "import", paths["import"], stage_root / "import", reuse_stage)
+    _copy_with_hardlinks(2, "archive", paths["archive"], stage_root / "archive", reuse_stage)
+    _copy_with_hardlinks(3, "raw", paths["raw"], stage_root / "raw", reuse_stage)
+
+    print(f"Prepared stage: {stage_root}")
+    print("Next: parc run")
+    return 0
+
+
+def run_command(_: argparse.Namespace) -> int:
+    paths = _paths()
+    stage_root = paths["stage"]
+    if not (stage_root / "import").is_dir():
+        print(f"Stage import directory not found: {stage_root / 'import'}", file=sys.stderr)
+        print("Run parc prepare first.", file=sys.stderr)
+        return 1
+
+    os.environ["PA_IMPORT_DIR"] = str(stage_root / "import")
+    os.environ["PA_ARCHIVE_DIR"] = str(stage_root / "archive")
+    os.environ["PA_RAW_DIR"] = str(stage_root / "raw")
+    os.environ["PYTHONUNBUFFERED"] = "1"
+
+    from pic_archiver import main as archiver_main
+
+    archiver_main()
+    print("Staged archive update complete.")
+    print("Next: parc review")
+    return 0
+
+
+def review_command(_: argparse.Namespace) -> int:
+    paths = _paths()
+    stage_root = paths["stage"]
+    if not (stage_root / "archive").is_dir() or not (stage_root / "raw").is_dir():
+        print(f"Stage archive/raw directories not found: {stage_root}", file=sys.stderr)
+        print("Run parc prepare and parc run first.", file=sys.stderr)
+        return 1
+
+    print("Archive changes:", flush=True)
+    _run(["rsync", "-aivn", "--8-bit-output", "--delete", f"{stage_root / 'archive'}/", f"{paths['archive']}/"])
+    print()
+    print("Raw changes:", flush=True)
+    _run(["rsync", "-aivn", "--8-bit-output", "--delete", f"{stage_root / 'raw'}/", f"{paths['raw']}/"])
+    print()
+    print("No files were changed. To apply approved changes, run:")
+    print("  parc apply")
+    return 0
+
+
+def apply_command(_: argparse.Namespace) -> int:
+    paths = _paths()
+    stage_root = paths["stage"]
+    if not (stage_root / "archive").is_dir() or not (stage_root / "raw").is_dir():
+        print(f"Stage archive/raw directories not found: {stage_root}", file=sys.stderr)
+        return 1
+
+    backup_dir = paths["backup"] / datetime.now().strftime("%Y%m%d_%H%M%S")
+    print("This will update:")
+    print(f"  {paths['archive']}")
+    print(f"  {paths['raw']}")
+    print(flush=True)
+    print("Changed or deleted destination files will be kept in:")
+    print(f"  {backup_dir}")
+    print()
+
+    answer = input("Apply staged changes? [y/N] ")
+    if answer not in {"y", "Y", "yes", "YES"}:
+        print("Cancelled.")
+        return 1
+
+    (backup_dir / "archive").mkdir(parents=True, exist_ok=True)
+    (backup_dir / "raw").mkdir(parents=True, exist_ok=True)
+    _run(["rsync", "-a", "--delete", "--backup", f"--backup-dir={backup_dir / 'archive'}", f"{stage_root / 'archive'}/", f"{paths['archive']}/"])
+    _run(["rsync", "-a", "--delete", "--backup", f"--backup-dir={backup_dir / 'raw'}", f"{stage_root / 'raw'}/", f"{paths['raw']}/"])
+
+    print("Applied staged changes.")
+    if any(child.is_file() for child in backup_dir.rglob("*")):
+        print(f"Backup directory: {backup_dir}")
+    else:
+        shutil.rmtree(backup_dir)
+        print("No backup files were created.")
+    print(f"Kept stage for faster next run: {stage_root}")
+
+    if paths["import"].is_dir():
+        for entry in sorted(paths["import"].iterdir(), key=lambda path: path.name):
+            send2trash(str(entry))
+        print(f"Trashed import contents: {paths['import']}")
+    else:
+        print(f"Import directory not found, skipped trashing: {paths['import']}")
+    return 0
+
+
+def _run_with_progress(label: str, func, args: argparse.Namespace, keepalive: bool = True) -> int:
+    print(f"==> {label}")
+    if not keepalive:
+        return func(args)
+    start = time.monotonic()
+    last = start
+    result = func(args)
+    elapsed = int(time.monotonic() - start)
+    if elapsed >= 10 and time.monotonic() - last >= 10:
+        print(f"Still running ({elapsed}s): {label}")
+    return result
+
+
+def stage_command(args: argparse.Namespace) -> int:
+    result = _run_with_progress(
+        "Preparing stage with replacement" if args.replace else "Preparing stage",
+        prepare_command,
+        args,
+        keepalive=False,
+    )
+    if result:
+        return result
+    result = _run_with_progress("Running picture archiving in stage", run_command, args)
+    if result:
+        return result
+    result = _run_with_progress("Reviewing staged changes", review_command, args)
+    if result:
+        return result
+    if args.apply:
+        print("==> Applying staged changes")
+        return apply_command(args)
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="parc")
+    subparsers = parser.add_subparsers(dest="command")
+
+    stage = subparsers.add_parser("stage", help="Prepare a stage, run archiving, and show the review diff.")
+    stage.add_argument("--replace", action="store_true", help="Recreate the stage work tree.")
+    stage.add_argument("--apply", action="store_true", help="Apply staged changes after review.")
+    stage.set_defaults(func=stage_command)
+
+    prepare = subparsers.add_parser("prepare", help="Create the stage work tree.")
+    prepare.add_argument("--replace", action="store_true", help="Recreate the stage work tree.")
+    prepare.set_defaults(func=prepare_command)
+
+    subparsers.add_parser("run", help="Run archiving inside the existing stage.").set_defaults(func=run_command)
+    subparsers.add_parser("review", help="Show staged changes without applying them.").set_defaults(func=review_command)
+    subparsers.add_parser("apply", help="Apply staged changes to archive/raw.").set_defaults(func=apply_command)
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    if not hasattr(args, "func"):
+        parser.print_help()
+        return 0
+    try:
+        return args.func(args)
+    except subprocess.CalledProcessError as exc:
+        print(f"Command failed: {' '.join(str(part) for part in exc.cmd)}", file=sys.stderr)
+        return exc.returncode
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

pic_archiver-0.1.0/pic_archiver.egg-info/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: pic-archiver
+Version: 0.1.0
+Summary: Rename, sort, and safely archive exported picture and video files.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow
+Requires-Dist: piexif
+Requires-Dist: rawpy
+Requires-Dist: Send2Trash
+
+# PicArchiver
+
+Photos ライブラリなどから書き出した写真・動画をリネームし、`archive/` と `raw/` に安全に整理するためのツールです。
+
+## 1. ディレクトリ構成
+
+写真管理用の親ディレクトリを `PA_ROOT` と呼びます。`PA_ROOT` を指定しない場合は、`parc` を実行したカレントディレクトリが親になります。
+
+```text
+PA_ROOT/
+├── import/         # 処理対象ファイル
+├── archive/        # アーカイブ出力先（年/年-月-日 の階層で保存）
+├── raw/            # RAW ファイル出力先（拡張子ごとに分類）
+├── .stage/         # 反映前の作業コピー
+└── .backups/       # apply 時の退避先
+```
+
+## 2. 写真を書き出す
+
+1. 内蔵ライブラリを起動する
+2. すべての写真を選択する
+3. `PA_ROOT/import/` に書き出す
+
+## 3. ターミナルで実行する
+
+初回だけ、PyPI からインストールします。
+
+```bash
+pip install pic-archiver
+```
+
+PyPI に公開する前に GitHub から直接インストールする場合は、次のコマンドを使います。
+
+```bash
+pip install "git+https://github.com/Ryota-Nitto/PicArchiver.git"
+```
+
+最新版に更新したい場合は、再インストールします。
+
+```bash
+pip install --upgrade --force-reinstall pic-archiver
+```
+
+開発中にこのディレクトリの変更を即反映したい場合だけ、リポジトリのディレクトリで代わりに `pip install -e .` を使います。
+
+`parc` が見つからない場合は、`pip` の script 置き場に `PATH` を通します。Homebrew Python では `/opt/homebrew/bin`、ユーザーインストールでは `~/.local/bin` になることがあります。
+
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+以後は、どのディレクトリからでも実行できます。
+
+```bash
+# import, archive, raw を含む親ディレクトリを指定する場合（推奨）
+export PA_ROOT=/path/to/pictures-root
+
+# 変更をステージして、差分を確認
+parc stage
+
+# 問題なければ適用
+parc apply
+```
+
+`parc` 単体では使えるコマンド一覧を表示します。`parc stage` は作業コピーを作って整理処理を実行し、差分を表示します。`parc apply` は差分を反映し、上書き・削除される既存ファイルを `.backups/YYYYMMDD_HHMMSS/` に退避します。退避ファイルがなかった場合、今回分の空バックアップディレクトリは削除されます。成功後、`import/` の中身はゴミ箱へ移ります。`.stage` は次回を速くするため削除せずに残します。
+
+## 4. Option
+
+### 取り込みをやり直す
+
+`stage` したあとで、取り込みたくない画像や修正したい内容が見つかった場合は、`import/` を修正してから `parc stage` を再実行します。既存の `.stage` がある場合は、捨てずに同期して再利用します。
+
+完全に作り直したい場合だけ `--replace` を使います。
+
+```bash
+parc stage --replace
+```
+
+### ステージ後、即座に適用する
+
+```bash
+parc stage --apply
+```
+
+`parc apply` と同じ確認プロンプトが出ます。
+
+### Photos ライブラリを統合する
+
+1. 内蔵ライブラリを複製する
+2. 統合先の Photos ライブラリを起動する
+3. `ファイル > 読み込む` で複製した内蔵ライブラリを選択する
+4. すべての項目を読み込む
+5. ライブラリにすべての写真が読み込まれたことを確認する
+6. 内蔵ライブラリの写真・動画を全選択し、ゴミ箱へ移動する
+7. 複製した内蔵ライブラリを削除する
+
+### ディレクトリを個別に指定する
+
+`PA_ROOT` 配下の標準構成を使わない場合だけ指定します。
+
+```bash
+export PA_IMPORT_DIR=/path/to/import
+export PA_ARCHIVE_DIR=/path/to/archive
+export PA_RAW_DIR=/path/to/raw
+export PA_STAGE_ROOT=/path/to/stage
+export PA_BACKUP_ROOT=/path/to/backups
+```
+
+### 直接実行する（非推奨）
+
+`python main.py` を直接実行すると、指定した `PA_ROOT` または `PA_IMPORT_DIR` 内のファイルを直接リネーム・移動します。上書きされる対象はバックアップされません。
+
+```bash
+python main.py
+```
+
+### 出力例
+
+```text
+Processing files in: /path/to/project/import
+Processing: IMG_1234.JPG
+Moved: IMG_1234.JPG -> /path/to/project/archive/2026/2026-01-12/20260112_145828_001.jpg
+Done
+```
+
+## 主要ファイル
+
+- `main.py`: エントリーポイント
+- `parc`: どのディレクトリからでも実行するためのコマンド
+- `pic_archiver.py`: コア処理（日時抽出・リネーム・振り分け）
+- `config.py`: パス設定（デフォルトはこのリポジトリのディレクトリ、環境変数で上書き可）
+- `*.sh`: 作業コピーで確認してから反映するための一連のコマンド

pic_archiver-0.1.0/pic_archiver.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+config.py
+main.py
+parc_cli.py
+pic_archiver.py
+pyproject.toml
+pic_archiver.egg-info/PKG-INFO
+pic_archiver.egg-info/SOURCES.txt
+pic_archiver.egg-info/dependency_links.txt
+pic_archiver.egg-info/entry_points.txt
+pic_archiver.egg-info/requires.txt
+pic_archiver.egg-info/top_level.txt

pic_archiver-0.1.0/pic_archiver.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pic_archiver-0.1.0/pic_archiver.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+parc = parc_cli:main

pic_archiver-0.1.0/pic_archiver.egg-info/requires.txt

@@ -0,0 +1,4 @@
+Pillow
+piexif
+rawpy
+Send2Trash

pic_archiver-0.1.0/pic_archiver.egg-info/top_level.txt

@@ -0,0 +1,4 @@
+config
+main
+parc_cli
+pic_archiver

pic_archiver-0.1.0/pic_archiver.py

@@ -0,0 +1,512 @@
+"""
+PicArchiver - 写真・動画ファイルの自動整理・リネーム・アーカイブツール
+"""
+from pathlib import Path
+import os
+import datetime
+import subprocess
+from PIL import Image
+from PIL.ExifTags import TAGS
+import piexif
+from send2trash import send2trash
+
+from config import IMPORT_DIR, ARCHIVE_DIR, RAW_DIR
+
+RAW_SUBDIRS = {
+    ".cr2": "canon cr2",
+    ".nef": "nikon nef",
+    ".arw": "sony arw",
+}
+VIDEO_EXTS = {".mov", ".mp4", ".avi"}
+IMAGE_EXTS = {".jpeg", ".jpg", ".heic", ".png", ".webp"}
+
+
+def _normalize_image_ext(ext):
+    """出力用の拡張子を正規化する"""
+    ext = ext.lower()
+    if ext == ".jpg":
+        return ".jpeg"
+    return ext
+
+
+# ===== DateTime Extraction Functions =====
+
+def _normalize_subsec(subsec):
+    """subsec を必ず3桁にそろえ、短い場合は右側に 0 を足す"""
+    if subsec is None:
+        return "000"
+    if isinstance(subsec, bytes):
+        subsec = subsec.decode("UTF-8", errors="ignore")
+    subsec = str(subsec).strip()
+    if not subsec:
+        return "000"
+    # 1桁/2桁は右側に 0 を足し、4桁以上は先頭3桁を残す
+    if len(subsec) >= 3:
+        return subsec[:3]
+    return subsec.ljust(3, "0")
+
+def get_exif_of_image(file):
+    """EXIFデータを取得"""
+    with Image.open(str(file)) as im:
+        try:
+            exif = im._getexif()
+        except AttributeError:
+            return {}
+
+    if not exif:
+        return {}
+
+    exif_table = {}
+    for tag_id, value in exif.items():
+        tag = TAGS.get(tag_id, tag_id)
+        exif_table[tag] = value
+    return exif_table
+
+
+def get_datetime_exif(file):
+    """JPEG向け撮影日時の取得"""
+    exif_table = get_exif_of_image(file)
+    date = exif_table['DateTimeOriginal'].split(' ')[0].split(':')
+    time = exif_table['DateTimeOriginal'].split(' ')[1].split(':')
+    subsec = _normalize_subsec(exif_table.get('SubsecTimeOriginal', '000'))
+    return date, time, subsec
+
+
+def get_datetime_cr2exif(file):
+    """CR2向け撮影日時の取得"""
+    exif_dict = piexif.load(str(file))
+    datetime_str = exif_dict["Exif"][piexif.ExifIFD.DateTimeOriginal]
+    subsec = exif_dict["Exif"].get(piexif.ExifIFD.SubSecTimeOriginal, b"000")
+    datetime_str = datetime_str.decode("UTF-8")
+    subsec = subsec.decode("UTF-8")
+    date = datetime_str.split(' ')[0].split(':')
+    time = datetime_str.split(' ')[1].split(':')
+    subsec = _normalize_subsec(subsec)
+    return date, time, subsec
+
+
+def get_datetime_raw_exif(file):
+    """NEF/ARW向け撮影日時の取得"""
+    exif_table = get_exif_of_image(file)
+    date_time = exif_table.get('DateTimeOriginal')
+    if not date_time:
+        raise KeyError('DateTimeOriginal not found')
+
+    date = date_time.split(' ')[0].split(':')
+    time = date_time.split(' ')[1].split(':')
+    subsec = _normalize_subsec(exif_table.get('SubsecTimeOriginal', '000'))
+    return date, time, subsec
+
+
+def get_creation_datetime(file):
+    """ファイルシステムの作成日時を取得"""
+    bt = os.stat(file).st_birthtime
+    d = datetime.datetime.fromtimestamp(bt)
+    return _datetime_to_parts(d)
+
+
+def _get_filesystem_datetimes(file):
+    """ファイルシステムから取得できる作成日時・変更日時を返す"""
+    stat = Path(file).stat()
+    candidates = [datetime.datetime.fromtimestamp(stat.st_mtime)]
+    birthtime = getattr(stat, "st_birthtime", None)
+    if birthtime is not None:
+        candidates.append(datetime.datetime.fromtimestamp(birthtime))
+    return candidates
+
+
+def get_filesystem_oldest_datetime(file):
+    """作成日時・変更日時のうち古い方を取得"""
+    return _datetime_to_parts(min(_get_filesystem_datetimes(file)))
+
+
+def _datetime_to_parts(d):
+    """datetimeをファイル名用の日付・時刻・ミリ秒に変換"""
+    year = d.year
+    month = d.month
+    day = d.day
+    hour = d.hour
+    minute = d.minute
+    second = d.second
+    subsec = d.microsecond // 1000
+
+    year = str(year)
+    month = f"{month:02d}" if isinstance(month, int) else f"{int(month):02d}"
+    day = f"{day:02d}" if isinstance(day, int) else f"{int(day):02d}"
+    hour = f"{hour:02d}" if isinstance(hour, int) else f"{int(hour):02d}"
+    minute = f"{minute:02d}" if isinstance(minute, int) else f"{int(minute):02d}"
+    second = f"{second:02d}" if isinstance(second, int) else f"{int(second):02d}"
+    
+    subsec = _normalize_subsec(subsec)
+    
+    return [year, month, day], [hour, minute, second], subsec
+
+
+def _parse_exiftool_datetime(value):
+    """exiftoolの日時文字列をdatetimeに変換"""
+    if not value:
+        return None
+
+    value = value.strip()
+    date_part, time_part = value.split(" ", 1)
+    year, month, day = [int(part) for part in date_part.split(":")]
+
+    parts = time_part.split()
+    time_value = parts[0]
+    timezone_value = parts[1] if len(parts) > 1 else None
+
+    offset = None
+    if len(time_value) >= 6 and time_value[-6] in ["+", "-"]:
+        offset = time_value[-6:]
+        time_value = time_value[:-6]
+    elif time_value.upper().endswith("Z"):
+        offset = "Z"
+        time_value = time_value[:-1]
+    elif timezone_value:
+        offset = timezone_value
+
+    hour_str, minute_str, second_str = time_value.split(":")
+    if "." in second_str:
+        second_whole, fraction = second_str.split(".", 1)
+        microsecond = int(fraction[:6].ljust(6, "0"))
+    else:
+        second_whole = second_str
+        microsecond = 0
+
+    tzinfo = None
+    if offset and offset.upper() != "Z":
+        sign = 1 if offset[0] == "+" else -1
+        offset_hour = int(offset[1:3])
+        offset_minute = int(offset[4:6])
+        tzinfo = datetime.timezone(
+            sign * datetime.timedelta(hours=offset_hour, minutes=offset_minute)
+        )
+    elif offset and offset.upper() == "Z":
+        tzinfo = datetime.timezone.utc
+
+    d = datetime.datetime(
+        year,
+        month,
+        day,
+        int(hour_str),
+        int(minute_str),
+        int(second_whole),
+        microsecond,
+        tzinfo=tzinfo,
+    )
+    if d.tzinfo:
+        d = d.astimezone()
+    return d.replace(tzinfo=None)
+
+
+def _parse_filename_datetime(file):
+    """YYYYMMDD_HHMMSS_sss形式のファイル名からdatetimeを取得"""
+    stem = Path(file).stem
+    parts = stem.split("_")
+    if len(parts) < 3:
+        return None
+    date_value, time_value, subsec = parts[:3]
+    if not (len(date_value) == 8 and len(time_value) == 6):
+        return None
+    if not (date_value.isdigit() and time_value.isdigit() and subsec[:3].isdigit()):
+        return None
+    try:
+        return datetime.datetime(
+            int(date_value[0:4]),
+            int(date_value[4:6]),
+            int(date_value[6:8]),
+            int(time_value[0:2]),
+            int(time_value[2:4]),
+            int(time_value[4:6]),
+            int(subsec[:3].ljust(3, "0")) * 1000,
+        )
+    except ValueError:
+        return None
+
+
+def _parts_to_datetime(date, time, subsec):
+    return datetime.datetime(
+        int(date[0]),
+        int(date[1]),
+        int(date[2]),
+        int(time[0]),
+        int(time[1]),
+        int(time[2]),
+        int(_normalize_subsec(subsec)) * 1000,
+    )
+
+
+def _preserve_filename_timestamp_if_close(file, datetime_info):
+    """動画メタデータとファイル名が近い場合は、ファイル名のミリ秒を保持"""
+    filename_dt = _parse_filename_datetime(file)
+    if not filename_dt:
+        return datetime_info
+
+    date, time, subsec = datetime_info
+    metadata_dt = _parts_to_datetime(date, time, subsec)
+    if abs((filename_dt - metadata_dt).total_seconds()) <= 4:
+        return _datetime_to_parts(filename_dt)
+
+    return datetime_info
+
+
+def _run_exiftool_datetimes(file, tags, quicktime_utc=False):
+    command = ["exiftool", "-s", "-s", "-s"]
+    if quicktime_utc:
+        command.extend(["-api", "QuickTimeUTC=1"])
+    command.extend(tags)
+    command.append(str(file))
+    try:
+        result = subprocess.run(command, capture_output=True, text=True, check=True)
+    except (FileNotFoundError, subprocess.SubprocessError):
+        return []
+
+    dates = []
+    for line in result.stdout.splitlines():
+        try:
+            d = _parse_exiftool_datetime(line)
+        except Exception:
+            continue
+        if d:
+            dates.append(d)
+
+    return dates
+
+
+def _run_exiftool_datetime(file, tags, quicktime_utc=False):
+    dates = _run_exiftool_datetimes(file, tags, quicktime_utc=quicktime_utc)
+    return dates[0] if dates else None
+
+
+def _oldest_datetime_info(file, metadata_datetimes):
+    """メタデータと作成/変更日時の候補から最古の日時を採用する"""
+    candidates = [d for d in metadata_datetimes if d]
+    candidates.extend(_get_filesystem_datetimes(file))
+    return _preserve_filename_timestamp_if_close(file, _datetime_to_parts(min(candidates)))
+
+
+def _select_quicktime_create_date(file):
+    """QuickTimeのCreateDateをローカル/UTC解釈のうちファイル変更日時に近い方で読む"""
+    quicktime_local = _run_exiftool_datetime(file, ["-QuickTime:CreateDate"], quicktime_utc=False)
+    quicktime_utc = _run_exiftool_datetime(file, ["-QuickTime:CreateDate"], quicktime_utc=True)
+    if quicktime_local and quicktime_utc:
+        file_modify = datetime.datetime.fromtimestamp(Path(file).stat().st_mtime)
+        local_delta = abs((file_modify - quicktime_local).total_seconds())
+        utc_delta = abs((file_modify - quicktime_utc).total_seconds())
+        return quicktime_utc if utc_delta < local_delta else quicktime_local
+    return quicktime_local or quicktime_utc
+
+
+def get_datetime_video_metadata(file):
+    """動画の内部メタデータと作成/変更日時から最古の日時を取得"""
+    metadata_datetimes = []
+
+    timezone_tags = ["-Keys:CreationDate", "-UserData:DateTimeOriginal"]
+    metadata_datetimes.extend(_run_exiftool_datetimes(file, timezone_tags, quicktime_utc=True))
+
+    if Path(file).suffix.lower() == ".mp4":
+        metadata_datetimes.extend(_run_exiftool_datetimes(
+            file,
+            ["-Composite:SubSecDateTimeOriginal", "-ExifIFD:DateTimeOriginal", "-QuickTime:CreateDate"],
+            quicktime_utc=True,
+        ))
+
+    quicktime_create_date = _select_quicktime_create_date(file)
+    if quicktime_create_date:
+        metadata_datetimes.append(quicktime_create_date)
+
+    return _oldest_datetime_info(file, metadata_datetimes)
+
+
+def get_datetime_image_metadata(file):
+    """HEIC/PNG/WebPのメタデータと作成/変更日時から最古の日時を取得"""
+    metadata_datetimes = _run_exiftool_datetimes(
+        file,
+        [
+            "-Composite:SubSecDateTimeOriginal",
+            "-EXIF:DateTimeOriginal",
+            "-QuickTime:CreateDate",
+            "-Keys:CreationDate",
+        ],
+        quicktime_utc=True,
+    )
+    return _oldest_datetime_info(file, metadata_datetimes)
+
+
+def get_datetime(file):
+    """ファイルの撮影日時を取得（形式に応じた処理）"""
+    file = Path(file)
+    _, ext = os.path.splitext(str(file))
+    ext = ext.lower()
+    
+    try:
+        if ext in ['.jpeg', '.jpg']:
+            try:
+                return get_datetime_exif(file)
+            except Exception:
+                return get_creation_datetime(file)
+        elif ext == '.cr2':
+            try:
+                return get_datetime_cr2exif(file)
+            except Exception:
+                return get_creation_datetime(file)
+        elif ext in ['.nef', '.arw']:
+            try:
+                return get_datetime_raw_exif(file)
+            except Exception:
+                return get_creation_datetime(file)
+        elif ext in ['.mov', '.mp4', '.avi']:
+            try:
+                return get_datetime_video_metadata(file)
+            except Exception:
+                return get_filesystem_oldest_datetime(file)
+        elif ext in ['.heic', '.png', '.webp']:
+            try:
+                return get_datetime_image_metadata(file)
+            except Exception:
+                return get_filesystem_oldest_datetime(file)
+        else:
+            print(f"{file} is not a supported image or video file")
+            return None
+    except Exception as e:
+        print(f"Error getting datetime for {file}: {e}")
+        return None
+
+
+# ===== File Renaming Functions =====
+
+def _build_filename(year, month, day, hour, minute, second, subsec, ext):
+    """統一フォーマットでファイル名を生成"""
+    return f"{year}{month}{day}_{hour}{minute}{second}_{subsec}{ext}"
+
+
+def _find_existing_event_archive_dir(year, month, day):
+    """同日付のイベント名付き archive フォルダがあれば返す"""
+    date_prefix = f"{year}-{month}-{day}"
+    year_dir = ARCHIVE_DIR / year
+    if not year_dir.exists():
+        return None
+
+    candidates = []
+    for child in year_dir.iterdir():
+        if not child.is_dir():
+            continue
+        if not child.name.startswith(date_prefix):
+            continue
+        # "yyyy-mm-dd" ちょうどのフォルダより、イベント名付きフォルダを優先する
+        suffix = child.name[len(date_prefix):].strip()
+        candidates.append((0 if suffix else 1, child.name, child))
+
+    if not candidates:
+        return None
+
+    candidates.sort()
+    return candidates[0][2]
+
+
+def _unique_target_path(target_path, source):
+    """同名ファイルがある場合は同じパスへ上書きする"""
+    source = Path(source).resolve()
+    target_path = Path(target_path)
+    if not target_path.exists() or target_path.resolve() == source:
+        return target_path
+    return target_path
+
+
+def rename_and_sort(file):
+    """ファイルのリネームと整理"""
+    file = Path(file)
+    _, ext = os.path.splitext(str(file))
+    ext = _normalize_image_ext(ext)
+    
+    datetime_info = get_datetime(file)
+    if not datetime_info:
+        print(f"Skipping {file.name} - unable to extract datetime")
+        return
+    
+    date, time, subsec = datetime_info
+    year = date[0]
+    month = date[1]
+    day = date[2]
+    hour = time[0]
+    minute = time[1]
+    second = time[2]
+    
+    filename = _build_filename(year, month, day, hour, minute, second, subsec, ext)
+    
+    # RAW系ファイルは拡張子ごとのサブディレクトリへ、それ以外はARCHIVE_DIRへ
+    if ext in RAW_SUBDIRS:
+        target_dir = RAW_DIR / RAW_SUBDIRS[ext]
+    else:
+        # 既存の "yyyy-mm-dd イベント名" フォルダがあれば優先して使う
+        target_dir = _find_existing_event_archive_dir(year, month, day)
+        if target_dir is None:
+            # なければ従来通り日付フォルダを作る
+            target_dir = ARCHIVE_DIR / year / f"{year}-{month}-{day}"
+    
+    target_dir.mkdir(parents=True, exist_ok=True)
+    target_path = target_dir / filename
+    
+    target_path = _unique_target_path(target_path, file)
+
+    file.rename(target_path)
+    print(f"Moved: {file.name} -> {target_path}")
+
+
+def remove_same_file(directories):
+    """同じベースネームの重複ファイルを削除"""
+    for directory in directories:
+        os.chdir(directory)
+        files = os.listdir()
+        bases = []
+        exts = []
+        for file in files:
+            base, ext = os.path.splitext(file)
+            ext = ext.lower()
+            for i in range(len(bases)):
+                if bases[i] == base and exts[i] == ext:
+                    send2trash(Path(file))
+            bases.append(base)
+            exts.append(ext)
+
+
+def remove_number(file):
+    """ファイル名の末尾の番号をリセット"""
+    base, ext = os.path.splitext(file)
+    if base.endswith(')'):
+        base = base[:-4]
+        os.renames(file, f"{base}{ext}")
+
+
+def lower_name(file):
+    """拡張子を小文字に"""
+    base, ext = os.path.splitext(file)
+    ext = _normalize_image_ext(ext)
+    os.renames(file, f"{base}{ext}")
+
+
+# ===== Main Function =====
+
+def main():
+    """メイン処理 - IMPORT_DIRのファイルを処理"""
+    if not IMPORT_DIR.exists():
+        raise FileNotFoundError(f"Import directory not found: {IMPORT_DIR}")
+
+    print(f"Processing files in: {IMPORT_DIR}", flush=True)
+    files = sorted([f for f in IMPORT_DIR.iterdir() if f.is_file() and not f.name.startswith(".")])
+    
+    if not files:
+        print("No files to process.", flush=True)
+        return
+    
+    total = len(files)
+    print(f"Found {total} file(s) to process.", flush=True)
+    for index, file_path in enumerate(files, start=1):
+        print(f"[{index}/{total}] Processing: {file_path.name}", flush=True)
+        rename_and_sort(file_path)
+    
+    print("Done", flush=True)
+
+
+if __name__ == '__main__':
+    main()

pic_archiver-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pic-archiver"
+version = "0.1.0"
+description = "Rename, sort, and safely archive exported picture and video files."
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+  "Pillow",
+  "piexif",
+  "rawpy",
+  "Send2Trash",
+]
+
+[project.scripts]
+parc = "parc_cli:main"
+
+[tool.setuptools]
+py-modules = ["config", "main", "parc_cli", "pic_archiver"]

pic_archiver-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+