jellyplex-sync 0.3.2__tar.gz → 0.3.4__tar.gz

{jellyplex_sync-0.3.2 → jellyplex_sync-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jellyplex-sync
-Version: 0.3.2
+Version: 0.3.4
 Summary: Convert your media library between Jellyfin and Plex formats by creating a hard-linked mirror
 Author: Stefan Schönberger
 Author-email: Stefan Schönberger <stefan@sniner.dev>
@@ -44,7 +44,7 @@ The easiest way to install the CLI is via [uv](https://docs.astral.sh/uv/):
 uv tool install jellyplex-sync
 ```
 
-This places `jellyplex-sync` on your `PATH` in an isolated environment. `pipx install jellyplex-sync` works the same way if you prefer pipx.
+This places `jellyplex` and `jellyplex-sync` on your `PATH` in an isolated environment. `pipx install jellyplex-sync` works the same way if you prefer pipx.
 
 ### Docker
 
@@ -62,17 +62,19 @@ docker build -t jellyplex-sync .
 
 ## Usage
 
-The CLI is split into four subcommands:
+The main CLI is `jellyplex` with four subcommands:
 
-- **`sync`** — mirror a source library into the target layout (the historical operation; this is also the default if you omit the subcommand).
-- **`diff`** — read-only comparison of source and target. No filesystem changes. Useful before deleting your source after a migration.
-- **`plan`** — show the Plan a sync would execute (text or `--json`), without touching either side. Pre-flight check before sync, or machine-readable input for tooling.
-- **`import`** — **(experimental)** import video files from a staging area into a structured library. See below.
+- **`jellyplex sync`** — mirror a source library into the target layout.
+- **`jellyplex diff`** — read-only comparison of source and target. No filesystem changes. Useful before deleting your source after a migration.
+- **`jellyplex plan`** — show the Plan a sync would execute (text or `--json`), without touching either side. Pre-flight check before sync, or machine-readable input for tooling.
+- **`jellyplex import`** — **(experimental)** import video files from a staging area into a structured library. See below.
+
+For backward compatibility, `jellyplex-sync` is also installed as a standalone command that does exactly what `jellyplex sync` does — same options, no subcommand needed.
 
 ### `sync`
 
 ```bash
-jellyplex-sync sync [OPTIONS] /path/to/source/library /path/to/target/library
+jellyplex sync [OPTIONS] /path/to/source/library /path/to/target/library
 ```
 
 The first positional is the source library, the second is the target. By default the tool auto-detects whether the source is a Jellyfin or Plex layout and converts to the other format.
@@ -101,31 +103,31 @@ Use `--copy` when source and target are on different filesystems (NAS to local d
 Mirror a Jellyfin library into a new Plex structure:
 
 ```bash
-jellyplex-sync sync --create ~/Media/Jellyfin ~/Media/Plex
+jellyplex sync --create ~/Media/Jellyfin ~/Media/Plex
 ```
 
 Migration with cleanup (target becomes a clean mirror):
 
 ```bash
-jellyplex-sync sync --delete --create ~/Media/Jellyfin ~/Media/Plex
+jellyplex sync --delete --create ~/Media/Jellyfin ~/Media/Plex
 ```
 
 Cross-filesystem copy with safe re-runs:
 
 ```bash
-jellyplex-sync sync --copy --create /mnt/nas/Movies /mnt/local/Plex
+jellyplex sync --copy --create /mnt/nas/Movies /mnt/local/Plex
 ```
 
 Dry-run a verbose, full sync with deletion:
 
 ```bash
-jellyplex-sync sync --dry-run --verbose --delete --create ~/Media/Jellyfin ~/Media/Plex
+jellyplex sync --dry-run --verbose --delete --create ~/Media/Jellyfin ~/Media/Plex
 ```
 
 ### `diff`
 
 ```bash
-jellyplex-sync diff [OPTIONS] /path/to/source/library /path/to/target/library
+jellyplex diff [OPTIONS] /path/to/source/library /path/to/target/library
 ```
 
 Compares the two libraries without touching anything. Reports movies that exist only on one side, file-level differences inside shared movies, translation losses (Plex labels with no Jellyfin equivalent, for example), and entries the scanner ignored.
@@ -141,13 +143,13 @@ Exit codes follow the Unix `diff` convention:
 Verify a target is a complete mirror before deleting the source:
 
 ```bash
-jellyplex-sync diff ~/Media/Jellyfin ~/Media/Plex
+jellyplex diff ~/Media/Jellyfin ~/Media/Plex
 ```
 
 ### `plan`
 
 ```bash
-jellyplex-sync plan [OPTIONS] /path/to/source/library /path/to/target/library
+jellyplex plan [OPTIONS] /path/to/source/library /path/to/target/library
 ```
 
 Shows the Plan a sync would execute — every movie folder, every translated video filename, every loose file, every asset subdirectory — without touching either filesystem. Useful as a pre-flight check ("will any movies clash? what gets translated?") or as a machine-readable input for tooling with `--json`.
@@ -164,13 +166,13 @@ Exit codes:
 Pre-flight a sync, see exactly which target filenames would be created:
 
 ```bash
-jellyplex-sync plan ~/Media/Plex ~/Media/Jellyfin
+jellyplex plan ~/Media/Plex ~/Media/Jellyfin
 ```
 
 Machine-readable, with `jq` to find videos that needed disambiguation:
 
 ```bash
-jellyplex-sync plan --json ~/Media/Plex ~/Media/Jellyfin \
+jellyplex plan --json ~/Media/Plex ~/Media/Jellyfin \
     | jq '.movies[].videos[] | select(.disambiguation) | {source, target_name, disambiguation}'
 ```
 
@@ -179,7 +181,7 @@ jellyplex-sync plan --json ~/Media/Plex ~/Media/Jellyfin \
 > ⚠️ **This subcommand is experimental.** The exact behaviour may change in future releases as real-world use cases become clearer. Always start with `--dry-run`.
 
 ```bash
-jellyplex-sync import [OPTIONS] /path/to/staging /path/to/target/library
+jellyplex import [OPTIONS] /path/to/staging /path/to/target/library
 ```
 
 Imports video files from a staging area — a flat directory (or directory tree) where properly named video files have been dumped without the one-folder-per-movie structure that `sync` expects. Files are grouped by their parsed movie identity (title, year, provider ID) and placed into the correct movie folder in the target library.
@@ -208,13 +210,13 @@ Other flags: `--dry-run`, `--create`, `--source-format`, `--target-format`, `-v`
 Move Plex-named video files into a new Jellyfin library:
 
 ```bash
-jellyplex-sync import --create /mnt/staging /mnt/library/Jellyfin
+jellyplex import --create /mnt/staging /mnt/library/Jellyfin
 ```
 
 Preview first, keeping the source:
 
 ```bash
-jellyplex-sync import --copy --dry-run /mnt/staging /mnt/library/Jellyfin
+jellyplex import --copy --dry-run /mnt/staging /mnt/library/Jellyfin
 ```
 
 ### JSON output
@@ -243,40 +245,24 @@ The schema (still evolving — pin a version when consuming):
 Show every file that would be replaced (with full paths):
 
 ```bash
-jellyplex-sync sync --json --dry-run /src /dst \
+jellyplex sync --json --dry-run /src /dst \
     | jq '.events[] | select(.action == "replace") | {source, target}'
 ```
 
 Verify nothing important gets deleted before running a migration with `--delete`:
 
 ```bash
-jellyplex-sync sync --json --dry-run --delete /src /dst \
+jellyplex sync --json --dry-run --delete /src /dst \
     | jq '.events[] | select(.action == "remove")'
 ```
 
 Action distribution:
 
 ```bash
-jellyplex-sync sync --json --dry-run /src /dst \
+jellyplex sync --json --dry-run /src /dst \
     | jq '[.events[].action] | group_by(.) | map({action: .[0], count: length})'
 ```
 
-### Default subcommand
-
-For backward compatibility, omitting the subcommand is treated as an implicit `sync` (as long as the first argument is a positional, not a flag):
-
-```bash
-jellyplex-sync ~/Media/Jellyfin ~/Media/Plex
-```
-
-is equivalent to
-
-```bash
-jellyplex-sync sync ~/Media/Jellyfin ~/Media/Plex
-```
-
-If you start with a flag, you must spell out `sync` explicitly.
-
 ### Docker
 
 ```bash

{jellyplex_sync-0.3.2 → jellyplex_sync-0.3.4}/README.md

@@ -28,7 +28,7 @@ The easiest way to install the CLI is via [uv](https://docs.astral.sh/uv/):
 uv tool install jellyplex-sync
 ```
 
-This places `jellyplex-sync` on your `PATH` in an isolated environment. `pipx install jellyplex-sync` works the same way if you prefer pipx.
+This places `jellyplex` and `jellyplex-sync` on your `PATH` in an isolated environment. `pipx install jellyplex-sync` works the same way if you prefer pipx.
 
 ### Docker
 
@@ -46,17 +46,19 @@ docker build -t jellyplex-sync .
 
 ## Usage
 
-The CLI is split into four subcommands:
+The main CLI is `jellyplex` with four subcommands:
 
-- **`sync`** — mirror a source library into the target layout (the historical operation; this is also the default if you omit the subcommand).
-- **`diff`** — read-only comparison of source and target. No filesystem changes. Useful before deleting your source after a migration.
-- **`plan`** — show the Plan a sync would execute (text or `--json`), without touching either side. Pre-flight check before sync, or machine-readable input for tooling.
-- **`import`** — **(experimental)** import video files from a staging area into a structured library. See below.
+- **`jellyplex sync`** — mirror a source library into the target layout.
+- **`jellyplex diff`** — read-only comparison of source and target. No filesystem changes. Useful before deleting your source after a migration.
+- **`jellyplex plan`** — show the Plan a sync would execute (text or `--json`), without touching either side. Pre-flight check before sync, or machine-readable input for tooling.
+- **`jellyplex import`** — **(experimental)** import video files from a staging area into a structured library. See below.
+
+For backward compatibility, `jellyplex-sync` is also installed as a standalone command that does exactly what `jellyplex sync` does — same options, no subcommand needed.
 
 ### `sync`
 
 ```bash
-jellyplex-sync sync [OPTIONS] /path/to/source/library /path/to/target/library
+jellyplex sync [OPTIONS] /path/to/source/library /path/to/target/library
 ```
 
 The first positional is the source library, the second is the target. By default the tool auto-detects whether the source is a Jellyfin or Plex layout and converts to the other format.
@@ -85,31 +87,31 @@ Use `--copy` when source and target are on different filesystems (NAS to local d
 Mirror a Jellyfin library into a new Plex structure:
 
 ```bash
-jellyplex-sync sync --create ~/Media/Jellyfin ~/Media/Plex
+jellyplex sync --create ~/Media/Jellyfin ~/Media/Plex
 ```
 
 Migration with cleanup (target becomes a clean mirror):
 
 ```bash
-jellyplex-sync sync --delete --create ~/Media/Jellyfin ~/Media/Plex
+jellyplex sync --delete --create ~/Media/Jellyfin ~/Media/Plex
 ```
 
 Cross-filesystem copy with safe re-runs:
 
 ```bash
-jellyplex-sync sync --copy --create /mnt/nas/Movies /mnt/local/Plex
+jellyplex sync --copy --create /mnt/nas/Movies /mnt/local/Plex
 ```
 
 Dry-run a verbose, full sync with deletion:
 
 ```bash
-jellyplex-sync sync --dry-run --verbose --delete --create ~/Media/Jellyfin ~/Media/Plex
+jellyplex sync --dry-run --verbose --delete --create ~/Media/Jellyfin ~/Media/Plex
 ```
 
 ### `diff`
 
 ```bash
-jellyplex-sync diff [OPTIONS] /path/to/source/library /path/to/target/library
+jellyplex diff [OPTIONS] /path/to/source/library /path/to/target/library
 ```
 
 Compares the two libraries without touching anything. Reports movies that exist only on one side, file-level differences inside shared movies, translation losses (Plex labels with no Jellyfin equivalent, for example), and entries the scanner ignored.
@@ -125,13 +127,13 @@ Exit codes follow the Unix `diff` convention:
 Verify a target is a complete mirror before deleting the source:
 
 ```bash
-jellyplex-sync diff ~/Media/Jellyfin ~/Media/Plex
+jellyplex diff ~/Media/Jellyfin ~/Media/Plex
 ```
 
 ### `plan`
 
 ```bash
-jellyplex-sync plan [OPTIONS] /path/to/source/library /path/to/target/library
+jellyplex plan [OPTIONS] /path/to/source/library /path/to/target/library
 ```
 
 Shows the Plan a sync would execute — every movie folder, every translated video filename, every loose file, every asset subdirectory — without touching either filesystem. Useful as a pre-flight check ("will any movies clash? what gets translated?") or as a machine-readable input for tooling with `--json`.
@@ -148,13 +150,13 @@ Exit codes:
 Pre-flight a sync, see exactly which target filenames would be created:
 
 ```bash
-jellyplex-sync plan ~/Media/Plex ~/Media/Jellyfin
+jellyplex plan ~/Media/Plex ~/Media/Jellyfin
 ```
 
 Machine-readable, with `jq` to find videos that needed disambiguation:
 
 ```bash
-jellyplex-sync plan --json ~/Media/Plex ~/Media/Jellyfin \
+jellyplex plan --json ~/Media/Plex ~/Media/Jellyfin \
     | jq '.movies[].videos[] | select(.disambiguation) | {source, target_name, disambiguation}'
 ```
 
@@ -163,7 +165,7 @@ jellyplex-sync plan --json ~/Media/Plex ~/Media/Jellyfin \
 > ⚠️ **This subcommand is experimental.** The exact behaviour may change in future releases as real-world use cases become clearer. Always start with `--dry-run`.
 
 ```bash
-jellyplex-sync import [OPTIONS] /path/to/staging /path/to/target/library
+jellyplex import [OPTIONS] /path/to/staging /path/to/target/library
 ```
 
 Imports video files from a staging area — a flat directory (or directory tree) where properly named video files have been dumped without the one-folder-per-movie structure that `sync` expects. Files are grouped by their parsed movie identity (title, year, provider ID) and placed into the correct movie folder in the target library.
@@ -192,13 +194,13 @@ Other flags: `--dry-run`, `--create`, `--source-format`, `--target-format`, `-v`
 Move Plex-named video files into a new Jellyfin library:
 
 ```bash
-jellyplex-sync import --create /mnt/staging /mnt/library/Jellyfin
+jellyplex import --create /mnt/staging /mnt/library/Jellyfin
 ```
 
 Preview first, keeping the source:
 
 ```bash
-jellyplex-sync import --copy --dry-run /mnt/staging /mnt/library/Jellyfin
+jellyplex import --copy --dry-run /mnt/staging /mnt/library/Jellyfin
 ```
 
 ### JSON output
@@ -227,40 +229,24 @@ The schema (still evolving — pin a version when consuming):
 Show every file that would be replaced (with full paths):
 
 ```bash
-jellyplex-sync sync --json --dry-run /src /dst \
+jellyplex sync --json --dry-run /src /dst \
     | jq '.events[] | select(.action == "replace") | {source, target}'
 ```
 
 Verify nothing important gets deleted before running a migration with `--delete`:
 
 ```bash
-jellyplex-sync sync --json --dry-run --delete /src /dst \
+jellyplex sync --json --dry-run --delete /src /dst \
     | jq '.events[] | select(.action == "remove")'
 ```
 
 Action distribution:
 
 ```bash
-jellyplex-sync sync --json --dry-run /src /dst \
+jellyplex sync --json --dry-run /src /dst \
     | jq '[.events[].action] | group_by(.) | map({action: .[0], count: length})'
 ```
 
-### Default subcommand
-
-For backward compatibility, omitting the subcommand is treated as an implicit `sync` (as long as the first argument is a positional, not a flag):
-
-```bash
-jellyplex-sync ~/Media/Jellyfin ~/Media/Plex
-```
-
-is equivalent to
-
-```bash
-jellyplex-sync sync ~/Media/Jellyfin ~/Media/Plex
-```
-
-If you start with a flag, you must spell out `sync` explicitly.
-
 ### Docker
 
 ```bash

{jellyplex_sync-0.3.2 → jellyplex_sync-0.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "jellyplex-sync"
-version = "0.3.2"
+version = "0.3.4"
 description = "Convert your media library between Jellyfin and Plex formats by creating a hard-linked mirror"
 authors = [{ name = "Stefan Schönberger", email = "stefan@sniner.dev" }]
 requires-python = ">=3.11"
@@ -17,6 +17,7 @@ classifiers = [
 dependencies = []
 
 [project.scripts]
+jellyplex = "jellyplex_sync.cli.main:main"
 jellyplex-sync = "jellyplex_sync.cli.sync:main"
 
 [dependency-groups]

jellyplex_sync-0.3.2/src/jellyplex_sync/cli/sync.py → jellyplex_sync-0.3.4/src/jellyplex_sync/cli/main.py

@@ -7,12 +7,10 @@ import sys
 
 import jellyplex_sync as jp
 
-_SUBCOMMANDS = {"sync", "diff", "plan", "import"}
-
 
 def _build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
-        prog="jellyplex-sync",
+        prog="jellyplex",
         description="Convert a media library between Plex and Jellyfin layouts.",
     )
 
@@ -41,7 +39,7 @@ def _build_parser() -> argparse.ArgumentParser:
     sync_p = sub.add_parser(
         "sync",
         parents=[common],
-        help="Mirror a source library into the target layout (default).",
+        help="Mirror a source library into the target layout.",
     )
     _add_io_args(sync_p)
     mode = sync_p.add_mutually_exclusive_group()
@@ -157,24 +155,9 @@ def _add_io_args(p: argparse.ArgumentParser) -> None:
     )
 
 
-def _inject_default_subcommand(argv: list[str]) -> list[str]:
-    """If the first positional argument isn't a known subcommand, treat the
-    call as `sync ...`. Keeps the historical invocation `jellyplex-sync
-    <source> <target>` working alongside the new `jellyplex-sync sync ...`.
-    """
-    if not argv:
-        return argv
-    first = argv[0]
-    if first.startswith("-"):
-        return argv
-    if first in _SUBCOMMANDS:
-        return argv
-    return ["sync", *argv]
-
-
 def main() -> None:
     parser = _build_parser()
-    args = parser.parse_args(_inject_default_subcommand(sys.argv[1:]))
+    args = parser.parse_args()
 
     # Under --json, INFO chatter on stderr distracts from the JSON document
     # on stdout. Quiet stderr to WARNING by default; --verbose or --debug
@@ -239,8 +222,15 @@ def _do_sync(args: argparse.Namespace) -> int:
 
     if args.json:
         assert stats is not None and reporter is not None
-        source_short, target_short = _resolve_formats_for_json(args)
         from jellyplex_sync.json_output import write_sync_json
+        from jellyplex_sync.sync import _resolve_formats
+
+        resolved = _resolve_formats(
+            pathlib.Path(args.source),
+            args.source_format,
+            args.target_format,
+        )
+        source_short, target_short = resolved if resolved else ("?", "?")
 
         write_sync_json(
             sys.stdout,
@@ -309,10 +299,7 @@ def _do_plan(args: argparse.Namespace) -> int:
 def _do_import(args: argparse.Namespace) -> int:
     from jellyplex_sync.sync import import_media
 
-    if args.mode == "move":
-        materializer = jp.MoveMaterializer()
-    else:
-        materializer = jp.CopyMaterializer()
+    materializer = jp.MoveMaterializer() if args.mode == "move" else jp.CopyMaterializer()
 
     try:
         return import_media(
@@ -334,20 +321,5 @@ def _do_import(args: argparse.Namespace) -> int:
         return 99
 
 
-def _resolve_formats_for_json(args: argparse.Namespace) -> tuple[str, str]:
-    """Re-run the same format resolution `sync()` did so the JSON payload
-    reports the formats that were actually used. Returns ('?', '?') if
-    resolution fails — sync() will already have logged the error and the
-    caller's exit code reflects it."""
-    import pathlib
-
-    from jellyplex_sync.sync import _resolve_formats
-
-    resolved = _resolve_formats(
-        pathlib.Path(args.source), args.source_format, args.target_format
-    )
-    return resolved if resolved else ("?", "?")
-
-
 if __name__ == "__main__":
     main()

jellyplex_sync-0.3.4/src/jellyplex_sync/cli/sync.py

@@ -0,0 +1,186 @@
+#!/usr/bin/python3
+"""Backward-compatible ``jellyplex-sync`` entry point.
+
+Provides the same interface as the original single-command CLI: flat
+argument list, no subcommands.
+"""
+
+from __future__ import annotations
+
+import argparse
+import logging
+import pathlib
+import sys
+
+import jellyplex_sync as jp
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    format_choices = [
+        jp.JellyfinLibraryReader.shortname(),
+        jp.PlexLibraryReader.shortname(),
+        "auto",
+    ]
+
+    parser = argparse.ArgumentParser(
+        prog="jellyplex-sync",
+        description="Mirror a source library into the target layout.",
+    )
+    parser.add_argument(
+        "-v",
+        "--verbose",
+        action="store_true",
+        help="Show more information messages.",
+    )
+    parser.add_argument(
+        "--debug",
+        action="store_true",
+        help="Show debug messages.",
+    )
+    parser.add_argument(
+        "--json",
+        action="store_true",
+        help="Emit a machine-readable JSON document on stdout. Logs continue to go to stderr.",
+    )
+    parser.add_argument("source", help="Source media library path.")
+    parser.add_argument("target", help="Target media library path.")
+    parser.add_argument(
+        "--source-format",
+        type=str,
+        choices=format_choices,
+        default="auto",
+        help="Source library format ('auto' detects from the source layout).",
+    )
+    parser.add_argument(
+        "--target-format",
+        type=str,
+        choices=format_choices,
+        default="auto",
+        help="Target library format ('auto' picks the opposite of the source).",
+    )
+
+    mode = parser.add_mutually_exclusive_group()
+    mode.add_argument(
+        "--hardlink",
+        dest="mode",
+        action="store_const",
+        const="hardlink",
+        help="Use hardlinks (default; needs source and target on the same filesystem).",
+    )
+    mode.add_argument(
+        "--copy",
+        dest="mode",
+        action="store_const",
+        const="copy",
+        help="Copy files; on re-runs skip files whose size and mtime already match.",
+    )
+    mode.add_argument(
+        "--force-copy",
+        dest="mode",
+        action="store_const",
+        const="force-copy",
+        help="Always copy and overwrite, regardless of existing target state.",
+    )
+    parser.set_defaults(mode="hardlink")
+    parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Show what would be done, don't change anything on disk.",
+    )
+    parser.add_argument(
+        "--delete",
+        action="store_true",
+        help="Remove stray folders from the target library.",
+    )
+    parser.add_argument(
+        "--create",
+        action="store_true",
+        help="Create the target library directory if it doesn't exist.",
+    )
+
+    return parser
+
+
+def main() -> None:
+    parser = _build_parser()
+    args = parser.parse_args()
+
+    if args.debug:
+        level = logging.DEBUG
+    elif args.json and not args.verbose:
+        level = logging.WARNING
+    else:
+        level = logging.INFO
+
+    logging.basicConfig(
+        level=level,
+        stream=sys.stderr,
+        format="%(levelname)s: %(asctime)s -- %(message)s",
+    )
+
+    if args.mode == "hardlink":
+        materializer: jp.FileMaterializer = jp.HardlinkMaterializer()
+    elif args.mode == "copy":
+        materializer = jp.CopyMaterializer()
+    elif args.mode == "force-copy":
+        materializer = jp.ForceCopyMaterializer()
+    else:
+        raise ValueError(f"unknown materialization mode: {args.mode!r}")
+
+    from jellyplex_sync.library import CollectingReporter
+    from jellyplex_sync.sync import LibraryStats
+
+    stats = LibraryStats() if args.json else None
+    reporter = CollectingReporter() if args.json else None
+
+    try:
+        rc = jp.sync(
+            args.source,
+            args.target,
+            dry_run=args.dry_run,
+            delete=args.delete,
+            create=args.create,
+            verbose=args.verbose,
+            debug=args.debug,
+            source_format=args.source_format,
+            target_format=args.target_format,
+            materializer=materializer,
+            reporter=reporter,
+            stats=stats,
+        )
+    except KeyboardInterrupt:
+        logging.info("INTERRUPTED")
+        sys.exit(10)
+    except Exception as exc:
+        logging.error("Exception: %s", exc)
+        sys.exit(99)
+
+    if args.json:
+        assert stats is not None and reporter is not None
+        from jellyplex_sync.json_output import write_sync_json
+        from jellyplex_sync.sync import _resolve_formats
+
+        resolved = _resolve_formats(
+            pathlib.Path(args.source),
+            args.source_format,
+            args.target_format,
+        )
+        source_short, target_short = resolved if resolved else ("?", "?")
+
+        write_sync_json(
+            sys.stdout,
+            source_path=pathlib.Path(args.source),
+            source_format=source_short,
+            target_path=pathlib.Path(args.target),
+            target_format=target_short,
+            dry_run=args.dry_run,
+            exit_code=rc,
+            stats=stats,
+            drops=reporter.drops,
+        )
+
+    sys.exit(rc)
+
+
+if __name__ == "__main__":
+    main()

{jellyplex_sync-0.3.2 → jellyplex_sync-0.3.4}/src/jellyplex_sync/jellyfin.py

@@ -125,7 +125,7 @@ class JellyfinLibraryWriter(_JellyfinBase):
             parts.append(f"[{key}id-{value}]")
 
         # Report any other provider IDs we couldn't fit; Jellyfin tolerates
-        # multiple bracket-IDs in the folder name, but jellyplex-sync only
+        # multiple bracket-IDs in the folder name, but jellyplex only
         # emits one for now.
         for key, value in movie.attributes.items():
             if primary and key == primary[0]:

{jellyplex_sync-0.3.2 → jellyplex_sync-0.3.4}/src/jellyplex_sync/materializer.py

@@ -2,7 +2,7 @@
 
 A `FileMaterializer` knows how to make a target path reflect a source path.
 The first (and currently only) implementation, `HardlinkMaterializer`, uses
-filesystem hardlinks — the behavior jellyplex-sync has always had. Copy
+filesystem hardlinks — the behavior this tool has always had. Copy
 backends arrive in a later step of Paket 4.
 
 The seam exists so the CLI can swap materialization strategies (`--copy`,

{jellyplex_sync-0.3.2 → jellyplex_sync-0.3.4}/src/jellyplex_sync/sync.py

@@ -6,6 +6,7 @@ import re
 from collections.abc import Callable
 from dataclasses import dataclass, field
 
+from .discover import FlatDiscoverer
 from .jellyfin import JellyfinLibraryReader, JellyfinLibraryWriter
 from .library import (
     ACCEPTED_VIDEO_SUFFIXES,
@@ -19,7 +20,6 @@ from .library import (
     Reporter,
     dedupe_drops,
 )
-from .discover import FlatDiscoverer
 from .materializer import FileMaterializer, HardlinkMaterializer, MoveMaterializer
 from .planner import Planner
 from .plex import PlexLibraryReader, PlexLibraryWriter