python.envutil Namespace Reference

Functions
	has_wildcards (filename)
	find_file_split (filename, dirlist=[os.getcwd()], access=os.R_OK, depth=0)
	find_file (filename, dirlist=[os.getcwd()], access=os.R_OK, depth=0)
	find_files_split (filename, dirlist, access, depth)
	find_files (filename, dirlist, access, depth)
	find_file_env (filename, env_var_name, access=os.R_OK, sep=defaultPathSeps, depth=0)
	find_files_env (filename, env_var_name, access=os.R_OK, sep=defaultPathSeps, depth=0)
	find_libraries (lib)

Variables
str	__doc__ = """Environment variables utilities"""
str	LD_LIBRARY_PATH = 'LD_LIBRARY_PATH'
str	filenameWildCards = r'\?|\*|\[.*\]'
	filenameWildCardsCompiled = re.compile(filenameWildCards)
str	defaultPathSeps = os.pathsep + '|,'
	_libraryNameRE = re.compile(r'\.so(\.[0-9]+)*$')
	filelist = glob.glob(filename)
	print ("Checking files %s..." % fullfile)
	dir = os.path.abspath( os.path.expandvars( os.path.expanduser(dir) ) )
	print ("Trying %s..." % f)
list	subdirlist = []
	fulldir = os.path.join(dir,d)

Function Documentation

find_file()

python.envutil.find_file	(		filename,
			dirlist = [ os.getcwd() ],
			access = os.R_OK,
			depth = 0 )

Search for file <filename> with access rights <access> (see os.access()) in directory list <dirlist>,
Search into directory tree of each directory up to depth <depth>. The default directory list is
a list containing only the current working directory.
<depth> = 0 : only search in directories given in list.
<depth> > 0 : descend deeper into the directory tree up to max <depth> levels.
<depth> < 0 : ascend upwards into the directory tree up to max -<depth> levels.

Definition at line 85 of file envutil.py.

               depth = 0 ):
    """Search for file <filename> with access rights <access> (see os.access()) in directory list <dirlist>,
    Search into directory tree of each directory up to depth <depth>. The default directory list is
    a list containing only the current working directory.
    <depth> = 0 : only search in directories given in list.
    <depth> > 0 : descend deeper into the directory tree up to max <depth> levels.
    <depth> < 0 : ascend upwards into the directory tree up to max -<depth> levels."""
    found = find_file_split( filename, dirlist, access, depth )
    return found and os.path.join( found[0], found[1] )
 
 

find_file_env()

python.envutil.find_file_env	(		filename,
			env_var_name,
			access = os.R_OK,
			sep = defaultPathSeps,
			depth = 0 )

Search for file <filename> with access rights <access> (see os.access()) in directory list
given as a <sep> separated list of paths in environment variable <env_var_name>.
Search into directory tree of each directory up to depth <depth> (0=don't descend at all).

Definition at line 178 of file envutil.py.

def find_file_env( filename, env_var_name, access = os.R_OK, sep = defaultPathSeps, depth = 0 ):
    """Search for file <filename> with access rights <access> (see os.access()) in directory list
    given as a <sep> separated list of paths in environment variable <env_var_name>.
    Search into directory tree of each directory up to depth <depth> (0=don't descend at all)."""
    env = os.environ.get( env_var_name )
    envList = [ os.getcwd() ]
    if not env:
        return envList
    envList.extend( re.split( sep, env ) )
    return find_file( filename, envList, access, depth )
 
 

find_file_split()

python.envutil.find_file_split	(		filename,
			dirlist = [ os.getcwd() ],
			access = os.R_OK,
			depth = 0 )

Search for file <filename> with access rights <access> (see os.access()) in directory list <dirlist>.
Search into directory tree of each directory in <dirlist> up to depth <depth>. The default directory
list is a list containing only the current working directory.
No wildcards are allowed in <filename>.
<depth> = 0 : only search in directories given in list.
<depth> > 0 : descend deeper into the directory tree up to max <depth> levels.
<depth> < 0 : ascend upwards into the directory tree up to max -<depth> levels.
It returns 2-tuple (dir,file) where:
   file=<filename> if no wildcards, or the actual (local) match to <filename> if wildcarded.
   dir=the directory where <file> was found (from <dirlist>, or from a subdir if depth > 0)
If no file is found, it returns None.

Definition at line 30 of file envutil.py.

                     depth = 0 ):
    """Search for file <filename> with access rights <access> (see os.access()) in directory list <dirlist>.
    Search into directory tree of each directory in <dirlist> up to depth <depth>. The default directory
    list is a list containing only the current working directory.
    No wildcards are allowed in <filename>.
    <depth> = 0 : only search in directories given in list.
    <depth> > 0 : descend deeper into the directory tree up to max <depth> levels.
    <depth> < 0 : ascend upwards into the directory tree up to max -<depth> levels.
    It returns 2-tuple (dir,file) where:
       file=<filename> if no wildcards, or the actual (local) match to <filename> if wildcarded.
       dir=the directory where <file> was found (from <dirlist>, or from a subdir if depth > 0)
    If no file is found, it returns None."""
    if not dirlist: return None
    for dir in dirlist:
        dir = os.path.abspath( os.path.expandvars( os.path.expanduser(dir) ) )
        if not os.path.isdir(dir): continue
        fullfile = os.path.join( dir, filename )
        #        print ("Checking file %s..." % fullfile)
        if fileutil.access( fullfile, access ):
            return (dir,filename)
 
    if depth == 0:
        # not found at all
        return None
    elif depth > 0:
        # not found at this level. Go one level down in directory structure
        for dir in dirlist:
            dir = os.path.abspath( os.path.expandvars( os.path.expanduser(dir) ) )
            if not os.path.isdir(dir): continue
            subdirlist = []
            for d in fileutil.listdir(dir):
                fulldir = os.path.join(dir,d)
                if os.path.isdir(fulldir):
                    subdirlist.append( fulldir )
            if subdirlist:
                found = find_file_split( filename, subdirlist, access, depth - 1 )
                if found: return found
    elif depth < 0:
        # not found at this level. Go one level up in directory structure
        for dir in dirlist:
            dir = os.path.abspath( os.path.expandvars( os.path.expanduser(dir) ) )
            if not os.path.isdir(dir): continue
            updir = os.path.dirname(dir)
            if updir != dir:
                found = find_file_split( filename, [ updir ], access, depth + 1 )
                if found: return found
                
        
    # not found at all
    return None
 
 

