Improve docs and security defaults

src/core/providers/streaming/doodstream.py

@@ -1,5 +1,8 @@
+"""Resolve Doodstream embed players into direct download URLs."""
+
 import random
 import re
+import string
 import time
 from typing import Any
 
@@ -8,6 +11,12 @@ from fake_useragent import UserAgent
 
 from .Provider import Provider
 
+# Precompiled regex patterns to extract the ``pass_md5`` endpoint and the
+# session token embedded in the obfuscated player script. Compiling once keeps
+# repeated invocations fast and documents the parsing intent.
+PASS_MD5_PATTERN = re.compile(r"\$\.get\('([^']*/pass_md5/[^']*)'")
+TOKEN_PATTERN = re.compile(r"token=([a-zA-Z0-9]+)")
+
 
 class Doodstream(Provider):
     """Doodstream video provider implementation."""
@@ -33,17 +42,15 @@ class Doodstream(Provider):
             "Referer": "https://dood.li/",
         }
 
-        def extract_data(pattern: str, content: str) -> str | None:
-            """Extract data using regex pattern."""
-            match = re.search(pattern, content)
+        def extract_data(pattern: re.Pattern[str], content: str) -> str | None:
+            """Extract data using a compiled regex pattern."""
+            match = pattern.search(content)
             return match.group(1) if match else None
 
         def generate_random_string(length: int = 10) -> str:
             """Generate random alphanumeric string."""
-            characters = (
-                "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"
-            )
-            return "".join(random.choice(characters) for _ in range(length))
+            charset = string.ascii_letters + string.digits
+            return "".join(random.choices(charset, k=length))
 
         response = requests.get(
             embedded_link,
@@ -53,15 +60,13 @@ class Doodstream(Provider):
         )
         response.raise_for_status()
 
-        pass_md5_pattern = r"\$\.get\('([^']*\/pass_md5\/[^']*)'"
-        pass_md5_url = extract_data(pass_md5_pattern, response.text)
+        pass_md5_url = extract_data(PASS_MD5_PATTERN, response.text)
         if not pass_md5_url:
             raise ValueError(f"pass_md5 URL not found using {embedded_link}.")
 
         full_md5_url = f"https://dood.li{pass_md5_url}"
 
-        token_pattern = r"token=([a-zA-Z0-9]+)"
-        token = extract_data(token_pattern, response.text)
+        token = extract_data(TOKEN_PATTERN, response.text)
         if not token:
             raise ValueError(f"Token not found using {embedded_link}.")