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