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"> 
   5 <meta http-equiv=
"Content-Type" content=
"text/html; charset=iso-8859-1" /> 
   6 <meta name=
"generator" content=
"Docutils 0.3.1: 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-02-04" /> 
  11 <link rel=
"stylesheet" href=
"default.css" type=
"text/css" /> 
  14 <div class=
"document" id=
"the-py-manual"> 
  15 <h1 class=
"title">The Py Manual
</h1> 
  16 <h2 class=
"subtitle" id=
"py-served-fresh-daily">Py - Served Fresh Daily
</h2> 
  17 <table class=
"docinfo" frame=
"void" rules=
"none"> 
  18 <col class=
"docinfo-name" /> 
  19 <col class=
"docinfo-content" /> 
  21 <tr><th class=
"docinfo-name">Author:
</th> 
  22 <td>Patrick K. O'Brien
</td></tr> 
  23 <tr><th class=
"docinfo-name">Contact:
</th> 
  24 <td><a class=
"first last reference" href=
"mailto:pobrien@orbtech.com">pobrien
@orbtech.com
</a></td></tr> 
  25 <tr><th class=
"docinfo-name">Organization:
</th> 
  26 <td><a class=
"first last reference" href=
"http://www.orbtech.com/">Orbtech
</a></td></tr> 
  27 <tr><th class=
"docinfo-name">Date:
</th> 
  28 <td>2004-
02-
04</td></tr> 
  29 <tr><th class=
"docinfo-name">Revision:
</th> 
  33 <div class=
"contents topic" id=
"contents"> 
  34 <p class=
"topic-title"><a name=
"contents">Contents
</a></p> 
  36 <li><a class=
"reference" href=
"#introduction" id=
"id3" name=
"id3">Introduction
</a></li> 
  37 <li><a class=
"reference" href=
"#developer-reference" id=
"id4" name=
"id4">Developer Reference
</a></li> 
  38 <li><a class=
"reference" href=
"#what-is-py" id=
"id5" name=
"id5">What is Py?
</a></li> 
  39 <li><a class=
"reference" href=
"#pycrust-is-dead-long-live-py" id=
"id6" name=
"id6">PyCrust is dead! Long live Py!
</a></li> 
  40 <li><a class=
"reference" href=
"#py-standalone-programs" id=
"id7" name=
"id7">Py standalone programs
</a></li> 
  41 <li><a class=
"reference" href=
"#pyalacarte" id=
"id8" name=
"id8">PyAlaCarte
</a></li> 
  42 <li><a class=
"reference" href=
"#pyalamode" id=
"id9" name=
"id9">PyAlaMode
</a></li> 
  43 <li><a class=
"reference" href=
"#pycrust" id=
"id10" name=
"id10">PyCrust
</a></li> 
  44 <li><a class=
"reference" href=
"#pyfilling" id=
"id11" name=
"id11">PyFilling
</a></li> 
  45 <li><a class=
"reference" href=
"#pyshell" id=
"id12" name=
"id12">PyShell
</a></li> 
  46 <li><a class=
"reference" href=
"#pywrap" id=
"id13" name=
"id13">PyWrap
</a></li> 
  47 <li><a class=
"reference" href=
"#py-modules" id=
"id14" name=
"id14">Py modules
</a></li> 
  48 <li><a class=
"reference" href=
"#decorator-classes" id=
"id15" name=
"id15">Decorator classes
</a></li> 
  49 <li><a class=
"reference" href=
"#projects-using-py" id=
"id16" name=
"id16">Projects using Py
</a></li> 
  50 <li><a class=
"reference" href=
"#history-of-changes" id=
"id17" name=
"id17">History of changes
</a><ul> 
  51 <li><a class=
"reference" href=
"#to-2004" id=
"id18" name=
"id18">0.9.4 (
1/
25/
2004 to //
2004)
</a></li> 
  52 <li><a class=
"reference" href=
"#to-1-24-2004" id=
"id19" name=
"id19">0.9.3 (
9/
25/
2003 to 
1/
24/
2004)
</a></li> 
  53 <li><a class=
"reference" href=
"#to-9-25-2003" id=
"id20" name=
"id20">0.9.2 (
5/
3/
2003 to 
9/
25/
2003)
</a></li> 
  54 <li><a class=
"reference" href=
"#to-5-2-2003" id=
"id21" name=
"id21">0.9.1 (
3/
21/
2003 to 
5/
2/
2003)
</a></li> 
  55 <li><a class=
"reference" href=
"#to-3-20-2003" id=
"id22" name=
"id22">0.9 (
2/
27/
2003 to 
3/
20/
2003)
</a></li> 
  56 <li><a class=
"reference" href=
"#to-2-26-2003" id=
"id23" name=
"id23">0.8.2 (
1/
5/
2003 to 
2/
26/
2003)
</a></li> 
  57 <li><a class=
"reference" href=
"#to-12-25-2002" id=
"id24" name=
"id24">0.8.1 (
12/
20/
2002 to 
12/
25/
2002)
</a></li> 
  58 <li><a class=
"reference" href=
"#to-12-16-2002" id=
"id25" name=
"id25">0.8 (
10/
29/
2002 to 
12/
16/
2002)
</a></li> 
  59 <li><a class=
"reference" href=
"#to-8-27-2002" id=
"id26" name=
"id26">0.7.2 (
2/
22/
2002 to 
8/
27/
2002)
</a></li> 
  60 <li><a class=
"reference" href=
"#to-2-21-2002" id=
"id27" name=
"id27">0.7.1 (
12/
12/
2001 to 
2/
21/
2002)
</a></li> 
  61 <li><a class=
"reference" href=
"#to-12-11-2001" id=
"id28" name=
"id28">0.7 (
10/
15/
2001 to 
12/
11/
2001)
</a></li> 
  62 <li><a class=
"reference" href=
"#to-10-12-2001" id=
"id29" name=
"id29">0.6.1 (
9/
19/
2001 to 
10/
12/
2001)
</a></li> 
  63 <li><a class=
"reference" href=
"#to-9-12-2001" id=
"id30" name=
"id30">0.6 (
8/
21/
2001 to 
9/
12/
2001)
</a></li> 
  64 <li><a class=
"reference" href=
"#to-8-20-2001" id=
"id31" name=
"id31">0.5.4 (
8/
17/
2001 to 
8/
20/
2001)
</a></li> 
  65 <li><a class=
"reference" href=
"#id1" id=
"id32" name=
"id32">0.5.3 (
8/
16/
2001)
</a></li> 
  66 <li><a class=
"reference" href=
"#to-8-15-2001" id=
"id33" name=
"id33">0.5.2 (
8/
14/
2001 to 
8/
15/
2001)
</a></li> 
  67 <li><a class=
"reference" href=
"#to-8-14-2001" id=
"id34" name=
"id34">0.5.1 (
8/
10/
2001 to 
8/
14/
2001)
</a></li> 
  68 <li><a class=
