Releases · matteomattei/PySquashfsImage

02 Jul 23:46

AT0myks

v0.9.0

8f4d3dc

v0.9.0 Latest

Latest

This version drops support for Python 2.6 and 3.0.

Breaking changes

Remove previously deprecated methods
Replace SquashInode and SquashedFile by one class per inode/file type with different attributes and methods
Remove some SquashFsImage attributes: fragment_buffer_size, data_buffer_size, block_size, block_log, all_buffers_size, inode_table, created_inode, total_blocks, total_files, total_inodes, directory_table and inode_to_file. Some were or are now unused, others were simply shortcuts to attributes of the superblock
Rename SquashFsImage.sBlk to SquashFsImage.sblk and make it a property
Rename SquashFsImage.image_file to SquashFsImage._fd
All remaining SquashFsImage attributes are made "private"
Root directory's path is now a single slash
Package layout changes
Rename command line utility from pysquashfsimage to pysquashfs
Change SquashFsImage constructor. The signature is now SquashFsImage(fd, offset=0, closefd=True). Calls to SquashFsImage("/path/to/file", offset=n) must be replaced by SquashFsImage.from_file("/path/to/file", offset=n)
Remove SquashFsImage.set_file(). Use the constructor instead

New API

The most notable changes are:

Instead of being instances of SquashedFile, all files are now instances of a subclass of File
SquashFsImage instances can be used as context managers
Instances of Directory emulate a read-only mapping and have 2 new methods riter() and find()
Instances of RegularFile have 3 methods iter_bytes(), read_bytes() and read_text()
Iterating over an instance of SquashFsImage will yield all its files recursively as if using root.riter()

Other changes

Add SquashFsImage.from_bytes(), SquashFsImage.find() and SquashFsImage.select()
All file types are now "scanned", not just directories, regular files and symlinks
All struct-based classes are now ctypes-based
Add support for LZO compression
Add support for holes
Reading large files is a lot faster
Add functions for image extraction (extended attributes not supported yet)
Add LRU cache for Python 3.2+ which can greatly speed up file reads in certain conditions
Add SquashFsImage.size property
Add find_superblocks()
Add support for calling dict() on structures (instances of structure._Base)
New CLI with 3 subcommands

Full Changelog: v0.8.0...v0.9.0

Assets 4

03 May 16:45

AT0myks

v0.8.0

88a1c66

v0.8.0

Formatting, dead code and quick fixes (#20)
Use stat.filemode() in getMode() when using Python 3 (#20)
All compressors are now a subclass of _Compressor (#21)
Use struct (#21)
File names and paths are now instances of str (#22)
Replace fill by the from_bytes class method (#22)
Use argparse for command line parsing (#22)
New pysquashfsimage command (#22)
Python 2 fixes (#23)
Decompressors fixes (#23)
Change internal classes names to comply with PEP 8 (#23)

API changes

Move towards an API similar to pathlib's (#23)
Add is_{file,socket,fifo,block_device,char_device} properties to SquashedFile and SquashInode (#23)
SquashedFile.hasAttribute() and SquashInode.hasAttribute() have been removed, use the is_* properties instead (#23)
SquashInode.xattr is now a property, SquashInode.getXattr() is deprecated (#23)
SquashInode.getContent() is deprecated, use SquashInode.read_bytes() instead (#23)
SquashedFile.name is now a property, SquashedFile.getName() is deprecated (#23)
SquashedFile.xattr is now a property, SquashedFile.getXattr() is deprecated (#23)
Add SquashedFile.path property, SquashedFile.getPath() is deprecated (#23)
Add SquashedFile.size property, SquashedFile.getLength() is deprecated (#23)
Add SquashedFile.filemode property, SquashedFile.getMode() is deprecated (#23)
SquashedFile.findAll() is deprecated, use SquashedFile.find_all() instead (#23)
SquashedFile.findAllPaths() is deprecated, use SquashedFile.find_all_paths() instead (#23)
SquashedFile.getContent() is deprecated, use SquashedFile.read_bytes() instead (#23)
SquashedFile.isFolder() is deprecated, use the SquashedFile.is_dir property instead (#23)
SquashedFile.isLink() is deprecated, use the SquashedFile.is_symlink property instead (#23)
SquashedFile.getLink() is deprecated, use SquashedFile.readlink() instead (#23)
SquashFsImage.root is now a property, SquashFsImage.getRoot() is deprecated (#23)
SquashFsImage.setFile() is deprecated, use SquashFsImage.set_file() instead (#23)
SquashFsImage.getFileContent() is deprecated, use SquashFsImage.read_file() instead (#23)

The deprecated methods will be removed in a future version.

New Contributors

@AT0myks made their first contribution in #20

Full Changelog: v0.7...v0.8.0

Contributors

AT0myks

Assets 2

02 May 23:01

AT0myks

v0.7

198266b

v0.7.1

Add support for LZ4 compression (#9) by @charles-dyfis-net
Avoid calling import each time we call uncompress() (#9) by @charles-dyfis-net
Only load decompressors when needed (#9) by @charles-dyfis-net
Fix xattrs loading (#8) by @Dr-Emann
Use int.from_bytes() with Python 3 (#10) by @nigels-com
Add support for symlinks (#11) by @nigels-com
Fix select() to work with Python 3 (#12) by @nigels-com
Add getMode() to get an ls-style string for file type and permissions (#12) by @nigels-com
Add reference links (#13) by @nigels-com
Update getMode() to also show SUID and SGID (#14) by @nigels-com
Fix processing of SQUASHFS_LREG_TYPE entries (#15) by @darktemplarbasealt
Add getXattr() methods (#17) by @franksinankaya
Add support for Zstandard compression (#18) by @shashank956
Replace compressors list with dictionary (#19) by @shashank956