This package is based on the oca-gen-addon-readme from the OCA/maintainer-tools.git repo wich is licensed AGPL-3
This is a small utility that generates high quality README for our odoo modules in an automated way.
The sections of the final README are organized in fragments. They must be put inside a readme folder respecting this structure.
tony_stark_module
├── views
├── readme
| ├── CONFIGURE.rst
| ├── CONTRIBUTORS.rst
| ├── CREDITS.rst
| ├── DESCRIPTION.rst
| ├── HISTORY.rst
| ├── INSTALL.rst
| ├── READMAP.rst
| └── USAGE.rst
├── reports
├── static
└── views
eg. To generate the final README for each module of the repository we can say (if we are stand in the repository root)
gen-readme --repo-name=stark-enterprises --branch=16.0 --addon-dir="$PWD"
The result is a fully pypi compilant README.rst in the root of each module of the repo
sudo pip install gen-odoo-readme
see proyect in https://pypi.org/project/gen-odoo-readme/
Use el comando gen-readme --help para obtener esta ayuda
Usage: gen-readme [OPTIONS]
Options:
--org-name TEXT Organization name [required]
--repo-name TEXT Repository name, eg. server-tools. [required]
--branch TEXT Odoo series. eg 11.0. [required]
--addons-dir DIRECTORY Directory containing several addons, the README
will be generated for all installable addons
found there. [required]
--gen-html / --no-gen-html Generate index html file.
--help Show this message and exit.
We recommend to set a small make_readme.sh file in each repo as this
#!/usr/bin/env bash
#################################
# Generate the odoo README.rst documentacion for each module in
# the current repository.
# you must install this: pip install gen-odoo-readme
gen-readme \
--web https://quilsoft.com \
--org-name quilsoft-org \
--repo-name star_enterprises \
--branch 16.0 \
--addons-dir "$PWD"
You can use this module as a pre-commit plugin this way
- repo: https://github.com/jobiols/gen-readme.git
rev: 1.2.2
hooks:
- id: gen-readme