python-code-validator 0.2.1__tar.gz → 0.3.0__tar.gz

{python_code_validator-0.2.1/src/python_code_validator.egg-info → python_code_validator-0.3.0}/PKG-INFO

@@ -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 → python_code_validator-0.3.0}/pyproject.toml

@@ -10,14 +10,13 @@ build-backend = "setuptools.build_meta"
 # ==============================================================================
 [project]
 name = "python-code-validator"
-version = "0.2.1"
+version = "0.3.0"
 description = "A flexible, AST-based framework for static validation of Python code using declarative JSON rules."
 keywords = ["validation", "linter", "static analysis", "testing", "education", "ast"]
 authors = [{ name = "Qu1nel", email = "covach.qn@gmail.com" }]
 readme = "README.md"
 requires-python = ">=3.11"
-license-files = ["LICEN[CS]E*"]
-license = "MIT"
+license = { file = "LICENSE" }
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
@@ -25,6 +24,7 @@ classifiers = [
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Topic :: Software Development :: Quality Assurance",
     "Topic :: Software Development :: Testing",

{python_code_validator-0.2.1 → python_code_validator-0.3.0}/src/code_validator/__init__.py

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

{python_code_validator-0.2.1 → python_code_validator-0.3.0}/src/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)

{python_code_validator-0.2.1 → python_code_validator-0.3.0}/src/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)

{python_code_validator-0.2.1 → python_code_validator-0.3.0}/src/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

{python_code_validator-0.2.1 → python_code_validator-0.3.0}/src/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 → python_code_validator-0.3.0/src/python_code_validator.egg-info}/PKG-INFO

@@ -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 → python_code_validator-0.3.0}/tests/test_validator.py

@@ -24,7 +24,7 @@ class TestStaticValidatorIntegration(unittest.TestCase):
             rules_path=FIXTURES_DIR / rules_file,
             log_level=LogLevel.CRITICAL,
             is_quiet=True,
-            stop_on_first_fail=False,
+            exit_on_first_error=False,
         )
         validator = StaticValidator(config, self.console)
         return validator.run()
@@ -81,7 +81,7 @@ class TestStaticValidatorIntegration(unittest.TestCase):
             rules_path=rules_path,
             log_level=LogLevel.CRITICAL,
             is_quiet=True,
-            stop_on_first_fail=False,
+            exit_on_first_error=False,
         )
         validator = StaticValidator(config, self.console)
 
@@ -133,7 +133,7 @@ class TestStaticValidatorIntegration(unittest.TestCase):
 
         self.assertFalse(result)
 
-    def test_stop_on_first_fail_works(self):
+    def test_exit_on_first_error_works(self):
         """Tests that the validator stops after the first failure if flag is set."""
         rules = {
             "validation_rules": [
@@ -165,7 +165,7 @@ class TestStaticValidatorIntegration(unittest.TestCase):
             rules_path=rules_path,
             log_level=LogLevel.CRITICAL,
             is_quiet=True,
-            stop_on_first_fail=True,
+            exit_on_first_error=True,
         )
         validator = StaticValidator(config, self.console)
         validator.run()
@@ -173,7 +173,8 @@ class TestStaticValidatorIntegration(unittest.TestCase):
 
         # Проверяем, что провалилось только одно правило, а не два
         self.assertEqual(len(validator.failed_rules_id), 1)
-        self.assertEqual(validator.failed_rules_id[0], 1)
+        # noinspection PyTypeChecker
+        self.assertEqual(validator.failed_rules_id[0].config.rule_id, 1)
 
     def test_unknown_rule_type_raises_error(self):
         """Tests that an unknown rule type in JSON raises RuleParsingError."""
@@ -256,7 +257,7 @@ class TestValidatorRobustness(unittest.TestCase):
             rules_path=FIXTURES_DIR / rules_file,
             log_level=LogLevel.CRITICAL,
             is_quiet=True,
-            stop_on_first_fail=False,
+            exit_on_first_error=False,
         )
         validator = StaticValidator(config, self.console)
         return validator.run()
@@ -273,7 +274,7 @@ class TestValidatorRobustness(unittest.TestCase):
             rules_path=self.valid_rules_path,
             log_level=LogLevel.CRITICAL,
             is_quiet=True,
-            stop_on_first_fail=False,
+            exit_on_first_error=False,
         )
         # Ожидаем, что проверка провалится (т.к. в пустом файле нет нужных функций),
         # но сама программа не упадет с ошибкой.
@@ -287,7 +288,7 @@ class TestValidatorRobustness(unittest.TestCase):
             rules_path=self.valid_rules_path,
             log_level=LogLevel.CRITICAL,
             is_quiet=True,
-            stop_on_first_fail=False,
+            exit_on_first_error=False,
         )
         # Проверяем, что вызов .run() вызывает именно FileNotFoundError
         with self.assertRaises(FileNotFoundError):
@@ -301,7 +302,7 @@ class TestValidatorRobustness(unittest.TestCase):
             rules_path=FIXTURES_DIR / "malformed.json",
             log_level=LogLevel.CRITICAL,
             is_quiet=True,
-            stop_on_first_fail=False,
+            exit_on_first_error=False,
         )
         with self.assertRaises(RuleParsingError):
             validator = StaticValidator(config, self.console)
@@ -328,6 +329,7 @@ class TestValidatorRobustness(unittest.TestCase):
         }
         rules_path = FIXTURES_DIR / "temp_arcade_rules.json"
         with open(rules_path, "w", encoding="utf-8") as f:
+            # noinspection PyTypeChecker
             json.dump(arcade_rules, f)
 
         result = self.run_validator("p09_arcade_app.py", str(rules_path))