compilescript/compilescript.1.adoc

compilescript(1)

NAME

compilescript - allows you to execute files from compiled languages as scripts.

SYNOPSIS

compilescript [file|--cleanup] [arguments]

DESCRIPTION

compilescript allows you to execute files from compiled languages as scripts. By default it uses g++.

It compiles the source file, stores the binary in ${XDG_CACHE_HOME}/compilescript/ and executes it. If the binary in cache is newer than the source file, the compilation is skipped.

Use #!/usr/bin/env compilescript as shebang and write the compiler arguments in the second line with the prefix: //compilescript:.

The configuration file is in ${XDG_CONFIG_HOME}/compilescript.cfg. It will be generated on first run.

OPTIONS

--cleanup

Delete old cache files (older than clean_after_hours).

EXAMPLES

Example script

#!/usr/bin/env compilescript
//compilescript: -Wall -pedantic -Wextra

#include <iostream>

using std::cout;

int main(int argc, char *argv[])
{
    cout << "Hello world!\n";
    cout << argv[1] << '\n';
}

Example config

compiler = "g++";
clean_after_hours = 720;
cache_dir = "/home/user/.cache/compilescript";

FILES

Configuration file:	${XDG_CONFIG_HOME}/compilescript.cfg
Cache:	${XDG_CACHE_HOME}/compilescript/

${XDG_CONFIG_HOME} is usually ~/.config and ${XDG_CACHE_HOME} is usually ~/.cache

REPORTING BUGS

Bugtracker: https://schlomp.space/tastytea/compilescript/issues

E-mail: tastytea@tastytea.de