jbang-run(1)

Name

jbang-run - Builds and runs provided script.

Synopsis

jbang run -o [-hn] [--[no-]cds] [--ea] [--esa] --fresh [--insecure] [--interactive] [--jsh] --quiet --verbose [-d[=<debugString>]] [-r [=<flightRecorderString>]] [--catalog=<catalog>] [--config=<config>] [-j=<javaVersion>] [-m=<main>] [--cp=<classpaths>]…​ [-D=<String=String>]…​ [--deps=<dependencies>]…​ [--java-options=<javaRuntimeOptions>]…​ [--javaagent=<String=Optional>]…​ [--repos=<repositories>]…​ <scriptOrFile> [<userParams>…​]

Description

Builds and runs provided script.

Options

--catalog=<catalog>

Path to catalog file to be used instead of the default

--[no-]cds

If specified Class Data Sharing (CDS) will be used for building and running (requires Java 13+)

--config=<config>

Path to config file to be used instead of the default

--cp, --class-path=<classpaths>

Add class path entries.

-d, --debug[=<debugString>]

Launch with java debug enabled on specified port (default: null)

-D, <String=String>

set a system property

--deps=<dependencies>

Add additional dependencies (Use commas to separate them).

--ea, --enableassertions

Enable assertions

--esa, --enablesystemassertions

Enable system assertions

--fresh

Make sure we use fresh (i.e. non-cached) resources.

-h, --help

Display help/info. Use 'jbang <command> -h' for detailed usage.

--insecure

Enable insecure trust of all SSL certificates.

--interactive

activate interactive mode

-j, --java=<javaVersion>

JDK version to use for running the script.

--java-options=<javaRuntimeOptions>

A Java runtime option

--javaagent=<String=Optional>
--jsh

Force input to be interpreted with jsh/jshell

-m, --main=<main>

Main class to use when running. Used primarily for running jar’s.

-n, --native

Build using native-image

-o, --offline

Work offline. Fail-fast if dependencies are missing. No connections will be attempted

--quiet

jbang will be quiet, only print when error occurs.

-r, --jfr[=<flightRecorderString>]

Launch with Java Flight Recorder enabled.

--repos=<repositories>

Add additional repositories.

--verbose

jbang will be verbose on what it does.

Arguments

<scriptOrFile>

A file with java code or if named .jsh will be run with jshell

[<userParams>…​]

Parameters to pass on to the script