Scriptisto

This is not an officially supported Google product

It is tool to enable writing one file scripts in languages that require compilation, dependencies fetching or preprocessing.

It works as a "shebang" for those scripts, extracting build instructions from comments. If a script is changed, it rebuilds it and caches the result. If it was already built, it immediately delegates to a binary with only <1 ms overhead.

Also useful for non-compiled languages like Typed Python, but type validation is slow and a good idea to do it once after very change.

Demo

#!/usr/bin/env scriptisto

#include <stdio.h>
#include <glib.h>

// scriptisto-begin
// script_src: main.c
// build_cmd: clang -O2 main.c `pkg-config --libs --cflags glib-2.0` -o ./app 
// target_bin: @@@/app
// scriptisto-end

int main(int argc, char *argv[]) {
  gchar* user = g_getenv("USER");
  printf("Hello, C! Current user: %s\n", user);
  return 0;
}

$ chmod +x ./script.c
$ ./script.c
Hello, C! Current user: username

Installation

Install Rust, for example via https://rustup.rs/. Then install from Crates.io:

$ cargo install scriptisto

Or the latest from Github:

$ git clone https://github.com/igor-petruk/scriptisto.git
$ cd scriptisto
$ cargo install --path .

Creating scripts from templates

Try one of the script templates from one of the language available. To see the list:

$ scriptisto -g

Then generate your basic script:

$ scriptisto -g rust | tee ./rust-script
$ chmod +x ./rust-script
$ ./rust-script
Hello, Rust!

Contributing

See Contributing Guide.