Trace

class shell_logger.trace.Trace(**kwargs)[source]

Trace a command run in the underlying shell.

Provides an interface for the ShellLogger to run commands with a certain trace (e.g., strace or ltrace).

Initialize the Trace object.

Set up the output file where the trace information will be written.

command(command)[source]

Get the command to be run in the underlying shell.

Return a command that runs a trace on command. E.g., ls -l might get translated to strace -f -c -e 'open' -- ls -l.

static subclass(trace_subclass)[source]

Mark a class as being a supported trace collector.

This is a class decorator that adds to a list of supported Trace classes for the trace_collector() factory method.

subclasses = [<class 'shell_logger.trace.STrace'>, <class 'shell_logger.trace.LTrace'>]

abstract property trace_args: str

Get the trace command.

The trace command and the arguments you pass to it, but not the command you’re tracing. E.g., return strace -f -c -e “open”.

shell_logger.trace.trace_collector()[source]

Generate trace collectors.

A factory method that returns any subclass of Trace that has the @Trace.subclass decorator applied to it.

STrace

class shell_logger.trace.STrace(**kwargs)[source]

Run strace on commands.

An interface between ShellLogger and the strace command.

Initialize the STrace instance.

class shell_logger.trace.LTrace(**kwargs)[source]

Run ltrace on commands.

An interface between ShellLogger and the ltrace command.

Initialize the LTrace instance.