home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
linuxmafia.com 2016
/
linuxmafia.com.tar
/
linuxmafia.com
/
pub
/
palmos
/
pippy-0.6beta-src.tar.gz
/
pippy-0.6beta-src.tar
/
pippy-0.6beta-src
/
docs
/
README
< prev
next >
Wrap
Text File
|
2001-02-23
|
6KB
|
209 lines
Pippy - The port of Python to the Palm OS.
VERSION: Pippy 0.6beta.
Copyright (c) 2001 Endeavors Technology, Inc.
All rights reserved.
NOTE
This distribution contains the source code for Pippy, the port of
Python (<http://www.python.org/>) to the PalmOS (<http://www.palm.com/>).
If you are only interested in running Pippy on a Palm hand held device,
you may download the pre-built PRC files (Pippy-0.6beta.tar.gz) from:
<http://www.endeavors.com/pippy.html>.
WARNING: Backup your Palm device before installing Pippy!
INTRODUCTION
Welcome to Pippy, the port of Python (revision 1.5.2+) to the PalmOS.
This project is a continuation of work previously released jointly
by The Aerospace Corporation and the University of California,
Irvine. <http://www.isr.uci.edu/projects/sensos/python>
Pippy runs on the PalmOS Version 3.5 and higher. The current version of
Pippy passes a restricted subset of the standard Python regression test suite
without failures or errors.
Our primary focus in this release of Pippy is tighter integration of
Python with the PalmOS. We have also included a simple interactive interface.
Several Python extension modules have been ported or developed from
scratch specifically to support the PalmOS. A list of these modules is
provided below.
We encourage interested developers to join our efforts to improve and
extend Pippy.
COPYRIGHT/LICENSE
License and copyright issues are discussed in the file: LICENSE
SYSTEM REQUIREMENTS
Palm Hand Held Device
Pippy was tested on POSE (PalmOS Emulator) and on a Palm IIIxe (running
PalmOS 3.5 or greater with 8M of RAM). Pippy has also been successfully
installed on a Palm III with 2M of RAM, but memory limitations
(specifically related to the Heap size) prevents Pippy from running any
significant code (see KNOWN PROBLEMS below).
Development Platform
Any platform for which the GNU tool chain has been ported. Additional
development tools are available as discussed in the file: TOOLS.
Pippy has been built on the following systems:
Solaris 2.6
Windows 95
Linux (RedHat 6.2)
BUILDING
The following instructions are specific to Unix/Linux.
0. This version of Pippy REQUIRES A SPECIFIC VERSION OF PYTHON. Please
see the TOOLS file for details on how to obtain and install this version.
1. See the file TOOLS for instructions to install the development
tools. You must use the tool set described in TOOLS. Other development
tool sets, such as prc-tools-2.0 and CodeWarrior, will NOT work for this
port.
2. See the file BUILD for the Pippy build instructions. Instructions
for installing the .prc files are also included in this file.
WARNING: Backup your Palm device before installing Pippy!
WHAT'S NEW
The following modules have been ported to the PalmOS as part of our
Pippy development:
palm_socketmodule.c
palm_errnomodule.c
palm_timemodule.c
palm_selectmodule.c:
We have eliminated floating point objects in the current release of
Pippy in the interest of reducing the code footprint. The time
specifier for time.sleep() and select.select() has been changed to the
following:
time.sleep(seconds, micro_seconds)
select.select(rlist, wlist, xlist[, (seconds, micro_seconds)])
The following modules are PalmOS specific:
palmnetmodule.c - Controls the palm network connection
palmeventmodule.c - Exports events to the Palm
palmsysmodule.c - Provides access to Palm system functions
palmdmmodule.c - Database interface
palmappsmodule.c - Standard Palm applications
palmformmodule.c - Palm forms
User Interface
A "BREAK" button has been added, which when pressed raises a
KeyboardInterrupt exception. Additional development on the user
interface is required.
TODO
If you are interested in helping with this effort, please email us for
further explanation on one of the topics listed below. We also welcome
suggestions for additional features.
Improve and update the Pippy User Interface. As a starting point we have
selected the LispMe interface <http://www.lispme.de/lispme/index.html>.
Object overhead reduction
Code footprint reduction (remove longobject, fileobject, ...)
Modified import mechanism - import from Palm databases, URLs, etc
Stackless Python
Stackless marshal (recursions can overflow the stack)
Interactive interface (similar to LispMe)
Integration with Palm
Port Python library modules (usually require minor mods)
Improve startup/shutdown speed
Improve/abstract IO Stream interface
Python Resource Manager (track stack, heap, freelists, etc.)
Upgrade to Python 2.0
REMOVED PYTHON FEATURES
The following features have been removed from this port of Python:
* float and complex objects
* file IO (stdio and stderr are simulated)
* documentation strings
* parser, compile - in non-interactive environments the parser and
compiler can be easily eliminated with a configuration switch
* most python library modules
* most extension modules
KNOWN PROBLEMS
Recursive Python functions can overflow the stack, possibly requiring a
hard reset. The implementation of Stackless Python will overcome this
problem.
The dynamic heap is variable, at most 256 KB, for systems running PalmOS
version 3.5 or later. Some applications may overflow this and raise a
MemoryError exception. However, if this happens there may not be
sufficient dynamic memory in reserve to clean up after Python
necessitating a soft reset of the Palm.
This release of Pippy runs only on PalmOS 3.5 or higher.
There is a GUI problem with PalmOS 3.0 that we are investigating.
The current "BREAK" button implementation responds to any touch of the
screen, not just the button. This can be easily fixed, but we just
haven't had the time.
LINKS AND CONTACT INFORMATION
Pippy Development Home
<http://www.endeavors.com/pippy.html>
Feedback & General Comments
<pippy@endeavors.com>
MAILING LISTS
Developer Issues
<pippy-dev@endeavors.org>
Bug Reports
<pippy-bugs@endeavors.org>
Announcements
<pippy-announce@endeavors.org>
CVS REPOSITORY
<http://www.endeavors.com/pippy/download.html>
Palm Developers Site
<http://www.palmos.com/dev/>
AUTHORS
Jeffery D. Collins <jcollins@endeavors.com>
Michael Gorlick <mgorlick@endeavors.com>
Endeavors Technology, Inc.
19700 Fairchild Rd, Suite 200
Irvine, CA 92612