rolfedh-doc-utils 0.1.18__py3-none-any.whl → 0.1.20__py3-none-any.whl

archive_unused_files.py

@@ -11,6 +11,7 @@ import argparse
 from doc_utils.unused_adoc import find_unused_adoc
 from doc_utils.version_check import check_version_on_startup
 from doc_utils.file_utils import parse_exclude_list_file
+from doc_utils.version import __version__
 
 from doc_utils.spinner import Spinner
 def main():
@@ -25,6 +26,7 @@ def main():
     parser.add_argument('--exclude-dir', action='append', default=[], help='Directory to exclude (can be used multiple times).')
     parser.add_argument('--exclude-file', action='append', default=[], help='File to exclude (can be used multiple times).')
     parser.add_argument('--exclude-list', type=str, help='Path to a file containing directories or files to exclude, one per line.')
+    parser.add_argument('--version', action='version', version=f'%(prog)s {__version__}')
     args = parser.parse_args()
 
     # Use provided scan directories or None for auto-discovery

archive_unused_images.py

@@ -10,6 +10,7 @@ import argparse
 from doc_utils.unused_images import find_unused_images
 from doc_utils.version_check import check_version_on_startup
 from doc_utils.file_utils import parse_exclude_list_file
+from doc_utils.version import __version__
 
 from doc_utils.spinner import Spinner
 def main():
@@ -20,6 +21,7 @@ def main():
     parser.add_argument('--exclude-dir', action='append', default=[], help='Directory to exclude (can be used multiple times).')
     parser.add_argument('--exclude-file', action='append', default=[], help='File to exclude (can be used multiple times).')
     parser.add_argument('--exclude-list', type=str, help='Path to a file containing directories or files to exclude, one per line.')
+    parser.add_argument('--version', action='version', version=f'%(prog)s {__version__}')
     args = parser.parse_args()
 
     scan_dirs = ['.']

check_scannability.py

@@ -19,6 +19,7 @@ from datetime import datetime
 from doc_utils.scannability import check_scannability
 from doc_utils.version_check import check_version_on_startup
 from doc_utils.file_utils import collect_files, parse_exclude_list_file
+from doc_utils.version import __version__
 
 from doc_utils.spinner import Spinner
 BASE_SENTENCE_WORD_LIMIT = 22
@@ -43,6 +44,7 @@ def main():
     parser.add_argument('--exclude-dir', action='append', default=[], help='Directory to exclude (can be used multiple times).')
     parser.add_argument('--exclude-file', action='append', default=[], help='File to exclude (can be used multiple times).')
     parser.add_argument('--exclude-list', type=str, help='Path to a file containing directories or files to exclude, one per line.')
+    parser.add_argument('--version', action='version', version=f'%(prog)s {__version__}')
     # Do not add -h/--help to argparse, handled manually above
     args = parser.parse_args()
 

doc_utils/format_asciidoc_spacing.py

@@ -39,6 +39,7 @@ def process_file(file_path: Path, dry_run: bool = False, verbose: bool = False)
     changes_made = False
     in_block = False  # Track if we're inside a block (admonition, listing, etc.)
     in_conditional = False  # Track if we're inside a conditional block
+    in_comment_block = False  # Track if we're inside a //// comment block
 
     for i, current_line in enumerate(lines):
         prev_line = lines[i-1] if i > 0 else ""
@@ -48,9 +49,11 @@ def process_file(file_path: Path, dry_run: bool = False, verbose: bool = False)
         if re.match(r'^(ifdef::|ifndef::)', current_line):
             in_conditional = True
             # Add blank line before conditional if needed
+            # Don't add if previous line is a comment (they form a logical unit)
             if (prev_line and
                 not re.match(r'^\s*$', prev_line) and
-                not re.match(r'^(ifdef::|ifndef::|endif::)', prev_line)):
+                not re.match(r'^(ifdef::|ifndef::|endif::)', prev_line) and
+                not re.match(r'^//', prev_line)):
                 new_lines.append("")
                 changes_made = True
                 if verbose:
@@ -70,19 +73,55 @@ def process_file(file_path: Path, dry_run: bool = False, verbose: bool = False)
                 if verbose:
                     messages.append("  Added blank line after conditional block")
 
