diff --git a/tasks.py b/tasks.py index f8f4017..d48a0de 100644 --- a/tasks.py +++ b/tasks.py @@ -1,23 +1,26 @@ from os.path import join +from shutil import rmtree, move from invoke import Collection, ctask as task from invocations import docs as _docs +from invocations.packaging import publish d = 'sites' # Usage doc/API site (published as docs.paramiko.org) -path = join(d, 'docs') +docs_path = join(d, 'docs') +docs_build = join(docs_path, '_build') docs = Collection.from_module(_docs, name='docs', config={ - 'sphinx.source': path, - 'sphinx.target': join(path, '_build'), + 'sphinx.source': docs_path, + 'sphinx.target': docs_build, }) # Main/about/changelog site ((www.)?paramiko.org) -path = join(d, 'www') +www_path = join(d, 'www') www = Collection.from_module(_docs, name='www', config={ - 'sphinx.source': path, - 'sphinx.target': join(path, '_build'), + 'sphinx.source': www_path, + 'sphinx.target': join(www_path, '_build'), }) @@ -31,4 +34,14 @@ def coverage(ctx): ctx.run("coverage run --source=paramiko test.py --verbose") -ns = Collection(test, coverage, docs=docs, www=www) +# Until we stop bundling docs w/ releases. Need to discover use cases first. +@task('docs') # Will invoke the API doc site build +def release(ctx): + # Move the built docs into where Epydocs used to live + rmtree('docs') + move(docs_build, 'docs') + # Publish + publish(ctx) + + +ns = Collection(test, coverage, release, docs=docs, www=www)