Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jaredly/vim-debug

A plugin for VIM that creates an Integrated Debugging Environment :) Currently works with PHP and Python
https://github.com/jaredly/vim-debug

Last synced: 15 days ago
JSON representation

A plugin for VIM that creates an Integrated Debugging Environment :) Currently works with PHP and Python

Host: GitHub
URL: https://github.com/jaredly/vim-debug
Owner: jaredly
License: mit
Created: 2010-07-12T16:26:15.000Z (over 14 years ago)
Default Branch: master
Last Pushed: 2021-07-18T13:35:46.000Z (over 3 years ago)
Last Synced: 2024-10-22T21:34:43.368Z (23 days ago)
Language: Python
Homepage: http://jaredforsyth.com/projects/vim-debug
Size: 199 KB
Stars: 284
Watchers: 13
Forks: 28
Open Issues: 16
Metadata Files:
- Readme: README.rst
- License: LICENSE

Awesome Lists containing this project

README

        .. |vim-debug-logo| image:: https://raw.github.com/jabapyth/vim-debug/master/logo.png

|vim-debug-logo| vim-debug

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

.. Maintainer: Jared Forsyth 

.. Source: http://github.com/jabapyth/vim-phpdebug

This plugin creates an integrated debugging environment in VIM.

It supports Python 2 and PHP.

Support Status

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

Seeking maintainer! I haven't used this actively in many years, and it's likely that alternatives have cropped up that are better. If you know one (or find one) please PR this readme and put a link [here] :D

If you want to make this package better, open an issue asking to be a maintainer!

Thanks

License

-------

MIT

Features

--------

* Integration with xdebug

* Step (into/over/out)

* Live stack view

* Breakpoint set/remove

* Watch expressions

* Live scope view

* Some improvements to make it easier to hack

  * It's now in a true python package

  * Modularized

  * Cleaned up, substantially rewritten for consistency

Planned:

* Conditional breakpoints

Usage

-----

To start your debug session, use the following variants::

   Usage: Dbg - (no auto start)

          Dbg . (autostart current file -- python)

          Dbg url (autostart a URL -- PHP)

          Dbg num (autostart a past url -- PHP)

Note: for PHP urls, vim-debug keeps track of the last 5 urls you debugged --

so you don't have to keep typing them in.

Debugger commands::

   [usage:] dbg command [options]

   - quit    :: exit the debugger

   - run     :: continue execution until a breakpoint is reached or the program ends

            default shortcut: \r

   - stop    :: exit the debugger

   - over    :: step over next function call

            default shortcut: \o

   - watch   :: execute watch functions

            default shortcut: \w

   - up      :: go up the stack

            default shortcut: \u

   - here    :: continue execution until the cursor (tmp breakpoint)

            default shortcut: \h

   - down    :: go down the stack

            default shortcut: \d

   - exit    :: exit the debugger

   - eval    :: eval some code

   - break   :: set a breakpoint

            default shortcut: \b

   - into    :: step into next function call

            default shortcut: \i

   - out     :: step out of current function call

            default shortcut: \t

To disable the default mappings, set the variable ``g:vim_debug_disable_mappings`` to a value

different than 0 in the debugger.vim file.

For example::

    let g:vim_debug_disable_mappings = 1

Installation

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

Execute the following commands::

    sudo pip install dbgp

and then use your preferred vim plugin manage (`pathogen

`_, `Vundle

`_, `vim-plug

`_, et al.) and install this

repository (``jaredly/vim-debug``) as appropriate for the given manager.

Take a look

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

Screenshot: `[full size]

`_

.. image:: http://jaredforsyth.com/media/uploads/images/vim_debug.jpeg

   :width: 450

A screencast tutorial: https://www.youtube.com/watch?v=kairdgZCD1U

Some links of interest

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

`Python package installer `_

`Xdebug docs `_

Credits

-------

:Sam Ghods: `(last activity 6/21/07) `_

:Seung Woo Shin: `(last activity 12/7/04) `_