Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Find the first file matching a given pattern in the current directory or the nearest ancestor directory.

Project Description

# python-findup

## Introduction

Find the first path matching a given pattern in the current working directory (or a given directory) or the nearest ancestor directory. This project is (roughly) a python version of [node-findup-sync](

Why? Applications, such as git, often use project configuration files found in the current directory or an ancestor directory. The findup modules allows an application author to easily find these files or directories.

## Installation

The best way to install is probably to use pip:

pip install findup

Or you can clone and install findup from github:

git clone cd python-findup python install

## Usage

pattern is combined with the current working directory or an ancestor directory and passed to glob.glob to see if the pattern matches. If it does, the first match is returned. Pattern can contain some shell wildcard characters, like ? and *. See the python glob module for more details.


To find the root dir of a git repository, when the current working directory is somewhere within the repository:


Or more robustly, handling the case where the cwd is not within a git repository:

path = findup.glob(‘.git’) git_root = None if path is None or os.path.dirname(path)
Release History

Release History

This version
History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
findup-0.3.0.tar.gz (3.3 kB) Copy SHA256 Checksum SHA256 Source Oct 5, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting