Skip to main content

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.

Project details

Download files

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

Source Distribution

findmodules-0.6.tar.gz (2.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page