# 🧾 docu-lite [](https://pepy.tech/projects/docu-lite)
### ⚡ Ultra-light Zero-dependency HTML outline generator for Python.
- 📖 Browse classes and functions with collapsible docstrings in a tidy, readable format
- 📘 Specify your own stylesheet(s) or rely on the default (will be generated on run)
- 🎈 No dependencies, short script
- ⚙️ [Integrate into your GitHub Workflow](https://g1ojs.github.io/docu-lite/add-to-workflow/index.html) to have automatically up-to-date outline(s) in your repo
- 👀 [Example live output:](https://g1ojs.github.io/docu-lite/docu-lite-outline.html)
- 👀 [Example live output (documentation mode):](https://g1ojs.github.io/docu-lite/docu-lite-outline-docmode.html)
## 🛠 Installation
Install using pip: open a command window and type
```
pip install docu-lite
```
## 💡 Usage
Either edit and run docu-lite.py in an IDE, or run from the command line:
```
docu-lite # uses or creates docu-lite.ini
docu-lite --config alt.ini # uses alt.ini, errors if missing
```
Docu-lite will create a docu-lite.ini file if one doesn't exist.
⚙️ Edit the docu-lite.ini file to control how docu-lite runs:
- **pattern** specifies where to look for input
- **html** specifies the name of the output html file
- **css** specifies the name of the input style sheet, which will be referenced from the output html file
- **documentation_mode** produces a less detailed output styled for use as or editing into documentation. This mode uses a **completely separate stylesheet**, which can be tailored independently.
- ignores code blocks starting with _ (e.g. def _name)
- provides inner content only for docstrings, not code
- **ignore_docstrings_with** can be followed by = word to ignore docstrings containing the word (e.g. License, useful to stop license blocks appearing in the output)
📝 If the specified css file is not found, docu-lite will generate one and reference it in the html
## ⚠️ Known Issues
- Doesn't cleanly handle all variations of docstring layout. In particular, the single line docstring causes the body below the docstring to appear below it.
- Doesn't cleanly handle function definitions that span several lines (only first line is shown)
[PyPI link](https://pypi.org/project/docu-lite/)
Raw data
{
"_id": null,
"home_page": null,
"name": "docu-lite",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "documentation, docstring, python, html, code-outline, doc-generator, lightweight, static, cli, developer-tools",
"author": null,
"author_email": "G1OJS <g1ojs@yahoo.com>",
"download_url": "https://files.pythonhosted.org/packages/9f/2c/d96a69fc318e7645dc66598d60cb6fa0db911eca368aa9a19ef5f460e6e1/docu_lite-1.4.0.tar.gz",
"platform": null,
"description": "# \ud83e\uddfe docu-lite [](https://pepy.tech/projects/docu-lite)\r\n\r\n### \u26a1 Ultra-light Zero-dependency HTML outline generator for Python. \r\n\r\n\r\n\r\n- \ud83d\udcd6 Browse classes and functions with collapsible docstrings in a tidy, readable format\r\n- \ud83d\udcd8 Specify your own stylesheet(s) or rely on the default (will be generated on run) \r\n- \ud83c\udf88 No dependencies, short script\r\n- \u2699\ufe0f [Integrate into your GitHub Workflow](https://g1ojs.github.io/docu-lite/add-to-workflow/index.html) to have automatically up-to-date outline(s) in your repo\r\n- \ud83d\udc40 [Example live output:](https://g1ojs.github.io/docu-lite/docu-lite-outline.html)\r\n- \ud83d\udc40 [Example live output (documentation mode):](https://g1ojs.github.io/docu-lite/docu-lite-outline-docmode.html)\r\n \r\n\r\n## \ud83d\udee0 Installation\r\n\r\nInstall using pip: open a command window and type\r\n\r\n```\r\npip install docu-lite\r\n```\r\n## \ud83d\udca1 Usage\r\nEither edit and run docu-lite.py in an IDE, or run from the command line:\r\n```\r\ndocu-lite # uses or creates docu-lite.ini\r\ndocu-lite --config alt.ini # uses alt.ini, errors if missing\r\n```\r\nDocu-lite will create a docu-lite.ini file if one doesn't exist.\r\n\r\n\u2699\ufe0f Edit the docu-lite.ini file to control how docu-lite runs:\r\n - **pattern** specifies where to look for input\r\n - **html** specifies the name of the output html file\r\n - **css** specifies the name of the input style sheet, which will be referenced from the output html file\r\n - **documentation_mode** produces a less detailed output styled for use as or editing into documentation. This mode uses a **completely separate stylesheet**, which can be tailored independently.\r\n - ignores code blocks starting with _ (e.g. def _name)\r\n - provides inner content only for docstrings, not code\r\n - **ignore_docstrings_with** can be followed by = word to ignore docstrings containing the word (e.g. License, useful to stop license blocks appearing in the output) \r\n\r\n\r\n\ud83d\udcdd If the specified css file is not found, docu-lite will generate one and reference it in the html\r\n\r\n## \u26a0\ufe0f Known Issues\r\n - Doesn't cleanly handle all variations of docstring layout. In particular, the single line docstring causes the body below the docstring to appear below it.\r\n - Doesn't cleanly handle function definitions that span several lines (only first line is shown)\r\n\r\n[PyPI link](https://pypi.org/project/docu-lite/)\r\n",
"bugtrack_url": null,
"license": null,
"summary": "\ud83e\uddfe docu-lite: Ultra-light Zero-dependency HTML outline generator for Python.",
"version": "1.4.0",
"project_urls": {
"Homepage": "https://github.com/G1OJS/docu-lite",
"Issues": "https://github.com/G1OJS/docu-lite/issues"
},
"split_keywords": [
"documentation",
" docstring",
" python",
" html",
" code-outline",
" doc-generator",
" lightweight",
" static",
" cli",
" developer-tools"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "26660a500367adc9d3c5ea1392803f40cca49534f50482b957daabc150d834e6",
"md5": "316a9f913c729770188e9f6d61a973e3",
"sha256": "27a62a5d960ec5ee33525b55092685d258e0729596ea4776e5c6b89a40960ffc"
},
"downloads": -1,
"filename": "docu_lite-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "316a9f913c729770188e9f6d61a973e3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 7599,
"upload_time": "2025-07-24T14:20:24",
"upload_time_iso_8601": "2025-07-24T14:20:24.580585Z",
"url": "https://files.pythonhosted.org/packages/26/66/0a500367adc9d3c5ea1392803f40cca49534f50482b957daabc150d834e6/docu_lite-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9f2cd96a69fc318e7645dc66598d60cb6fa0db911eca368aa9a19ef5f460e6e1",
"md5": "ecf67c94380e5b3f180d79d51b0e910a",
"sha256": "536f81f5477a189d798c84d59600ab3e348dd141ceeadf9f9c6b6c20c5b62e10"
},
"downloads": -1,
"filename": "docu_lite-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "ecf67c94380e5b3f180d79d51b0e910a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 7317,
"upload_time": "2025-07-24T14:20:25",
"upload_time_iso_8601": "2025-07-24T14:20:25.453404Z",
"url": "https://files.pythonhosted.org/packages/9f/2c/d96a69fc318e7645dc66598d60cb6fa0db911eca368aa9a19ef5f460e6e1/docu_lite-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-24 14:20:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "G1OJS",
"github_project": "docu-lite",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "docu-lite"
}
JSON
