openmairie.devtools 1.5.0

om-tests

Should be run from the tests folder of your project and allow you to initialize your test environment, to run all tests suites or to run only one tests suite.

om-svnexternals

Install SVN dependencies listed in EXTERNALS.txt.

Should be run from the root of your project. It scans for EXTERNALS.txt files and resolves each entry using the following strategy:

1. Git branch export — for openmairie_exemple/branches/... URLs, if the matching branch exists in the openmairie/framework-openmairie git repository, the requested sub-directory is exported from that branch.

2. GitLab package registry — the SVN URL is parsed to derive a package name and version. If a matching archive exists in the generic package registry, it is downloaded and extracted.

3. SVN export — if neither path succeeds, a classic svn export --force --ignore-externals is performed and any nested EXTERNALS.txt discovered inside the export is resolved recursively.

Three URL patterns are recognised:

• Externals (externals-- prefixed packages):

  .../externals/fpdf/tags/1.8.5/             → externals--fpdf          1.8.5
  .../externals/pear/pear-core/tags/v1.10.12 → externals--pear--pear-core v1.10.12
  .../externals/om-theme/kied/tags/2.0.0     → externals--om-theme--kied 2.0.0

• Framework tags (openmairie_exemple) — maps to the single package externals--framework-openmairie. The bundled archive (with resolved sub-externals) is preferred over the bare one:

  .../openmairie_exemple/tags/4.11.0-a16/core → core-bundle.tar.gz then core.tar.gz
  .../openmairie_exemple/tags/4.11.0-a16/lib  → lib-bundle.tar.gz  then lib.tar.gz

• Framework branches (openmairie_exemple) — exported from git, not from the package registry (and not cached, since a branch moves):

  .../openmairie_exemple/branches/4.11.x/core → branch 4.11.x, sub-directory core

Downloaded tag archives are cached locally so subsequent runs are near-instant.

Usage

cd /path/to/your/project
om-svnexternals            # normal run (uses cache)
om-svnexternals --no-cache # force re-download

om-release

Performs the complete release cycle for openMairie PHP applications (replacing the legacy om.releaser package). Should be run from the root of your project.

The workflow has three phases:

1. Prerelease: version bump in VERSION.txt (or dyn/version.inc.php), history file update, documentation link update, framework externals pinning, DB init & SQL file handling, commit.

2. Release: git tag.

3. Postrelease: bump to next development version (.dev0), new history section, framework externals unpinning, new SQL files, commit.

By default all three phases run in sequence. Each phase can also be run independently.

Usage

cd /path/to/your/project
om-release                  # full release (prerelease + tag + postrelease)
om-release --prerelease     # prerelease only
om-release --release        # tag only
om-release --postrelease    # postrelease only

om-release-notes

Generates a release notes PDF (and CSV) from a GitLab milestone. It fetches all issues attached to the milestone, converts their markdown descriptions (including images) to PDF, and produces a document with a cover page, table of contents, and one section per issue category (evolutions, bugs, others).

Usage

om-release-notes --project openmairie/openXXX --milestone "1.15.0"
om-release-notes --project openmairie/openXXX --milestone "1.15.0" \
    --logo logo.png --output notes.pdf

om-logo

This command allows you to generate SVG and PNG logo for your openMairie application, according to design’s guideline available here

http://www.openmairie.org/communaute/ressources-graphiques/openmairie-identite-visuelle.pdf

1.5.0 (2026-09-10)

• (om-svnexternals): support installing openmairie framework externals from the GitLab repository [flohcim]

• Print a notice to the user if a new version is available on PyPi [nathanaelhoun], idea from [flohcim]

• Revert pinned argcomplete version, upstream is fixed [nathanaelhoun,epritchard2]

1.4.2 (2026-08-05)

• Ensure argcomplete is compatible with python 3.9 [epritchard2]

1.4.1 (2026-07-24)

• Fix argument autocompletion breaking the whole scripts [nathanaelhoun]

• Modernize python packaging by following PEP 621 [nathanaelhoun]

1.4.0 (2026-07-24)

• Code base modernization. [nathanaelhoun]

• Always drop existing database on ìnitenv. [nathanaelhoun]

• GitLab CI/CD : new build-robotframework-documentation CI/CD component to build the robotframework documentation for all keywords of a given project and allow them to be published on GitLab Pages [nathanaelhoun]

• feat(om-release): add release workflow command replacing om.releaser. [flohcim, nathanaelhoun]

• feat(om-release-notes): new script to generate a PDF and CSV with release notes from a GitLab milestone. [flohcim, nathanaelhoun]

• Rename configuration directory from ~/.om-devtools/ to $XDG_CONFIG_HOME/om-devtools/. The legacy paths are still read with a deprecation warning. [nathanaelhoun]

1.3.0 (2026-03-30)

• om-tests: runall command now excludes the dev tag by default. [epontagnier]

• om-svnexternals: resolve externals from GitLab generic package registry instead of svn export when the archive is available. Falls back to svn export when not found. [flohcim]

• om-svnexternals: add local cache for downloaded archives (~/.cache/om-devtools/packages/). Use -N / --no-cache to force re-download. [flohcim]

• om-svnexternals: use svn export --force --ignore-externals and recursively resolve nested EXTERNALS.txt files. [flohcim]

• om-svnexternals: support framework URLs (openmairie_exemple) mapped to externals--framework-openmairie package with bundle priority. [flohcim]

• Rename configuration directory from ~/.om-tests/ to ~/.om-devtools/. The legacy path is still read with a deprecation warning. [flohcim]

1.2.0 (2025-05-28)

• Fixed documentation for pabot. [rasseum]

• Added two contributors. [rasseum]

• Note: Version 1.1.1 should have been named 1.2.0. This 1.2.0 version restores proper versioning by correcting several aspects. [rasseum]

1.1.1 (2025-04-24)

• Add pabot to openmairie.devtools. [rasseum]

1.1.0 (2023-10-08)

• Use robot and not pybot command anymore. [flohcim]

1.0.0 (2022-05-10)

• Python 3 support only. [flohcim, tiazma]

0.4.0 (2018-04-10)

• Add ‘additional_sql’ option config to om-tests. [flohcim]

0.3.1 (2018-01-10)

• Removed unnecessary jinja2 env options [tiazma]

0.3.0 (2018-01-10)

• Added om-logo, application logo generation [tiazma]

0.2.2 (2017-11-25)

• Remove the externals was breaking travis CI. [flohcim]

0.2.1 (2017-11-24)

• Filename of EXTERNALS.txt file parsed was missing. [flohcim]

0.2.0 (2017-11-24)

• Add om-svnexternals script. [flohcim]

0.1 (2017-11-23)

• Initial release as a python package. [flohcim, fmichon, jymadier, mbroquet, nhaye, NHaye, nmeucci, oc1n, softime, stimezouaght, tiazma]