pinspect - repository inspection interface

Synopsis

pinspect [-h] [–version] [–debug] [-q] [-v] [–color BOOLEAN] [–config CONFIG_PATH] {pkgsets,eapi_usage,license_usage,eclass_usage,mirror_usage,distfiles_usage,query,portageq,profile,digests} …

Base Options

-h, --help

show this help message and exit

--version

show this program’s version info and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

Config Options

--config CONFIG_PATH

use custom config or skip loading system config

Subcommands

report applets

pinspect eapi_usage - report of eapi usage for targeted repos

Synopsis

pinspect eapi_usage [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–no-final-summary] [–sort-by-name] [–first FIRST | –last LAST] [repo …]

Positional Arguments

repo

repo(s) to inspect

Options

--no-final-summary

disable outputting a summary of data across all repos

--sort-by-name

sort output by name, rather then by frequency

--first FIRST

show only the first N detail items

--last LAST

show only the last N detail items

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect license_usage - report of license usage for targeted repos

Synopsis

pinspect license_usage [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–no-final-summary] [–sort-by-name] [–first FIRST | –last LAST] [repo …]

Positional Arguments

repo

repo(s) to inspect

Options

--no-final-summary

disable outputting a summary of data across all repos

--sort-by-name

sort output by name, rather then by frequency

--first FIRST

show only the first N detail items

--last LAST

show only the last N detail items

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect eclass_usage - report of eclass usage for targeted repos

Synopsis

pinspect eclass_usage [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–no-final-summary] [–sort-by-name] [–first FIRST | –last LAST] [repo …]

Positional Arguments

repo

repo(s) to inspect

Options

--no-final-summary

disable outputting a summary of data across all repos

--sort-by-name

sort output by name, rather then by frequency

--first FIRST

show only the first N detail items

--last LAST

show only the last N detail items

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect mirror_usage - report of SRC_URI mirror usage for targeted repos

Synopsis

pinspect mirror_usage [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–no-final-summary] [–sort-by-name] [–first FIRST | –last LAST] [repo …]

Positional Arguments

repo

repo(s) to inspect

Options

--no-final-summary

disable outputting a summary of data across all repos

--sort-by-name

sort output by name, rather then by frequency

--first FIRST

show only the first N detail items

--last LAST

show only the last N detail items

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect distfiles_usage - report detailing distfiles space usage for targeted repos

Synopsis

pinspect distfiles_usage [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–no-final-summary | –no-repo-summary | –no-detail] [–sort-by-name] [–first FIRST | –last LAST] [–include-nonmirrored] [–include-restricted] [repo …]

Positional Arguments

repo

repo(s) to inspect

Options

--no-final-summary

disable outputting a summary of data across all repos

--no-repo-summary

disable outputting repo summaries

--no-detail

disable outputting a detail view of all repos

--sort-by-name

sort output by name, rather then by frequency

--first FIRST

show only the first N detail items

--last LAST

show only the last N detail items

--include-nonmirrored

if set, nonmirrored distfiles will be included in the total

--include-restricted

if set, fetch restricted distfiles will be included in the total

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect query - auxiliary access to ebuild/repo info via portageq akin api

Synopsis

pinspect query [-h] [–debug] [-q] [-v] [–color BOOLEAN] {best_version,env_var,get_profiles,get_repo_path,get_repos,has_version,mass_best_version} …

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

Subcommands

query commands

pinspect query best_version - Return the maximum visible version for a given atom.
Synopsis

pinspect query best_version [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] [–domain DOMAIN | –domain-at-root DOMAIN] atom

Positional Arguments
atom

atom to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

--domain DOMAIN

custom pkgcore domain to use for this operation

--domain-at-root DOMAIN

specify the domain to use via its root path

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect query env_var - return configuration defined variables.
Synopsis

pinspect query env_var [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] [–domain DOMAIN | –domain-at-root DOMAIN] variable [variable …]

Positional Arguments
variable

variable to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

--domain DOMAIN

custom pkgcore domain to use for this operation

--domain-at-root DOMAIN

specify the domain to use via its root path

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect query get_profiles
Synopsis

