Add Subs4Series provider

docs/api/providers.rst

@@ -32,6 +32,11 @@ Shooter
 .. automodule:: subliminal.providers.shooter
    :private-members:
 
+Subs4Series
+-----------
+.. automodule:: subliminal.providers.subs4series
+   :private-members:
+
 TheSubDB
 --------
 .. automodule:: subliminal.providers.thesubdb

docs/user/how_it_works.rst

@@ -12,6 +12,7 @@ subtitles. Current supported providers are:
 * OpenSubtitles
 * Podnapisi
 * Shooter
+* Subs4Series
 * TheSubDB
 * TvSubtitles
 

setup.py

@@ -73,6 +73,7 @@ def find_version(*file_paths):
               'opensubtitles = subliminal.providers.opensubtitles:OpenSubtitlesProvider',
               'podnapisi = subliminal.providers.podnapisi:PodnapisiProvider',
               'shooter = subliminal.providers.shooter:ShooterProvider',
+              'subs4series = subliminal.providers.subs4series:Subs4SeriesProvider',
               'thesubdb = subliminal.providers.thesubdb:TheSubDBProvider',
               'tvsubtitles = subliminal.providers.tvsubtitles:TVsubtitlesProvider'
           ],

subliminal/extensions.py

@@ -95,6 +95,7 @@ def unregister(self, entry_point):
     'opensubtitlesvip = subliminal.providers.opensubtitles:OpenSubtitlesVipProvider',
     'podnapisi = subliminal.providers.podnapisi:PodnapisiProvider',
     'shooter = subliminal.providers.shooter:ShooterProvider',
+    'subs4series = subliminal.providers.subs4series:Subs4SeriesProvider',
     'thesubdb = subliminal.providers.thesubdb:TheSubDBProvider',
     'tvsubtitles = subliminal.providers.tvsubtitles:TVsubtitlesProvider'
 ])

subliminal/providers/subs4series.py

