def gather_flags_info(
cpvs=None,
system_flags=None,
include_unset=False,
target="USE",
use_portage=False,
# override-able for testing
_get_flags=get_flags,
_get_used=get_installed_use
):
"""Analyze the installed pkgs USE flags for frequency of use
@type cpvs: list
@param cpvs: optional list of [cat/pkg-ver,...] to analyze or
defaults to entire installed pkg db
@type: system_flags: list
@param system_flags: the current default USE flags as defined
by portage.settings["USE"].split()
@type include_unset: bool
@param include_unset: controls the inclusion of unset USE flags in the report.
@type target: string
@param target: the environment variable being analyzed
one of ["USE", "PKGUSE"]
@type _get_flags: function
@param _get_flags: ovride-able for testing,
defaults to gentoolkit.enalyze.lib.get_flags
@param _get_used: ovride-able for testing,
defaults to gentoolkit.enalyze.lib.get_installed_use
@rtype dict. {flag:{"+":[cat/pkg-ver,...], "-":[cat/pkg-ver,...], "unset":[]}
"""
if cpvs is None:
cpvs = portage.db[portage.root]["vartree"].dbapi.cpv_all()
# pass them in to override for tests
flags = FlagAnalyzer(system_flags,
filter_defaults=False,
target=target,
_get_flags=_get_flags,
_get_used=get_installed_use
)
flag_users = {}
for cpv in cpvs:
if cpv.startswith("virtual"):
continue
if use_portage:
plus, minus, unset = flags.analyse_cpv(cpv)
else:
pkg = Package(cpv)
plus, minus, unset = flags.analyse_pkg(pkg)
for flag in plus:
if flag in flag_users:
flag_users[flag]["+"].append(cpv)
else:
flag_users[flag] = {"+": [cpv], "-": []}
for flag in minus:
if flag in flag_users:
flag_users[flag]["-"].append(cpv)
else:
flag_users[flag] = {"+":[], "-": [cpv]}
if include_unset:
for flag in unset:
if flag in flag_users:
if "unset" in flag_users[flag]:
flag_users[flag]["unset"].append(cpv)
else:
flag_users[flag]["unset"] = [cpv]
else:
flag_users[flag] = {"+": [], "-": [], "unset": [cpv]}
return flag_users
def gather_flags_info(
cpvs=None,
system_flags=None,
include_unset=False,
target="USE",
use_portage=False,
# override-able for testing
_get_flags=get_flags,
_get_used=get_installed_use,
):
"""Analyze the installed pkgs USE flags for frequency of use
@type cpvs: list
@param cpvs: optional list of [cat/pkg-ver,...] to analyze or
defaults to entire installed pkg db
@type: system_flags: list
@param system_flags: the current default USE flags as defined
by portage.settings["USE"].split()
@type include_unset: bool
@param include_unset: controls the inclusion of unset USE flags in the report.
@type target: string
@param target: the environment variable being analyzed
one of ["USE", "PKGUSE"]
@type _get_flags: function
@param _get_flags: ovride-able for testing,
defaults to gentoolkit.enalyze.lib.get_flags
@param _get_used: ovride-able for testing,
defaults to gentoolkit.enalyze.lib.get_installed_use
@rtype dict. {flag:{"+":[cat/pkg-ver,...], "-":[cat/pkg-ver,...], "unset":[]}
"""
if cpvs is None:
cpvs = portage.db[portage.root]["vartree"].dbapi.cpv_all()
# pass them in to override for tests
flags = FlagAnalyzer(
system_flags, filter_defaults=False, target=target, _get_flags=_get_flags, _get_used=get_installed_use
)
flag_users = {}
for cpv in cpvs:
if cpv.startswith("virtual"):
continue
if use_portage:
plus, minus, unset = flags.analyse_cpv(cpv)
else:
pkg = Package(cpv)
plus, minus, unset = flags.analyse_pkg(pkg)
for flag in plus:
if flag in flag_users:
flag_users[flag]["+"].append(cpv)
else:
flag_users[flag] = {"+": [cpv], "-": []}
for flag in minus:
if flag in flag_users:
flag_users[flag]["-"].append(cpv)
else:
flag_users[flag] = {"+": [], "-": [cpv]}
if include_unset:
for flag in unset:
if flag in flag_users:
if "unset" in flag_users[flag]:
flag_users[flag]["unset"].append(cpv)
else:
flag_users[flag]["unset"] = [cpv]
else:
flag_users[flag] = {"+": [], "-": [], "unset": [cpv]}
return flag_users
