#script #tree #command #keeper #directory #orun

bin+lib otkeep

Command line tools for managing out of tree scripts

1 unstable release

0.1.0 Jun 13, 2022

#2070 in Database interfaces

MIT/Apache

30KB
724 lines

OtKeep - Out of tree keeper

OtKeep is a tool that helps you manage out of tree scripts for different projects.

What problem does it solve?

OtKeep stores all your out of tree scripts in its database, letting you use them conveniently, just as easily as if you had them in-tree.

What are out of tree scripts? They are personal scripts you make for a project that you don't want to commit. Here are some examples:

  • Running a project in very specific configurations

    Setting different arguments, environment variables, etc. You want to put this into a script so you don't have to remember and type all of this stuff up every time.

  • Building a project in very specific configurations

    e.g. invoking cmake with the i686-pc-windows-gnu cross-compiler, while also cross-compiling all the dependencies, and pointing to all the cross-compiled libraries on your system.

  • Packaging up a project for your friends to try out

    This might involve cross-compiling to their OS, copying over .dll files and assets, then zipping it all up

  • Etc.

    I'm sure you can figure out more use cases. I use them a lot for personal convenience. I'm not here to sell the idea of out of tree scripts, I'm here to sell the idea of a tool that manages them.

You don't want to commit these kinds of scripts into a repository, because they are highly specific to you.

What about just adding them to .gitignore or such? The problem with that is that they can be easily destroyed by a git clean -dfx, or reclone of the repository. And they still dirty up the working tree. They are not organized nicely.

Wouldn't it be nicer to store them in some kind of database in your user directory? This is exactly what OtKeep is for.

Needless to say, if you don't have to deal with out of tree scripts, then OtKeep is not for you.

Usage

OTKeep provides 2 tools, okeep for managing your scripts, and orun for running them.

Adding scripts

To add a script, use okeep add. For example, to add your windows cross-build script called build_win.sh, do okeep add build-win build_win.sh.

Running scripts

To run a script you added, be in the tree you added it to, and simply run orun with the script name as argument. For the aformentioned build-win example, you would run orun build-win. orun forwards all arguments to the script.

Listing scripts for the current tree

Simply run orun without any arguments. It will list the scripts available for the current tree.

Dependencies

~24MB
~462K SLoC