atmpt

Pronounced attempt, Atmpt is a simple CLI program which lets you quickly create a temporary project and open it in your chosen $VISUAL environment variable.

This makes testing some quick lines of code easy without having to open a new replit or creating a new project with boilerplate yourself.

Showcase

($VISUAL variable set to nvim for Neovim)

Running

After installing, you may run

atmpt <TEMPLATE>

where <TEMPLATE> is the name of the folder in atmpt's data directory which you would like to clone. For example, if you have a cpp template for C++, you would run

atmpt cpp

Afterwards, whatever you have set as your $VISUAL environment variable will be run in the new directory.

Building

(Currently the only installation method)

Ensure you have Rust installed. After cloning this repo, cd into it and install by running:

cargo install --path .

This should place the atmpt binary in $HOME/.cargo/bin, but you will not have any templates to use. You may either create them in atmpt's data directory (along with the directory itself if it does not exist already), or you could use the default ones included in this repo (example given for Unix-based systems like Linux and MacOS):

mkdir -p $(atmpt --list-template-dir)
cp -r templates/* $(atmpt --list-template-dir)

Additionally, autocompletion files for several shells are created in a new completions directory (inside target). These should be placed in your respective shell's autocompletion directory, for example, zsh reads completion files from any directory in your $fpath environment variable.

Data Directory

Many times above you may have seen talk about a data directory, this is where your templates should be stored, but is dependent on the OS. Therefore, Atmpt offers an option to print it out on your system (you may have seen its output be used in the installing section):

atmpt --list-template-dir

(The option could be shortened to -d)

In the printed directory you may put folders for atmpt to clone as temporary projects when run with their name as input.

License