#############################################################
##                                                         ##
## Copyright (c) 2003-2011 by The University of Queensland ##
## Earth Systems Science Computational Centre (ESSCC)      ##
## http://www.uq.edu.au/esscc                              ##
##                                                         ##
## Primary Business: Brisbane, Queensland, Australia       ##
## Licensed under the Open Software License version 3.0    ##
## http://www.opensource.org/licenses/osl-3.0.php          ##
##                                                         ##
#############################################################

import os
import string

class PathSearcher:
    
    def __init__(self, pathString=os.environ["PATH"], pathDelimiter=":"):
        self.searchList = string.split(pathString, pathDelimiter)
        
    def contains(self, fileName):
        for dir in self.searchList:
            if os.path.exists(os.path.join(dir, fileName)):
                return True
        return False

    def which(self, fileName):
        for dir in self.searchList:
            fileNamePath = os.path.join(dir, fileName)
            if os.path.exists(fileNamePath):
                return fileNamePath
        return fileName
        
    def find(self, fileName):
        for dir in self.searchList:
            fileNamePath = os.path.join(dir, fileName)
            if os.path.exists(fileNamePath):
                return fileNamePath
        return ""