| Name | hexdoc-oneironaut JSON |
| Version |
0.3.3.1.0
JSON |
| download |
| home_page | None |
| Summary | Python web book docgen and hexdoc plugin for Oneironaut. |
| upload_time | 2024-07-12 21:37:13 |
| maintainer | None |
| docs_url | None |
| author | beholderface |
| requires_python | >=3.11 |
| license | None |
| keywords |
hexdoc
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# hexdoc-oneironaut
Python web book docgen and [hexdoc](https://pypi.org/project/hexdoc) plugin for Oneironaut.
## Version scheme
We use [hatch-gradle-version](https://pypi.org/project/hatch-gradle-version) to generate the version number based on whichever mod version the docgen was built with.
The version is in this format: `mod-version.python-version.mod-pre.python-dev.python-post`
For example:
* Mod version: `0.11.1-7`
* Python package version: `1.0.dev0`
* Full version: `0.11.1.1.0rc7.dev0`
## Setup
```sh
python3.11 -m venv venv
.\venv\Scripts\activate # Windows
. venv/bin/activate.fish # fish
source venv/bin/activate # everything else
# run from the repo root, not doc/
pip install -e .[dev]
```
## Usage
For local testing, create a file called `.env` in the repo root following this template:
```sh
GITHUB_REPOSITORY=beholderface/oneironaut
GITHUB_SHA=main
GITHUB_PAGES_URL=https://beholderface.github.io/oneironaut
```
Useful commands:
```sh
# show help
hexdoc -h
# render and serve the web book in watch mode
nodemon --config doc/nodemon.json
# render and serve the web book
hexdoc serve
# export, render, and merge the web book
hexdoc export
hexdoc render
hexdoc merge
# start the Python interpreter with some extra local variables
hexdoc repl
```
Raw data
{
"_id": null,
"home_page": null,
"name": "hexdoc-oneironaut",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "hexdoc",
"author": "beholderface",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/2c/7a/b3d96142b00e832baa007ae09dccc39d6b070ee5f9d4c7e5ce1305013fdd/hexdoc_oneironaut-0.3.3.1.0.tar.gz",
"platform": null,
"description": "# hexdoc-oneironaut\n\nPython web book docgen and [hexdoc](https://pypi.org/project/hexdoc) plugin for Oneironaut.\n\n## Version scheme\n\nWe use [hatch-gradle-version](https://pypi.org/project/hatch-gradle-version) to generate the version number based on whichever mod version the docgen was built with.\n\nThe version is in this format: `mod-version.python-version.mod-pre.python-dev.python-post`\n\nFor example:\n* Mod version: `0.11.1-7`\n* Python package version: `1.0.dev0`\n* Full version: `0.11.1.1.0rc7.dev0`\n\n## Setup\n\n```sh\npython3.11 -m venv venv\n\n.\\venv\\Scripts\\activate # Windows\n. venv/bin/activate.fish # fish\nsource venv/bin/activate # everything else\n\n# run from the repo root, not doc/\npip install -e .[dev]\n```\n\n## Usage\n\nFor local testing, create a file called `.env` in the repo root following this template:\n```sh\nGITHUB_REPOSITORY=beholderface/oneironaut\nGITHUB_SHA=main\nGITHUB_PAGES_URL=https://beholderface.github.io/oneironaut\n```\n\nUseful commands:\n```sh\n# show help\nhexdoc -h\n\n# render and serve the web book in watch mode\nnodemon --config doc/nodemon.json\n\n# render and serve the web book\nhexdoc serve\n\n# export, render, and merge the web book\nhexdoc export\nhexdoc render\nhexdoc merge\n\n# start the Python interpreter with some extra local variables\nhexdoc repl\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Python web book docgen and hexdoc plugin for Oneironaut.",
"version": "0.3.3.1.0",
"project_urls": {
"Homepage": "https://beholderface.github.io/oneironaut",
"Source": "https://github.com/beholderface/oneironaut"
},
"split_keywords": [
"hexdoc"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ae5f7525072bb6efb3f215f9a8e7062572834bc21558c03e80023eec76ca5f36",
"md5": "08390f403d464b3ccd10a401f74c6bbd",
"sha256": "ef2dc7f780d088f3c0553c4168a317e3315ac95df48f6eb408368e83b8d4381b"
},
"downloads": -1,
"filename": "hexdoc_oneironaut-0.3.3.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "08390f403d464b3ccd10a401f74c6bbd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 519481,
"upload_time": "2024-07-12T21:37:09",
"upload_time_iso_8601": "2024-07-12T21:37:09.510724Z",
"url": "https://files.pythonhosted.org/packages/ae/5f/7525072bb6efb3f215f9a8e7062572834bc21558c03e80023eec76ca5f36/hexdoc_oneironaut-0.3.3.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2c7ab3d96142b00e832baa007ae09dccc39d6b070ee5f9d4c7e5ce1305013fdd",
"md5": "d06b0090cb6a5aff3ec54f6b03e17128",
"sha256": "8292740f54a8fcf88f8f34a416828c937203547eb45235e73c8562a4baa229f5"
},
"downloads": -1,
"filename": "hexdoc_oneironaut-0.3.3.1.0.tar.gz",
"has_sig": false,
"md5_digest": "d06b0090cb6a5aff3ec54f6b03e17128",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 436793,
"upload_time": "2024-07-12T21:37:13",
"upload_time_iso_8601": "2024-07-12T21:37:13.847634Z",
"url": "https://files.pythonhosted.org/packages/2c/7a/b3d96142b00e832baa007ae09dccc39d6b070ee5f9d4c7e5ce1305013fdd/hexdoc_oneironaut-0.3.3.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-12 21:37:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "beholderface",
"github_project": "oneironaut",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "hexdoc-oneironaut"
}
