Metadata-Version: 1.1
Name: machobot
Version: 0.1.2
Summary: A set of tools for Mach-O executables analysis on OS X
Home-page: http://github.com/rodionovd/machobot
Author: Dmitry Rodionov
Author-email: i.am.rodionovd@gmail.com
License: MIT
Description: machobot  
        ========  
          
        A Python toolbox for Mach-O files analysis. Heavily relies on
        ``macholib``.   
          
        Installation  
        ------------  
          
        For usage
        '''''''''
        
        ::
        
        	$ [sudo] pip install machobot
        
        For development
        '''''''''''''''
        
        ::
        
        	$ pip install nose macholib
        	$ git clone https://github.com/rodionovd/machobot.git machobot
        	$ cd ./machobot
        	$ nosetests # run the test suite
        
        Usage
        -----
        
        -  As a command-line util:
        
           .. code:: bash
        
        	   $ inject_dylib ./target "@rpath/mylib.dylib"
        
        -  As a Python module:
        
           .. code:: python
        
        	   import machobot
        
           Example usage:
        
           .. code:: python
        
        	   import machobot.dylib as dylib
        
        	   dylib.insert_load_command("output.a", "@executable_path/../../libk.dylib")
        	   
        Modules
        -------
        
        dylib
        '''''''''
        
           .. code:: python
        
        	   insert_load_command (target_path, library_install_name)
        
        Inserts a new ``LC_LOAD_DYLIB`` load command into the target Mach-O
        header.
        
        +----------------------------+-------------------------------------------------------------------------------------------------+
        | Argument                   | Description                                                                                     |
        +============================+=================================================================================================+
        | ``target_path``            | A path to the target Mach-O executable file. **This file will be overwritten**.                 |
        +----------------------------+-------------------------------------------------------------------------------------------------+
        | ``library_install_name``   | An install name for the library to inject. This string is used as a part of the load command.   |
        +----------------------------+-------------------------------------------------------------------------------------------------+
        
        +-----------------------------------------------------------------------+
        | Return value                                                          |
        +=======================================================================+
        | Returns ``True`` if everything is OK. Otherwise rises an exception.   |
        +-----------------------------------------------------------------------+
        
        --------------
        
        Found an issue? `Submit an issue`_.
        
        .. _Sumbit an issue: https://github.com/rodionovd/machobot/issues/new
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
