# 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)`
Raw data
{
"_id": null,
"home_page": "https://github.com/i2mint/epythet",
"name": "epythet",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "documentation, publishing",
"author": "Otosense",
"author_email": "andie.phan@analog.com",
"download_url": "https://files.pythonhosted.org/packages/38/25/259bcad7e46dfbd4738f34be447c56b3aad4fabc730a3184d1c6ca97f708/epythet-0.1.7.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\n",
"bugtrack_url": null,
"license": "Apache Software License",
"summary": "Tools for documentation and packaging",
"version": "0.1.7",
"project_urls": {
"Homepage": "https://github.com/i2mint/epythet"
},
"split_keywords": [
"documentation",
" publishing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3e3f8006f8435c8f1b2b4d13cca9ce571808ba3cf828cf7dbe4998ad5fa23f81",
"md5": "f4ad065314099c97637efc9e84640194",
"sha256": "c39598ac922c8708b3c5265d60e2cac5a59b6bb57447b1f336f1bd89b8e73f02"
},
"downloads": -1,
"filename": "epythet-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f4ad065314099c97637efc9e84640194",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 26347,
"upload_time": "2024-12-19T17:00:41",
"upload_time_iso_8601": "2024-12-19T17:00:41.288955Z",
"url": "https://files.pythonhosted.org/packages/3e/3f/8006f8435c8f1b2b4d13cca9ce571808ba3cf828cf7dbe4998ad5fa23f81/epythet-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3825259bcad7e46dfbd4738f34be447c56b3aad4fabc730a3184d1c6ca97f708",
"md5": "920fb5c39653b96eabe2cda14269c524",
"sha256": "257604f1426ec066f7751d3fda2ac2b44992e07327b861a660c4b1a7cc8e8adf"
},
"downloads": -1,
"filename": "epythet-0.1.7.tar.gz",
"has_sig": false,
"md5_digest": "920fb5c39653b96eabe2cda14269c524",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 22184,
"upload_time": "2024-12-19T17:00:43",
"upload_time_iso_8601": "2024-12-19T17:00:43.467290Z",
"url": "https://files.pythonhosted.org/packages/38/25/259bcad7e46dfbd4738f34be447c56b3aad4fabc730a3184d1c6ca97f708/epythet-0.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-19 17:00:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "i2mint",
"github_project": "epythet",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "epythet"
}
JSON
