python-code-validator 0.2.1__py3-none-any.whl → 0.3.0__py3-none-any.whl

code_validator/__init__.py

@@ -54,4 +54,4 @@ __all__ = [
     "RuleParsingError",
 ]
 
-__version__ = "0.2.1"
+__version__ = "0.3.0"

code_validator/cli.py

@@ -43,13 +43,22 @@ def setup_arg_parser() -> argparse.ArgumentParser:
         "--log",
         type=LogLevel,
         default=LogLevel.ERROR,
-        help=("Set the logging level for stderr (TRACE, DEBUG, INFO, WARNING, ERROR, CRITICAL). Default: ERROR."),
+        help="Set the logging level for stderr (TRACE, DEBUG, INFO, WARNING, ERROR, CRITICAL). Default: ERROR.",
     )
     parser.add_argument(
         "--quiet", action="store_true", help="Suppress all stdout output (validation errors and final verdict)."
     )
     parser.add_argument("--no-verdict", action="store_true", help="Suppress stdout output verdict, show failed rules.")
-    parser.add_argument("--stop-on-first-fail", action="store_true", help="Stop after the first failed rule.")
+    parser.add_argument(
+        "--max-messages",
+        type=int,
+        default=0,
+        metavar="N",
+        help="Maximum number of error messages to display. 0 for no limit. Default: 0.",
+    )
+    parser.add_argument(
+        "-x", "--exit-on-first-error", action="store_true", help="Exit instantly on the first error found."
+    )
     parser.add_argument("--version", "-v", action="version", version=f"%(prog)s {__version__}")
     return parser
 
@@ -79,7 +88,8 @@ def run_from_cli() -> None:
         rules_path=args.rules_path,
         log_level=args.log,
         is_quiet=args.quiet,
-        stop_on_first_fail=args.stop_on_first_fail,
+        exit_on_first_error=args.exit_on_first_error,
+        max_messages=args.max_messages,
     )
     console.print(f"Config is: {config}", level=LogLevel.TRACE)
 
@@ -95,18 +105,24 @@ def run_from_cli() -> None:
             console.print("Validation successful.", level=LogLevel.INFO, is_verdict=True)
             sys.exit(ExitCode.SUCCESS)
         else:
-            console.print("Validation failed.", level=LogLevel.INFO, is_verdict=True)
+            console.print("Validation failed.", level=LogLevel.WARNING, is_verdict=True)
             sys.exit(ExitCode.VALIDATION_FAILED)
 
     except CodeValidatorError as e:
-        console.print("Error: Internal Error of validator!", level=LogLevel.CRITICAL)
-        logger.exception(f"Traceback for CodeValidatorError: {e}")
+        console.print(
+            f"Error: An internal validator error occurred: {e}", level=LogLevel.CRITICAL, show_user=True, exc_info=True
+        )
         sys.exit(ExitCode.VALIDATION_FAILED)
     except FileNotFoundError as e:
-        console.print(f"Error: File not found - {e.filename}!", level=LogLevel.CRITICAL)
-        logger.exception(f"Traceback for FileNotFoundError: {e}")
+        console.print(
+            f"Error: Input file not found: {e.filename}", level=LogLevel.CRITICAL, show_user=True, exc_info=True
+        )
         sys.exit(ExitCode.FILE_NOT_FOUND)
     except Exception as e:
-        console.print(f"An unexpected error occurred: {e.__class__.__name__}!", level=LogLevel.CRITICAL)
-        logger.exception(f"Traceback for unexpected error: {e}")
+        console.print(
+            f"Error: An unexpected error occurred: {e.__class__.__name__}. See logs for detailed traceback.",
+            level=LogLevel.CRITICAL,
+            show_user=True,
+            exc_info=True,
+        )
         sys.exit(ExitCode.UNEXPECTED_ERROR)

code_validator/config.py

