Utilities for working with files.
Project description
[](https://coveralls.io/github/jdidion/xphyle?branch=master)
# xphyle: extraordinarily simple file handling
xphyle is a small python (3.3+) library that makes it easy to open compressed
files for the highest-possible performance available on your system. It also
provides some convenience methods for working with file paths.
[Documentation](https://xphyle.readthedocs.io)
# Installation
```
pip install xphyle
```
# Example usages:
```python
from xphyle import *
# Open a compressed file
myfile = xopen('infile.gz')
# Print all lines in a compressed file
with open_('infile.gz') as myfile:
for line in myfile:
print(line)
# Transparently handle paths and file objects
def dostuff(path_or_file):
with open_(path_or_file) as myfile:
for line in myfile:
print(line)
# Read all lines in a compressed file into a list
from xphyle.utils import safe_file_iter
lines = list(safe_iter('infile.gz'))
# Sum the rows in a compressed file where each line is an integer value
total = sum(i for i in safe_iter('infile.gz', convert=int))
```
# Roadmap
## 0.8
* Documentation
## 0.9
* Formalize the plug-in interface for alternative compression formats
* Consider natively supporting other popular compression formats:
* LZW: the only decent library is python-lzw, and it doesn't provide an open method
* Snappy (via python-snappy): this is problematic since it depends on libsnappy, with no pure python fallback
## 1.0
* Add support for archive formats
* tar, zip
* Recognize .tgz, .tbz2, and .tlz extensions
* Support 7zip archives: this is problematic as it depends on 7zip being installed, with no pure python fallback
* Consider using libarchive (if installed) via one of the several available python packages. Will have to do performance testing to determine whether this should be the first option or the second to try.
* Many other archive formats that might be supported - which are most important? arc, cab (windows-specific), dmg (mac-specific), iso9660, lzh, rar, xar, zz
[](https://coveralls.io/github/jdidion/xphyle?branch=master)
# xphyle: extraordinarily simple file handling
xphyle is a small python (3.3+) library that makes it easy to open compressed
files for the highest-possible performance available on your system. It also
provides some convenience methods for working with file paths.
[Documentation](https://xphyle.readthedocs.io)
# Installation
```
pip install xphyle
```
# Example usages:
```python
from xphyle import *
# Open a compressed file
myfile = xopen('infile.gz')
# Print all lines in a compressed file
with open_('infile.gz') as myfile:
for line in myfile:
print(line)
# Transparently handle paths and file objects
def dostuff(path_or_file):
with open_(path_or_file) as myfile:
for line in myfile:
print(line)
# Read all lines in a compressed file into a list
from xphyle.utils import safe_file_iter
lines = list(safe_iter('infile.gz'))
# Sum the rows in a compressed file where each line is an integer value
total = sum(i for i in safe_iter('infile.gz', convert=int))
```
# Roadmap
## 0.8
* Documentation
## 0.9
* Formalize the plug-in interface for alternative compression formats
* Consider natively supporting other popular compression formats:
* LZW: the only decent library is python-lzw, and it doesn't provide an open method
* Snappy (via python-snappy): this is problematic since it depends on libsnappy, with no pure python fallback
## 1.0
* Add support for archive formats
* tar, zip
* Recognize .tgz, .tbz2, and .tlz extensions
* Support 7zip archives: this is problematic as it depends on 7zip being installed, with no pure python fallback
* Consider using libarchive (if installed) via one of the several available python packages. Will have to do performance testing to determine whether this should be the first option or the second to try.
* Many other archive formats that might be supported - which are most important? arc, cab (windows-specific), dmg (mac-specific), iso9660, lzh, rar, xar, zz
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
xphyle-0.7.5.tar.gz
(42.9 kB
view hashes)
