wok-code 2.0.23

Python developers tools

Overview

Various tools at your fingertips.

The available tools are:

• cvt_csv_2_rst.py: convert csv file into rst file

• cvt_csv_2_xml.py: convert csv file into xml file

• cvt_script: parse bash script and convert to meet company standard

• gen_readme.py: generate documentation files, mainly README.rst

• odoo_dependency.py: show odoo dependencies and/or Odoo module tree

• odoo_translation.py: manage Odoo translation

• arcangelo: parse source .py file to meet pep8 and convert across Odoo versions

• please: developer shell

• wget_odoo_repositories.py: get repository names from github.com

Usage

usage: please [-h] [-H PATH] [-n] [-Q FILE] [-q] [-v] [-V] [action]

Zeroincombenze® developer shell.
obj after action may be on of apache, cwd, python, z0bug, zerobug, travis

positional arguments:
  action

options:
  -h, --help            show this help message and exit
  -H PATH, --home-devel PATH
                        Home devel directory
  -n, --dry-run         do nothing (dry-run)
  -Q FILE, --tools-config FILE
                        Configuration file
  -q, --quiet           silent mode
  -v, --verbose         verbose mode
  -V, --version         show program's version number and exit

Help available issuing: please help ACTION
© 2015-2023 by SHS-AV s.r.l.
Author: [e-mail]
Full documentation at: https://zeroincombenze-tools.readthedocs.io/

Action is one of:

• help

• build

• chkconfig

• config

• docs

• duplicate

• export MODULE DB

• import

• list

• lsearch

• publish

• push

• pythonhosted

• replace

• replica

• show

• status

• test

• translate MODULE DB

• version

• wep

build

Build a tar file for current PYPI project

chkconfig

Display various values of current project.

config global|local

Set various parameter by edit with vim. Set various parameter editing with vim. Comments inside configuration file can aim to set values.

Some variable are:

• GBL_EXCLUDE=test_impex -> Module globally escluded by test because can fail locally

• PYTHON_MATRIX=”2.7 3.7” -> python version to use in tests

docs

Prepare documentation to publish on readthedocs website (PYPI). Create / update README and index.html of Odoo module. Notice: README of repository history is tailored with last 60 days items; on README and index,html of module, history is tailored with last 180 days items; However max 12 items are added in README / index.html Summary showed to console are tailored with last 15 days.

export MODULE DB [-bBRANCH]

Export po file of Odoo project. If current directory is a module directory you can use ‘.’ (dot) for module name.

To declare specific version use -b switch

import MODULE DB

Import po file of Odoo project.

To declare target version use fB-bfR switch

publish docs|download|pypi|svg|testpypi

Publish documentation or package.

• publish docs -> publish generate docs to website (require system privileges)

• publish download -> publish tarball to download (require system privileges)

  type fBplease buildfR to generate tarball file

• publish pypi -> publish package to pypi website (from odoo user)

• publish svg -> publish test result svg file (require system privileges)

• publish tar -> write a tarball with package files

Getting started

Prerequisites

Zeroincombenze(R) tools requires:

• Linux Centos 7/8 or Debian 9/10/11 or Ubuntu 16/18/20/22/24

• python 2.7+, some tools require python 3.7+, best python 3.9+

• bash 5.0+

Installation

Current version via Git

cd $HOME
[[ ! -d ./tools ]] && git clone https://github.com/zeroincombenze/tools.git
cd ./tools
./install_tools.sh -pUT
source $HOME/devel/activate_tools

Upgrade

Current version via Git

cd ./tools
./install_tools.sh -pUT
source $HOME/devel/activate_tools

ChangeLog History

2.0.23 (2025-06-14)

• [IMP] arcangelo became a pypi package

• [IMP] please install python: now can install python 3.12

• [FIX] please version does not add line at the end of file

• [FIX] please: best recognition of read-only repositories

• [FIX] please test: check on templates to use

• [FIX] No crash if invalid modules declaration

• [FIX] License declaration compatible with pypi

2.0.22 (2025-05-31)

• [FIX] arcangelo: sometimes wrong format .rst files

• [FIX] please translate: new algorithm

• [FIX] lint_2_compare: minor bug fixing

• [IMP] lint_2_compare: automatic detecting version from source path

• [IMP] run_odoo_debug: new -A switch

• [IMP] deploy_odoo: minor improvements

• [UPD] Esteem quality rate: new algorithm

2.0.21 (2025-04-26)

