rolfedh-doc-utils 0.1.31__tar.gz → 0.1.33__tar.gz

{rolfedh_doc_utils-0.1.31 → rolfedh_doc_utils-0.1.33}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rolfedh-doc-utils
-Version: 0.1.31
+Version: 0.1.33
 Summary: CLI tools for AsciiDoc documentation projects
 Author: Rolfe Dlugy-Hegwer
 License: MIT License

{rolfedh_doc_utils-0.1.31 → rolfedh_doc_utils-0.1.33}/callout_lib/converter_deflist.py

@@ -48,22 +48,29 @@ class DefListConverter:
             code_line = group.code_line
             callout_nums = group.callout_numbers
 
-            # Check if this is a user-replaceable value (contains angle brackets but not heredoc)
-            # User values are single words/phrases in angle brackets like <my-value>
-            user_values = DefListConverter.USER_VALUE_PATTERN.findall(code_line)
-
-            if user_values and len(user_values) == 1 and len(code_line) < 100:
-                # This looks like a user-replaceable value placeholder
-                # Format the value (ensure it has angle brackets)
-                user_value = user_values[0]
-                if not user_value.startswith('<'):
-                    user_value = f'<{user_value}>'
-                if not user_value.endswith('>'):
-                    user_value = f'{user_value}>'
-                term = f'`{user_value}`'
-            else:
-                # This is a code line - strip whitespace before wrapping in backticks
-                term = f'`{code_line.strip()}`'
+            # COMMENTED OUT: User-replaceable value detection causes false positives
+            # with Java generics (e.g., <MyEntity, Integer>) and other valid syntax
+            # that uses angle brackets. Always use the full code line as the term.
+            #
+            # # Check if this is a user-replaceable value (contains angle brackets but not heredoc)
+            # # User values are single words/phrases in angle brackets like <my-value>
+            # user_values = DefListConverter.USER_VALUE_PATTERN.findall(code_line)
+            #
+            # if user_values and len(user_values) == 1 and len(code_line) < 100:
+            #     # This looks like a user-replaceable value placeholder
+            #     # Format the value (ensure it has angle brackets)
+            #     user_value = user_values[0]
+            #     if not user_value.startswith('<'):
+            #         user_value = f'<{user_value}>'
+            #     if not user_value.endswith('>'):
+            #         user_value = f'{user_value}>'
+            #     term = f'`{user_value}`'
+            # else:
+            #     # This is a code line - strip whitespace before wrapping in backticks
+            #     term = f'`{code_line.strip()}`'
+
+            # Always use the full code line - strip whitespace before wrapping in backticks
+            term = f'`{code_line.strip()}`'
 
             # Add blank line before each term
             lines.append('')

{rolfedh_doc_utils-0.1.31 → rolfedh_doc_utils-0.1.33}/callout_lib/detector.py

@@ -46,9 +46,10 @@ class CalloutDetector:
     CALLOUT_IN_CODE = re.compile(r'<(\d+)>')
 
     # Pattern for callout with optional preceding comment syntax
-    # Matches common comment styles: //, #, --, ;, followed by optional whitespace and <number>
-    # The comment syntax must be preceded by whitespace to avoid matching code operators
-    CALLOUT_WITH_COMMENT = re.compile(r'\s*(?://|#|--|;)\s*<\d+>|\s*<\d+>')
+    # Matches common comment styles: //, #, --, followed by optional whitespace and <number>
+    # Note: Semicolon (;) removed because it's a statement terminator in Java/C/C++/JavaScript
+    # and causes false positives (e.g., "name; <1>" would incorrectly remove the semicolon)
+    CALLOUT_WITH_COMMENT = re.compile(r'\s*(?://|#|--)\s*<\d+>|\s*<\d+>')
 
     # Pattern for callout explanation line: <1> Explanation text
     CALLOUT_EXPLANATION = re.compile(r'^<(\d+)>\s+(.+)$')
@@ -141,16 +142,23 @@ class CalloutDetector:
                 # Use CALLOUT_WITH_COMMENT to remove both comment syntax and callout
                 line_without_callouts = self.CALLOUT_WITH_COMMENT.sub('', line).rstrip()
 
