cmd-interceptor

A tool to intercept calls to your command line tools and alter their args.

Requires UNIX and working Python3 and whereis.

Installation

Since the interceptor PyPI package name is taken, you ought to install interceptor the following way:

pip install cmd-interceptor

Or, if you don't have pip:

git clone https://github.com/Dronehub/interceptor.git
cd interceptor
python setup.py install

Usage

Prepare the configuration

To override g++ put a JSON file at /etc/interceptor.d/g++

with the following contents:

{
  "args_to_disable": ["-quiet"],
  "args_to_append": ["-DDEBUG"]],
  "args_to_prepend": ["-v"],
  "args_to_replace": [["-march=native", "-mcpu=native"]],
  "display_before_start": true,
  "notify_about_actions": false
}

Configuring

If the intercepted command sees any arguments given in args_to_disable they will be removed before being passed to target command.

You give two-item lists in args_to_replace. If the first item occurs in arguments, it will be replaced by the second item.

If arguments in args_to_append are not in arguments, they will be appended to the arguments.

The arguments in args_to_append will be appended in the order they are listed.

If arguments in args_to_prepend are not in arguments, they will be prepended to arguments.

The arguments in args_to_prepend will be appended in the order they are listed.

If you don't prepare the configuration file in advance, an empty file will be created for you.

If display_before_start is set, then before the launch the application name and parameters actually passed to it will be displayed on stdout.

If notify_about_actions is set, then interceptor will print out each case an action is attempted.

The intercept command

The intercept command is the basic command used to interface with interceptor.

Intercepting tools

Say, to intercept the command foo invoke:

intercept foo

Note that foo's executable must be discoverable by whereis. There should be ideally a single executable file, otherwise interceptor will patch all of them. Interceptor should display the following:

Successfully intercepted foo

Note that you will be unable to proceed if foo is already an interceptor wrapper.

A Python wrapper will be found at previous location of foo, while it itself will be copied to the same directory but named foo-intercepted. The wrapper will hold the name of foo inside, so you can symlink it safely (eg. symlink of g++ to c++).

To cancel intercepting foo type:

intercept undo foo

To check whether foo is being intercepted type:

intercept status foo

This will additionally validate and reformat it's configuration file. This will return information about whether it's config is a symlink, or whether the tool is partially patched (ie. there are executables reachable within PATH that haven't been patched). To rectify this issue just type

intercept foo --force

Any call of intercept with a single argument (and optional switch) will be treated as order to intercept this command, so if you're trying to intercept, say show you just type:

intercept show

To provide configuration for foo type

intercept configure foo```

And type in the configuration in JSON format, followed by Ctrl+D.

To display current configuration for foo type:

intercept show foo

To have intercept display when the tool is called type:

intercept display foo

To hide the display type:

intercept hide foo

To have nano/vi run to edit your config file type:

intercept edit foo

To add an argument to be appended to the command type:

intercept append foo arg

To add an argument to be prepended to the command type:

intercept prepend foo arg

To add an argument to be eliminated if foo is called with it type:

intercept disable foo arg

To replace arg1 with arg2 each time foo is called type:

intercept replace foo arg1 arg2

To have intercept display when an action is taken type:

intercept notify foo

To hide the notifications type:

intercept unnotify foo

To symlink bar's configuration to that of foo type:

intercept link foo bar

To copy foo's configuration to that of bar type:

intercept copy foo bar

Note that intercept will refuse to link to foo if foo is already a symlink. To circumvent that type:

intercept link foo bar --force

To toggle argument deduplication (only unique arguments will be passed) type:

intercept enable-deduplication foo  # enable it
intercept disable-deduplication foo  # disable it

To append all calls to this instruction into /var/log/inteceptor.d/instruction_name:

intercept log foo # enable it
intercept unlog foo # disable it

To backup a configuration of foo:

intercept backup foo
intercept restore foo <save_number>

intercept backup will tell you the save number.

To reset configuration of foo, type

intercept reset foo

This will tell you if foo's configuration was a symlink. Note that this will unlink foo is it is already a symlink.

Note that many of the aforementioned commands check first to see it foo is intercepted. You can pass --force to skip that check.

If you mean to pass --force as an argument, and not as a switch, interceptor will treat only the first --force found as a switch and remove it from further command processing. Rethink your naming of commands in that case.