Changelogs » Hunter

Hunter

3.0.3

------------------

* Fixed ``safe_repr`` on pypy so it's safer on method objects.

3.0.2

------------------

* Fixed setting ``stream`` from ``PYTHONHUNTERCONFIG`` environment variable.
* Fixed a couple minor documentation issues.

3.0.1

------------------

* Fixed issue with coloring missing source message (coloring leaked into next line).

3.0.0

------------------

* The package now uses setuptools-scm for development builds (available at https://test.pypi.org/project/hunter/). As a
consequence installing the sdist will download setuptools-scm.
* Recompiled cython modules with latest Cython. Hunter can be installed without any Cython, as before.
* Refactored some of the cython modules to have more typing information and not use deprecated property syntax.
* Replaced ``unsafe_repr`` option with ``repr_func``. Now you can use your custom repr function in the builtin actions.
**BACKWARDS INCOMPATIBLE**
* Fixed buggy filename handling when using Hunter in ipython/jupyter. Source code should be properly displayed now.
* Removed ``globals`` option from ``VarsPrinter`` action. Globals are now always looked up. **BACKWARDS INCOMPATIBLE**
* Added support for locals in ``VarsPrinter`` action. Now you can do ``VarsPrinter('len(foobar)')``.
* Always pass module_globals dict to linecache methods. Source code from PEP-302 loaders is now printed properly.
Contributed by Mikhail Borisov in `65 <https://github.com/ionelmc/python-hunter/pull/65>`_.
* Various code cleanup, style and docstring fixing.
* Added :func:`hunter.From` helper to allow passing in filters directly as keyword arguments.
* Added :meth:`hunter.event.Event.detach` for storing events without leaks or side-effects (due to prolonged references
to Frame objects, local or global variables).
* Refactored the internals of actions for easier subclassing.

Added the
:meth:`~hunter.actions.ColorStreamAction.filename_prefix`,
:meth:`~hunter.actions.ColorStreamAction.output`,
:meth:`~hunter.actions.ColorStreamAction.pid_prefix`,
:meth:`~hunter.actions.ColorStreamAction.thread_prefix`,
:meth:`~hunter.actions.ColorStreamAction.try_repr` and
:meth:`~hunter.actions.ColorStreamAction.try_source` methods
to the :class:`hunter.actions.ColorStreamAction` baseclass.
* Added :class:`hunter.actions.VarsSnooper` - a PySnooper-inspired variant of :class:`~hunter.actions.VarsPrinter`. It
will record and show variable changes, with the risk of leaking or using too much memory of course :)
* Fixed tracers to log error and automatically stop if there's an internal failure. Previously error may have been
silently dropped in some situations.

2.2.1

------------------

* Fixed a link in changelog.
* Fixed some issues in the Travis configuration.

2.2.0

------------------

* Added :class:`hunter.predicates.From` predicate for tracing from a specific point. It stop after returning back to the
same call depth with a configurable offset.
* Fixed ``PYTHONHUNTERCONFIG`` not working in some situations (config values were resolved at the wrong time).
* Made tests in CI test the wheel that will eventually be published to PyPI
(`tox-wheel <https://pypi.org/project/tox-wheel/>`_).
* Made ``event.stdlib`` more reliable: ``pkg_resources`` is considered part of stdlib and few more paths will be
considered as stdlib.
* Dumbed down the ``get_peercred`` check that is done when attaching with ``hunter-trace`` CLI (via
``hunter.remote.install()``). It will be slightly insecure but will work on OSX.
* Added OSX in the Travis test grid.

2.1.0

------------------

