Read all headers, logging, and core settings from config file; Add Show.refresh() method

plexapi/__init__.py

@@ -3,20 +3,27 @@ PlexAPI
 """
 import logging, os, platform
 from logging.handlers import RotatingFileHandler
+from plexapi.config import PlexConfig
 from uuid import getnode
 
 PROJECT = 'PlexAPI'
 VERSION = '0.9.5'
-TIMEOUT = 5
+
+# Load User Defined Config
+CONFIG_PATH = os.path.expanduser('~/.config/plexapi/config.ini')
+CONFIG = PlexConfig(CONFIG_PATH)
+
+# Core Settings
+TIMEOUT = CONFIG.get('plexapi.timeout', 5, int)
 
 # Plex Header Configuation
-X_PLEX_PLATFORM = platform.uname()[0]               # Platform name, eg iOS, MacOSX, Android, LG, etc
-X_PLEX_PLATFORM_VERSION = platform.uname()[2]       # Operating system version, eg 4.3.1, 10.6.7, 3.2
-X_PLEX_PROVIDES = 'controller'                      # one or more of [player, controller, server]
-X_PLEX_PRODUCT = PROJECT                            # Plex application name, eg Laika, Plex Media Server, Media Link
-X_PLEX_VERSION = VERSION                            # Plex application version number
-X_PLEX_DEVICE = platform.platform()                 # Device name and model number, eg iPhone3,2, Motorola XOOM, LG5200TV
-X_PLEX_IDENTIFIER = str(hex(getnode()))             # UUID, serial number, or other number unique per device
+X_PLEX_PROVIDES = 'player,controller'                                                   # one or more of [player, controller, server]
+X_PLEX_PLATFORM = CONFIG.get('headers.platorm', platform.uname()[0])                    # Platform name, eg iOS, MacOSX, Android, LG, etc
+X_PLEX_PLATFORM_VERSION = CONFIG.get('headers.platform_version', platform.uname()[2])   # Operating system version, eg 4.3.1, 10.6.7, 3.2
+X_PLEX_PRODUCT = CONFIG.get('headers.product', PROJECT)                                 # Plex application name, eg Laika, Plex Media Server, Media Link
+X_PLEX_VERSION = CONFIG.get('headers.version', VERSION)                                 # Plex application version number
+X_PLEX_DEVICE = CONFIG.get('headers.platform', platform.platform())                     # Device name and model number, eg iPhone3,2, Motorola XOOM, LG5200TV
+X_PLEX_IDENTIFIER = CONFIG.get('headers.identifier', str(hex(getnode())))               # UUID, serial number, or other number unique per device
 BASE_HEADERS = {
     'X-Plex-Platform': X_PLEX_PLATFORM,
     'X-Plex-Platform-Version': X_PLEX_PLATFORM_VERSION,
@@ -29,9 +36,13 @@ BASE_HEADERS = {
 
 # Logging Configuration
 log = logging.getLogger('plexapi')
-logfile = os.path.join('/tmp', 'plexapi.log')
-logformat = logging.Formatter('%(asctime)s %(module)12s:%(lineno)-4s %(levelname)-9s %(message)s')
-filehandler = RotatingFileHandler(logfile, 'a', 512000, 3)
-filehandler.setFormatter(logformat)
-log.addHandler(filehandler)
-log.setLevel(logging.INFO)
+LOG_FILE = CONFIG.get('logging.path')
+if LOG_FILE:
+    LOG_BACKUPS = CONFIG.get('logging.backup_count', 3, int)
+    LOG_BYTES = CONFIG.get('logging.rotate_bytes', 512000, int)
+    LOG_FORMAT = CONFIG.get('logging.format', '%(asctime)s %(module)12s:%(lineno)-4s %(levelname)-9s %(message)s')
+    LOG_LEVEL = CONFIG.get('logging.level', 'INFO')
+    filehandler = RotatingFileHandler(os.path.expanduser(LOG_FILE), 'a', LOG_BYTES, LOG_BACKUPS)
+    filehandler.setFormatter(logging.Formatter(LOG_FORMAT))
+    log.addHandler(filehandler)
+    log.setLevel(LOG_LEVEL)

plexapi/config.py

@@ -0,0 +1,29 @@
+"""
+PlexConfig
+"""
+from collections import defaultdict
+from ConfigParser import ConfigParser
+
+
+class PlexConfig(ConfigParser):
+
+    def __init__(self, path):
+        ConfigParser.__init__(self)
+        self.read(path)
+        self.data = self._as_dict()
+
+    def get(self, key, default=None, cast=None):
+        try:
+            section, name = key.split('.')
+            value = self.data.get(section.lower(), {}).get(name.lower(), default)
+            return cast(value) if cast else value
+        except:
+            return default
+
+    def _as_dict(self):
+        config = defaultdict(dict)
+        for section in self._sections:
+            for name, value in self._sections[section].items():
+                if name != '__name__':
+                    config[section.lower()][name.lower()] = value
+        return dict(config)

plexapi/video.py

@@ -139,6 +139,9 @@ class Show(Video):
     def get(self, title):
         return self.episode(title)
 
+    def refresh(self):
+        self.server.query('/library/metadata/%s/refresh' % self.ratingKey)
+
 
 class Season(Video):
     TYPE = 'season'