#compiled-language #script #script-file #build #scripting-language #cache #preprocessor

build scriptisto

A language-agnostic "shebang interpreter" that enables you to write scripts in compiled languages

59 releases (6 stable)

2.2.0 Jun 8, 2024
2.1.1 Apr 10, 2023
2.0.1 Jan 19, 2023
1.0.0 Dec 9, 2022
0.6.2 Nov 24, 2019

#43 in Build Utils

Download history 111/week @ 2024-09-22 16/week @ 2024-09-29 4/week @ 2024-10-06 1/week @ 2024-10-13

3,317 downloads per month

Apache-2.0

69KB
1.5K SLoC

Rust 1K SLoC // 0.1% comments OCaml 37 SLoC // 0.4% comments Python 25 SLoC // 0.5% comments Dart 24 SLoC // 0.2% comments C 16 SLoC // 0.5% comments Java 11 SLoC // 0.6% comments Puppet 8 SLoC C++ 8 SLoC // 0.3% comments JavaScript 8 SLoC // 0.6% comments C# 7 SLoC // 0.7% comments Go 6 SLoC // 0.7% comments COBOL 6 SLoC // 0.5% comments FORTRAN Modern 5 SLoC // 0.4% comments Elixir 5 SLoC // 0.8% comments Zig 5 SLoC // 0.4% comments Common Lisp 3 SLoC // 0.8% comments TypeScript 3 SLoC // 0.7% comments Racket 3 SLoC // 0.7% comments Haskell 2 SLoC // 0.7% comments Scheme 2 SLoC // 0.7% comments Crystal 1 SLoC // 0.9% comments

Scriptisto

Latest Version Build Status Crates.io License Libraries.io dependency status for latest release GitHub top language

Crates.io GitHub All Releases

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, scriptisto rebuilds it and caches the result. If a script was already built, scriptisto immediately delegates to a binary with only <1 ms overhead.

Builds in Docker are available.

Advantages and use-cases are listed in the Wiki.

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 ./script
// 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

Note: some templates such as rust take more time to build during the first time. The default behaviour is to supress the build logs, so do not be discouraged that you do not immediately see any output. More info in the wiki.

Installation

Scriptisto is available as a prebuilt statically-linked standalone binary or distributions packages at Releases or at Crates.io.

Please proceed to the Installation for instructions.

Documentation

Proceed to our Wiki.

Disclaimer

This is not an officially supported Google product.

Dependencies

~6–14MB
~155K SLoC