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

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

@@ -1,9 +1,30 @@
 Metadata-Version: 2.4
 Name: python-code-validator
-Version: 0.2.1
+Version: 0.4.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.4.0}/pyproject.toml

@@ -10,14 +10,13 @@ build-backend = "setuptools.build_meta"
 # ==============================================================================
 [project]
 name = "python-code-validator"
-version = "0.2.1"
+version = "0.4.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.4.0}/src/code_validator/__init__.py

@@ -1,57 +1,57 @@
-"""A flexible framework for static validation of Python code.
-
-This package provides a comprehensive toolkit for statically analyzing Python
-source code based on a declarative set of rules defined in a JSON format. It
-allows for checking syntax, style, structure, and constraints without
-executing the code.
-
-The primary entry point for using this package programmatically is the
-`StaticValidator` class.
-
-Example:
-    A minimal example of using the validator as a library.
-
-    .. code-block:: python
-
-        from code_validator import StaticValidator, AppConfig, LogLevel
-        from code_validator.output import Console, setup_logging
-        from pathlib import Path
-
-        # Basic setup
-        logger = setup_logging(LogLevel.INFO)
-        console = Console(logger)
-        config = AppConfig(
-            solution_path=Path("path/to/solution.py"),
-            rules_path=Path("path/to/rules.json"),
-            log_level=LogLevel.INFO,
-            is_silent=False,
-            stop_on_first_fail=False
-        )
-
-        # Run validation
-        validator = StaticValidator(config, console)
-        is_valid = validator.run()
-
-        if is_valid:
-            print("Validation Passed!")
-
-Attributes:
-    __version__ (str): The current version of the package.
-    __all__ (list[str]): The list of public objects exposed by the package.
-
-"""
-
-from .config import AppConfig, ExitCode, LogLevel
-from .core import StaticValidator
-from .exceptions import RuleParsingError, ValidationFailedError
-
-__all__ = [
-    "StaticValidator",
-    "AppConfig",
-    "ExitCode",
-    "LogLevel",
-    "ValidationFailedError",
-    "RuleParsingError",
-]
-
-__version__ = "0.2.1"
+"""A flexible framework for static validation of Python code.
+
+This package provides a comprehensive toolkit for statically analyzing Python
+source code based on a declarative set of rules defined in a JSON format. It
+allows for checking syntax, style, structure, and constraints without
+executing the code.
+
+The primary entry point for using this package programmatically is the
+`StaticValidator` class.
+
+Example:
+    A minimal example of using the validator as a library.
+
+    .. code-block:: python
+
+        from code_validator import StaticValidator, AppConfig, LogLevel
+        from code_validator.output import Console, setup_logging
+        from pathlib import Path
+
+        # Basic setup
+        logger = setup_logging(LogLevel.INFO)
+        console = Console(logger)
+        config = AppConfig(
+            solution_path=Path("path/to/solution.py"),
+            rules_path=Path("path/to/rules.json"),
+            log_level=LogLevel.INFO,
+            is_silent=False,
+            stop_on_first_fail=False
+        )
+
+        # Run validation
+        validator = StaticValidator(config, console)
+        is_valid = validator.run()
+
+        if is_valid:
+            print("Validation Passed!")
+
+Attributes:
+    __version__ (str): The current version of the package.
+    __all__ (list[str]): The list of public objects exposed by the package.
+
+"""
+
+from .config import AppConfig, ExitCode, LogLevel
+from .core import StaticValidator
+from .exceptions import RuleParsingError, ValidationFailedError
+
+__all__ = [
+    "StaticValidator",
+    "AppConfig",
+    "ExitCode",
+    "LogLevel",
+    "ValidationFailedError",
+    "RuleParsingError",
+]
+
+__version__ = "0.4.0"

{python_code_validator-0.2.1 → python_code_validator-0.4.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.4.0}/src/code_validator/components/definitions.py