"reference" href=
"#id2" id=
"id35" name=
"id35">0.5 (
8/
8/
2001)
</a></li> 
  69 <li><a class=
"reference" href=
"#to-8-7-2001" id=
"id36" name=
"id36">0.4 (
8/
4/
2001 to 
8/
7/
2001)
</a></li> 
  70 <li><a class=
"reference" href=
"#to-8-3-2001" id=
"id37" name=
"id37">0.3 (
8/
2/
2001 to 
8/
3/
2001)
</a></li> 
  71 <li><a class=
"reference" href=
"#to-8-2-2001" id=
"id38" name=
"id38">0.2 (
7/
30/
2001 to 
8/
2/
2001)
</a></li> 
  72 <li><a class=
"reference" href=
"#to-7-19-2001" id=
"id39" name=
"id39">0.1 (
7/
1/
2001 to 
7/
19/
2001)
</a></li> 
  73 <li><a class=
"reference" href=
"#in-the-beginning-there-was-pie-7-1-2001" id=
"id40" name=
"id40">In the beginning, there was pie... (
7/
1/
2001)
</a></li> 
  78 <div class=
"section" id=
"introduction"> 
  79 <h1><a class=
"toc-backref" href=
"#id3" name=
"introduction">Introduction
</a></h1> 
  80 <p>This document will show you how to use the Py programs and the Py
 
  81 library of Python source code modules.  Py is the new name for the
 
  82 project that began as PyCrust.  Py is officially part of 
<a class=
"reference" href=
"http://www.wxpython.org/">wxPython
</a>,
 
  83 and includes PyCrust, so PyCrust is no longer distributed separately.
</p> 
  85 <div class=
"section" id=
"developer-reference"> 
  86 <h1><a class=
"toc-backref" href=
"#id4" name=
"developer-reference">Developer Reference
</a></h1> 
  87 <p>Source code documentation for developers is available at:
</p> 
  88 <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> 
  90 <div class=
"section" id=
"what-is-py"> 
  91 <h1><a class=
"toc-backref" href=
"#id5" name=
"what-is-py">What is Py?
</a></h1> 
  92 <p>Besides being 
<a class=
"reference" href=
"http://www.wikipedia.org/wiki/Pie">a delicious dessert
</a>, Py is the name for a collection
 
  93 of whimsically-named Python programs and modules that began as the
 
  94 PyCrust project.  So Py is really several things: a set of standalone
 
  95 programs, including the original PyCrust program, a library of Python
 
  96 source code modules that can be used in your own programs, a set of
 
  97 decorator classes that enhance the wxPython class library, and as many
 
  98 examples of bad 
"pie
" puns as I can come up with.  (If you're going to
 
  99 do something, you might as well do it all the way, right?)  Py uses
 
 100 Python and wxPython, so it works equally well on Windows, Linux and
 
 103 <div class=
"section" id=
"pycrust-is-dead-long-live-py"> 
 104 <h1><a class=
"toc-backref" href=
"#id6" name=
"pycrust-is-dead-long-live-py">PyCrust is dead! Long live Py!
</a></h1> 
 105 <p>This project began with a program I created called PyCrust - an
 
 106 interactive, graphical Python shell, developed using the wxPython GUI
 
 107 toolkit.  For about two years, PyCrust was hosted on 
<a class=
"reference" href=
"http://www.sf.net/projects/pycrust/">SourceForge
</a>.
 
 108 Shortly after I created PyCrust, the wxPython folks started including
 
 109 it in their distribution.  As the PyCrust project grew, it reached a
 
 110 point where I thought the original PyCrust name was too confining.  I
 
 111 was using the PyCrust code base to develop programs that weren't just
 
 112 Python shells any more.
</p> 
 113 <p>Around that same time, the wxPython folks asked me if I'd be willing
 
 114 to move all my wxPython-related projects into the 
<a class=
"reference" href=
"http://cvs.wxWidgets.org">wxPython CVS
 
 115 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.
 
 116 I decided the time was right to restructure the PyCrust project.
 
 117 During the move, the PyCrust package was renamed to 
"py
" (lowercase
 
 118 "p
") and the collection of programs and modules as a whole became
 
 119 known as 
"Py
" (with a capital 
"P
").
</p> 
 120 <p>The original goal of PyCrust was to be the best interactive, graphical
 
 121 Python shell (of course, I claimed it was the 
"flakiest
" Python
 
 122 shell).  And that was all I wanted it to be.  But little by little I
 
 123 found myself developing a wider variety of tools for wxPython
 
 124 applications.  Eventually I'll create a debugger (PySlice, perhaps)
 
 125 and whatever else is needed to one day become a complete wxPython
 
 126 application development environment (PyFactory?).  In the mean time,
 
 127 PyCrust is still the flakiest Python shell, and the other Py programs
 
 128 are equally tasty.
</p> 
 129 <p>At this point, Py has standalone programs that include Python code
 
 130 editors (PyAlaCarte and PyAlaMode), interactive Python shells (PyCrust
 
 131 and PyShell), and a runtime wrapper (PyWrap).  The runtime wrapper
 
 132 utility provides you with runtime introspection capabilities for your
 
 133 wxPython programs without having to include PyCrust or PyShell in your
 
 134 program, and without having to alter one line of your source code.
</p> 
 135 <p>Py also contains a collection of modules that you can use in your own
 
 136 wxPython applications to provide similar services, either for your own
 
 137 use during development, or as an interface for users of your programs.
 
 138 These modules are the same ones used by all the Py programs.  In
 
 139 addition, Py contains a set of decorator classes that enhance the
 
 140 wxPython class library, by dynamically attaching docstrings and call
 
 141 signatures at runtime.
</p> 
 143 <div class=
"section" id=
"py-standalone-programs"> 
 144 <h1><a class=
"toc-backref" href=
"#id7" name=
"py-standalone-programs">Py standalone programs
</a></h1> 
 145 <p>These are the standalone applications in the Py collection:
</p> 
 155 <div class=
"section" id=
"pyalacarte"> 
 156 <h1><a class=
"toc-backref" href=
"#id8" name=
"pyalacarte">PyAlaCarte
</a></h1> 
 157 <p>PyAlaCarte is a Python source code editor.  It is designed to have a
 
 158 simple, single-file interface.  As a standalone application, it is
 
 159 good for simple, short editing tasks.  But it is really meant to be
 
 160 more of an example of how to embed the Py editor into a wxPython
 
 163 <div class=
"section" id=
"pyalamode"> 
 164 <h1><a class=
"toc-backref" href=
"#id9" name=
"pyalamode">PyAlaMode
</a></h1> 
 165 <p>PyAlaMode is a Python source code editor.
</p> 
 167 <div class=
"section" id=
"pycrust"> 
 168 <h1><a class=
"toc-backref" href=
"#id10" name=
"pycrust">PyCrust
</a></h1> 
 169 <p>PyCrust is an interactive, Python shell.  But it's more than just a
 
 170 shell.  It includes a tabbed notebook containing a namespace tree
 
 171 (PyFilling), and several other things.
