Changelog¶
3.5.2 (2022-10-26)¶
- Added Python 3.11 wheels.
3.5.1 (2022-09-27)¶
- Fixed breakage in
hunter-trace
when Ctrl-C.
3.5.0 (2022-09-11)¶
- Add support for generators and coroutines in the
hunter.wrap
decorator. - Dropped support for Python 3.6.
3.4.3 (2021-12-15)¶
- 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.
3.4.2 (2021-12-15)¶
- Fixed CI to properly make win32 wheels.
3.4.1 (2021-12-14)¶
- Add support for building a
pp37.pp38
tagged wheel (basically an universal wheel installable just for those two PyPy versions).
3.4.0 (2021-12-14)¶
- 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).
3.3.8 (2021-06-23)¶
- Fixed CI problem that publishes same type of wheels two times.
3.3.7 (2021-06-23)¶
- Fixed a bug with how
stdlib
is detected on Windows (at least).
3.3.6 (2021-06-23)¶
- 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.
3.3.5 (2021-06-11)¶
- 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.
3.3.3 (2021-05-04)¶
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
Tracer
will uninstall itself if it’s marked as stopped.This fixes bogus errors that appear when using
ipdb
with thehunter.actions.Debugger
action while thread support is enabled (the default).
3.3.2 (2021-03-25)¶
- 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.
3.3.1 (2020-10-24)¶
- Fixed CI/test issues that prevented all of 21 wheels being published.
3.3.0 (2020-10-23)¶
- Fixed handling so that
hunter.event.Event.module
is always the"?"
string instead ofNone
. Previously it wasNone
when tracing particularly broken code and broke various predicates. - Similarly
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
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
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.
3.2.2 (2020-09-04)¶
- Fixed oversight over what value is in
hunter.event.Event.builtin
. Now it’s always a boolean, and can be used consistently in filters (eg:builtin=True,function='getattr'
).
3.2.1 (2020-08-18)¶
- Added support for regex, date and datetime in
safe_repr
. - Fixed call argument display when positional and keyword arguments are used in
hunter.actions.CallPrinter
.
3.2.0 (2020-08-16)¶
- Implemented the
StackPrinter
action. - Implemented the
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 ofBacklog
. - Implemented the
ErrorSnooper
action. - Added support for profiling mode (eg:
trace(profile=True)
). This mode will usesetprofile
instead ofsettrace
. - Added ARM64 wheels and CI.
- Added
hunter.event.Event.instruction
andhunter.event.Event.builtin
(usable in profile mode). - Added more cookbook entries.
3.1.3 (2020-02-02)¶
- Improved again the stdlib check to handle certain paths better.
3.1.2 (2019-01-19)¶
- Really fixed the
<frozen importlib.something
stdlib check.
3.1.1 (2019-01-19)¶
- Marked all the
<frozen importlib.something
files as part of stdlib.
3.1.0 (2019-01-19)¶
- Added
ErrorSnooper
- an action that detects silenced exceptions. - Added
load_config()
and fixed issues with configuration being loaded too late from thePYTHONHUNTERCONFIG
environment variable. - Changed
From()
helper to automatically movedepth
andcalls
filters to the predicate (so they filter afterFrom
activates). - Changed
From
to pass a copy of event to the predicate. The copy will have thedepth
andcalls
attributes adjusted to the point whereFrom
activated. - Fixed a bunch of inconsistencies and bugs when using
&
and|
operators with predicates. - Fixed a bunch of broken fields on
detached events
(function_object
andarg
). - Improved docstrings in various and added a configuration doc section.
- Improved testing (more coverage).
3.0.5 (2019-12-06)¶
- 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).
3.0.4 (2019-10-26)¶
- Really fixed
stream
setup in actions (usingforce_colors
without anystream
was broken). See:ColorStreamAction
. - Fixed
__repr__
for theFrom
predicate to includewatermark
. - Added binary wheels for Python 3.8.
3.0.3 (2019-10-13)¶
- Fixed
safe_repr
on pypy so it’s safer on method objects. See:ColorStreamAction
.
3.0.2 (2019-10-10)¶
- Fixed setting
stream
fromPYTHONHUNTERCONFIG
environment variable. See:ColorStreamAction
. - Fixed a couple minor documentation issues.
3.0.1 (2019-06-17)¶
- Fixed issue with coloring missing source message (coloring leaked into next line).
3.0.0 (2019-06-17)¶
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
hunter.From()
helper to allow passing in filters directly as keyword arguments.Added
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
filename_prefix()
,output()
,pid_prefix()
,thread_prefix()
,try_repr()
andtry_source()
methods to thehunter.actions.ColorStreamAction
baseclass.Added
hunter.actions.VarsSnooper
- a PySnooper-inspired variant ofVarsPrinter
. 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 (2019-01-19)¶
- Fixed a link in changelog.
- Fixed some issues in the Travis configuration.
2.2.0 (2019-01-19)¶
- Added
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.
2.1.0 (2018-11-17)¶
- 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).
2.0.2 (2017-11-24)¶
- Fixed indentation in
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 (2017-09-09)¶
- Now
Py_AddPendingCall
is used instead of acquiring the GIL (when using GDB).
2.0.0 (2017-09-02)¶
- Added the
hunter.event.Event.count
andhunter.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
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
hunter.actions.CallPrinter
. You’ll need to useaction=CodePrinter
if you want the old output.
1.4.1 (2016-09-24)¶
- Fix support for getting sources for Cython module (it was broken on Windows and Python3.5+).
1.4.0 (2016-09-24)¶
- Added support for tracing Cython modules (#30). A # cython: linetrace=True stanza or equivalent is required in Cython modules for this to work.
1.3.0 (2016-04-14)¶
- Added
hunter.event.Event.thread
. - Added
hunter.event.Event.threadid
andhunter.event.Event.threadname
(available for filtering withhunter.Q()
). - Added
hunter.event.Event.threading_support
argument tohunter.trace()
. It makes new threads be traced and changes action output to include thread name. - Added support for using pdb++ in the
hunter.actions.Debugger
action. - Added support for using manhole via a new
hunter.actions.Manhole
action. - Made the
hunter.event.Event.handler
a public but readonly property.
1.2.2 (2016-01-28)¶
- Fix broken import. Require
fields>=4.0
. - Simplify a string check in Cython code.
1.2.1 (2016-01-27)¶
- Fix “KeyError: ‘normal’” bug in
hunter.actions.CallPrinter
. Create the NO_COLORS dict from the COLOR dicts. Some keys were missing.
1.2.0 (2016-01-24)¶
- Fixed printouts of objects that return very large string in
__repr__()
. Trimmed to 512. Configurable in actions with therepr_limit
option. - Improved validation of
hunter.actions.VarsPrinter
’s initializer. - Added a
hunter.actions.CallPrinter
action.
1.1.0 (2016-01-21)¶
- 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.
1.0.2 (2016-01-05)¶
- Fixed missing import in
setup.py
.
1.0.1 (2015-12-24)¶
- Fix a compile issue with the MSVC compiler (seems it don’t like the inline option on the
fast_When_call
).
1.0.0 (2015-12-24)¶
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.
0.6.0 (2015-10-10)¶
- Added a
clear_env_var
option on the tracer (disables tracing in subprocess). - Added
force_colors
option onhunter.actions.VarsPrinter
andhunter.actions.CodePrinter
. - Allowed setting the stream to a file name (option on
hunter.actions.VarsPrinter
andhunter.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
).
0.5.1 (2015-04-15)¶
- Fixed
hunter.event.Event.globals
to actually be the dict of global vars (it was just the locals).
0.5.0 (2015-04-06)¶
- Fixed
hunter.And()
andhunter.Or()
“single argument unwrapping”. - Implemented predicate compression. Example:
Or(Or(a, b), c)
is converted toOr(a, b, c)
. - Renamed
hunter.event.Event.source
tohunter.event.Event.fullsource
. - Added
hunter.event.Event.source
that doesn’t do any fancy sourcecode tokenization. - Fixed
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
hunter.event.Event
.
0.4.0 (2015-03-29)¶
- 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.
0.3.1 (2015-03-29)¶
- Forgot to merge some commits …
0.3.0 (2015-03-29)¶
- 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.
0.2.1 (2015-03-28)¶
- Added missing color entry for exception events.
- Added
hunter.event.Event.line
property. It returns the source code for the line being run.
0.2.0 (2015-03-27)¶
- Added color support (and
colorama
as dependency). - Added support for expressions in
hunter.actions.VarsPrinter
. - Breaking changes:
- Renamed
F
tohunter.Q()
. Andhunter.Q()
is now just a convenience wrapper forhunter.predicates.Query
. - Renamed the
PYTHON_HUNTER
env variable toPYTHONHUNTER
. - Changed
hunter.predicates.When
to take positional arguments. - Changed output to show 2 path components (still not configurable).
- Changed
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”).
0.1.0 (2015-03-22)¶
- First release on PyPI.