chore: Update ty comments

Author: pawamoy

packages/griffecli/src/griffecli/_internal/cli.py

@@ -414,7 +414,7 @@ def dump(
     if per_package_output:
         for package_name, data in data_packages.items():
             serialized = data.as_json(indent=2, full=full, sort_keys=True)
-            _print_data(serialized, output.format(package=package_name))  # ty:ignore[possibly-missing-attribute]
+            _print_data(serialized, output.format(package=package_name))  # ty:ignore[unresolved-attribute]
     else:
         serialized = json.dumps(data_packages, cls=JSONEncoder, indent=2, full=full, sort_keys=True)
         _print_data(serialized, output)

packages/griffelib/src/griffe/_internal/agents/inspector.py

@@ -156,13 +156,13 @@ def __init__(
         self.parent: Module | None = parent
         """An optional parent for the final module object."""
 
-        self.current: Module | Class = None
+        self.current: Module | Class = None  # ty:ignore[invalid-assignment]
         """The current object being inspected."""
 
         self.docstring_parser: DocstringStyle | Parser | None = docstring_parser
         """The docstring parser to use."""
 
-        self.docstring_options: DocstringOptions = docstring_options or {}
+        self.docstring_options: DocstringOptions = docstring_options or {}  # ty:ignore[invalid-assignment]
         """The docstring parsing options."""
 
         self.lines_collection: LinesCollection = lines_collection or LinesCollection()
@@ -581,7 +581,7 @@ def handle_attribute(self, node: ObjectNode, annotation: str | Expr | None = Non
             analysis="dynamic",
         )
         attribute.labels |= labels
-        parent.set_member(node.name, attribute)  # ty:ignore[possibly-missing-attribute]
+        parent.set_member(node.name, attribute)  # ty:ignore[unresolved-attribute]
 
         if node.name == "__all__":
             parent.exports = list(node.obj)  # ty:ignore[invalid-assignment]

packages/griffelib/src/griffe/_internal/agents/nodes/runtime.py

@@ -113,7 +113,7 @@ def module_path(self) -> str | None:
             except ValueError:
                 return None
             try:
-                return module.__spec__.name  # ty:ignore[possibly-missing-attribute]
+                return module.__spec__.name  # ty:ignore[unresolved-attribute]
             except AttributeError:
                 return getattr(module, "__name__", None)
         else:

packages/griffelib/src/griffe/_internal/agents/visitor.py

@@ -176,13 +176,13 @@ def __init__(
         self.parent: Module | None = parent
         """An optional parent for the final module object."""
 
-        self.current: Module | Class = None
+        self.current: Module | Class = None  # ty:ignore[invalid-assignment]
         """The current object being visited."""
 
         self.docstring_parser: DocstringStyle | Parser | None = docstring_parser
         """The docstring parser to use."""
 
-        self.docstring_options: DocstringOptions = docstring_options or {}
+        self.docstring_options: DocstringOptions = docstring_options or {}  # ty:ignore[invalid-assignment]
         """The docstring parsing options."""
 
         self.lines_collection: LinesCollection = lines_collection or LinesCollection()
@@ -231,7 +231,7 @@ def _get_type_parameters(
                         member=scope,
                     ),
                 )
-                for type_param in node.type_params  # ty:ignore[possibly-missing-attribute,unused-ignore-comment,unused-ignore-comment]
+                for type_param in node.type_params  # ty:ignore[unresolved-attribute,unused-ignore-comment,unused-ignore-comment]
             ]
     else:
 
@@ -692,8 +692,8 @@ def handle_attribute(
                     if existing_member.docstring and not docstring:
                         docstring = existing_member.docstring
                     with suppress(AttributeError):
-                        if existing_member.annotation and not annotation:  # ty:ignore[possibly-missing-attribute]
-                            annotation = existing_member.annotation  # ty:ignore[possibly-missing-attribute]
+                        if existing_member.annotation and not annotation:  # ty:ignore[unresolved-attribute]
+                            annotation = existing_member.annotation  # ty:ignore[unresolved-attribute]
 
             attribute = Attribute(
                 name=name,
@@ -741,13 +741,13 @@ def visit_augassign(self, node: ast.AugAssign) -> None:
         """
         with suppress(AttributeError):
             all_augment = (
-                node.target.id == "__all__"  # ty:ignore[possibly-missing-attribute]
+                node.target.id == "__all__"  # ty:ignore[unresolved-attribute]
                 and self.current.is_module
                 and isinstance(node.op, ast.Add)
             )
             if all_augment:
                 # We assume `exports` is not `None` at this point.
-                self.current.exports.extend(  # ty:ignore[possibly-missing-attribute]
+                self.current.exports.extend(  # ty:ignore[unresolved-attribute]
                     [
                         name if isinstance(name, str) else ExprName(name.name, parent=name.parent)
                         for name in safe_get__all__(node, self.current)  # ty:ignore[invalid-argument-type]

packages/griffelib/src/griffe/_internal/diff.py

@@ -131,19 +131,19 @@ def explain(self, style: ExplanationStyle = ExplanationStyle.ONE_LINE) -> str:
     @property
     def _filepath(self) -> Path:
         if self.obj.is_alias:
-            return self.obj.parent.filepath  # ty:ignore[invalid-return-type, possibly-missing-attribute]
+            return self.obj.parent.filepath  # ty:ignore[invalid-return-type, unresolved-attribute]
         return self.obj.filepath  # ty:ignore[invalid-return-type]
 
     @property
     def _relative_filepath(self) -> Path:
         if self.obj.is_alias:
-            return self.obj.parent.relative_filepath  # ty:ignore[possibly-missing-attribute]
+            return self.obj.parent.relative_filepath  # ty:ignore[unresolved-attribute]
         return self.obj.relative_filepath
 
     @property
     def _relative_package_filepath(self) -> Path:
         if self.obj.is_alias:
-            return self.obj.parent.relative_package_filepath  # ty:ignore[possibly-missing-attribute]
+            return self.obj.parent.relative_package_filepath  # ty:ignore[unresolved-attribute]
         return self.obj.relative_package_filepath
 
     @property
@@ -167,7 +167,7 @@ def _canonical_path(self) -> str:
     @property
     def _module_path(self) -> str:
         if self.obj.is_alias:
-            return self.obj.parent.module.path  # ty:ignore[possibly-missing-attribute]
+            return self.obj.parent.module.path  # ty:ignore[unresolved-attribute]
         return self.obj.module.path
 
     @property
@@ -182,7 +182,7 @@ def _lineno(self) -> int:
         if self.kind is BreakageKind.OBJECT_REMOVED and self._relative_filepath != self._location:
             return 0
         if self.obj.is_alias:
-            return self.obj.alias_lineno or 0  # ty:ignore[possibly-missing-attribute]
+            return self.obj.alias_lineno or 0  # ty:ignore[unresolved-attribute]
         return self.obj.lineno or 0
 
     def _format_location(self, *, colors: bool = True) -> str:
@@ -566,8 +566,8 @@ def _alias_incompatibilities(
     seen_paths: set[str],
 ) -> Iterable[Breakage]:
     try:
-        old_member = old_obj.target if old_obj.is_alias else old_obj  # ty:ignore[possibly-missing-attribute]
-        new_member = new_obj.target if new_obj.is_alias else new_obj  # ty:ignore[possibly-missing-attribute]
+        old_member = old_obj.target if old_obj.is_alias else old_obj  # ty:ignore[unresolved-attribute]
+        new_member = new_obj.target if new_obj.is_alias else new_obj  # ty:ignore[unresolved-attribute]
     except AliasResolutionError:
         logger.debug("API check: %s | %s: skip alias with unknown target", old_obj.path, new_obj.path)
         return

packages/griffelib/src/griffe/_internal/docstrings/auto.py

@@ -162,7 +162,7 @@ def infer_docstring_style(
     if method == "max_sections":
         style_sections = {}
         for style in style_order:
-            style_sections[style] = parsers[style](docstring, **per_style_options.get(style, {}))  # ty:ignore[possibly-missing-attribute]
+            style_sections[style] = parsers[style](docstring, **per_style_options.get(style, {}))  # ty:ignore[unresolved-attribute]
         style_lengths = {style: len(section) for style, section in style_sections.items()}
         max_sections = max(style_lengths.values())
         for style in style_order:
@@ -220,5 +220,5 @@ def parse_auto(
         per_style_options=per_style_options,
     )
     if sections is None:
-        return parse(docstring, style, **per_style_options.get(style, {}))  # ty:ignore[no-matching-overload, possibly-missing-attribute]
+        return parse(docstring, style, **per_style_options.get(style, {}))  # ty:ignore[no-matching-overload, unresolved-attribute]
     return sections

packages/griffelib/src/griffe/_internal/docstrings/google.py

@@ -311,20 +311,20 @@ def _read_type_parameters_section(
             name = name_with_bound
             # try to use the annotation from the signature
             try:
-                bound = docstring.parent.type_parameters[name].annotation  # ty:ignore[possibly-missing-attribute]
+                bound = docstring.parent.type_parameters[name].annotation  # ty:ignore[unresolved-attribute]
             except (AttributeError, KeyError):
                 bound = None
 
         try:
-            default = docstring.parent.type_parameters[name].default  # ty:ignore[possibly-missing-attribute]
+            default = docstring.parent.type_parameters[name].default  # ty:ignore[unresolved-attribute]
         except (AttributeError, KeyError):
             default = None
 
         if warn_unknown_params:
             with suppress(AttributeError):  # for type parameters sections in objects without type parameters
-                type_params = docstring.parent.type_parameters  # ty:ignore[possibly-missing-attribute]
+                type_params = docstring.parent.type_parameters  # ty:ignore[unresolved-attribute]
                 if name not in type_params:
-                    message = f"Type parameter '{name}' does not appear in the {docstring.parent.kind.value} signature"  # ty:ignore[possibly-missing-attribute]
+                    message = f"Type parameter '{name}' does not appear in the {docstring.parent.kind.value} signature"  # ty:ignore[unresolved-attribute]
                     for starred_name in (f"*{name}", f"**{name}"):
                         if starred_name in type_params:
                             message += f". Did you mean '{starred_name}'?"

packages/griffelib/src/griffe/_internal/docstrings/numpy.py

@@ -367,23 +367,23 @@ def _read_type_parameters_section(
             # try to use the bound from the signature
             for name in names:
                 with suppress(AttributeError, KeyError):
-                    bound = docstring.parent.type_parameters[name].annotation  # ty:ignore[possibly-missing-attribute]
+                    bound = docstring.parent.type_parameters[name].annotation  # ty:ignore[unresolved-attribute]
                     break
         else:
             bound = parse_docstring_annotation(bound, docstring, log_level=LogLevel.debug)
 
         if default is None:
             for name in names:
                 with suppress(AttributeError, KeyError):
-                    default = docstring.parent.type_parameters[name].default  # ty:ignore[possibly-missing-attribute]
+                    default = docstring.parent.type_parameters[name].default  # ty:ignore[unresolved-attribute]
                     break
 
         if warn_unknown_params:
             with suppress(AttributeError):  # for parameters sections in objects without parameters
-                type_params = docstring.parent.type_parameters  # ty:ignore[possibly-missing-attribute]
+                type_params = docstring.parent.type_parameters  # ty:ignore[unresolved-attribute]
                 for name in names:
                     if name not in type_params:
-                        message = f"Type parameter '{name}' does not appear in the {docstring.parent.kind} signature"  # ty:ignore[possibly-missing-attribute]
+                        message = f"Type parameter '{name}' does not appear in the {docstring.parent.kind} signature"  # ty:ignore[unresolved-attribute]
                         for starred_name in (f"*{name}", f"**{name}"):
                             if starred_name in type_params:
                                 message += f". Did you mean '{starred_name}'?"
@@ -458,9 +458,9 @@ def _read_returns_section(
         if annotation is None:
             # try to retrieve the annotation from the docstring parent
             with suppress(AttributeError, KeyError, ValueError):
-                if docstring.parent.is_function:  # ty:ignore[possibly-missing-attribute]
+                if docstring.parent.is_function:  # ty:ignore[unresolved-attribute]
                     annotation = docstring.parent.returns  # ty:ignore[unresolved-attribute]
-                elif docstring.parent.is_attribute:  # ty:ignore[possibly-missing-attribute]
+                elif docstring.parent.is_attribute:  # ty:ignore[unresolved-attribute]
                     annotation = docstring.parent.annotation  # ty:ignore[unresolved-attribute]
                 else:
                     raise ValueError

packages/griffelib/src/griffe/_internal/docstrings/utils.py

@@ -37,11 +37,11 @@ def docstring_warning(
 
     def warn(docstring: Docstring, offset: int, message: str, log_level: LogLevel = LogLevel.warning) -> None:
         try:
-            prefix = docstring.parent.relative_filepath  # ty:ignore[possibly-missing-attribute]
+            prefix = docstring.parent.relative_filepath  # ty:ignore[unresolved-attribute]
         except (AttributeError, ValueError):
             prefix = "<module>"
         except BuiltinModuleError:
-            prefix = f"<module: {docstring.parent.module.name}>"  # ty:ignore[possibly-missing-attribute]
+            prefix = f"<module: {docstring.parent.module.name}>"  # ty:ignore[unresolved-attribute]
         log = getattr(logger, log_level.value)
         log(f"{prefix}:{(docstring.lineno or 0) + offset}: {message}")
 

packages/griffelib/src/griffe/_internal/encoders.py

@@ -197,7 +197,7 @@ def _attach_parent_to_exprs(obj: Class | Function | Attribute | TypeAlias, paren
 def _load_module(obj_dict: dict[str, Any]) -> Module:
     filepath = obj_dict.get("filepath")
     if filepath is not None:
-        filepath = [*map(Path, filepath)] if isinstance(filepath, list) else Path(filepath)
+        filepath = [*map(Path, filepath)] if isinstance(filepath, list) else Path(filepath)  # ty:ignore[invalid-argument-type]
     module = Module(
         name=obj_dict["name"],
         filepath=filepath,