@@ -0,0 +1,261 @@
+# -*- coding: utf-8 -*-
+import io
+import logging
+import os
+
+import rarfile
+import re
+import zipfile
+
+from babelfish import Language
+from guessit import guessit
+from requests import Session
+
+from . import ParserBeautifulSoup, Provider
+from .. import __short_version__
+from ..cache import SHOW_EXPIRATION_TIME, region
+from ..matches import guess_matches
+from ..subtitle import SUBTITLE_EXTENSIONS, Subtitle, fix_line_ending
+from ..utils import sanitize
+from ..video import Episode
+
+logger = logging.getLogger(__name__)
+
+year_re = re.compile(r'^\((\d{4})\)$')
+
+
+class Subs4SeriesSubtitle(Subtitle):
+    """Subs4Series Subtitle."""
+    provider_name = 'subs4series'
+
+    def __init__(self, language, page_link, series, year, version, download_link):
+        super(Subs4SeriesSubtitle, self).__init__(language, page_link=page_link)
+        self.series = series
+        self.year = year
+        self.version = version
+        self.download_link = download_link
+        self.hearing_impaired = None
+        self.encoding = 'windows-1253'
+
+    @property
+    def id(self):
+        return self.download_link
+
+    @property
+    def info(self):
+        return self.version or self.download_link
+
+    def get_matches(self, video):
+        matches = guess_matches(video, {
+            'title': self.series,
+            'year': self.year,
+            'release_group': self.version
+        })
+
+        # other properties
+        matches |= guess_matches(video, guessit(self.version, {'type': 'episode'}), partial=True)
+
+        return matches
+
+
+class Subs4SeriesProvider(Provider):
+    """Subs4Series Provider."""
+    languages = {Language.fromalpha2(l) for l in {'el', 'en'}}
+    video_types = (Episode,)
+    server_url = 'https://www.subs4series.com'
+    search_url = '/search_report.php?search={}&searchType=1'
+    episode_link = '/tv-series/{show_id}/season-{season:d}/episode-{episode:d}'
+    anti_block_1 = '/includes/anti-block-layover.php?launch=1'
+    anti_block_2 = '/includes/anti-block.php'
+    subtitle_class = Subs4SeriesSubtitle
+
+    def __init__(self):
+        self.session = None
+
+    def initialize(self):
+        self.session = Session()
+        self.session.headers['User-Agent'] = 'Subliminal/{}'.format(__short_version__)
+
+    def terminate(self):
+        self.session.close()
+
+    def get_show_links(self, title, year=None):
+        """Get the matching show links for `title` and `year`.
+
+        First search in the result of :meth:`_get_show_suggestions`.
+
+        :param title: show title.
+        :param year: year of the show, if any.
+        :type year: int
+        :return: the show links, if found.
+        :rtype: list of str
+
+        """
+        title = sanitize(title)
+        suggestions = self._get_suggestions(title)
+
+        show_links = []
+        for suggestion in suggestions:
+            show_title = sanitize(suggestion['title'])
+
+            if show_title == title or (year and show_title == '{title} {year:d}'.format(title=title, year=year)):
+                logger.debug('Getting show link')
+                show_links.append('/'.join(suggestion['link'].rsplit('/', 2)[1:]))
+
+        return show_links
+
+    @region.cache_on_arguments(expiration_time=SHOW_EXPIRATION_TIME, should_cache_fn=lambda value: value)
+    def _get_suggestions(self, title):
+        """Search the show or movie id from the `title` and `year`.
+
+        :param str title: title of the show.
+        :return: the show suggestions found.
+        :rtype: list of dict
+
+        """
+        # make the search
+        logger.info('Searching show ids with %r', title)
+        r = self.session.get(self.server_url + self.search_url.format(title),
+                             headers={'Referer': self.server_url}, timeout=10)
+        r.raise_for_status()
+
+        if not r.content:
+            logger.debug('No data returned from provider')
+            return []
+
+        soup = ParserBeautifulSoup(r.content, ['html.parser'])
+        series = [{'link': l.attrs['value'], 'title': l.text}
+                  for l in soup.select('select[name="Mov_sel"] > option[value]')]
+        logger.debug('Found suggestions: %r', series)
+
+        return series
+
+    def query(self, show_id, series, season, episode, title):
+        # get the season list of the show
+        logger.info('Getting the subtitle list of show id %s', show_id)
+        if all((show_id, season, episode)):
+            page_link = self.server_url + self.episode_link.format(show_id=show_id, season=season, episode=episode)
+        else:
+            return []
+
+        r = self.session.get(page_link, timeout=10)
+        r.raise_for_status()
+
+        if not r.content:
+            logger.debug('No data returned from provider')
+            return []
+
+        soup = ParserBeautifulSoup(r.content, ['lxml', 'html.parser'])
+
+        year = None
+        matches = year_re.match(str(soup.select_one('#dates_header_br > table div').contents[2]).strip())
+        if matches:
+            year = int(matches.group(1))
+        show_title = str(soup.select_one('#dates_header_br > table div u').string).strip()
+
+        subtitles = []
+        # loop over episode rows
+        for subs_tag in soup.select('table .seeDark,.seeMedium'):
+            # read common info
+            version = subs_tag.find('b').text
+            download_link = self.server_url + subs_tag.find('a')['href']
+            language = Language.fromalpha2(subs_tag.find('img')['src'].split('/')[-1].split('.')[0])
+
+            subtitle = self.subtitle_class(language, page_link, show_title, year, version, download_link)
+
+            logger.debug('Found subtitle %r', subtitle)
+            subtitles.append(subtitle)
+
+        return subtitles
+
+    def list_subtitles(self, video, languages):
+        # lookup show_id
+        titles = [video.series] + video.alternative_series if isinstance(video, Episode) else []
+
+        show_links = None
+        for title in titles:
+            show_links = self.get_show_links(title, video.year)
+            if show_links:
+                break
+
+        subtitles = []
+        # query for subtitles with the show_id
+        for show_link in show_links:
+            subtitles += [s for s in self.query(show_link, video.series, video.season, video.episode, video.title)
+                          if s.language in languages]
+
+        return subtitles
+
+    def download_subtitle(self, subtitle):
+        if isinstance(subtitle, Subs4SeriesSubtitle):
+            # download the subtitle
+            logger.info('Downloading subtitle %r', subtitle)
+            r = self.session.get(subtitle.download_link, headers={'Referer': subtitle.page_link}, timeout=10)
+            r.raise_for_status()
+
+            if not r.content:
+                logger.debug('Unable to download subtitle. No data returned from provider')
+                return
+
+            soup = ParserBeautifulSoup(r.content, ['lxml', 'html.parser'])
+            download_element = soup.select_one('a.style55ws')
+            if not download_element:
+                download_element = soup.select_one('form[method="post"]')
+                target = download_element['action'] if download_element else None
+            else:
+                target = download_element['href']
+
+            if not target:
+                logger.debug('Unable to download subtitle. No download link found')
+                return
+
+            self.apply_anti_block(subtitle)
+
+            download_url = self.server_url + target
+            r = self.session.get(download_url, headers={'Referer': subtitle.download_link}, timeout=10)
+            r.raise_for_status()
+
+            if not r.content:
+                logger.debug('Unable to download subtitle. No data returned from provider')
+                return
+
+            archive = _get_archive(r.content)
+            subtitle_content = _get_subtitle_from_archive(archive) if archive else r.content
+
+            if subtitle_content:
+                subtitle.content = fix_line_ending(subtitle_content)
+            else:
+                logger.debug('Could not extract subtitle from %r', archive)
+
+    def apply_anti_block(self, subtitle):
+        self.session.get(self.server_url + self.anti_block_1, headers={'Referer': subtitle.download_link}, timeout=10)
+        self.session.get(self.server_url + self.anti_block_2, headers={'Referer': subtitle.download_link}, timeout=10)
+
+
+def _get_archive(content):
+    # open the archive
+    archive_stream = io.BytesIO(content)
+    archive = None
+    if rarfile.is_rarfile(archive_stream):
+        logger.debug('Identified rar archive')
+        archive = rarfile.RarFile(archive_stream)
+    elif zipfile.is_zipfile(archive_stream):
+        logger.debug('Identified zip archive')
+        archive = zipfile.ZipFile(archive_stream)
+
+    return archive
+
+
+def _get_subtitle_from_archive(archive):
+    for name in archive.namelist():
+        # discard hidden files
+        if os.path.split(name)[-1].startswith('.'):
+            continue
+
+        # discard non-subtitle files
+        if not name.lower().endswith(SUBTITLE_EXTENSIONS):
+            continue
+
+        return archive.read(name)
+
+    return None