BaseTestPackage 1.0.0
dotnet add package BaseTestPackage --version 1.0.0
NuGet\Install-Package BaseTestPackage -Version 1.0.0
<PackageReference Include="BaseTestPackage" Version="1.0.0" />
paket add BaseTestPackage --version 1.0.0
#r "nuget: BaseTestPackage, 1.0.0"
// Install BaseTestPackage as a Cake Addin #addin nuget:?package=BaseTestPackage&version=1.0.0 // Install BaseTestPackage as a Cake Tool #tool nuget:?package=BaseTestPackage&version=1.0.0
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:
Pattern | Description | Example |
---|---|---|
? |
Any single character except the directory separator | 202305??.log |
* |
Zero or more of any characters except the directory separator | src/*.md |
**/ |
Zero or more path segments ending with the directory separator | **/bin/ |
** |
Equivalent of **/* , only valid at the beginning of the segment, if it occurs not at the beginning of the segment it is interpreted as consecutive * |
** , **.cs |
*. |
Trailing dot changes the behavior of the wildcards (? , * , ** ) of the last segment of the path to not include a dot, i.e. allows to match file system entries without extension. If there are no wildcards in the last segment, the trailing dot is treated as a regular character |
test/*. , split/x?a. |
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
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET Framework | net is compatible. |
This package has no dependencies.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.0.0 | 97,842 | 12/6/2013 |
Summary of changes made in this release of the package.