Pydemexp
========

Pydemexp is a small kit that allows to create programs that interact
with a demexp [1] server. It offers simple examples that be extended
to develop full-featured text-based or graphical clients, as well as
various scripts, like RSS feeds or Web pages generators. It is based
on PyRpc [2] to communicate with the server using the Sun RPC
protocol.

[1] http://www.demexp.org
[2] http://thomas.enix.org/pub/pyrpc/

Installation
============

First of all, you need to install PyRpc, available at
http://thomas.enix.org/pub/pyrpc/. You also need noweb (available in
the package of the same name in the Debian distribution).

Once PyRpc is installed, you can generate the client stubs for the
demexp protocol. To do so, you need the sources of demexp, available
from http://www.demexp.org. Uncompress them somewhere, and run the
generate-demexp-rpc.sh script with the path to the demexp sources as
argument.

To sum up:

 $ wget http://thomas.enix.org/pub/pydemexp/pydemexp-0.1.tar.gz
 $ tar xvzf pydemexp-0.1.tar.gz
 $ wget http://www.linux-france.org/~dmentre/demexp/latest-src/demexp-0.6.3.tar.gz
 $ tar xvzf demexp-0.6.3.tar.gz
 $ cd pydemexp-0.1
 $ ./generate-demexp-rpc.sh ../demexp-0.6.3/

This will create the DemexpRpc directory, which contains a Python
package of the same name, usable to interact with a demexp server.

clean-demexp-rpc.sh is a script that removes the files generated by
the generate-demexp-rpc.sh script.

Usage
=====

Three examples are available:

 - add-question.py is a basic example that adds a question whose
   description is given on the command line. It assumes that the
   server is running on the local machine on port 50000 and that the
   root login is root:demexp.

 - list-question.py is another basic example that lists all questions
   available on the server running on localhost, port 50000. It also
   log in as root:demexp.

 - pydemexp is a more advanced example. It is a small client, that
   allows to connect and disconnect from servers, add question and
   tags, list questions and tags, tag and untag questions. It is
   possible through a very rudimentary text-based interface, not very
   usable for the day-to-day usage of demexp.

Download
========

The latest stable version of pydemexp is available from
http://thomas.enix.org/pub/pydemexp/. The latest development version
can be retrived from the Subversion repository available at
https://ssl.bulix.org/svn/thomas/pydemexp/trunk/.

Authors
=======

Code written by Thomas Petazzoni <thomas.petazzoni@enix.org>

License
=======

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; version 2 of the License.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.