skip to navigation
skip to content

pd.find 0.0.3

Multipurpose module used to access filesystem items

Downloads ↓ 

Short module description
=========================

Module pd.find present simple way use filesystem
to search and read files on it. File system using
showed as simple as using ordinal dict::

    >>> import pd.find
    >>> f=pd.find.file.File("/etc/sysconfig")
    >>> f
    '/etc/sysconfig'
    >>> f.keys()
    ['harddisk', 'lm_sensors', 'ipw3945d~', 'syscheckerrc', 'mouse']
    >>> f['lm_sensors']
    '/etc/sysconfig/lm_sensors'
    >>> print str(f['lm_sensors'])
    #    /etc/sysconfig/lm_sensors - Defines modules loaded by

Other important pakage mission is find files by the way similar
to command line find utility::

    >>> import pd.find
    >>> pd.find.find("/etc/sysconfig",lambda x : x.isreg() and x.check_regex(".*rc"))
    
    >>> for item in pd.find.find("/etc/sysconfig",lambda x : x.isreg() and x.check_regex(".*rc$")) :
    ... print item.path
    ...
    /etc/sysconfig/xinitrc
    /etc/sysconfig/syscheckerrc
    >>>

Using  pd.find.file.File
--------------------------

Constructor issued as in example above, with one required
argument - path to file or directory. There are other
arguments:

    dereference
        Follow symlinks (is False by default)

The File object to provide some useful methods and attributes:

    path
        Attribute present absolute file path;

    __str__()
        Method returns file body if it can;

Other attributes do condition check and will be described bellow.

Issue pd.find.find utility
--------------------------

The pd.find.find utility issued to reqursive search files to satisfy
some conditions. Utility accept followed arguments:

    path
        Directory path to search begin with;

    condition
        Condition checked on scanned files and directories. If condition satisfy - object
        yielded by utility;

    precondition
        Condition checked before subdirectory scan. If condition does not satisfy,
        subdirectory will not be scaned;

    dereference
        On true value of this argument searhing will be followed by symbolic
        link.

Utility return generator of list object find by them.

Tests provided by File Object
-----------------------------

    mtime
        Return modification time

    atime
        Return last access time

    ctime
        Return creation time """
        return self.__checktime_(stat.ST_CTIME)

    newer
        Return true if object is more newer then input path

    check_name
        Return true if object name are equal to input name

    check_path
        Return true if object path are equal to input path

    check_path_regex
        Return true if regexp matched object path

    check_regex
        Return true if regexp matched object name

    check_iregex
        Return true if regexp matched object name

    depth
        Return current depth on file tree

    dele
        Delete file by path of current object

    execute
        Frm will be substituted by substring "{}" on path and executed
        by os.system() call

Ho-ho. Sorry my English :)


* Sat Nov 10 2007  Andrey Orlov  0.0.3
- Some documentation wrote

* Wed Nov 9 2007 Andrey Orlov  0.0.2
- first official release
 
File Type Py Version Uploaded on Size # downloads
pd.find-0.0.3.tar.gz (md5) Source 2007-11-10 6KB 8136