Skip to content

v1.2.0
Compare
Choose a tag to compare
@dgelessus dgelessus released this 13 Sep 08:11
· 145 commits to master since this release
v1.2.0
fb5708e

  • Added support for compressed resources.

    • Compressed resource data is automatically decompressed, both in the Python API and on the command line.
    • This is technically a breaking change, since in previous versions the compressed resource data was returned directly. However, this change will not affect end users negatively, unless one has already implemented custom handling for compressed resources.
    • Currently, only the three standard System 7.0 compression formats ('dcmp' IDs 0, 1, 2) are supported. Attempting to access a resource compressed in an unsupported format results in a DecompressError.
    • To access the raw resource data as stored in the file, without automatic decompression, use the res.data_raw attribute (for the Python API), or the --no-decompress option (for the command-line interface). This can be used to read the resource data in its compressed form, even if the compression format is not supported.

  • Improved automatic data/resource fork selection for files whose resource fork contains invalid data.

    • This fixes reading certain system files with resource data in their data fork (such as HIToolbox.rsrc in HIToolbox.framework, or .dfont fonts) on recent macOS versions (at least macOS 10.14, possibly earlier). Although these files have no resource fork, recent macOS versions will successfully open the resource fork and return garbage data for it. This behavior is now detected and handled by using the data fork instead.

  • Replaced the rsrcfork parameter of rsrcfork.open/ResourceFork.open with a new fork parameter. fork accepts string values (like the command line --fork option) rather than rsrcfork's hard to understand None/True/False.

    • The old rsrcfork parameter has been deprecated and will be removed in the future, but for now it still works as before.

  • Added an explanatory message when a resource filter on the command line doesn't match any resources in the resource file. Previously there would either be no output or a confusing error, depending on the selected --format.

  • Changed resource type codes and names to be displayed in MacRoman instead of escaping all non-ASCII characters.

  • Cleaned up the resource descriptions in listings and dumps to improve readability. Previously they included some redundant or unnecessary information - for example, each resource with no attributes set would be explicitly marked as "no attributes".

  • Unified the formats of resource descriptions in listings and dumps, which were previously slightly different from each other.

  • Improved error messages when attempting to read multiple resources using --format=hex or --format=raw.

  • Fixed reading from non-seekable streams not working for some resource files.

  • Removed the allow_seek parameter of ResourceFork.__init__ and the --read-mode command line option. They are no longer necessary, and were already practically useless before due to non-seekable stream reading being broken.

Assets 2
Loading