程序包 com.agentsflex.tool.commons

类 GrepTool

java.lang.Object

com.agentsflex.tool.commons.GrepTool

public class GrepTool
extends Object

Pure Java grep implementation that doesn't require external ripgrep installation. Uses Java NIO.2 for file traversal and regex Pattern/Matcher for searching.

Generated with Claude Code AI assistant.

作者:

Christian Tzolov, Claude Code, Michael Yang

嵌套类概要

嵌套类

修饰符和类型	类	说明
static class	GrepTool.Builder
private static interface	GrepTool.FileProcessor	Functional interface for file processing
static enum	GrepTool.OutputMode	Output modes for grep

字段概要

字段

修饰符和类型	字段	说明
private static final Map<String,String[]>	FILE_TYPE_EXTENSIONS
private final int	maxDepth
private final int	maxLineLength
private final int	maxOutputLength
private final Path	workingDirectory

构造器概要

构造器

限定符	构造器	说明
	GrepTool()	已过时。 Use builder() instead.
private	GrepTool(int maxOutputLength, int maxDepth, int maxLineLength, Path workingDirectory)	Constructor with configurable parameters.

方法概要

修饰符和类型	方法	说明
static GrepTool.Builder	builder()
private List<PathMatcher>	buildGlobMatchers(String glob, String type)	Build glob matchers from glob pattern or file type
private int	countMatchesInFile(Path file, Pattern pattern)	Count matches in a file
private boolean	fileContainsPattern(Path file, Pattern pattern)	Check if file contains the pattern
private List<String>	findMatchesWithContext(Path file, Pattern pattern, int beforeContext, int afterContext, boolean lineNumbers)	Find matches with context lines
String	grep(String pattern, String path, String glob, GrepTool.OutputMode outputMode, Integer contextBefore, Integer contextAfter, Integer context, Boolean showLineNumbers, Boolean caseInsensitive, String type, Integer headLimit, Integer offset, Boolean multiline)
private boolean	isIgnoredPath(Path path)	Check if a file should be ignored (common ignore patterns)
private boolean	matchesGlob(Path file, List<PathMatcher> matchers)	Check if a file matches any of the glob matchers
private void	processFiles(Path searchPath, List<PathMatcher> matchers, GrepTool.FileProcessor processor)	Process files in the search path
private String	searchContent(Path searchPath, Pattern pattern, List<PathMatcher> matchers, int beforeContext, int afterContext, boolean lineNumbers, Integer headLimit, Integer offset)	Search and show matching content with context (content mode)
private String	searchCount(Path searchPath, Pattern pattern, List<PathMatcher> matchers, Integer headLimit, Integer offset)	Search and count matches per file (count mode)
private String	searchFilesWithMatches(Path searchPath, Pattern pattern, List<PathMatcher> matchers, Integer headLimit, Integer offset)	Search for files containing matches (files_with_matches mode)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

maxOutputLength

private final int maxOutputLength

maxDepth

private final int maxDepth

maxLineLength

private final int maxLineLength

workingDirectory

private final Path workingDirectory

FILE_TYPE_EXTENSIONS

private static final Map<String,String[]> FILE_TYPE_EXTENSIONS

构造器详细资料

GrepTool

public GrepTool()

已过时。

Use builder() instead.

Default constructor with default values for all configuration parameters.

GrepTool

private GrepTool(int maxOutputLength,
 int maxDepth,
 int maxLineLength,
 Path workingDirectory)

Constructor with configurable parameters.

参数:

maxOutputLength - Maximum output length before truncation (default: 100000)

maxDepth - Maximum directory traversal depth to prevent infinite recursion (default: 100)

maxLineLength - Maximum line length to process, longer lines are skipped (default: 10000)

workingDirectory - The working directory to use when path is not specified. If null, defaults to current JVM working directory.

方法详细资料

grep

public String grep(String pattern,
 String path,
 String glob,
 GrepTool.OutputMode outputMode,
 Integer contextBefore,
 Integer contextAfter,
 Integer context,
 Boolean showLineNumbers,
 Boolean caseInsensitive,
 String type,
 Integer headLimit,
 Integer offset,
 Boolean multiline)

buildGlobMatchers

private List<PathMatcher> buildGlobMatchers(String glob,
 String type)

Build glob matchers from glob pattern or file type

matchesGlob

private boolean matchesGlob(Path file,
 List<PathMatcher> matchers)

Check if a file matches any of the glob matchers

searchFilesWithMatches

private String searchFilesWithMatches(Path searchPath,
 Pattern pattern,
 List<PathMatcher> matchers,
 Integer headLimit,
 Integer offset)
                               throws IOException

Search for files containing matches (files_with_matches mode)

抛出:

IOException

searchCount

private String searchCount(Path searchPath,
 Pattern pattern,
 List<PathMatcher> matchers,
 Integer headLimit,
 Integer offset)
                    throws IOException

Search and count matches per file (count mode)

抛出:

IOException

searchContent

private String searchContent(Path searchPath,
 Pattern pattern,
 List<PathMatcher> matchers,
 int beforeContext,
 int afterContext,
 boolean lineNumbers,
 Integer headLimit,
 Integer offset)
                      throws IOException

Search and show matching content with context (content mode)

抛出:

IOException

processFiles

private void processFiles(Path searchPath,
 List<PathMatcher> matchers,
 GrepTool.FileProcessor processor)
                   throws IOException

Process files in the search path

抛出:

IOException

isIgnoredPath

private boolean isIgnoredPath(Path path)

Check if a file should be ignored (common ignore patterns)

fileContainsPattern

private boolean fileContainsPattern(Path file,
 Pattern pattern)

Check if file contains the pattern

countMatchesInFile

private int countMatchesInFile(Path file,
 Pattern pattern)

Count matches in a file

findMatchesWithContext

private List<String> findMatchesWithContext(Path file,
 Pattern pattern,
 int beforeContext,
 int afterContext,
 boolean lineNumbers)

Find matches with context lines

builder

public static GrepTool.Builder builder()