adventuresinodyssey 0.1.4__tar.gz

adventuresinodyssey-0.1.4/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: adventuresinodyssey
+Version: 0.1.4
+Summary: Python API client for the Adventures in Odyssey Club and public endpoints.
+Author-email: CATEIN <CATEIN@protonmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/CATEIN/adventuresinodyssey-py
+Project-URL: Repository, https://github.com/CATEIN/adventuresinodyssey-py
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.1
+Requires-Dist: playwright>=1.40.0
+
+An unofficial Python API client for the Adventures in Odyssey Club and public endpoints. This library allows you to interact with AIO content, including retrieving metadata for albums and episodes.
+
+**Note:** This is an Alpha release. APIs may change.
+
+[Documentation](https://github.com/CATEIN/adventuresinodyssey-py/blob/main/docs/docs.md)
+
+[Github](https://github.com/CATEIN/adventuresinodyssey-py)
+
+### Important: Browser Requirement
+
+This library uses Playwright for authentication. After installing the package, you must install the required browser binaries (Chromium):
+
+```bash
+playwright install chromium
+```
+
+## Example Program
+```python
+import random
+from adventuresinodyssey import AIOClient
+
+client = AIOClient()
+link_base = "https://app.adventuresinodyssey.com/content/"
+
+print("Caching episodes...")
+all_episodes = client.cache_episodes()
+
+if not all_episodes:
+    print("Error: Failed to cache episodes.")
+    exit()
+
+# Pick a random episode
+episode = random.choice(all_episodes)
+
+print(f"Random episode: {episode.get('short_name')}")
+print(f"Link: {link_base}{episode.get('id')}")
+```

adventuresinodyssey-0.1.4/README.md

@@ -0,0 +1,37 @@
+An unofficial Python API client for the Adventures in Odyssey Club and public endpoints. This library allows you to interact with AIO content, including retrieving metadata for albums and episodes.
+
+**Note:** This is an Alpha release. APIs may change.
+
+[Documentation](https://github.com/CATEIN/adventuresinodyssey-py/blob/main/docs/docs.md)
+
+[Github](https://github.com/CATEIN/adventuresinodyssey-py)
+
+### Important: Browser Requirement
+
+This library uses Playwright for authentication. After installing the package, you must install the required browser binaries (Chromium):
+
+```bash
+playwright install chromium
+```
+
+## Example Program
+```python
+import random
+from adventuresinodyssey import AIOClient
+
+client = AIOClient()
+link_base = "https://app.adventuresinodyssey.com/content/"
+
+print("Caching episodes...")
+all_episodes = client.cache_episodes()
+
+if not all_episodes:
+    print("Error: Failed to cache episodes.")
+    exit()
+
+# Pick a random episode
+episode = random.choice(all_episodes)
+
+print(f"Random episode: {episode.get('short_name')}")
+print(f"Link: {link_base}{episode.get('id')}")
+```

adventuresinodyssey-0.1.4/adventuresinodyssey/__init__.py

@@ -0,0 +1,31 @@
+"""
+Adventures in Odyssey API Package
+"""
+from .clubclient import ClubClient
+from .aioclient import AIOClient
+
+__version__ = "0.1.4"
+__all__ = ["ClubClient", "AIOClient"]
+
+import logging
+
+def set_logging_level(level: str = 'INFO'):
+    """
+    Sets the logging level for the 'adventuresinodyssey' package and its modules.
+    
+    Args:
+        level: The desired logging level (e.g., 'DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL').
+    """
+    # 1. Map string level to logging constants
+    numeric_level = getattr(logging, level.upper(), None)
+    if not isinstance(numeric_level, int):
+        raise ValueError(f"Invalid logging level: {level}. Must be one of DEBUG, INFO, WARNING, ERROR, CRITICAL.")
+        
+    # 2. Get the root logger for the entire package ('adventuresinodyssey')
+    package_logger = logging.getLogger('adventuresinodyssey')
+    package_logger.setLevel(numeric_level)
+    
+    # 3. If a handler hasn't been configured (i.e., the user hasn't called basicConfig), 
+    # ensure logging output goes somewhere by attaching a basic handler.
+    if not logging.root.handlers:
+        logging.basicConfig(level=numeric_level)