</p> 
 173 <div class=
"section" id=
"pyfilling"> 
 174 <h1><a class=
"toc-backref" href=
"#id11" name=
"pyfilling">PyFilling
</a></h1> 
 175 <p>PyFilling is a namespace viewer.  It isn't really useful as a
 
 176 standalone program, but it does illustrate how to make use of the
 
 177 underlying 
<tt class=
"literal"><span class=
"pre">filling
</span></tt> module.
</p> 
 179 <div class=
"section" id=
"pyshell"> 
 180 <h1><a class=
"toc-backref" href=
"#id12" name=
"pyshell">PyShell
</a></h1> 
 181 <p>PyShell is an interactive, Python shell.  It shares the same base code
 
 182 as PyCrust, but doesn't have any of the extra features that appear in
 
 183 the PyCrust notebook interface.
</p> 
 185 <p><img alt=
"screenshots/PyShell.png" src=
"screenshots/PyShell.png" /></p> 
 186 <p class=
"caption">PyShell running on Mandrake Linux.
</p> 
 189 <div class=
"section" id=
"pywrap"> 
 190 <h1><a class=
"toc-backref" href=
"#id13" name=
"pywrap">PyWrap
</a></h1> 
 191 <p>PyWrap is a runtime utility that lets you run an existing wxPython
 
 192 program with a PyCrust frame at the same time.  Inside the PyCrust
 
 193 shell namespace, the local variable 
<tt class=
"literal"><span class=
"pre">app
</span></tt> is assigned to your
 
 194 application instance.  In this way you can introspect your entire
 
 195 application within the PyCrust shell, as well as the PyFilling
 
 196 namespace viewer.  And through the use of the Py decorator classes,
 
 197 PyCrust can display wxPython function and method signatures as well as
 
 198 docstrings for the entire wxPython library.
</p> 
 200 <div class=
"section" id=
"py-modules"> 
 201 <h1><a class=
"toc-backref" href=
"#id14" name=
"py-modules">Py modules
</a></h1> 
 202 <p>Py was designed to be modular.  That means graphical code is kept
 
 203 separate from non-graphical code, and many of the Py modules can be
 
 204 used by other programs.  Likewise, other programs can supply some of
 
 205 the modules needed by Py.  For example, you could supply a customized
 
 206 interpreter module and plug it in to the PyCrust standalone
 
 207 application.  As long as it supports the minimum functionality
 
 208 required, PyCrust will work just as well with your interpreter as with
 
 209 its default interpreter.
</p> 
 211 <div class=
"section" id=
"decorator-classes"> 
 212 <h1><a class=
"toc-backref" href=
"#id15" name=
"decorator-classes">Decorator classes
</a></h1> 
 213 <p>Py contains a set of decorator classes that enhance the wxPython class
 
 214 library, by dynamically attaching docstrings and call signatures at
 
 217 <div class=
"section" id=
"projects-using-py"> 
 218 <h1><a class=
"toc-backref" href=
"#id16" name=
"projects-using-py">Projects using Py
</a></h1> 
 220 <li><a class=
"reference" href=
"http://conflictsolver.sourceforge.net/">Conflict Solver
</a></li> 
 221 <li><a class=
"reference" href=
"http://www.gnumed.org/">Gnumed
</a></li> 
 223 <li><a class=
"reference" href=
"http://www.pythoncard.org/">PythonCard
</a></li> 
 224 <li><a class=
"reference" href=
"http://rpy.sourceforge.net/">RPy
</a></li> 
 225 <li><a class=
"reference" href=
"http://www.scipy.org/">SciPy
</a></li> 
 226 <li><a class=
"reference" href=
"http://www.sim42.org/">Sim42
</a></li> 
 227 <li><a class=
"reference" href=
"http://linus.yorktown.arlington.k12.va.us/CS/APCSC/student_sites/David_Mayo/wxGasp">wxGasp
</a></li> 
 230 <div class=
"section" id=
"history-of-changes"> 
 231 <h1><a class=
"toc-backref" href=
"#id17" name=
"history-of-changes">History of changes
</a></h1> 
 232 <p>This section lists all the changes that have been made to the Py
 
 233 programs and modules, since the beginning.
</p> 
 234 <div class=
"section" id=
"to-2004"> 
 235 <h2><a class=
"toc-backref" href=
"#id18" name=
"to-2004">0.9.4 (
1/
25/
2004 to //
2004)
</a></h2> 
 236 <p>Removed wxd decorators in favor of new SWIG-generated docstrings.
</p> 
 237 <p>Removed docs tabs from crust interface:
 
 240 <p>Fixed Calltip tab refresh problem on Windows.
</p> 
 241 <p>shell.autoCompleteAutoHide added with default of False.
</p> 
 242 <p>Changed default namespace of Shell to __main__.__dict__, instead of an
 
 243 empty dictionary.
</p> 
 245 <div class=
"section" id=
"to-1-24-2004"> 
 246 <h2><a class=
"toc-backref" href=
"#id19" name=
"to-1-24-2004">0.9.3 (
9/
25/
2003 to 
1/
24/
2004)
</a></h2> 
 247 <p>Fun and games with dynamic renaming.  Details of any other changes
 
 248 were lost in the confusion.  I'll try to do better in the future.
</p> 
 250 <div class=
"section" id=
"to-9-25-2003"> 
 251 <h2><a class=
"toc-backref" href=
"#id20" name=
"to-9-25-2003">0.9.2 (
5/
3/
2003 to 
9/
25/
2003)
</a></h2> 
 252 <p>Changed to the new prefix-less 
"wx
" package:
</p> 
 253 <pre class=
"literal-block"> 
 257 <pre class=
"literal-block"> 
 258 from wxPython import wx
 
 260 <p>Fixed typo in 
<tt class=
"literal"><span class=
"pre">PyWrap.py
</span></tt>:
</p> 
 261 <pre class=
"literal-block"> 
 262 if __name__ == '__main__':
 
 265 <p>should have been:
</p> 
 266 <pre class=
"literal-block"> 
 267 if __name__ == '__main__':
 
 270 <p>Added pretty-print Display tab to Crust, based on suggestion from
 
 272 <p>Improved 
<tt class=
"literal"><span class=
"pre">Can*
</span></tt> checks in 
<tt class=
"literal"><span class=
"pre">EditWindow
</span></tt>, since STC is too lenient,
 
 273 particularly when it is set to read-only but returns True for
 
 274 CanPaste() (seems like an STC bug to me):
</p> 
 275 <pre class=
"literal-block"> 
 277     """Return True if text is selected and can be copied.
""" 
 278     return self.GetSelectionStart() != self.GetSelectionEnd()
 
 281     """Return True if text is selected and can be cut.
""" 
 282     return self.CanCopy() and self.CanEdit()
 
 285     """Return True if editing should succeed.
""" 
 286     return not self.GetReadOnly()
 
 289     """Return True if pasting should succeed.
""" 
 290     return stc.StyledTextCtrl.CanPaste(self) and self.CanEdit()
 
 293 <div class=