+        # Check for comment block delimiters (////)
+        elif re.match(r'^////+$', current_line):
+            in_comment_block = not in_comment_block  # Toggle comment block state
+            new_lines.append(current_line)
+
+            # If we're closing a comment block, add blank line after if needed
+            if not in_comment_block:
+                if (next_line and
+                    not re.match(r'^\s*$', next_line) and
+                    not re.match(r'^////+$', next_line)):
+                    new_lines.append("")
+                    changes_made = True
+                    if verbose:
+                        messages.append("  Added blank line after comment block")
+
         # Check for block delimiters (====, ----, ...., ____)
         # These are used for admonitions, listing blocks, literal blocks, etc.
         elif re.match(r'^(====+|----+|\.\.\.\.+|____+)$', current_line):
             in_block = not in_block  # Toggle block state
             new_lines.append(current_line)
+
+        # Check for role blocks ([role="..."])
+        # Role blocks don't need special spacing - they're followed directly by content
+        elif not in_block and not in_comment_block and re.match(r'^\[role=', current_line):
+            new_lines.append(current_line)
+
+        # Check for block titles (.Title)
+        elif not in_block and not in_comment_block and re.match(r'^\.[A-Z]', current_line):
+            # Add blank line before block title if needed
+            if (prev_line and
+                not re.match(r'^\s*$', prev_line) and
+                not re.match(r'^=+\s+', prev_line) and
+                not re.match(r'^\[role=', prev_line)):  # Don't add if previous is heading, empty, or role block
+                new_lines.append("")
+                changes_made = True
+                if verbose:
+                    truncated = current_line[:50] + "..." if len(current_line) > 50 else current_line
+                    messages.append(f"  Added blank line before block title: {truncated}")
+            new_lines.append(current_line)
+
         # Check if current line is a heading (but not if we're in a block)
         elif not in_block and re.match(r'^=+\s+', current_line):
             new_lines.append(current_line)
 
-            # Check if next line is not empty and not another heading
+            # Check if next line is not empty, not another heading, and not a comment block
             if (next_line and
                 not re.match(r'^=+\s+', next_line) and
-                not re.match(r'^\s*$', next_line)):
+                not re.match(r'^\s*$', next_line) and
+                not re.match(r'^////+$', next_line)):  # Don't add if next is comment block
                 new_lines.append("")
                 changes_made = True
                 if verbose:
@@ -98,15 +137,19 @@ def process_file(file_path: Path, dry_run: bool = False, verbose: bool = False)
                 # Check if next line is an include directive
                 if next_line and re.match(r'^include::', next_line):
                     # This comment belongs to the include, add blank line before comment if needed
+                    # This includes when previous line is an include (to separate include blocks)
                     if (prev_line and
                         not re.match(r'^\s*$', prev_line) and
                         not re.match(r'^//', prev_line) and
-                        not re.match(r'^:', prev_line)):  # Don't add if previous is attribute
+                        not re.match(r'^:', prev_line)):
                         new_lines.append("")
                         changes_made = True
                         if verbose:
                             messages.append("  Added blank line before comment above include")
-                new_lines.append(current_line)
+                    new_lines.append(current_line)
+                else:
+                    # Standalone comment, just add it
+                    new_lines.append(current_line)
 
         # Check if current line is an attribute (starts with :)
         elif re.match(r'^:', current_line):
@@ -125,7 +168,10 @@ def process_file(file_path: Path, dry_run: bool = False, verbose: bool = False)
                         changes_made = True
                         if verbose:
                             messages.append("  Added blank line before attribute above include")
-                new_lines.append(current_line)
+                    new_lines.append(current_line)
+                else:
+                    # Standalone attribute, just add it
+                    new_lines.append(current_line)
 
         # Check if current line is an include directive
         elif re.match(r'^include::', current_line):
@@ -155,10 +201,10 @@ def process_file(file_path: Path, dry_run: bool = False, verbose: bool = False)
                 if not (is_attribute_include and is_near_h1):
                     # Don't add blank line if there's a comment or attribute above (it was handled by the comment/attribute logic)
                     if not has_comment_above and not has_attribute_above:
-                        # Add blank line before include if previous line is not empty and not an include
+                        # Add blank line before include if previous line is not empty
+                        # This includes adding blank lines between consecutive includes
                         if (prev_line and
-                            not re.match(r'^\s*$', prev_line) and
-                            not re.match(r'^include::', prev_line)):
+                            not re.match(r'^\s*$', prev_line)):
                             new_lines.append("")
                             changes_made = True
                             if verbose:

doc_utils/version.py

@@ -0,0 +1,8 @@
+"""Version information for doc-utils."""
+
+# This should match the version in pyproject.toml
+__version__ = "0.1.20"
+
+def get_version():
+    """Return the current version string."""
+    return __version__

doc_utils/version_check.py

@@ -136,6 +136,26 @@ def check_for_update(force_check: bool = False) -> Optional[str]:
     return None
 
 
+def detect_install_method() -> str:
+    """
+    Detect how the package was installed.
+
+    Returns:
+        'pipx', 'pip', or 'unknown'
+    """
+    # Check if running from pipx venv
+    if 'pipx' in sys.prefix:
+        return 'pipx'
+
+    # Check PIPX_HOME environment variable
+    pipx_home = os.environ.get('PIPX_HOME') or os.path.join(Path.home(), '.local', 'pipx')
+    if pipx_home and str(Path(sys.prefix)).startswith(str(Path(pipx_home))):
+        return 'pipx'
+
+    # Default to pip
+    return 'pip'
+
+
 def show_update_notification(latest_version: str, current_version: str = None):
     """Show update notification to user."""
     if not current_version:
@@ -144,9 +164,17 @@ def show_update_notification(latest_version: str, current_version: str = None):
         except Exception:
             current_version = 'unknown'
 
+    # Detect installation method and recommend appropriate upgrade command
+    install_method = detect_install_method()
+
     # Use stderr to avoid interfering with tool output
     print(f"\n📦 Update available: {current_version} → {latest_version}", file=sys.stderr)
-    print(f"   Run: pip install --upgrade rolfedh-doc-utils", file=sys.stderr)
+
+    if install_method == 'pipx':
+        print(f"   Run: pipx upgrade rolfedh-doc-utils", file=sys.stderr)
+    else:
+        print(f"   Run: pip install --upgrade rolfedh-doc-utils", file=sys.stderr)
+
     print("", file=sys.stderr)
 
 