-                # Find all angle-bracket enclosed values
-                user_values = self.USER_VALUE_PATTERN.findall(line_without_callouts)
-
-                # Determine what to use as the code line term
-                if user_values:
-                    # Use the rightmost (closest to the callout) user value
-                    code_line = user_values[-1]
-                else:
-                    # No angle-bracket value found - use the actual code line
-                    code_line = line_without_callouts
+                # COMMENTED OUT: User-replaceable value detection causes false positives
+                # with Java generics (e.g., <MyEntity, Integer>) and other valid syntax
+                # that uses angle brackets. Always use the full code line.
+                #
+                # # Find all angle-bracket enclosed values
+                # user_values = self.USER_VALUE_PATTERN.findall(line_without_callouts)
+                #
+                # # Determine what to use as the code line term
+                # if user_values:
+                #     # Use the rightmost (closest to the callout) user value
+                #     code_line = user_values[-1]
+                # else:
+                #     # No angle-bracket value found - use the actual code line
+                #     code_line = line_without_callouts
+
+                # Always use the full code line
+                code_line = line_without_callouts
 
                 # Collect all callout numbers on this line
                 callout_nums = [int(m.group(1)) for m in callout_matches]

{rolfedh_doc_utils-0.1.31 → rolfedh_doc_utils-0.1.33}/convert_callouts_interactive.py

@@ -20,6 +20,9 @@ from callout_lib import (
     CodeBlock,
 )
 
+# Import version
+from doc_utils.version import __version__
+
 
 # Colors for output
 class Colors:
@@ -124,24 +127,30 @@ class InteractiveCalloutConverter:
         print("  [d] Use Definition list format instead")
         print("  [b] Use Bulleted list format instead")
         print("  [k] Skip this block")
-        print("  [q] Quit")
+        print("  [q] Skip current file")
+        print("  [Q] Quit script entirely (Ctrl+C)")
 
         while True:
             try:
-                choice = input("\nYour choice [s/d/b/k/q]: ").strip().lower()
-
-                if choice in ['q', 'quit', 'exit']:
+                choice = input("\nYour choice [s/d/b/k/q/Q]: ").strip()
+
+                if choice in ['Q', 'QUIT', 'EXIT']:
+                    # Quit script entirely
+                    print_colored("\nQuitting script...", Colors.YELLOW)
+                    sys.exit(0)
+                elif choice.lower() in ['q', 'quit', 'exit']:
+                    # Skip current file
                     return None
-                elif choice in ['s', 'shorten', 'short']:
+                elif choice.lower() in ['s', 'shorten', 'short']:
                     return 'shorten'
-                elif choice in ['d', 'deflist']:
+                elif choice.lower() in ['d', 'deflist']:
                     return 'deflist'
-                elif choice in ['b', 'bullets', 'bullet']:
+                elif choice.lower() in ['b', 'bullets', 'bullet']:
                     return 'bullets'
-                elif choice in ['k', 'skip']:
+                elif choice.lower() in ['k', 'skip']:
                     return 'skip'
                 else:
-                    print_colored("Invalid choice. Please enter s, d, b, k, or q.", Colors.RED)
+                    print_colored("Invalid choice. Please enter s, d, b, k, q, or Q.", Colors.RED)
 
             except (KeyboardInterrupt, EOFError):
                 print()
@@ -165,23 +174,29 @@ class InteractiveCalloutConverter:
         print("  [c] Inline comments")
         print("  [s] Skip this block")
         print("  [a] Apply choice to All remaining blocks")
-        print("  [q] Quit")
+        print("  [q] Skip current file")
+        print("  [Q] Quit script entirely (Ctrl+C)")
 
         while True:
             try:
