3.0.0-M1

Generic Notes

Fixes

This milestone contains some notable changes:

• Using Spring Boot 3.x
• Support for GraalVM mostly complete
• Project is now build with gradle

Issues

#540 Upgrade native-build-tools 0.9.14
#535 Fix release workflows for gradle
#529 Improve JPMS support by adding Automatic-Module-Name
#527 Docs changes
#526 Prevent ExtendedDefaultParser warning
#525 Add starter for jansi
#524 Move starter modules under starters
#523 Upgrade spring-boot 3.0.0-M5
#521 Could not find org.springframework.shell:spring-shell-management:3.0.0-SNAPSHOT.
#510 next does not work as expected in ComponentFlow
#506 Upgrade gradle 7.5.1
#504 Split builtin command docs
#495 Incorrect completion for options
#493 Spring shell is defaulting to the base Jakarta validator
#490 Provide needed aot configs
#486 Build publish broken
#470 Switch to gradle
#385 Rework for boot 3.x

PRs

#520 Docs correctness!

2.1.2

Generic Notes

Fixes

This GA contains some notable changes:

• Builds on Spring Boot 2.7.4
• Some bug fixes backported

Issues

#538 Upgrade spring-boot 2.7.4
#513 backport(510) next does not work as expected in ComponentFlow

2.1.1

Generic Notes

Fixes

This GA contains some notable changes:

• Builds on Spring Boot 2.7.3
• Some bug fixes backported

Issues

#505 backport(504) Split builtin command docs
#500 Upgrade spring-boot 2.7.3
#498 backport(495) Incorrect completion for options
#496 backport(493) Spring shell is defaulting to the base Jakarta validator

2.1.0

Generic Notes

Fixes

This GA contains some notable changes:

• Builds on Spring Boot 2.7.2
• Some styling changes
• Help commands now knows about aliases
• MultiItemSelector component can now have items selected on default
• Some fixes on @ShellOption

Issues

#480 Add commands as list in help templating
#477 Upgrade to Spring Boot 2.7.2
#476 Component styling bad for black on white
#461 ShellOption booleans are now mandatory in 2.1.0-RC1
#458 Help should group commands with aliases
#454 Create GA release workflow
#446 Missing option error without ShellOption
#426 Add aliases info to help

PRs

#468 Add the possibility of default selection to MultiItemSelector
#455 Fix typos in using-shell-options-optional.adoc

Additional Notes

Recap

Earlier this year we started an effort align the project with latest Spring Boot and Spring Framework versions as it was difficult to use existing Spring Shell release of a spring family.

Originally the main issue we wanted to address was a removal of a bean cycles which Spring Boot is now enforcing by default. While this feature can be turned off it is not something Spring Shell should require. This required a lot of changes and we chose to handle it with rework of a shell internals. One big challenge was how the old Spring Shell worked by essentially keeping command info methods backed by @ShellMethod annotations and then calling those methods via reflection using not so well defined ways.

Now that it was clear that we needed to do a bigger overhaul it made sense to do further development now rather than waiting for Spring Boot 3 and Spring Framework 6 which Spring Shell eventually would have needed to support.

Here is a recap of the changes that were done:

Command Registration

CommandRegistration is a new programmatic way to define commands. The existing annotation model of commands translates to these registration behind a scene. This new registration model now allows to us control commands dynamically which wasn't the case in the old shell implementation.

Existing Annotations

What comes for @ShellMethod and @ShellOption We've tried to keep those compatible and future development will most likely introduce new annotations more aligned with CommandRegistration.

Theming

Modern terminal implementations are not bound to just show a simple text, but allow for different types of font styles and can be used with colors. In the old Spring Shell these were mostly hard coded while it was possible to use ANSI sequences via JLine to write anything into a console. It made sense to introduce a theming system where text written can be styled and figures chosen per style. Figures are just unicode characters supported by modern terminals which is the basis for creating pretty shell UI's.

UI Components

You've mostly likely used various CLI tools which go beyond just asking some text from a user and then doing something based on that. For example GitHub CLI is a good example as some of its commands enter interactive mode and ask users for input using various tricks like selector lists and other sort of shell style forms.

What we wanted to accomplish in Spring Shell was to create these components which can be use independently or combine those into a flow.

Graal

A big topic in a future Spring Framework release is native compilation with GraalVM. This obviously makes a big impact on the CLI side as that little jvm bootstrap timeout goes away when your existing code is translated into native binary.

With 2.1.x it was shown using our experimental Spring Native project that it is possible to create a Spring Shell application which works the same way in Linux, MacOS and Windows.