doc_utils_cli.py

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+"""
+doc-utils - CLI tools for AsciiDoc documentation projects
+
+Main entry point that provides a hub for all doc-utils tools.
+"""
+
+import argparse
+import sys
+from doc_utils.version import __version__
+from doc_utils.version_check import check_version_on_startup
+
+
+# Tool definitions with descriptions
+TOOLS = [
+    {
+        'name': 'validate-links',
+        'description': 'Validates all links in documentation with URL transposition [EXPERIMENTAL]',
+        'example': 'validate-links --transpose "https://prod--https://preview"'
+    },
+    {
+        'name': 'extract-link-attributes',
+        'description': 'Extracts link/xref macros with attributes into reusable definitions',
+        'example': 'extract-link-attributes --dry-run'
+    },
+    {
+        'name': 'replace-link-attributes',
+        'description': 'Resolves Vale LinkAttribute issues by replacing attributes in link URLs',
+        'example': 'replace-link-attributes --dry-run'
+    },
+    {
+        'name': 'format-asciidoc-spacing',
+        'description': 'Standardizes spacing after headings and around includes [EXPERIMENTAL]',
+        'example': 'format-asciidoc-spacing --dry-run modules/'
+    },
+    {
+        'name': 'check-scannability',
+        'description': 'Analyzes document readability by checking sentence/paragraph length',
+        'example': 'check-scannability --max-sentence-length 5'
+    },
+    {
+        'name': 'archive-unused-files',
+        'description': 'Finds and optionally archives unreferenced AsciiDoc files',
+        'example': 'archive-unused-files  # preview\narchive-unused-files --archive  # execute'
+    },
+    {
+        'name': 'archive-unused-images',
+        'description': 'Finds and optionally archives unreferenced image files',
+        'example': 'archive-unused-images  # preview\narchive-unused-images --archive  # execute'
+    },
+    {
+        'name': 'find-unused-attributes',
+        'description': 'Identifies unused attribute definitions in AsciiDoc files',
+        'example': 'find-unused-attributes  # auto-discovers attributes files'
+    },
+]
+
+
+def print_tools_list():
+    """Print a formatted list of all available tools."""
+    print("\n🛠️  Available Tools:\n")
+
+    for tool in TOOLS:
+        # Print tool name and description
+        experimental = " [EXPERIMENTAL]" if "[EXPERIMENTAL]" in tool['description'] else ""
+        desc = tool['description'].replace(" [EXPERIMENTAL]", "")
+        print(f"  {tool['name']}{experimental}")
+        print(f"    {desc}")
+        print()
+
+
+def print_help():
+    """Print comprehensive help information."""
+    print(f"doc-utils v{__version__}")
+    print("\nCLI tools for maintaining clean, consistent AsciiDoc documentation repositories.")
+
+    print_tools_list()
+
+    print("📚 Usage:")
+    print("  doc-utils --version          Show version information")
+    print("  doc-utils --list             List all available tools")
+    print("  doc-utils --help             Show this help message")
+    print("  <tool-name> --help           Show help for a specific tool")
+    print()
+    print("📖 Documentation:")
+    print("  https://rolfedh.github.io/doc-utils/")
+    print()
+    print("💡 Examples:")
+    print("  find-unused-attributes")
+    print("  check-scannability --max-sentence-length 5")
+    print("  format-asciidoc-spacing --dry-run modules/")
+    print()
+    print("⚠️  Safety First:")
+    print("  Always work in a git branch and review changes with 'git diff'")
+    print()
+
+
+def main():
+    """Main entry point for doc-utils command."""
+    # Check for updates (non-blocking)
+    check_version_on_startup()
+
+    parser = argparse.ArgumentParser(
+        description='doc-utils - CLI tools for AsciiDoc documentation projects',
+        add_help=False  # We'll handle help ourselves
+    )
+
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'doc-utils {__version__}'
+    )
+
+    parser.add_argument(
+        '--list',
+        action='store_true',
+        help='List all available tools'
+    )
+
+    parser.add_argument(
+        '--help', '-h',
+        action='store_true',
+        help='Show this help message'
+    )
+
+    # Parse known args to allow for future expansion
+    args, remaining = parser.parse_known_args()
+
+    # Handle flags
+    if args.list:
+        print_tools_list()
+        return 0
+
+    if args.help or len(sys.argv) == 1:
+        print_help()
+        return 0
+
+    # If we get here with remaining args, show help
+    if remaining:
+        print(f"doc-utils: unknown command or option: {' '.join(remaining)}")
+        print("\nRun 'doc-utils --help' for usage information.")
+        return 1
+
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

extract_link_attributes.py

@@ -11,6 +11,7 @@ import argparse
 import sys
 from doc_utils.extract_link_attributes import extract_link_attributes
 from doc_utils.version_check import check_version_on_startup
+from doc_utils.version import __version__
 
 
 def main():
@@ -86,6 +87,7 @@ Examples:
         default='both',
         help='Type of macros to process: link, xref, or both (default: both)'
     )
+    parser.add_argument('--version', action='version', version=f'%(prog)s {__version__}')
 
     args = parser.parse_args()
 

find_unused_attributes.py

@@ -15,6 +15,7 @@ from datetime import datetime
 from doc_utils.unused_attributes import find_unused_attributes, find_attributes_files, select_attributes_file, comment_out_unused_attributes
 from doc_utils.spinner import Spinner
 from doc_utils.version_check import check_version_on_startup
+from doc_utils.version import __version__
 
 def main():
     # Check for updates (non-blocking, won't interfere with tool operation)
@@ -27,6 +28,7 @@ def main():
     )
     parser.add_argument('-o', '--output', action='store_true', help='Write results to a timestamped txt file in your home directory.')
     parser.add_argument('-c', '--comment-out', action='store_true', help='Comment out unused attributes in the attributes file with "// Unused".')
+    parser.add_argument('--version', action='version', version=f'%(prog)s {__version__}')
     args = parser.parse_args()
 
     # Determine which attributes file to use

format_asciidoc_spacing.py

@@ -11,6 +11,7 @@ from pathlib import Path
 
 from doc_utils.format_asciidoc_spacing import process_file, find_adoc_files
 from doc_utils.version_check import check_version_on_startup
+from doc_utils.version import __version__
 
 
 from doc_utils.spinner import Spinner
@@ -63,6 +64,7 @@ Examples:
         action='store_true',
         help='Show detailed output'
     )
