Commit Graph

45 Commits

Author SHA1 Message Date
Janne Valkealahti
3891a8b375 Add support for exit codes
- New configurations to CommandRegistration
- Re-using exit code concepts from boot
- Handling exit codes only in non-interactive mode
- Adding e2e commands and tests for better coverage
- Fixes #431
2022-05-31 07:49:50 +01:00
Jay Bryant
2af4e86925 Editing pass
for a bunch of new content to support the new version.
2022-05-28 08:27:36 +01:00
Janne Valkealahti
bd9ab62013 Rework help command
- Change help command output to get templated using
  model classes.
- Remove things around ParameterDescription as those are
  replaced with template classes.
- Fixes for native configs.
- For now availability and aliases are removed from
  help to get back in better form.
- Aliases has been partly introduced to structure.
- Fixes #422
2022-05-26 07:45:35 +01:00
Janne Valkealahti
eed1d84653 Update docs 2022-05-18 09:44:26 +01:00
Janne Valkealahti
c7d3eb15b4 Expose CommandRegistration in CommandContext
- Fixes #420
2022-05-18 08:18:38 +01:00
Janne Valkealahti
0f655a03ce Add missing headers to snippets 2022-05-15 16:46:42 +01:00
Janne Valkealahti
ee21619885 Update docs 2022-05-15 16:29:23 +01:00
Janne Valkealahti
60e63f87ae Update docs 2022-05-14 17:08:09 +01:00
Janne Valkealahti
ab476345fa Update docs 2022-05-14 16:36:53 +01:00
Janne Valkealahti
3599182536 Update docs 2022-05-14 09:02:37 +01:00
Janne Valkealahti
751c9e213e Update docs 2022-05-13 17:28:32 +01:00
Janne Valkealahti
8477a5ac4c Update docs
- Add docs for component flow
- Relates #383
2022-05-11 15:36:10 +01:00
Janne Valkealahti
bed8457ff2 Update docs
- Split some adoc files
- Shuffle to reorg structure
- Relates #383
2022-05-11 10:18:11 +01:00
Janne Valkealahti
8a23518b84 Rework command subsystem
- Focus of these changes are to introduce a new command system based on
  real registrations (new way) instead of continuously (old way) resolve
  methods and its parameters via reflection.
- There's a lot of changes as this resolution via reflection had its
  hooks almost everywhere and thus most changes are just refactorings.
- Order to understand real changes I'd start to look classes under
  `org.springframework.shell.command` package as it defines new registration,
  catalog and parser classes. Also samples contain new classes to demonstrate
  new functionality.
- Fixes #380
2022-05-06 08:32:53 +01:00
Janne Valkealahti
942108e612 Update docs
- Split adoc files
- Relates #383
2022-04-23 08:36:10 +01:00
Janne Valkealahti
8920db699d Update component docs
- Relates #361
2022-02-24 09:25:38 +00:00
Janne Valkealahti
1593ee86d2 Update docs
- Polish pom
- Version command
- Theming
- Templating
- Relates #354
2022-02-03 09:51:13 +00:00
Janne Valkealahti
cde73ec2c0 Update docs 2022-01-21 09:28:22 +00:00
Janne Valkealahti
6c2e858534 Fix docs copyright year 2022-01-18 13:23:56 +00:00
Janne Valkealahti
d26f6d1a90 Update doc authors 2021-12-18 13:01:58 +00:00
Johnny Marnell
2b7a9b15e6 Clarify how to achieve varying arity in docs
Add examples of how to achieve, with existing functionality, a varying amount of parameter arity (and favor this verbage over "infinite", which, though technically true, could be misleading for evoking neding a very large amount of a parameter, instead of the normal usecase of a few of any amount).
2021-12-18 12:54:06 +00:00
Jay Bryant
012481ef63 Update document appearance
Use Spring's standard styles for the ToC. Also added epub generation.
2021-12-18 09:29:09 +00:00
Jay Bryant
7473c9ec5c Editing pass
Edited for spelling, puncuation, grammar, usage, and corporate voice.
2021-12-18 08:13:47 +00:00
Gao Liang
10fb9a8ed2 fix pom exclusions 2021-12-11 08:41:45 +00:00
Jay Bryant
eca0dd1572 Update doc appearance and link doc formats
Updated the ToC, banner, highlighting, and CSS styles to the last Spring standard.
Linked the HTML output to the PDF output and vice-versa.
2021-12-11 08:39:05 +00:00
onnadi-sa
296db93462 Fix typo 2019-10-02 12:02:13 +02:00
Spring Operator
23d99f45eb URL Cleanup
This commit updates URLs to prefer the https protocol. Redirects are not followed to avoid accidentally expanding intentionally shortened URLs (i.e. if using a URL shortener).

# HTTP URLs that Could Not Be Fixed
These URLs were unable to be fixed. Please review them to see if they can be manually resolved.

