poxy 0.16.0__py3-none-any.whl → 0.17.0__py3-none-any.whl

poxy/main.py

@@ -141,7 +141,7 @@ def multi_version_git_tags(args: argparse.Namespace):
     tags = sorted(tags, key=lambda t: t[1], reverse=True)
     tags.insert(0, (default_branch, (999999, 999999, 999999, 999999)))
 
-    if 0:
+    if args.squash_patches:
         # squash patch/rev differences
         seen_versions = set()
         for i in range(len(tags)):
@@ -152,6 +152,25 @@ def multi_version_git_tags(args: argparse.Namespace):
             seen_versions.add(normalized_version)
         tags = [t for t in tags if t]
 
+    if args.min_version is not None:
+        args.min_version = re.sub(r'[ \t]+', '', str(args.min_version).strip())
+        m = re.fullmatch(r'^[vV]?([0-9]+)(?:[.]([0-9]+)(?:[.]([0-9]+)(?:[.]([0-9]+))?)?)?$', args.min_version)
+        if m:
+            min_ver = (
+                (int(m[1] if m[1] else 0)),
+                (int(m[2] if m[2] else 0)),
+                (int(m[3] if m[3] else 0)),
+                (int(m[4] if m[4] else 0)),
+            )
+            tags = [t for t in tags if t[1] >= min_ver]
+        else:
+            try:
+                max_vers = int(args.min_version)
+                assert max_vers < 0
+                tags = tags[:-max_vers]
+            except:
+                raise Error(rf'min-version: expected semver tag or negative integer')
+
     tags = [t for t, _ in tags]
     print("Versions:")
     print("\n".join([rf'    {t}' for t in tags]))
@@ -159,7 +178,16 @@ def multi_version_git_tags(args: argparse.Namespace):
     worker_args = [
         arg
         for arg in sys.argv[1:]
-        if arg not in (r'--bug-report', r'--git-tags', r'--worker', r'--versions-in-navbar', r'--verbose', r'-v')
+        if arg
+        not in (
+            r'--bug-report',
+            r'--git-tags',
+            r'--worker',
+            r'--versions-in-navbar',
+            r'--verbose',
+            r'-v',
+            r'--higest-patch-only',
+        )
     ]
     for key in (r'--output-dir', r'--temp-dir', r'--copy-config-to'):
         pos = -1
@@ -430,7 +458,7 @@ def main(invoker=True):
         type=str,
         default=None,
         metavar=r'<regex>',
