# Path: tasks/_config.py
# DOC_DIR = op.join(ROOT_DIR, "docs")
# 
# DOC_BUILD_DIR = op.join(DOC_DIR, "_build")


import os
import sys
import os.path as op
import shutil
    import sphinx
        import sphinx.cmd.build
    import webbrowser
from invoke import task
from ._config import DOC_DIR, DOC_BUILD_DIR



@task(
    help=dict(
        clean="clear the doc output; start fresh",
        build="build html docs",
        show="show the docs in the browser.",
    )
)
def docs(ctx, clean=False, build=False, show=False, **kwargs):
    """make API documentation"""
    # Prepare

    if not (clean or build or show):
        sys.exit('Task "docs" must be called with --clean, --build or --show')

    if clean:

# Path: tasks/_config.py
# DOC_DIR = op.join(ROOT_DIR, "docs")
# 
# DOC_BUILD_DIR = op.join(DOC_DIR, "_build")


# Path: tasks/docs.py
import os
import sys
import os.path as op
import shutil
    import sphinx
        import sphinx.cmd.build
    import webbrowser
from invoke import task
from ._config import DOC_DIR, DOC_BUILD_DIR




@task(
    help=dict(
        clean="clear the doc output; start fresh",
        build="build html docs",
        show="show the docs in the browser.",
    )
)
def docs(ctx, clean=False, build=False, show=False, **kwargs):
    """make API documentation"""
    # Prepare

    if not (clean or build or show):
        sys.exit('Task "docs" must be called with --clean, --build or --show')

    if clean:

        sphinx_clean(DOC_BUILD_DIR)