Package _emerge

Displays a prompt and a set of responses, then waits for a response which is checked against the responses and the first to match is returned. An empty response will match the first value in responses. The input buffer is *not* cleared prior to the prompt!

prompt: a String. responses: a List of Strings. colours: a List of Functions taking and returning a String, used to process the responses for display. Typically these will be functions like red() but could be e.g. lambda x: "DisplayString". If responses is omitted, defaults to ["Yes", "No"], [green, red]. If only colours is omitted, defaults to [bold, ...].

Returns a member of the List responses. (If called without optional arguments, returns "Yes" or "No".) KeyboardInterrupt is converted to SystemExit to avoid tracebacks being printed.

Create a new atom for the world file if one does not exist. If the argument atom is precise enough to identify a specific slot then a slot atom will be returned. Atoms that are in the system set may also be stored in world since system atoms can only match one slot while world atoms can be greedy with respect to slots. Unslotted system packages will not be stored in world.

Check if a package is visible. This can raise an InvalidDependString exception if LICENSE is invalid. TODO: optionally generate a list of masking reasons

Returns: Boolean

True if the package is visible, False otherwise.

Test if it's possible to use poll() on a device such as a pty. This is known to fail on Darwin.

Returns: bool

True if poll() on a device succeeds, False otherwise.

Misc. things to run at the end of a merge session.

Update Info Files
Update Config Files
Update News Items
Commit mtimeDB
Display preserved libs warnings
Exit Emerge

@param trees: A dictionary mapping each ROOT to it's package databases
@type trees: dict
@param mtimedb: The mtimeDB to store data needed across merge invocations
@type mtimedb: MtimeDB class instance
@param retval: Emerge's return value
@type retval: Int
@rype: None
@returns:
1.  Calls sys.exit(retval)

Examines news items in repodir + '/' + NEWS_PATH and attempts to find unread items
Returns the number of unread (yet relevent) items.

@param portdb: a portage tree database
@type portdb: pordbapi
@param vardb: an installed package database
@type vardb: vardbapi
@param NEWS_PATH:
@type NEWS_PATH:
@param UNREAD_PATH:
@type UNREAD_PATH:
@param repo_id:
@type repo_id:
@rtype: Integer
@returns:
1.  The number of unread but relevant news items.

Construct a depgraph for the given resume list. This will raise PackageNotFound or depgraph.UnsatisfiedResumeDep when necessary.

Returns: tuple

(success, depgraph, dropped_tasks)

Parse optional arguments and insert a value if one has not been provided. This is done before feeding the args to the optparse parser since that parser does not support this feature natively.

actions

Value:

['clean', 'config', 'depclean', 'info', 'metadata', 'prune', 'regen', 'search', ...

options

Value:

['--ask', '--alphabetical', '--buildpkg', '--buildpkgonly', '--changelog', '--columns', '--complete-graph', '--debug', ...

shortmapping

Value:

{'1': '--oneshot', 'B': '--buildpkgonly', 'C': '--unmerge', 'D': '--deep', 'F': '--fetch-all-uri', 'G': '--getbinpkgonly', 'K': '--usepkgonly', 'N': '--newuse', ...