Official support for GraalVM in Spring Shell comes with 3.x.

Templating

Writing a command into a terminal is easy as you essentially just write something. However what we've done in some of the built-in commands like help is not always something a user wants to have or they may have other reasons to modify how it looks. Some default outputs from Spring Shell are now based on templates based on ST4 from the ANTRL project.

This allows a user to replace templates used in Spring Shell and modify default behaviour. These templates also integrate into the theme framework so that it's possible to define templates per active theme.

2.1.0-RC1

Generic Notes

Fixes
With this release candidate some notable changes were done.

• Dynamic availability implemented
• Theming functionality went through a rework
• Interactive mode completion went through a rework
• Experimental spring native support is now complete
• Some tweaks to make interactive commands to fail fast in non-tty envs

Issues

#452 Separate commit and push in release workflow
#449 Rework interactive completion
#445 ConfirmationInput should have resultValue
#444 Components can't use interactive mode without tty
#442 Rework themes support
#433 Update Docs
#423 Fix Availability
#323 add support to spring-native

2.1.0-M5

Generic Notes

Fixes
This release has a fixes to few issues found in a previous milestone.

Issues

#437 Exit code customisation broken
#436 Option with @ShellOption not marked as required
#435 Fix ConversionService auto-config
#431 Add support for exit codes
#424 Support option label
#401 Testing e2e

PRs

#432 Capturing CTRL+D (EOF) to exit the shell

2.1.0-M4

Generic Notes

Notable Changes

• Project has been updated to Boot 2.7.0
• Command sub-system has been rewritten
• Support registering commands dynamically
• Execution target can now also be Function or Consumer
• Build-in help command is rendered via a template

Issues

#427 Better errors with non-interactive mode
#422 Rework help command
#421 Change help to description in command registration
#420 Expose CommandRegistration in CommandContext
#419 Update boot 2.7.0
#417 Support defining history file location
#414 Expose default option in SingleItemSelector
#411 Update boot 2.6.7
#409 Default values not used correctly
#407 Make samples to require jdk11
#400 Parameter 0 of method standardParameterResolver in ParameterResolverAutoConfiguration is error
#395 Drop jcommander
#394 Drop spring-shell-test-samples
#387 Add auto-config for ComponentFlow
#383 Update docs
#382 Update boot 2.6.4
#380 Rework command subsystem
#379 Register commands dynamically
#364 Flow system for UI components
#340 Native support for JCommander
#333 Remove legacy support for shell 1.x

2.1.0-M3

Generic Notes

Notable Changes
With usual small enhancements this release contains initial work to add higher level UI Component model which makes it easier to build beautiful interactions with a user. See more from samples and docs but below screencast shows the idea.

Issues

#366 Add confirmation component
#363 Consider a different version output if no properties are set
#361 Update docs
#360 UI component model

PRs

#372 Add support for multiple non-interactive commands

2.1.0-M2

Generic Notes

Notable Changes

• Where's 2.1.0-M1, see #356
• New build-in version command
• Separate starter for cases you need to use jna
• Customizer for non-interactive runner
• New styling and theming subsystem

Issues

#357 Create starter for jna
#356 3.0.x(main) to 2.1.x
#354 Update Docs
#353 Add styling system
#352 Add build-in support for version command
#351 Fix javadoc publish
#347 Change or remove group of "Built-in Commands"
#293 Handling CommandNotFound exceptions

PRs

#358 Add non-interactive shell runner customizer

2.1.0-M1

Generic Notes

NOTE: This used to be 3.0.0-M1, see #356

Notable Changes

• Project has been updated to Spring Boot 2.6.x line.
• Re-work to remove bean cycles which caused issues with boot 2.6.x.
• We're now starting to have a working support for spring-native.
• Autoconfiguration has been moved into its own module.
• Changes in a use of Boot's ApplicationRunner with new shell related interface ShellRunner.
• Better build-in support for non-interactive mode(looking at you spring-native)
• Completion script support for bash to ease tab-tab completion in non-interactive mode.

Issues

#350 Update boot 2.6.3
#345 Separate interactive and non-interactive commands
#343 Add support for bash completion
#342 Support non-interactive shell commands
#339 Update boot 2.6.2
#336 Refactor ResultHandler type hierachy
#331 Update jline 3.21.0
#330 Update maven wrapper
#329 Extract auto-config into separate module
#328 Publish snapshots from workflows
#326 Build support for jdk 11/17
#325 Update boot 2.6.1
#324 Boot 2.6.x beans form a cycle