Machotools is a small set of tools built on top of macholib to retrieve and change informations about mach-o files. Think of it as a pure python, cross-platform implementation of install_name_tool
Examples:
# Print the list of rpath defined in the given .dylib
python -m machotools list_rpaths foo.dylib
# Print the id (i.e. install_name) of the given .dylib
python -m machotools install_name foo.dylib
# Print the list of libraries linked in the given mach-o (simple otool
# -L)
python -m machotools list_libraries a.out
Internally, machotools is written as a library so that it can be used within bigger tools, but the API is currently in-flux until the first 1.0 release.
Example:
from machotools import rewriter_factory
rewriter = rewriter_factory("foo.dylib")
print rewriter.dependencies
# install_name property only available if rewriter is a DylibRewriter
# instance (auto-detected in rewriter_factory)
print rewriter.install_name
print rewriter.rpaths
rewriter.install_name = "bar.dylib"
# Changes are not actually written until you call commit()
rewriter.commit()
# When modifying a binary, one can also use context manager so that
# changes are automatically committed when exciting the context.
with rewriter_factory("foo.dylib") as rewriter:
rewriter.install_name = "bar.dylib"
Main features:
- ability to query/change rpath
- ability to query/change the install name
- ability to query/change the dependencies
- should work on any platform supported by macholib (mac os x, unix, windows)
- modifications are safe against crash/interruption as files are never modified in place. Instead, modifications are made against a temporary copy, and replace the original file using atomic rename on Posix (emulated on windows).
Development happens on github
TODO:
- support for multi arch
- more detailed output for list_libraries (including versioning info)