"section" id=
"to-5-2-2003"> 
 294 <h2><a class=
"toc-backref" href=
"#id21" name=
"to-5-2-2003">0.9.1 (
3/
21/
2003 to 
5/
2/
2003)
</a></h2> 
 295 <p>PyCrust is dead!  Long live Py!
</p> 
 297 <li>Renamed 
<tt class=
"literal"><span class=
"pre">PyCrust
</span></tt> package to 
<tt class=
"literal"><span class=
"pre">py
</span></tt>.
</li> 
 298 <li>Moved code to wxPython's CVS repository.
</li> 
 300 <p>Fixed bug in 
<tt class=
"literal"><span class=
"pre">introspect.py
</span></tt> on introspecting objects occurring
 
 301 immediately after a secondary prompt, like this:
</p> 
 302 <pre class=
"literal-block"> 
 303 >>> l = [
1, 
2, 
3]
 
 304 >>> for n in range(
3):
 
 305 ...     l.  
<-- failed to popup autocomplete list
 
 307 <p>Added documentation files:
</p> 
 309 <li>PyManual.txt
</li> 
 310 <li>wxPythonManual.txt
</li> 
 311 <li>wxPythonPackage.txt
</li> 
 312 <li>wxPythonExamples.txt
</li> 
 314 <p>Added PyAlaMode and PyAlaCarte code editors.
</p> 
 315 <p>Major refactoring to support 
<tt class=
"literal"><span class=
"pre">editor
</span></tt> and 
<tt class=
"literal"><span class=
"pre">shell
</span></tt> from the same
 
 317 <p>Renamed program files:
</p> 
 319 <li><tt class=
"literal"><span class=
"pre">PyCrustApp.py
</span></tt> to 
<tt class=
"literal"><span class=
"pre">PyCrust.py
</span></tt></li> 
 320 <li><tt class=
"literal"><span class=
"pre">PyFillingApp.py
</span></tt> to 
<tt class=
"literal"><span class=
"pre">PyFilling.py
</span></tt></li> 
 321 <li><tt class=
"literal"><span class=
"pre">PyShellApp.py
</span></tt> to 
<tt class=
"literal"><span class=
"pre">PyShell.py
</span></tt></li> 
 322 <li><tt class=
"literal"><span class=
"pre">wrap.py
</span></tt> to 
<tt class=
"literal"><span class=
"pre">PyWrap.py
</span></tt></li> 
 324 <p>Removed disabling of autocomplete for lists of 
2000 items or more.
 
 325 The current implementation of wxSTC can now handle lists this big.
</p> 
 326 <p>Improved handling of 
<tt class=
"literal"><span class=
"pre">sys.path
</span></tt> to mimic the standard Python shell.
</p> 
 328 <div class=
"section" id=
"to-3-20-2003"> 
 329 <h2><a class=
"toc-backref" href=
"#id22" name=
"to-3-20-2003">0.9 (
2/
27/
2003 to 
3/
20/
2003)
</a></h2> 
 330 <p>Added fontIncrease, fontDecrease, fontDefault signals, receivers and
 
 332 <pre class=
