Skip to content

enthought/machotools

Repository files navigation

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)