@@ -42,14 +42,16 @@ class AppConfig:
         rules_path: The file path to the JSON rules file.
         log_level: The minimum logging level for console output.
         is_quiet: If True, suppresses all non-log output to stdout.
-        stop_on_first_fail: If True, halts validation after the first failed rule.
+        exit_on_first_error: If True, halts validation after the first failed rule.
+        max_messages: Maximum number of error messages to display. 0 for no limit. Default: 0.
     """
 
     solution_path: Path
     rules_path: Path
     log_level: LogLevel
     is_quiet: bool
-    stop_on_first_fail: bool
+    exit_on_first_error: bool
+    max_messages: int = 0
 
 
 @dataclass(frozen=True)

code_validator/core.py

@@ -64,7 +64,7 @@ class StaticValidator:
         _source_code (str): The raw text content of the Python file being validated.
         _ast_tree (ast.Module | None): The Abstract Syntax Tree of the source code.
         _rules (list[Rule]): A list of initialized, executable rule objects.
-        _failed_rules (list[int]): A list of rule IDs that failed during the run.
+        _failed_rules (list[Rule]): A list of rules that contained IDs of failed checks during the run.
     """
 
     @log_initialization(level=LogLevel.DEBUG)
@@ -83,10 +83,10 @@ class StaticValidator:
         self._source_code: str = ""
         self._ast_tree: ast.Module | None = None
         self._rules: list[Rule] = []
-        self._failed_rules: list[int] = []
+        self._failed_rules: list[Rule] = []
 
     @property
-    def failed_rules_id(self) -> list[int]:
+    def failed_rules_id(self) -> list[Rule]:
         """list[int]: A list of rule IDs that failed during the last run."""
         return self._failed_rules
 
@@ -161,11 +161,54 @@ class StaticValidator:
                 if getattr(rule.config, "type", None) == "check_syntax":
                     self._console.print(rule.config.message, level=LogLevel.ERROR, show_user=True)
                     self._console.print(f"Failed rule id: {rule.config.rule_id}", level=LogLevel.DEBUG)
-                    self._failed_rules.append(rule.config.rule_id)
+                    self._failed_rules.append(rule)
                     return False
             self._console.print(f"Syntax Error found: {e}", level=LogLevel.ERROR)
             return False
 
+    def _report_errors(self) -> None:
+        """Formats and prints collected validation errors to the console.
+
+        This method is responsible for presenting the final list of failed
+        rules to the user. It respects the `--max-messages` configuration
+        to avoid cluttering the terminal. If the number of found errors
+        exceeds the specified limit, it truncates the output and displays
+        a summary message indicating how many more errors were found.
+
+        The method retrieves the list of failed rules from `self._failed_rules`
+        and the display limit from `self._config`. All user-facing output is
+        channeled through the `self._console` object.
+
+        It performs the following steps:
+          1. Checks if any errors were recorded. If not, it returns immediately.
+          2. Determines the subset of errors to display based on the configured
+             `max_messages` limit (a value of 0 means no limit).
+          3. Iterates through the selected error rules and prints their
+             failure messages.
+          4. If the error list was truncated, prints a summary line, e.g.,
+             "... (5 more errors found)".
+        """
+        max_errors = self._config.max_messages
+        num_errors = len(self._failed_rules)
+
+        if num_errors == 0:
+            return None
+
+        errors_to_show = self._failed_rules
+        if 0 < max_errors < num_errors:
+            errors_to_show = self._failed_rules[:max_errors]
+
+        for rule in errors_to_show:
+            self._console.print(rule.config.message, level=LogLevel.WARNING, show_user=True)
+
+        if 0 < max_errors < num_errors:
+            remaining_count = num_errors - max_errors
+            self._console.print(
+                f"... ({remaining_count} more error{'s' if remaining_count > 1 else ''} found)",
+                level=LogLevel.WARNING,
+                show_user=True,
+            )
+
     def run(self) -> bool:
         """Runs the entire validation process from start to finish.
 
@@ -184,6 +227,7 @@ class StaticValidator:
             self._load_and_parse_rules()
 
             if not self._parse_ast_tree():
+                self._report_errors()
                 return False
 
             self._console.print("Lead source code, load and parse rules and parsing code - PASS", level=LogLevel.DEBUG)
@@ -211,13 +255,18 @@ class StaticValidator:
             )
             is_passed = rule.execute(self._ast_tree, self._source_code)
             if not is_passed:
-                self._console.print(rule.config.message, level=LogLevel.WARNING, show_user=True)
+                self._failed_rules.append(rule)
+                # self._console.print(rule.config.message, level=LogLevel.WARNING, show_user=True)
                 self._console.print(f"Rule {rule.config.rule_id} - FAIL", level=LogLevel.INFO)
-                self._failed_rules.append(rule.config.rule_id)
-                if getattr(rule.config, "is_critical", False) or self._config.stop_on_first_fail:
+                if getattr(rule.config, "is_critical", False):
                     self._console.print("Critical rule failed. Halting validation.", level=LogLevel.WARNING)
                     break
+                elif self._config.exit_on_first_error:
+                    self._console.print("Exiting on first error.", level=LogLevel.INFO)
+                    break
             else:
                 self._console.print(f"Rule {rule.config.rule_id} - PASS", level=LogLevel.INFO)
 
+        self._report_errors()
+
         return not self._failed_rules

code_validator/output.py

@@ -210,6 +210,7 @@ class Console:
         level: LogLevel | Literal["TRACE", "DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"] = LogLevel.TRACE,
         is_verdict: bool = False,
         show_user: bool = False,
+        exc_info: bool = False,
     ) -> None:
         """Prints a message to stdout and logs it simultaneously.
 
