ytdl-sub 2025.11.28.post1__py3-none-any.whl → 2025.12.6__py3-none-any.whl

ytdl_sub/__init__.py

@@ -1 +1 @@
-__pypi_version__ = "2025.11.28.post1";__local_version__ = "2025.11.28+8d5d2be"
+__pypi_version__ = "2025.12.06";__local_version__ = "2025.12.06+a5ae695"

ytdl_sub/config/config_validator.py

@@ -12,6 +12,8 @@ from ytdl_sub.config.defaults import DEFAULT_FFPROBE_PATH
 from ytdl_sub.config.defaults import DEFAULT_LOCK_DIRECTORY
 from ytdl_sub.config.defaults import MAX_FILE_NAME_BYTES
 from ytdl_sub.prebuilt_presets import PREBUILT_PRESETS
+from ytdl_sub.utils.exceptions import SubscriptionPermissionError
+from ytdl_sub.utils.file_handler import FileHandler
 from ytdl_sub.validators.file_path_validators import FFmpegFileValidator
 from ytdl_sub.validators.file_path_validators import FFprobeFileValidator
 from ytdl_sub.validators.strict_dict_validator import StrictDictValidator
@@ -147,6 +149,12 @@ class ConfigOptions(StrictDictValidator):
             key="file_name_max_bytes", validator=IntValidator, default=MAX_FILE_NAME_BYTES
         )
 
+        if not FileHandler.is_path_writable(self.working_directory):
+            raise SubscriptionPermissionError(
+                "ytdl-sub does not have permissions to the working directory: "
+                f"{self.working_directory}"
+            )
+
     @property
     def working_directory(self) -> str:
         """

ytdl_sub/config/preset_options.py

@@ -8,6 +8,9 @@ from ytdl_sub.config.overrides import Overrides
 from ytdl_sub.config.plugin.plugin_operation import PluginOperation
 from ytdl_sub.config.validators.options import OptionsDictValidator
 from ytdl_sub.entries.script.variable_definitions import VARIABLES as v
+from ytdl_sub.utils.exceptions import SubscriptionPermissionError
+from ytdl_sub.utils.exceptions import ValidationException
+from ytdl_sub.utils.file_handler import FileHandler
 from ytdl_sub.validators.file_path_validators import OverridesStringFormatterFilePathValidator
 from ytdl_sub.validators.file_path_validators import StringFormatterFileNameValidator
 from ytdl_sub.validators.string_datetime import StringDatetimeValidator
@@ -57,12 +60,24 @@ class YTDLOptions(UnstructuredOverridesDictFormatterValidator):
     def to_native_dict(self, overrides: Overrides) -> Dict:
         """
         Materializes the entire ytdl-options dict from OverrideStringFormatters into
-        native python
+        native python.
         """
-        return {
+        out = {
             key: overrides.apply_overrides_formatter_to_native(val)
             for key, val in self.dict.items()
         }
+        if "cookiefile" in out:
+            if not FileHandler.is_file_existent(out["cookiefile"]):
+                raise ValidationException(
+                    f"Specified cookiefile {out['cookiefile']} but it does not exist as a file."
+                )
+
+            if not FileHandler.is_file_readable(out["cookiefile"]):
+                raise SubscriptionPermissionError(
+                    f"Cannot read cookiefile {out['cookiefile']} due to permissions issue."
+                )
+
+        return out
 
 
 # Disable for proper docstring formatting

ytdl_sub/subscriptions/base_subscription.py

@@ -10,6 +10,8 @@ from ytdl_sub.config.preset_options import OutputOptions
 from ytdl_sub.config.preset_options import YTDLOptions
 from ytdl_sub.downloaders.url.validators import MultiUrlValidator
 from ytdl_sub.entries.variables.override_variables import SubscriptionVariables
+from ytdl_sub.utils.exceptions import SubscriptionPermissionError
+from ytdl_sub.utils.file_handler import FileHandler
 from ytdl_sub.utils.file_handler import FileHandlerTransactionLog
 from ytdl_sub.utils.logger import Logger
 from ytdl_sub.ytdl_additions.enhanced_download_archive import EnhancedDownloadArchive
@@ -94,6 +96,12 @@ class BaseSubscription(ABC):
 
         self._exception: Optional[Exception] = None
 
+        if not FileHandler.is_path_writable(self.output_directory):
+            raise SubscriptionPermissionError(
+                "ytdl-sub does not have write permissions to the output directory: "
+                f"{self.output_directory}"
+            )
+
     @property
     def download_archive(self) -> EnhancedDownloadArchive:
         """

ytdl_sub/utils/exceptions.py

@@ -40,3 +40,7 @@ class FileNotDownloadedException(ValueError):
 
 class ExperimentalFeatureNotEnabled(ValidationException):
     """Feature is not enabled for usage"""
+
+
+class SubscriptionPermissionError(ValidationException):
+    """Early-caught permission error"""

ytdl_sub/utils/file_handler.py

