make_docs.py

#!/usr/bin/env python

import os
import webbrowser
import subprocess

def browser(pathname):
    try:
        from urllib import pathname2url
    except:
        from urllib.request import pathname2url
    webbrowser.open("file:" + pathname2url(pathname))

def remove_exists(filename):
    try:
        os.remove(filename)
    except FileNotFoundError:
        pass


# clean docs config and html files, and rebuild everything
remove_exists('docs/flatland.rst')
remove_exists('docs/modules.rst')

subprocess.call('sphinx-apidoc -o docs/ flatland')

os.environ["SPHINXPROJ"] = "flatland"
os.chdir('docs')
subprocess.call('python -msphinx -M clean . _build')
subprocess.call('python -msphinx -M html . _build')

browser(os.path.abspath('_build/html/index.html'))