Metadata-Version: 1.1
Name: objgraph
Version: 1.8.0
Summary: Draws Python object reference graphs with graphviz
Home-page: http://mg.pov.lt/objgraph/
Author: Marius Gedminas
Author-email: marius@gedmin.as
License: MIT
Description: Python Object Graphs
        ====================
        
        .. image:: https://travis-ci.org/mgedmin/objgraph.png?branch=master
           :target: https://travis-ci.org/mgedmin/objgraph
        
        ``objgraph`` is a module that lets you visually explore Python object graphs.
        
        You'll need `graphviz <http://www.graphviz.org/>`_ if you want to draw
        the pretty graphs.
        
        I recommend `xdot <http://pypi.python.org/pypi/xdot>`_ for interactive use.
        ``pip install xdot`` should suffice; objgraph will automatically look for it
        in your ``PATH``.
        
        
        Installation and Documentation
        ------------------------------
        
        ``pip install objgraph`` or `download it from PyPI
        <http://pypi.python.org/pypi/objgraph>`_.
        
        Documentation lives at http://mg.pov.lt/objgraph.
        
        
        .. _history:
        
        History
        -------
        
        I've developed a set of functions that eventually became objgraph when I
        was hunting for memory leaks in a Python program.  The whole story -- with
        illustrated examples -- is in this series of blog posts:
        
        * `Hunting memory leaks in Python
          <http://mg.pov.lt/blog/hunting-python-memleaks.html>`_
        * `Python object graphs
          <http://mg.pov.lt/blog/python-object-graphs.html>`_
        * `Object graphs with graphviz
          <http://mg.pov.lt/blog/object-graphs-with-graphviz.html>`_
        
        
        .. _devel:
        
        Support and Development
        -----------------------
        
        The source code can be found in this Git repository:
        https://github.com/mgedmin/objgraph.
        
        To check it out, use ``git clone https://github.com/mgedmin/objgraph``.
        
        Report bugs at https://github.com/mgedmin/objgraph/issues.
        
        
        
        
        Changes
        =======
        
        
        
        1.8.0 (2014-02-13)
        ------------------
        
        - Moved to GitHub.
        
        - Python 3.4 support (`LP#1270872 <http://launchpad.net/bugs/1270872>`_).
        
        - New function: `is_proper_module`.
        
        - New ``shortnames`` argument for `typestats`, `most_common_types`,
          `show_most_common_types`, `show_growth`, `show_refs`,
          and `show_backrefs`.
        
          `count` and `by_type` accept fully-qualified type names now.
        
          Fixes `issue 4 <https://github.com/mgedmin/objgraph/issues/4>`_.
        
        
        1.7.2 (2012-10-23)
        ------------------
        
        - Bugfix: setup.py sdist was broken on Python 2.7 (UnicodeDecodeError in
          tarfile).
        
        - The ``filename`` argument for `show_refs` and `show_backrefs` now
          allows arbitrary image formats, not just PNG.  Patch by `Riccardo
          Murri <https://launchpad.net/~rmurri>`_.
        
        - Temporary dot files are now named `objgraph-*.dot` instead of `tmp*.dot`.
        
        - Python 3.3 support: no code changes, but some tests started failing because
          the new and improved dictionary implementation no longer holds references to
          str objects used as dict keys.
        
        - Added a tox.ini for convenient multi-Python testing.
        
        
        1.7.1 (2011-12-11)
        ------------------
        
        - Bugfix: non-ASCII characters in object representations would break graph
          generation on Python 3.x, in some locales (e.g. with LC_ALL=C).  Reported and
          fixed by `Stefano Rivera <https://launchpad.net/~stefanor>`_.
        
        - Bugfix: setup.py was broken on Python 3.x
        
        - Bugfix: dot.exe/xdot.exe were not found on Windows (`LP#767239
          <http://launchpad.net/bugs/767239>`_).
        
        - Documentation updates: document the forgotten `find_ref_chain`,
          update `show_chain` prototype.
        
        
        1.7.0 (2011-03-11)
        ------------------
        
        - New function: `find_ref_chain`.
        
        - New ``backrefs`` argument for `show_chain`.
        
        - New function: `get_leaking_objects`, based on `a blog post by
          Kristján Valur
          <http://blog.ccpgames.com/kristjan/2010/12/08/finding-c-reference-leaks-using-the-gc-module/>`_.
        
        - New ``objects`` argument for `count`, `typestats`,
          `most_common_types`, `show_most_common_types`, and
          `by_type`.
        
        - Edges pointing to function attributes such as __defaults__ or __globals__
          are now labeled.
        
        - Edge labels that are not simple strings now show the type.
        
        - Bugfix: '\0' and other unsafe characters used in a dictionary key could
          break graph generation.
        
        - Bugfix: show_refs(..., filename='graph.dot') would then go to complain
          about unrecognized file types and then produce a png.
        
        
        1.6.0 (2010-12-18)
        ------------------
        
        - Python 3 support, thanks to Stefano Rivera (fixes `LP#687601
          <http://launchpad.net/bugs/687601>`_).
        
        - Removed weird weakref special-casing.
        
        
        1.5.1 (2010-12-09)
        ------------------
        
        - Avoid test failures in uncollectable-garbage.txt (fixes `LP#686731
          <http://launchpad.net/bugs/686731>`_).
        
        - Added HACKING.txt (later renamed to HACKING.rst).
        
        
        1.5.0 (2010-12-05)
        ------------------
        
        - Show frame objects as well (fixes `LP#361704
          <http://launchpad.net/bugs/361704>`_).
        
        - New functions: `show_growth`, `show_chain`.
        
        - `find_backref_chain` returns ``[obj]`` instead of ``None`` when a chain
          could not be found.  This makes ``show_chain(find_backref_chain(...), ...)``
          not break.
        
        - Show how many references were skipped from the output of
          `show_refs`/`show_backrefs` by specifying ``too_many``.
        
        - Make `show_refs` descend into modules.
        
        - Do not highlight classes that define a ``__del__``, highlight only instances of
          those classes.
        
        - Option to show reference counts in `show_refs`/`show_backrefs`.
        
        - Add `Sphinx <http://pypi.python.org/pypi/Sphinx>`_ documentation and a PyPI
          long description.
        
        
        1.4.0 (2010-11-03)
        ------------------
        
        - Compatibility with Python 2.4 and 2.5 (``tempfile.NamedTemporaryFile`` has no
          ``delete`` argument).
        
        - New function: `most_common_types`.
        
        
        1.3.1 (2010-07-17)
        ------------------
        
        - Rebuild an sdist with no missing files (fixes `LP#606604
          <http://launchpad.net/bugs/606604>`_).
        
        - Added MANIFEST.in and a Makefile to check that setup.py sdist generates
          source distributions with no files missing.
        
        
        1.3 (2010-07-13)
        ----------------
        
        - Highlight objects with a ``__del__`` method.
        
        - Fixes `LP#483411 <http://launchpad.net/bugs/483411>`_: suggest always passing
          ``[obj]`` to `show_refs`, `show_backrefs`, since obj might be a
          list/tuple.
        
        - Fixes `LP#514422 <http://launchpad.net/bugs/514422>`_: `show_refs`,
          `show_backrefs` don't create files in the current working directory any
          more.  Instead they accept a filename argument, which can be a .dot file or a
          .png file.  If None or not specified, those functions will try to spawn xdot
          as before.
        
        - New extra_info argument to graph-generating functions (patch by Thouis Jones,
          `LP#558914 <http://launchpad.net/bugs/558914>`_).
        
        - setup.py should work with distutils now (`LP#604430
          <http://launchpad.net/bugs/604430>`_, thanks to Randy Heydon).
        
        
        1.2 (2009-03-25)
        ----------------
        
        - Project website, public source repository, uploaded to PyPI.
        
        - No code changes.
        
        
        1.1 (2008-09-10)
        ----------------
        
        - New function: `show_refs` for showing forward references.
        
        - New functions: `typestats` and `show_most_common_types`.
        
        - Object boxes are less crammed with useless information (such as IDs).
        
        - Spawns `xdot <http://pypi.python.org/pypi/xdot>`_ if it is available.
        
        
        1.0 (2008-06-14)
        ----------------
        
        - First public release.
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.4
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
