Jukebox - A Python implementation for connectivity to jBASE

Abstract: 
    Jukebox is an open source, platform independent utility for connectivity
    from the Python language to a jBASE database. It's object model closely
    resembles that of Java OBjEX however there are certain 'Pythonic' 
    differences imposed by the language.

Minimum Requirements:

    jBASE 3.3.10
    Python 2.0

Installation Instructions:

Download Jukebox

***Some components may have 'read only' permissions and you should change this as necessary***

1)  Place all .py files in a directory visible to the PYTHONPATH environment variable
    on the client. **

2)  Place all .b files in a jBC program library on the server machine. **

3)  Compile and catalog the jukebox.b server component. Note that it must be compiled
    with the following Config_EMULATE emulation option set:

       	 resize_array = true

    Once the jukebox.b program is compiled, this setting can be changed back to its original value.

    For convenience, the download package contains executables for the Windows and
    Linux platforms. The Windows executable was compiled with VC++ 6.0. The Linux
    executable was compiled with the GNU compiler version egcs-2.91.66. If you are
    using one of those platforms, simply place the appropriate file in a 'bin'
    directory visible to the PATH environment variable. If you are not using one of
    those platforms (or your Unix/Linux machine does not use this version of the GNU
    compiler), you will be required to compile and catalog this component on the server.

** This is a preliminary release of the software. Currently, sockets have not been
implemented, therefore both client and server components will run locally on the
client machine. Sockets will be implemented in a future release.


Code Examples:

The jtest.py module contains example client code. To install and run this module:

1) Place the jtest and jtest]D hashed files in your HOME directory, or visible to
   the JEDIFILEPATH environment variable. It may be necessary to change these files to
   have 'write' permissions.

2) Compile and catalog the jcalltest.b and jcalltest2.b jBC programs so they are visible
   to the JBCOBJECTLIST environment variable. These programs require no special
   configuration settings.

To run the jtest.py module:

	 python jtest.py

===================================================================

Support: Send questions, comments, suggestions or report bugs to python@jbase.com

See the Python Integration presentation from the jBASE User Conference.

===================================================================

The author of Jukebox would be interested to know if you have downloaded this software
so as to keep track of the level of interest. If you are so inclined, please send email
to python@jbase.com with your name and company so that we can keep you informed of
it's progress.

Any comments or suggestions are gratefully received.