Skip to main content

Convenient File Handling Library

Project description

Py7File wraps and unifies the python stdlib file handling modules with a simple and intuitive high-level api.


Use easy_install or pip:

pip install py7file


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('')
zfile.unzip() # creates a folder a_file_unzipped with contents of zipfile
zfile.rezip() # repackages subfolder a_file_unzipped to

See for more examples.


Py7File is tested against python 2.6 and 2.7

To run the tests:



Well I am using this this file handling library quite extensivly myself and i got no complaints so far ;). Still please consider this Beta and use at your own risk…


As I 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…



  • fixed get_md5 to use internal filepath


  • .unzip() can now handle gzipped files transparently
  • .unzip() now returns a list containing all extracted files as Py7File objects
  • fixed filepath encoding


Release date: 15-August-2011

  • Added get_number() method for convenient work with numbered files.


Release date: 24-July-2011

  • fixed


Release date: 17-July-2011

  • added new get_sanitized_filename method


Release date: 21-May-2011

  • new EpubFile class that suports epub packaging
  • enhancements for Py7File subclassing


Release date: 10-May-2011

  • basic read method added
  • improved file comparison


Release date: 09-May-2011

  • fixed filepath property to always give absolute path


Release date: 08-May-2011

  • fixed to work with files that have no extension
  • fixed getsize test not returning long on osx
  • added md5 based file comparison
  • .is_binary() detects if file is binary or “text”


Release date: 08-May-2011

  • Fixed for tests on OSX


Release date: 08-May-2011

  • Initial release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for py7file, version 0.7.4
Filename, size File type Python version Upload date Hashes
Filename, size py7file-0.7.4.tar.gz (6.5 kB) File type Source Python version None Upload date Hashes View
Filename, size (11.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page