* http://jcommander.org/apidocs/ (200) with 1 occurrences could not be migrated:
   ([https](https://jcommander.org/apidocs/) result SSLHandshakeException).

# Fixed URLs

## Fixed Success
These URLs were switched to an https URL with a 2xx status. While the status was successful, your review is still recommended.

* http://docs.spring.io/spring-framework/docs/current/javadoc-api/ with 1 occurrences migrated to:
  https://docs.spring.io/spring-framework/docs/current/javadoc-api/ ([https](https://docs.spring.io/spring-framework/docs/current/javadoc-api/) result 200).
* http://maven.apache.org/xsd/assembly-2.0.0.xsd with 1 occurrences migrated to:
  https://maven.apache.org/xsd/assembly-2.0.0.xsd ([https](https://maven.apache.org/xsd/assembly-2.0.0.xsd) result 200).
* http://maven.apache.org/xsd/maven-4.0.0.xsd with 12 occurrences migrated to:
  https://maven.apache.org/xsd/maven-4.0.0.xsd ([https](https://maven.apache.org/xsd/maven-4.0.0.xsd) result 200).
* http://repo.spring.io/libs-milestone-local with 2 occurrences migrated to:
  https://repo.spring.io/libs-milestone-local ([https](https://repo.spring.io/libs-milestone-local) result 302).
* http://repo.spring.io/libs-snapshot-local with 2 occurrences migrated to:
  https://repo.spring.io/libs-snapshot-local ([https](https://repo.spring.io/libs-snapshot-local) result 302).
* http://repo.spring.io/release with 1 occurrences migrated to:
  https://repo.spring.io/release ([https](https://repo.spring.io/release) result 302).

# Ignored
These URLs were intentionally ignored.

* http://maven.apache.org/ASSEMBLY/2.0.0 with 2 occurrences
* http://maven.apache.org/POM/4.0.0 with 24 occurrences
* http://www.w3.org/2001/XMLSchema-instance with 13 occurrences
2019-03-26 11:55:46 +01:00
Spring Operator
7176450689 URL Cleanup
This commit updates URLs to prefer the https protocol. Redirects are not followed to avoid accidentally expanding intentionally shortened URLs (i.e. if using a URL shortener).

# Fixed URLs

## Fixed Success
These URLs were switched to an https URL with a 2xx status. While the status was successful, your review is still recommended.

* [ ] http://beanvalidation.org/ with 1 occurrences migrated to:
  https://beanvalidation.org/ ([https](https://beanvalidation.org/) result 200).
* [ ] http://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/ with 1 occurrences migrated to:
  https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/ ([https](https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/) result 200).
* [ ] http://github.com/spring-projects/spring-shell with 1 occurrences migrated to:
  https://github.com/spring-projects/spring-shell ([https](https://github.com/spring-projects/spring-shell) result 200).
* [ ] http://start.spring.io with 2 occurrences migrated to:
  https://start.spring.io ([https](https://start.spring.io) result 200).
* [ ] http://www.java.com/en/download/help/error_hotspot.xml with 1 occurrences migrated to:
  https://www.java.com/en/download/help/error_hotspot.xml ([https](https://www.java.com/en/download/help/error_hotspot.xml) result 200).
* [ ] http://contributor-covenant.org with 1 occurrences migrated to:
  https://contributor-covenant.org ([https](https://contributor-covenant.org) result 301).
* [ ] http://contributor-covenant.org/version/1/3/0/ with 1 occurrences migrated to:
  https://contributor-covenant.org/version/1/3/0/ ([https](https://contributor-covenant.org/version/1/3/0/) result 301).
2019-03-26 11:48:55 +01:00
Florian Waibel
793eaa6fe7 Fix method annotation in some reference documentation snippets
Somehow `@ShellCommand` found its way into the snippets. This commit
replaces it with the correct annotation `@ShellMethod`.
2018-01-17 21:31:07 +01:00
Eric Bottard
f90edd42c4 Make ResultHandlers configuration more explicit
Handle exit as a dedicated case (prevents eg 'exit' commands in scripts to make script quit)
Add an example of custom ApplicationRunner

Fixes #187
Fixes #183

Decouple ApplicationRunners

Make ThrowableResultHandler behave differently in non-interactive mode
2018-01-15 15:59:01 +01:00
Eric Bottard
2ef0610f81 Added an example of full class dynamic availability toggle
Fixes #175
2017-11-06 15:12:46 +01:00
Eric Bottard
7d50c0813f Qualify the Spring Shell provided ConversionService
Fixes #173
2017-11-06 14:52:50 +01:00
Eric Bottard
91bc5f31e7 Warn about potential NPE when using gradle 2017-10-09 09:56:11 +02:00
Eric Bottard
f0e5c45ee9 Add automatic command grouping
Fixes #163

Introduce Command and Command.Help
2017-09-28 09:44:48 +02:00
altus34
1695527408 Fix documentation
- Optional Parameters and Default Values. Type error in greet method signature who cause compile error
 - Customizing the Named Parameter Key(s). help method is already registered in spring shell by default and cannot be reused
2017-09-23 10:57:13 +02:00
Eric Bottard
a50b741af1 Document PromptProvider, ApplicationRunner and ConversionService.
Make the default ConversionService register converters in the ctx
2017-09-19 13:57:28 +02:00
Eric Bottard
b9df6c48a9 Small docs fixes 2017-09-18 19:01:09 +02:00
Eric Bottard
919cefbc52 Document bean validation 2017-09-07 14:48:50 +02:00
Eric Bottard
49850562c1 Generate aggregated API docs
Fixes #145
2017-08-29 17:44:27 +02:00
Eric Bottard
dfa1a778a5 More reference documentation 2017-08-28 15:32:37 +02:00
Eric Bottard
be1603214d More reference documentation 2017-08-25 18:16:09 +02:00
Eric Bottard
56adc9ab5a Write tutorial in ref doc 2017-08-23 21:09:40 +02:00
Eric Bottard
1eea04ad2f Add dynamic command availability
Introduce availability concept on MethodTarget (with reason if not available)
Add bridge to @CliAvailabilityIndicator to Legacy registrar

Fixes #138

Add help for unavailable commands

Add standard API for availability
2017-08-23 18:44:31 +02:00
Eric Bottard
51c043e1e1 Remove extra directory in docs zip 2017-08-18 14:00:33 +02:00
Eric Bottard
3fb368476f Add Reference Documentation infrastructure 2017-08-17 12:22:52 +02:00