CLASPLint 0.5.0__tar.gz → 0.5.2__tar.gz

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/__init__.py

@@ -22,16 +22,16 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17
 
-FILE VERSION DATE    : 2026-07-08
+FILE VERSION DATE    : 2026-07-11
 
-FILE VERSION         : 0.5.0
+FILE VERSION         : 1.0.1
 
 
 STATUS               : Stable
@@ -71,6 +71,6 @@ Sort License:
 """
 
 # Define the package version string.
-__version__ = "0.5.0"
+__version__ = "0.5.2"
 # Expose the runner and reporter modules as the public API.
 __all__ = ["runner", "reporter"]

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/__main__.py

@@ -20,9 +20,9 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17
@@ -159,6 +159,10 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
     :return: Exit code 0 when no violations are found, 1 otherwise.
     :rtype: int
     """
+    # Ensure stdout and stderr use UTF-8 encoding for cross-platform Chinese output.
+    sys.stdout.reconfigure(encoding='utf-8')
+    # Reconfigure the standard error stream to use UTF-8 encoding.
+    sys.stderr.reconfigure(encoding='utf-8')
     # Build and parse command-line arguments.
     command_parser = _init_build_parser_function_()
     # Parse the provided arguments or default to sys.argv.

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/checker_base.py

@@ -22,9 +22,9 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-07-08

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/comment_checker.py

@@ -20,9 +20,9 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/configuration.py

@@ -23,9 +23,9 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-07-07

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/configuration.yaml

@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
 """
 THIS FILE IS CORE PART OF CLASPLINT BY MATT BELFAST BROWN.
 
@@ -24,16 +24,16 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-07-06
 
-FILE VERSION DATE    : 2026-07-08
+FILE VERSION DATE    : 2026-07-11
 
-FILE VERSION         : 1.0.0
+FILE VERSION         : 1.0.1
 
 
 STATUS               : Stable
@@ -341,6 +341,40 @@ bool_words:
   - is
   # Require the has prefix to mark boolean possession-checking variables.
   - has
+  # Require the bool prefix to mark boolean type-prefixed variables.
+  - bool
+  # Require the should prefix to mark boolean recommendation variables.
+  - should
+  # Require the can prefix to mark boolean capability-checking variables.
+  - can
+  # Require the does prefix to mark boolean action-status variables.
+  - does
+  # Require the did prefix to mark boolean past-action variables.
+  - did
+  # Require the do prefix to mark boolean imperative variables.
+  - do
+  # Require the will prefix to mark boolean future-intent variables.
+  - will
+  # Require the was prefix to mark boolean past-state variables.
+  - was
+  # Require the were prefix to mark boolean past-plural variables.
+  - were
+  # Require the could prefix to mark boolean possibility variables.
+  - could
+  # Require the would prefix to mark boolean hypothetical variables.
+  - would
+  # Require the might prefix to mark boolean uncertainty variables.
+  - might
+  # Require the must prefix to mark boolean requirement variables.
+  - must
+  # Require the needs prefix to mark boolean need-indication variables.
+  - needs
+  # Require the contains prefix to mark boolean membership variables.
+  - contains
+  # Require the allows prefix to mark boolean permission variables.
+  - allows
+  # Require the supports prefix to mark boolean feature-check variables.
+  - supports
 
 # Vague verbs that trigger function name warnings when used at the start.
 verbs_vague:

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/dict_key_checker.py

@@ -20,16 +20,16 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17
 
-FILE VERSION DATE    : 2026-07-08
+FILE VERSION DATE    : 2026-07-11
 
-FILE VERSION         : 1.0.0
+FILE VERSION         : 1.0.1
 
 
 STATUS               : Stable
@@ -94,7 +94,7 @@ class DictKeyChecker(ast.NodeVisitor):
             Visit subscript nodes for potential dict key access in assignments.
 
     PRIVATE METHODS                    :
-        _init_key_function_(node_key: ast.AST) -> None:
+        _init_validate_key_function_(node_key: ast.AST) -> None:
             Validate a string-constant dictionary key.
         _init_keyword_as_key_function_(node_keyword: ast.keyword) -> list:
             Validate a keyword argument name used as a dictionary key.
@@ -129,7 +129,7 @@ class DictKeyChecker(ast.NodeVisitor):
         # Collect violations found during AST traversal.
         self.list_violations: List[Violation] = []
 
-    def _init_key_function_(self, node_key: ast.AST) -> None:
+    def _init_validate_key_function_(self, node_key: ast.AST) -> None:
         """
         Validate a single dictionary key literal.
 
