HWDOCER

The HardWare DOCumentation buildER is a utility that help generating graphical documentations using drawio and wireviz

Install

Stable version

Stable package are release on pypi.org and are installable simply via pip:

pip install hwdocer

You can also clone the specific tags from the repo

Development version

Development version are only available on the repo, the suggested process is to add a git submodule to your project:

Add the submodule
simply open a terminal in the host repo and execute this:

git submodule add https://gitlab.com/real-ee/public/hwdocer.git dep/hwdocer

Venv install Then you need to install the venv, by having poetry and pyenv.
Open a terminal then execute this:
```
poetry install
```

Usage

Direct call

If you installed the stable version (via pypi) you can call it directly like this:

hwdocer -vv -i "./" -o "./_build"

Python module call

When installed as a python module, you can invoke it

poetry run python -m hwdocer -vvvv -i "./doc" -o "./doc/build"

NOTE: Currently all *.yml file in the input search will match for harness drawing and all *.drawio files will match for diagram drawing

Adding source to be built

This tool uses drawio local software and wireviz defined file, use them to creat some source file which you pass as input (-i argument) to hwdocer.

Drawio

To create diagram and drawing that will be then automatically drawn by this tool, you need to install drawio local executable by downloading the installer for your OS (only linux tested)

Wireviz

To create wire harness, install wireviz, which is a project based on graphviz but aimed to specifically draw wire harnesses.

Contrib

See the contribution guideline

Changelog

See the release file and roadmap file

License

This software is released under GPL3

Metadata

Release files for hwdocer 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hwdocer 0.2.2
File	Size	Uploaded
hwdocer-0.2.2.tar.gz	10.6 kB	Apr 9, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for hwdocer 0.2.2
File	Interpreter	ABI	Platform	Reset
hwdocer-0.2.2-py3-none-any.whl 10.3 kB Apr 9, 2024	Python 3	none	any	Details

Total release size: 20.9 kB

Release files / hwdocer-0.2.2.tar.gz

Download URL	hwdocer-0.2.2.tar.gz
Size	10.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`75f2c14cb2ac18c52c333ff7d24526b991e9a3d84521a8de65573d4fefaafa80`
BLAKE2b-256 checksum How to use checksums	`85113b60d013bf4cf666442ea46ddff76d62e078980b940efa59ea600032916f`
Upload date	Apr 9, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.2 CPython/3.8.16 Linux/6.8.0-76060800daily20240311-generic`

Release files / hwdocer-0.2.2-py3-none-any.whl

Download URL	hwdocer-0.2.2-py3-none-any.whl
Size	10.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`78153d71f83b89f513adc027edbf4ee2b296f1b14d5553639f6e990dfd34406e`
BLAKE2b-256 checksum How to use checksums	`6576b8bfc7135c4cf88c2b7ebfa31cf233c20e2383a5b3d691dc4ab91fc956dd`
Upload date	Apr 9, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.2 CPython/3.8.16 Linux/6.8.0-76060800daily20240311-generic`