"literal-block"> 
 333 Ctrl+]            Increase font size.
 
 334 Ctrl+[            Decrease font size.
 
 335 Ctrl+=            Default font size.
 
 337 <p>Continued enhancement of the decorator capability to provide better
 
 338 documentation and docstrings for wxPython classes and functions.
</p> 
 339 <p>Introduced new tabbed interface:
</p> 
 345 <li>wxPython Docs
</li> 
 348 <p><tt class=
"literal"><span class=
"pre">Filling.tree
</span></tt> now expands tuples as well as lists.  (It should have
 
 349 done this all along, I just never noticed this omission before.)
</p> 
 350 <p>Added this True/False test to all modules:
</p> 
 351 <pre class=
"literal-block"> 
 358 <p>Added 
<tt class=
"literal"><span class=
"pre">wxd
</span></tt> directory with decoration classes.
</p> 
 360 <div class=
"section" id=
"to-2-26-2003"> 
 361 <h2><a class=
"toc-backref" href=
"#id23" name=
"to-2-26-2003">0.8.2 (
1/
5/
2003 to 
2/
26/
2003)
</a></h2> 
 362 <p>Wrapped 
<tt class=
"literal"><span class=
"pre">sys.ps1
</span></tt>, 
<tt class=
"literal"><span class=
"pre">sys.ps2
</span></tt>, and 
<tt class=
"literal"><span class=
"pre">sys.ps3
</span></tt> in 
<tt class=
"literal"><span class=
"pre">str()
</span></tt>.
 
 363 (Thanks, Kieran Holland.)
</p> 
 364 <p>Fixed minor things found by PyChecker.
</p> 
 365 <p>Changed locals to use 
<tt class=
"literal"><span class=
"pre">__main__.__dict__
</span></tt> and added code to clean up
 
 366 the namespace, making it as close to the regular Python environment as
 
 367 possible.  This solves the problem of pickling and unpickling
 
 368 instances of classes defined in the shell.
</p> 
 369 <p>Made 
<tt class=
"literal"><span class=
"pre">shell.PasteAndRun()
</span></tt> a little more forgiving when it finds a
 
 370 ps2 prompt line with no trailing space, such when you copy code from a
 
 372 <p>Improved autocomplete behavior by adding these to shell:
</p> 
 373 <pre class=
"literal-block"> 
 374 self.AutoCompSetAutoHide(False)
 
 375 self.AutoCompStops(' .,;:([)]}\'
"\\
<>%^
&+-=*/|`')
 
 377 <p>Added 
<tt class=
"literal"><span class=
"pre">decor
</span></tt> directory, 
<tt class=
"literal"><span class=
"pre">decorator.py
</span></tt>, 
<tt class=
"literal"><span class=
"pre">stcDecor.py
</span></tt>, and
 
 378 <tt class=
"literal"><span class=
"pre">stcConstants.py
</span></tt>.  These all serve the purpose of adding docstrings
 
 379 to existing wxPython classes, in particular the 
<tt class=
"literal"><span class=
"pre">wxStyledTextCtrl
</span></tt>.
</p> 
 380 <p>Added 
<tt class=
"literal"><span class=
"pre">wrap.py
</span></tt>, a command line utility for running a wxPython app
 
 381 with additional runtime-tools loaded, such as PyCrust (the only tool
 
 383 <p>Flushed the clipboard Cut/Copy operations so that selections will
 
 384 exist in the clipboard even after PyCrust has been closed.
</p> 
 385 <p>Improved the suppression of docstrings for simple data types appearing
 
 386 in the namespace viewer.
</p> 
 387 <p>Better handling of autocompletion with numeric types; no
 
 388 autocompletion when typing a dot after an integer.  If the
 
 389 autocompletion is desired, type a space before the dot:
</p> 
 390 <pre class=
"literal-block"> 
 393 <p>More Filling!!! The namespace tree is now dynamically updated.
</p> 
 395 <div class=
"section" id=
"to-12-25-2002"> 
 396 <h2><a class=
"toc-backref" href=
"#id24" name=
"to-12-25-2002">0.8.1 (
12/
20/
2002 to 
12/
25/
2002)
</a></h2> 
 397 <p>Improved keyboard handling with Autocomplete active.  You can now use
 
 398 Enter as well as Tab to select an item from the list.
</p> 
 399 <p>Disabled autocomplete for lists of 
2000 items or more.  The current
 
 400 implementation of wxSTC can't handle lists this big.
</p> 
 401 <p>Changed 
<tt class=
"literal"><span class=
"pre">filling
</span></tt> to always display docstrings for objects.  This is
 
 402 useful for objects whose docstrings have been decorated, rather than
 
 403 coming directly from the source code.  (Hmmm.  Sounds like someone is
 
 404 doing some decorating.  I wonder where that would be helpful? 
<wink
>)
</p> 
 405 <p>Fixed handling of icon.  Added 
<tt class=
"literal"><span class=
"pre">images.py
</span></tt> file.
</p> 
 407 <div class=
"section" id=
"to-12-16-2002"> 
 408 <h2><a class=
"toc-backref" href=
"#id25" name=
"to-12-16-2002">0.8 (
10/
29/
2002 to 
12/
16/
2002)
</a></h2> 
 409 <p>Added 
"help
" to startup banner info.
</p> 
 410 <p>Made all 
<tt class=
"literal"><span class=
"pre">wx
</span></tt> and 
<tt class=
"literal"><span class=
"pre">stc
</span></tt> imports explicit.  No more 
<tt class=
"literal"><span class=
"pre">import
</span> <span class=
"pre">*
</span></tt>.
</p> 
 411 <p>Replaced use of the 
<tt class=
"literal"><span class=
"pre">wx
</span></tt> module's 
<tt class=
"literal"><span class=
"pre">true
</span></tt> and 
<tt class=
"literal"><span class=
"pre">false
</span></tt> with
 
 412 Python's 
<tt class=
"literal"><span class=
"pre">True
</span></tt> and 
<tt class=
"literal"><span class=
"pre">False
</span></tt>.
</p> 
 413 <p>Changed 
<tt class=
"literal"><span class=
"pre">introspect.getRoot()
</span></tt> to use 
<tt class=
"literal"><span class=
"pre">tokenize
</span></tt> module.  This
 
 414 does a slightly better job than the previous parsing routine and the
 
 416 <p>Improved handling of whitespace and empty types during introspection.
</p> 
 417 <p>Fixed cut/copy clipboard problem under Linux.  (Robin Dunn rocks!!!)
</p> 
 418 <p>Added shell.about() which works like this:
</p> 
 419 <pre class=
"literal-block"> 
 420 >>> shell.about()
 
 423 Interpreter Revision: 
1.15 
 424 Python Version: 
2.2.2 
 425 wxPython Version: 
2.3.3.1 
 428 <p>Added copy plus and paste plus to shell menu.
</p> 
 429 <p>Moved shell menu from 
<tt class=
"literal"><span class=
"pre">shell.py
</span></tt> to 
<tt class=
"literal"><span class=
"pre">shellmenu.py
</span></tt>.
</p> 
 430 <p>Added 
<tt class=
"literal"><span class=
"pre">sys.stdin.readlines()
</span></tt> support.
</p> 
 431 <p>Added 
<tt class=
"literal"><span class=
"pre">time.sleep()
</span></tt> in 
<tt class=
"literal"><span class=
"pre">readline()
</span></tt> and 
<tt class=
"literal"><span class=
"pre">OnIdle()
</span></tt> event
 
 432 handler to free up the CPU.
</p> 
 434 <div class=
"section" id=
"to-8-27-2002"> 
 435 <h2><a class=
"toc-backref" href=
"#id26" name=
"to-8-27-2002">0.7.2 (
2/
22/
2002 to 
8/
27/
2002)
</a></h2> 
 436 <p>Tweaked 
<tt class=
"literal"><span class=
"pre">getAttributeNames()
</span></tt> to pick up a few more attributes:
</p> 
 437 <pre class=
"literal-block"> 
 438 '__bases__', '__class__', '__dict__', '__name__', 'func_closure',
 
 439 'func_code', 'func_defaults', 'func_dict', 'func_doc',
 
 440 'func_globals', 'func_name'
 
 442 <p>Added a tests directory and unit tests.
</p> 
 443 <p>Improved support for empty types in the shell: 
<tt class=
"literal"><span class=
"pre">[]
</span></tt>, 
<tt class=
"literal"><span class=
"pre">()
</span></tt> and
 
 444 <tt class=
"literal"><span class=
"pre">{}
</span></tt> as far as when call tips and autocompletion are available.
</p> 
 445 <p>Added support for the other triple string - 
<tt class=
"literal"><span class=
"pre">''''''
</span></tt>.
</p> 
 446 <p>Refactored 
<tt class=
"literal"><span class=
"pre">introspect.py
</span></tt> to improve testability.
</p> 
 447 <p>Improved call tips for unbound methods by leaving the 
"self
" 
 448 parameter, since unbound methods require an instance be passed.
</p> 
 449 <p>Fixed call tip bug where a tip was displayed when a 
"(
" was typed
 
 450 after an object that wasn't callable.
</p> 
 451 <p>Fixed 
<tt class=
"literal"><span class=
"pre">getAllAttributeNames
</span></tt> when 
<tt class=
"literal"><span class=
"pre">str(object)
</span></tt> fails.
</p> 
 452 <p>Added brace highlighting.  (Thank you, Kevin Altis.)
</p> 
 453 <p>Fixed problem displaying unicode objects in 
<tt class=
"literal"><span class=
"pre">PyFilling
</span></tt>.
</p> 
 454 <p>Changed how 
<tt class=
"literal"><span class=
"pre">filling.py
</span></tt> checks for expandable objects.  Lists are
 
 455 now expandable objects.
</p> 
 456 <p>Made the key handling more robust when there is an active text
 
 457 selection that includes text prior to the last primary prompt.  Thanks
 
 458 to Raul Cota for pointing this out.
</p> 
 459 <p>Fixed wxSTC problem with brace highlighting and non-us keyboards.
 
 460 (Thank you for the patch, Jean-Michel Fauth.)
</p> 
 461 <p>Added 
<tt class=
"literal"><span class=
"pre">busy
</span> <span class=
"pre">=
</span> <span class=
"pre">wxBusyCursor()
</span></tt> to key points in 
<tt class=
"literal"><span class=
"pre">shell
</span></tt> and
 
 462 <tt class=
"literal"><span class=
"pre">filling
</span></tt>.
</p> 
 463 <p>Added 
<tt class=
"literal"><span class=
"pre">OnCloseWindow
</span></tt> handler to 
<tt class=
"literal"><span class=
"pre">ShellFrame
</span></tt> and 
<tt class=
"literal"><span class=
"pre">CrustFrame
</span></tt>.
</p> 
 464 <p>Default to 
<tt class=
"literal"><span class=
"pre">SetWrapMode(
1)
</span></tt> for shell and namespace viewer.
</p> 
 465 <p>Added 
<tt class=
"literal"><span class=
"pre">shell.wrap()
</span></tt> and 
<tt class=
"literal"><span class=
"pre">shell.zoom()
</span></tt>.
</p> 
 466 <p>Added autoCompleteKeys hooks for Raul Cota.
</p> 
 467 <p>Cleaned up various little key handling bugs.
</p> 
 468 <p>Changed input methods to get values from shell, rather than dialog
 
 469 boxes.  Renamed 
<tt class=
"literal"><span class=
"pre">readIn
</span></tt> to 
<tt class=
"literal"><span class=
"pre">readline
</span></tt> and 
<tt class=
"literal"><span class=
"pre">readRaw
</span></tt> to
 
 470 <tt class=
"literal"><span class=
"pre">raw_input
</span></tt>.
</p> 
 472 <div class=
"section" id=
"to-2-21-2002"> 
 473 <h2><a class=
"toc-backref" href=
"#id27" name=
"to-2-21-2002">0.7.1 (
12/
12/
2001 to 
2/
21/
2002)
</a></h2> 
 474 <p>Fixed 
<tt class=
"literal"><span class=
"pre">OnChar()
</span></tt> issues effecting European keyboards, as reported by
 
 475 Jean-Michel Fauth.
</p> 
 476 <p>Fixed 
<tt class=
"literal"><span class=
"pre">introspect.py
</span></tt> issue with xmlrpc objects reported by Kevin
 
 478 <p>Fixed some introspect/PyFilling issues with regard to Python 
2.2.
</p> 
 479 <p>Fixed font background color as reported by Keith J. Farmer.  (Thanks)
</p> 
 480 <p>Fixed problem with call tips and autocompletion inside multiline
 
 481 commands as report by Kevin Altis.
</p> 
 482 <p>Improved 
<tt class=
"literal"><span class=
"pre">OnKeyDown
</span></tt> handling of cut/copy/paste operations based on
 
 483 feedback from Syver Enstad.  (Thanks)
</p> 
 484 <p>Added a 
<tt class=
"literal"><span class=
"pre">shell.help()
</span></tt> method to display some help info.
</p> 
 485 <p>Changed sort of items in the namespace viewer to case insensitive.
</p> 
 486 <p>Changed 
<tt class=
"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
 
 487 advance of an upcoming fix to an autocompletion matching bug in wxSTC.
</p> 
 488 <p>Improved support for ZODB by allowing namespace drilldown into BTrees.
</p> 
 489 <p>Added 
<tt class=
"literal"><span class=
"pre">shell.PasteAndRun()
</span></tt> to support pasting multiple commands into
 
 490 the shell from the clipboard.  Ctrl+Shift+V or v.
</p> 
 491 <p>Enter now always processes a command (or copies down a previous one.)
 
 492 To insert a line break, press Ctrl+Enter.
</p> 
 493 <p>Escape key clears the current, unexecuted command.
</p> 
 494 <p>History retrieval changed to replace current command.  Added new keys
 
 495 to insert from history - Shift+Up and Shift+Down.
</p> 
 496 <p>Better call tips on objects with 
<tt class=
"literal"><span class=
"pre">__call__
</span></tt> methods.
</p> 
 497 <p>Improved call tip positioning calculation.
</p> 
 499 <div class=
"section" id=
"to-12-11-2001"> 
 500 <h2><a class=
"toc-backref" href=
"#id28" name=
"to-12-11-2001">0.7 (
10/
15/
2001 to 
12/
11/
2001)
</a></h2> 
 501 <p>Changed how command history retrieval functions work.  Added Alt-P,
 
 502 Alt-N as keybindings for Retrieve-Previous, Retrieve-Next.
</p> 
 503 <p>Added full support for multi-line commands, similar to IDLE.
</p> 
 504 <p>Changed 
<tt class=
"literal"><span class=
"pre">introspect.getAttributeNames()
</span></tt> to do a case insensitive
 
 506 <p>Changed Cut/Copy/Paste to deal with prompts intelligently.  Cut and
 
 507 Copy remove all prompts.  Paste can handle prompted or not-prompted
 
 509 <p>Added 
<tt class=
"literal"><span class=
"pre">CopyWithPrompts()
</span></tt> method attached to Ctrl-Shift-C for those
 
 510 times when you really do want all the prompts left intact.
</p> 
 511 <p>Improved handling of the shell's read-only zone.
</p> 
 512 <p>Changed 
<tt class=
"literal"><span class=
"pre">CrustFrame.__init__
</span></tt> parameter spec to include all
 
 513 parameters allowed by a 
<tt class=
"literal"><span class=
"pre">wxFrame
</span></tt>.
</p> 
 514 <p>Changed 
<tt class=
"literal"><span class=
"pre">FillingText
</span></tt> to be read-only.
</p> 
 515 <p>Renamed 
<tt class=
"literal"><span class=
"pre">PyCrust.py
</span></tt> to 
<tt class=
"literal"><span class=
"pre">PyCrustApp.py
</span></tt> to eliminate
 
 516 package/module name conflicts that kept you from doing 
<tt class=
"literal"><span class=
"pre">from
</span> <span class=
"pre">PyCrust
</span> 
 517 <span class=
"pre">import
</span> <span class=
"pre">shell
</span></tt> inside files located in the 
<tt class=
"literal"><span class=
"pre">PyCrust
</span></tt> directory.
</p> 
 518 <p>Renamed 
<tt class=
"literal"><span class=
"pre">PyFilling.py
</span></tt> to 
<tt class=
"literal"><span class=
"pre">PyFillingApp.py
</span></tt> and 
<tt class=
"literal"><span class=
"pre">PyShell.py
</span></tt> to
 
 519 <tt class=
"literal"><span class=
"pre">PyShellApp.py
</span></tt> to maintain consistency.
</p> 
 520 <p>Removed the 
<tt class=
"literal"><span class=
"pre">__date__
</span></tt> property from all modules.
</p> 
 521 <p>Fixed bug in 
<tt class=
"literal"><span class=
"pre">introspect.getCallTip()
</span></tt>, reported by Kevin Altis.
</p> 
 523 <div class=
"section" id=
"to-10-12-2001"> 
 524 <h2><a class=
"toc-backref" href=
"#id29" name=
"to-10-12-2001">0.6.1 (
9/
19/
2001 to 
10/
12/
2001)
</a></h2> 
 525 <p>Changed 
<tt class=
"literal"><span class=
"pre">Shell.run()
</span></tt> to always position to the end of existing
 
 526 text, as suggested by Raul Cota.
</p> 
 527 <p>Changed 
<tt class=
"literal"><span class=
"pre">introspect.getAllAttributeNames()
</span></tt> to break circular
 
 528 references in 
<tt class=
"literal"><span class=
"pre">object.__class__
</span></tt>, which occurs in Zope/ZODB
 
 529 extension classes.
</p> 
 530 <p>Changed 
<tt class=
"literal"><span class=
"pre">filling.FillingTree.getChildren()
</span></tt> to introspect extension
 
 532 <p>Fixed minor bugs in 
<tt class=
"literal"><span class=
"pre">introspect.getCallTip()
</span></tt> that were interfering
 
 533 with call tips for Zope/ZODB extension class methods.
</p> 
 534 <p>In preparation for wxPython 
2.3.2, added code to fix a font sizing
 
 535 problem.  Versions of wxPython prior to 
2.3.2 had a sizing bug on Win
 
 536 platform where the font was 
2 points larger than what was specified.
</p> 
 537 <p>Added a hack to 
<tt class=
"literal"><span class=
"pre">introspect.getAllAttributeNames()
</span></tt> to 
"wake up
" 
 538 ZODB objects that are asleep - in a 
"ghost
" state.  Otherwise it
 
 539 returns incomplete info.
</p> 
 541 <div class=
"section" id=
"to-9-12-2001"> 
 542 <h2><a class=
"toc-backref" href=
"#id30" name=
"to-9-12-2001">0.6 (
8/
21/
2001 to 
9/
12/
2001)
</a></h2> 
 543 <p>Added 
<tt class=
"literal"><span class=
"pre">PyFilling.py
</span></tt> and 
<tt class=
"literal"><span class=
"pre">filling.py
</span></tt>.
</p> 
 544 <p><tt class=
"literal"><span class=
"pre">PyShell.py
</span></tt> and 
<tt class=
"literal"><span class=
"pre">PyFilling.py
</span></tt> can now be run standalone, as well
 
 545 as 
<tt class=
"literal"><span class=
"pre">PyCrust.py
</span></tt>.
</p> 
 546 <p>Added 
<tt class=
"literal"><span class=
"pre">crust.py
</span></tt> and moved some code from 
<tt class=
"literal"><span class=
"pre">PyCrust.py
</span></tt> to it.
</p> 
 547 <p>Added command history retrieval features submitted by Richie Hindle.
</p> 
 548 <p>Changed 
<tt class=
"literal"><span class=
"pre">shell.write()
</span></tt> to replace line endings with OS-specific
 
 549 endings.  Changed 
<tt class=
"literal"><span class=
"pre">shell.py
</span></tt> and 
<tt class=
"literal"><span class=
"pre">interpreter.py
</span></tt> to use
 
 550 <tt class=
"literal"><span class=
"pre">os.linesep
</span></tt> in strings having hardcoded line endings.
</p> 
 551 <p>Added 
<tt class=
"literal"><span class=
"pre">shell.redirectStdin()
</span></tt>, 
<tt class=
"literal"><span class=
"pre">shell.redirectStdout()
</span></tt> and
 
 552 <tt class=
"literal"><span class=
"pre">shell.redirectStderr()
</span></tt> to allow the surrounding app to toggle
 
 553 requests that the specified 
<tt class=
"literal"><span class=
"pre">sys.std*
</span></tt> be redirected to the shell.
 
 554 These can also be run from within the shell itself, of course.
</p> 
 555 <p>The shell now adds the current working directory 
".
" to the search
 
 557 <pre class=
"literal-block"> 
 558 sys.path.insert(
0, os.curdir)
 
 560 <p>Added support for distutils installations.
</p> 
 562 <div class=
"section" id=
"to-8-20-2001"> 
 563 <h2><a class=
"toc-backref" href=
"#id31" name=
"to-8-20-2001">0.5.4 (
8/
17/
2001 to 
8/
20/
2001)
</a></h2> 
 564 <p>Changed default font size under Linux to:
</p> 
 565 <pre class=
"literal-block"> 
 569 <p>Changed 
<tt class=
"literal"><span class=
"pre">Shell
</span></tt> to expect a parameter referencing an Interpreter
 
 570 class, rather than an intepreter instance, to facilitate subclassing
 
 571 of Interpreter, which effectively broke when the Editor class was
 
 573 <p>Fixed 
<tt class=
"literal"><span class=
"pre">PyCrustAlaCarte.py
</span></tt>, which had been broken by previous
 
 575 <p>Created 
<tt class=
"literal"><span class=
"pre">InterpreterAlaCarte
</span></tt> class as an example for use in the
 
 577 <p>Split 
<tt class=
"literal"><span class=
"pre">PyCrust.py
</span></tt> into 
<tt class=
"literal"><span class=
"pre">PyCrust.py
</span></tt> and 
<tt class=
"literal"><span class=
"pre">PyShell.py
</span></tt> in
 
 578 anticipation of 
<tt class=
"literal"><span class=
"pre">PyFilling.py
</span></tt>.
</p> 
 580 <div class=
"section" id=
"id1"> 
 581 <h2><a class=
"toc-backref" href=
"#id32" name=
"id1">0.5.3 (
8/
16/
2001)
</a></h2> 
 582 <p>Added patch to 
<tt class=
"literal"><span class=
"pre">PyCrust.py
</span></tt> to fix wxPython bug:
</p> 
 583 <pre class=
"literal-block"> 
 584 wxID_SELECTALL = NewId() # This *should* be defined by wxPython.
 
 587 <div class=
"section" id=
"to-8-15-2001"> 
 588 <h2><a class=
"toc-backref" href=
"#id33" name=
"to-8-15-2001">0.5.2 (
8/
14/
2001 to 
8/
15/
2001)
</a></h2> 
 589 <p>Shortened module names by dropping 
"PyCrust
" as a prefix.
</p> 
 590 <p>Changed 
<tt class=
"literal"><span class=
"pre">version
</span></tt> to 
<tt class=
"literal"><span class=
"pre">VERSION
</span></tt> in 
<tt class=
"literal"><span class=
"pre">version
</span></tt> module.
</p> 
 591 <p>Added Options menu to PyCrust application.
</p> 
 592 <p>Eliminated the Editor class (and editor module) by merging with Shell.
 
 593 This means that Shell 
"is a
" wxStyledTextCtrl rather than 
"has a
".
 
 594 There just wasn't enough non-gui code to justify the separation.
 
 595 Plus, Shell will be much easier for gui toolkits/designers to deal
 
 598 <div class=
"section" id=
"to-8-14-2001"> 
 599 <h2><a class=
"toc-backref" href=
"#id34" name=
"to-8-14-2001">0.5.1 (
8/
10/
2001 to 
8/
14/
2001)
</a></h2> 
 600 <p>Added 
<tt class=
"literal"><span class=
"pre">introspect
</span></tt> module.
</p> 
 601 <p>Moved some functionality from 
<tt class=
"literal"><span class=
"pre">PyCrustInterp
</span></tt> to 
<tt class=
"literal"><span class=
"pre">introspect
</span></tt>.
</p> 
 602 <p>Changed 
<tt class=
"literal"><span class=
"pre">introspect.getRoot()
</span></tt> to no longer remove whitespace from
 
 603 the command.  This was a remnant of a previous approach that, when
 
 604 left as part of the current approach, turned out to be a really bad
 
 606 <p>Changed 
<tt class=
"literal"><span class=
"pre">introspect.getRoot()
</span></tt> to allow commands of 
<tt class=
"literal"><span class=
"pre">''
</span></tt>, 
<tt class=
"literal"><span class=
"pre">""</span></tt>,
 
 607 <tt class=
"literal"><span class=
"pre">""""""</span></tt>, 
<tt class=
"literal"><span class=
"pre">[]
</span></tt>, 
<tt class=
"literal"><span class=
"pre">()
</span></tt>, and 
<tt class=
"literal"><span class=
"pre">{}
</span></tt> to pass through.  This allows
 
 608 you to type them, followed by a dot, and get autocomplete options on
 
 610 <p>Changed 
<tt class=
"literal"><span class=
"pre">introspect.getRoot()
</span></tt> to identify some situations where
 
 611 strings shouldn't be considered roots.  For example:
</p> 
 612 <pre class=
"literal-block"> 
 613 >>> import PyCrust  # To illustrate the potential problem.
 
 614 >>> len('PyCrust.py')
 
 616 <p>Typing the dot at the end of 
"PyCrust
" in the second line above should
 
 617 NOT result in an autocompletion list because 
"PyCrust
" is part of a
 
 618 string in this context, not a reference to the PyCrust module object.
 
 619 Similar reasoning applies to call tips.  For example:
</p> 
 620 <pre class=
"literal-block"> 
 621 >>> len('dir(')
 
 623 <p>Typing the left paren at the end of 
"dir
" should NOT result in a call
 
 625 <p>Both features now behave properly in the examples given.  However,
 
 626 there is still the case where whitespace precedes the potential root
 
 627 and that is NOT handled properly.  For example:
</p> 
 628 <pre class=
"literal-block"> 
 629 >>> len('this is a dir(')
 
 632 <pre class=
"literal-block"> 
 633 >>> len('This is PyCrust.py')
 
 635 <p>More code needs to be written to handle more complex situations.
</p> 
 636 <p>Added 
<tt class=
"literal"><span class=
"pre">locals=None
</span></tt> parameter to 
<tt class=
"literal"><span class=
"pre">Shell.__init__()
</span></tt>.
</p> 
 637 <p>Added support for magic attribute retrieval.  Users can change this
 
 639 <pre class=
"literal-block"> 
 640 >>> shell.editor.autoCompleteIncludeMagic = 
0 
 642 <p>Added the ability to set filters on auto completion to exclude
 
 643 attributes prefixed with a single or double underscore.  Users can
 
 644 exclude one or the other or both with:
</p> 
 645 <pre class=
"literal-block"> 
 646 >>> shell.editor.autoCompleteExcludeSingle = 
1 
 647 >>> shell.editor.autoCompleteExcludeDouble = 
1 
 650 <div class=
"section" id=
"id2"> 
 651 <h2><a class=
"toc-backref" href=
"#id35" name=
"id2">0.5 (
8/
8/
2001)
</a></h2> 
 652 <p>Mostly just a final version change before creating a release.
</p> 
 654 <div class=
"section" id=
"to-8-7-2001"> 
 655 <h2><a class=
"toc-backref" href=
"#id36" name=
"to-8-7-2001">0.4 (
8/
4/
2001 to 
8/
7/
2001)
</a></h2> 
 656 <p>Changed version/revision handling.
</p> 
 659 <div class=
"section" id=
"to-8-3-2001"> 
 660 <h2><a class=
"toc-backref" href=
"#id37" name=
"to-8-3-2001">0.3 (
8/
2/
2001 to 
8/
3/
2001)
</a></h2> 
 661 <p>Removed lots of cruft.
</p> 
 662 <p>Added lots of docstrings.
</p> 
 663 <p>Imported to CVS repository at SourceForge.
</p> 
 664 <p>Added call tips.
</p> 
 666 <div class=
"section" id=
"to-8-2-2001"> 
 667 <h2><a class=
"toc-backref" href=
"#id38" name=
"to-8-2-2001">0.2 (
7/
30/
2001 to 
8/
2/
2001)
</a></h2> 
 668 <p>Renamed several files.
</p> 
 669 <p>Added command autocompletion.
</p> 
 670 <p>Added menus to PyCrust.py: File, Edit and Help.
</p> 
 671 <p>Added sample applications: 
<tt class=
"literal"><span class=
"pre">PyCrustAlaCarte.py
</span></tt>,
 
 672 <tt class=
"literal"><span class=
"pre">PyCrustAlaMode.py
</span></tt>, and 
<tt class=
"literal"><span class=
"pre">PyCrustMinimus.py
</span></tt>.
</p> 
 674 <div class=
"section" id=
"to-7-19-2001"> 
 675 <h2><a class=
"toc-backref" href=
"#id39" name=
"to-7-19-2001">0.1 (
7/
1/
2001 to 
7/
19/
2001)
</a></h2> 
 676 <p>Added basic syntax coloring much like Boa.
</p> 
 677 <p>Added read-only logging much like IDLE.
</p> 
 678 <p>Can retrieve a previous command by putting the cursor back on that
 
 679 line and hitting enter.
</p> 
 680 <p>Stdin and raw_input operate properly so you can now do 
<tt class=
"literal"><span class=
"pre">help()
</span></tt> and
 
 681 <tt class=
"literal"><span class=
"pre">license()
</span></tt> without hanging.
</p> 
 682 <p>Redefined 
"quit
", 
"exit
", and 
"close
" to display a better-than-nothing
 
 684 <p>Home key honors the prompt.
</p> 
 685 <p>Created SourceForge account, but nothing was posted.
</p> 
 687 <div class=
"section" id=
"in-the-beginning-there-was-pie-7-1-2001"> 
 688 <h2><a class=
"toc-backref" href=
"#id40" name=
"in-the-beginning-there-was-pie-7-1-2001">In the beginning, there was pie... (
7/
1/
2001)
</a></h2> 
 689 <p>Blame it all on IDLE, Boa and PythonWin.  I was using all three, got
 
 690 frustrated with their dissimilarities, and began to let everyone know
 
 691 how I felt.  At the same time, Scintilla looked like an interesting
 
 692 tool to build a shell around.  And while I didn't receive much in the
 
 693 way of positive feedback, let alone encouragement, I just couldn't let
 
 694 go of the idea of a Scintilla-based Python shell.  Then the PythonCard
 
 695 project got to the point where they were talking about including a
 
 696 shell in their development environment.  That was all the incentive I
 
 697 needed.  PyCrust had to happen...
</p> 
 701 <hr class=
"footer" /> 
 703 Generated on: 
2004-
03-
26 21:
09 UTC.