+    parser.add_argument('--version', action='version', version=f'%(prog)s {__version__}')
 
     args = parser.parse_args()
 

replace_link_attributes.py

@@ -20,6 +20,7 @@ from doc_utils.replace_link_attributes import (
     find_adoc_files
 )
 from doc_utils.version_check import check_version_on_startup
+from doc_utils.version import __version__
 from doc_utils.spinner import Spinner
 
 
@@ -111,6 +112,7 @@ def main():
         default='both',
         help='Type of macros to process: link, xref, or both (default: both)'
     )
+    parser.add_argument('--version', action='version', version=f'%(prog)s {__version__}')
 
     args = parser.parse_args()
 

{rolfedh_doc_utils-0.1.18.dist-info → rolfedh_doc_utils-0.1.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rolfedh-doc-utils
-Version: 0.1.18
+Version: 0.1.20
 Summary: CLI tools for AsciiDoc documentation projects
 Author: Rolfe Dlugy-Hegwer
 License: MIT License
@@ -57,6 +57,9 @@ These tools can modify or delete files. **Always:**
 # Install
 pipx install rolfedh-doc-utils
 
+# Verify installation
+doc-utils --version
+
 # Upgrade to latest version
 pipx upgrade rolfedh-doc-utils
 ```
@@ -75,6 +78,18 @@ pip install -e .
 
 ## 🛠️ Available Tools
 
+### Quick Reference
+
+Run `doc-utils` to see all available tools and their descriptions:
+
+```bash
+doc-utils --help     # Show comprehensive help
+doc-utils --list     # List all tools
+doc-utils --version  # Show version
+```
+
+### Individual Tools
+
 **Note:** Commands use hyphens (`-`), while Python files use underscores (`_`). After installing with pipx, use the hyphenated commands directly.
 
 | Tool | Description | Usage |
@@ -197,11 +212,11 @@ Before submitting PRs:
 
 ### 🔔 Update Notifications
 
-All tools now check for updates automatically and notify you when a new version is available:
+All tools automatically check for updates and notify you when a new version is available. The notification will recommend the appropriate upgrade command based on how you installed the package:
 
 ```
-📦 Update available: 0.1.15 → 0.1.16
-   Run: pip install --upgrade rolfedh-doc-utils
+📦 Update available: 0.1.19 → 0.1.20
+   Run: pipx upgrade rolfedh-doc-utils
 ```
 
 To disable update checks, set the environment variable:

rolfedh_doc_utils-0.1.20.dist-info/RECORD

@@ -0,0 +1,29 @@
+archive_unused_files.py,sha256=OJZrkqn70hiOXED218jMYPFNFWnsDpjsCYOmBRxYnHU,2274
+archive_unused_images.py,sha256=fZeyEZtTd72Gbd3YBXTy5xoshAAM9qb4qFPMjhHL1Fg,1864
+check_scannability.py,sha256=O6ROr-e624jVPvPpASpsWo0gTfuCFpA2mTSX61BjAEI,5478
+doc_utils_cli.py,sha256=3ShuLw--q-LpADHfz80ftEQndgVnXyTkupXnoRMR2UA,4726
+extract_link_attributes.py,sha256=wR2SmR2la-jR6DzDbas2PoNONgRZ4dZ6aqwzkwEv8Gs,3516
+find_unused_attributes.py,sha256=77CxFdm72wj6SO81w-auMdDjnvF83jWy_qaM7DsAtBw,4263
+format_asciidoc_spacing.py,sha256=nmWpw2dgwhd81LXyznq0rT8w6Z7cNRyGtPJGRyKFRdc,4212
+replace_link_attributes.py,sha256=Cpc4E-j9j-4_y0LOstAKYOPl02Ln_2bGNIeqp3ZVCdA,7624
+validate_links.py,sha256=lWuK8sgfiFdfcUdSVAt_5U9JHVde_oa6peSUlBQtsac,6145
+doc_utils/__init__.py,sha256=qqZR3lohzkP63soymrEZPBGzzk6-nFzi4_tSffjmu_0,74
+doc_utils/extract_link_attributes.py,sha256=U0EvPZReJQigNfbT-icBsVT6Li64hYki5W7MQz6qqbc,22743
+doc_utils/file_utils.py,sha256=fpTh3xx759sF8sNocdn_arsP3KAv8XA6cTQTAVIZiZg,4247
+doc_utils/format_asciidoc_spacing.py,sha256=QMeEGkbcZnK7MJDWdi6s_ct5LQ5A4zOfDaDwg8yrli0,12528
+doc_utils/replace_link_attributes.py,sha256=gmAs68_njBqEz-Qni-UGgeYEDTMxlTWk_IOm76FONNE,7279
+doc_utils/scannability.py,sha256=XwlmHqDs69p_V36X7DLjPTy0DUoLszSGqYjJ9wE-3hg,982
+doc_utils/spinner.py,sha256=lJg15qzODiKoR0G6uFIk2BdVNgn9jFexoTRUMrjiWvk,3554
+doc_utils/topic_map_parser.py,sha256=tKcIO1m9r2K6dvPRGue58zqMr0O2zKU1gnZMzEE3U6o,4571
+doc_utils/unused_adoc.py,sha256=2cbqcYr1os2EhETUU928BlPRlsZVSdI00qaMhqjSIqQ,5263
+doc_utils/unused_attributes.py,sha256=OHyAdaBD7aNo357B0SLBN5NC_jNY5TWXMwgtfJNh3X8,7621
+doc_utils/unused_images.py,sha256=nqn36Bbrmon2KlGlcaruNjJJvTQ8_9H0WU9GvCW7rW8,1456
+doc_utils/validate_links.py,sha256=iBGXnwdeLlgIT3fo3v01ApT5k0X2FtctsvkrE6E3VMk,19610
+doc_utils/version.py,sha256=BZlea1i6_Z9BTH1ITRRSnO3AEaAbTNlKLE-J4GL1QIo,203
+doc_utils/version_check.py,sha256=eHJnZmBTbdhhY2fJQW9KnnyD0rWEvCZpMg6oSr0fOmI,7090
+rolfedh_doc_utils-0.1.20.dist-info/licenses/LICENSE,sha256=vLxtwMVOJA_hEy8b77niTkdmQI9kNJskXHq0dBS36e0,1075
+rolfedh_doc_utils-0.1.20.dist-info/METADATA,sha256=SNhIc-1rGCXJVSJvL827C1bzHCpQu6Dr-3pJnJzeh4U,8203
+rolfedh_doc_utils-0.1.20.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rolfedh_doc_utils-0.1.20.dist-info/entry_points.txt,sha256=m3z-u5BsRe5Zt05cJdP5w4R-3d7wfa6yfJ6lHdxJYT8,449
+rolfedh_doc_utils-0.1.20.dist-info/top_level.txt,sha256=AeJfm0SrL6JK9YcehGnIi-UeRksDC0YETck667IEzeo,196
+rolfedh_doc_utils-0.1.20.dist-info/RECORD,,

{rolfedh_doc_utils-0.1.18.dist-info → rolfedh_doc_utils-0.1.20.dist-info}/entry_points.txt

@@ -2,6 +2,7 @@
 archive-unused-files = archive_unused_files:main
 archive-unused-images = archive_unused_images:main
 check-scannability = check_scannability:main
+doc-utils = doc_utils_cli:main
 extract-link-attributes = extract_link_attributes:main
 find-unused-attributes = find_unused_attributes:main
 format-asciidoc-spacing = format_asciidoc_spacing:main

{rolfedh_doc_utils-0.1.18.dist-info → rolfedh_doc_utils-0.1.20.dist-info}/top_level.txt

@@ -2,6 +2,7 @@ archive_unused_files
 archive_unused_images
 check_scannability
 doc_utils
+doc_utils_cli
 extract_link_attributes
 find_unused_attributes
 format_asciidoc_spacing

validate_links.py

@@ -13,6 +13,7 @@ import sys
 import json
 from doc_utils.validate_links import LinkValidator, parse_transpositions, format_results
 from doc_utils.version_check import check_version_on_startup
+from doc_utils.version import __version__
 from doc_utils.spinner import Spinner
 
 
@@ -132,6 +133,7 @@ Examples:
         action='store_true',
         help='Exit with error code if broken links are found'
     )
+    parser.add_argument('--version', action='version', version=f'%(prog)s {__version__}')
 
     args = parser.parse_args()
 

rolfedh_doc_utils-0.1.18.dist-info/RECORD

@@ -1,27 +0,0 @@
-archive_unused_files.py,sha256=VL4hEN40CTYJzScyevY1fn7Fs2O083qfJUYdrv5JxxM,2142
-archive_unused_images.py,sha256=uZ4-OSMja98toyraDaeG6OMjV7kU2hq-QsTjnDl-BfQ,1732
-check_scannability.py,sha256=IdHwzQtBWzx95zIDOx3B7OyzoKxTVtpn0wJUErFQRC0,5346
-extract_link_attributes.py,sha256=bfWC6h4QWj6YvwZ3-tc3K7oMC2wN4QdA4YMCKcYdKCg,3384
-find_unused_attributes.py,sha256=KYVhIgJobEtMzzVI4P7wkMym7Z6N27IdxQmg3qySvAo,4131
-format_asciidoc_spacing.py,sha256=B3Bo68_i_RJNlUdNLZ4TiYUslrbwhSkzX3Dyd9JWRo0,4080
-replace_link_attributes.py,sha256=OGD-COUG3JUCYOoARa32xqaSEcA-p31AJLk-d-FPUUQ,7492
-validate_links.py,sha256=KmN4dULwLiLM2lUyteXwbBuTuQHcNkCq0nhiaZ48BtI,6013
-doc_utils/__init__.py,sha256=qqZR3lohzkP63soymrEZPBGzzk6-nFzi4_tSffjmu_0,74
-doc_utils/extract_link_attributes.py,sha256=U0EvPZReJQigNfbT-icBsVT6Li64hYki5W7MQz6qqbc,22743
-doc_utils/file_utils.py,sha256=fpTh3xx759sF8sNocdn_arsP3KAv8XA6cTQTAVIZiZg,4247
-doc_utils/format_asciidoc_spacing.py,sha256=XnVJekaj39aDzjV3xFKl58flM41AaJzejxNYJIIAMz0,10139
-doc_utils/replace_link_attributes.py,sha256=gmAs68_njBqEz-Qni-UGgeYEDTMxlTWk_IOm76FONNE,7279
-doc_utils/scannability.py,sha256=XwlmHqDs69p_V36X7DLjPTy0DUoLszSGqYjJ9wE-3hg,982
-doc_utils/spinner.py,sha256=lJg15qzODiKoR0G6uFIk2BdVNgn9jFexoTRUMrjiWvk,3554
-doc_utils/topic_map_parser.py,sha256=tKcIO1m9r2K6dvPRGue58zqMr0O2zKU1gnZMzEE3U6o,4571
-doc_utils/unused_adoc.py,sha256=2cbqcYr1os2EhETUU928BlPRlsZVSdI00qaMhqjSIqQ,5263
-doc_utils/unused_attributes.py,sha256=OHyAdaBD7aNo357B0SLBN5NC_jNY5TWXMwgtfJNh3X8,7621
-doc_utils/unused_images.py,sha256=nqn36Bbrmon2KlGlcaruNjJJvTQ8_9H0WU9GvCW7rW8,1456
-doc_utils/validate_links.py,sha256=iBGXnwdeLlgIT3fo3v01ApT5k0X2FtctsvkrE6E3VMk,19610
-doc_utils/version_check.py,sha256=1ySC6Au21OqUMZr7AkIa3nMNh3M6wLQmPQCi-ZFIqoE,6338
-rolfedh_doc_utils-0.1.18.dist-info/licenses/LICENSE,sha256=vLxtwMVOJA_hEy8b77niTkdmQI9kNJskXHq0dBS36e0,1075
-rolfedh_doc_utils-0.1.18.dist-info/METADATA,sha256=0MRwKnjHS1EEX5--O9m0UQVvQpYSICZ1k-VSTX3VhQA,7824
-rolfedh_doc_utils-0.1.18.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-rolfedh_doc_utils-0.1.18.dist-info/entry_points.txt,sha256=2J4Ojc3kkuArpe2xcUOPc0LxSWCmnctvw8hy8zpnbO4,418
-rolfedh_doc_utils-0.1.18.dist-info/top_level.txt,sha256=1w0JWD7w7gnM5Sga2K4fJieNZ7CHPTAf0ozYk5iIlmo,182
-rolfedh_doc_utils-0.1.18.dist-info/RECORD,,