semvec/pypi-packages huggingface dataset:
mr.freeze 1.0a3
Trigger a pdb in a running zope via a USR1 signal
License: BSD
Keywords: zope debugging pdb

Introduction
============

This package allows one to perform various debugging and development actions
on a running Zope instance.  In order to perform an action one must:

  1. Insert a command into a special control file.  To determine which file
     to look in, mr.freeze will take the Zope pid file and replace the
     extension with '.freeze'.  So in a typical buildout the control file
     would be var/instance.freeze
  2. Send a *USR1* signal to the Zope instance.

This pattern is intended to support integration with editors like TextMate
and emacs, but that hasn't been implemented yet.


Commands
========

The following commands are currently supported in both debug and non-debug mode.

stack
  Will dump a stack backtrace for all threads to the console.
  (Default command if unable to read freeze file.)

pony
  Will dump a pony to the console.


The following commands are supported in debug mode only.

freeze
  Will drop Zope to a pdb debug prompt.

freeze [file] [line #]
  Will set a pdb breakpoint on the specified line.


The following commands are planned.

reload code
  Will reload code that has been modified.

reload zcml
  Will reload code and ZCML that has been modified.


Editor integration
==================

Please see r82128_ for some preliminary information regarding TextMate_
integration or watch the quick `demo screen cast`__.

  .. _r82128: http://dev.plone.org/collective/changeset/82128
  .. _TextMate: http://macromates.com/
  .. __: http://www.vimeo.com/3595417

Credits
=======

 * David Glick
 * Andreas Zeidler

Thanks to those who have helped provide the foundation for this package:

 * Products.signalstack: Wichert Akkerman
 * Products.PDBDebugMode: Ross Patterson
 * z3c.deadlockdebugger: Malthe Borch
 * DeadlockDebugger: Florent Guillaume
 * threadframe: Fazal Majid

Changelog
=========

1.0a3 (2009-03-19)
------------------

* Fix the adjusted patch from 1.0a2 so that we actually return responses. :->
  [davisagli]

1.0a2 (2009-03-19)
------------------

* Be a little more careful about patching ZPublisher's call_object,
  so that we can coexist with PDBDebugMode.

* Use canonical path of files passed to the freeze command.

* Fixes for TextMate integration script.
  [witsch]


1.0a1 (2009-03-12)
------------------

* Add script to help integrate with TextMate.  Please see
  http://dev.plone.org/collective/changeset/82128 for some preliminary info.
  [witsch]

* Initial release
  [davisagli]