pinspect query get_profiles [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] [–domain DOMAIN | –domain-at-root DOMAIN] repo_id

Positional Arguments
repo_id

repo_id to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

--domain DOMAIN

custom pkgcore domain to use for this operation

--domain-at-root DOMAIN

specify the domain to use via its root path

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect query get_repo_path
Synopsis

pinspect query get_repo_path [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] [–domain DOMAIN | –domain-at-root DOMAIN] repo_id

Positional Arguments
repo_id

repo_id to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

--domain DOMAIN

custom pkgcore domain to use for this operation

--domain-at-root DOMAIN

specify the domain to use via its root path

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect query get_repos
Synopsis

pinspect query get_repos [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] [–domain DOMAIN | –domain-at-root DOMAIN]

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

--domain DOMAIN

custom pkgcore domain to use for this operation

--domain-at-root DOMAIN

specify the domain to use via its root path

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect query has_version - Return 0 if an atom is merged, 1 if not.
Synopsis

pinspect query has_version [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] [–domain DOMAIN | –domain-at-root DOMAIN] atom

Positional Arguments
atom

atom to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

--domain DOMAIN

custom pkgcore domain to use for this operation

--domain-at-root DOMAIN

specify the domain to use via its root path

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect query mass_best_version - multiple best_version calls.
Synopsis

pinspect query mass_best_version [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] [–domain DOMAIN | –domain-at-root DOMAIN] atom [atom …]

Positional Arguments
atom

atom to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

--domain DOMAIN

custom pkgcore domain to use for this operation

--domain-at-root DOMAIN

specify the domain to use via its root path

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect portageq - portageq compatible interface to query commands

Synopsis

pinspect portageq [-h] [–debug] [-q] [-v] [–color BOOLEAN] {best_version,envvar,envvar2,get_repo_news_path,get_repo_path,get_repos,has_version,mass_best_version,match} …

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

Subcommands

portageq commands

pinspect portageq best_version - Return the maximum visible version for a given atom.
Synopsis

pinspect portageq best_version [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] root atom

Positional Arguments
root

the domain that lives at root will be used

atom

atom to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect portageq envvar - return configuration defined variables. Use envvar2 instead, this will be removed.
Synopsis

pinspect portageq envvar [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] [root] variable [variable …]

Positional Arguments
root

the domain that lives at root will be used

variable

variable to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect portageq envvar2 - return configuration defined variables.
Synopsis

pinspect portageq envvar2 [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] root variable [variable …]

Positional Arguments
root

the domain that lives at root will be used

variable

variable to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect portageq get_repo_news_path
Synopsis

pinspect portageq get_repo_news_path [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] root repo_id

Positional Arguments
root

the domain that lives at root will be used

repo_id

repo_id to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect portageq get_repo_path
Synopsis

pinspect portageq get_repo_path [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] root repo_id

Positional Arguments
root

the domain that lives at root will be used

repo_id

repo_id to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect portageq get_repos
Synopsis

pinspect portageq get_repos [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] [root]

Positional Arguments
root

the domain that lives at root will be used

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect portageq has_version - Return 0 if an atom is merged, 1 if not.
Synopsis

pinspect portageq has_version [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] root atom

Positional Arguments
root

the domain that lives at root will be used

atom

atom to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect portageq mass_best_version - multiple best_version calls.
Synopsis

pinspect portageq mass_best_version [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] root atom [atom …]

Positional Arguments
root

the domain that lives at root will be used

atom

atom to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect portageq match - shorthand for pquery –installed
Synopsis

pinspect portageq match [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–eapi ATOM_KLS] [–use USE] root atom

Positional Arguments
root

the domain that lives at root will be used

atom

atom to inspect

Options
--eapi ATOM_KLS

limit all operations to just what the given EAPI supports.

--use USE

override the use flags used for transititive USE deps- dev-lang/python[threads=] for example

Base Options
-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pinspect digests - identify what packages are missing digest info

Synopsis

pinspect digests [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–domain DOMAIN] [repos …]

Positional Arguments

repos

repo to inspect

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

Config Options

--domain DOMAIN

custom pkgcore domain to use for this operation