pkgcheck scan: add initial latest pkgs filter support to -f/--filter

Fixes #184.

Author: radhermit

src/pkgcheck/scripts/pkgcheck.py

@@ -136,11 +136,17 @@ def __call__(self, parser, namespace, values, option_string=None):
     action=commandline.StoreRepoObject, repo_type='ebuild-raw', allow_external_repos=True,
     help='repo to pull packages from')
 main_options.add_argument(
-    '-f', '--filter', choices=('repo',),
-    help="enable all license and visibility filtering for packages",
+    '-f', '--filter', choices=('latest', 'repo',),
+    help='limit targeted packages for scanning',
     docs="""
-        Enable all package filtering mechanisms such as ACCEPT_KEYWORDS,
-        ACCEPT_LICENSE, and package.mask.
+        Support limiting targeted packages for scanning using a chosen filter.
+
+        If the 'repo' argument is used, all package visibility mechanisms used
+        by the package manager when resolving package dependencies such as
+        ACCEPT_KEYWORDS, ACCEPT_LICENSE, and package.mask will be enabled.
+
+        If the 'latest' argument is used, only the latest package per slot of
+        both VCS and non-VCS types will be scanned.
     """)
 main_options.add_argument(
     '--sorted', action='store_true',
@@ -514,6 +520,11 @@ def restrictions():
     namespace.enabled_checks = [
         c for c in namespace.enabled_checks if not c.skip(namespace)]
 
+    # only run version scope checks when using a package filter
+    if namespace.filter in ('latest',):
+        namespace.enabled_checks = [
+            c for c in namespace.enabled_checks if c.scope == base.version_scope]
+
     if not namespace.enabled_checks:
         parser.error('no active checks')
 

src/pkgcheck/sources.py

@@ -46,7 +46,11 @@ def source(self):
     def itermatch(self, restrict, **kwargs):
         """Yield packages matching the given restriction from the selected source."""
         kwargs.setdefault('sorter', sorted)
-        yield from self.source.itermatch(restrict, **kwargs)
+        unfiltered_iter = self.source.itermatch(restrict, **kwargs)
+        if self._options.filter == 'latest':
+            yield from LatestPkgsFilter(unfiltered_iter)
+        else:
+            yield from unfiltered_iter
 
 
 class EmptySource(Source):
@@ -153,10 +157,13 @@ class RawRepoSource(RepoSource):
 
     def __init__(self, *args):
         super().__init__(*args)
-        self._repo = _RawRepo(self._repo)
 
     def itermatch(self, restrict, **kwargs):
-        yield from super().itermatch(restrict, raw_pkg_cls=RawCPV, **kwargs)
+        if self._options.filter == 'latest':
+            yield from LatestPkgsFilter(super().itermatch(restrict, **kwargs))
+        else:
+            self._repo = _RawRepo(self._repo)
+            yield from super().itermatch(restrict, raw_pkg_cls=RawCPV, **kwargs)
 
 
 class RestrictionRepoSource(RepoSource):