jorgenbele / cmdcache

Simple command line utility to cache results of command line programs.

cmdcache

Simple command line utility to cache command line programs.

Usage

Usage: cmdcache [OPTIONS] <COMMAND> [COMMAND_ARGS]...

Arguments:
  <COMMAND>
  [COMMAND_ARGS]...

Options:
      --cache-seconds <CACHE_SECONDS>
  -c, --cache-duration <CACHE_DURATION>  [default: 1min]
      --cache-failures
  -v, --verbose
      --clear
      --clear-all
  -h, --help                             Print help information
  -V, --version                          Print version information

Why

Shell scripts can often be executed many times in rapid succession. Sometimes some part of the script needs to do an expensive operation (such as database access, network communication, etc) but we don't need the result to be updated every time. cmdcache let you easily cache results of invokations without manually dealing with caching in the script.

How it works

cmdcache saves both the stdout and stderr output of a command every time it is executed. It checks whether the time since the last execution is less than --cache-seconds, and uses the existing output if it is too recent.

Examples

Caching of database query

$ cmdcache -c 1hrs psql -f costly_db_query.sql

Cache result of expensive command

$ cmdcache -c 1days -- du ~/