Skip to main content

Tools for documentation and packaging

Project description

epythet

Documentation and packaging tools. Less humdrum, more automation, earlier at the pub.

Full documentation here

Install

Just

pip install epythet

Oh, and also you'll need sphinx-doc, which you can get on linux by:

$ apt-get install python3-sphinx

and on macOS with

brew install sphinx-doc

and on windows by googling it.

Quickstart

Setup Sphinx docsrc

from epythet.docs_gen.setup_docsrc import make_docsrc
make_docsrc(PROJECT_DIR)

Generate module docs

from epythet.docs_gen.autogen import make_autodocs
make_autodocs(PROJECT_DIR)

Compile docs

cd PROJECT_DIR/docsrc
make html

View by opening PROJECT_DIR/docsrc/_build/html/index.html.

Github Pages

Go to your repo settings and set GitHub Pages site to build from the /docs folder in the master branch. Github will tell you where it will be published. In this case, the site is published at https://i2mint.github.io/epythet/

Compile docs for github

cd PROJECT_DIR/docsrc
make github

Push generated PROJECT_DIR/docs to master branch

Editing and Customizing Docs

You can add RST documentation directly in the source files. This source file for example.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

epythet-0.0.18.tar.gz (32.2 kB view hashes)

Uploaded Source

Built Distribution

epythet-0.0.18-py3-none-any.whl (44.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page