# Glob

A C# Glob library for .NET.

What is a glob?

A glob is a pattern-matching syntax that shells use. Like when you do rm *.cs, the *.cs is a glob.

See: http://en.wikipedia.org/wiki/Glob_(programming) for more info.

Try it out!

You can test out Glob expressions using this library in your browser by visiting:

https://kthompson.github.io/glob/

Supported Environments

• Windows
• Macintosh OS X (Darwin)
• Linux

Features

Common Expressions

Expressions

Other Features

• Escape patterns are supported using \
• Pure C# implementation
• No reliance on Regex
• Simple text string matching support
• File system matching APIs

Getting Started

Installing from NuGet

dotnet add package Glob

Setup

To use Glob, you need to include the namespace:

using GlobExpressions;

Example

var glob = new Glob("**/bin");
var match = glob.IsMatch(@"C:\files\bin\");

Static Usage

Single file

var match = Glob.IsMatch(@"C:\files\bin\", "**/bin");   

Files in a directory

string[] matchingFiles = Glob.Files(@"C:\files\bin\", "**/bin").ToArray();  

Directories in a directory

string[] matchingDirectories = Glob.Directories(@"C:\files\bin\", "**/bin").ToArray();  

Extension Methods

DirectoryInfo.GlobDirectories

Enumerate through all matching directories recursively.

Params

• pattern: String

Example

var root = new DirectoryInfo(@"C:\");
var allBinFolders = root.GlobDirectories("**/bin");

DirectoryInfo.GlobFiles

Enumerate through all matching files recursively.

Params

• pattern: String

Example

var root = new DirectoryInfo(@"C:\");
var allDllFiles = root.GlobFiles("**/*.dll");

DirectoryInfo.GlobFileSystemInfos

Enumerate through all matching files and folders recursively.

Params

• pattern: String

Example

var root = new DirectoryInfo(@"C:\");
var allInfoFilesAndFolders = root.GlobFileSystemInfos("**/*info");

Upgrading from 1.x

In 2.x all Glob expressions no longer support \ as path separators. Instead / should be used to separate paths in expressions. The / path separator will still match on platform specific directory separators but \ is reserved for escape sequences.

Performance

See benchmarks