# -*- 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