https://github.com/trepan-debuggers/perl-devel-trepan

Perl port of trepanning debugger
https://github.com/trepan-debuggers/perl-devel-trepan

Last synced: about 1 year ago
JSON representation

Perl port of trepanning debugger

• Host: GitHub
• URL: https://github.com/trepan-debuggers/perl-devel-trepan
• Owner: Trepan-Debuggers
• License: gpl-3.0
• Created: 2011-08-28T03:58:14.000Z (almost 15 years ago)
• Default Branch: master
• Last Pushed: 2019-11-03T19:31:57.000Z (over 6 years ago)
• Last Synced: 2025-03-27T11:13:39.926Z (over 1 year ago)
• Language: Perl
• Homepage: https://metacpan.org/pod/Devel::Trepan
• Size: 3.23 MB
• Stars: 36
• Watchers: 6
• Forks: 8
• Open Issues: 14
• Metadata Files:
  • Readme: README
  • Changelog: ChangeLog
  • License: LICENSE

Awesome Lists containing this project

README

          
NAME

    Devel::Trepan -- A new Perl debugger

SUMMARY

    A modular, testable, gdb-like debugger in the family of the Ruby

    trepanning debuggers.

Features: 

* has extensive online-help, 

* syntax highlighting of Perl code

* context-sensitive command completion

* out-of-process and remote debugging

* interactive shell support

* code disassembly

* gdb syntax

* easy extensibility at several levels

    * command aliases

    * a user-supplied command directory

    * Perl Plugin module such as [Trepan::Devel::Disassemble](https://github.com/rocky/Perl-Devel-Trepan-Disassemble)

* is more modular

* comes with extensive tests

* is not as ugly as _perl5db_

INSTALLATION

To install this module, run the following commands:

	perl Build.PL

	./Build

	./Build test

	./Build install

DESCRIPTION

    From a shell:

        $ trepan.pl [trepan-opts] perl-program [perl-program-opts]

    Or for those who prefer the traditional Perlish way:

        $ perl -d:Trepan perl-program [perl-program-opts]

    Calling the debugger from inside your Perl program using Joshua ben

    Jore's Enbugger:

            # This needs to be done once and could even be in some sort of 

            # conditional code

            require Enbugger; Enbugger->load_debugger( 'trepan' );

            # Alternatively, to unconditionally load Enbugger and trepan:

            use Enbugger 'trepan';

            # work, work, work...

            # Oops! there was an error! Enable the debugger now!

            Enbugger->stop;  # or Enbugger->stop if ... 

    Or if you just want POSIX-shell-like `set -x` line tracing:

       $ trepan.pl -x -- perl-program [perl-program-opts]

    Inside the debugger tracing is turned on using the command `set

    trace print`.  

    There is extensive help from the `help` command.

AUTHORS

    Rocky Bernstein

COPYRIGHT

    Copyright (C) 2011, 2012 Rocky Bernstein 

    This program is distributed WITHOUT ANY WARRANTY, including but not

    limited to the implied warranties of merchantability or fitness for a

    particular purpose.

    The program is free software. You may distribute it and/or modify it

    under the terms of the GNU General Public License as published by the

    Free Software Foundation (either version 2 or any later version) and the

    Perl Artistic License as published by O'Reilly Media, Inc. Please open

    the files named gpl-2.0.txt and Artistic for a copy of these licenses.