{"author":"Ionel Cristian Mărieș","author_email":"contact@ionelmc.ro","bugtrack_url":null,"classifiers":["Development Status :: 5 - Production/Stable","Intended Audience :: Developers","License :: OSI Approved :: BSD License","Operating System :: Microsoft :: Windows","Operating System :: POSIX","Operating System :: Unix","Programming Language :: Python","Programming Language :: Python :: 3","Programming Language :: Python :: 3 :: Only","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12","Programming Language :: Python :: 3.8","Programming Language :: Python :: 3.9","Programming Language :: Python :: Implementation :: CPython","Programming Language :: Python :: Implementation :: PyPy","Topic :: Software Development :: Debuggers","Topic :: Utilities"],"description":"========\nOverview\n========\n\n\n\nHunter is a flexible code tracing toolkit, not for measuring coverage, but for debugging, logging, inspection and other\nnefarious purposes. It has a `simple Python API `_,\na `convenient terminal API `_ and\na `CLI tool to attach to processes `_.\n\n* Free software: BSD 2-Clause License\n\nInstallation\n============\n\n::\n\n pip install hunter\n\nDocumentation\n=============\n\n\nhttps://python-hunter.readthedocs.io/\n\nGetting started\n===============\n\nBasic use involves passing various filters to the ``trace`` option. An example:\n\n.. sourcecode:: python\n\n import hunter\n hunter.trace(module='posixpath', action=hunter.CallPrinter)\n\n import os\n os.path.join('a', 'b')\n\nThat would result in:\n\n.. sourcecode:: pycon\n\n >>> os.path.join('a', 'b')\n /usr/lib/python3.6/posixpath.py:75 call => join(a='a')\n /usr/lib/python3.6/posixpath.py:80 line a = os.fspath(a)\n /usr/lib/python3.6/posixpath.py:81 line sep = _get_sep(a)\n /usr/lib/python3.6/posixpath.py:41 call => _get_sep(path='a')\n /usr/lib/python3.6/posixpath.py:42 line if isinstance(path, bytes):\n /usr/lib/python3.6/posixpath.py:45 line return '/'\n /usr/lib/python3.6/posixpath.py:45 return <= _get_sep: '/'\n /usr/lib/python3.6/posixpath.py:82 line path = a\n /usr/lib/python3.6/posixpath.py:83 line try:\n /usr/lib/python3.6/posixpath.py:84 line if not p:\n /usr/lib/python3.6/posixpath.py:86 line for b in map(os.fspath, p):\n /usr/lib/python3.6/posixpath.py:87 line if b.startswith(sep):\n /usr/lib/python3.6/posixpath.py:89 line elif not path or path.endswith(sep):\n /usr/lib/python3.6/posixpath.py:92 line path += sep + b\n /usr/lib/python3.6/posixpath.py:86 line for b in map(os.fspath, p):\n /usr/lib/python3.6/posixpath.py:96 line return path\n /usr/lib/python3.6/posixpath.py:96 return <= join: 'a/b'\n 'a/b'\n\nIn a terminal it would look like:\n\n.. image:: https://raw.githubusercontent.com/ionelmc/python-hunter/master/docs/code-trace.png\n\n\nAnother useful scenario is to ignore all standard modules and force colors to make them stay even if the output is\nredirected to a file.\n\n.. sourcecode:: python\n\n import hunter\n hunter.trace(stdlib=False, action=hunter.CallPrinter(force_colors=True))\n\nActions\n-------\n\nOutput format can be controlled with \"actions\". There's an alternative ``CodePrinter`` action that doesn't handle\nnesting (it was the default action until Hunter 2.0).\n\nIf filters match then action will be run. Example:\n\n.. sourcecode:: python\n\n import hunter\n hunter.trace(module='posixpath', action=hunter.CodePrinter)\n\n import os\n os.path.join('a', 'b')\n\nThat would result in:\n\n.. sourcecode:: pycon\n\n >>> os.path.join('a', 'b')\n /usr/lib/python3.6/posixpath.py:75 call def join(a, *p):\n /usr/lib/python3.6/posixpath.py:80 line a = os.fspath(a)\n /usr/lib/python3.6/posixpath.py:81 line sep = _get_sep(a)\n /usr/lib/python3.6/posixpath.py:41 call def _get_sep(path):\n /usr/lib/python3.6/posixpath.py:42 line if isinstance(path, bytes):\n /usr/lib/python3.6/posixpath.py:45 line return '/'\n /usr/lib/python3.6/posixpath.py:45 return return '/'\n ... return value: '/'\n /usr/lib/python3.6/posixpath.py:82 line path = a\n /usr/lib/python3.6/posixpath.py:83 line try:\n /usr/lib/python3.6/posixpath.py:84 line if not p:\n /usr/lib/python3.6/posixpath.py:86 line for b in map(os.fspath, p):\n /usr/lib/python3.6/posixpath.py:87 line if b.startswith(sep):\n /usr/lib/python3.6/posixpath.py:89 line elif not path or path.endswith(sep):\n /usr/lib/python3.6/posixpath.py:92 line path += sep + b\n /usr/lib/python3.6/posixpath.py:86 line for b in map(os.fspath, p):\n /usr/lib/python3.6/posixpath.py:96 line return path\n /usr/lib/python3.6/posixpath.py:96 return return path\n ... return value: 'a/b'\n 'a/b'\n\n- or in a terminal:\n\n.. image:: https://raw.githubusercontent.com/ionelmc/python-hunter/master/docs/simple-trace.png\n\n------\n\nAnother useful action is the ``VarsPrinter``:\n\n.. sourcecode:: python\n\n import hunter\n # note that this kind of invocation will also use the default `CallPrinter` action\n hunter.trace(hunter.Q(module='posixpath', action=hunter.VarsPrinter('path')))\n\n import os\n os.path.join('a', 'b')\n\nThat would result in:\n\n.. sourcecode:: pycon\n\n >>> os.path.join('a', 'b')\n /usr/lib/python3.6/posixpath.py:75 call => join(a='a')\n /usr/lib/python3.6/posixpath.py:80 line a = os.fspath(a)\n /usr/lib/python3.6/posixpath.py:81 line sep = _get_sep(a)\n /usr/lib/python3.6/posixpath.py:41 call [path => 'a']\n /usr/lib/python3.6/posixpath.py:41 call => _get_sep(path='a')\n /usr/lib/python3.6/posixpath.py:42 line [path => 'a']\n /usr/lib/python3.6/posixpath.py:42 line if isinstance(path, bytes):\n /usr/lib/python3.6/posixpath.py:45 line [path => 'a']\n /usr/lib/python3.6/posixpath.py:45 line return '/'\n /usr/lib/python3.6/posixpath.py:45 return [path => 'a']\n /usr/lib/python3.6/posixpath.py:45 return <= _get_sep: '/'\n /usr/lib/python3.6/posixpath.py:82 line path = a\n /usr/lib/python3.6/posixpath.py:83 line [path => 'a']\n /usr/lib/python3.6/posixpath.py:83 line try:\n /usr/lib/python3.6/posixpath.py:84 line [path => 'a']\n /usr/lib/python3.6/posixpath.py:84 line if not p:\n /usr/lib/python3.6/posixpath.py:86 line [path => 'a']\n /usr/lib/python3.6/posixpath.py:86 line for b in map(os.fspath, p):\n /usr/lib/python3.6/posixpath.py:87 line [path => 'a']\n /usr/lib/python3.6/posixpath.py:87 line if b.startswith(sep):\n /usr/lib/python3.6/posixpath.py:89 line [path => 'a']\n /usr/lib/python3.6/posixpath.py:89 line elif not path or path.endswith(sep):\n /usr/lib/python3.6/posixpath.py:92 line [path => 'a']\n /usr/lib/python3.6/posixpath.py:92 line path += sep + b\n /usr/lib/python3.6/posixpath.py:86 line [path => 'a/b']\n /usr/lib/python3.6/posixpath.py:86 line for b in map(os.fspath, p):\n /usr/lib/python3.6/posixpath.py:96 line [path => 'a/b']\n /usr/lib/python3.6/posixpath.py:96 line return path\n /usr/lib/python3.6/posixpath.py:96 return [path => 'a/b']\n /usr/lib/python3.6/posixpath.py:96 return <= join: 'a/b'\n 'a/b'\n\nIn a terminal it would look like:\n\n.. image:: https://raw.githubusercontent.com/ionelmc/python-hunter/master/docs/vars-trace.png\n\n-----\n\nYou can give it a tree-like configuration where you can optionally configure specific actions for parts of the\ntree (like dumping variables or a pdb set_trace):\n\n.. sourcecode:: python\n\n from hunter import trace, Q, Debugger\n from pdb import Pdb\n\n trace(\n # drop into a Pdb session if ``foo.bar()`` is called\n Q(module=\"foo\", function=\"bar\", kind=\"call\", action=Debugger(klass=Pdb))\n | # or\n Q(\n # show code that contains \"mumbo.jumbo\" on the current line\n lambda event: event.locals.get(\"mumbo\") == \"jumbo\",\n # and it's not in Python's stdlib\n stdlib=False,\n # and it contains \"mumbo\" on the current line\n source__contains=\"mumbo\"\n )\n )\n\n import foo\n foo.func()\n\nWith a ``foo.py`` like this:\n\n.. sourcecode:: python\n\n def bar():\n execution_will_get_stopped # cause we get a Pdb session here\n\n def func():\n mumbo = 1\n mumbo = \"jumbo\"\n print(\"not shown in trace\")\n print(mumbo)\n mumbo = 2\n print(mumbo) # not shown in trace\n bar()\n\n\nWe get:\n\n.. sourcecode:: pycon\n\n >>> foo.func()\n not shown in trace\n /home/ionel/osp/python-hunter/foo.py:8 line print(mumbo)\n jumbo\n /home/ionel/osp/python-hunter/foo.py:9 line mumbo = 2\n 2\n /home/ionel/osp/python-hunter/foo.py:1 call def bar():\n > /home/ionel/osp/python-hunter/foo.py(2)bar()\n -> execution_will_get_stopped # cause we get a Pdb session here\n (Pdb)\n\nIn a terminal it would look like:\n\n.. image:: https://raw.githubusercontent.com/ionelmc/python-hunter/master/docs/tree-trace.png\n\n.. _tracing-processes:\n\nTracing processes\n-----------------\n\nIn similar fashion to ``strace`` Hunter can trace other processes, eg::\n\n hunter-trace --gdb -p 123\n\nIf you wanna play it safe (no messy GDB) then add this in your code::\n\n from hunter import remote\n remote.install()\n\nThen you can do::\n\n hunter-trace -p 123\n\nSee `docs on the remote feature `_.\n\n**Note:** Windows ain't supported.\n\n.. _environment-variable-activation:\n\nEnvironment variable activation\n-------------------------------\n\nFor your convenience environment variable activation is available. Just run your app like this::\n\n\n PYTHONHUNTER=\"module='os.path'\" python yourapp.py\n\nOn Windows you'd do something like::\n\n set PYTHONHUNTER=module='os.path'\n python yourapp.py\n\nThe activation works with a clever ``.pth`` file that checks for that env var presence and before your app runs does something\nlike this::\n\n from hunter import *\n trace()\n\nNote that Hunter is activated even if the env var is empty, eg: ``PYTHONHUNTER=\"\"``.\n\nEnvironment variable configuration\n``````````````````````````````````\n\nSometimes you always use the same options (like ``stdlib=False`` or ``force_colors=True``). To save typing you can\nset something like this in your environment::\n\n PYTHONHUNTERCONFIG=\"stdlib=False,force_colors=True\"\n\nThis is the same as ``PYTHONHUNTER=\"stdlib=False,action=CallPrinter(force_colors=True)\"``.\n\nNotes:\n\n* Setting ``PYTHONHUNTERCONFIG`` alone doesn't activate hunter.\n* All the options for the builtin actions are supported.\n* Although using predicates is supported it can be problematic. Example of setup that won't trace anything::\n\n PYTHONHUNTERCONFIG=\"Q(module_startswith='django')\"\n PYTHONHUNTER=\"Q(module_startswith='celery')\"\n\n which is the equivalent of::\n\n PYTHONHUNTER=\"Q(module_startswith='django'),Q(module_startswith='celery')\"\n\n which is the equivalent of::\n\n PYTHONHUNTER=\"Q(module_startswith='django')&Q(module_startswith='celery')\"\n\n\n\nFiltering DSL\n-------------\n\nHunter supports a flexible query DSL, see the `introduction\n`_.\n\nDevelopment\n===========\n\nTo run the all tests run::\n\n tox\n\nDesign notes\n============\n\nHunter doesn't do everything. As a design goal of this library some things are made intentionally austere and verbose (to avoid complexity,\nconfusion and inconsistency). This has few consequences:\n\n* There are `Operators `_ but there's no negation operator.\n Instead you're expected to negate a Query object, eg: ``~Q(module='re')``.\n* There are no specialized operators or filters - all filters behave exactly the same. For example:\n\n * No filter for packages. You're expected to filter by module with an operator.\n * No filter for arguments, return values or variables. You're expected to write your own filter function and deal with the problems\n of poking into objects.\n* Layering is minimal. There's are some `helpers `_ that do\n some argument processing and conversions to save you some typing but that's about it.\n* The library doesn't try to hide the mechanics of tracing in Python - it's 1:1 regarding what Python sends to a trace function if you'd be\n using `sys.settrace `_.\n* Doesn't have any storage. You are expected to redirect output to a file.\n\nYou should look at it like it's a tool to help you understand and debug big applications, or a framework ridding you of the boring parts of\nsettrace, not something that helps you learn Python.\n\nFAQ\n===\n\nWhy not Smiley?\n---------------\n\nThere's some obvious overlap with `smiley `_ but there are few fundamental differences:\n\n* Complexity. Smiley is simply over-engineered:\n\n * It uses IPC and a SQL database.\n * It has a webserver. Lots of dependencies.\n * It uses threads. Side-effects and subtle bugs are introduced in your code.\n * It records everything. Tries to dump any variable. Often fails and stops working.\n\n Why do you need all that just to debug some stuff in a terminal? Simply put, it's a nice idea but the design choices work\n against you when you're already neck-deep into debugging your own code. In my experience Smiley has been very buggy and\n unreliable. Your mileage may vary of course.\n\n* Tracing long running code. This will make Smiley record lots of data, making it unusable.\n\n Now because Smiley records everything, you'd think it's better suited for short programs. But alas, if your program runs\n quickly then it's pointless to record the execution. You can just run it again.\n\n It seems there's only one situation where it's reasonable to use Smiley: tracing io-bound apps remotely. Those apps don't\n execute lots of code, they just wait on network so Smiley's storage won't blow out of proportion and tracing overhead might\n be acceptable.\n* Use-cases. It seems to me Smiley's purpose is not really debugging code, but more of a \"non interactive monitoring\" tool.\n\nIn contrast, Hunter is very simple:\n\n* Few dependencies.\n* Low overhead (tracing/filtering code has an optional Cython extension).\n* No storage. This simplifies lots of things.\n\n The only cost is that you might need to run the code multiple times to get the filtering/actions right. This means Hunter is\n not really suited for \"post-mortem\" debugging. If you can't reproduce the problem anymore then Hunter won't be of much help.\n\nWhy not pytrace?\n----------------\n\n`Pytrace `_ is another tracer tool. It seems quite similar to Smiley - it uses a sqlite\ndatabase for the events, threads and IPC, thus it's reasonable to expect the same kind of problems.\n\nWhy not PySnooper or snoop?\n---------------------------\n\n`snoop `_ is a refined version of `PySnooper `_. Both are\nmore suited to tracing small programs or functions as the output is more verbose and less suited to the needs of tracing a big application\nwhere Hunter provides more flexible setup, filtering capabilities, speed and brevity.\n\nWhy not coverage?\n-----------------\n\nFor purposes of debugging `coverage `_ is a great tool but only as far as \"debugging\nby looking at what code is (not) run\". Checking branch coverage is good but it will only get you as far.\n\nFrom the other perspective, you'd be wondering if you could use Hunter to measure coverage-like things. You could do it but\nfor that purpose Hunter is very \"rough\": it has no builtin storage. You'd have to implement your own storage. You can do it\nbut it wouldn't give you any advantage over making your own tracer if you don't need to \"pre-filter\" whatever you're\nrecording.\n\nIn other words, filtering events is the main selling point of Hunter - it's fast (cython implementation) and the query API is\nflexible enough.\n\nProjects using Hunter\n=====================\n\nNoteworthy usages or Hunter (submit a PR with your project if you built a tool that relies on hunter):\n\n* `Crunch-io/diagnose `_ - a runtime instrumentation library.\n* `talwrii/huntrace `_ - an alternative cli (similar to ltrace).\n* `anki-code/xunter `_ - a profiling tool made specifically for `the xonsh shell `_.\n\nMore projects using it at https://github.com/ionelmc/python-hunter/network/dependents\n\n\nChangelog\n=========\n\n3.7.0 (2024-05-02)\n------------------\n\n* Drop support for Python 3.7.\n* Upgrade linters and refactor various string formatting and other cleanups.\n* Upgrade Cython to latest release (3.0.10).\n* Linux wheels should be back now.\n* Switched docs theme to furo.\n\n3.6.1 (2023-04-26)\n------------------\n\n* Added safe repr support for Decimal objects.\n\n3.6.0 (2023-04-25)\n------------------\n\n* Added C extension support for Python 3.11. This may come with up to 10% performance hit (depending on use-case) for all Pythons.\n Unfortunately some `compat shims `_ are\n now used for getting frame details. This is necessary to be able to work with Python 3.11 and be more future-proof.\n* Added safe repr support for ZoneInfo objects.\n* C extension files are now prebuilt with Cython 3.0b2.\n* Replaced the flake8/isort pre-commit hooks with ruff.\n* Disabled editable wheels (`PEP-0662 `_) as they don't include the `hunter.pth` file.\n There may be a way to do it but I haven't figured out a way to customize the `editable_wheel` command without a\n very brittle solution glued to setuptools' internals.\n\n3.5.1 (2022-09-27)\n------------------\n\n* Fixed breakage in ``hunter-trace`` when Ctrl-C.\n\n3.5.0 (2022-09-11)\n------------------\n\n* Add support for generators and coroutines in the ``hunter.wrap`` decorator.\n* Dropped support for Python 3.6.\n\n3.4.3 (2021-12-15)\n------------------\n\n* Removed most of the Python 2 support code.\n* Fix some refactoring regression in ``setup.py`` and make the 3.4.x series installable only on Python 3.6 and later.\n* Yank 3.4.0, 3.4.1, 3.4.2 releases to avoid install problems on Python 2.7.\n\n3.4.2 (2021-12-15)\n------------------\n\n* Fixed CI to properly make win32 wheels.\n\n3.4.1 (2021-12-14)\n------------------\n\n* Add support for building a ``pp37.pp38`` tagged wheel\n (basically an universal wheel installable just for those two PyPy versions).\n\n3.4.0 (2021-12-14)\n------------------\n\n* Switched CI to GitHub Actions, this has a couple consequences:\n\n * Support for Python 2.7 is dropped. You can still install it there but it's not tested anymore and\n Python 2 specific handling will be removed at some point.\n * Linux wheels are now provided in `musllinux` and `manylinux2014` variants.\n* Extension building is now completely skipped on PyPy.\n* A pure but tagged as platform specific wheel is now provided for PyPy (to have fast installs there as well).\n\n3.3.8 (2021-06-23)\n------------------\n\n* Fixed CI problem that publishes same type of wheels two times.\n\n3.3.7 (2021-06-23)\n------------------\n\n* Fixed a bug with how ``stdlib`` is detected on Windows (at least).\n\n3.3.6 (2021-06-23)\n------------------\n\n* Fixed regression from *3.3.4*: ``stdlib`` filter was broken.\n* Improved the pth file (``PYTHONHUNTER`` environment variable activation) to use a clean eval environment.\n No bogus variables like ``line`` (from the ``site.py`` machinery) will be available anymore.\n* Fixed a bug in ``VarsSnooper`` that would make it fail in rare situation where a double `return` event is emitted.\n\n3.3.5 (2021-06-11)\n------------------\n\n* Added support for Python 3.10.\n* Added support for ``time`` objects and the ``fold`` option in ``safe_repr``.\n* *3.3.4 was skipped cause I messed up the CI.*\n\n3.3.3 (2021-05-04)\n------------------\n\n* Fixed tracer still being active for other threads after it was stopped.\n\n Python unfortunately only allows removing the trace function for the current thread -\n now ``hunter.tracer.Tracer`` will uninstall itself if it's marked as stopped.\n\n This fixes bogus errors that appear when using ``ipdb`` with\n the ``hunter.actions.Debugger`` action while thread support is enabled (the default).\n\n3.3.2 (2021-03-25)\n------------------\n\n* Changed CI to build Python 3.9 wheels. Python 3.5 no longer tested and wheels no longer built to keep things simple.\n* Documentation improvements.\n\n3.3.1 (2020-10-24)\n------------------\n\n* Fixed CI/test issues that prevented all of 21 wheels being published.\n\n3.3.0 (2020-10-23)\n------------------\n\n* Fixed handling so that ``hunter.event.Event.module`` is always the ``\"?\"`` string instead of ``None``.\n Previously it was ``None`` when tracing particularly broken code and broke various predicates.\n* Similarly ``hunter.event.Event.filename`` is now ``\"?\"`` if there's no filename available.\n* Building on the previous changes the actions have simpler code for displaying missing module/filenames.\n* Changed ``hunter.actions.CallPrinter`` so that trace events for builtin functions are displayed differently.\n These events appear when using profile mode (eg: ``trace(profile=True)``).\n* Fixed failure that could occur if ``hunter.event.Event.module`` is an unicode string. Now it's always a regular string.\n *Only applies to Python 2.*\n* Fixed argument display when tracing functions with tuple arguments.\n Closes `#88 `_. *Only applies to Python 2.*\n* Improved error reporting when internal failures occur. Now some details about the triggering event are logged.\n\n3.2.2 (2020-09-04)\n------------------\n\n* Fixed oversight over what value is in ``hunter.event.Event.builtin``. Now it's always a boolean, and can be used consistently\n in filters (eg: ``builtin=True,function='getattr'``).\n\n3.2.1 (2020-08-18)\n------------------\n\n* Added support for regex, date and datetime in ``safe_repr``.\n* Fixed call argument display when positional and keyword arguments are used in ``hunter.actions.CallPrinter``.\n\n3.2.0 (2020-08-16)\n------------------\n\n* Implemented the ``hunter.actions.StackPrinter`` action.\n* Implemented the ``hunter.predicates.Backlog`` predicate.\n Contributed by Dan Ailenei in `#81 `_.\n* Improved contributing section in docs a bit.\n Contributed by Tom Schraitle in `#85 `_.\n* Improved filtering performance by avoiding a lot of unnecessary\n ``PyObject_GetAttr`` calls in the Cython implementation of ``hunter.predicates.Backlog``.\n* Implemented the ``hunter.actions.ErrorSnooper`` action.\n* Added support for profiling mode (eg: ``trace(profile=True)``).\n This mode will use ``setprofile`` instead of ``settrace``.\n* Added ARM64 wheels and CI.\n* Added ``hunter.event.Event.instruction`` and ``hunter.event.Event.builtin`` (usable in profile mode).\n* Added more cookbook entries.\n\n3.1.3 (2020-02-02)\n------------------\n\n* Improved again the stdlib check to handle certain paths better.\n\n3.1.2 (2019-01-19)\n------------------\n\n* Really fixed the ````\n (``hunter.event.Event.function_object`` and ``hunter.event.Event.arg``).\n* Improved docstrings in various and added a configuration doc section.\n* Improved testing (more coverage).\n\n3.0.5 (2019-12-06)\n------------------\n\n* Really fixed ``safe_repr`` so it doesn't cause side-effects (now isinstance/issubclass are avoided - they\n can cause side-effects in code that abuses descriptors in special attributes/methods).\n\n3.0.4 (2019-10-26)\n------------------\n\n* Really fixed ``stream`` setup in actions (using ``force_colors`` without any ``stream`` was broken).\n See: ``hunter.actions.ColorStreamAction``.\n* Fixed ``__repr__`` for the ``hunter.predicates.From`` predicate to include ``watermark``.\n* Added binary wheels for Python 3.8.\n\n3.0.3 (2019-10-13)\n------------------\n\n* Fixed ``safe_repr`` on pypy so it's safer on method objects.\n See: ``hunter.actions.ColorStreamAction``.\n\n3.0.2 (2019-10-10)\n------------------\n\n* Fixed setting ``stream`` from ``PYTHONHUNTERCONFIG`` environment variable.\n See: ``hunter.actions.ColorStreamAction``.\n* Fixed a couple minor documentation issues.\n\n3.0.1 (2019-06-17)\n------------------\n\n* Fixed issue with coloring missing source message (coloring leaked into next line).\n\n3.0.0 (2019-06-17)\n------------------\n\n* The package now uses setuptools-scm for development builds (available at https://test.pypi.org/project/hunter/). As a\n consequence installing the sdist will download setuptools-scm.\n* Recompiled cython modules with latest Cython. Hunter can be installed without any Cython, as before.\n* Refactored some of the cython modules to have more typing information and not use deprecated property syntax.\n* Replaced ``unsafe_repr`` option with ``repr_func``. Now you can use your custom repr function in the builtin actions.\n **BACKWARDS INCOMPATIBLE**\n* Fixed buggy filename handling when using Hunter in ipython/jupyter. Source code should be properly displayed now.\n* Removed ``globals`` option from ``VarsPrinter`` action. Globals are now always looked up. **BACKWARDS INCOMPATIBLE**\n* Added support for locals in ``VarsPrinter`` action. Now you can do ``VarsPrinter('len(foobar)')``.\n* Always pass module_globals dict to linecache methods. Source code from PEP-302 loaders is now printed properly.\n Contributed by Mikhail Borisov in `#65 `_.\n* Various code cleanup, style and docstring fixing.\n* Added ``hunter.From`` helper to allow passing in filters directly as keyword arguments.\n* Added ``hunter.event.Event.detach`` for storing events without leaks or side-effects (due to prolonged references\n to Frame objects, local or global variables).\n* Refactored the internals of actions for easier subclassing.\n\n Added the\n ``hunter.actions.ColorStreamAction.filename_prefix``,\n ``hunter.actions.ColorStreamAction.output``,\n ``hunter.actions.ColorStreamAction.pid_prefix``,\n ``hunter.actions.ColorStreamAction.thread_prefix``,\n ``hunter.actions.ColorStreamAction.try_repr`` and\n ``hunter.actions.ColorStreamAction.try_source`` methods\n to the ``hunter.actions.ColorStreamAction`` baseclass.\n* Added ``hunter.actions.VarsSnooper`` - a PySnooper-inspired variant of ``hunter.actions.VarsPrinter``. It\n will record and show variable changes, with the risk of leaking or using too much memory of course :)\n* Fixed tracers to log error and automatically stop if there's an internal failure. Previously error may have been\n silently dropped in some situations.\n\n2.2.1 (2019-01-19)\n------------------\n\n* Fixed a link in changelog.\n* Fixed some issues in the Travis configuration.\n\n2.2.0 (2019-01-19)\n------------------\n\n* Added ``hunter.predicates.From`` predicate for tracing from a specific point. It stop after returning back to the\n same call depth with a configurable offset.\n* Fixed ``PYTHONHUNTERCONFIG`` not working in some situations (config values were resolved at the wrong time).\n* Made tests in CI test the wheel that will eventually be published to PyPI\n (`tox-wheel `_).\n* Made ``event.stdlib`` more reliable: ``pkg_resources`` is considered part of stdlib and few more paths will be\n considered as stdlib.\n* Dumbed down the ``get_peercred`` check that is done when attaching with ``hunter-trace`` CLI (via\n ``hunter.remote.install()``). It will be slightly insecure but will work on OSX.\n* Added OSX in the Travis test grid.\n\n2.1.0 (2018-11-17)\n------------------\n\n* Made ``threading_support`` on by default but output automatic (also, now ``1`` or ``0`` allowed).\n* Added ``pid_alignment`` and ``force_pid`` action options to show a pid prefix.\n* Fixed some bugs around ``__eq__`` in various classes.\n* Dropped Python 3.3 support.\n* Dropped dependency on `fields `_.\n* Actions now repr using a simplified implementation that tries to avoid calling ``__repr__`` on user classes in order\n to avoid creating side-effects while tracing.\n* Added support for the ``PYTHONHUNTERCONFIG`` environment variable (stores defaults and doesn't activate hunter).\n\n2.0.2 (2017-11-24)\n------------------\n\n* Fixed indentation in ``hunter.actions.CallPrinter`` action (shouldn't deindent on exception).\n* Fixed option filtering in Cython Query implementation (filtering on ``tracer`` was allowed by mistake).\n* Various fixes to docstrings and docs.\n\n2.0.1 (2017-09-09)\n------------------\n\n* Now ``Py_AddPendingCall`` is used instead of acquiring the GIL (when using GDB).\n\n2.0.0 (2017-09-02)\n------------------\n\n* Added the ``hunter.event.Event.count`` and ``hunter.event.Event.calls`` attributes.\n* Added the ``lt``/``lte``/``gt``/``gte`` lookups.\n* Added convenience aliases for ``startswith`` (``sw``), ``endswith`` (``ew``), ``contains`` (``has``)\n and ``regex`` (``rx``).\n* Added a convenience ``hunter.wrap`` decorator to start tracing around a function.\n* Added support for remote tracing (with two backends: `manhole `__ and GDB) via\n the ``hunter-trace`` bin. Note: **Windows is NOT SUPPORTED**.\n* Changed the default action to ``hunter.actions.CallPrinter``.\n You'll need to use ``action=CodePrinter`` if you want the old output.\n\n1.4.1 (2016-09-24)\n------------------\n\n* Fix support for getting sources for Cython module (it was broken on Windows and Python3.5+).\n\n1.4.0 (2016-09-24)\n------------------\n\n* Added support for tracing Cython modules (`#30 `_). A\n `# cython: linetrace=True` stanza or equivalent is required in Cython modules for this to work.\n\n1.3.0 (2016-04-14)\n------------------\n\n* Added ``hunter.event.Event.thread``.\n* Added ``hunter.event.Event.threadid`` and ``hunter.event.Event.threadname``\n (available for filtering with ``hunter.Q``).\n* Added ``hunter.event.Event.threading_support`` argument to ``hunter.trace``.\n It makes new threads be traced and changes action output to include thread name.\n* Added support for using `pdb++ `_ in the ``hunter.actions.Debugger`` action.\n* Added support for using `manhole `_ via a new ``hunter.actions.Manhole``\n action.\n* Made the ``hunter.event.Event.handler`` a public but readonly property.\n\n\n1.2.2 (2016-01-28)\n------------------\n\n* Fix broken import. Require ``fields>=4.0``.\n* Simplify a string check in Cython code.\n\n1.2.1 (2016-01-27)\n------------------\n\n* Fix \"KeyError: 'normal'\" bug in ``hunter.actions.CallPrinter``. Create the NO_COLORS dict from the COLOR dicts.\n Some keys were missing.\n\n1.2.0 (2016-01-24)\n------------------\n\n* Fixed printouts of objects that return very large string in ``__repr__()``. Trimmed to 512. Configurable in actions\n with the ``repr_limit`` option.\n* Improved validation of ``hunter.actions.VarsPrinter``'s initializer.\n* Added a ``hunter.actions.CallPrinter`` action.\n\n1.1.0 (2016-01-21)\n------------------\n\n* Implemented a destructor (``__dealloc__``) for the Cython tracer.\n* Improved the restoring of the previous tracer in the Cython tracer (use ``PyEval_SetTrace``) directly.\n* Removed ``tracer`` as an allowed filtering argument in ``hunter.Query``.\n* Add basic validation (must be callable) for positional arguments and actions passed into ``hunter.Q``. Closes\n `#23 `_.\n* Fixed ``stdlib`` checks (wasn't very reliable). Closes `#24 `_.\n\n1.0.2 (2016-01-05)\n------------------\n\n* Fixed missing import in ``setup.py``.\n\n1.0.1 (2015-12-24)\n------------------\n\n* Fix a compile issue with the MSVC compiler (seems it don't like the inline option on the ``fast_When_call``).\n\n1.0.0 (2015-12-24)\n------------------\n\n* Implemented fast tracer and query objects in Cython. **MAY BE BACKWARDS INCOMPATIBLE**\n\n To force using the old pure-python implementation set the ``PUREPYTHONHUNTER`` environment variable to non-empty value.\n* Added filtering operators: ``contains``, ``startswith``, ``endswith`` and ``in``. Examples:\n\n * ``Q(module_startswith='foo'`` will match events from ``foo``, ``foo.bar`` and ``foobar``.\n * ``Q(module_startswith=['foo', 'bar']`` will match events from ``foo``, ``foo.bar``, ``foobar``, ``bar``, ``bar.foo`` and ``baroo`` .\n * ``Q(module_endswith='bar'`` will match events from ``foo.bar`` and ``foobar``.\n * ``Q(module_contains='ip'`` will match events from ``lipsum``.\n * ``Q(module_in=['foo', 'bar']`` will match events from ``foo`` and ``bar``.\n * ``Q(module_regex=r\"(re|sre.*)\\b\") will match events from ``re``, ``re.foobar``, ``srefoobar`` but not from ``repr``.\n\n* Removed the ``merge`` option. Now when you call ``hunter.trace(...)`` multiple times only the last one is active.\n **BACKWARDS INCOMPATIBLE**\n* Remove the ``previous_tracer`` handling. Now when you call ``hunter.trace(...)`` the previous tracer (whatever was in\n ``sys.gettrace()``) is disabled and restored when ``hunter.stop()`` is called. **BACKWARDS INCOMPATIBLE**\n* Fixed ``CodePrinter`` to show module name if it fails to get any sources.\n\n0.6.0 (2015-10-10)\n------------------\n\n* Added a ``clear_env_var`` option on the tracer (disables tracing in subprocess).\n* Added ``force_colors`` option on ``hunter.actions.VarsPrinter`` and ``hunter.actions.CodePrinter``.\n* Allowed setting the `stream` to a file name (option on ``hunter.actions.VarsPrinter`` and\n ``hunter.actions.CodePrinter``).\n* Bumped up the filename alignment to 40 cols.\n* If not merging then ``self`` is not kept as a previous tracer anymore.\n Closes `#16 `_.\n* Fixed handling in VarsPrinter: properly print eval errors and don't try to show anything if there's an AttributeError.\n Closes `#18 `_.\n* Added a ``stdlib`` boolean flag (for filtering purposes).\n Closes `#15 `_.\n* Fixed broken frames that have \"None\" for filename or module (so they can still be treated as strings).\n* Corrected output files in the ``install_lib`` command so that pip can uninstall the pth file.\n This only works when it's installed with pip (sadly, ``setup.py install/develop`` and ``pip install -e`` will still\n leave pth garbage on ``pip uninstall hunter``).\n\n0.5.1 (2015-04-15)\n------------------\n\n* Fixed ``hunter.event.Event.globals`` to actually be the dict of global vars (it was just the locals).\n\n0.5.0 (2015-04-06)\n------------------\n\n* Fixed ``hunter.And`` and ``hunter.Or`` \"single argument unwrapping\".\n* Implemented predicate compression. Example: ``Or(Or(a, b), c)`` is converted to ``Or(a, b, c)``.\n* Renamed ``hunter.event.Event.source`` to ``hunter.event.Event.fullsource``.\n* Added ``hunter.event.Event.source`` that doesn't do any fancy sourcecode tokenization.\n* Fixed ``hunter.event.Event.fullsource`` return value for situations where the tokenizer would fail.\n* Made the print function available in the ``PYTHONHUNTER`` env var payload.\n* Added a __repr__ for ``hunter.event.Event``.\n\n0.4.0 (2015-03-29)\n------------------\n\n* Disabled colors for Jython.\n Contributed by Claudiu Popa in `#12 `_.\n* Test suite fixes for Windows.\n Contributed by Claudiu Popa in `#11 `_.\n* Added an introduction section in the docs.\n* Implemented a prettier fallback for when no sources are available for that frame.\n* Implemented fixups in cases where you use action classes as a predicates.\n\n0.3.1 (2015-03-29)\n------------------\n\n* Forgot to merge some commits ...\n\n0.3.0 (2015-03-29)\n------------------\n\n* Added handling for internal repr failures.\n* Fixed issues with displaying code that has non-ascii characters.\n* Implemented better display for ``call`` frames so that when a function has decorators the\n function definition is shown (instead of just the first decorator).\n See: `#8 `_.\n\n0.2.1 (2015-03-28)\n------------------\n\n* Added missing color entry for exception events.\n* Added ``hunter.event.Event.line`` property. It returns the source code for the line being run.\n\n0.2.0 (2015-03-27)\n------------------\n\n* Added color support (and ``colorama`` as dependency).\n* Added support for expressions in ``hunter.actions.VarsPrinter``.\n* Breaking changes:\n\n * Renamed ``F`` to ``hunter.Q``. And ``hunter.Q`` is now just a convenience wrapper for\n ``hunter.predicates.Query``.\n * Renamed the ``PYTHON_HUNTER`` env variable to ``PYTHONHUNTER``.\n * Changed ``hunter.predicates.When`` to take positional arguments.\n * Changed output to show 2 path components (still not configurable).\n * Changed ``hunter.actions.VarsPrinter`` to take positional arguments for the names.\n* Improved error reporting for env variable activation (``PYTHONHUNTER``).\n* Fixed env var activator (the ``.pth`` file) installation with ``setup.py install`` (the \"egg installs\") and\n ``setup.py develop``/``pip install -e`` (the \"egg links\").\n\n0.1.0 (2015-03-22)\n------------------\n\n* First release on PyPI.\n","description_content_type":null,"docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":"https://github.com/ionelmc/python-hunter","keywords":"trace, tracer, settrace, debugger, debugging, code, source","license":"BSD-2-Clause","license_expression":null,"license_files":null,"maintainer":null,"maintainer_email":null,"name":"hunter","package_url":"https://pypi.org/project/hunter/","platform":null,"project_url":"https://pypi.org/project/hunter/","project_urls":{"Changelog":"https://python-hunter.readthedocs.io/en/latest/changelog.html","Documentation":"https://python-hunter.readthedocs.io/","Homepage":"https://github.com/ionelmc/python-hunter","Issue Tracker":"https://github.com/ionelmc/python-hunter/issues"},"provides_extra":null,"release_url":"https://pypi.org/project/hunter/3.7.0/","requires_dist":["manhole>=1.5; platform_system != \"Windows\""],"requires_python":">=3.8","summary":"Hunter is a flexible code tracing toolkit.","version":"3.7.0","yanked":false,"yanked_reason":null}

Package search

hunter

project_urls

Dependencies

All package metadata

Releases