@@ -228,9 +229,10 @@ class Console:
             show_user:  If True and `is_verdict=False`, allows
                         printing non-verdict messages to stdout. Defaults to
                         False.
+            exc_info:   If True this work as loggings.exception("<message>").
         """
         level_num = logging.getLevelName(level if isinstance(level, LogLevel) else level)
-        self._logger.log(level_num, message, stacklevel=2)
+        self._logger.log(level_num, message, stacklevel=2, exc_info=exc_info)
 
         if (not self._is_quiet) and ((not is_verdict and show_user) or (is_verdict and self._show_verdict)):
             print(message, file=self._stdout)

{python_code_validator-0.2.1.dist-info → python_code_validator-0.3.0.dist-info}/METADATA

@@ -1,9 +1,30 @@
 Metadata-Version: 2.4
 Name: python-code-validator
-Version: 0.2.1
+Version: 0.3.0
 Summary: A flexible, AST-based framework for static validation of Python code using declarative JSON rules.
 Author-email: Qu1nel <covach.qn@gmail.com>
-License-Expression: MIT
+License: MIT License
+        
+        Copyright (c) 2025 Ivan Kovach
+        
+        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.
+        
 Project-URL: Homepage, https://github.com/Qu1nel/PythonCodeValidator
 Project-URL: Documentation, https://pythoncodevalidator.readthedocs.io/en/latest/
 Project-URL: Bug Tracker, https://github.com/Qu1nel/PythonCodeValidator/issues
@@ -14,6 +35,7 @@ Classifier: Intended Audience :: Education
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Software Development :: Testing

{python_code_validator-0.2.1.dist-info → python_code_validator-0.3.0.dist-info}/RECORD

@@ -1,10 +1,10 @@
-code_validator/__init__.py,sha256=uag-AMj0a1I953aW7JLcxS6q0f_rueJWvO3AmGOWgUI,1721
+code_validator/__init__.py,sha256=_C8AEkBsAbgA7PJ58v_K_2vuCXl_XtRrk_oMp6UEEvI,1721
 code_validator/__main__.py,sha256=Z41EoJqX03AI11gnku_Iwt6rP8SPUkYuxwN7P51qgLc,600
-code_validator/cli.py,sha256=-8pl9iv1ufRWiRKrY0vtk3ncZu6tFj6ZrKa0F-ruuZ4,4826
-code_validator/config.py,sha256=ELi19GC1YeLEZZbm49FO8a1URLBrZxAuOGkrHTK8FvE,5071
-code_validator/core.py,sha256=HyXXxECxsAgiXOl9tMZVqg0Xptx7nA-64IDVv_W4Svo,10117
+code_validator/cli.py,sha256=f0B9Pmnj0oKuknhxo0seqbdgEedW8lA-WJuVujLZ9m0,5173
+code_validator/config.py,sha256=h9bCeVc_gFMKDWWrexmIytuAivBednwBc7sO4c_Axrs,5196
+code_validator/core.py,sha256=3w5Zi_2jyl4vl8IEN4Yekelqn8pi9Bv2VVego6SUGrw,12288
 code_validator/exceptions.py,sha256=XkiRNQ25FWJkjS2wBaUaKQcEL5WF9tN_HSV3tqJwDcE,1627
-code_validator/output.py,sha256=Saydp1D6JRIzHroK12K38lnoMZCJaIEDyPD1ZXgJFGA,9137
+code_validator/output.py,sha256=wpr24W8m-viS5--RB9Z8dCxFEYlYxGaiwJ7pRMW4BWw,9268
 code_validator/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 code_validator/components/ast_utils.py,sha256=v0N3F58oxNMg7bUY6-8x0AeoLsxrzrp_bLTGNVr5EMU,1589
 code_validator/components/definitions.py,sha256=9WEXQ_i-S4Vega6HqOdjreZE_1cgJPC7guZodTKtzhc,3208
@@ -14,9 +14,9 @@ code_validator/rules_library/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NM
 code_validator/rules_library/basic_rules.py,sha256=RGlHEDnd0Cn72ofbE8Y7wAl9h7iZR8reR80v2oiICTo,7118
 code_validator/rules_library/constraint_logic.py,sha256=-gN6GaIZvPfHqiLCzH5Jwuz6DcPaQKlepbMo2r5V2Yc,11026
 code_validator/rules_library/selector_nodes.py,sha256=wCAnQRSdEB8HM8avTy1wkJzyb6v2EQgHIPASXruiqbc,14733
-python_code_validator-0.2.1.dist-info/licenses/LICENSE,sha256=Lq69RwIO4Dge7OsjgAamJfYSDq2DWI2yzVYI1VX1s6c,1089
-python_code_validator-0.2.1.dist-info/METADATA,sha256=EKuyRnPMen6M3C5YgSWHXmI1BjOyTP_-ttXgIfZDGKc,10794
-python_code_validator-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-python_code_validator-0.2.1.dist-info/entry_points.txt,sha256=pw_HijiZyPxokVJHStTkGCwheTjukDomdk81JyHzv74,66
-python_code_validator-0.2.1.dist-info/top_level.txt,sha256=yowMDfABI5oqgW3hhTdec_7UHGeprkvc2BnqRzNbI5w,15
-python_code_validator-0.2.1.dist-info/RECORD,,
+python_code_validator-0.3.0.dist-info/licenses/LICENSE,sha256=Lq69RwIO4Dge7OsjgAamJfYSDq2DWI2yzVYI1VX1s6c,1089
+python_code_validator-0.3.0.dist-info/METADATA,sha256=rysi7-B63cRuzDUgE_bltaF06CDHBcdYDddB3isxNs4,12089
+python_code_validator-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+python_code_validator-0.3.0.dist-info/entry_points.txt,sha256=pw_HijiZyPxokVJHStTkGCwheTjukDomdk81JyHzv74,66
+python_code_validator-0.3.0.dist-info/top_level.txt,sha256=yowMDfABI5oqgW3hhTdec_7UHGeprkvc2BnqRzNbI5w,15
+python_code_validator-0.3.0.dist-info/RECORD,,