Tool to create README.rst files for Odoo
Project description
README GENERATOR
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
Installation
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.
Recomendation
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"
pre-commit hook
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for gen_odoo_readme-1.2.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cf9eb904800a63ae29ca259c3e4d04bffe1fb1849568d00369d9a4ea2f9ccb64 |
|
MD5 | 3b0ea88b4e6c3a0f35c5bda94772fbf6 |
|
BLAKE2b-256 | 5de52e820f58063c9c75cd2c6585f40116c85e9cd3f343c5f00d4bdb27aa3c04 |