history#

Tools interfacing with conda's history file.

Classes#

History

Functions#

write_head(fo)

is_diff(content)

pretty_diff(diff)

pretty_content(content)

Attributes#

h

exception CondaHistoryWarning#

Bases: Warning

Base class for warning categories.

write_head(fo)#
is_diff(content)#
pretty_diff(diff)#
pretty_content(content)#
class History(prefix)#
com_pat#
spec_pat#
conda_v_pat#
__enter__()#
__exit__(exc_type, exc_value, traceback)#
init_log_file()#
file_is_empty()#
update() → None#

Update the history file (creating a new one if necessary).

parse() → list[tuple[str, set[str], list[str]]]#

Parse the history file.

Return a list of tuples(datetime strings, set of distributions/diffs, comments).

static _parse_old_format_specs_string(specs_string)#

Parse specifications string that use conda<4.5 syntax.

Examples

  • "param >=1.5.1,<2.0'"

  • "python>=3.5.1,jupyter >=1.0.0,<2.0,matplotlib >=1.5.1,<2.0"

classmethod _parse_comment_line(line)#

Parse comment lines in the history file.

These lines can be of command type or action type.

Examples

  • "# cmd: /scratch/mc3/bin/conda install -c conda-forge param>=1.5.1,<2.0"

  • "# install specs: python>=3.5.1,jupyter >=1.0.0,<2.0,matplotlib >=1.5.1,<2.0"

get_user_requests()#

Return a list of user requested items.

Each item is a dict with the following keys: 'date': the date and time running the command 'cmd': a list of argv of the actual command which was run 'action': install/remove/update 'specs': the specs being used

get_requested_specs_map()#
construct_states()#

Return a list of tuples(datetime strings, set of distributions).

get_state(rev=-1)#

Return the state, i.e. the set of distributions, for a given revision.

Defaults to latest (which is the same as the current state when the log file is up-to-date).

Returns a list of dist_strs.

print_log()#
object_log()#
write_changes(last_state, current_state)#
write_specs(remove_specs=(), update_specs=(), neutered_specs=())#
h#