plexflow 0.0.140__py3-none-any.whl → 0.0.142__py3-none-any.whl

plexflow/core/plex/watchlist/watchlist.py

@@ -18,6 +18,6 @@ def get_watchlist(**kwargs) -> MediaContainer:
         None
 
     """
-    context = PlexAuthorizedRequestContext(base_url="https://metadata.provider.plex.tv")
+    context = PlexAuthorizedRequestContext(base_url="https://discover.provider.plex.tv")
     response = context.get(endpoint="/library/sections/watchlist/all", **kwargs)
     return from_json(response.content.decode("utf-8"))

plexflow/utils/video/sync.py

@@ -0,0 +1,103 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+import argparse
+import logging
+import os
+import shutil
+import subprocess
+import sys
+
+
+# --- Custom Exceptions for Clearer Error Handling ---
+class SubSyncError(Exception):
+    """Base exception for this tool."""
+    pass
+
+class FFSubsyncExecutableError(SubSyncError):
+    """Raised when the ffsubsync executable is not found."""
+    pass
+
+class FFSubsyncProcessError(SubSyncError):
+    """Raised when the ffsubsync process fails."""
+    def __init__(self, message, returncode, stdout, stderr):
+        super().__init__(message)
+        self.returncode = returncode
+        self.stdout = stdout
+        self.stderr = stderr
+
+def synchronize_subtitle(
+    video_path: str,
+    subtitle_path: str,
+    output_path: str = None,
+    ffsubsync_path: str = 'ffsubsync'
+) -> str:
+    """
+    Synchronizes a subtitle file with a video using ffsubsync.
+
+    Args:
+        video_path: Path to the reference video file.
+        subtitle_path: Path to the subtitle file to synchronize.
+        output_path: Path for the synchronized output file. If None, a default
+                     is generated next to the input subtitle.
+        ffsubsync_path: Path to the ffsubsync executable.
+
+    Returns:
+        The path to the successfully created synchronized subtitle file.
+
+    Raises:
+        FFSubsyncExecutableError: If ffsubsync or its dependencies are not found.
+        FileNotFoundError: If the input video or subtitle files do not exist.
+        FFSubsyncProcessError: If the ffsubsync process returns a non-zero exit code.
+    """
+    # 1. --- Pre-flight Checks ---
+    logging.info("Performing pre-flight checks...")
+    if not shutil.which(ffsubsync_path):
+        raise FFSubsyncExecutableError(
+            f"'{ffsubsync_path}' command not found. Please ensure ffsubsync is "
+            "installed (pip install ffsubsync) and in your system's PATH."
+        )
+
+    for fpath in [video_path, subtitle_path]:
+        if not os.path.exists(fpath):
+            raise FileNotFoundError(f"Input file not found at '{fpath}'")
+
+    # 2. --- Determine Output Path ---
+    if output_path is None:
+        base, ext = os.path.splitext(subtitle_path)
+        output_path = f"{base}_synced{ext}"
+
+    logging.info(f"Reference video: {video_path}")
+    logging.info(f"Input subtitle:  {subtitle_path}")
+    logging.info(f"Output path:     {output_path}")
+
+    # 3. --- Construct and Run the Command ---
+    command = [
+        ffsubsync_path,
+        video_path,
+        "-i", subtitle_path,
+        "-o", output_path,
+    ]
+    logging.debug(f"Executing command: {' '.join(command)}")
+
+    try:
+        result = subprocess.run(
+            command,
+            check=True,  # Raises CalledProcessError on non-zero exit codes
+            capture_output=True,
+            text=True,
+            encoding='utf-8',
+        )
+        # ffsubsync logs to stderr, so we log it for debug purposes
+        logging.debug("ffsubsync process output (stderr):\n%s", result.stderr)
+
+    except subprocess.CalledProcessError as e:
+        raise FFSubsyncProcessError(
+            "ffsubsync failed during execution.",
+            returncode=e.returncode,
+            stdout=e.stdout,
+            stderr=e.stderr
+        ) from e
+
+    logging.info(f"Successfully synchronized subtitle to '{output_path}'")
+    return output_path

{plexflow-0.0.140.dist-info → plexflow-0.0.142.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: plexflow
-Version: 0.0.140
+Version: 0.0.142
 Summary: A short description of the package.
 License: MIT
 Keywords: keyword1,keyword2,keyword3

{plexflow-0.0.140.dist-info → plexflow-0.0.142.dist-info}/RECORD

@@ -323,9 +323,9 @@ plexflow/core/plex/token/__pycache__/auto_token.cpython-312.pyc,sha256=1uRpJbyiW
 plexflow/core/plex/token/auto_token.py,sha256=CcAd6KcnI7ul5TxpdYVw_7T0ab2K3YTi8DcqHtjKt4Q,3615
 plexflow/core/plex/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plexflow/core/plex/utils/__pycache__/__init__.cpython-311.pyc,sha256=2b2qu_365BZcXqAU5s34hzrvKC0s2_W8OReMDlBr3Sc,174
-plexflow/core/plex/utils/__pycache__/__init__.cpython-312.pyc,sha256=c0Yk4iDt3y2vEr_P7Vp3CWPuAinLOeQq592IL-w1AiA,162
+plexflow/core/plex/utils/__pycache__/__init__.cpython-312.pyc,sha256=kDTyAiv1LvPBl4_1L0O5-mL4S3Vxj12MsP0Cv8L2NC0,160
 plexflow/core/plex/utils/__pycache__/paginated.cpython-311.pyc,sha256=7WkEf0cLkNXyI5BHrAZndqSoR6NM-V0wW1Oi5uSIf0M,1523
-plexflow/core/plex/utils/__pycache__/paginated.cpython-312.pyc,sha256=vxpUDtw11STCsmwUC8tiqp_6FwVe3tn-Day_K5OPZHE,1385
+plexflow/core/plex/utils/__pycache__/paginated.cpython-312.pyc,sha256=5dnkFug_9eFqj3zXm6CWPMw_N9tYwWy68F0mntRyWhM,1383
 plexflow/core/plex/utils/paginated.py,sha256=4w-Q2kpkCmsCYnxJazoltvvpLq-c2hzyS4DWsGHkeoM,1171
 plexflow/core/plex/watchlist/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plexflow/core/plex/watchlist/__pycache__/__init__.cpython-311.pyc,sha256=5GlwuWEZYpXuoiIJkYyX4h6wxwzMD9DUosgJ5Gw_6ZU,178
@@ -333,9 +333,9 @@ plexflow/core/plex/watchlist/__pycache__/__init__.cpython-312.pyc,sha256=FlojeaU
 plexflow/core/plex/watchlist/__pycache__/datatypes.cpython-311.pyc,sha256=raf3JEsEqRmBYH2FOfY4Wujcdmobp94rviGft5Z7jCQ,8849
 plexflow/core/plex/watchlist/__pycache__/datatypes.cpython-312.pyc,sha256=iOPW1Mhf5SuUFHMzATc2pqN_uF-_NAmcCrzeUReQEt0,7606
 plexflow/core/plex/watchlist/__pycache__/watchlist.cpython-311.pyc,sha256=CocErWnueQIN8ReWjjpteDvF7mDtsdlxvFe4TaMiKvY,1274
-plexflow/core/plex/watchlist/__pycache__/watchlist.cpython-312.pyc,sha256=zLFP394Wxxnb67jOZlUcFlh4KAelz_gyO-WbzcBTJHs,1294
+plexflow/core/plex/watchlist/__pycache__/watchlist.cpython-312.pyc,sha256=hZpx1d7RgxUamD-kxd0qdcYs6EXwaS4Od53SUgG2FbU,1415
 plexflow/core/plex/watchlist/datatypes.py,sha256=Ukri8nM16-IKxPxia4n45syjtc401nMWSd3hgjdrJSE,5193
-plexflow/core/plex/watchlist/watchlist.py,sha256=3vtkxvjVWmVWLSRxptZoek0eeAX2tU0mQ-IsT6TBwB4,851
+plexflow/core/plex/watchlist/watchlist.py,sha256=8WB_2zvf2xCc9IdOnUCjAIiFtCyCGK2hU4ORu72Lzjw,851
 plexflow/core/storage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plexflow/core/storage/__pycache__/__init__.cpython-311.pyc,sha256=kKE5c5UA7CgoFly4hrI7a7s-ztUxg3zLnkjgpShAj2k,171
 plexflow/core/storage/__pycache__/__init__.cpython-312.pyc,sha256=bkMvtPZ53O_tyElEvOeGWcjGR-DEufOi4f0zHQeJFXo,157
@@ -725,9 +725,9 @@ plexflow/utils/torrent/extract/torrentquest.py,sha256=gQn9GanFM5SXvpwjcyRu0XgTZ2
 plexflow/utils/torrent/files.py,sha256=XJxvFedZQb8H-wSzNIZI_2nUOT-pqr6MwgYcoty0yA0,2285
 plexflow/utils/torrent/hash.py,sha256=yaVAXj6t4qouNVUdZ-ulgrhTSLsp7DOggyB6sanCPX8,3162
 plexflow/utils/transcribe/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-plexflow/utils/transcribe/__pycache__/__init__.cpython-312.pyc,sha256=uz1p6LU0YlLilrO5jq7FocDsrHhLldFGpTAFwicVPlU,163
+plexflow/utils/transcribe/__pycache__/__init__.cpython-312.pyc,sha256=AEEtGtOBmfH0I2QiG4MzzInGJracQnS7YyNLJ5Gwg2s,161
 plexflow/utils/transcribe/__pycache__/speech2text.cpython-311.pyc,sha256=WcYPF8JcosrCCwmIFl0eamZpasICUBJ_MeUS_Ok7zUs,1632
-plexflow/utils/transcribe/__pycache__/speech2text.cpython-312.pyc,sha256=dY538EbFsJXzZr3139_TrtuLytcmculX_yBhi9DeKaM,2842
+plexflow/utils/transcribe/__pycache__/speech2text.cpython-312.pyc,sha256=DqZEkcJR1rubjolqlFp6Y-Ed2lh-MTSoHMUS4N_6sRA,2822
 plexflow/utils/transcribe/speech2text.py,sha256=ldcZqx18Yr8aa-y5sw7WaEKCci9mvBI0z06YQqJemnU,3547
 plexflow/utils/video/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plexflow/utils/video/__pycache__/__init__.cpython-312.pyc,sha256=SA7I28R8t-m5Q4uA7laJCUz3JHqVgUtkvewvrAk1qVk,156
@@ -735,7 +735,8 @@ plexflow/utils/video/__pycache__/audio.cpython-312.pyc,sha256=kmzGDCHSC1hWyHwRut
 plexflow/utils/video/__pycache__/subtitle.cpython-312.pyc,sha256=PCjpCLydGXaRsQy6cikhgsEs8WlComfOoYPiLFqfVMA,2515
 plexflow/utils/video/audio.py,sha256=Pd8OuQHX2QN-lc5iYkB0Vo1OEHmTcvDYH-uKud1f1q4,5262
 plexflow/utils/video/subtitle.py,sha256=qPvvBjlPj0fynJJvGJgGeKt9ey26R-cF6EoLaYt9iXU,1333
-plexflow-0.0.140.dist-info/METADATA,sha256=27yq2pNtHNgLWCkYfnzdGNgCnHd_Abzl_oMDJ7c-nmo,2971
-plexflow-0.0.140.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-plexflow-0.0.140.dist-info/entry_points.txt,sha256=9RJC3ikOQORHNOn573EdwJOBUnFU_4EGHbtNUM5pjjY,1557
-plexflow-0.0.140.dist-info/RECORD,,
+plexflow/utils/video/sync.py,sha256=LqBA0M-9MIozYNtZA4BzQfNjl8uWoV7doxhzKC6mlxU,3347
+plexflow-0.0.142.dist-info/METADATA,sha256=UKKl8iO9rQVAgo2QogikQJOMV-llDRXmtzX7ES3qahI,2971
+plexflow-0.0.142.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+plexflow-0.0.142.dist-info/entry_points.txt,sha256=9RJC3ikOQORHNOn573EdwJOBUnFU_4EGHbtNUM5pjjY,1557
+plexflow-0.0.142.dist-info/RECORD,,