FastFind.Core 1.1.0

FastFind.NET

Ultra-high performance cross-platform file search library for .NET 10

Packages

Package	Version	Description
FastFind.Core		Core interfaces and models
FastFind.Windows		Windows-optimized with MFT & USN Journal
FastFind.Unix		Linux/macOS with parallel enumeration & inotify
FastFind.SQLite		SQLite persistence with FTS5 search

Key Features

• Cross-Platform SIMD: Vector256/Vector128 auto-dispatch (AVX2, SSE2, NEON) — 1.87M ops/sec
• MFT Direct Access (Windows): 31K+ files/sec NTFS enumeration (30x faster than standard APIs)
• Parallel File Enumeration (Linux): Channel-based BFS with depth-aware parallelism
• USN Journal Sync (Windows) / inotify (Linux): Real-time file change detection
• SQLite FTS5: Persistent index with full-text search
• Memory Optimized: 60-80% reduction through string interning
• Auto Platform Detection: ModuleInitializer auto-registration per platform

Installation

dotnet add package FastFind.Core

# Platform-specific (auto-registered at runtime)
dotnet add package FastFind.Windows    # Windows
dotnet add package FastFind.Unix       # Linux / macOS

dotnet add package FastFind.SQLite     # Optional: SQLite persistence

Quick Start

Windows

using FastFind;
using Microsoft.Extensions.Logging;

using var loggerFactory = LoggerFactory.Create(b => b.AddConsole());
var searchEngine = FastFinder.CreateWindowsSearchEngine(loggerFactory);

await searchEngine.StartIndexingAsync(new IndexingOptions
{
    DriveLetters = ['C', 'D'],
    ExcludedPaths = ["node_modules", "bin", "obj", ".git"],
    CollectFileSize = true
});

while (searchEngine.IsIndexing) await Task.Delay(500);

var results = await searchEngine.SearchAsync(new SearchQuery
{
    BasePath = @"D:\Projects",
    SearchText = "controller",
    ExtensionFilter = ".cs",
    MaxResults = 100
});

await foreach (var file in results.Files)
{
    Console.WriteLine($"{file.Name} ({file.SizeFormatted})");
}

Linux

using FastFind;
using FastFind.Unix;
using Microsoft.Extensions.Logging;

using var loggerFactory = LoggerFactory.Create(b => b.AddConsole());
var searchEngine = UnixSearchEngine.CreateLinuxSearchEngine(loggerFactory);

await searchEngine.StartIndexingAsync(new IndexingOptions
{
    MountPoints = ["/home", "/opt"],
    ExcludedPaths = ["node_modules", ".git", "__pycache__"],
    CollectFileSize = true
});

while (searchEngine.IsIndexing) await Task.Delay(500);

var results = await searchEngine.SearchAsync(new SearchQuery
{
    BasePath = "/home/user/projects",
    SearchText = "config",
    ExtensionFilter = ".json",
    MaxResults = 100
});

await foreach (var file in results.Files)
{
    Console.WriteLine($"{file.Name} - {file.DirectoryPath}");
}

Performance

See Performance Benchmarks for detailed results.

Documentation

• Getting Started
• API Reference
• Performance Benchmarks
• Search Examples
• Roadmap

Platform Support

License

MIT License - see LICENSE for details.