xpython
=============

About
------

xpython is a windows python interpreter contained in a single .exe file,
with a number of libraries already linked in.

It contains the following libraries and/or python modules:

* `gfx <http://www.swftools.org/gfx.html>`_
* `wxWindows <http://www.wxwindows.org/>`_ (and `wxPython * <http://www.wxpython.org/>`_)
* `Imaging <http://www.pythonware.com/products/pil/>`_
* `ReportLab <http://www.reportlab.org/>`_
* `sqlite <http://www.sqlite.org>`_ (with pysqlite)
* `magpy <http://www.athana.org/magpy>`_

xpython hence makes it very easy to install Python programs based on one
of the above libraries (in particular, wxPython applications) on
arbitrary windows machines.

It's also possible to compile a version of xpython (without wxWindows) 
for Linux, for testing and/or development purposes.

Download
--------

`xpython.exe <xpython.exe>`_, Version 0.3.0 

`xpython Source Code <xpython.tar.gz>`_, Version 0.3.0 (includes all needed libraries)

Usage
-----

Just run xpython.exe like you would python.exe::

 xpython.exe program.py

If program.py does any imports based on wxWindows, Imaging etc., those
will be served from the data contained in xpython.exe itself.

Compiling 
---------

In order to compile xpython (which you normally do *not* need to do- the
whole point of this project, after all, is to save you the hassle of compiling
python for windows with custom libraries), pass your mingw version to
the configure script::

  CXX=/opt/xmingw/bin/i386-mingw32msvc-g++ \
  CPP=/opt/xmingw/bin/i386-mingw32msvc-cpp \
  CC=/opt/xmingw/bin/i386-mingw32msvc-gcc \
  AR=/opt/xmingw/bin/i386-mingw32msvc-ar \
  RANLIB=/opt/xmingw/bin/i386-mingw32msvc-ranlib \
  STRIP=/opt/xmingw/bin/i386-mingw32msvc-strip \
  WINDRES=/opt/xmingw/bin/i386-mingw32msvc-windres \
  NM=/opt/xmingw/bin/i386-mingw32msvc-nm \
   ./configure --host=i586-mingw32msvc 

The above is only an example, for how to do this on Gentoo systems- your 
host environment might differ.


.. Contents:
   ---------

.. toctree::
   :maxdepth: 2

.. Indices and tables
   ---------------------

.. * :ref:`genindex`
.. * :ref:`modindex`
.. * :ref:`search`