• [IMP] please translation: modified algorithm

• [FIX] run_odoo_debug: module replacements

2.0.20 (2025-03-01)

• [FIX] gen_readme.py: read-only repositories

• [FIX] gen_readme.py: new odoo14+ nomenclature

• [FIX] please: new odoo14+ nomenclature

• [FIX] run_odoo_debug: new odoo14+ nomenclature

2.0.19 (2025-03-01)

• [FIX] please python 3.9+

• [FIX] install_python_3_from_source.sh: fix bugs and improvements

• [FIX] ssh.py: store encrypted password

• [IMP] run_odoo_debug: now can replace modules

• [IMP] cvt_script executable

• [IMP] deploy_odooo: more improvements

• [IMP] please: minor improvements

• [IMP] please clen db: remove filestore directories too

2.0.18 (2024-07-10)

• [FIX] please python 3.9+

• [FIX] deploy_odoo update addons_path in config file

• [FIX] deploy_odoo update that requires checkout, requires -f switch

• [FIX] deploy_odoo default branch from repo in actions different from clone

• [IMP] deploy_odoo new action merge

• [IMP] deploy_odoo new action new-branch

• [IMP] deploy_odoo: new features on status

• [FIX] gen_readme now check for images value for marketplace

• [IMP] gen_readme now can use .jpg and .gif images

• [IMP] new pg_requirements.py

• [IMP] run_odoo_debug checks fro pg_requirements from __manifest__.rst

• [FIX] No more depends on os0

• [IMP] Python 3.6 deprecated

2.0.17 (2024-05-11)

• [FIX] odoo_translate.py various fixes

• [IMP] Log file of daemon process of test in tests/logs

• [IMP] run_odoo_debug: OCB repository does not search for other repositories

• [IMP] deploy_odoo now download empy repositories (to compatibility use –clean-empy-repo)

2.0.16 (2024-03-26)

• [FIX] odoo_translation.py: case correction

• [FIX] run_odoo_debug: sometimes crashes on OCB/addons modules

• [FIX] gen_readme.py: Odoo repository documentation

• [FIX] gen_readme.py: thumbnail figure

• [FIX] please docs: count assertions

• [FIX] please test: switch -K –no-ext-test

• [FIX] deploy_odoo: crash when clone existing directory

• [IMP] deploy_odoo: new switch –continue-after-error

• [FIX] deploy_odoo/wget_odoo_repositories: store github query in cache

2.0.15 (2024-02-17)

• [FIX] do_git_checkout_new_branch: ignore symbolic links

• [FIX] deploy_odoo: minor fixes

• [IMP] do_git_checkout_new_branch: oddo 17.0

• [IMP] deploy_odoo: new action amend

• [IMP] deploy_odoo: new switch to link repositories

• [IMP] deploy_odoo: removed deprecated switches

• [IMP] New repositories selection

• [IMP] arcangelo improvements: new tests odoo from 8.0 to 17.0

• [IMP] arcangelo improvements: test odoo from 8.0 to 17.0

• [IMP] arcangelo switch -lll

• [IMP] arcaneglo: rules reorganization

• [IMP] arcangelo: trigger management and new param ctx

• [IMP] arcangelo: new switch -R to select rules to apply

2.0.14 (2024-02-07)

• [FIX] Quality rating formula

• [FIX] please install python –python=3.7

• [IMP] please publish marketplace

• [IMP] read-only repository

• [IMP] arcangelo improvements

• [IMP] gen_readme.py manifest rewrite improvements

• [IMP] cvt_csv_coa.py improvements

• [IMP] please test with new switch -D

• [IMP] run_odoo_debug improvements

2.0.13 (2023-11-27)

• [IMP] please install python, now can install python 3.10

• [IMP] arcangelo: new python version assignment from odoo version

• [IMP] please version: now show compare with last entry of history

• [FIX] please docs: faq

• [FIX] please help cwd

• [FIX] gen_readme.py: sometimes lost history

• [FIX] gen_readme.py: error reading malformed table

• [IMP] odoo_translation.py: new regression tests

• [FIX] odoo_translation.py: punctuation at the end of term

• [FIX] odoo_translation.py: first character case

• [FIX] odoo_translation.py: cache file format is Excel

• [FIX] run_odoo_debug: path with heading space

• [IMP] please test now can update account.account.xlsx

2.0.12 (2023-08-29)

• [FIX] gen_readme.py: minor fixes

• [IMP] gen_readme.py: manifest author priority