@@ -379,6 +379,36 @@ class FileHandler:
         """
         return self._file_handler_transaction_log
 
+    @classmethod
+    def is_path_writable(cls, src_file_path: Union[str, Path]) -> bool:
+        """
+        Check whether a path is writable. If it does not exist, try to find the base directory
+        and check permissions on that.
+        """
+        path = os.path.abspath(src_file_path)
+
+        while not os.path.exists(path):
+            new_path = os.path.dirname(path)
+            if new_path == path:  # reached root
+                break
+            path = new_path
+
+        return os.access(path, os.W_OK)
+
+    @classmethod
+    def is_file_existent(cls, file_path: Union[str, Path]) -> bool:
+        """
+        Check whether a file exists.
+        """
+        return os.path.isfile(file_path)
+
+    @classmethod
+    def is_file_readable(cls, file_path: Union[str, Path]) -> bool:
+        """
+        Check whether a file exists and is readable.
+        """
+        return cls.is_file_existent(file_path) and os.access(file_path, os.R_OK)
+
     @classmethod
     def copy(cls, src_file_path: Union[str, Path], dst_file_path: Union[str, Path]):
         """

{ytdl_sub-2025.11.28.post1.dist-info → ytdl_sub-2025.12.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ytdl-sub
-Version: 2025.11.28.post1
+Version: 2025.12.6
 Summary: Automate downloading metadata generation with YoutubeDL
 Author: Jesse Bannon
 License:                     GNU GENERAL PUBLIC LICENSE

{ytdl_sub-2025.11.28.post1.dist-info → ytdl_sub-2025.12.6.dist-info}/RECORD

@@ -1,4 +1,4 @@
-ytdl_sub/__init__.py,sha256=S6dNcqTDairr1YsTIC2vDAyTwaSw4B88XoXSQwM5YuE,79
+ytdl_sub/__init__.py,sha256=KSVxAu5wwrT1Qp3VE6mgj9HLsY1j3VHzpYx1HZHKitI,73
 ytdl_sub/main.py,sha256=4Rf9wXxSKW7IPnWqG5YtTZ814PjP1n9WtoFDivaainE,1004
 ytdl_sub/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ytdl_sub/cli/entrypoint.py,sha256=XXjUH4HiOP_BB2ZA_bNcyt5-o6YLAdZmj0EP3xtOtD8,9496
@@ -10,11 +10,11 @@ ytdl_sub/cli/parsers/dl.py,sha256=Fzc9nstJ8QXGhCOzSW1_v3cZHfSiVV2coFq3L1eTHtQ,90
 ytdl_sub/cli/parsers/main.py,sha256=-H4A9DPARVWe2tCH3rOJiybevlmH3VYhS10yz3683zk,7245
 ytdl_sub/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ytdl_sub/config/config_file.py,sha256=SQtVrMIUq2z3WwJVOed4y84JBMQ8aa4pbiBB0Y-YY4M,2781
-ytdl_sub/config/config_validator.py,sha256=NWPoCb6qjOom-YQamjho4UAIMSC43LRIT28W0rriXds,9424
+ytdl_sub/config/config_validator.py,sha256=W1dvQD8wI7VOmGOHyaliu8DC6HOjfoGsgUw2MURTZOM,9797
 ytdl_sub/config/defaults.py,sha256=NTwzlKDkks1LDGNjFMxh91fw5E6T6d_zGsCwODNYJxo,1152
 ytdl_sub/config/overrides.py,sha256=0L6WaVtgqGqLvSuUkn4lbll9E8IboJlA7iJteIfN4Mo,8918
 ytdl_sub/config/preset.py,sha256=cp_oCyR78pHqYIakUNvNnwuFfFUq1YzitvIav5QW3Jw,8517
-ytdl_sub/config/preset_options.py,sha256=RgwnpIQqe_17YiaqaI-qlQ12RnkVGTdawXR_e6gYhuQ,13523
+ytdl_sub/config/preset_options.py,sha256=PBinBBRLTaO4B5Q9bW2WUHAd0-x8fVIUqodOIm-py-c,14207
 ytdl_sub/config/plugin/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ytdl_sub/config/plugin/plugin.py,sha256=ugUyDnjLKcBy7lOpTbVKaGSuUMvzyyQx3DIcbv3eTkQ,4721
 ytdl_sub/config/plugin/plugin_mapping.py,sha256=xx9K2EReIU7zdPlogjvIkowy8J2R4TEhMNJyR7_1aE0,7846
@@ -121,7 +121,7 @@ ytdl_sub/script/utils/exceptions.py,sha256=cag5ZLM6as1w-RsrOwO-oe4YFpwlFu_8U0QNG
 ytdl_sub/script/utils/name_validation.py,sha256=ckTZqzeC-PTJRfAJbFLTNEgKchPA6YqLMS9Z280WUeQ,1830
 ytdl_sub/script/utils/type_checking.py,sha256=9EKWE1mWPOlmXWiWTZw-bCRV0FlYk22tNKlgEM6wU_0,10393
 ytdl_sub/subscriptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ytdl_sub/subscriptions/base_subscription.py,sha256=-zq4WgpsOq493fEHal8XmC6mLQiA3tvaeuFRyRW_7Es,6803
+ytdl_sub/subscriptions/base_subscription.py,sha256=JRVyJIoHIt0I7NoEMqYd9FsZU3QF9i8HQAjzQeg_CPM,7179
 ytdl_sub/subscriptions/subscription.py,sha256=wfzOYVkzmsSH1KYbAMRi6Nhrb2pRaXdhILle7H0hcas,5127
 ytdl_sub/subscriptions/subscription_download.py,sha256=-eLbClw88tleLdUgP7TtPtnqroE3Zzdx2XLQrgapMDc,18190
 ytdl_sub/subscriptions/subscription_validators.py,sha256=tSN8YPLkIYXQbmWQ3M6U7xHpNjPn8rtNR9wSLIE2kzM,13606
@@ -131,9 +131,9 @@ ytdl_sub/thread/log_entries_downloaded_listener.py,sha256=7gPJSyvbM0W9XjliHgzmWF
 ytdl_sub/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ytdl_sub/utils/chapters.py,sha256=zLNndxmVdNg3LKV7HeNEImC3rWlpsoBPkZ1-TFQBD0Q,8754
 ytdl_sub/utils/datetime.py,sha256=M9OTwGDlPWlu4E637P34Tc_23c-MtEUTiiU9eVI5pKQ,1100
-ytdl_sub/utils/exceptions.py,sha256=mu6F5eneFo-oEIcmjEJV4aCK2pc7vKucBtmMz91HN68,1219
+ytdl_sub/utils/exceptions.py,sha256=P4OTl8dQXYoHv_AzdPz8VM-i3O3tUh8Kn_F5-qrUxTk,1317
 ytdl_sub/utils/ffmpeg.py,sha256=1av8AEvVraIXROk9Q__UWVFNLvXGKJZnFTufnLnPfR8,6513
-ytdl_sub/utils/file_handler.py,sha256=chP9i2Cf14vV9FHTIN2YqmAJF_yxV1jDZzDeVsJ8PWE,17259
+ytdl_sub/utils/file_handler.py,sha256=-uBhEjym9UeCEqJtGjWeKveDZfDME7XOOKiqtpV4Rxo,18211
 ytdl_sub/utils/file_lock.py,sha256=VlDl8QjBEUAHDBHsfp7Q0tR1Me0fFYELqzMtlyZ0MO4,2790
 ytdl_sub/utils/file_path.py,sha256=7RWc4fGj7HH6srzGJ5ph1l5euJfWpIX-2cyC-03YXEs,2539
 ytdl_sub/utils/logger.py,sha256=g_23ddk1WpQ3-_MOHz-Rlz7xCydK66BbtqkualX1zAQ,8593
@@ -158,9 +158,9 @@ ytdl_sub/validators/string_select_validator.py,sha256=KFXNKWX2J80WGt08m5gVYphPMH
 ytdl_sub/validators/validators.py,sha256=X9AkECdngEXcME_C25njHaOjtqbfEJMED2eG9Qy3UPs,9352
 ytdl_sub/ytdl_additions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ytdl_sub/ytdl_additions/enhanced_download_archive.py,sha256=Lsc0wjHdx9d8dYJCskZYAUGDAQ_QzQ-_xbQlyrBSzfk,24884
-ytdl_sub-2025.11.28.post1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-ytdl_sub-2025.11.28.post1.dist-info/METADATA,sha256=pc1Bdfyuw36jWFP0PUCDg9gT8vAVeNKL7essp3Oi7VY,51427
-ytdl_sub-2025.11.28.post1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ytdl_sub-2025.11.28.post1.dist-info/entry_points.txt,sha256=K3T5235NlAI-WLmHCg5tzLZHqc33OLN5IY5fOGc9t10,48
-ytdl_sub-2025.11.28.post1.dist-info/top_level.txt,sha256=6z-JWazl6jXspC2DNyxOnGnEqYyGzVbgcBDoXfbkUhI,9
-ytdl_sub-2025.11.28.post1.dist-info/RECORD,,
+ytdl_sub-2025.12.6.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+ytdl_sub-2025.12.6.dist-info/METADATA,sha256=DjARA2YOVqdCHLqljTVOuLmRHG8q6oqJrK_dUGfOxLk,51420
+ytdl_sub-2025.12.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ytdl_sub-2025.12.6.dist-info/entry_points.txt,sha256=K3T5235NlAI-WLmHCg5tzLZHqc33OLN5IY5fOGc9t10,48
+ytdl_sub-2025.12.6.dist-info/top_level.txt,sha256=6z-JWazl6jXspC2DNyxOnGnEqYyGzVbgcBDoXfbkUhI,9
+ytdl_sub-2025.12.6.dist-info/RECORD,,