5f933e58ef
includes several new tools. As part of the change the location of the pacakge has changed as well, it is now accessible as "from wxPython import py" (or "from wx import py" using the new namespace.) There are still some transition moudules in the wxPython.lib.PyCrust mackage that will issue a warning and then import what is needed from the new package. These will be removed in a future release. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/branches/WX_2_4_BRANCH@20104 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
77 lines
2.2 KiB
Plaintext
77 lines
2.2 KiB
Plaintext
===============
|
|
The Py Manual
|
|
===============
|
|
|
|
-------------------------
|
|
Py - Served Fresh Daily
|
|
-------------------------
|
|
|
|
:Author: Patrick K. O'Brien
|
|
:Contact: pobrien@orbtech.com
|
|
:Date: $Date$
|
|
:Revision: $Revision$
|
|
|
|
.. contents::
|
|
|
|
|
|
Introduction
|
|
============
|
|
|
|
This document will show you how to make use of the Py programs and
|
|
library of modules.
|
|
|
|
|
|
What is Py?
|
|
===========
|
|
|
|
Py is really several things. Py is a set of standalone programs as
|
|
well as a library of modules that you can use in your own programs.
|
|
|
|
First, Py contains standalone programs that provide code editors and
|
|
graphical, Python shell interfaces. Second, Py contains a collections
|
|
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 program. Third, Py containss a
|
|
wrapper utility, providing you with runtime introspection capabilities
|
|
for your wxPython programs without having to include PyCrust or
|
|
PyShell in your program, or alter one line of your code.
|
|
|
|
|
|
Py standalone programs
|
|
======================
|
|
|
|
There are several standalone applications in the Py package:
|
|
|
|
* PyAlaCarte
|
|
* PyAlaMode
|
|
* PyCrust
|
|
* PyFilling
|
|
* PyShell
|
|
* PyWrap
|
|
|
|
|
|
Py modules
|
|
==========
|
|
|
|
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.
|
|
|
|
|
|
Py runtime wrapper
|
|
==================
|
|
|
|
The Py wrapper utility (``PyWrap.py``) lets you run an existing
|
|
wxPython program with a PyCrust frame at the same time. Inside the
|
|
PyCrust shell, the local variable ``app`` is assigned to your
|
|
application instance. In this way you can introspect your entire
|
|
application within the PyCrust shell and the PyFilling namespace
|
|
viewer. And through the use of the Py decorator classes, PyCrust can
|
|
display wxPython function and method signatures as well as docstrings
|
|
for the entire wxPython library.
|