@@ -1,89 +1,91 @@
-"""Defines the core component interfaces for the validator using Protocols.
-
-This module establishes the fundamental "contracts" for the main architectural
-components: Rules, Selectors, and Constraints. By using `typing.Protocol`, we
-ensure that any class conforming to these interfaces can be used interchangeably
-by the system's factories and core engine. This enables a flexible and
-decoupled plugin-style architecture, where new components can be added without
-modifying the core logic.
-"""
-
-import ast
-from typing import Protocol, runtime_checkable
-
-from ..config import FullRuleConfig, ShortRuleConfig
-
-
-@runtime_checkable
-class Selector(Protocol):
-    """An interface for objects that find and select specific nodes from an AST.
-
-    A Selector's main responsibility is to traverse the Abstract Syntax Tree (AST)
-    of a Python source file and return a list of nodes that match a specific
-    criterion (e.g., all function definitions, all import statements).
-    """
-
-    def select(self, tree: ast.Module) -> list[ast.AST]:
-        """Selects and returns a list of relevant AST nodes from the tree.
-
-        Args:
-            tree: The full, parsed AST of the source code to be searched.
-
-        Returns:
-            A list of ast.AST nodes that match the selector's criteria.
-            An empty list should be returned if no matching nodes are found.
-        """
-        ...
-
-
-@runtime_checkable
-class Constraint(Protocol):
-    """An interface for objects that apply a condition to a set of AST nodes.
-
-    A Constraint takes the list of nodes found by a Selector and checks if they
-    satisfy a specific condition (e.g., the list must not be empty, the node
-    must inherit from a specific class).
-    """
-
-    def check(self, nodes: list[ast.AST]) -> bool:
-        """Checks if the given list of nodes satisfies the constraint.
-
-        Args:
-            nodes: A list of AST nodes provided by a Selector.
-
-        Returns:
-            True if the constraint is satisfied, False otherwise.
-        """
-        ...
-
-
-@runtime_checkable
-class Rule(Protocol):
-    """An interface for any complete, executable validation rule.
-
-    A Rule represents a single, self-contained validation check. It can be a
-    "short" rule (like a linter check) or a "full" rule that internally uses
-    a Selector and a Constraint. The core validator engine interacts with
-    objects conforming to this protocol.
-
-    Attributes:
-        config: The dataclass object holding the configuration for this rule,
-            parsed from the JSON file.
-    """
-
-    config: FullRuleConfig | ShortRuleConfig
-
-    def execute(self, tree: ast.Module | None, source_code: str | None = None) -> bool:
-        """Executes the validation rule.
-
-        Depending on the rule type, this method might operate on the AST, the
-        raw source code, or both.
-
-        Args:
-            tree: The full AST of the source code (for structural checks).
-            source_code: The raw source code string (e.g., for linter checks).
-
-        Returns:
-            True if the validation check passes, False otherwise.
-        """
-        ...
+"""Defines the core component interfaces for the validator using Protocols.
+
+This module establishes the fundamental "contracts" for the main architectural
+components: Rules, Selectors, and Constraints. By using `typing.Protocol`, we
+ensure that any class conforming to these interfaces can be used interchangeably
+by the system's factories and core engine. This enables a flexible and
+decoupled plugin-style architecture, where new components can be added without
+modifying the core logic.
+"""
+
+import ast
+from typing import Protocol, runtime_checkable
+
+from ..config import FullRuleConfig, ShortRuleConfig
+
+
+@runtime_checkable
+class Selector(Protocol):
+    """An interface for objects that find and select specific nodes from an AST.
+
+    A Selector's main responsibility is to traverse the Abstract Syntax Tree (AST)
+    of a Python source file and return a list of nodes that match a specific
+    criterion (e.g., all function definitions, all import statements).
+    """
+
+    def select(self, tree: ast.Module) -> list[ast.AST]:
+        """Selects and returns a list of relevant AST nodes from the tree.
+
+        Args:
+            tree: The full, parsed AST of the source code to be searched.
+
+        Returns:
+            A list of ast.AST nodes that match the selector's criteria.
+            An empty list should be returned if no matching nodes are found.
+        """
+        ...
+
+
+@runtime_checkable
+class Constraint(Protocol):
+    """An interface for objects that apply a condition to a set of AST nodes.
+
+    A Constraint takes the list of nodes found by a Selector and checks if they
+    satisfy a specific condition (e.g., the list must not be empty, the node
+    must inherit from a specific class).
+    """
+
+    def check(self, nodes: list[ast.AST]) -> bool:
+        """Checks if the given list of nodes satisfies the constraint.
+
+        Args:
+            nodes: A list of AST nodes provided by a Selector.
+
+        Returns:
+            True if the constraint is satisfied, False otherwise.
+        """
+        ...
+
+
+@runtime_checkable
+class Rule(Protocol):
+    """An interface for any complete, executable validation rule.
+
+    A Rule represents a single, self-contained validation check. It can be a
+    "short" rule (like a linter check) or a "full" rule that internally uses
+    a Selector and a Constraint. The core validator engine interacts with
+    objects conforming to this protocol.
+
+    Attributes:
+        config: The dataclass object holding the configuration for this rule,
+            parsed from the JSON file.
+        typo_suggestion: Optional typo suggestion message for user display.
+    """
+
+    config: FullRuleConfig | ShortRuleConfig
+    typo_suggestion: str | None
+
+    def execute(self, tree: ast.Module | None, source_code: str | None = None) -> bool:
+        """Executes the validation rule.
+
+        Depending on the rule type, this method might operate on the AST, the
+        raw source code, or both.
+
+        Args:
+            tree: The full AST of the source code (for structural checks).
+            source_code: The raw source code string (e.g., for linter checks).
+
+        Returns:
+            True if the validation check passes, False otherwise.
+        """
+        ...