@@ -197,7 +197,7 @@ class DictKeyChecker(ast.NodeVisitor):
             # Process non-None keys through the key validator.
             if node_key is not None:
                 # Delegate to the key validation method for this dictionary key.
-                self._init_key_function_(node_key)
+                self._init_validate_key_function_(node_key)
         # Continue visiting child nodes for nested dictionaries.
         self.generic_visit(ast_node)
 

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/docstring_checker.py

@@ -20,16 +20,16 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17
 
-FILE VERSION DATE    : 2026-07-08
+FILE VERSION DATE    : 2026-07-11
 
-FILE VERSION         : 1.0.0
+FILE VERSION         : 1.0.1
 
 
 STATUS               : Stable
@@ -156,6 +156,8 @@ class DocstringChecker(ast.NodeVisitor):
         self.list_violations: List[Violation] = []
         # Track the current class name for contextual messages.
         self.string_currentclass: str = ""
+        # Track whether the current class inherits from ast.NodeVisitor for visit_* exemption.
+        self.is_astvisitor: bool = False
 
     def _init_add_violation_function_(self, ast_node: ast.AST, string_message: str) -> None:
         """
@@ -273,10 +275,16 @@ class DocstringChecker(ast.NodeVisitor):
         string_previous = self.string_currentclass
         # Set the current class name for method context messages.
         self.string_currentclass = ast_node.name
+        # Save the previous visitor flag before entering the new class.
+        was_visitor = self.is_astvisitor
+        # Determine whether this class inherits from ast.NodeVisitor for visit_* exemption.
+        self.is_astvisitor = self._init_detect_visitor_function_(ast_node)
         # Visit child nodes within the class body to check methods.
         self.generic_visit(ast_node)
         # Restore the previous class context after leaving the class.
         self.string_currentclass = string_previous
+        # Restore the previous visitor flag after leaving the class.
+        self.is_astvisitor = was_visitor
 
     def visit_FunctionDef(self, ast_node: Union[ast.FunctionDef, ast.AsyncFunctionDef]) -> None:
         """
@@ -319,8 +327,14 @@ class DocstringChecker(ast.NodeVisitor):
             return
         # Perform Sphinx format validation only for class methods.
         if bool_ismethod:
-            # Validate the method docstring against the Sphinx directive format.
-            self._init_check_format_function_(ast_node, docstring_text, display_name)
+            # Skip Sphinx format checks for visit_* methods in ast.NodeVisitor subclasses.
+            if self.is_astvisitor and ast_node.name.startswith("visit_"):
+                # Exempt NodeVisitor callback methods per CLASP Stage 3.3 Section 6.4.4.
+                pass
+            # Sphinx format checks apply to non-visit methods only.
+            else:
+                # Validate the method docstring against the Sphinx directive format.
+                self._init_check_format_function_(ast_node, docstring_text, display_name)
         # Validate docstring text quality for all functions and methods.
         self._init_chk_doc_qual_function_(ast_node, docstring_text, display_name)
         # Continue visiting the function body for nested definitions.
@@ -341,6 +355,46 @@ class DocstringChecker(ast.NodeVisitor):
         # Delegate to the standard function definition visitor.
         self.visit_FunctionDef(ast_node)
 
