hexdoc-hexdebug


Namehexdoc-hexdebug JSON
Version 0.2.2.1.20.1.1.0 PyPI version JSON
download
home_pageNone
SummaryPython web book docgen and hexdoc plugin for HexDebug.
upload_time2024-05-28 17:43:27
maintainerNone
docs_urlNone
authorobject-Object
requires_python>=3.11
licenseNone
keywords hexdoc
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # hexdoc-hexdebug

Python web book docgen and [hexdoc](https://pypi.org/project/hexdoc) plugin for HexDebug.

## 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

Install Python 3.11 and Node 18 (20+ is **not** currently supported).

```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=object-Object/HexDebug
GITHUB_SHA=main
GITHUB_PAGES_URL=https://hexdebug.hexxy.media
```

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-hexdebug",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "hexdoc",
    "author": "object-Object",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/e0/1e/c8837cce625656f1015ff6aa58b07631c6f81d75e98ae506dc6f08ecb6a6/hexdoc_hexdebug-0.2.2.1.20.1.1.0.tar.gz",
    "platform": null,
    "description": "# hexdoc-hexdebug\n\nPython web book docgen and [hexdoc](https://pypi.org/project/hexdoc) plugin for HexDebug.\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\nInstall Python 3.11 and Node 18 (20+ is **not** currently supported).\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=object-Object/HexDebug\nGITHUB_SHA=main\nGITHUB_PAGES_URL=https://hexdebug.hexxy.media\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 HexDebug.",
    "version": "0.2.2.1.20.1.1.0",
    "project_urls": {
        "Homepage": "https://hexdebug.hexxy.media",
        "Source": "https://github.com/object-Object/HexDebug"
    },
    "split_keywords": [
        "hexdoc"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c16e88f236319d68c58fe6e7d4cca438bc435cde10f8202c731920f25ddf3b35",
                "md5": "54cd11e94c276460327f461f65bc33fe",
                "sha256": "7ccf70eecfb892d603d037a5b70c473c483b402edee48e7e3eb4511c44486f7a"
            },
            "downloads": -1,
            "filename": "hexdoc_hexdebug-0.2.2.1.20.1.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "54cd11e94c276460327f461f65bc33fe",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 36083,
            "upload_time": "2024-05-28T17:43:25",
            "upload_time_iso_8601": "2024-05-28T17:43:25.981392Z",
            "url": "https://files.pythonhosted.org/packages/c1/6e/88f236319d68c58fe6e7d4cca438bc435cde10f8202c731920f25ddf3b35/hexdoc_hexdebug-0.2.2.1.20.1.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e01ec8837cce625656f1015ff6aa58b07631c6f81d75e98ae506dc6f08ecb6a6",
                "md5": "7100be52e26d5032d9ed9f196f12ec81",
                "sha256": "db035e7af69cb1d2ead65d92a0beb7252826458fffbb26490e747d5c1b559f78"
            },
            "downloads": -1,
            "filename": "hexdoc_hexdebug-0.2.2.1.20.1.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "7100be52e26d5032d9ed9f196f12ec81",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 16684,
            "upload_time": "2024-05-28T17:43:27",
            "upload_time_iso_8601": "2024-05-28T17:43:27.462327Z",
            "url": "https://files.pythonhosted.org/packages/e0/1e/c8837cce625656f1015ff6aa58b07631c6f81d75e98ae506dc6f08ecb6a6/hexdoc_hexdebug-0.2.2.1.20.1.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-28 17:43:27",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "object-Object",
    "github_project": "HexDebug",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "hexdoc-hexdebug"
}
        
Elapsed time: 1.04334s