add --shared
[pylucene.git] / jcc / DESCRIPTION
1
2 For changes since earlier releases, see:
3   http://svn.apache.org/repos/asf/lucene/pylucene/trunk/jcc/CHANGES
4
5 JCC is a C++ code generator for producing the code necessary to call
6 into Java classes from CPython via Java's Native Invocation Interface (JNI).
7
8 JCC generates C++ wrapper classes that hide all the gory details of JNI
9 access as well Java memory and object reference management.
10
11 JCC generates CPython types that make these C++ classes accessible from a
12 Python interpreter. JCC attempts to make these Python types pythonic by
13 detecting iterators and property accessors. Iterators and mappings may also
14 be declared to JCC.
15
16 JCC has been built on Python 2.3, 2.4, 2.5, 2.6 and 2.7 and has been used with
17 various Java Runtime Environments such as Sun Java 1.4, 1.5 and 1.6, Apple's
18 Java 1.4 and 1.5 on Mac OS X and open source Java OpenJDK 1.7 builds.
19
20 An experimental port to Python 3 is available from a branch:
21   http://svn.apache.org/repos/asf/lucene/pylucene/branches/python_3/jcc/
22
23 JCC is supported on Mac OS X, Linux, Solaris and Windows.
24
25 JCC is written in C++ and Python. It uses Java's reflection API to do its
26 job and needs a Java Runtime Environment to be present to operate.
27
28 JCC is built with distutils or setuptools::
29
30     python setup.py build
31     sudo python setup.py install
32
33 Setuptools is required to build JCC on Python 2.3.
34
35 Except for Mac OS X - where Apple's Java comes pre-installed in a known
36 framework location - JCC's setup.py file needs to be edited before building
37 JCC to specify the location of the Java Runtime Environment's header files
38 and libraries.
39
40 The svn sources for JCC are available at:
41   http://svn.apache.org/repos/asf/lucene/pylucene/trunk/jcc/
42
43 For more information about JCC see:
44   http://lucene.apache.org/pylucene/jcc/index.html
45
46 JCC comes with an Apache 2.0 copyright license:
47   http://www.apache.org/licenses/LICENSE-2.0