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