- Drop support for Python 3.7.
- Upgrade linters and refactor various string formatting and other cleanups.
- Upgrade Cython to latest release (3.0.10).
- Linux wheels should be back now.
- Switched docs theme to furo.
- Added safe repr support for Decimal objects.
- Added C extension support for Python 3.11. This may come with up to 10% performance hit (depending on use-case) for all Pythons. Unfortunately some compat shims are now used for getting frame details. This is necessary to be able to work with Python 3.11 and be more future-proof.
- Added safe repr support for ZoneInfo objects.
- C extension files are now prebuilt with Cython 3.0b2.
- Replaced the flake8/isort pre-commit hooks with ruff.
- Disabled editable wheels (PEP-0662) as they don't include the hunter.pth file. There may be a way to do it but I haven't figured out a way to customize the editable_wheel command without a very brittle solution glued to setuptools' internals.
- Fixed breakage in
hunter-trace
when Ctrl-C.
- Add support for generators and coroutines in the :obj:`hunter.wrap` decorator.
- Dropped support for Python 3.6.
- Removed most of the Python 2 support code.
- Fix some refactoring regression in
setup.py
and make the 3.4.x series installable only on Python 3.6 and later. - Yank 3.4.0, 3.4.1, 3.4.2 releases to avoid install problems on Python 2.7.
- Fixed CI to properly make win32 wheels.
- Add support for building a
pp37.pp38
tagged wheel (basically an universal wheel installable just for those two PyPy versions).
- Switched CI to GitHub Actions, this has a couple consequences:
- Support for Python 2.7 is dropped. You can still install it there but it's not tested anymore and Python 2 specific handling will be removed at some point.
- Linux wheels are now provided in musllinux and manylinux2014 variants.
- Extension building is now completely skipped on PyPy.
- A pure but tagged as platform specific wheel is now provided for PyPy (to have fast installs there as well).
- Fixed CI problem that publishes same type of wheels two times.
- Fixed a bug with how
stdlib
is detected on Windows (at least).
- Fixed regression from 3.3.4:
stdlib
filter was broken. - Improved the pth file (
PYTHONHUNTER
environment variable activation) to use a clean eval environment. No bogus variables likeline
(from thesite.py
machinery) will be available anymore. - Fixed a bug in
VarsSnooper
that would make it fail in rare situation where a double return event is emitted.
- Added support for Python 3.10.
- Added support for
time
objects and thefold
option insafe_repr
. - 3.3.4 was skipped cause I messed up the CI.
Fixed tracer still being active for other threads after it was stopped.
Python unfortunately only allows removing the trace function for the current thread - now :obj:`~hunter.tracer.Tracer` will uninstall itself if it's marked as stopped.
This fixes bogus errors that appear when using
ipdb
with the :class:`hunter.actions.Debugger` action while thread support is enabled (the default).
- Changed CI to build Python 3.9 wheels. Python 3.5 no longer tested and wheels no longer built to keep things simple.
- Documentation improvements.
- Fixed CI/test issues that prevented all of 21 wheels being published.
- Fixed handling so that :any:`hunter.event.Event.module` is always the
"?"
string instead ofNone
. Previously it wasNone
when tracing particularly broken code and broke various predicates. - Similarly :any:`hunter.event.Event.filename` is now
"?"
if there's no filename available. - Building on the previous changes the actions have simpler code for displaying missing module/filenames.
- Changed :class:`hunter.actions.CallPrinter` so that trace events for builtin functions are displayed differently.
These events appear when using profile mode (eg:
trace(profile=True)
). - Fixed failure that could occur if :any:`hunter.event.Event.module` is an unicode string. Now it's always a regular string. Only applies to Python 2.
- Fixed argument display when tracing functions with tuple arguments. Closes #88. Only applies to Python 2.
- Improved error reporting when internal failures occur. Now some details about the triggering event are logged.
- Fixed oversight over what value is in :any:`hunter.event.Event.builtin`. Now it's always a boolean, and can be used consistently
in filters (eg:
builtin=True,function='getattr'
).
- Added support for regex, date and datetime in
safe_repr
. - Fixed call argument display when positional and keyword arguments are used in :class:`hunter.actions.CallPrinter`.
- Implemented the :class:`~hunter.actions.StackPrinter` action.
- Implemented the :class:`~hunter.predicates.Backlog` predicate. Contributed by Dan Ailenei in #81.
- Improved contributing section in docs a bit. Contributed by Tom Schraitle in #85.
- Improved filtering performance by avoiding a lot of unnecessary
PyObject_GetAttr
calls in the Cython implementation of :class:`~hunter.predicates.Backlog`. - Implemented the :class:`~hunter.actions.ErrorSnooper` action.
- Added support for profiling mode (eg:
trace(profile=True)
). This mode will usesetprofile
instead ofsettrace
. - Added ARM64 wheels and CI.
- Added :any:`hunter.event.Event.instruction` and :any:`hunter.event.Event.builtin` (usable in profile mode).
- Added more cookbook entries.
- Improved again the stdlib check to handle certain paths better.
- Really fixed the
<frozen importlib.something
stdlib check.
- Marked all the
<frozen importlib.something
files as part of stdlib.
- Added :class:`~hunter.actions.ErrorSnooper` - an action that detects silenced exceptions.
- Added :func:`~hunter.load_config` and fixed issues with configuration being loaded too late from the
PYTHONHUNTERCONFIG
environment variable. - Changed :func:`~hunter.From` helper to automatically move
depth
andcalls
filters to the predicate (so they filter after :class:`~hunter.predicates.From` activates). - Changed :class:`~hunter.predicates.From` to pass a copy of event to the predicate.
The copy will have the
depth
andcalls
attributes adjusted to the point where :class:`~hunter.predicates.From` activated. - Fixed a bunch of inconsistencies and bugs when using
&
and|
operators with predicates. - Fixed a bunch of broken fields on :meth:`detached events <hunter.event.Event.detach>` (:attr:`~hunter.event.Event.function_object` and :attr:`~hunter.event.Event.arg`).
- Improved docstrings in various and added a configuration doc section.
- Improved testing (more coverage).
- Really fixed
safe_repr
so it doesn't cause side-effects (now isinstance/issubclass are avoided - they can cause side-effects in code that abuses descriptors in special attributes/methods).
- Really fixed
stream
setup in actions (usingforce_colors
without anystream
was broken). See: :obj:`~hunter.actions.ColorStreamAction`. - Fixed
__repr__
for the :obj:`~hunter.predicates.From` predicate to includewatermark
. - Added binary wheels for Python 3.8.
- Fixed
safe_repr
on pypy so it's safer on method objects. See: :class:`~hunter.actions.ColorStreamAction`.
- Fixed setting
stream
fromPYTHONHUNTERCONFIG
environment variable. See: :class:`~hunter.actions.ColorStreamAction`. - Fixed a couple minor documentation issues.
- Fixed issue with coloring missing source message (coloring leaked into next line).
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 withrepr_func
. Now you can use your custom repr function in the builtin actions. BACKWARDS INCOMPATIBLEFixed buggy filename handling when using Hunter in ipython/jupyter. Source code should be properly displayed now.
Removed
globals
option fromVarsPrinter
action. Globals are now always looked up. BACKWARDS INCOMPATIBLEAdded support for locals in
VarsPrinter
action. Now you can doVarsPrinter('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.
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.
- Fixed a link in changelog.
- Fixed some issues in the Travis configuration.
- 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).
- 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 withhunter-trace
CLI (viahunter.remote.install()
). It will be slightly insecure but will work on OSX. - Added OSX in the Travis test grid.
- Made
threading_support
on by default but output automatic (also, now1
or0
allowed). - Added
pid_alignment
andforce_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.
- 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).
- 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.
- Now
Py_AddPendingCall
is used instead of acquiring the GIL (when using GDB).
- 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
) andregex
(rx
). - Added a convenience :func:`hunter.wrap` decorator to start tracing around a function.
- Added support for remote tracing (with two backends: 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.
- Fix support for getting sources for Cython module (it was broken on Windows and Python3.5+).
- Added support for tracing Cython modules (#30). A # cython: linetrace=True stanza or equivalent is required in Cython modules for this to work.
- 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++ in the :class:`hunter.actions.Debugger` action.
- Added support for using manhole via a new :class:`hunter.actions.Manhole` action.
- Made the :attr:`hunter.event.Event.handler` a public but readonly property.
- Fix broken import. Require
fields>=4.0
. - Simplify a string check in Cython code.
- Fix "KeyError: 'normal'" bug in :class:`hunter.actions.CallPrinter`. Create the NO_COLORS dict from the COLOR dicts. Some keys were missing.
- Fixed printouts of objects that return very large string in
__repr__()
. Trimmed to 512. Configurable in actions with therepr_limit
option. - Improved validation of :class:`hunter.actions.VarsPrinter`'s initializer.
- Added a :class:`hunter.actions.CallPrinter` action.
- 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 inhunter.Query
. - Add basic validation (must be callable) for positional arguments and actions passed into
hunter.Q
. Closes #23. - Fixed
stdlib
checks (wasn't very reliable). Closes #24.
- Fixed missing import in
setup.py
.
- Fix a compile issue with the MSVC compiler (seems it don't like the inline option on the
fast_When_call
).
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
andin
. Examples:Q(module_startswith='foo'
will match events fromfoo
,foo.bar
andfoobar
.Q(module_startswith=['foo', 'bar']
will match events fromfoo
,foo.bar
,foobar
,bar
,bar.foo
andbaroo
.Q(module_endswith='bar'
will match events fromfoo.bar
andfoobar
.Q(module_contains='ip'
will match events fromlipsum
.Q(module_in=['foo', 'bar']
will match events fromfoo
andbar
.Q(module_regex=r"(re|sre.*)\b") will match events from ``re
,re.foobar
,srefoobar
but not fromrepr
.
Removed the
merge
option. Now when you callhunter.trace(...)
multiple times only the last one is active. BACKWARDS INCOMPATIBLERemove the
previous_tracer
handling. Now when you callhunter.trace(...)
the previous tracer (whatever was insys.gettrace()
) is disabled and restored whenhunter.stop()
is called. BACKWARDS INCOMPATIBLEFixed
CodePrinter
to show module name if it fails to get any sources.
- 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. - Fixed handling in VarsPrinter: properly print eval errors and don't try to show anything if there's an AttributeError. Closes #18.
- Added a
stdlib
boolean flag (for filtering purposes). Closes #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
andpip install -e
will still leave pth garbage onpip uninstall hunter
).
- Fixed :attr:`hunter.event.Event.globals` to actually be the dict of global vars (it was just the locals).
- Fixed :func:`hunter.And` and :func:`hunter.Or` "single argument unwrapping".
- Implemented predicate compression. Example:
Or(Or(a, b), c)
is converted toOr(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`.
- Disabled colors for Jython. Contributed by Claudiu Popa in #12.
- Test suite fixes for Windows. Contributed by Claudiu Popa in #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.
- Forgot to merge some commits ...
- 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.
- Added missing color entry for exception events.
- Added :attr:`hunter.event.Event.line` property. It returns the source code for the line being run.
- 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 toPYTHONHUNTER
. - 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.
- Renamed
- Improved error reporting for env variable activation (
PYTHONHUNTER
). - Fixed env var activator (the
.pth
file) installation withsetup.py install
(the "egg installs") andsetup.py develop
/pip install -e
(the "egg links").
- First release on PyPI.