+    @staticmethod
+    def _init_detect_visitor_function_(class_node: ast.ClassDef) -> bool:
+        """
+        Determine whether the class definition inherits from ast.NodeVisitor.
+
+        Inspects each base class of the given ClassDef node and checks whether any
+        base matches the ast.NodeVisitor attribute chain. Returns True immediately
+        upon finding a match, or False after exhausting all bases.
+
+        The parameters are as follows:
+
+        :param class_node: The ClassDef AST node whose base classes are inspected.
+        :type class_node: ast.ClassDef
+        :return: True if any base class is ast.NodeVisitor, False otherwise.
+        :rtype: bool
+        """
+        # Iterate over each base class in the class definition.
+        for node_base in class_node.bases:
+            # Check for direct ast.NodeVisitor base class reference.
+            if isinstance(node_base, ast.Attribute):
+                # Verify the attribute chain matches ast.NodeVisitor.
+                if (
+                        # Check that the value is an ast Name node.
+                        isinstance(node_base.value, ast.Name)
+                        # Match the module name ast.
+                        and node_base.value.id == "ast"
+                        # Match the class name NodeVisitor.
+                        and node_base.attr == "NodeVisitor"
+                ):
+                    # Confirm that the class inherits from ast.NodeVisitor.
+                    return True
+            # Check for known NodeVisitor subclass as base class.
+            if isinstance(node_base, ast.Name):
+                # Detect known NodeVisitor subclasses used in this project.
+                if node_base.id == "CheckerBase":
+                    # Confirm transitively inheriting from ast.NodeVisitor.
+                    return True
+        # No ast.NodeVisitor base class was found in the inheritance chain.
+        return False
+
     def _init_check_format_function_(
             # Accept the function definition node for signature analysis.
             self, ast_node: Union[ast.FunctionDef, ast.AsyncFunctionDef],

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/function_checker.py

@@ -20,16 +20,16 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17
 
-FILE VERSION DATE    : 2026-07-08
+FILE VERSION DATE    : 2026-07-11
 
-FILE VERSION         : 1.0.0
+FILE VERSION         : 1.0.1
 
 
 STATUS               : Stable
@@ -86,7 +86,7 @@ class FunctionChecker(CheckerBase):
         source_lines (list): Source lines for contextual messages.
         list_violations (list): Collected naming violations.
         string_currentclass (str): Current class context for method detection.
-        bool_isastvisitor (bool): Whether current class inherits ast.NodeVisitor.
+        is_astvisitor (bool): Whether current class inherits ast.NodeVisitor.
 
     PUBLIC METHODS                     :
         visit_ClassDef(class_node: ast.ClassDef) -> None:
@@ -130,7 +130,7 @@ class FunctionChecker(CheckerBase):
         # Track the current class context for method detection.
         self.string_currentclass: str = ""
         # Track whether the current class inherits from ast.NodeVisitor.
-        self.bool_isastvisitor: bool = False
+        self.is_astvisitor: bool = False
 
     def _init_add_violations_function_(
             # Accept the violation category for grouping in the report.
@@ -180,17 +180,17 @@ class FunctionChecker(CheckerBase):
         # Save the previous class context before entering the new class.
         string_previous = self.string_currentclass
         # Save the previous visitor flag before entering the new class.
-        was_visitor = self.bool_isastvisitor
+        was_visitor = self.is_astvisitor
         # Set the current class context for method detection.
         self.string_currentclass = class_node.name
         # Determine whether this class inherits from ast.NodeVisitor for visit_* exemption.
-        self.bool_isastvisitor = self._init_detect_visitor_function_(class_node)
+        self.is_astvisitor = self._init_detect_visitor_function_(class_node)
         # Visit child nodes within the class body.
         self.generic_visit(class_node)
         # Restore the previous class context after leaving the class.
         self.string_currentclass = string_previous
         # Restore the previous visitor flag after leaving the class.
-        self.bool_isastvisitor = was_visitor
+        self.is_astvisitor = was_visitor
 
     def visit_FunctionDef(self, function_node: Union[ast.FunctionDef, ast.AsyncFunctionDef]) -> None:
         """
@@ -214,7 +214,7 @@ class FunctionChecker(CheckerBase):
             # Indicate whether this is a method or a module-level function.
             is_method=bool_ismethod,
             # Pass the AST visitor flag for targeted visit_* exemption.
-            is_astvisitor=self.bool_isastvisitor,
+            is_astvisitor=self.is_astvisitor,
         )
         # Use the "function" category for all function and method violations.
         string_category = "function"

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/log_checker.py

@@ -20,9 +20,9 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/naming_utils.py

@@ -20,16 +20,16 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17
 
-FILE VERSION DATE    : 2026-07-08
+FILE VERSION DATE    : 2026-07-11
 
-FILE VERSION         : 1.0.0
+FILE VERSION         : 1.0.1
 
 
 STATUS               : Stable
@@ -489,8 +489,20 @@ def is_private_method_format(string_name: str) -> bool:
     :return: True when the name matches the private method format pattern.
     :rtype: bool
     """
-    # Use regex to match the required _init_..._function_ private method format.
-    return bool(re.match(r'^_init_[a-z][a-z0-9]*(_[a-z][a-z0-9]*)*_function_$', string_name))
+    # Match the _init_..._function_ pattern with fully spelled lowercase word groups.
+    match_result = re.match(r'^_init_([a-z]+(_[a-z]+)*)_function_$', string_name)
+    # Reject names that do not match the basic private method pattern.
+    if not match_result:
+        # Exit early when the name structure does not match _init_..._function_ format.
+        return False
+    # Extract the descriptor portion between _init_ and _function_.
+    string_descriptor = match_result.group(1)
+    # Split the descriptor into individual word segments by underscore.
+    list_words = string_descriptor.split('_')
+    # Count the number of fully spelled words in the descriptor.
+    int_wordcount = len(list_words)
+    # Enforce the 2-to-8 word range per CLASP Stage 3.3 Section 4.3.6.
+    return 2 <= int_wordcount <= 8
 
 
 def validate_variable_name(string_name: str) -> list:

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/reporter.py

@@ -20,9 +20,9 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/runner.py

@@ -20,9 +20,9 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/try_except_checker.py

@@ -21,9 +21,9 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-07-07

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint/variable_checker.py

@@ -20,16 +20,16 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17
 
-FILE VERSION DATE    : 2026-07-08
+FILE VERSION DATE    : 2026-07-11
 
-FILE VERSION         : 1.0.0
+FILE VERSION         : 1.0.2
 
 
 STATUS               : Stable
@@ -352,16 +352,24 @@ class VariableChecker(ast.NodeVisitor):
         :param ast_node: The assignment AST node whose targets contain variable names.
         :type ast_node: ast.Assign
         """
-        # Detect module-level ALL_CAPS assignments as constant naming violations.
+        # Detect ALL_CAPS assignments as constant naming violations.
         for target_node in ast_node.targets:
+            # Track the variable name string to validate, regardless of node type.
+            target_name = ""
             # Check simple Name targets for ALL_CAPS pattern suggesting a constant.
             if isinstance(target_node, ast.Name):
-                # An all-uppercase name with underscores is the traditional Python constant pattern.
+                # Extract the identifier from the Name node.
                 target_name = target_node.id
-                # Exempt names in the check-skipping set.
-                if target_name not in names_exempt:
-                    # Detect any uppercase letter in the variable name.
-                    if target_name != target_name.lower():
+            # Check attribute targets only for self or cls instance variables.
+            elif isinstance(target_node, ast.Attribute):
+                # Only extract the attribute name when the object is self or cls.
+                if isinstance(target_node.value, ast.Name) and target_node.value.id in ('self', 'cls'):
+                    # Extract the attribute name from the Attribute node.
+                    target_name = target_node.attr
+            # Validate the extracted name when it is not exempt from checks.
+            if target_name and target_name not in names_exempt:
+                # Detect any uppercase letter in the variable name.
+                if target_name != target_name.lower():
                         # Build a unique key to prevent duplicate reports.
                         int_lineno = getattr(ast_node, 'lineno', 0)
                         # Guard against nodes that lack a reliable line number.
@@ -417,10 +425,22 @@ class VariableChecker(ast.NodeVisitor):
         :param ast_node: The assignment AST node to inspect for boolean literal values.
         :type ast_node: ast.Assign
         """
-        # Only check simple Name targets, not unpacking patterns.
+        # Check Name and Attribute targets for boolean literal assignments.
         for target_node in ast_node.targets:
-            # Skip non-Name targets and exempt names.
-            if not isinstance(target_node, ast.Name) or target_node.id in names_exempt:
+            # Track the variable name regardless of target node type.
+            target_name = ""
+            # Extract the name from simple Name targets.
+            if isinstance(target_node, ast.Name):
+                # Retrieve the identifier from the Name node.
+                target_name = target_node.id
+            # Extract the attribute name only for self.xxx or cls.xxx Attribute targets.
+            elif isinstance(target_node, ast.Attribute):
+                # Only retrieve the attribute name when the object is self or cls.
+                if isinstance(target_node.value, ast.Name) and target_node.value.id in ('self', 'cls'):
+                    # Retrieve the attribute name portion from the Attribute node.
+                    target_name = target_node.attr
+            # Skip when no valid name was extracted or the name is exempt.
+            if not target_name or target_name in names_exempt:
                 # Proceed to the next target.
                 continue
             # Detect boolean literal assignments for prefix verification.
@@ -431,8 +451,6 @@ class VariableChecker(ast.NodeVisitor):
             if ast_node.value.value not in (True, False):
                 # Skip non-boolean constants.
                 continue
-            # Extract the variable name for inspection.
-            target_name = target_node.id
             # Extract the first underscore-separated group for prefix detection.
             list_groups = target_name.split("_")
             # Skip variables that already use the mandatory boolean prefix.
@@ -491,10 +509,20 @@ class VariableChecker(ast.NodeVisitor):
         """
         # Check that bool-annotated variables use the mandatory boolean prefix.
         if isinstance(ast_node.annotation, ast.Name) and ast_node.annotation.id == "bool":
-            # Only apply the check to simple Name targets, not unpacking patterns.
-            if isinstance(ast_node.target, ast.Name) and ast_node.target.id not in names_exempt:
-                # Split to inspect whether group1 is a recognized boolean prefix.
+            # Track the variable name regardless of target node type.
+            target_name = ""
+            # Extract the name from simple Name targets.
+            if isinstance(ast_node.target, ast.Name):
+                # Retrieve the variable name from the Name node.
                 target_name = ast_node.target.id
+            # Extract the attribute name only for self.xxx or cls.xxx Attribute targets.
+            elif isinstance(ast_node.target, ast.Attribute):
+                # Only retrieve the attribute name when the object is self or cls.
+                if isinstance(ast_node.target.value, ast.Name) and ast_node.target.value.id in ('self', 'cls'):
+                    # Retrieve the attribute name portion from the Attribute node.
+                    target_name = ast_node.target.attr
+            # Validate the bool prefix when a name was extracted and is not exempt.
+            if target_name and target_name not in names_exempt:
                 # Extract the first underscore-separated group.
                 list_groups = target_name.split("_")
                 # Flag bool-annotated variables missing is_ or has_ prefix.
@@ -707,10 +735,12 @@ class VariableChecker(ast.NodeVisitor):
         elif isinstance(target, ast.Starred):
             # Recursively walk the value inside the starred expression.
             self._init_walk_target_function_(target.value)
-        # Skip attribute assignments (obj.attr = ...) as these are not variable definitions.
+        # Validate instance variable names only when assigned via self.attr or cls.attr.
         elif isinstance(target, ast.Attribute):
-            # Take no action for attribute assignment targets.
-            pass
+            # Only validate attribute names on self or cls instances.
+            if isinstance(target.value, ast.Name) and target.value.id in ('self', 'cls'):
+                # Extract the attribute name part beyond the dot for validation.
+                self._init_check_name_function_(target.attr, target)
         # Skip subscript assignments (obj[key] = ...) as these are not variable definitions.
         elif isinstance(target, ast.Subscript):
             # Take no action for subscript assignment targets.

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/CLASPLint.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: CLASPLint
-Version: 0.5.0
+Version: 0.5.2
 Summary: CLASP Stage 3.3 / PEP 2606 Static Analysis Tool — enforces naming and comment conventions beyond PEP 8.
 Author: Matt Belfast Brown
 Author-email: Matt Belfast Brown <thedayofthedo@gmail.com>
@@ -27,11 +27,11 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
-# CLASPLint
+# CLASPLint
 
 [![Python](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://www.python.org/)
 [![License](https://img.shields.io/badge/license-GPLv3-green)](./LICENSE)
-[![PyPI](https://img.shields.io/badge/pypi-v0.5.0-orange)](https://pypi.org/project/CLASPLint/)
+[![PyPI](https://img.shields.io/badge/pypi-v0.5.2-orange)](https://pypi.org/project/CLASPLint/)
 
 > CLASP Stage 3.3 / PEP 2606 static analysis tool. Enforces naming and comment conventions beyond PEP 8 —
 > checks variables, dictionary keys, functions, classes, comments, and log messages for standards
@@ -210,7 +210,7 @@ CLASPLint supports **Python 3.8 through 3.14**. The minimum version is 3.8 due t
 
 [![Python](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://www.python.org/)
 [![License](https://img.shields.io/badge/license-GPLv3-green)](./LICENSE)
-[![PyPI](https://img.shields.io/badge/pypi-v0.5.0-orange)](https://pypi.org/project/CLASPLint/)
+[![PyPI](https://img.shields.io/badge/pypi-v0.5.2-orange)](https://pypi.org/project/CLASPLint/)
 
 > **CLASP Stage 3.3 / PEP 2606** 静态分析工具。在 PEP 8 **之上**强制执行命名与注释规范 ——
 > 检查变量、字典键、函数、类、注释和日志消息是否符合标准。

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: CLASPLint
-Version: 0.5.0
+Version: 0.5.2
 Summary: CLASP Stage 3.3 / PEP 2606 Static Analysis Tool — enforces naming and comment conventions beyond PEP 8.
 Author: Matt Belfast Brown
 Author-email: Matt Belfast Brown <thedayofthedo@gmail.com>
@@ -27,11 +27,11 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
-# CLASPLint
+# CLASPLint
 
 [![Python](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://www.python.org/)
 [![License](https://img.shields.io/badge/license-GPLv3-green)](./LICENSE)
-[![PyPI](https://img.shields.io/badge/pypi-v0.5.0-orange)](https://pypi.org/project/CLASPLint/)
+[![PyPI](https://img.shields.io/badge/pypi-v0.5.2-orange)](https://pypi.org/project/CLASPLint/)
 
 > CLASP Stage 3.3 / PEP 2606 static analysis tool. Enforces naming and comment conventions beyond PEP 8 —
 > checks variables, dictionary keys, functions, classes, comments, and log messages for standards
@@ -210,7 +210,7 @@ CLASPLint supports **Python 3.8 through 3.14**. The minimum version is 3.8 due t
 
 [![Python](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://www.python.org/)
 [![License](https://img.shields.io/badge/license-GPLv3-green)](./LICENSE)
-[![PyPI](https://img.shields.io/badge/pypi-v0.5.0-orange)](https://pypi.org/project/CLASPLint/)
+[![PyPI](https://img.shields.io/badge/pypi-v0.5.2-orange)](https://pypi.org/project/CLASPLint/)
 
 > **CLASP Stage 3.3 / PEP 2606** 静态分析工具。在 PEP 8 **之上**强制执行命名与注释规范 ——
 > 检查变量、字典键、函数、类、注释和日志消息是否符合标准。

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/README.md

@@ -1,8 +1,8 @@
-# CLASPLint
+# CLASPLint
 
 [![Python](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://www.python.org/)
 [![License](https://img.shields.io/badge/license-GPLv3-green)](./LICENSE)
-[![PyPI](https://img.shields.io/badge/pypi-v0.5.0-orange)](https://pypi.org/project/CLASPLint/)
+[![PyPI](https://img.shields.io/badge/pypi-v0.5.2-orange)](https://pypi.org/project/CLASPLint/)
 
 > CLASP Stage 3.3 / PEP 2606 static analysis tool. Enforces naming and comment conventions beyond PEP 8 —
 > checks variables, dictionary keys, functions, classes, comments, and log messages for standards
@@ -181,7 +181,7 @@ CLASPLint supports **Python 3.8 through 3.14**. The minimum version is 3.8 due t
 
 [![Python](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://www.python.org/)
 [![License](https://img.shields.io/badge/license-GPLv3-green)](./LICENSE)
-[![PyPI](https://img.shields.io/badge/pypi-v0.5.0-orange)](https://pypi.org/project/CLASPLint/)
+[![PyPI](https://img.shields.io/badge/pypi-v0.5.2-orange)](https://pypi.org/project/CLASPLint/)
 
 > **CLASP Stage 3.3 / PEP 2606** 静态分析工具。在 PEP 8 **之上**强制执行命名与注释规范 ——
 > 检查变量、字典键、函数、类、注释和日志消息是否符合标准。

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "CLASPLint"
-version = "0.5.0"
+version = "0.5.2"
 description = "CLASP Stage 3.3 / PEP 2606 Static Analysis Tool — enforces naming and comment conventions beyond PEP 8."
 readme = "README.md"
 license = {text = "GPL-3.0-only"}

{CLASPLint-0.5.0 → CLASPLint-0.5.2}/setup.py

@@ -23,16 +23,16 @@ MAINTAINER           :
 
 PROJECT CREATE DATE  : 2026-06-17
 
-PROJECT VERSION DATE : 2026-07-08
+PROJECT VERSION DATE : 2026-07-11
 
-PROJECT VERSION      : 0.5.0
+PROJECT VERSION      : 0.5.2
 
 
 FILE CREATE DATE     : 2026-06-17
 
-FILE VERSION DATE    : 2026-07-08
+FILE VERSION DATE    : 2026-07-11
 
-FILE VERSION         : 0.5.0
+FILE VERSION         : 1.0.1
 
 
 STATUS               : Stable
@@ -75,7 +75,7 @@ setup(
     # Declare the package name used for PyPI registration and pip install.
     name="CLASPLint",
     # Declare the semantic version following major.minor.patch convention.
-    version="0.5.0",
+    version="0.5.2",
 
     # Provide a brief description of the tool for PyPI and help text.
     description="CLASP Stage 3.3 / PEP 2606 Static Analysis Tool",