skip annotations for version results

Add support for an ebuild to declare a skip annotation for a class of
*version* results. This skip annotation must be declared before any
non-comment non-empty line (most of the times it would be before the
EAPI declaration). Empty lines between the copyright and the annotation
are allowed.
The annotation line must be precise, only one class per line and every
space is required.

For example, it would look like:

  # Copyright 2023 Gentoo Authors
  # Distributed under the terms of the GNU General Public License v2

  # pkgcheck skip: PythonCompatUpdate

  EAPI=8

Resolves: #478
Signed-off-by: Arthur Zamarin <[email protected]>

Author: arthurzam

src/pkgcheck/results.py

@@ -225,6 +225,9 @@ def __init__(self, pkg, **kwargs):
         self.version = pkg.fullver
         self._attr = "version"
 
+        if self.__class__.__name__ in getattr(pkg, "skipped_results", ()):
+            self._filtered = True
+
     @klass.jit_attr
     def ver_rev(self):
         version, _, revision = self.version.partition("-r")

src/pkgcheck/sources.py

@@ -292,13 +292,21 @@ def itermatch(self, restrict, **kwargs):
 class _SourcePkg(WrappedPkg):
     """Package object with file contents injected as an attribute."""
 
-    __slots__ = ("lines",)
+    __slots__ = ("lines", "skipped_results")
 
     def __init__(self, pkg):
         super().__init__(pkg)
         with pkg.ebuild.text_fileobj() as fileobj:
             self.lines = tuple(fileobj)
 
+            skipped_results: set[str] = set()
+            for line in map(str.rstrip, self.lines):
+                if line and not line.startswith("#"):
+                    break  # stop after first non-comment non-empty line
+                elif line.startswith("# pkgcheck skip:"):
+                    skipped_results.add(line[16:].strip())
+            self.skipped_results = frozenset(skipped_results)
+
 
 class EbuildFileRepoSource(RepoSource):
     """Ebuild repository source yielding package objects and their file contents."""
@@ -311,6 +319,17 @@ def itermatch(self, restrict, **kwargs):
 class _ParsedPkg(ParseTree, WrappedPkg):
     """Parsed package object."""
 
+    def __init__(self, data: bytes, **kwargs):
+        super().__init__(data, **kwargs)
+
+        skipped_results: set[str] = set()
+        for line in data.splitlines():
+            if line and not line.startswith(b"#"):
+                break  # stop after first non-comment non-empty line
+            elif line.startswith(b"# pkgcheck skip:"):
+                skipped_results.add(line[16:].strip().decode("utf8"))
+        self.skipped_results = frozenset(skipped_results)
+
 
 class EbuildParseRepoSource(RepoSource):
     """Ebuild repository source yielding parsed packages."""