# epythet
Documentation and packaging tools.
Less humdrum, more automation, earlier at the pub.
[Full documentation here](https://i2mint.github.io/epythet/index.html) generated by Epythet.
# Getting Started
Follow the [Sphinx Installation Guide](https://www.sphinx-doc.org/en/master/usage/installation.html)
```
pip install epythet
```
Follow the short [Quickstart Guide](https://i2mint.github.io/epythet/module_docs/epythet.html#quickstart)
# About
Tired of learning new frameworks and just need something to quickly display your docstrings in your python files? You've come to the right place. Epythet is built on
[Sphinx Python Documentation Generator](https://www.sphinx-doc.org/en/master/index.html) but automatically generates pages for each module .py files and a table of contents.
# Publishing to GitHub Page with GitHub Actions
Add workflow [.github/workflows/publish-docs.yml](https://github.com/i2mint/epythet/blob/master/.github/workflows/publish-docs.yml) to your repo and modify the trigger conditions to suit your needs. Example below will run automatically when the other "Continuous Integration" workflow is completed.
```
name: GitHub Pages
on:
workflow_run:
workflows: ["Continuous Integration"]
types:
- completed
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: i2mint/epythet/actions/publish-github-pages@master
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
docs-branch: "gh-pages"
docs-dir: "./docsrc/_build/html/"
python-version: "3.10"
```
Setup the GitHub Pages for your repo after the target docs-branch is created. Set the target branch (default: "gh-pages") and folder as `/(root)`
![image](https://user-images.githubusercontent.com/22692594/212193474-80b287e2-211c-470d-aa7c-9f779bdd3866.png)
Raw data
{
"_id": null,
"home_page": "https://github.com/i2mint/epythet",
"name": "epythet",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "documentation,publishing",
"author": "Otosense",
"author_email": "andie.phan@analog.com",
"download_url": "https://files.pythonhosted.org/packages/6b/2d/9e30c6312288813d62f3588a00a60c804ca72b94f6d1b0232457153a86ed/epythet-0.1.3.tar.gz",
"platform": "any",
"description": "# epythet\n\nDocumentation and packaging tools.\nLess humdrum, more automation, earlier at the pub.\n\n[Full documentation here](https://i2mint.github.io/epythet/index.html) generated by Epythet.\n\n# Getting Started\nFollow the [Sphinx Installation Guide](https://www.sphinx-doc.org/en/master/usage/installation.html)\n\n```\npip install epythet\n```\nFollow the short [Quickstart Guide](https://i2mint.github.io/epythet/module_docs/epythet.html#quickstart)\n\n# About\nTired of learning new frameworks and just need something to quickly display your docstrings in your python files? You've come to the right place. Epythet is built on\n [Sphinx Python Documentation Generator](https://www.sphinx-doc.org/en/master/index.html) but automatically generates pages for each module .py files and a table of contents.\n\n\n# Publishing to GitHub Page with GitHub Actions\nAdd workflow [.github/workflows/publish-docs.yml](https://github.com/i2mint/epythet/blob/master/.github/workflows/publish-docs.yml) to your repo and modify the trigger conditions to suit your needs. Example below will run automatically when the other \"Continuous Integration\" workflow is completed.\n```\nname: GitHub Pages\n\non:\n workflow_run:\n workflows: [\"Continuous Integration\"]\n types:\n - completed\n\njobs:\n deploy:\n runs-on: ubuntu-latest\n steps:\n - uses: i2mint/epythet/actions/publish-github-pages@master\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n docs-branch: \"gh-pages\"\n docs-dir: \"./docsrc/_build/html/\"\n python-version: \"3.10\"\n```\nSetup the GitHub Pages for your repo after the target docs-branch is created. Set the target branch (default: \"gh-pages\") and folder as `/(root)`\n![image](https://user-images.githubusercontent.com/22692594/212193474-80b287e2-211c-470d-aa7c-9f779bdd3866.png)\n\n\n",
"bugtrack_url": null,
"license": "Apache Software License",
"summary": "Tools for documentation and packaging",
"version": "0.1.3",
"project_urls": {
"Homepage": "https://github.com/i2mint/epythet"
},
"split_keywords": [
"documentation",
"publishing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b98af8de0420233639624ee2828d0c8653176435e0e50f4d3e9bb0db0e589a9d",
"md5": "af9cd90d563a556f0d1994b3031749e9",
"sha256": "8f9b2b6914fe8b748edf3169636d368d91351be988459d4d56e74594110a616f"
},
"downloads": -1,
"filename": "epythet-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "af9cd90d563a556f0d1994b3031749e9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 23663,
"upload_time": "2024-01-22T10:21:37",
"upload_time_iso_8601": "2024-01-22T10:21:37.275165Z",
"url": "https://files.pythonhosted.org/packages/b9/8a/f8de0420233639624ee2828d0c8653176435e0e50f4d3e9bb0db0e589a9d/epythet-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6b2d9e30c6312288813d62f3588a00a60c804ca72b94f6d1b0232457153a86ed",
"md5": "4cd394c24082c3ba16606a657f3e4b47",
"sha256": "c9481fcc7f85e381da0e930e6c589930843929eb298636bae37d7eb3d874751c"
},
"downloads": -1,
"filename": "epythet-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "4cd394c24082c3ba16606a657f3e4b47",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 19679,
"upload_time": "2024-01-22T10:21:39",
"upload_time_iso_8601": "2024-01-22T10:21:39.162707Z",
"url": "https://files.pythonhosted.org/packages/6b/2d/9e30c6312288813d62f3588a00a60c804ca72b94f6d1b0232457153a86ed/epythet-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-22 10:21:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "i2mint",
"github_project": "epythet",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "epythet"
}