jvm 0.5.0b5

Python bridge for the Java Virtual Machine.

jvm

Python bridge for the Java Virtual Machine.

Overview

jvm is a bridge between Python and JVM, allowing these to intercommunicate.

It is an effort to allow Python programs full access to Java class libraries.

PyPI record.

Documentation.

jvm package is closely based on the jni Python package.

What is jvm:

jvm is an effort to allow Python programs full access to Java class libraries.

This is achieved not through re-implementing Python, as Jython 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 …

Known Bugs/Limitations :

• Java classes outside of a package (in the <default>) cannot be imported.

• 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.

Installation

Prerequisites:

• Python 3.6 or higher

  • https://www.python.org/

  • 3.7 with Java 8 is a primary test environment.

• pip and setuptools

  • https://pypi.org/project/pip/

  • https://pypi.org/project/setuptools/

To install run:

python -m pip install --upgrade jvm

Development

Prerequisites:

• Development is strictly based on tox. To install it run:

  python -m pip install --upgrade tox

Visit development page.

Installation from sources:

clone the sources:

git clone https://github.com/karpierz/jvm.git jvm

and run:

python -m pip install ./jvm

or on development mode:

python -m pip install --editable ./jvm

License

Copyright (c) 2004-2022 Adam Karpierz

Licensed under CC BY-NC-ND 4.0

Licensed under proprietary License

Please refer to the accompanying LICENSE file.

Authors

• Adam Karpierz <[e-mail]>

Changelog

0.5.0b5 (2021-10-16)

• dll_path argument of JVM() can also be type os.PathLike.

• Copyright year update.

• Setup update.

0.5.0b3 (2020-12-13)

• Add support for Python 3.9.

• General update, improvements and cleanup.

• Setup update.

• Elimination of dependence on _testcapi.

0.4.0b3 (2020-03-08)

• Drop support for Python2.

• Update of Mozilla Rhino.

• Update of license info.

• Setup update.

0.3.0b2 (2019-07-10)

• Last release for Python2.

0.3.0b1 (2018-11-08)

• Bug fixes and improvements.

• Add Java 10 support.

• Update of the required setuptools version.

• Setup and tests improvements.

0.2.0b3 (2018-05-29)

• Bug fixes and improvements in Java 9 support.

• Improved support for Cygwin.

• Update of Mozilla Rhino.

• Update of the required setuptools version.

0.2.0b1 (2018-02-26)

• Improvement and simplification of setup and packaging.

0.1.1 (2005-10-05)

• Initial version.