Skip to main content

Library for string matching with glob patterns

Project description


Build Status codecov PyPI License

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.


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


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.


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

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for globber, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size globber-0.2.1-py3-none-any.whl (8.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size globber-0.2.1.tar.gz (3.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page