Fork of JPype with the goal of an easy installation process.
C++ Python C Java Objective-C
Switch branches/tags
Nothing to show
Pull request Compare This branch is 86 commits ahead, 494 commits behind originell:master.
Latest commit 0fa3b80 Feb 25, 2017 @tcalmant tcalmant Allow trusted paths, to fix #24
This allows to accept a Java home from the JAVA_HOME environment variable whatever its root directory is,
as long as it as an "include" folder.

README.rst

JPype - Python 3

From the original Website:

JPype is an effort to allow python programs full access to java class libraries. This is achieved not through re-implementing Python, as Jython/JPython has done, but rather through interfacing at the native level in both Virtual Machines. Eventually, it should be possible to replace Java with python in many, though not all, situations. JSP, Servlets, RMI servers and IDE plugins are good candidates.

Once this integration is achieved, a second phase will be started to separate the Java logic from the Python logic, eventually allowing the bridging technology to be used in other environments, I.E. Ruby, Perl, COM, etc ...

This GitHub fork is a Python 3 version of jPype. It does not support Python 2.

This is a fork of originell/jpype, which originally aims to simplify the installation of jPype on Linux and MacOS X.

Known Bugs/Limitations

  • Java classes outside of a package (in the <default> package) cannot be imported.
  • Fields or methods conflicting with a python keyword can't be accessed.
  • Because of lack of JVM support, you cannot shutdown the JVM and then restart it.
  • Some methods rely on the "current" class/caller. Since calls coming directly from python code do not have a current class, these methods do not work. The User Manual lists all the known methods like that.

Road map

Future developments of this fork of jPype :

  • Stay close to the Python 2 version (patches, issues, ...)
  • Convert examples in Python 3
  • Review the code (Python and C++): clean up, add comments, ...
  • Separate Python 3 specific code (Python and C++)

Requirements

The Python 3 development files and either the Sun/Oracle JDK/JRE Variant or OpenJDK.

Debian/Ubuntu

Debian/Ubuntu users will have to install g++ and python3-dev first:

sudo apt-get install g++ python3-dev

Red Hat/Fedora

Same thing with Fedora users:

su -c 'yum install gcc-c++ python3-devel'

Windows

On Windows, you will have to install:

Installation

On Linux:

sudo python3 setup.py install

On Windows:

python setup.py install

If it fails...

This happens mostly due to the setup not being able to find your JAVA_HOME. In case this happens, please do two things:

  1. You can continue the installation by finding the JAVA_HOME on your own ( the place where the headers etc. are) and explicitly setting it for the installation:

    JAVA_HOME=/usr/lib/jvm/java-1.7.0-openjdk-amd64 python3 setup.py install
  2. Please create an Issue on GitHub and post all the information you have.

Tested on

OS Architecture Java version
Fedora 18 64 bits OpenJDK 6 and 7
Fedora 19 64 bits OpenJDK 6 and 7
Ubuntu 12.04 64 bits OpenJDK 6 and 7
Mac OS X 10.8.4 64 bits Oracle JDK 6 and 7
Mac OS X 10.9 64 bits Oracle JDK 6 and 7
Windows 7 32 bits Oracle JDK 7 and OpenJDK 7