GlobRegex 1.0.1

GlobRegex  

A simple fully tested Glob to Regex conversion library for .NET with no external dependencies targeting netstadard2.0

Glob is a pattern that defines a set of file system entries using wildcards. GlobRegex allows you to convert a glob into a regular expression pattern splitting the glob into a base directory from which a recursive traversal can be started, and a stem that can be used to match a relative path.

Usage

var glob = GlobConvert.ToRegexPattern("../usr/doc?/**/*.txt", GlobRegexOptions.MatchFullString);
var regex = new Regex(glob.StemRegexPattern, RegexOptions.Compiled | RegexOptions.CultureInvariant | RegexOptions.IgnoreCase);
Directory.EnumerateFiles(glob.BasePath, "*", new EnumerationOptions {RecurseSubdirectories = true})
    .Select(path => Path.GetRelativePath(glob.BasePath, path))
    .Where(path => regex.IsMatch(path))
    .ForEach(Console.WriteLine);

Patterns

The following patterns are supported:

Both / and \ are treated as directory separator characters. So **/* is the same as **\*. Consecutive * after ** (and * if not at the beginning of the segment) are ignored. So ***/abc*** is the same as **/abc*. Escaping of wildcard characters is not supported.

The passed glob is not normalized, in particular ./ and ../, consecutive directory separators like // or \\, etc. processed literally. ./ and ../ in normal use are expected to appear only in the BasePath and can be normalized afterwards. In the usage example above Path.GetRelativePath method resolve paths by calling the GetFullPath normalization method before calculating the difference.

Reproducible builds

GlobRegex nuget package is built using ReproducibleBuilds with the SourceLink. Reproducible builds give confidence by allowing to validate that the package has actually been built using public sources. To be able to reproduce a build, you need the source files, the referenced DLLs, the compiler version, and the compiler options (language version, defines, nullables, etc.). All this information is available using Nuget Package Explorer. Or you can use dotnet-validate tool to validate the package.

Author

Copyright (c) Dmitriy dscheg Titarenko 2023

GlobRegex is distributed under BSD 3-Clause License