xcp-tool

Command line tool for cutting, copying, and pasting files.


License
MIT
Install
pip install xcp-tool==0.1.1

Documentation

xcp

A command line tool to cut, copy, and paste files.

Installation

To get the xcp command, install using pip. Only Python >=3.5 is supported.

pip install xcp-tool

Usage

usage: xcp <command> <args>

commands:
  x|cut   <file>  Move the file into the clipboard. The file is removed from
                  its current location.
  c|copy  <file>  Copy the file into the clipboard. The file also remains in
                  its current location.
  p|paste [name]  Copy the file currently in the clipboard to the current
                  working directory. Optionally rename the file.
  peek            Print the name of the file in the clipboard.
  clean           Clear the clipboard.
  help            Print this message.

Configuration

xcp allows the user to configure certain properties:

root_dir:    string   Directory to use for clipboard.
max_entries: int > 0  Number of most recent entries to keep backed up.
verbose:     bool     Set to true for verbose output.

These can be set in a yaml file at either ~/.config/xcp/config.yaml or a file path set by the environment variable XCP_CONFIG_PATH (the latter is given priority, if the variable is set).

Aliases

I actually like to make cp and mv perform xcp's copy and cut operations, respectively, when only a single file is passed to them. I also create a function pst to paste. A script xcp.sh located in the sh directory provides this functionality when sourced. It should work with both bash and zsh.

Development

Testing is done using pytest. Simply run pytest . in the tests/ directory.

License

MIT