DUNAMAI(1)

📦
version 1.26.2 · 5 versions
, in fedora 43, fedora 44

💅 DUNAMAI 💅

okay so bestie, welcome to DUNAMAI(1) — it lives in the User Commands section of the manual, and today's whole vibe is dunamai from subversion. grab a lil snack, we're doing this together 🫶

✨ NAME ✨

dunamai — dunamai from subversion

like. that's it. that's the name. iconic behavior honestly 👑

🌸 DESCRIPTION 🌸

here's the whole shape of it, verbatim, no cap:

usage: dunamai from subversion [-h] [--metadata] [--no-metadata] [--dirty]
       [--tagged-metadata] [--pattern PATTERN]
       [--pattern-prefix PATTERN_PREFIX] [--format FORMAT] [--style
       {pep440,semver,pvp}] [--latest-tag] [--highest-tag] [--strict]
       [--path PATH] [--debug] [--bump] [--commit-length COMMIT_LENGTH]
       [--commit-prefix COMMIT_PREFIX] [--escape-with ESCAPE_WITH]
       [--tag-dir TAG_DIR]

Generate version from Subversion 💖 that's the job. that's the assignment. and she ate.

🔥 options 🔥

every single one of them, in order, nothing skipped, because we do NOT gatekeep here 🎀

  • -h, --help — show this help message and exit. the classic. the "bestie what do i do" button 🙈
  • --metadata — Always include metadata. Ignored when --format is used (default: None)
  • --no-metadata — Never include metadata. Ignored when --format is used (default: None)
  • --dirty — Include dirty flag if applicable. Ignored when --format is used (default: False)
  • --tagged-metadata — Include tagged metadata if applicable. Ignored when --format is used (default: False)
  • --pattern PATTERN — a regular expression that gets matched against the version source. the tea ☕ is that it must contain one capture group named base, and that group corresponds to the release segment of the source. optionally, it may contain another two groups named stage and revision, which correspond to a prerelease type (like 'alpha' or 'rc') and number (like in 'alpha-2' or 'rc3'). it may also contain a group named tagged_metadata for extra metadata after the main part of the version (typically after a plus sign). there may also be a group named epoch for the PEP 440 concept. and here's the plot twist — if the base group is not present, then instead this will be interpreted as a named preset, which may be one of the following: default, default-unprefixed (default: (?x) (?# ignore whitespace) ^v((?P<epoch>\d+)!)?(?P<base>\d+(\.\d+)*) (?# v1.2.3 or v1!2000.1.2) ([-._]?((?P<stage>[a-zA-Z]+)[-._]?(?P<revision>\d+)?))? (?# b0) (\+(?P<tagged_metadata>.+))?$ (?# +linux))) — yeah it's a whole paragraph, she's thorough, we love her 💅
  • --pattern-prefix PATTERN_PREFIX — Insert this after the pattern's start anchor (^). (default: None)
  • --format FORMAT — Custom output format. the available substitutions are: {base}, {stage}, {revision}, {distance}, {commit}, {dirty}, {tagged_metadata}, {epoch}, {branch}, {branch_escaped}, {timestamp}, {major}, {minor}, {patch} (default: None) ✨
  • --style {pep440,semver,pvp} — Preconfigured output format. Will default to PEP 440 if not set and no custom format given. If you specify both a style and a custom format, then the format will be validated against the style's rules (default: None)
  • --latest-tag — Only inspect the latest tag on the latest tagged commit for a pattern match (default: False)
  • --highest-tag — Only inspect the numerically highest tag across all tagged commits for a pattern match (default: False)
  • --strict — Elevate warnings to errors. When there are no tags, fail instead of falling back to 0.0.0 (default: False) 🚨
  • --path PATH — Directory to inspect, if not the current working directory (default: None)
  • --debug — Display additional information on stderr for troubleshooting (default: False) 🔍
  • --bump — Increment the last part of the version base by 1, unless the stage is set, in which case increment the revision by 1 or set it to a default of 2 if there was no revision Does nothing when on a commit with a version tag. (default: False)
  • --commit-length COMMIT_LENGTH — Use this many characters from the start of the full commit hash (default: None)
  • --commit-prefix COMMIT_PREFIX — Add this prefix when serializing commit IDs (default: None)
  • --escape-with ESCAPE_WITH — When escaping, replace with this substitution. The default is simply to remove invalid characters. (default: None)
  • --tag-dir TAG_DIR — Location of tags relative to the root (only: Subversion) (default: tags)
heads up bestie: --metadata, --no-metadata, --dirty, and --tagged-metadata all get ignored when --format is used. so if you're out here with a custom format, don't be surprised when those lil flags do absolutely nothing. that's not a bug, that's just the rules 💀

and that's the whole page!! every flag, every default, every regex, all present and accounted for, fr fr 💖

this was dunamai from subversion 1.26.2, dated August 2026 — go forth and version your Subversion repos, you absolute main character 🌈✨💅

📦 where this page comes from