python-plexapi/tests/test_misc.py

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

import pytest

SKIP_EXAMPLES = ["Example 4"]


@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