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 project module directory relative to the running script.

Project Description

Find project module directory relative to the running script.

This module will search the currently runnings script’s parent directory, and all successive parent directories up to the root directory for a module matching the base argument. If found, the directory is added to sys.path.

This is useful for sets of scripts that use custom project-specific modules that you don’t want to install into the system python modules folders.

Example usage:

import findmodules
findmodules.init(base='modules', realpath=True)

This example will search for a folder called “modules” in the current script’s directory, and all parent directories. Symlinks will be resolved first. If the directory is found, it will be appended to sys.path.


  • bin: Path to script file. Default is currently running script file
  • base: Name of base module directory to add to sys.path. Default is “lib”.
  • append: Append module directory to the end of sys.path, or insert at the beginning? Default is to append.
  • ignore: List of directories to ignore during the module search. Default is to ignore “/” and “/usr”.
  • realpath: Should symlinks be resolved first? Default is False.
  • pythonpath: Should the modules directory be added to the PYTHONPATH environment variable? Default is False.
  • throw: Should an exception be thrown if no modules directory was found? Default is False.
  • The path to the modules directory if it was found, otherwise None.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(2.1 kB) Copy SHA256 Hash SHA256
Source None Jan 2, 2015

Supported By

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 Google Google Cloud Servers DreamHost DreamHost Log Hosting