Metadata-Version: 2.1
Name: analyze-objects
Version: 0.1.0
Summary: Contains command line tools an python functions to search symbols in object files (.o, .obj).
Home-page: UNKNOWN
Author: Philip Schill
Author-email: philip.schill@gmx.de
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Dist: colorama

analyze_objects
===============

*analyze_objects* contains command line tools that analyze compile object files (.o, .obj). It is a wrapper around the
platform specific tools ``nm`` (linux) or ``dumpbin`` (windows).

Currently, it consists of the single shell command ``find_symbols``.

Installing
----------

Install from pip::

    python -m pip install analyze_objects

Usage
-----

If binaries of installed python packages are added to the PATH, you can call ``find_symbols`` directly from the shell::

    find_symbols

Otherwise, it can be invoked using python::

    python -m analyze_objects.find_symbols

Documentation
-------------

Use the following command to search the object files ``foo.o`` and ``bar.o`` for undefined symbols that match the
regular expression ``"foo"``::

    find_symbols --undef_regex foo foo.o bar.o

Using this command requires that ``nm`` (linux) or ``dumpbin`` (windows) are available in the PATH. If that is not the
case, you can use the ``--nm_exe`` or ``--dumpbin_exe`` arguments to pass their location to ``find_symbols``.

Use ``--def_regex`` instead of ``--undef_regex`` to search for defined symbols. It is
possible to combine both arguments and search for both defined and undefined symbols.

The ``find_symbols`` command accepts an arbitrary number of object files. It is possible to use placeholders ``**`` and
``*`` in the object file paths.