find_files()

python.envutil.find_files	(		filename,
			dirlist,
			access,
			depth )

Search for all (regular) files that match <filename> with access rights <access> (see os.access()) in directory list <dirlist>.
Search is done into subdirectories each directory up to depth <depth>.
The default value for <dirlist> is the current working directory.
If the same file (without the directory name) is found in more than one places, only the first match is kept.
<filename> : can contain wildcards as used on the unix command line.
<depth> = 0 : only search in directories given in list.
<depth> < 0 : treated as = 0
<depth> > 0 : descend deeper into the directory tree up to max <depth> levels.
It returns a list of filenames with full pathnames. If none is found, an empty list is returned.

Definition at line 165 of file envutil.py.

def find_files( filename, dirlist, access, depth ):
    """Search for all (regular) files that match <filename> with access rights <access> (see os.access()) in directory list <dirlist>.
    Search is done into subdirectories each directory up to depth <depth>.
    The default value for <dirlist> is the current working directory.
    If the same file (without the directory name) is found in more than one places, only the first match is kept.
    <filename> : can contain wildcards as used on the unix command line.
    <depth> = 0 : only search in directories given in list.
    <depth> < 0 : treated as = 0
    <depth> > 0 : descend deeper into the directory tree up to max <depth> levels.
    It returns a list of filenames with full pathnames. If none is found, an empty list is returned."""
    return list (map( lambda arg : os.path.join( arg[0], arg[1] ), find_files_split( filename, dirlist, access, depth ) ))
 
 

find_files_env()

python.envutil.find_files_env	(		filename,
			env_var_name,
			access = os.R_OK,
			sep = defaultPathSeps,
			depth = 0 )

