globber 0.2.1

Library for string matching with glob patterns

Globber

Globber is a Python library for matching file names against glob patterns. In contrast to other glob-matching libraries, it matches arbitrary strings and doesn't require the matched names to be existing files. In addition, it supports the globstar ** operator to match an arbitrary number of path components.

I have been working with Git repositories, specifically trying to process files classified as source. Picking the source files is much easier with globstar expressions, and since old files might no longer exist on the file system, the matching cannot be based on actual files. I couldn't find anything that had support for both, so I wrote this library.

Patterns

The syntax of a pattern is a sequence of components, separated by slashes /. Each component may include the following special characters:

Character	Meaning
?	Match any single character (not a path separator)
*	Match any sequence of characters, possibly empty (except path separators)
**	Must appear alone inside a component. Match any sequence of components, possibly empty
\	Match the following character literally. This is intended to escape the special characters

Contributing

I may occasionally keep working on this library if I have a need for new functionality, but for the moment it is good enough for my current needs. If you're using it, and find bugs or want some new functionality, you're welcome to open an issue. Pull requests are also appreciated but not necessary to get your concerns heard.

License

Globber is licensed under the Apache Software License, version 2.0. See the LICENSE file for precise license terms and conditions.