epythet


Nameepythet JSON
Version 0.1.6 PyPI version JSON
download
home_pagehttps://github.com/i2mint/epythet
SummaryTools for documentation and packaging
upload_time2024-08-13 11:24:45
maintainerNone
docs_urlNone
authorOtosense
requires_pythonNone
licenseApache Software License
keywords documentation publishing
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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": 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/d3/52/1deeceb43c4a6d491160685a93943fe0535c5d2cd839c70ae8f1f7551f08/epythet-0.1.6.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",
    "bugtrack_url": null,
    "license": "Apache Software License",
    "summary": "Tools for documentation and packaging",
    "version": "0.1.6",
    "project_urls": {
        "Homepage": "https://github.com/i2mint/epythet"
    },
    "split_keywords": [
        "documentation",
        " publishing"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2b6936e32d3aa371e3915566713e6479a0ef7bddc53fdd5d95988aa06aa1362c",
                "md5": "3fba40cc1b2613f1b9d3b18d5c0493ea",
                "sha256": "e265664d445d53e6d601304e5ab40bd8525a3b4151cce2ce6655744556387fa6"
            },
            "downloads": -1,
            "filename": "epythet-0.1.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3fba40cc1b2613f1b9d3b18d5c0493ea",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 24790,
            "upload_time": "2024-08-13T11:24:44",
            "upload_time_iso_8601": "2024-08-13T11:24:44.274900Z",
            "url": "https://files.pythonhosted.org/packages/2b/69/36e32d3aa371e3915566713e6479a0ef7bddc53fdd5d95988aa06aa1362c/epythet-0.1.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d3521deeceb43c4a6d491160685a93943fe0535c5d2cd839c70ae8f1f7551f08",
                "md5": "e4eeec0aedfa426fd1df79a4de7249c5",
                "sha256": "18094753e01b585b16514c71f24e73163b97b4c7954219ebc54eeae1763bfc9b"
            },
            "downloads": -1,
            "filename": "epythet-0.1.6.tar.gz",
            "has_sig": false,
            "md5_digest": "e4eeec0aedfa426fd1df79a4de7249c5",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 20644,
            "upload_time": "2024-08-13T11:24:45",
            "upload_time_iso_8601": "2024-08-13T11:24:45.887577Z",
            "url": "https://files.pythonhosted.org/packages/d3/52/1deeceb43c4a6d491160685a93943fe0535c5d2cd839c70ae8f1f7551f08/epythet-0.1.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-13 11:24:45",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "i2mint",
    "github_project": "epythet",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "epythet"
}
        
Elapsed time: 0.71613s