wxPython/docs/PyManual.html

   1 <?xml version="1.0" encoding="iso-8859-1" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   4 <head>
   5 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
   6 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
   7 <title>The Py Manual</title>
   8 <meta name="author" content="Patrick K. O'Brien" />
   9 <meta name="organization" content="Orbtech" />
  10 <meta name="date" content="2004-04-15" />
  11 <style type="text/css">
  12
  13 /*
  14 :Author: David Goodger
  15 :Contact: goodger@users.sourceforge.net
  16 :Date: $Date$
  17 :Revision: $Revision$
  18 :Copyright: This stylesheet has been placed in the public domain.
  19
  20 Default cascading style sheet for the HTML output of Docutils.
  21
  22 See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
  23 customize this style sheet.
  24 */
  25
  26 /* used to remove borders from tables and images */
  27 .borderless, table.borderless td, table.borderless th {
  28   border: 0 }
  29
  30 table.borderless td, table.borderless th {
  31   /* Override padding for "table.docutils td" with "! important".
  32      The right padding separates the table cells. */
  33   padding: 0 0.5em 0 0 ! important }
  34
  35 .first {
  36   /* Override more specific margin styles with "! important". */
  37   margin-top: 0 ! important }
  38
  39 .last, .with-subtitle {
  40   margin-bottom: 0 ! important }
  41
  42 .hidden {
  43   display: none }
  44
  45 a.toc-backref {
  46   text-decoration: none ;
  47   color: black }
  48
  49 blockquote.epigraph {
  50   margin: 2em 5em ; }
  51
  52 dl.docutils dd {
  53   margin-bottom: 0.5em }
  54
  55 /* Uncomment (and remove this text!) to get bold-faced definition list terms
  56 dl.docutils dt {
  57   font-weight: bold }
  58 */
  59
  60 div.abstract {
  61   margin: 2em 5em }
  62
  63 div.abstract p.topic-title {
  64   font-weight: bold ;
  65   text-align: center }
  66
  67 div.admonition, div.attention, div.caution, div.danger, div.error,
  68 div.hint, div.important, div.note, div.tip, div.warning {
  69   margin: 2em ;
  70   border: medium outset ;
  71   padding: 1em }
  72
  73 div.admonition p.admonition-title, div.hint p.admonition-title,
  74 div.important p.admonition-title, div.note p.admonition-title,
  75 div.tip p.admonition-title {
  76   font-weight: bold ;
  77   font-family: sans-serif }
  78
  79 div.attention p.admonition-title, div.caution p.admonition-title,
  80 div.danger p.admonition-title, div.error p.admonition-title,
  81 div.warning p.admonition-title {
  82   color: red ;
  83   font-weight: bold ;
  84   font-family: sans-serif }
  85
  86 /* Uncomment (and remove this text!) to get reduced vertical space in
  87    compound paragraphs.
  88 div.compound .compound-first, div.compound .compound-middle {
  89   margin-bottom: 0.5em }
  90
  91 div.compound .compound-last, div.compound .compound-middle {
  92   margin-top: 0.5em }
  93 */
  94
  95 div.dedication {
  96   margin: 2em 5em ;
  97   text-align: center ;
  98   font-style: italic }
  99
 100 div.dedication p.topic-title {
 101   font-weight: bold ;
 102   font-style: normal }
 103
 104 div.figure {
 105   margin-left: 2em ;
 106   margin-right: 2em }
 107
 108 div.footer, div.header {
 109   clear: both;
 110   font-size: smaller }
 111
 112 div.line-block {
 113   display: block ;
 114   margin-top: 1em ;
 115   margin-bottom: 1em }
 116
 117 div.line-block div.line-block {
 118   margin-top: 0 ;
 119   margin-bottom: 0 ;
 120   margin-left: 1.5em }
 121
 122 div.sidebar {
 123   margin-left: 1em ;
 124   border: medium outset ;
 125   padding: 1em ;
 126   background-color: #ffffee ;
 127   width: 40% ;
 128   float: right ;
 129   clear: right }
 130
 131 div.sidebar p.rubric {
 132   font-family: sans-serif ;
 133   font-size: medium }
 134
 135 div.system-messages {
 136   margin: 5em }
 137
 138 div.system-messages h1 {
 139   color: red }
 140
 141 div.system-message {
 142   border: medium outset ;
 143   padding: 1em }
 144
 145 div.system-message p.system-message-title {
 146   color: red ;
 147   font-weight: bold }
 148
 149 div.topic {
 150   margin: 2em }
 151
 152 h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
 153 h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
 154   margin-top: 0.4em }
 155
 156 h1.title {
 157   text-align: center }
 158
 159 h2.subtitle {
 160   text-align: center }
 161
 162 hr.docutils {
 163   width: 75% }
 164
 165 img.align-left {
 166   clear: left }
 167
 168 img.align-right {
 169   clear: right }
 170
 171 ol.simple, ul.simple {
 172   margin-bottom: 1em }
 173
 174 ol.arabic {
 175   list-style: decimal }
 176
 177 ol.loweralpha {
 178   list-style: lower-alpha }
 179
 180 ol.upperalpha {
 181   list-style: upper-alpha }
 182
 183 ol.lowerroman {
 184   list-style: lower-roman }
 185
 186 ol.upperroman {
 187   list-style: upper-roman }
 188
 189 p.attribution {
 190   text-align: right ;
 191   margin-left: 50% }
 192
 193 p.caption {
 194   font-style: italic }
 195
 196 p.credits {
 197   font-style: italic ;
 198   font-size: smaller }
 199
 200 p.label {
 201   white-space: nowrap }
 202
 203 p.rubric {
 204   font-weight: bold ;
 205   font-size: larger ;
 206   color: maroon ;
 207   text-align: center }
 208
 209 p.sidebar-title {
 210   font-family: sans-serif ;
 211   font-weight: bold ;
 212   font-size: larger }
 213
 214 p.sidebar-subtitle {
 215   font-family: sans-serif ;
 216   font-weight: bold }
 217
 218 p.topic-title {
 219   font-weight: bold }
 220
 221 pre.address {
 222   margin-bottom: 0 ;
 223   margin-top: 0 ;
 224   font-family: serif ;
 225   font-size: 100% }
 226
 227 pre.literal-block, pre.doctest-block {
 228   margin-left: 2em ;
 229   margin-right: 2em ;
 230   background-color: #eeeeee }
 231
 232 span.classifier {
 233   font-family: sans-serif ;
 234   font-style: oblique }
 235
 236 span.classifier-delimiter {
 237   font-family: sans-serif ;
 238   font-weight: bold }
 239
 240 span.interpreted {
 241   font-family: sans-serif }
 242
 243 span.option {
 244   white-space: nowrap }
 245
 246 span.pre {
 247   white-space: pre }
 248
 249 span.problematic {
 250   color: red }
 251
 252 span.section-subtitle {
 253   /* font-size relative to parent (h1..h6 element) */
 254   font-size: 80% }
 255
 256 table.citation {
 257   border-left: solid 1px gray;
 258   margin-left: 1px }
 259
 260 table.docinfo {
 261   margin: 2em 4em }
 262
 263 table.docutils {
 264   margin-top: 0.5em ;
 265   margin-bottom: 0.5em }
 266
 267 table.footnote {
 268   border-left: solid 1px black;
 269   margin-left: 1px }
 270
 271 table.docutils td, table.docutils th,
 272 table.docinfo td, table.docinfo th {
 273   padding-left: 0.5em ;
 274   padding-right: 0.5em ;
 275   vertical-align: top }
 276
 277 table.docutils th.field-name, table.docinfo th.docinfo-name {
 278   font-weight: bold ;
 279   text-align: left ;
 280   white-space: nowrap ;
 281   padding-left: 0 }
 282
 283 h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
 284 h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
 285   font-size: 100% }
 286
 287 tt.docutils {
 288   background-color: #eeeeee }
 289
 290 ul.auto-toc {
 291   list-style-type: none }
 292
 293 </style>
 294 </head>
 295 <body>
 296 <div class="document" id="the-py-manual">
 297 <h1 class="title">The Py Manual</h1>
 298 <h2 class="subtitle" id="py-served-fresh-daily">Py - Served Fresh Daily</h2>
 299 <table class="docinfo" frame="void" rules="none">
 300 <col class="docinfo-name" />
 301 <col class="docinfo-content" />
 302 <tbody valign="top">
 303 <tr><th class="docinfo-name">Author:</th>
 304 <td>Patrick K. O'Brien</td></tr>
 305 <tr><th class="docinfo-name">Contact:</th>
 306 <td><a class="first last reference" href="mailto:pobrien&#64;orbtech.com">pobrien&#64;orbtech.com</a></td></tr>
 307 <tr><th class="docinfo-name">Organization:</th>
 308 <td><a class="first last reference" href="http://www.orbtech.com/">Orbtech</a></td></tr>
 309 <tr><th class="docinfo-name">Date:</th>
 310 <td>2004-04-15</td></tr>
 311 <tr><th class="docinfo-name">Revision:</th>
 312 <td>1.5</td></tr>
 313 </tbody>
 314 </table>
 315 <div class="contents topic">
 316 <p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
 317 <ul class="simple">
 318 <li><a class="reference" href="#introduction" id="id4" name="id4">Introduction</a></li>
 319 <li><a class="reference" href="#developer-reference" id="id5" name="id5">Developer Reference</a></li>
 320 <li><a class="reference" href="#what-is-py" id="id6" name="id6">What is Py?</a></li>
 321 <li><a class="reference" href="#pycrust-is-dead-long-live-py" id="id7" name="id7">PyCrust is dead! Long live Py!</a></li>
 322 <li><a class="reference" href="#py-standalone-programs" id="id8" name="id8">Py standalone programs</a></li>
 323 <li><a class="reference" href="#pyalacarte" id="id9" name="id9">PyAlaCarte</a></li>
 324 <li><a class="reference" href="#pyalamode" id="id10" name="id10">PyAlaMode</a></li>
 325 <li><a class="reference" href="#pycrust" id="id11" name="id11">PyCrust</a></li>
 326 <li><a class="reference" href="#pyfilling" id="id12" name="id12">PyFilling</a></li>
 327 <li><a class="reference" href="#pyshell" id="id13" name="id13">PyShell</a></li>
 328 <li><a class="reference" href="#pywrap" id="id14" name="id14">PyWrap</a></li>
 329 <li><a class="reference" href="#py-modules" id="id15" name="id15">Py modules</a></li>
 330 <li><a class="reference" href="#projects-using-py" id="id16" name="id16">Projects using Py</a></li>
 331 <li><a class="reference" href="#history-of-changes" id="id17" name="id17">History of changes</a><ul>
 332 <li><a class="reference" href="#id1" id="id18" name="id18">0.9.5 (12/23/2005)</a></li>
 333 <li><a class="reference" href="#to-2004" id="id19" name="id19">0.9.4 (1/25/2004 to //2004)</a></li>
 334 <li><a class="reference" href="#to-1-24-2004" id="id20" name="id20">0.9.3 (9/25/2003 to 1/24/2004)</a></li>
 335 <li><a class="reference" href="#to-9-25-2003" id="id21" name="id21">0.9.2 (5/3/2003 to 9/25/2003)</a></li>
 336 <li><a class="reference" href="#to-5-2-2003" id="id22" name="id22">0.9.1 (3/21/2003 to 5/2/2003)</a></li>
 337 <li><a class="reference" href="#to-3-20-2003" id="id23" name="id23">0.9 (2/27/2003 to 3/20/2003)</a></li>
 338 <li><a class="reference" href="#to-2-26-2003" id="id24" name="id24">0.8.2 (1/5/2003 to 2/26/2003)</a></li>
 339 <li><a class="reference" href="#to-12-25-2002" id="id25" name="id25">0.8.1 (12/20/2002 to 12/25/2002)</a></li>
 340 <li><a class="reference" href="#to-12-16-2002" id="id26" name="id26">0.8 (10/29/2002 to 12/16/2002)</a></li>
 341 <li><a class="reference" href="#to-8-27-2002" id="id27" name="id27">0.7.2 (2/22/2002 to 8/27/2002)</a></li>
 342 <li><a class="reference" href="#to-2-21-2002" id="id28" name="id28">0.7.1 (12/12/2001 to 2/21/2002)</a></li>
 343 <li><a class="reference" href="#to-12-11-2001" id="id29" name="id29">0.7 (10/15/2001 to 12/11/2001)</a></li>
 344 <li><a class="reference" href="#to-10-12-2001" id="id30" name="id30">0.6.1 (9/19/2001 to 10/12/2001)</a></li>
 345 <li><a class="reference" href="#to-9-12-2001" id="id31" name="id31">0.6 (8/21/2001 to 9/12/2001)</a></li>
 346 <li><a class="reference" href="#to-8-20-2001" id="id32" name="id32">0.5.4 (8/17/2001 to 8/20/2001)</a></li>
 347 <li><a class="reference" href="#id2" id="id33" name="id33">0.5.3 (8/16/2001)</a></li>
 348 <li><a class="reference" href="#to-8-15-2001" id="id34" name="id34">0.5.2 (8/14/2001 to 8/15/2001)</a></li>
 349 <li><a class="reference" href="#to-8-14-2001" id="id35" name="id35">0.5.1 (8/10/2001 to 8/14/2001)</a></li>
 350 <li><a class="reference" href="#id3" id="id36" name="id36">0.5 (8/8/2001)</a></li>
 351 <li><a class="reference" href="#to-8-7-2001" id="id37" name="id37">0.4 (8/4/2001 to 8/7/2001)</a></li>
 352 <li><a class="reference" href="#to-8-3-2001" id="id38" name="id38">0.3 (8/2/2001 to 8/3/2001)</a></li>
 353 <li><a class="reference" href="#to-8-2-2001" id="id39" name="id39">0.2 (7/30/2001 to 8/2/2001)</a></li>
 354 <li><a class="reference" href="#to-7-19-2001" id="id40" name="id40">0.1 (7/1/2001 to 7/19/2001)</a></li>
 355 <li><a class="reference" href="#in-the-beginning-there-was-pie-7-1-2001" id="id41" name="id41">In the beginning, there was pie... (7/1/2001)</a></li>
 356 </ul>
 357 </li>
 358 </ul>
 359 </div>
 360 <div class="section">
 361 <h1><a class="toc-backref" href="#id4" id="introduction" name="introduction">Introduction</a></h1>
 362 <p>This document will show you how to use the Py programs and the Py
 363 library of Python source code modules.  Py is the new name for the
 364 project that began as PyCrust.  Py is officially part of <a class="reference" href="http://www.wxpython.org/">wxPython</a>,
 365 and includes PyCrust, so PyCrust is no longer distributed separately.</p>
 366 </div>
 367 <div class="section">
 368 <h1><a class="toc-backref" href="#id5" id="developer-reference" name="developer-reference">Developer Reference</a></h1>
 369 <p>Source code documentation for developers is available at:</p>
 370 <p><a class="reference" href="http://www.orbtech.com/www/wx/epydoc/public/wx.py-module.html">http://www.orbtech.com/www/wx/epydoc/public/wx.py-module.html</a></p>
 371 </div>
 372 <div class="section">
 373 <h1><a class="toc-backref" href="#id6" id="what-is-py" name="what-is-py">What is Py?</a></h1>
 374 <p>Besides being <a class="reference" href="http://www.wikipedia.org/wiki/Pie">a delicious dessert</a>, Py is the name for a collection
 375 of whimsically-named Python programs and modules that began as the
 376 PyCrust project.  So Py is really several things: a set of standalone
 377 programs, including the original PyCrust program, a library of Python
 378 source code modules that can be used in your own programs, and as many
 379 examples of bad &quot;pie&quot; puns as I can come up with.  (If you're going to
 380 do something, you might as well do it all the way, right?)  Py uses
 381 Python and wxPython, so it works equally well on Windows, Linux and
 382 Mac OS X.</p>
 383 </div>
 384 <div class="section">
 385 <h1><a class="toc-backref" href="#id7" id="pycrust-is-dead-long-live-py" name="pycrust-is-dead-long-live-py">PyCrust is dead! Long live Py!</a></h1>
 386 <p>This project began with a program I created called PyCrust - an
 387 interactive, graphical Python shell, developed using the wxPython GUI
 388 toolkit.  For about two years, PyCrust was hosted on <a class="reference" href="http://www.sf.net/projects/pycrust/">SourceForge</a>.
 389 Shortly after I created PyCrust, the wxPython folks started including
 390 it in their distribution.  As the PyCrust project grew, it reached a
 391 point where I thought the original PyCrust name was too confining.  I
 392 was using the PyCrust code base to develop programs that weren't just
 393 Python shells any more.</p>
 394 <p>Around that same time, the wxPython folks asked me if I'd be willing
 395 to move all my wxPython-related projects into the <a class="reference" href="http://cvs.wxWidgets.org">wxPython CVS
 396 repository</a>, and become part of the <a class="reference" href="http://www.wxpython.org/">wxPython</a>/<a class="reference" href="http://www.wxWidgets.org/">wxWidgets</a> developer team.
 397 I decided the time was right to restructure the PyCrust project.
 398 During the move, the PyCrust package was renamed to &quot;py&quot; (lowercase
 399 &quot;p&quot;) and the collection of programs and modules as a whole became
 400 known as &quot;Py&quot; (with a capital &quot;P&quot;).</p>
 401 <p>The original goal of PyCrust was to be the best interactive, graphical
 402 Python shell (of course, I claimed it was the &quot;flakiest&quot; Python
 403 shell).  And that was all I wanted it to be.  But little by little I
 404 found myself developing a wider variety of tools for wxPython
 405 applications.  Eventually I'll create a debugger (PySlice, perhaps)
 406 and whatever else is needed to one day become a complete wxPython
 407 application development environment (PyFactory?).  In the mean time,
 408 PyCrust is still the flakiest Python shell, and the other Py programs
 409 are equally tasty.</p>
 410 <p>At this point, Py has standalone programs that include Python code
 411 editors (PyAlaCarte and PyAlaMode), interactive Python shells (PyCrust
 412 and PyShell), and a runtime wrapper (PyWrap).  The runtime wrapper
 413 utility provides you with runtime introspection capabilities for your
 414 wxPython programs without having to include PyCrust or PyShell in your
 415 program, and without having to alter one line of your source code.</p>
 416 <p>Py also contains a collection of modules that you can use in your own
 417 wxPython applications to provide similar services, either for your own
 418 use during development, or as an interface for users of your programs.
 419 These modules are the same ones used by all the Py programs.</p>
 420 </div>
 421 <div class="section">
 422 <h1><a class="toc-backref" href="#id8" id="py-standalone-programs" name="py-standalone-programs">Py standalone programs</a></h1>
 423 <p>These are the standalone applications in the Py collection:</p>
 424 <ul class="simple">
 425 <li>PyAlaCarte</li>
 426 <li>PyAlaMode</li>
 427 <li>PyCrust</li>
 428 <li>PyFilling</li>
 429 <li>PyShell</li>
 430 <li>PyWrap</li>
 431 </ul>
 432 </div>
 433 <div class="section">
 434 <h1><a class="toc-backref" href="#id9" id="pyalacarte" name="pyalacarte">PyAlaCarte</a></h1>
 435 <p>PyAlaCarte is a Python source code editor.  It is designed to have a
 436 simple, single-file interface.  As a standalone application, it is
 437 good for simple, short editing tasks.  But it is really meant to be
 438 more of an example of how to embed the Py editor into a wxPython
 439 application.</p>
 440 </div>
 441 <div class="section">
 442 <h1><a class="toc-backref" href="#id10" id="pyalamode" name="pyalamode">PyAlaMode</a></h1>
 443 <p>PyAlaMode is a Python source code editor.</p>
 444 </div>
 445 <div class="section">
 446 <h1><a class="toc-backref" href="#id11" id="pycrust" name="pycrust">PyCrust</a></h1>
 447 <p>PyCrust is an interactive, Python shell.  But it's more than just a
 448 shell.  It includes a tabbed notebook containing a namespace tree
 449 (PyFilling), and several other things.</p>
 450 </div>
 451 <div class="section">
 452 <h1><a class="toc-backref" href="#id12" id="pyfilling" name="pyfilling">PyFilling</a></h1>
 453 <p>PyFilling is a namespace viewer.  It isn't really useful as a
 454 standalone program, but it does illustrate how to make use of the
 455 underlying <tt class="docutils literal"><span class="pre">filling</span></tt> module.</p>
 456 </div>
 457 <div class="section">
 458 <h1><a class="toc-backref" href="#id13" id="pyshell" name="pyshell">PyShell</a></h1>
 459 <p>PyShell is an interactive, Python shell.  It shares the same base code
 460 as PyCrust, but doesn't have any of the extra features that appear in
 461 the PyCrust notebook interface.</p>
 462 <div class="figure">
 463 <img alt="screenshots/PyShell.png" src="screenshots/PyShell.png" />
 464 <p class="caption">PyShell running on Mandrake Linux.</p>
 465 </div>
 466 </div>
 467 <div class="section">
 468 <h1><a class="toc-backref" href="#id14" id="pywrap" name="pywrap">PyWrap</a></h1>
 469 <p>PyWrap is a runtime utility that lets you run an existing wxPython
 470 program with a PyCrust frame at the same time.  Inside the PyCrust
 471 shell namespace, the local variable <tt class="docutils literal"><span class="pre">app</span></tt> is assigned to your
 472 application instance.  In this way you can introspect your entire
 473 application within the PyCrust shell, as well as the PyFilling
 474 namespace viewer.</p>
 475 </div>
 476 <div class="section">
 477 <h1><a class="toc-backref" href="#id15" id="py-modules" name="py-modules">Py modules</a></h1>
 478 <p>Py was designed to be modular.  That means graphical code is kept
 479 separate from non-graphical code, and many of the Py modules can be
 480 used by other programs.  Likewise, other programs can supply some of
 481 the modules needed by Py.  For example, you could supply a customized
 482 interpreter module and plug it in to the PyCrust standalone
 483 application.  As long as it supports the minimum functionality
 484 required, PyCrust will work just as well with your interpreter as with
 485 its default interpreter.</p>
 486 </div>
 487 <div class="section">
 488 <h1><a class="toc-backref" href="#id16" id="projects-using-py" name="projects-using-py">Projects using Py</a></h1>
 489 <ul class="simple">
 490 <li><a class="reference" href="http://conflictsolver.sourceforge.net/">Conflict Solver</a></li>
 491 <li><a class="reference" href="http://www.gnumed.org/">Gnumed</a></li>
 492 <li>PyGist</li>
 493 <li><a class="reference" href="http://www.pythoncard.org/">PythonCard</a></li>
 494 <li><a class="reference" href="http://rpy.sourceforge.net/">RPy</a></li>
 495 <li><a class="reference" href="http://www.scipy.org/">SciPy</a></li>
 496 <li><a class="reference" href="http://www.sim42.org/">Sim42</a></li>
 497 <li><a class="reference" href="http://linus.yorktown.arlington.k12.va.us/CS/APCSC/student_sites/David_Mayo/wxGasp">wxGasp</a></li>
 498 </ul>
 499 </div>
 500 <div class="section">
 501 <h1><a class="toc-backref" href="#id17" id="history-of-changes" name="history-of-changes">History of changes</a></h1>
 502 <p>This section lists all the changes that have been made to the Py
 503 programs and modules, since the beginning.</p>
 504 <div class="section">
 505 <h2><a class="toc-backref" href="#id18" id="id1" name="id1">0.9.5 (12/23/2005)</a></h2>
 506 <p>Applied a series of enhancments by Franz Steinaeusler, Adi Sieker, and
 507 Sebastian Haase, up until their 7-31-2005 version.  (Their next
 508 version broke some existing functionality, and added some confusing
 509 hacks, and I didn't feel that the incremental gains were worth the
 510 loss at that point so I stopped at 7-31-2005.)</p>
 511 <p>Their changes include the following:</p>
 512 <ul class="simple">
 513 <li>The Autocomplete and Calltip windows can now be opened manually with
 514 Ctrl-Space and Ctrl-Shift-Space.</li>
 515 <li>In the stand alone PyCrust app the various option settings, window
 516 size and position, and etc. are saved and restored at the next run.</li>
 517 <li>Added a help dialog bound to the F1 key that shows the key bindings.</li>
 518 <li>Added a new text completion function that suggests words from the
 519 history.  Bound to Shift-Return.</li>
 520 <li>F11 will toggle the maximized state of the frame.</li>
 521 <li>switched to Bind() from wx.EVT_*().</li>
 522 <li>Display of line numbers can be toggled.</li>
 523 <li>F12 toggles a &quot;free edit&quot; mode of the shell buffer.  This mode is
 524 useful, for example, if you would like to remove some output or
 525 errors or etc. from the buffer before doing a copy/paste.  The free
 526 edit mode is designated by the use of a red, non-flashing caret.</li>
 527 <li>Ctrl-Shift-F will fold/unfold (hide/show) the selected lines.</li>
 528 </ul>
 529 <p>On top of these changes I (Robin Dunn) added the following:</p>
 530 <ul class="simple">
 531 <li>General code cleanup and fixes.</li>
 532 <li>Use wx.StandardPaths to determine the location of the config files.</li>
 533 <li>Remove Orbtech attributions from the UI, they've been there long
 534 enough.</li>
 535 <li>Use wx.SP_LIVE_UPDATE on crust and filling windows.</li>
 536 <li>Extended the saving of the config info and other new features to the
 537 PyShell app too.  Additionally, other apps that embed a PyCrust or a
 538 PyShell can pass their own wx.Config object and have the Py code
 539 save/restore its settings to/from there.</li>
 540 <li>All of the classes with config info get an opportunity to save/load
 541 their own settings instead of putting all the save/load code in one
 542 place that then has to reach all over the place to do anything.</li>
 543 <li>Enable editing of the startup python code, which will either be the
 544 file pointed to by PYTHONSTARTUP or a file in the config dir if
 545 PYTHONSTARTUP is not set in the environment.</li>
 546 <li>Added an option to skip the running of the startup code when
 547 PyShell or PyCrust starts.</li>
 548 <li>PyCrust adds a pp(item) function to the shell's namespace that
 549 pretty prints the item in the Display tab of the notebook.  Added
 550 code to raise that tab when pp() is called.</li>
 551 <li>Added an option for whether to insert text for function parameters
 552 when popping up the call tip.</li>
 553 <li>Added Find and Find-Next functions that use the wx.FindReplaceDialog.</li>
 554 </ul>
 555 </div>
 556 <div class="section">
 557 <h2><a class="toc-backref" href="#id19" id="to-2004" name="to-2004">0.9.4 (1/25/2004 to //2004)</a></h2>
 558 <p>Removed wxd decorators in favor of new SWIG-generated docstrings.</p>
 559 <p>Removed docs tabs from crust interface:
 560 * wxPython Docs
 561 * wxSTC Docs</p>
 562 <p>Fixed Calltip tab refresh problem on Windows.</p>
 563 <p>shell.autoCompleteAutoHide added with default of False.</p>
 564 <p>Changed default namespace of Shell to __main__.__dict__, instead of an
 565 empty dictionary.</p>
 566 </div>
 567 <div class="section">
 568 <h2><a class="toc-backref" href="#id20" id="to-1-24-2004" name="to-1-24-2004">0.9.3 (9/25/2003 to 1/24/2004)</a></h2>
 569 <p>Fun and games with dynamic renaming.  Details of any other changes
 570 were lost in the confusion.  I'll try to do better in the future.</p>
 571 </div>
 572 <div class="section">
 573 <h2><a class="toc-backref" href="#id21" id="to-9-25-2003" name="to-9-25-2003">0.9.2 (5/3/2003 to 9/25/2003)</a></h2>
 574 <p>Changed to the new prefix-less &quot;wx&quot; package:</p>
 575 <pre class="literal-block">
 576 import wx
 577 </pre>
 578 <p>instead of:</p>
 579 <pre class="literal-block">
 580 from wxPython import wx
 581 </pre>
 582 <p>Fixed typo in <tt class="docutils literal"><span class="pre">PyWrap.py</span></tt>:</p>
 583 <pre class="literal-block">
 584 if __name__ == '__main__':
 585     main(sys.argv)
 586 </pre>
 587 <p>should have been:</p>
 588 <pre class="literal-block">
 589 if __name__ == '__main__':
 590     main()
 591 </pre>
 592 <p>Added pretty-print Display tab to Crust, based on suggestion from
 593 Jason Whitlark.</p>
 594 <p>Improved <tt class="docutils literal"><span class="pre">Can*</span></tt> checks in <tt class="docutils literal"><span class="pre">EditWindow</span></tt>, since STC is too lenient,
 595 particularly when it is set to read-only but returns True for
 596 CanPaste() (seems like an STC bug to me):</p>
 597 <pre class="literal-block">
 598 def CanCopy(self):
 599     &quot;&quot;&quot;Return True if text is selected and can be copied.&quot;&quot;&quot;
 600     return self.GetSelectionStart() != self.GetSelectionEnd()
 601
 602 def CanCut(self):
 603     &quot;&quot;&quot;Return True if text is selected and can be cut.&quot;&quot;&quot;
 604     return self.CanCopy() and self.CanEdit()
 605
 606 def CanEdit(self):
 607     &quot;&quot;&quot;Return True if editing should succeed.&quot;&quot;&quot;
 608     return not self.GetReadOnly()
 609
 610 def CanPaste(self):
 611     &quot;&quot;&quot;Return True if pasting should succeed.&quot;&quot;&quot;
 612     return stc.StyledTextCtrl.CanPaste(self) and self.CanEdit()
 613 </pre>
 614 </div>
 615 <div class="section">
 616 <h2><a class="toc-backref" href="#id22" id="to-5-2-2003" name="to-5-2-2003">0.9.1 (3/21/2003 to 5/2/2003)</a></h2>
 617 <p>PyCrust is dead!  Long live Py!</p>
 618 <ul class="simple">
 619 <li>Renamed <tt class="docutils literal"><span class="pre">PyCrust</span></tt> package to <tt class="docutils literal"><span class="pre">py</span></tt>.</li>
 620 <li>Moved code to wxPython's CVS repository.</li>
 621 </ul>
 622 <p>Fixed bug in <tt class="docutils literal"><span class="pre">introspect.py</span></tt> on introspecting objects occurring
 623 immediately after a secondary prompt, like this:</p>
 624 <pre class="literal-block">
 625 &gt;&gt;&gt; l = [1, 2, 3]
 626 &gt;&gt;&gt; for n in range(3):
 627 ...     l.  &lt;-- failed to popup autocomplete list
 628 </pre>
 629 <p>Added documentation files:</p>
 630 <ul class="simple">
 631 <li>PyManual.txt</li>
 632 <li>wxPythonManual.txt</li>
 633 <li>wxPythonPackage.txt</li>
 634 <li>wxPythonExamples.txt</li>
 635 </ul>
 636 <p>Added PyAlaMode and PyAlaCarte code editors.</p>
 637 <p>Major refactoring to support <tt class="docutils literal"><span class="pre">editor</span></tt> and <tt class="docutils literal"><span class="pre">shell</span></tt> from the same
 638 base.</p>
 639 <p>Renamed program files:</p>
 640 <ul class="simple">
 641 <li><tt class="docutils literal"><span class="pre">PyCrustApp.py</span></tt> to <tt class="docutils literal"><span class="pre">PyCrust.py</span></tt></li>
 642 <li><tt class="docutils literal"><span class="pre">PyFillingApp.py</span></tt> to <tt class="docutils literal"><span class="pre">PyFilling.py</span></tt></li>
 643 <li><tt class="docutils literal"><span class="pre">PyShellApp.py</span></tt> to <tt class="docutils literal"><span class="pre">PyShell.py</span></tt></li>
 644 <li><tt class="docutils literal"><span class="pre">wrap.py</span></tt> to <tt class="docutils literal"><span class="pre">PyWrap.py</span></tt></li>
 645 </ul>
 646 <p>Removed disabling of autocomplete for lists of 2000 items or more.
 647 The current implementation of wxSTC can now handle lists this big.</p>
 648 <p>Improved handling of <tt class="docutils literal"><span class="pre">sys.path</span></tt> to mimic the standard Python shell.</p>
 649 </div>
 650 <div class="section">
 651 <h2><a class="toc-backref" href="#id23" id="to-3-20-2003" name="to-3-20-2003">0.9 (2/27/2003 to 3/20/2003)</a></h2>
 652 <p>Added fontIncrease, fontDecrease, fontDefault signals, receivers and
 653 keybindings:</p>
 654 <pre class="literal-block">
 655 Ctrl+]            Increase font size.
 656 Ctrl+[            Decrease font size.
 657 Ctrl+=            Default font size.
 658 </pre>
 659 <p>Continued enhancement of the decorator capability to provide better
 660 documentation and docstrings for wxPython classes and functions.</p>
 661 <p>Introduced new tabbed interface:</p>
 662 <ul class="simple">
 663 <li>Namespace</li>
 664 <li>Calltip</li>
 665 <li>Session</li>
 666 <li>Dispatcher</li>
 667 <li>wxPython Docs</li>
 668 <li>wxSTC Docs</li>
 669 </ul>
 670 <p><tt class="docutils literal"><span class="pre">Filling.tree</span></tt> now expands tuples as well as lists.  (It should have
 671 done this all along, I just never noticed this omission before.)</p>
 672 <p>Added this True/False test to all modules:</p>
 673 <pre class="literal-block">
 674 try:
 675     True
 676 except NameError:
 677     True = 1==1
 678     False = 1==0
 679 </pre>
 680 <p>Added <tt class="docutils literal"><span class="pre">wxd</span></tt> directory with decoration classes.</p>
 681 </div>
 682 <div class="section">
 683 <h2><a class="toc-backref" href="#id24" id="to-2-26-2003" name="to-2-26-2003">0.8.2 (1/5/2003 to 2/26/2003)</a></h2>
 684 <p>Wrapped <tt class="docutils literal"><span class="pre">sys.ps1</span></tt>, <tt class="docutils literal"><span class="pre">sys.ps2</span></tt>, and <tt class="docutils literal"><span class="pre">sys.ps3</span></tt> in <tt class="docutils literal"><span class="pre">str()</span></tt>.
 685 (Thanks, Kieran Holland.)</p>
 686 <p>Fixed minor things found by PyChecker.</p>
 687 <p>Changed locals to use <tt class="docutils literal"><span class="pre">__main__.__dict__</span></tt> and added code to clean up
 688 the namespace, making it as close to the regular Python environment as
 689 possible.  This solves the problem of pickling and unpickling
 690 instances of classes defined in the shell.</p>
 691 <p>Made <tt class="docutils literal"><span class="pre">shell.PasteAndRun()</span></tt> a little more forgiving when it finds a
 692 ps2 prompt line with no trailing space, such when you copy code from a
 693 web page.</p>
 694 <p>Improved autocomplete behavior by adding these to shell:</p>
 695 <pre class="literal-block">
 696 self.AutoCompSetAutoHide(False)
 697 self.AutoCompStops(' .,;:([)]}\'&quot;\\&lt;&gt;%^&amp;+-=*/|`')
 698 </pre>
 699 <p>Added <tt class="docutils literal"><span class="pre">decor</span></tt> directory, <tt class="docutils literal"><span class="pre">decorator.py</span></tt>, <tt class="docutils literal"><span class="pre">stcDecor.py</span></tt>, and
 700 <tt class="docutils literal"><span class="pre">stcConstants.py</span></tt>.  These all serve the purpose of adding docstrings
 701 to existing wxPython classes, in particular the <tt class="docutils literal"><span class="pre">wxStyledTextCtrl</span></tt>.</p>
 702 <p>Added <tt class="docutils literal"><span class="pre">wrap.py</span></tt>, a command line utility for running a wxPython app
 703 with additional runtime-tools loaded, such as PyCrust (the only tool
 704 at this point).</p>
 705 <p>Flushed the clipboard Cut/Copy operations so that selections will
 706 exist in the clipboard even after PyCrust has been closed.</p>
 707 <p>Improved the suppression of docstrings for simple data types appearing
 708 in the namespace viewer.</p>
 709 <p>Better handling of autocompletion with numeric types; no
 710 autocompletion when typing a dot after an integer.  If the
 711 autocompletion is desired, type a space before the dot:</p>
 712 <pre class="literal-block">
 713 func = 3 .
 714 </pre>
 715 <p>More Filling!!! The namespace tree is now dynamically updated.</p>
 716 </div>
 717 <div class="section">
 718 <h2><a class="toc-backref" href="#id25" id="to-12-25-2002" name="to-12-25-2002">0.8.1 (12/20/2002 to 12/25/2002)</a></h2>
 719 <p>Improved keyboard handling with Autocomplete active.  You can now use
 720 Enter as well as Tab to select an item from the list.</p>
 721 <p>Disabled autocomplete for lists of 2000 items or more.  The current
 722 implementation of wxSTC can't handle lists this big.</p>
 723 <p>Changed <tt class="docutils literal"><span class="pre">filling</span></tt> to always display docstrings for objects.  This is
 724 useful for objects whose docstrings have been decorated, rather than
 725 coming directly from the source code.  (Hmmm.  Sounds like someone is
 726 doing some decorating.  I wonder where that would be helpful? &lt;wink&gt;)</p>
 727 <p>Fixed handling of icon.  Added <tt class="docutils literal"><span class="pre">images.py</span></tt> file.</p>
 728 </div>
 729 <div class="section">
 730 <h2><a class="toc-backref" href="#id26" id="to-12-16-2002" name="to-12-16-2002">0.8 (10/29/2002 to 12/16/2002)</a></h2>
 731 <p>Added &quot;help&quot; to startup banner info.</p>
 732 <p>Made all <tt class="docutils literal"><span class="pre">wx</span></tt> and <tt class="docutils literal"><span class="pre">stc</span></tt> imports explicit.  No more <tt class="docutils literal"><span class="pre">import</span> <span class="pre">*</span></tt>.</p>
 733 <p>Replaced use of the <tt class="docutils literal"><span class="pre">wx</span></tt> module's <tt class="docutils literal"><span class="pre">true</span></tt> and <tt class="docutils literal"><span class="pre">false</span></tt> with
 734 Python's <tt class="docutils literal"><span class="pre">True</span></tt> and <tt class="docutils literal"><span class="pre">False</span></tt>.</p>
 735 <p>Changed <tt class="docutils literal"><span class="pre">introspect.getRoot()</span></tt> to use <tt class="docutils literal"><span class="pre">tokenize</span></tt> module.  This
 736 does a slightly better job than the previous parsing routine and the
 737 code is clearer.</p>
 738 <p>Improved handling of whitespace and empty types during introspection.</p>
 739 <p>Fixed cut/copy clipboard problem under Linux.  (Robin Dunn rocks!!!)</p>
 740 <p>Added shell.about() which works like this:</p>
 741 <pre class="literal-block">
 742 &gt;&gt;&gt; shell.about()
 743 PyCrust Version: 0.8
 744 Shell Revision: 1.80
 745 Interpreter Revision: 1.15
 746 Python Version: 2.2.2
 747 wxPython Version: 2.3.3.1
 748 Platform: linux2
 749 </pre>
 750 <p>Added copy plus and paste plus to shell menu.</p>
 751 <p>Moved shell menu from <tt class="docutils literal"><span class="pre">shell.py</span></tt> to <tt class="docutils literal"><span class="pre">shellmenu.py</span></tt>.</p>
 752 <p>Added <tt class="docutils literal"><span class="pre">sys.stdin.readlines()</span></tt> support.</p>
 753 <p>Added <tt class="docutils literal"><span class="pre">time.sleep()</span></tt> in <tt class="docutils literal"><span class="pre">readline()</span></tt> and <tt class="docutils literal"><span class="pre">OnIdle()</span></tt> event
 754 handler to free up the CPU.</p>
 755 </div>
 756 <div class="section">
 757 <h2><a class="toc-backref" href="#id27" id="to-8-27-2002" name="to-8-27-2002">0.7.2 (2/22/2002 to 8/27/2002)</a></h2>
 758 <p>Tweaked <tt class="docutils literal"><span class="pre">getAttributeNames()</span></tt> to pick up a few more attributes:</p>
 759 <pre class="literal-block">
 760 '__bases__', '__class__', '__dict__', '__name__', 'func_closure',
 761 'func_code', 'func_defaults', 'func_dict', 'func_doc',
 762 'func_globals', 'func_name'
 763 </pre>
 764 <p>Added a tests directory and unit tests.</p>
 765 <p>Improved support for empty types in the shell: <tt class="docutils literal"><span class="pre">[]</span></tt>, <tt class="docutils literal"><span class="pre">()</span></tt> and
 766 <tt class="docutils literal"><span class="pre">{}</span></tt> as far as when call tips and autocompletion are available.</p>
 767 <p>Added support for the other triple string - <tt class="docutils literal"><span class="pre">''''''</span></tt>.</p>
 768 <p>Refactored <tt class="docutils literal"><span class="pre">introspect.py</span></tt> to improve testability.</p>
 769 <p>Improved call tips for unbound methods by leaving the &quot;self&quot;
 770 parameter, since unbound methods require an instance be passed.</p>
 771 <p>Fixed call tip bug where a tip was displayed when a &quot;(&quot; was typed
 772 after an object that wasn't callable.</p>
 773 <p>Fixed <tt class="docutils literal"><span class="pre">getAllAttributeNames</span></tt> when <tt class="docutils literal"><span class="pre">str(object)</span></tt> fails.</p>
 774 <p>Added brace highlighting.  (Thank you, Kevin Altis.)</p>
 775 <p>Fixed problem displaying unicode objects in <tt class="docutils literal"><span class="pre">PyFilling</span></tt>.</p>
 776 <p>Changed how <tt class="docutils literal"><span class="pre">filling.py</span></tt> checks for expandable objects.  Lists are
 777 now expandable objects.</p>
 778 <p>Made the key handling more robust when there is an active text
 779 selection that includes text prior to the last primary prompt.  Thanks
 780 to Raul Cota for pointing this out.</p>
 781 <p>Fixed wxSTC problem with brace highlighting and non-us keyboards.
 782 (Thank you for the patch, Jean-Michel Fauth.)</p>
 783 <p>Added <tt class="docutils literal"><span class="pre">busy</span> <span class="pre">=</span> <span class="pre">wxBusyCursor()</span></tt> to key points in <tt class="docutils literal"><span class="pre">shell</span></tt> and
 784 <tt class="docutils literal"><span class="pre">filling</span></tt>.</p>
 785 <p>Added <tt class="docutils literal"><span class="pre">OnCloseWindow</span></tt> handler to <tt class="docutils literal"><span class="pre">ShellFrame</span></tt> and <tt class="docutils literal"><span class="pre">CrustFrame</span></tt>.</p>
 786 <p>Default to <tt class="docutils literal"><span class="pre">SetWrapMode(1)</span></tt> for shell and namespace viewer.</p>
 787 <p>Added <tt class="docutils literal"><span class="pre">shell.wrap()</span></tt> and <tt class="docutils literal"><span class="pre">shell.zoom()</span></tt>.</p>
 788 <p>Added autoCompleteKeys hooks for Raul Cota.</p>
 789 <p>Cleaned up various little key handling bugs.</p>
 790 <p>Changed input methods to get values from shell, rather than dialog
 791 boxes.  Renamed <tt class="docutils literal"><span class="pre">readIn</span></tt> to <tt class="docutils literal"><span class="pre">readline</span></tt> and <tt class="docutils literal"><span class="pre">readRaw</span></tt> to
 792 <tt class="docutils literal"><span class="pre">raw_input</span></tt>.</p>
 793 </div>
 794 <div class="section">
 795 <h2><a class="toc-backref" href="#id28" id="to-2-21-2002" name="to-2-21-2002">0.7.1 (12/12/2001 to 2/21/2002)</a></h2>
 796 <p>Fixed <tt class="docutils literal"><span class="pre">OnChar()</span></tt> issues effecting European keyboards, as reported by
 797 Jean-Michel Fauth.</p>
 798 <p>Fixed <tt class="docutils literal"><span class="pre">introspect.py</span></tt> issue with xmlrpc objects reported by Kevin
 799 Altis.</p>
 800 <p>Fixed some introspect/PyFilling issues with regard to Python 2.2.</p>
 801 <p>Fixed font background color as reported by Keith J. Farmer.  (Thanks)</p>
 802 <p>Fixed problem with call tips and autocompletion inside multiline
 803 commands as report by Kevin Altis.</p>
 804 <p>Improved <tt class="docutils literal"><span class="pre">OnKeyDown</span></tt> handling of cut/copy/paste operations based on
 805 feedback from Syver Enstad.  (Thanks)</p>
 806 <p>Added a <tt class="docutils literal"><span class="pre">shell.help()</span></tt> method to display some help info.</p>
 807 <p>Changed sort of items in the namespace viewer to case insensitive.</p>
 808 <p>Changed <tt class="docutils literal"><span class="pre">attributes.sort(lambda</span> <span class="pre">x,</span> <span class="pre">y:</span> <span class="pre">cmp(x.upper(),</span> <span class="pre">y.upper()))</span></tt> in
 809 advance of an upcoming fix to an autocompletion matching bug in wxSTC.</p>
 810 <p>Improved support for ZODB by allowing namespace drilldown into BTrees.</p>
 811 <p>Added <tt class="docutils literal"><span class="pre">shell.PasteAndRun()</span></tt> to support pasting multiple commands into
 812 the shell from the clipboard.  Ctrl+Shift+V or v.</p>
 813 <p>Enter now always processes a command (or copies down a previous one.)
 814 To insert a line break, press Ctrl+Enter.</p>
 815 <p>Escape key clears the current, unexecuted command.</p>
 816 <p>History retrieval changed to replace current command.  Added new keys
 817 to insert from history - Shift+Up and Shift+Down.</p>
 818 <p>Better call tips on objects with <tt class="docutils literal"><span class="pre">__call__</span></tt> methods.</p>
 819 <p>Improved call tip positioning calculation.</p>
 820 </div>
 821 <div class="section">
 822 <h2><a class="toc-backref" href="#id29" id="to-12-11-2001" name="to-12-11-2001">0.7 (10/15/2001 to 12/11/2001)</a></h2>
 823 <p>Changed how command history retrieval functions work.  Added Alt-P,
 824 Alt-N as keybindings for Retrieve-Previous, Retrieve-Next.</p>
 825 <p>Added full support for multi-line commands, similar to IDLE.</p>
 826 <p>Changed <tt class="docutils literal"><span class="pre">introspect.getAttributeNames()</span></tt> to do a case insensitive
 827 sort.</p>
 828 <p>Changed Cut/Copy/Paste to deal with prompts intelligently.  Cut and
 829 Copy remove all prompts.  Paste can handle prompted or not-prompted
 830 text.</p>
 831 <p>Added <tt class="docutils literal"><span class="pre">CopyWithPrompts()</span></tt> method attached to Ctrl-Shift-C for those
 832 times when you really do want all the prompts left intact.</p>
 833 <p>Improved handling of the shell's read-only zone.</p>
 834 <p>Changed <tt class="docutils literal"><span class="pre">CrustFrame.__init__</span></tt> parameter spec to include all
 835 parameters allowed by a <tt class="docutils literal"><span class="pre">wxFrame</span></tt>.</p>
 836 <p>Changed <tt class="docutils literal"><span class="pre">FillingText</span></tt> to be read-only.</p>
 837 <p>Renamed <tt class="docutils literal"><span class="pre">PyCrust.py</span></tt> to <tt class="docutils literal"><span class="pre">PyCrustApp.py</span></tt> to eliminate
 838 package/module name conflicts that kept you from doing <tt class="docutils literal"><span class="pre">from</span> <span class="pre">PyCrust</span>
 839 <span class="pre">import</span> <span class="pre">shell</span></tt> inside files located in the <tt class="docutils literal"><span class="pre">PyCrust</span></tt> directory.</p>
 840 <p>Renamed <tt class="docutils literal"><span class="pre">PyFilling.py</span></tt> to <tt class="docutils literal"><span class="pre">PyFillingApp.py</span></tt> and <tt class="docutils literal"><span class="pre">PyShell.py</span></tt> to
 841 <tt class="docutils literal"><span class="pre">PyShellApp.py</span></tt> to maintain consistency.</p>
 842 <p>Removed the <tt class="docutils literal"><span class="pre">__date__</span></tt> property from all modules.</p>
 843 <p>Fixed bug in <tt class="docutils literal"><span class="pre">introspect.getCallTip()</span></tt>, reported by Kevin Altis.</p>
 844 </div>
 845 <div class="section">
 846 <h2><a class="toc-backref" href="#id30" id="to-10-12-2001" name="to-10-12-2001">0.6.1 (9/19/2001 to 10/12/2001)</a></h2>
 847 <p>Changed <tt class="docutils literal"><span class="pre">Shell.run()</span></tt> to always position to the end of existing
 848 text, as suggested by Raul Cota.</p>
 849 <p>Changed <tt class="docutils literal"><span class="pre">introspect.getAllAttributeNames()</span></tt> to break circular
 850 references in <tt class="docutils literal"><span class="pre">object.__class__</span></tt>, which occurs in Zope/ZODB
 851 extension classes.</p>
 852 <p>Changed <tt class="docutils literal"><span class="pre">filling.FillingTree.getChildren()</span></tt> to introspect extension
 853 classes.</p>
 854 <p>Fixed minor bugs in <tt class="docutils literal"><span class="pre">introspect.getCallTip()</span></tt> that were interfering
 855 with call tips for Zope/ZODB extension class methods.</p>
 856 <p>In preparation for wxPython 2.3.2, added code to fix a font sizing
 857 problem.  Versions of wxPython prior to 2.3.2 had a sizing bug on Win
 858 platform where the font was 2 points larger than what was specified.</p>
 859 <p>Added a hack to <tt class="docutils literal"><span class="pre">introspect.getAllAttributeNames()</span></tt> to &quot;wake up&quot;
 860 ZODB objects that are asleep - in a &quot;ghost&quot; state.  Otherwise it
 861 returns incomplete info.</p>
 862 </div>
 863 <div class="section">
 864 <h2><a class="toc-backref" href="#id31" id="to-9-12-2001" name="to-9-12-2001">0.6 (8/21/2001 to 9/12/2001)</a></h2>
 865 <p>Added <tt class="docutils literal"><span class="pre">PyFilling.py</span></tt> and <tt class="docutils literal"><span class="pre">filling.py</span></tt>.</p>
 866 <p><tt class="docutils literal"><span class="pre">PyShell.py</span></tt> and <tt class="docutils literal"><span class="pre">PyFilling.py</span></tt> can now be run standalone, as well
 867 as <tt class="docutils literal"><span class="pre">PyCrust.py</span></tt>.</p>
 868 <p>Added <tt class="docutils literal"><span class="pre">crust.py</span></tt> and moved some code from <tt class="docutils literal"><span class="pre">PyCrust.py</span></tt> to it.</p>
 869 <p>Added command history retrieval features submitted by Richie Hindle.</p>
 870 <p>Changed <tt class="docutils literal"><span class="pre">shell.write()</span></tt> to replace line endings with OS-specific
 871 endings.  Changed <tt class="docutils literal"><span class="pre">shell.py</span></tt> and <tt class="docutils literal"><span class="pre">interpreter.py</span></tt> to use
 872 <tt class="docutils literal"><span class="pre">os.linesep</span></tt> in strings having hardcoded line endings.</p>
 873 <p>Added <tt class="docutils literal"><span class="pre">shell.redirectStdin()</span></tt>, <tt class="docutils literal"><span class="pre">shell.redirectStdout()</span></tt> and
 874 <tt class="docutils literal"><span class="pre">shell.redirectStderr()</span></tt> to allow the surrounding app to toggle
 875 requests that the specified <tt class="docutils literal"><span class="pre">sys.std*</span></tt> be redirected to the shell.
 876 These can also be run from within the shell itself, of course.</p>
 877 <p>The shell now adds the current working directory &quot;.&quot; to the search
 878 path:</p>
 879 <pre class="literal-block">
 880 sys.path.insert(0, os.curdir)
 881 </pre>
 882 <p>Added support for distutils installations.</p>
 883 </div>
 884 <div class="section">
 885 <h2><a class="toc-backref" href="#id32" id="to-8-20-2001" name="to-8-20-2001">0.5.4 (8/17/2001 to 8/20/2001)</a></h2>
 886 <p>Changed default font size under Linux to:</p>
 887 <pre class="literal-block">
 888 'size'   : 12,
 889 'lnsize' : 10,
 890 </pre>
 891 <p>Changed <tt class="docutils literal"><span class="pre">Shell</span></tt> to expect a parameter referencing an Interpreter
 892 class, rather than an intepreter instance, to facilitate subclassing
 893 of Interpreter, which effectively broke when the Editor class was
 894 eliminated.</p>
 895 <p>Fixed <tt class="docutils literal"><span class="pre">PyCrustAlaCarte.py</span></tt>, which had been broken by previous
 896 changes.</p>
 897 <p>Created <tt class="docutils literal"><span class="pre">InterpreterAlaCarte</span></tt> class as an example for use in the
 898 demo.</p>
 899 <p>Split <tt class="docutils literal"><span class="pre">PyCrust.py</span></tt> into <tt class="docutils literal"><span class="pre">PyCrust.py</span></tt> and <tt class="docutils literal"><span class="pre">PyShell.py</span></tt> in
 900 anticipation of <tt class="docutils literal"><span class="pre">PyFilling.py</span></tt>.</p>
 901 </div>
 902 <div class="section">
 903 <h2><a class="toc-backref" href="#id33" id="id2" name="id2">0.5.3 (8/16/2001)</a></h2>
 904 <p>Added patch to <tt class="docutils literal"><span class="pre">PyCrust.py</span></tt> to fix wxPython bug:</p>
 905 <pre class="literal-block">
 906 wxID_SELECTALL = NewId() # This *should* be defined by wxPython.
 907 </pre>
 908 </div>
 909 <div class="section">
 910 <h2><a class="toc-backref" href="#id34" id="to-8-15-2001" name="to-8-15-2001">0.5.2 (8/14/2001 to 8/15/2001)</a></h2>
 911 <p>Shortened module names by dropping &quot;PyCrust&quot; as a prefix.</p>
 912 <p>Changed <tt class="docutils literal"><span class="pre">version</span></tt> to <tt class="docutils literal"><span class="pre">VERSION</span></tt> in <tt class="docutils literal"><span class="pre">version</span></tt> module.</p>
 913 <p>Added Options menu to PyCrust application.</p>
 914 <p>Eliminated the Editor class (and editor module) by merging with Shell.
 915 This means that Shell &quot;is a&quot; wxStyledTextCtrl rather than &quot;has a&quot;.
 916 There just wasn't enough non-gui code to justify the separation.
 917 Plus, Shell will be much easier for gui toolkits/designers to deal
 918 with now.</p>
 919 </div>
 920 <div class="section">
 921 <h2><a class="toc-backref" href="#id35" id="to-8-14-2001" name="to-8-14-2001">0.5.1 (8/10/2001 to 8/14/2001)</a></h2>
 922 <p>Added <tt class="docutils literal"><span class="pre">introspect</span></tt> module.</p>
 923 <p>Moved some functionality from <tt class="docutils literal"><span class="pre">PyCrustInterp</span></tt> to <tt class="docutils literal"><span class="pre">introspect</span></tt>.</p>
 924 <p>Changed <tt class="docutils literal"><span class="pre">introspect.getRoot()</span></tt> to no longer remove whitespace from
 925 the command.  This was a remnant of a previous approach that, when
 926 left as part of the current approach, turned out to be a really bad
 927 thing.</p>
 928 <p>Changed <tt class="docutils literal"><span class="pre">introspect.getRoot()</span></tt> to allow commands of <tt class="docutils literal"><span class="pre">''</span></tt>, <tt class="docutils literal"><span class="pre">&quot;&quot;</span></tt>,
 929 <tt class="docutils literal"><span class="pre">&quot;&quot;&quot;&quot;&quot;&quot;</span></tt>, <tt class="docutils literal"><span class="pre">[]</span></tt>, <tt class="docutils literal"><span class="pre">()</span></tt>, and <tt class="docutils literal"><span class="pre">{}</span></tt> to pass through.  This allows
 930 you to type them, followed by a dot, and get autocomplete options on
 931 them.</p>
 932 <p>Changed <tt class="docutils literal"><span class="pre">introspect.getRoot()</span></tt> to identify some situations where
 933 strings shouldn't be considered roots.  For example:</p>
 934 <pre class="literal-block">
 935 &gt;&gt;&gt; import PyCrust  # To illustrate the potential problem.
 936 &gt;&gt;&gt; len('PyCrust.py')
 937 </pre>
 938 <p>Typing the dot at the end of &quot;PyCrust&quot; in the second line above should
 939 NOT result in an autocompletion list because &quot;PyCrust&quot; is part of a
 940 string in this context, not a reference to the PyCrust module object.
 941 Similar reasoning applies to call tips.  For example:</p>
 942 <pre class="literal-block">
 943 &gt;&gt;&gt; len('dir(')
 944 </pre>
 945 <p>Typing the left paren at the end of &quot;dir&quot; should NOT result in a call
 946 tip.</p>
 947 <p>Both features now behave properly in the examples given.  However,
 948 there is still the case where whitespace precedes the potential root
 949 and that is NOT handled properly.  For example:</p>
 950 <pre class="literal-block">
 951 &gt;&gt;&gt; len('this is a dir(')
 952 </pre>
 953 <p>and:</p>
 954 <pre class="literal-block">
 955 &gt;&gt;&gt; len('This is PyCrust.py')
 956 </pre>
 957 <p>More code needs to be written to handle more complex situations.</p>
 958 <p>Added <tt class="docutils literal"><span class="pre">locals=None</span></tt> parameter to <tt class="docutils literal"><span class="pre">Shell.__init__()</span></tt>.</p>
 959 <p>Added support for magic attribute retrieval.  Users can change this
 960 with:</p>
 961 <pre class="literal-block">
 962 &gt;&gt;&gt; shell.editor.autoCompleteIncludeMagic = 0
 963 </pre>
 964 <p>Added the ability to set filters on auto completion to exclude
 965 attributes prefixed with a single or double underscore.  Users can
 966 exclude one or the other or both with:</p>
 967 <pre class="literal-block">
 968 &gt;&gt;&gt; shell.editor.autoCompleteExcludeSingle = 1
 969 &gt;&gt;&gt; shell.editor.autoCompleteExcludeDouble = 1
 970 </pre>
 971 </div>
 972 <div class="section">
 973 <h2><a class="toc-backref" href="#id36" id="id3" name="id3">0.5 (8/8/2001)</a></h2>
 974 <p>Mostly just a final version change before creating a release.</p>
 975 </div>
 976 <div class="section">
 977 <h2><a class="toc-backref" href="#id37" id="to-8-7-2001" name="to-8-7-2001">0.4 (8/4/2001 to 8/7/2001)</a></h2>
 978 <p>Changed version/revision handling.</p>
 979 <p>Fixed bugs.</p>
 980 </div>
 981 <div class="section">
 982 <h2><a class="toc-backref" href="#id38" id="to-8-3-2001" name="to-8-3-2001">0.3 (8/2/2001 to 8/3/2001)</a></h2>
 983 <p>Removed lots of cruft.</p>
 984 <p>Added lots of docstrings.</p>
 985 <p>Imported to CVS repository at SourceForge.</p>
 986 <p>Added call tips.</p>
 987 </div>
 988 <div class="section">
 989 <h2><a class="toc-backref" href="#id39" id="to-8-2-2001" name="to-8-2-2001">0.2 (7/30/2001 to 8/2/2001)</a></h2>
 990 <p>Renamed several files.</p>
 991 <p>Added command autocompletion.</p>
 992 <p>Added menus to PyCrust.py: File, Edit and Help.</p>
 993 <p>Added sample applications: <tt class="docutils literal"><span class="pre">PyCrustAlaCarte.py</span></tt>,
 994 <tt class="docutils literal"><span class="pre">PyCrustAlaMode.py</span></tt>, and <tt class="docutils literal"><span class="pre">PyCrustMinimus.py</span></tt>.</p>
 995 </div>
 996 <div class="section">
 997 <h2><a class="toc-backref" href="#id40" id="to-7-19-2001" name="to-7-19-2001">0.1 (7/1/2001 to 7/19/2001)</a></h2>
 998 <p>Added basic syntax coloring much like Boa.</p>
 999 <p>Added read-only logging much like IDLE.</p>
1000 <p>Can retrieve a previous command by putting the cursor back on that
1001 line and hitting enter.</p>
1002 <p>Stdin and raw_input operate properly so you can now do <tt class="docutils literal"><span class="pre">help()</span></tt> and
1003 <tt class="docutils literal"><span class="pre">license()</span></tt> without hanging.</p>
1004 <p>Redefined &quot;quit&quot;, &quot;exit&quot;, and &quot;close&quot; to display a better-than-nothing
1005 response.</p>
1006 <p>Home key honors the prompt.</p>
1007 <p>Created SourceForge account, but nothing was posted.</p>
1008 </div>
1009 <div class="section">
1010 <h2><a class="toc-backref" href="#id41" id="in-the-beginning-there-was-pie-7-1-2001" name="in-the-beginning-there-was-pie-7-1-2001">In the beginning, there was pie... (7/1/2001)</a></h2>
1011 <p>Blame it all on IDLE, Boa and PythonWin.  I was using all three, got
1012 frustrated with their dissimilarities, and began to let everyone know
1013 how I felt.  At the same time, Scintilla looked like an interesting
1014 tool to build a shell around.  And while I didn't receive much in the
1015 way of positive feedback, let alone encouragement, I just couldn't let
1016 go of the idea of a Scintilla-based Python shell.  Then the PythonCard
1017 project got to the point where they were talking about including a
1018 shell in their development environment.  That was all the incentive I
1019 needed.  PyCrust had to happen...</p>
1020 </div>
1021 </div>
1022 </div>
1023 </body>
1024 </html>