Add sample to showcase secure input

Author: fmbenhassine

README.adoc

@@ -73,6 +73,7 @@ You can find complete tutorials and sample applications in the `spring-shell-sam
 - https://github.com/spring-projects/spring-shell/tree/main/spring-shell-samples/spring-shell-sample-spring-boot[Hello World Spring Shell application with Spring Boot]
 - https://github.com/spring-projects/spring-shell/tree/main/spring-shell-samples/spring-shell-sample-petclinic[Spring Pet Clinic CLI application]
 - https://github.com/spring-projects/spring-shell/tree/main/spring-shell-samples/spring-shell-sample-non-interactive[Non-interactive Spring Shell application]
+- https://github.com/spring-projects/spring-shell/tree/main/spring-shell-samples/spring-shell-sample-secure-input[Spring Shell application to demonstrate secure input]
 
 == Getting Help
 Are you having trouble with Spring Shell? We want to help!

spring-shell-samples/pom.xml

@@ -18,6 +18,7 @@
 		<module>spring-shell-sample-petclinic</module>
 		<module>spring-shell-sample-spring-boot</module>
 		<module>spring-shell-sample-non-interactive</module>
+		<module>spring-shell-sample-secure-input</module>
 	</modules>
 
 	<build>

spring-shell-samples/spring-shell-sample-secure-input/README.md

@@ -0,0 +1,21 @@
+### About
+
+This is a sample project demonstrating the use of Spring Shell commands to read secure input from the user, such as passwords.
+
+### Building the Project
+
+To build the project, navigate to the project's root directory and run the following command:
+
+```bash
+./mvnw clean install
+```
+
+### Running the Application
+
+To run the application, use the following command:
+
+```bash
+./mvnw -pl org.springframework.shell:spring-shell-sample-secure-input spring-boot:run
+```
+
+You should see a prompt where you can use the `change-password` command to securely input and change a password.

spring-shell-samples/spring-shell-sample-secure-input/pom.xml

@@ -0,0 +1,52 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+		 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+
+	<parent>
+		<groupId>org.springframework.shell</groupId>
+		<artifactId>spring-shell-samples</artifactId>
+		<version>4.0.0-SNAPSHOT</version>
+	</parent>
+
+	<artifactId>spring-shell-sample-secure-input</artifactId>
+	<name>Spring Shell Samples - Secure input sample application </name>
+	<packaging>jar</packaging>
+	<description>Spring Shell application to show how to read secure input</description>
+
+	<dependencies>
+		<dependency>
+			<groupId>org.springframework.shell</groupId>
+			<artifactId>spring-shell-starter-jansi</artifactId>
+			<version>${project.parent.version}</version>
+		</dependency>
+        <dependency>
+            <groupId>ch.qos.logback</groupId>
+            <artifactId>logback-classic</artifactId>
+            <version>${logback.version}</version>
+        </dependency>
+		<dependency>
+			<groupId>org.hibernate.validator</groupId>
+			<artifactId>hibernate-validator</artifactId>
+			<version>${hibernate-validator.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>org.glassfish</groupId>
+			<artifactId>jakarta.el</artifactId>
+			<version>${jakarta.el.version}</version>
+		</dependency>
+	</dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <version>${spring-boot.version}</version>
+                <configuration>
+                    <mainClass>org.springframework.shell.samples.secure.input.SpringShellApplication</mainClass>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

spring-shell-samples/spring-shell-sample-secure-input/src/main/java/org/springframework/shell/samples/secure/input/SpringShellApplication.java

@@ -0,0 +1,29 @@
+package org.springframework.shell.samples.secure.input;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.shell.core.command.CommandContext;
+import org.springframework.shell.core.command.annotation.Command;
+
+@SpringBootApplication
+public class SpringShellApplication {
+
+	public static void main(String[] args) {
+		SpringApplication.run(SpringShellApplication.class, args);
+	}
+
+	@Command(name = "change-password", description = "Change password", group = "User Management",
+			help = "A command that changes the user password by securely reading it from the standard input.")
+	public String changePassword(CommandContext commandContext) {
+		try {
+			char[] chars = commandContext.inputReader().readPassword("Enter new password: ");
+			// In a real application, you would update the password securely here
+			return "Password successfully updated.";
+		}
+		catch (Exception e) {
+			commandContext.outputWriter().println("Error reading password: " + e.getMessage());
+			return "Failed to set password.";
+		}
+	}
+
+}

spring-shell-samples/spring-shell-sample-secure-input/src/main/resources/application.properties

@@ -0,0 +1 @@
+spring.application.name=spring-shell-secure-input

spring-shell-samples/spring-shell-sample-secure-input/src/main/resources/logback.xml

@@ -0,0 +1,13 @@
+<configuration>
+
+	<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
+        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
+            <pattern>%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n</pattern>
+        </encoder>
+	</appender>
+
+	<root level="info">
+		<appender-ref ref="CONSOLE"/>
+	</root>
+
+</configuration>