rolfedh-doc-utils 0.1.4__py3-none-any.whl → 0.1.41__py3-none-any.whl

rolfedh_doc_utils-0.1.41.dist-info/METADATA

@@ -0,0 +1,246 @@
+Metadata-Version: 2.4
+Name: rolfedh-doc-utils
+Version: 0.1.41
+Summary: CLI tools for AsciiDoc documentation projects
+Author: Rolfe Dlugy-Hegwer
+License: MIT License
+        
+        Copyright (c) 2025 Rolfe Dlugy-Hegwer
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML>=6.0
+Dynamic: license-file
+
+# doc-utils
+
+[![PyPI version](https://badge.fury.io/py/rolfedh-doc-utils.svg)](https://pypi.org/project/rolfedh-doc-utils/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/github/license/rolfedh/doc-utils)](https://github.com/rolfedh/doc-utils/blob/main/LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-brightgreen)](https://rolfedh.github.io/doc-utils/)
+
+Python CLI tools for maintaining clean, consistent AsciiDoc documentation repositories.
+
+📚 **[View Full Documentation](https://rolfedh.github.io/doc-utils/)** | 📦 **[PyPI Package](https://pypi.org/project/rolfedh-doc-utils/)** | 🐙 **[GitHub](https://github.com/rolfedh/doc-utils)**
+
+## ⚠️ Safety First
+
+These tools can modify or delete files. **Always:**
+- Work in a git branch (never main/master)
+- Review changes with `git diff`
+- Test documentation builds after changes
+
+## 🚀 Quick Start
+
+### Install with pipx (Recommended)
+
+```bash
+# Install
+pipx install rolfedh-doc-utils
+
+# Verify installation
+doc-utils --version
+
+# Upgrade to latest version
+pipx upgrade rolfedh-doc-utils
+```
+
+### Alternative Installation
+
+```bash
+# With pip user flag
+pip install --user rolfedh-doc-utils
+
+# For development
+git clone https://github.com/rolfedh/doc-utils.git
+cd doc-utils
+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 |
+|------|-------------|-------|
+| **`validate-links`** | Validates links in AsciiDoc source files, with URL transposition for preview environments | `validate-links --transpose "https://prod--https://preview"` |
+| **`check-published-links`** | Validates links on published HTML docs using linkchecker, with URL rewriting for misresolved paths | `check-published-links https://docs.example.com/guide/` |
+| **`extract-link-attributes`** | Extracts link/xref macros with attributes into reusable definitions | `extract-link-attributes --dry-run` |
+| **`replace-link-attributes`** | Resolves Vale LinkAttribute issues by replacing attributes in link URLs | `replace-link-attributes --dry-run` |
+| **`format-asciidoc-spacing`** | Standardizes spacing after headings and around includes | `format-asciidoc-spacing --dry-run modules/` |
+| **`check-scannability`** | Analyzes readability (sentence/paragraph length) | `check-scannability --max-words 25` |
+| **`archive-unused-files`** | Finds and archives unreferenced .adoc files | `archive-unused-files` (preview)<br>`archive-unused-files --archive` (execute) |
+| **`archive-unused-images`** | Finds and archives unreferenced images | `archive-unused-images` (preview)<br>`archive-unused-images --archive` (execute) |
+| **`find-unused-attributes`** | Identifies unused attribute definitions | `find-unused-attributes attributes.adoc` |
+| **`inventory-conditionals`** | Creates inventory of `ifdef`/`ifndef` conditionals | `inventory-conditionals ~/docs -o ~/reports/` |
+| **`convert-callouts-to-deflist`** | Converts callout-style annotations to definition list format | `convert-callouts-to-deflist --dry-run modules/` |
+
+## 📖 Documentation
+
+Comprehensive documentation is available at **[rolfedh.github.io/doc-utils](https://rolfedh.github.io/doc-utils/)**
+
+### OpenShift-docs Example
+
+For OpenShift documentation repositories:
+
+```bash
+# Format spacing in specific directories
+format-asciidoc-spacing modules/
+format-asciidoc-spacing microshift_networking/
+
+# Preview changes first
+format-asciidoc-spacing --dry-run modules/networking/
+
+# Process specific file
+format-asciidoc-spacing modules/networking/about-networking.adoc
+```
+
+- [Getting Started Guide](https://rolfedh.github.io/doc-utils/getting-started)
+- [Tools Reference](https://rolfedh.github.io/doc-utils/tools/)
+- [Best Practices](https://rolfedh.github.io/doc-utils/best-practices)
+- [Contributing](https://rolfedh.github.io/doc-utils/contributing)
+
+## 💡 Common Workflows
+
+### Clean Up Documentation
+
+```bash
+# 1. Create a branch
+git checkout -b doc-cleanup
+
+# 2. Preview what would change
+format-asciidoc-spacing --dry-run .
+archive-unused-files
+archive-unused-images
+
+# 3. Apply changes
+format-asciidoc-spacing .
+archive-unused-files --archive
+archive-unused-images --archive
+
+# 4. Review and commit
+git diff
+git add -A && git commit -m "Clean up documentation"
+```
+
+### Check Documentation Quality
+
+```bash
+# Check readability
+check-scannability --max-words 30 --max-sentences 5
+
+# Find unused attributes
+find-unused-attributes attributes.adoc
+
+# Save results
+find-unused-attributes attributes.adoc --output unused.txt
+```
+
+## 🔧 Exclusions
+
+All tools support excluding files and directories:
+
+```bash
+# Exclude specific directories
+archive-unused-files --exclude-dir ./temp --exclude-dir ./drafts
+
+# Exclude specific files
+check-scannability --exclude-file ./README.adoc
+
+# Use exclusion list file
+echo "./deprecated/" > .docutils-ignore
+archive-unused-images --exclude-list .docutils-ignore
+```
+
+## 🧪 Development
+
+```bash
+# Install dev dependencies
+pip install -r requirements-dev.txt
+
+# Run tests
+python -m pytest tests/ -v
+
+# Run specific test
+python -m pytest tests/test_file_utils.py
+```
+
+## 🤝 Contributing
+
+We welcome contributions! See our [Contributing Guide](https://rolfedh.github.io/doc-utils/contributing) for details.
+
+Before submitting PRs:
+- ✅ All tests pass
+- ✅ Code follows PEP 8
+- ✅ Documentation updated
+- ✅ Changelog entry added
+
+## 📊 Project Status
+
+- **Latest Version**: 0.1.16 (with automatic update notifications)
+- **Python Support**: 3.8+
+- **Test Coverage**: 112+ tests (100% passing)
+- **Dependencies**: Minimal (PyYAML for OpenShift-docs support)
+
+### 🔔 Update Notifications
+
+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.19 → 0.1.20
+   Run: pipx upgrade rolfedh-doc-utils
+```
+
+To disable update checks, set the environment variable:
+```bash
+export DOC_UTILS_NO_VERSION_CHECK=1
+```
+
+Update checks are cached for 24 hours to minimize network requests.
+
+## 🔗 Resources
+
+- [Documentation](https://rolfedh.github.io/doc-utils/)
+- [PyPI Package](https://pypi.org/project/rolfedh-doc-utils/)
+- [Issue Tracker](https://github.com/rolfedh/doc-utils/issues)
+- [Changelog](https://github.com/rolfedh/doc-utils/blob/main/CHANGELOG.md)
+- [License](https://github.com/rolfedh/doc-utils/blob/main/LICENSE)
+
+## 📝 License
+
+This project is licensed under the terms specified in the [LICENSE](https://github.com/rolfedh/doc-utils/blob/main/LICENSE) file.
+
+---
+
+Created by [Rolfe Dlugy-Hegwer](https://github.com/rolfedh) for technical writers everywhere.

rolfedh_doc_utils-0.1.41.dist-info/RECORD

@@ -0,0 +1,52 @@
+archive_unused_files.py,sha256=YKYPtuBHEZcsyQSwSYxSYvw9v9Mh6Of8MqT53A5bM44,2438
+archive_unused_images.py,sha256=EvPhMIwp6_AHKtuNYQ663q6biXBeXaqf88NzWrhvtIE,2029
+check_published_links.py,sha256=nk07prV6xHVqVrYCy2Eb8BWkjkgJBhczk8U0E-KeIvA,43258
+check_scannability.py,sha256=O6ROr-e624jVPvPpASpsWo0gTfuCFpA2mTSX61BjAEI,5478
+check_source_directives.py,sha256=JiIvn_ph9VKPMH4zg-aSsuIGQZcnI_imj7rZLLE04L8,3660
+convert_callouts_interactive.py,sha256=4PjiVIOWxNJiJLQuBHT3x6rE46-hgfFHSaoo5quYIs8,22889
+convert_callouts_to_deflist.py,sha256=BoqW5_GkQ-KqNzn4vmE6lsQosrPV0lkB-bfAx3dzyMw,25886
+convert_freemarker_to_asciidoc.py,sha256=ki0bFDPWxl9aUHK_-xqffIKF4KJYMXA8S4XLG_mOA0U,10097
+convert_tables_to_deflists.py,sha256=PIP6xummuMqC3aSzahKKRBYahes_j5ZpHp_-k6BjurY,15599
+doc_utils_cli.py,sha256=J3CE7cTDDCRGkhAknYejNWHhk5t9YFGt27WDVfR98Xk,5111
+extract_link_attributes.py,sha256=wR2SmR2la-jR6DzDbas2PoNONgRZ4dZ6aqwzkwEv8Gs,3516
+find_duplicate_content.py,sha256=iYWekmriItXWSd8nBnIQN_FoZkv6quPJNL0qjv6UxUA,6343
+find_duplicate_includes.py,sha256=sQaVLOe4Ksc3t08_A_2GaLMwQCgKe9Nsr8c3ipp1Ph0,5456
+find_unused_attributes.py,sha256=AQVJsvRRgGsDjOZClcvJRQ5i5H2YrClcR-1nRLVBzI8,5140
+format_asciidoc_spacing.py,sha256=nmWpw2dgwhd81LXyznq0rT8w6Z7cNRyGtPJGRyKFRdc,4212
+insert_abstract_role.py,sha256=C1PZilpYTC1xUfdujAarNXo3oYXbToLdQB4wCpWQrsg,5454
+inventory_conditionals.py,sha256=vLWEDTj9MbqUnA_iw4g-HEVX47fSG8tfd4KpSJKg6kA,1416
+replace_link_attributes.py,sha256=Cpc4E-j9j-4_y0LOstAKYOPl02Ln_2bGNIeqp3ZVCdA,7624
+validate_links.py,sha256=lWuK8sgfiFdfcUdSVAt_5U9JHVde_oa6peSUlBQtsac,6145
+callout_lib/__init__.py,sha256=8B82N_z4D1LaZVYgd5jZR53QAabtgPzADOyGlnvihj0,665
+callout_lib/converter_bullets.py,sha256=nfH0hz4p8qNM2F-MhtBjwH-lUYcNf2m1sdJebRlCxoo,4405
+callout_lib/converter_comments.py,sha256=do0dH8uOyNFpn5CDEzR0jYYCMIPP3oPFM8cEB-Fp22c,9767
+callout_lib/converter_deflist.py,sha256=Ocr3gutTo_Sl_MkzethZH1UO6mCDEcuExGMZF5MfZFg,6131
+callout_lib/detector.py,sha256=S0vZDa4zhTSn6Kv0hWfG56W-5srGxUc-nvpLe_gIx-A,15971
+callout_lib/table_parser.py,sha256=ZucisADE8RDAk5HtIrttaPgBi6Hf8ZUpw7KzfbcmEjc,31450
+doc_utils/__init__.py,sha256=qqZR3lohzkP63soymrEZPBGzzk6-nFzi4_tSffjmu_0,74
+doc_utils/convert_freemarker_to_asciidoc.py,sha256=UGQ7iS_9bkVdDMAWBORXbK0Q5mLPmDs1cDJqoR4LLH8,22491
+doc_utils/duplicate_content.py,sha256=rFrIuiDE5CqWQyL7wTLL-GlrGVDNs1fsq36eQIsCMug,14580
+doc_utils/duplicate_includes.py,sha256=8hpL7fq_pHcKMS0C50LTwTyzqth39nMQ9Lz67gie8b0,10654
+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=RL2WU_dG_UfGL01LnevcyJfKsvYy_ogNyeoVX-Fyqks,13579
+doc_utils/insert_abstract_role.py,sha256=z_Pm8A3EE03DU2fBReJDwMfIUT1qRbDcOKw4EI63I90,6641
+doc_utils/inventory_conditionals.py,sha256=PSrdmeBHbpayvXgaRryqvjUlLZYryPgU9js8IBYqB7g,5486
+doc_utils/missing_source_directive.py,sha256=X3Acn0QJTk6XjmBXhGus5JAjlIitCiicCRE3fslifyw,8048
+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=LPQWPGEOizXECxepk7E_5cjTVvKn6RXQYTWG97Ps5VQ,9077
+doc_utils/unused_attributes.py,sha256=2UmqdXd5ogaPtj9_teApM0IlkdCmzBZNRh7XXrVYJOk,9032
+doc_utils/unused_images.py,sha256=hL8Qrik9QCkVh54eBLuNczRS9tMnsqIEfavNamM1UeQ,5664
+doc_utils/validate_links.py,sha256=iBGXnwdeLlgIT3fo3v01ApT5k0X2FtctsvkrE6E3VMk,19610
+doc_utils/version.py,sha256=6M2GqXp9MDStl7sAFi0I6plYG3mZnB2F3aR5fYWcdNI,203
+doc_utils/version_check.py,sha256=-31Y6AN0KGi_CUCAVOOhf6bPO3r7SQIXPxxeffLAF0w,7535
+doc_utils/warnings_report.py,sha256=20yfwqBjOprfFhQwCujbcsvjJCbHHhmH84uAujm-y-o,8877
+rolfedh_doc_utils-0.1.41.dist-info/licenses/LICENSE,sha256=vLxtwMVOJA_hEy8b77niTkdmQI9kNJskXHq0dBS36e0,1075
+rolfedh_doc_utils-0.1.41.dist-info/METADATA,sha256=TFcXE1pz0bqxhUSvIN20DJzYn4bS9Ix-HLw1b38cdUk,8654
+rolfedh_doc_utils-0.1.41.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+rolfedh_doc_utils-0.1.41.dist-info/entry_points.txt,sha256=VbjA2E5PzSdELQ59Gutdj2C7ZXVhTypTzc1LyTdepis,1023
+rolfedh_doc_utils-0.1.41.dist-info/top_level.txt,sha256=5ajEGX1siKKjC1cahR-_X-XKMsH8BdY9RPaH8vdSHB8,460
+rolfedh_doc_utils-0.1.41.dist-info/RECORD,,

{rolfedh_doc_utils-0.1.4.dist-info → rolfedh_doc_utils-0.1.41.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

rolfedh_doc_utils-0.1.41.dist-info/entry_points.txt

@@ -0,0 +1,20 @@
+[console_scripts]
+archive-unused-files = archive_unused_files:main
+archive-unused-images = archive_unused_images:main
+check-published-links = check_published_links:main
+check-scannability = check_scannability:main
+check-source-directives = check_source_directives:main
+convert-callouts-interactive = convert_callouts_interactive:main
+convert-callouts-to-deflist = convert_callouts_to_deflist:main
+convert-freemarker-to-asciidoc = convert_freemarker_to_asciidoc:main
+convert-tables-to-deflists = convert_tables_to_deflists:main
+doc-utils = doc_utils_cli:main
+extract-link-attributes = extract_link_attributes:main
+find-duplicate-content = find_duplicate_content:main
+find-duplicate-includes = find_duplicate_includes:main
+find-unused-attributes = find_unused_attributes:main
+format-asciidoc-spacing = format_asciidoc_spacing:main
+insert-abstract-role = insert_abstract_role:main
+inventory-conditionals = inventory_conditionals:main
+replace-link-attributes = replace_link_attributes:main
+validate-links = validate_links:main

rolfedh_doc_utils-0.1.41.dist-info/top_level.txt

@@ -0,0 +1,21 @@
+archive_unused_files
+archive_unused_images
+callout_lib
+check_published_links
+check_scannability
+check_source_directives
+convert_callouts_interactive
+convert_callouts_to_deflist
+convert_freemarker_to_asciidoc
+convert_tables_to_deflists
+doc_utils
+doc_utils_cli
+extract_link_attributes
+find_duplicate_content
+find_duplicate_includes
+find_unused_attributes
+format_asciidoc_spacing
+insert_abstract_role
+inventory_conditionals
+replace_link_attributes
+validate_links

validate_links.py

@@ -0,0 +1,213 @@
+#!/usr/bin/env python3
+"""
+Validate links in AsciiDoc documentation.
+
+This tool checks all links in AsciiDoc files for validity, including:
+- External HTTP/HTTPS links
+- Internal cross-references (xref)
+- Image paths
+"""
+
+import argparse
+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
+
+
+def main():
+    # Check for updates (non-blocking, won't interfere with tool operation)
+    check_version_on_startup()
+    """Main entry point for the validate-links CLI tool."""
+    parser = argparse.ArgumentParser(
+        description='Validate links in AsciiDoc documentation',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  # Basic validation
+  validate-links
+
+  # Validate against preview environment
+  validate-links --transpose "https://docs.redhat.com--https://preview.docs.redhat.com"
+
+  # Multiple transpositions
+  validate-links \\
+    --transpose "https://docs.redhat.com--https://preview.docs.redhat.com" \\
+    --transpose "https://access.redhat.com--https://stage.access.redhat.com"
+
+  # With specific options
+  validate-links \\
+    --transpose "https://docs.example.com--https://preview.example.com" \\
+    --attributes-file common-attributes.adoc \\
+    --timeout 15 \\
+    --retry 3 \\
+    --parallel 20 \\
+    --exclude-domain localhost \\
+    --exclude-domain example.com
+
+  # Export results to JSON
+  validate-links --output report.json --format json
+        """
+    )
+
+    parser.add_argument(
+        '--transpose',
+        action='append',
+        help='Transpose URLs from production to preview/staging (format: from_url--to_url)'
+    )
+
+    parser.add_argument(
+        '--attributes-file',
+        help='Path to the AsciiDoc attributes file'
+    )
+
+    parser.add_argument(
+        '--scan-dir',
+        action='append',
+        help='Directory to scan for .adoc files (can be used multiple times, default: current directory)'
+    )
+
+    parser.add_argument(
+        '--timeout',
+        type=int,
+        default=10,
+        help='Timeout in seconds for each URL check (default: 10)'
+    )
+
+    parser.add_argument(
+        '--retry',
+        type=int,
+        default=3,
+        help='Number of retries for failed URLs (default: 3)'
+    )
+
+    parser.add_argument(
+        '--parallel',
+        type=int,
+        default=10,
+        help='Number of parallel URL checks (default: 10)'
+    )
+
+    parser.add_argument(
+        '--cache-duration',
+        type=int,
+        default=3600,
+        help='Cache duration in seconds (default: 3600)'
+    )
+
+    parser.add_argument(
+        '--exclude-domain',
+        action='append',
+        dest='exclude_domains',
+        help='Domain to exclude from validation (can be used multiple times)'
+    )
+
+    parser.add_argument(
+        '--no-cache',
+        action='store_true',
+        help='Disable caching of validation results'
+    )
+
+    parser.add_argument(
+        '--output',
+        help='Output file for results'
+    )
+
+    parser.add_argument(
+        '--format',
+        choices=['text', 'json', 'junit'],
+        default='text',
+        help='Output format (default: text)'
+    )
+
+    parser.add_argument(
+        '-v', '--verbose',
+        action='store_true',
+        help='Show verbose output including warnings'
+    )
+
+    parser.add_argument(
+        '--fail-on-broken',
+        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()
+
+    # Parse transpositions
+    transpositions = parse_transpositions(args.transpose)
+
+    # Show configuration
+    print("Validating links in documentation...")
+    if args.attributes_file:
+        print(f"Loading attributes from {args.attributes_file}")
+    if transpositions:
+        print("\nURL Transposition Rules:")
+        for from_url, to_url in transpositions:
+            print(f"  {from_url} → {to_url}")
+        print()
+
+    # Create validator
+    validator = LinkValidator(
+        timeout=args.timeout,
+        retry=args.retry,
+        parallel=args.parallel,
+        cache_duration=args.cache_duration if not args.no_cache else 0,
+        transpositions=transpositions
+    )
+
+    try:
+        # Run validation
+        spinner = Spinner("Validating links")
+        spinner.start()
+        results = validator.validate_all(
+            scan_dirs=args.scan_dir,
+            attributes_file=args.attributes_file,
+            exclude_domains=args.exclude_domains
+        )
+        total = results['summary']['total']
+        valid = results['summary']['valid']
+        spinner.stop(f"Validated {total} links: {valid} valid")
+
+        # Format output
+        if args.format == 'json':
+            output = json.dumps(results, indent=2)
+        elif args.format == 'junit':
+            # TODO: Implement JUnit XML format
+            output = format_results(results, verbose=args.verbose)
+        else:
+            output = format_results(results, verbose=args.verbose)
+
+        # Save or print output
+        if args.output:
+            with open(args.output, 'w', encoding='utf-8') as f:
+                f.write(output)
+            print(f"Results saved to {args.output}")
+            # Still print summary to console
+            if args.format != 'text':
+                summary = results['summary']
+                print(f"\nSummary: {summary['valid']} valid, {summary['broken']} broken, "
+                      f"{summary['warnings']} warnings")
+        else:
+            print(output)
+
+        # Exit code
+        if args.fail_on_broken and results['summary']['broken'] > 0:
+            sys.exit(1)
+
+    except KeyboardInterrupt:
+        print("\nValidation cancelled.")
+        sys.exit(1)
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        if args.verbose:
+            import traceback
+            traceback.print_exc()
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()