Add file scanning infrastructure

Introduces InputOptions (shared picocli mixin for path, includes,
excludes, encoding, and line-separator), FileScanner (directory
scanning using plexus DirectoryScanner), FileFormatterFactory (factory
for creating a FileFormatter from a base directory), and
ScanConfiguration (Spring configuration wiring the factory bean).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: timothysparg

spring-javaformat-cli/src/main/java/io/spring/javaformat/cli/InputOptions.java

@@ -0,0 +1,113 @@
+/*
+ * Copyright 2017-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.spring.javaformat.cli;
+
+import java.io.File;
+import java.nio.charset.Charset;
+import java.nio.file.FileSystems;
+
+import org.jspecify.annotations.Nullable;
+import picocli.CommandLine.ITypeConverter;
+import picocli.CommandLine.Option;
+import picocli.CommandLine.Parameters;
+import picocli.CommandLine.TypeConversionException;
+
+/**
+ * Shared options for commands that scan and format files.
+ *
+ * @author Tim Sparg
+ */
+@PicocliManaged
+public class InputOptions {
+
+	/** Base directory to scan. */
+	@Parameters(index = "0", arity = "0..1", defaultValue = ".", paramLabel = "PATH",
+			description = "Base directory to scan. Default: ${DEFAULT-VALUE}", converter = DirectoryConverter.class)
+	public File path;
+
+	/** Glob patterns for files to include. */
+	@Option(names = { "-i", "--includes" }, split = ",", defaultValue = "**/*.java",
+			description = "Repeatable or comma-separated include patterns. Default: ${DEFAULT-VALUE}",
+			converter = GlobConverter.class)
+	public String[] includes;
+
+	/** Glob patterns for files to exclude. */
+	@Option(names = { "-x", "--excludes" }, split = ",",
+			defaultValue = "**/target/**,**/generated-sources/**,**/generated-test-sources/**",
+			description = "Repeatable or comma-separated exclude patterns. Default: ${DEFAULT-VALUE}",
+			converter = GlobConverter.class)
+	public String[] excludes;
+
+	/** File encoding to use when reading and writing files. */
+	@Option(names = { "-e", "--encoding" }, defaultValue = "UTF-8",
+			description = "File encoding. Default: ${DEFAULT-VALUE}")
+	public Charset encoding;
+
+	@Option(names = { "-l", "--line-separator" },
+			description = "Line separator (${COMPLETION-CANDIDATES}). If not specified, the existing line separator in each file is preserved.")
+	@Nullable
+	LineSeparator lineSeparator;
+
+	@Nullable
+	public String resolveLineSeparator() {
+		return (this.lineSeparator != null) ? this.lineSeparator.value : null;
+	}
+
+	enum LineSeparator {
+
+		CR("\r"), LF("\n"), CRLF("\r\n");
+
+		private final String value;
+
+		LineSeparator(String value) {
+			this.value = value;
+		}
+
+	}
+
+	static final class GlobConverter implements ITypeConverter<String> {
+
+		@Override
+		public String convert(String value) throws TypeConversionException {
+			try {
+				FileSystems.getDefault().getPathMatcher("glob:" + value);
+			}
+			catch (IllegalArgumentException ex) {
+				throw new TypeConversionException("Invalid glob pattern '" + value + "': " + ex.getMessage());
+			}
+			return value;
+		}
+
+	}
+
+	static final class DirectoryConverter implements ITypeConverter<File> {
+
+		@Override
+		public File convert(String value) throws TypeConversionException {
+			File dir = new File(value).getAbsoluteFile();
+			if (!dir.exists()) {
+				throw new TypeConversionException("Directory does not exist: " + dir);
+			}
+			if (!dir.isDirectory()) {
+				throw new TypeConversionException("Not a directory: " + dir);
+			}
+			return dir;
+		}
+
+	}
+
+}

spring-javaformat-cli/src/main/java/io/spring/javaformat/cli/scan/FileFormatterFactory.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright 2017-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.spring.javaformat.cli.scan;
+
+import java.io.File;
+
+import io.spring.javaformat.formatter.FileFormatter;
+
+/**
+ * Factory for creating a {@link FileFormatter} from a base directory.
+ *
+ * @author Tim Sparg
+ */
+@FunctionalInterface
+public interface FileFormatterFactory {
+
+	FileFormatter create(File basedir);
+
+}

spring-javaformat-cli/src/main/java/io/spring/javaformat/cli/scan/FileScanner.java

@@ -0,0 +1,51 @@
+/*
+ * Copyright 2017-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.spring.javaformat.cli.scan;
+
+import java.io.File;
+import java.util.Arrays;
+import java.util.List;
+import java.util.stream.Collectors;
+
+import org.codehaus.plexus.util.DirectoryScanner;
+import org.springframework.stereotype.Component;
+
+import io.spring.javaformat.cli.InputOptions;
+
+/**
+ * Scans files from a directory using include and exclude patterns.
+ *
+ * @author Tim Sparg
+ */
+@Component
+public class FileScanner {
+
+	public List<File> scan(InputOptions options) {
+		DirectoryScanner scanner = new DirectoryScanner();
+		scanner.setBasedir(options.path);
+		scanner.setIncludes(options.includes);
+		scanner.setExcludes(options.excludes);
+		scanner.addDefaultExcludes();
+		scanner.setCaseSensitive(false);
+		scanner.setFollowSymlinks(false);
+		scanner.scan();
+		return Arrays.stream(scanner.getIncludedFiles())
+			.map((name) -> new File(options.path, name))
+			.collect(Collectors.toList());
+	}
+
+}

spring-javaformat-cli/src/main/java/io/spring/javaformat/cli/scan/ScanConfiguration.java

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2017-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.spring.javaformat.cli.scan;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import io.spring.javaformat.config.JavaFormatConfig;
+import io.spring.javaformat.formatter.FileFormatter;
+
+
+
+/**
+ * Spring configuration for the scan sub-system.
+ *
+ * @author Tim Sparg
+ */
+@Configuration
+class ScanConfiguration {
+
+	@Bean
+	FileFormatterFactory fileFormatterFactory() {
+		return (basedir) -> new FileFormatter(JavaFormatConfig.findFrom(basedir));
+	}
+
+}

spring-javaformat-cli/src/main/java/io/spring/javaformat/cli/scan/package-info.java

@@ -0,0 +1,25 @@
+/*
+ * Copyright 2017-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * File scanning and formatting infrastructure shared across commands.
+ *
+ * @author Tim Sparg
+ */
+@NullMarked
+package io.spring.javaformat.cli.scan;
+
+import org.jspecify.annotations.NullMarked;