Fileglob

<p align="center"> <img alt="GoReleaser Logo" src="https://avatars2.githubusercontent.com/u/24697112?v=3&s=200" height="140" /> </p> <h1 align="center">fileglob</h1> <h3 align="center">A file globbing library.</h3> <p align="center"> <a href="https://github.com/goreleaser/fileglob/releases/latest"><img alt="Release" src="https://img.shields.io/github/release/goreleaser/fileglob.svg?style=for-the-badge"></a> <a href="/LICENSE.md"><img alt="Software License" src="https://img.shields.io/badge/license-MIT-brightgreen.svg?style=for-the-badge"></a> <a href="https://github.com/goreleaser/fileglob/actions?workflow=build"><img alt="GitHub Actions" src="https://img.shields.io/github/actions/workflow/status/goreleaser/fileglob/build.yml?style=for-the-badge&branch=main"></a> <a href="https://codecov.io/gh/goreleaser/fileglob"><img alt="Codecov branch" src="https://img.shields.io/codecov/c/github/goreleaser/fileglob/master.svg?style=for-the-badge"></a> <a href="https://goreportcard.com/report/github.com/goreleaser/fileglob"><img alt="Go Report Card" src="https://goreportcard.com/badge/github.com/goreleaser/fileglob?style=for-the-badge"></a> <a href="https://pkg.go.dev/github.com/goreleaser/fileglob"><img alt="Go Doc" src="https://img.shields.io/badge/godoc-reference-blue.svg?style=for-the-badge"></a> <a href="https://github.com/goreleaser"><img alt="Powered By: GoReleaser" src="https://img.shields.io/badge/powered%20by-goreleaser-green.svg?style=for-the-badge"></a> </p>

What

fileglob is a glob library that uses gobwas/glob underneath and returns only matching files or direcories, depending on the configuration. Due to this great foundation, fileglob supports:

• Asterisk wildcards (*)
• Super-asterisk wildcards (**)
• Single symbol wildcards (?)
• Character list matchers with negation and ranges ([abc], [!abc], [a-c])
• Alternative matchers ({a,b})
• Nested globbing ({a,[bc]})
• Escapable wildcards (\{a\}/\* and fileglob.QuoteMeta(pattern))

By also building on top of fs.FS, a range of alternative filesystems as well as custom filesystems are supported.

Why

gobwas/glob is very well implemented: it has a lexer, compiler, and all that, which seems like a better approach than most libraries do: regex.

It doesn't have a Walk method though, and we needed it in a couple of places. So we decided to implement it ourselves, a little bit based on how mattn/go-zglob works.