* Made ``threading_support`` on by default but output automatic (also, now ``1`` or ``0`` allowed).
* Added ``pid_alignment`` and ``force_pid`` action options to show a pid prefix.
* Fixed some bugs around ``__eq__`` in various classes.
* Dropped Python 3.3 support.
* Dropped dependency on `fields <https://python-fields.readthedocs.io/en/stable/>`_.
* Actions now repr using a simplified implementation that tries to avoid calling ``__repr__`` on user classes in order
to avoid creating side-effects while tracing.
* Added support for the ``PYTHONHUNTERCONFIG`` environment variable (stores defaults and doesn't activate hunter).

2.0.2

------------------

* Fixed indentation in :class:`hunter.actions.CallPrinter` action (shouldn't deindent on exception).
* Fixed option filtering in Cython Query implementation (filtering on ``tracer`` was allowed by mistake).
* Various fixes to docstrings and docs.

2.0.1

------------------

* Now ``Py_AddPendingCall`` is used instead of acquiring the GIL (when using GDB).

2.0.0

------------------

* Added the :attr:`hunter.event.Event.count` and :attr:`hunter.event.Event.calls`` attributes.
* Added the ``lt``/``lte``/``gt``/``gte`` lookups.
* Added convenience aliases for ``startswith`` (``sw``), ``endswith`` (``ew``), ``contains`` (``has``)
and ``regex`` (``rx``).
* Added a convenience :func:`hunter.wrap` decorator to start tracing around a function.
* Added support for remote tracing (with two backends: `manhole <https://pypi.python.org/pypi/manhole>`__ and GDB) via
the ``hunter-trace`` bin. Note: **Windows is NOT SUPPORTED**.
* Changed the default action to :class:`hunter.actions.CallPrinter`.
You'll need to use ``action=CodePrinter`` if you want the old output.

1.4.1

------------------

* Fix support for getting sources for Cython module (it was broken on Windows and Python3.5+).

1.4.0

------------------

* Added support for tracing Cython modules (`30 <https://github.com/ionelmc/python-hunter/issues/30>`_). A
` cython: linetrace=True` stanza or equivalent is required in Cython modules for this to work.

1.3.0

------------------

* Added :attr:`hunter.event.Event.thread`.
* Added :attr:`hunter.event.Event.threadid` and :attr:`hunter.event.Event.threadname`
(available for filtering with :func:`hunter.Q`).
* Added :attr:`hunter.event.Event.threading_support` argument to :func:`hunter.trace`.
It makes new threads be traced and changes action output to include thread name.
* Added support for using `pdb++ <https://pypi.python.org/pypi/pdbpp>`_ in the :class:`hunter.actions.Debugger` action.
* Added support for using `manhole <https://pypi.python.org/pypi/manhole>`_ via a new :class:`hunter.actions.Manhole`
action.
* Made the :attr:`hunter.event.Event.handler` a public but readonly property.

1.2.2

------------------

* Fix broken import. Require `fields>=4.0`.
* Simplify a string check in Cython code.

1.2.1

------------------

* Fix "KeyError: 'normal'" bug in :class:`hunter.actions.CallPrinter`. Create the NO_COLORS dict from the COLOR dicts.
Some keys were missing.

1.2.0

------------------

* Fixed printouts of objects that return very large string in ``__repr__()``. Trimmed to 512. Configurable in actions
with the ``repr_limit`` option.
* Improved validation of :class:`hunter.actions.VarsPrinter`'s initializer.
* Added a :class:`hunter.actions.CallPrinter` action.

1.1.0

------------------

* Implemented a destructor (``__dealloc__``) for the Cython tracer.
* Improved the restoring of the previous tracer in the Cython tracer (use ``PyEval_SetTrace``) directly.
* Removed ``tracer`` as an allowed filtering argument in ``hunter.Query``.
* Add basic validation (must be callable) for positional arguments and actions passed into ``hunter.Q``. Closes
`23 <https://github.com/ionelmc/python-hunter/issues/23>`_.
* Fixed ``stdlib`` checks (wasn't very reliable). Closes `24 <https://github.com/ionelmc/python-hunter/issues/24>`_.

1.0.2

------------------

* Fixed missing import in ``setup.py``.

1.0.1

------------------

* Fix a compile issue with the MSVC compiler (seems it don't like the inline option on the ``fast_When_call``).

1.0.0

------------------

* Implemented fast tracer and query objects in Cython. **MAY BE BACKWARDS INCOMPATIBLE**

To force using the old pure-python implementation set the ``PUREPYTHONHUNTER`` environment variable to non-empty value.
* Added filtering operators: ``contains``, ``startswith``, ``endswith`` and ``in``. Examples:

* ``Q(module_startswith='foo'`` will match events from ``foo``, ``foo.bar`` and ``foobar``.
* ``Q(module_startswith=['foo', 'bar']`` will match events from ``foo``, ``foo.bar``, ``foobar``, ``bar``, ``bar.foo`` and ``baroo`` .
* ``Q(module_endswith='bar'`` will match events from ``foo.bar`` and ``foobar``.
* ``Q(module_contains='ip'`` will match events from ``lipsum``.
* ``Q(module_in=['foo', 'bar']`` will match events from ``foo`` and ``bar``.
* ``Q(module_regex=r"(re|sre.*)\b") will match events from ``re``, ``re.foobar``, ``srefoobar`` but not from ``repr``.

* Removed the ``merge`` option. Now when you call ``hunter.trace(...)`` multiple times only the last one is active.
**BACKWARDS INCOMPATIBLE**
* Remove the `previous_tracer handling`. Now when you call ``hunter.trace(...)`` the previous tracer (whatever was in
``sys.gettrace()``) is disabled and restored when ``hunter.stop()`` is called. **BACKWARDS INCOMPATIBLE**
* Fixed ``CodePrinter`` to show module name if it fails to get any sources.

0.6.0

------------------

* Added a ``clear_env_var`` option on the tracer (disables tracing in subprocess).
* Added ``force_colors`` option on :class:`hunter.actions.VarsPrinter` and :class:`hunter.actions.CodePrinter`.
* Allowed setting the `stream` to a file name (option on :class:`hunter.actions.VarsPrinter` and
:class:`hunter.actions.CodePrinter`).
* Bumped up the filename alignment to 40 cols.
* If not merging then `self` is not kept as a previous tracer anymore.
Closes `16 <https://github.com/ionelmc/python-hunter/issues/16>`_.
* Fixed handling in VarsPrinter: properly print eval errors and don't try to show anything if there's an AttributeError.
Closes `18 <https://github.com/ionelmc/python-hunter/issues/18>`_.
* Added a ``stdlib`` boolean flag (for filtering purposes).
Closes `15 <https://github.com/ionelmc/python-hunter/issues/15>`_.
* Fixed broken frames that have "None" for filename or module (so they can still be treated as strings).
* Corrected output files in the ``install_lib`` command so that pip can uninstall the pth file.
This only works when it's installed with pip (sadly, ``setup.py install/develop`` and ``pip install -e`` will still
leave pth garbage on ``pip uninstall hunter``).

0.5.1

------------------

* Fixed :attr:`hunter.event.Event.globals` to actually be the dict of global vars (it was just the locals).

0.5.0

------------------

* Fixed :func:`hunter.And` and :func:`hunter.Or` "single argument unwrapping".
* Implemented predicate compression. Example: ``Or(Or(a, b), c)`` is converted to ``Or(a, b, c)``.
* Renamed :attr:`hunter.event.Event.source` to :attr:`hunter.event.Event.fullsource`.
* Added :attr:`hunter.event.Event.source` that doesn't do any fancy sourcecode tokenization.
* Fixed :attr:`hunter.event.Event.fullsource` return value for situations where the tokenizer would fail.
* Made the print function available in the ``PYTHONHUNTER`` env var payload.
* Added a __repr__ for :class:`hunter.event.Event`.

0.4.0

------------------

* Disabled colors for Jython.
Contributed by Claudiu Popa in `12 <https://github.com/ionelmc/python-hunter/pull/12>`_.
* Test suite fixes for Windows.
Contributed by Claudiu Popa in `11 <https://github.com/ionelmc/python-hunter/pull/11>`_.
* Added an introduction section in the docs.
* Implemented a prettier fallback for when no sources are available for that frame.
* Implemented fixups in cases where you use action classes as a predicates.

0.3.1

------------------

* Forgot to merge some commits ...

0.3.0

------------------

* Added handling for internal repr failures.
* Fixed issues with displaying code that has non-ascii characters.
* Implemented better display for ``call`` frames so that when a function has decorators the
function definition is shown (instead of just the first decorator).
See: `8 <https://github.com/ionelmc/python-hunter/issues/8>`_.

0.2.1

------------------

* Added missing color entry for exception events.
* Added :attr:`hunter.event.Event.line` property. It returns the source code for the line being run.

0.2.0

------------------

* Added color support (and ``colorama`` as dependency).
* Added support for expressions in :class:`hunter.actions.VarsPrinter`.
* Breaking changes:

* Renamed ``F`` to :func:`hunter.Q`. And :func:`hunter.Q` is now just a convenience wrapper for
:class:`hunter.predicates.Query`.
* Renamed the ``PYTHON_HUNTER`` env variable to ``PYTHONHUNTER``.
* Changed :class:`hunter.predicates.When` to take positional arguments.
* Changed output to show 2 path components (still not configurable).
* Changed :class:`hunter.actions.VarsPrinter` to take positional arguments for the names.
* Improved error reporting for env variable activation (``PYTHONHUNTER``).
* Fixed env var activator (the ``.pth`` file) installation with ``setup.py install`` (the "egg installs") and
``setup.py develop``/``pip install -e`` (the "egg links").

0.1.0

------------------

* First release on PyPI.