Search for all files that match <filename> with access rights <access> (see os.access()) in directory list
given as a <sep> (a regular expression) separated list of paths in environment variable <env_var_name>.
<filename> can contain wildcards as used on the unix command line.
Search into directory tree of each directory up to depth <depth> (0=don't descend at all).

Definition at line 190 of file envutil.py.

def find_files_env( filename, env_var_name, access = os.R_OK, sep = defaultPathSeps, depth = 0 ):
    """Search for all files that match <filename> with access rights <access> (see os.access()) in directory list
    given as a <sep> (a regular expression) separated list of paths in environment variable <env_var_name>.
    <filename> can contain wildcards as used on the unix command line.
    Search into directory tree of each directory up to depth <depth> (0=don't descend at all)."""
    env = os.environ.get( env_var_name )
    envList = [ os.getcwd() ]
    if not env:
        return envList
    envList.extend( re.split( sep, env ) )
    return find_files( filename, envList, access, depth )
 
 

find_files_split()

python.envutil.find_files_split	(		filename,
			dirlist,
			access,
			depth )

Search for all (regular) files that match <filename> with access rights <access> (see os.access())
in directory list <dirlist>.
Search is done into subdirectories each directory up to depth <depth>.
The default value for <dirlist> is the current working directory.
If the same file (without the directory name) is found in more than one places, only the first match is kept.
<filename> : can contain wildcards as used on the unix command line.
<depth> = 0 : only search in directories given in list.
<depth> < 0 : treated as = 0
<depth> > 0 : descend deeper into the directory tree up to max <depth> levels.
It returns a list of 2-tuples (dir,file) where
   file=<filename> if no wildcards, or the actual (local) match to <filename> if wildcarded.
   dir=the directory where <file> was found (from <dirlist>, or from a subdir if depth > 0)
If none is found, an empty list is returned.

Definition at line 99 of file envutil.py.

def find_files_split( filename, dirlist, access, depth ):
    """Search for all (regular) files that match <filename> with access rights <access> (see os.access())
    in directory list <dirlist>.
    Search is done into subdirectories each directory up to depth <depth>.
    The default value for <dirlist> is the current working directory.
    If the same file (without the directory name) is found in more than one places, only the first match is kept.
    <filename> : can contain wildcards as used on the unix command line.
    <depth> = 0 : only search in directories given in list.
    <depth> < 0 : treated as = 0
    <depth> > 0 : descend deeper into the directory tree up to max <depth> levels.
    It returns a list of 2-tuples (dir,file) where
       file=<filename> if no wildcards, or the actual (local) match to <filename> if wildcarded.
       dir=the directory where <file> was found (from <dirlist>, or from a subdir if depth > 0)
    If none is found, an empty list is returned."""
#    if dirlist is None:
#        return []
    if depth < 0: depth = 0
    # to speed up search, do a single file search if the filename does not contain wildcards
    if not has_wildcards(filename):
        singleFile = find_file_split( filename, dirlist, access, depth )
        if singleFile:
            return [ singleFile ]
        else:
            return []
    # filename has wildcards. Find all (first) files that match.
    filenameList = [] # the list of files to return
    dirnameList = [] # keep track of files already found
    for dir in dirlist:
        dir = os.path.abspath( os.path.expandvars( os.path.expanduser(dir) ) )
        # protect against non-existing entries
        if not os.path.isdir(dir): continue
        olddir = os.getcwd()
        os.chdir(dir)

find_libraries()

python.envutil.find_libraries

(

lib

)

Search for libraries in LD_LIBRARY_PATH. Return list of full paths of libraries if found.
<lib> can contain wildcards, in which case all files matching the wildcard will be returned.
If the same file appears in several paths, the first one found will be taken.

Definition at line 203 of file envutil.py.

def find_libraries( lib ):
    """Search for libraries in LD_LIBRARY_PATH. Return list of full paths of libraries if found.
    <lib> can contain wildcards, in which case all files matching the wildcard will be returned.
    If the same file appears in several paths, the first one found will be taken."""
    # require extension .so (or .so with version numbers)
    libsfull = []
    libname = lib
    if _libraryNameRE.search(lib): # fully specified ending
        libsfull = find_files_env( libname, LD_LIBRARY_PATH )
    else:
        libsfull = find_files_env( libname, LD_LIBRARY_PATH )
        # filter results for valid shared library ending (basically to get rid of *.cmtref)
        libsfull = [ l for l in libsfull if _libraryNameRE.search(l) ]
        if not libsfull:
            # add generic ending
            libname = lib + '.so*'
            libsfull = find_files_env( libname, LD_LIBRARY_PATH )
        # filter results for valid shared library ending (basically to get rid of *.cmtref)
        libsfull = [ l for l in libsfull if _libraryNameRE.search(l) ]
        
    # if still not found anything, try with prefix 'lib'
    if not libsfull and not lib.startswith('lib'):
        libsfull = find_libraries( 'lib' + lib )
 
    return libsfull

has_wildcards()

python.envutil.has_wildcards

(

filename

)

Return boolean indicating if the filename contains any unix shell filename wildcards

Definition at line 22 of file envutil.py.

def has_wildcards(filename):
    """Return boolean indicating if the filename contains any unix shell filename wildcards"""
    if filenameWildCardsCompiled.search(filename):
        return True
    else:
        return False
 
 

Variable Documentation

__doc__

str python.envutil.__doc__ = """Environment variables utilities"""

private

Definition at line 6 of file envutil.py.

_libraryNameRE

python.envutil._libraryNameRE = re.compile(r'\.so(\.[0-9]+)*$')

protected

Definition at line 19 of file envutil.py.

defaultPathSeps

str python.envutil.defaultPathSeps = os.pathsep + '|,'

Definition at line 16 of file envutil.py.

dir

python.envutil.dir = os.path.abspath( os.path.expandvars( os.path.expanduser(dir) ) )

print ("Trying %s..." % f)

print ("==> Adding %s to list from %s" % (f,dir))

print ("==> Already have %s in list" % (base))

Definition at line 148 of file envutil.py.

filelist

python.envutil.filelist = glob.glob(filename)

print ("Checking files %s..." % fullfile)

Definition at line 133 of file envutil.py.

filenameWildCards

str python.envutil.filenameWildCards = r'\?|\*|\[.*\]'

Definition at line 12 of file envutil.py.

filenameWildCardsCompiled

python.envutil.filenameWildCardsCompiled = re.compile(filenameWildCards)

Definition at line 13 of file envutil.py.

fulldir

python.envutil.fulldir = os.path.join(dir,d)

Definition at line 153 of file envutil.py.

LD_LIBRARY_PATH

str python.envutil.LD_LIBRARY_PATH = 'LD_LIBRARY_PATH'

Definition at line 9 of file envutil.py.

subdirlist

list python.envutil.subdirlist = []

Definition at line 151 of file envutil.py.