clank

A simple CLI that runs your C++ code just in time.

Built with Deno.

👾 Installation

$ deno install -Af -n "clank" https://deno.land/x/clank/mod.ts

Alternatively, you can download a binary from the releases page. The upgrade command doesn’t work in the standalone binary.

🔥 Usage

# Basic help text:
$ clank

# Run a C++ script:
$ clank hello.cpp

# See juicy debug info:
$ CLANK_DEBUG=1 clank hello.cpp

# Inspect the cache:
$ clank cache list

# Clear the cache:
$ clank cache clean

# Prune the cache (limit it to 0.5 GB):
$ clank cache prune

# Add autocompletion to your shell:
$ source <(clank completions bash)        # bash => ~/.bashrc
$ source (clank completions fish | psub)  # fish => ~/.config/fish/config.fish
$ source <(clank completions zsh)         # zsh  => ~/.zshrc

# Upgrade clank:
$ clank upgrade

🚀 Features

Passthrough stdin, stdout and stderr
Prints status code
A cache based on unique hashes of files
Smart deletion of cached files to keep cache size under 0.5 GB
Configure which compiler to use
Passing options directly to compilers
An incredibly convenient upgrade command
Shell autocompletion support
Looks great

🚧 Roadmap

Config file
Smarter deletion algo
Options to compiler
Configure which compiler to use
More tests

🧑‍💻 Development

The Velociraptor script runner is used for productivity.

# Build native binaries
$ vr build

# Install your local version of clank as `clank-dev`
$ vr install-dev

# Run tests
$ vr test