Metadata-Version: 1.0
Name: py7file
Version: 0.3
Summary: Convenient File Handling Library
Home-page: http://github.com/titusz/py7file
Author: Titusz
Author-email: tp@py7.de
License: BSD
Description: ==========================================
        Py7File - Simple file handling with python
        ==========================================
        
        *Py7File wraps and unifies the python stdlib file handling modules with a simple
        and intuitive high-level api.*
        
        **Think:** os.path, shutil etc. via object based method access.
        
        **Author:** *Titusz (tp@py7.de)*
        **Source Code**: http://github.com/titusz/py7file
        **License**: BSD
        
        Installation
        ------------
        
        Use easy_install or pip::
        
            pip install py7file
        
        
        Usage
        -----
        Here some hopefully self explaining examples of Py7File usage::
        
            from py7file import Py7File
        
            the_file = Py7File('a_file.txt')
        
            # Copy and Move
            copied_file = the_file.copy('d_file.txt')  # copied_file is also a Py7file
            the_file.move('moved_file.txt')  # moves the file and mutates the reference
        
            # Backup and Restore
            the_file.backup()  # creates a_file_backup_001.txt
            the_file.backup()  # creates a_file_backup_002.txt
            the_file.delete()  # removes a_file.txt from disk (ups...)
            the_file.restore() # recovers file from a_file_backup_002.txt
        
            # Unzip and Rezip
            zfile = Py7File('a_file.zip')
            zfile.unzip() # creates a subfolder a_file with contents of zipfile
            zfile.rezip() # repackages subfolder a_file to a_file.zip
            
        See test_py7file.py for more examples.
        
        Testing
        -------
        To run the tests::
        
            python test_py7file.py
        
        Status
        ------
        Alpha - Use at own risk...
        
        Background
        ----------
        As a started learning programming with python I found the different modules for
        handling files very confusing and cumbersome to use. While writing my first
        scripts I found myself writing os.path.join(...) way to often. I still
        keep mixing up os and shutil based file operations like copy, move, rename.
        So I started this little module to make things easier...
        
        News
        ====
        
        0.2
        ---
        
        *Release date: 08-May-2011*
        
        * Fixed for tests on OSX
        
        0.1
        ---
        
        *Release date: 08-May-2011*
        
        * Initial release
        
        
Keywords: file copy move backup unzip open os.path shutil wrapper api
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Desktop Environment :: File Managers
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
