Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Python module for finding files in a set of paths. Port of the Hike gem from Ruby
Python Shell
Branch: master


Build Status

Crawl is a port of the Ruby gem Hike to Python. Crawl will scan through a list of given folders for a requested file. You can also specify a list of possible extensions and aliases for those extensions.


$ pip install crawl


import crawl
trail = crawl.Crawl()

Getting Involved

If you want to get involved and help make Crawl better then please feel free. Just fork and clone the repo and install any development requirements by running the following from the commmand line:

$ pip install -r dev_requirements.txt

Please write any necessary unit tests and check all tests still pass with your changes. If you want to discuss suggested changes then please raise an issue, that way other people can discuss them as well. When you're happy everything is ready to go just submit a pull request and I'll check it out.

Running Tests

Run the following from the command line to run all tests:

$ nosetests


Huge amounts of credit to Sam Stephenson(@sstephenson) and Josh Peek(@josh) for all their work on the original Hike gem. I have basically just rewritten their code and tests in python, tweaking where necessary to make things more 'pythonic' (I hope).


Copyright 2012 Will McKenzie

Crawl is licensed under the MIT License, please see the LICENSE file for more details.

Something went wrong with that request. Please try again.