-                choice = input("\nYour choice [d/b/c/s/a/q]: ").strip().lower()
-
-                if choice in ['q', 'quit', 'exit']:
+                choice = input("\nYour choice [d/b/c/s/a/q/Q]: ").strip()
+
+                if choice in ['Q', 'QUIT', 'EXIT']:
+                    # Quit script entirely
+                    print_colored("\nQuitting script...", Colors.YELLOW)
+                    sys.exit(0)
+                elif choice.lower() in ['q', 'quit', 'exit']:
+                    # Skip current file
                     return None
-                elif choice in ['s', 'skip']:
+                elif choice.lower() in ['s', 'skip']:
                     return 'skip'
-                elif choice in ['d', 'deflist']:
+                elif choice.lower() in ['d', 'deflist']:
                     return 'deflist'
-                elif choice in ['b', 'bullets', 'bullet']:
+                elif choice.lower() in ['b', 'bullets', 'bullet']:
                     return 'bullets'
-                elif choice in ['c', 'comments', 'comment']:
+                elif choice.lower() in ['c', 'comments', 'comment']:
                     return 'comments'
-                elif choice in ['a', 'all']:
+                elif choice.lower() in ['a', 'all']:
                     # Ask for the format to apply to all
                     print("\nWhat format should be applied to all remaining blocks?")
                     print("  [d] Definition list")
@@ -254,7 +269,7 @@ class InteractiveCalloutConverter:
             choice = self.get_user_choice(idx, total_blocks)
 
             if choice is None:
-                print_colored("\nConversion cancelled by user.", Colors.YELLOW)
+                print_colored("\nSkipping remaining blocks in this file.", Colors.YELLOW)
                 return 0, False
             elif choice == 'skip':
                 print_colored("Skipping this block.\n", Colors.YELLOW)
@@ -276,7 +291,7 @@ class InteractiveCalloutConverter:
                     long_choice = self.get_user_choice_for_long_comments(block, long_warnings)
 
                     if long_choice is None:
-                        print_colored("\nConversion cancelled by user.", Colors.YELLOW)
+                        print_colored("\nSkipping remaining blocks in this file.", Colors.YELLOW)
                         return 0, False
                     elif long_choice == 'skip':
                         print_colored("Skipping this block.\n", Colors.YELLOW)
@@ -444,6 +459,11 @@ Examples:
         """
     )
 
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'%(prog)s {__version__}'
+    )
     parser.add_argument(
         'path',
         nargs='?',
@@ -510,8 +530,8 @@ Examples:
                 total_conversions += conversions
 
         except KeyboardInterrupt:
-            print_colored("\n\nOperation cancelled by user", Colors.YELLOW)
-            break
+            print_colored("\n\nScript interrupted by user (Ctrl+C)", Colors.YELLOW)
+            sys.exit(0)
         except Exception as e:
             print_colored(f"\nUnexpected error processing {file_path}: {e}", Colors.RED)
             import traceback

{rolfedh_doc_utils-0.1.31 → rolfedh_doc_utils-0.1.33}/convert_callouts_to_deflist.py

@@ -25,6 +25,9 @@ from callout_lib import (
 # Import warnings report generator
 from doc_utils.warnings_report import generate_warnings_report
 
+# Import version
+from doc_utils.version import __version__
+
 
 # Colors for output
 class Colors:
@@ -395,6 +398,11 @@ Example transformation (deflist format):
         """
     )
 
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'%(prog)s {__version__}'
+    )
     parser.add_argument(
         'path',
         nargs='?',

{rolfedh_doc_utils-0.1.31 → rolfedh_doc_utils-0.1.33}/doc_utils/version.py

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

{rolfedh_doc_utils-0.1.31 → rolfedh_doc_utils-0.1.33}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rolfedh-doc-utils"
-version = "0.1.31"
+version = "0.1.33"
 description = "CLI tools for AsciiDoc documentation projects"
 readme = "README.md"
 requires-python = ">=3.8"

{rolfedh_doc_utils-0.1.31 → rolfedh_doc_utils-0.1.33}/rolfedh_doc_utils.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rolfedh-doc-utils
-Version: 0.1.31
+Version: 0.1.33
 Summary: CLI tools for AsciiDoc documentation projects
 Author: Rolfe Dlugy-Hegwer
 License: MIT License