Jeninnet.FileQuery

Building a Deterministic File Query Engine for .NET

Technical Whitepaper

Version 1.0

Author: Tarek Najem

GitHub: https://github.com/TarekNajem04/Jeninnet.FileQuery

NuGet: https://www.nuget.org/packages/Jeninnet.FileQuery

License: MIT

Table of Contents

Jeninnet.FileQuery

Table of Contents

1. Introduction

2. The Problem With Traditional File Matching

2.1 Glob-only libraries

2.2 Regular expression libraries

2.3 GitIgnore-inspired libraries

3. Deterministic Rule Evaluation

4. The Pattern Language

4.1 GitIgnore Patterns

4.2 Glob Patterns

4.3 Regular Expression Patterns

4.4 POSIX Character Classes

5. Architecture

5.1 Separation of Concerns

5.2 The Compilation Pipeline

5.3 The HybridPathMatcher

5.4 Traversal

5.5 Path Normalization

6. Performance

6.1 Zero-Allocation Hot Path

6.2 Benchmark Results

6.3 Compilation Pipeline Allocations

7.…