• [FIX] gen_readme.py: coverage in CHANGELOG.rst”

• [IMP] gen_readme.py: link to authors on README.rst and index.html

• [IMP] gen_readme.py: history tailoring keeps minimal 2 items

• [FIX] license_mgnt: best organization recognition

• [IMP] license_mgnt: powerp renamed to librerp

• [FIX] run_odoo_debug: no doc neither translate after test error

• [IMP] arcangelo: new rules

• [IMP] arcangelo: new git conflict selection

• [IMP] arcangelo: merge gen_readme.py formatting

• [IMP] arcangelo: new switch –string-normalization

• [FIX] deploy_odoo: minor fixes

• [FIX] odoo_translation: sometime did not translate

• [IMP] odoo_translation: best performance

2.0.10 (2023-07-10)

• [IMP] gen_readme.py: do not create .bak file; now it can be used in pre-commit process

• [IMP] please replace now do “please docs” before

• [IMP] please docs now do “please clean” after

• [IMP] please lint and zerobug now do “pre-commit run” before (–no-verify)

• [IMP] please test and zerobug now do “please translate” after (–no-translate)

• [IMP] please update: new switches –vme –odoo-venv

• [IMP] please clean db: new action replace old wep-db

• [IMP] please version: new interface

• [IMP] please show docs: new interface

• [REF] run_odoo_debug: partial refactoring

• [IMP] run_odoo_debug: new switch –daemon

• [IMP] arcangelo: new swicth –string-normalization

• [FIX] please test / run_odoo_debug: minor fixes

2.0.9 (2023-06-26)

• [FIX] run_odoo_debug: recognize ‘to upgrade’ and ‘to install’ states

• [FIX] run_odoo_debug: check for dropped DB and abort if still exist

• [REF] odoo_translation: refactoring

• [REF] please: refactoring

• [IMP] deploy_odoo: new brief for status

• [IMP] deploy_odoo: new action unstaged e new status format

• [IMP] do_migrate renamed to arcangelo

• [IMP] gen_readme.py: manage CHANGELOG.rst too

• [IMP] argangelo: refactoring to run inside pre-commit

2.0.8 (2023-05-09)

• [FIX] Install run_odoo_debug

• [FIX] Install do_git_ignore

• [IMP] lint_2_compare: ignore odoo/openerp test string and LICENSE files

• [IMP] lint_2_compare: new switch —purge do not load identical files (quick diff)

2.0.7 (2023-05-08)

• [IMP] deply_odoo: new action git-push

• [REF] odoo_translation: new implementation

• [FIX] run_odoo_debug: minor fixes

• [NEW] do_git_checkout_new_branch: new command

• [IMP] install_python3_from_source: improvements

• [FIX] ssh.py: scp with port not 22

2.0.6 (2023-02-23)

• [IMP] ssh.py: -m -s switches accept path with user and host

• [IMP] deploy_odoo: new property status to display

• [IMP] deploy_odoo: new switches -l and -x

• [NEW] do_git_checkout_new_branch.py

• [IMP] do_migrate.py: new features

• [IMP] run_odoo_debug.sh imported from odoo_score

• [FIX] run_odoo_debug.sh: ODOO_COMMIT TEST not set when build template

• [IMP] run_odoo_debug.sh: simulate server_wide_modules parameter for Odoo 7.0-

2.0.5 (2023-01-13)

• [IMP] please: wep now delete old travis-emulator logs

• [IMP] install_python_3_from_source.sh: now can install python 3.9

• [IMP] please: action docs, minor improvements

• [IMP] deploy_odoo: format output list

2.0.4 (2022-12-09)

• [FIX] deploy_odoo: update from path

• [FIX] build_cmd: best recognition of python version

• [FIX] set_python_version.sh: best recognition of python version

2.0.3 (2022-11-22)

• [REF] odoo_translation

2.0.2.1 (2022-10-31)

• [IMP] lint_2_compare: ignoring .git .idea egg-info and setup directories

• [IMP] lint_2_compare: new ignore switches

• [FIX] please translate: do not execute export

2.0.2 (2022-10-20)

• [IMP] Clearing code

2.0.1 (2022-10-12)

• [IMP] minor improvements

2.0.1 (2022-10-12)

• [IMP] stable version

Credits

Copyright

SHS-AV s.r.l. <https://www.shs-av.com/>

Authors

• SHS-AV s.r.l.

Contributors

• Antonio M. Vigliotti