cpp/scons/scons-local-2.0.0.final.0/SCons/Scanner/Dir.py

   1 #
   2 # Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 The SCons Foundation
   3 #
   4 # Permission is hereby granted, free of charge, to any person obtaining
   5 # a copy of this software and associated documentation files (the
   6 # "Software"), to deal in the Software without restriction, including
   7 # without limitation the rights to use, copy, modify, merge, publish,
   8 # distribute, sublicense, and/or sell copies of the Software, and to
   9 # permit persons to whom the Software is furnished to do so, subject to
  10 # the following conditions:
  11 #
  12 # The above copyright notice and this permission notice shall be included
  13 # in all copies or substantial portions of the Software.
  14 #
  15 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
  16 # KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  17 # WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  18 # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  19 # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  20 # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  21 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  22
  23 __revision__ = "src/engine/SCons/Scanner/Dir.py 5023 2010/06/14 22:05:46 scons"
  24
  25 import SCons.Node.FS
  26 import SCons.Scanner
  27
  28 def only_dirs(nodes):
  29     is_Dir = lambda n: isinstance(n.disambiguate(), SCons.Node.FS.Dir)
  30     return list(filter(is_Dir, nodes))
  31
  32 def DirScanner(**kw):
  33     """Return a prototype Scanner instance for scanning
  34     directories for on-disk files"""
  35     kw['node_factory'] = SCons.Node.FS.Entry
  36     kw['recursive'] = only_dirs
  37     return SCons.Scanner.Base(scan_on_disk, "DirScanner", **kw)
  38
  39 def DirEntryScanner(**kw):
  40     """Return a prototype Scanner instance for "scanning"
  41     directory Nodes for their in-memory entries"""
  42     kw['node_factory'] = SCons.Node.FS.Entry
  43     kw['recursive'] = None
  44     return SCons.Scanner.Base(scan_in_memory, "DirEntryScanner", **kw)
  45
  46 skip_entry = {}
  47
  48 skip_entry_list = [
  49    '.',
  50    '..',
  51    '.sconsign',
  52    # Used by the native dblite.py module.
  53    '.sconsign.dblite',
  54    # Used by dbm and dumbdbm.
  55    '.sconsign.dir',
  56    # Used by dbm.
  57    '.sconsign.pag',
  58    # Used by dumbdbm.
  59    '.sconsign.dat',
  60    '.sconsign.bak',
  61    # Used by some dbm emulations using Berkeley DB.
  62    '.sconsign.db',
  63 ]
  64
  65 for skip in skip_entry_list:
  66     skip_entry[skip] = 1
  67     skip_entry[SCons.Node.FS._my_normcase(skip)] = 1
  68
  69 do_not_scan = lambda k: k not in skip_entry
  70
  71 def scan_on_disk(node, env, path=()):
  72     """
  73     Scans a directory for on-disk files and directories therein.
  74
  75     Looking up the entries will add these to the in-memory Node tree
  76     representation of the file system, so all we have to do is just
  77     that and then call the in-memory scanning function.
  78     """
  79     try:
  80         flist = node.fs.listdir(node.abspath)
  81     except (IOError, OSError):
  82         return []
  83     e = node.Entry
  84     for f in  filter(do_not_scan, flist):
  85         # Add ./ to the beginning of the file name so if it begins with a
  86         # '#' we don't look it up relative to the top-level directory.
  87         e('./' + f)
  88     return scan_in_memory(node, env, path)
  89
  90 def scan_in_memory(node, env, path=()):
  91     """
  92     "Scans" a Node.FS.Dir for its in-memory entries.
  93     """
  94     try:
  95         entries = node.entries
  96     except AttributeError:
  97         # It's not a Node.FS.Dir (or doesn't look enough like one for
  98         # our purposes), which can happen if a target list containing
  99         # mixed Node types (Dirs and Files, for example) has a Dir as
 100         # the first entry.
 101         return []
 102     entry_list = sorted(filter(do_not_scan, list(entries.keys())))
 103     return [entries[n] for n in entry_list]
 104
 105 # Local Variables:
 106 # tab-width:4
 107 # indent-tabs-mode:nil
 108 # End:
 109 # vim: set expandtab tabstop=4 shiftwidth=4: