python-plexapi/tests/test_misc.py

# -*- coding: utf-8 -*-
import os
import pytest
import shlex
import subprocess
from os.path import abspath, dirname, join

SKIP_EXAMPLES = ['Example 4']


@pytest.mark.xfail
@pytest.mark.skipif(os.name == 'nt', reason='No make.bat specified for Windows')
def test_build_documentation():
    docroot = join(dirname(dirname(abspath(__file__))), 'docs')
    cmd = shlex.split('sphinx-build -aE . _build')
    proc = subprocess.Popen(cmd, cwd=docroot, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
    status = proc.wait()
    assert status == 0
    issues = []
    for output in proc.communicate():
        for line in str(output).split('\\n'):
            line = line.lower().strip()
            if 'warning' in line or 'error' in line or 'traceback' in line:
                issues.append(line)
    for line in issues:
        print(line)
    assert not issues


def test_readme_examples(plex):
    failed = 0
    examples = _fetch_examples()
    assert len(examples), 'No examples found in README'
    for title, example in examples:
        if _check_run_example(title):
            try:
                print('\n%s\n%s' % (title, '-' * len(title)))
                exec('\n'.join(example))
            except Exception as err:
                failed += 1
                print('Error running test: %s\nError: %s' % (title, err))
    assert not failed, '%s examples raised an exception.' % failed


def _fetch_examples():
    parsing = False
    examples = []
    filepath = join(dirname(dirname(abspath(__file__))), 'README.rst')
    with open(filepath, 'r') as handle:
        for line in handle.read().split('\n'):
            line = line[4:]
            if line.startswith('# Example '):
                parsing = True
                title = line.lstrip('# ')
                examples.append([title, []])
            elif parsing and line == '':
                parsing = False
            elif parsing:
                examples[-1][1].append(line)
    return examples


def _check_run_example(title):
    for skip_example in SKIP_EXAMPLES:
        if skip_example in title:
            return False
    return True