Metadata-Version: 2.1
Name: mknodes
Version: 0.4.2
Summary: Generate docs with ease.
Project-URL: Documentation, https://phil65.github.io/mknodes/
Project-URL: Source, https://github.com/phil65/mknodes
Author-email: mknodes <philipptemminghoff@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: docs,docstrings,documentation,framework,internet,markdown
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Documentation
Classifier: Topic :: Internet
Classifier: Topic :: Text Processing :: Markup :: Markdown
Requires-Python: >=3.10
Requires-Dist: mkdocs
Requires-Dist: mkdocs-gen-files
Requires-Dist: typing-extensions
Description-Content-Type: text/markdown

# MkNodes

<p align="center">
    <em>Generate docs with ease.</em>
</p>

[![build](https://github.com/phil65/mknodes/workflows/Build/badge.svg)](https://github.com/phil65/mknodes/actions)
[![codecov](https://codecov.io/gh/phil65/mknodes/branch/master/graph/badge.svg)](https://codecov.io/gh/phil65/mknodes)
[![PyPI version](https://badge.fury.io/py/mknodes.svg)](https://badge.fury.io/py/mknodes)

---

**Documentation**: <a href="https://phil65.github.io/mknodes/" target="_blank">https://phil65.github.io/mknodes/</a>

**Source Code**: <a href="https://github.com/phil65/mknodes" target="_blank">https://github.com/phil65/mknodes</a>

---

## Development

### Setup environment

We use [Hatch](https://hatch.pypa.io/latest/install/) to manage the development environment and production build. Ensure it's installed on your system.

### Run unit tests

You can run all the tests with:

```bash
hatch run test
```

### Format the code

Execute the following command to apply linting and check typing:

```bash
hatch run lint
```

### Publish a new version

You can bump the version, create a commit and associated tag with one command:

```bash
hatch version patch
```

```bash
hatch version minor
```

```bash
hatch version major
```

Your default Git text editor will open so you can add information about the release.

When you push the tag on GitHub, the workflow will automatically publish it on PyPi and a GitHub release will be created as draft.

## Serve the documentation

You can serve the Mkdocs documentation with:

```bash
hatch run docs-serve
```

It'll automatically watch for changes in your code.

## License

This project is licensed under the terms of the MIT license.
