https://github.com/alexmojaki/birdseye

Graphical Python debugger which lets you easily view the values of all evaluated expressions
https://github.com/alexmojaki/birdseye

ast birdseye debugger debugging python python-debugger

Last synced: 6 days ago
JSON representation

Graphical Python debugger which lets you easily view the values of all evaluated expressions

• Host: GitHub
• URL: https://github.com/alexmojaki/birdseye
• Owner: alexmojaki
• License: mit
• Created: 2017-07-22T18:49:20.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-10-13T21:22:02.000Z (4 months ago)
• Last Synced: 2025-01-29T01:17:59.001Z (13 days ago)
• Topics: ast, birdseye, debugger, debugging, python, python-debugger
• Language: JavaScript
• Homepage: https://birdseye.readthedocs.io
• Size: 1.65 MB
• Stars: 1,665
• Watchers: 42
• Forks: 72
• Open Issues: 22
• Metadata Files:
  • Readme: README.rst
  • Contributing: docs/contributing.rst
  • License: LICENSE.txt

Awesome Lists containing this project

• my-awesome-github-stars - alexmojaki/birdseye - Graphical Python debugger which lets you easily view the values of all evaluated expressions (JavaScript)
• best-of-python-dev - GitHub - 36% open · ⏱️ 16.10.2023): (Debugging Tools)

README

        
|logo| birdseye

===============

|Build Status| |Supports Python versions 2.7 and 3.5+|

birdseye is a Python debugger which records the values of expressions in a

function call and lets you easily view them after the function exits.

For example:

.. figure:: https://i.imgur.com/rtZEhHb.gif

   :alt: Hovering over expressions

You can use birdseye no matter how you run or edit your code. Just ``pip install birdseye``, add the ``@eye`` decorator

as seen above, run your function however you like, and view the results in your browser.

It's also `integrated with some common tools `_ for a smoother experience.

You can try it out **instantly** on `futurecoder `_: enter your code in the editor on the left and click the ``birdseye`` button to run. No imports or decorators required.

Feature Highlights

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

Rather than stepping through lines, move back and forth through loop

iterations and see how the values of selected expressions change:

.. figure:: https://i.imgur.com/236Gj2E.gif

   :alt: Stepping through loop iterations

See which expressions raise exceptions, even if they’re suppressed:

.. figure:: http://i.imgur.com/UxqDyIL.png

   :alt: Exception highlighting

Expand concrete data structures and objects to see their contents.

Lengths and depths are limited to avoid an overload of data.

.. figure:: http://i.imgur.com/PfmqZnT.png

   :alt: Exploring data structures and objects

Calls are organised into functions (which are organised into files) and

ordered by time, letting you see what happens at a glance:

.. figure:: https://i.imgur.com/5OrB76I.png

   :alt: List of function calls

.. |logo| image:: https://i.imgur.com/i7uaJDO.png

.. |Build Status| image:: https://travis-ci.com/alexmojaki/birdseye.svg?branch=master

   :target: https://travis-ci.com/alexmojaki/birdseye

.. |Supports Python versions 2.7 and 3.5+| image:: https://img.shields.io/pypi/pyversions/birdseye.svg

   :target: https://pypi.python.org/pypi/birdseye

.. inclusion-end-marker

**Read more documentation** `here `_