Spring Shell helps you to create Spring-powered, production-grade applications targeting CLI space. It takes an opinionated view of the Spring platform so that new and existing users can quickly get to the bits they need.
You can use Spring Shell to create stand-alone Java applications that can be started using java -jar or more sophisticated GraalVM native ways to create platform dependant apps.
Our primary goals are:
-
Provide a radically faster and widely accessible getting started experience for shell development.
-
Be opinionated, but get out of the way quickly as requirements start to diverge from the defaults.
Here is a quick teaser of a complete Spring Shell application in Java:
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.shell.standard.ShellComponent;
import org.springframework.shell.standard.ShellMethod;
@SpringBootApplication
@ShellComponent
public class DemoApplication {
@ShellMethod
public String hi() {
return "hi";
}
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
Running it as jar interactive:
$ java -jar demo.jar
shell:>help
AVAILABLE COMMANDS
Built-In Commands
help: Display help about available commands
stacktrace: Display the full stacktrace of the last error.
clear: Clear the shell screen.
quit, exit: Exit the shell.
history: Display or save the history of previously run commands
version: Show version info
script: Read and execute commands from a file.
Demo Application
hi:
shell:>hi
hi
Running it as jar non-interactive:
$ java -jar demo.jar hi
hi
Are you having trouble with Spring Shell? We want to help!
-
Join our GitHub Discussion section and post your question there.
Spring Shell uses GitHubβs integrated issue tracking system to record bugs and feature requests. If you want to raise an issue, please follow the recommendations below:
-
Before you log a bug, please search the {github}/issues[issue tracker] to see if someone has already reported the problem.
-
If the issue doesnβt already exist, {github}/issues/new[create a new issue].
-
Please provide as much information as possible with the issue report. We like to know the Spring Boot and Shell version, operating system, and JVM version youβre using.
-
If you need to paste code or include a stack trace, use Markdown. ``` escapes before and after your text.
-
If possible, try to create a test case or project that replicates the problem and attach it to the issue.
Active development branch is main
targeting work for 3.2.x
. 3.1.x
, 3.0.x
and 2.1.x
are for maintaining current active releases.
Building and running tests:
./gradlew build
Publishing to local maven cache:
./gradlew publishToMavenLocal
Samples contains various examples how to use spring-shell
.
./gradlew :spring-shell-samples:spring-shell-sample-catalog:build -x test
./gradlew :spring-shell-samples:spring-shell-sample-commands:build -x test
./gradlew :spring-shell-samples:spring-shell-sample-e2e:build -x test
Native build can be enabled using property -PspringShellSampleNative=true
. On linux a musl
can be activated with -PspringShellSampleMusl=true
. Note that musl needs to be properly configured in the environment.
Spring Shell is Open Source software released under the Apache 2.0 license.