-        help=r"pattern matching HTML file names to exclude from post-processing (default: none)",
+        help=r"pattern matching HTML file names to exclude from post-processing (default: %(default)s)",
     )
     args.add_argument(
         r'--theme',  #
@@ -456,6 +484,19 @@ def main(invoker=True):
     args.add_argument(
         r'--git-tags', action=r'store_true', help=r"add git-tag-based semver version switcher to the generated HTML"  #
     )
+    make_boolean_optional_arg(
+        args,
+        r'squash-patches',
+        default=True,
+        help='when using --git-tags and two version tags differ by a patch number,\ngenerate docs for the highest one only (default: %(default)s)',
+    )
+    args.add_argument(
+        r'--min-version',
+        type=str,
+        default=None,
+        metavar='<version>',
+        help='sets the minimum version number to emit when using --git-tags,\nor a negative integer to mean "the last N versions". (default: %(default)s)',
+    )
 
     # --------------------------------------------------------------
     # hidden/developer-only/deprecated/diagnostic arguments

poxy/version.txt

@@ -1 +1 @@
-0.16.0
+0.17.0

{poxy-0.16.0.dist-info → poxy-0.17.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: poxy
-Version: 0.16.0
+Version: 0.17.0
 Summary: Documentation generator for C++.
 Author-email: Mark Gillard <mark.gillard@outlook.com.au>
 License: MIT
@@ -101,14 +101,16 @@ Poxy is a command-line application.
 ```
 usage: poxy [-h] [-v] [--html | --no-html] [--ppinclude <regex>] [--ppexclude <regex>]
             [--theme {light,dark,custom}] [--threads N] [--version] [--xml | --no-xml]
-            [--werror | --no-werror] [--bug-report] [--git-tags] [config]
+            [--werror | --no-werror] [--bug-report] [--git-tags]
+            [--squash-patches | --no-squash-patches] [--min-version <version>]
+            [config]
 
   _ __   _____  ___   _
  | '_ \ / _ \ \/ / | | |
  | |_) | (_) >  <| |_| |
  | .__/ \___/_/\_\\__, |
  | |               __/ |
- |_|              |___/  v0.16.0 - github.com/marzer/poxy
+ |_|              |___/  v0.17.0 - github.com/marzer/poxy
 
 Generate fancy C++ documentation.
 
@@ -120,15 +122,22 @@ options:
   -v, --verbose         enable very noisy diagnostic output
   --html, --no-html     specify whether HTML output is required
   --ppinclude <regex>   pattern matching HTML file names to post-process (default: all)
-  --ppexclude <regex>   pattern matching HTML file names to exclude from post-processing (default: none)
+  --ppexclude <regex>   pattern matching HTML file names to exclude from post-processing (default: None)
   --theme {light,dark,custom}
                         sets the default visual theme (default: read from config)
   --threads N           set the number of threads to use (default: automatic)
   --version             print the version and exit
   --xml, --no-xml       specify whether XML output is required
-  --werror, --no-werror treat warnings as errors (default: read from config)
+  --werror, --no-werror
+                        treat warnings as errors (default: read from config)
   --bug-report          captures all output in a zip file for easier bug reporting.
   --git-tags            add git-tag-based semver version switcher to the generated HTML
+  --squash-patches, --no-squash-patches
+                        when using --git-tags and two version tags differ by a patch number,
+                        generate docs for the highest one only (default: True)
+  --min-version <version>
+                        sets the minimum version number to emit when using --git-tags,
+                        or a negative integer to mean "the last N versions". (default: None)
 ```
 
 The basic three-step to using Poxy is similar to Doxygen:
@@ -212,6 +221,10 @@ Poxy bundles a fork of m.css, used per the [MIT/Expat license](https://github.co
 
 # Changelog
 
+## v0.17.0 - 2024-04-21
+
+-   added arguments `--min-version` and `--squash-patches` for more control over `--git-tags` mode
+
 ## v0.16.0 - 2024-01-28
 
 -   added multi-version mode argument `--git-tags`

{poxy-0.16.0.dist-info → poxy-0.17.0.dist-info}/RECORD

@@ -5,7 +5,7 @@ poxy/doxygen.py,sha256=nHygTYfKqh4M0hcdomWK5J3T16GZ7owM5oaWa141Ky4,46372
 poxy/emoji.py,sha256=Vj2ZbUq1MewLMVoLtH2xP_jZToRoNi52AgrIg3VhUuU,3410
 poxy/fixers.py,sha256=aUIQu4YEaygDK4YIaQJ9HsbP6uUKR3XYfroJQeps64M,44783
 poxy/graph.py,sha256=xI7xoV6-yTM-gh2OBARakANLHzGYBwwhwJHchQz2EKw,31959
-poxy/main.py,sha256=vSJWm54MNx9yDwobwL-qrTImSAU-bZsj_O3rOcZobYo,25482
+poxy/main.py,sha256=X8IvjjEnxwV0oT2lv5cP24CQjxHKpsxDmfByoPP2gxg,26937
 poxy/mcss.py,sha256=j9PmkfjcwaKdKBauwiPKhSeKGNmGiBt0i_WcnVAV3Hk,2157
 poxy/paths.py,sha256=OqyP9bIIhW0zyWL6PV2TVV9zsrtvnb25_XNmHlFJmQ8,1540
 poxy/project.py,sha256=TMb3kiMhlvvu4X4XsdtwrhbF2vWOZoeAKu15aMu3bbY,96377
@@ -16,7 +16,7 @@ poxy/soup.py,sha256=gMXKigNJDuJWWFhPpD5Gu9gbeyVVXo7SrjL1GcsqlMs,7678
 poxy/svg.py,sha256=tsMcKIxQ8OVmXEabqwKDkdEqYV4zI5wM0AJ-E1EXmVo,2657
 poxy/utils.py,sha256=0_HRU6GxlwJ5TXPJId2j8zQJnUZ8TJBiBU6wqgrMjrI,5748
 poxy/version.py,sha256=N5I7nr5zcmAy-hhgZFi7KfFPV-lB_ueD_Xx6R7XQ-tk,668
-poxy/version.txt,sha256=qgN0VLXoMgUhoysnij9K_wX8eQCatVA_XUobmjOzjEc,7
+poxy/version.txt,sha256=AtOOmOiPSo3C6kDbt2kzhgEGb8lJILUogqFPIa2X9-4,7
 poxy/xml_utils.py,sha256=dJEtHyp4lORHhmBt1E9miRH48PpPM6WRlLEdMhn0Yi8,2183
 poxy/css/m-special.css,sha256=dLVigwqsg_Htm6CESQGemyOKjb-plBlFk54dsAoOd_A,4644
 poxy/css/m-theme-dark.css,sha256=UbAEz9JAgJ1PJJG-Oy9UG2_DUqYTaPJm1cDvVGy5kYk,4186
@@ -176,10 +176,10 @@ poxy/mcss/plugins/m/plots.py,sha256=tiPvTZDkJ-Ab7xSVUhi5CFf_KvO017ZEtxS-ZQYJPiM,
 poxy/mcss/plugins/m/qr.py,sha256=EpYTecbB0m6IzJMDNpIeMjh3-bxisGw6sCdQgL3_Zl4,4183
 poxy/mcss/plugins/m/sphinx.py,sha256=OZHtZ0qVHYHGxJVpSARk_WQiIr6o9B-CTqx2Limfyuw,30965
 poxy/mcss/plugins/m/vk.py,sha256=MiZeFEagOkMBHfNXYf1YEaooCbgoGBtFY9K16CDqdaw,3108
-poxy-0.16.0.dist-info/LICENSE.txt,sha256=kp84JW_RPClTO5Hz6yHQ9jKPfUMerlHHAeyU0VpXV_E,1064
-poxy-0.16.0.dist-info/METADATA,sha256=3mZOiXlYggf6eJ-K9UO2zHe6nTYxq7Bn4YuqHYSJCkQ,19029
-poxy-0.16.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-poxy-0.16.0.dist-info/entry_points.txt,sha256=yWiOmptj1Ga_dDEU9ch16hRgmzDE8bgrtDkGbH7VFYc,66
-poxy-0.16.0.dist-info/top_level.txt,sha256=vAxxbZDX_cQ6rfRZ1SYSStSdMMlsHEP-zgzBSB0gPco,5
-poxy-0.16.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-poxy-0.16.0.dist-info/RECORD,,
+poxy-0.17.0.dist-info/LICENSE.txt,sha256=kp84JW_RPClTO5Hz6yHQ9jKPfUMerlHHAeyU0VpXV_E,1064
+poxy-0.17.0.dist-info/METADATA,sha256=DrK1i-r3OyMIsuuS1rCXA40UxijYv0MV466O0IBf5wA,19700
+poxy-0.17.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+poxy-0.17.0.dist-info/entry_points.txt,sha256=yWiOmptj1Ga_dDEU9ch16hRgmzDE8bgrtDkGbH7VFYc,66
+poxy-0.17.0.dist-info/top_level.txt,sha256=vAxxbZDX_cQ6rfRZ1SYSStSdMMlsHEP-zgzBSB0gPco,5
+poxy-0.17.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+poxy-0.17.0.dist-info/RECORD,,

{poxy-0.16.0.dist-info → poxy-0.17.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.42.0)
+Generator: bdist_wheel (0.43.0)
 Root-Is-Purelib: true
 Tag: py3-none-any