jni 1.2.0b1
Python bridge for the Java Native Interface.
Requires Python: <4.0.0,>=3.10.0
Keywords: jni, jvm, jtypes, jt, jpype, jep, pyjnius, jpy, javabridge, pyjava, jcc, py4j, jython, java, pythonjava, rubicon-java

jni
===

Python bridge for the Java Native Interface.

Overview
========

| |package_bold| is a complete bridge between Python and Java JNI.
| It is an effort to allow python programs full access to Java JNI API.

`PyPI record`_.

`Documentation`_.

| |package_bold| is a lightweight Python package, based on the *ctypes*, or *cffi* library,
  or Cython wrapper (currently under development).
| It is done by implementing whole JNI API functionality in a clean Python instead of C/C++.
| |package_bold| also contains a JNI wrapper in pure C based on Python C-API (currently under
  development) - mainly for performance reasons.

What is |package|:
------------------

| |package_bold| is an effort to allow python programs full access to Java JNI API.
| This is achieved not through re-implementing Python, as Jython has done,
  but rather through interfacing at the native level in both virtual machines.

Known Bugs/Limitations :
  * Because of lack of JVM support, you cannot shutdown the JVM and then restart it.

Installation
============

Prerequisites:

+ Python 3.10 or higher

  * https://www.python.org/
  * Java 17 is a primary test environment.

+ pip and setuptools

  * https://pypi.org/project/pip/
  * https://pypi.org/project/setuptools/

To install run:

  .. parsed-literal::

    python -m pip install --upgrade |package|

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:

  .. parsed-literal::

    git clone |respository| |package|

and run:

  .. parsed-literal::

    python -m pip install ./|package|

or on development mode:

  .. parsed-literal::

    python -m pip install --editable ./|package|

License
=======

  | |copyright|
  | Licensed under CC BY-NC-ND 4.0
  | Licensed under proprietary License
  | Please refer to the accompanying LICENSE file.

Authors
=======

* Adam Karpierz <adam@karpierz.net>

.. |package| replace:: jni
.. |package_bold| replace:: **jni**
.. |copyright| replace:: Copyright (c) 2004-2025 Adam Karpierz
.. |respository| replace:: https://github.com/karpierz/jni.git
.. _Development page: https://github.com/karpierz/jni
.. _PyPI record: https://pypi.org/project/jni/
.. _Documentation: https://jni.readthedocs.io/

Changelog
=========

1.2.0b1 (2025-06-17)
--------------------
- Add support for Python 3.14
- Add support for PyPy 3.11
- Drop support for Python 3.9 (due to compatibility issues).
- Drop support for PyPy 3.9
- | Drop support for Oracle Java 1.8 (jdk, jre) due to licensing issues
  | and the end of support from Oracle.
- Update readthedocs's python to version 3.13
- Update tox's base_python to version 3.13
- The distribution is now created using 'build' instead of 'setuptools'.
- Copyright year update.
- Setup (dependencies) update.

1.1.0b6 (2024-12-01)
--------------------
- Fixes for embedded python.
- Java 17 is now the primary build/test environment.
- Add support for Python 3.13
- Drop support for Python 3.8
- jni.c and pvm.c (useful for embedded python apps) have been added.
- Unittest have been performed for much more JVMs.
- Tox configuration is now in native (toml) format.
- Setup fixes.
- Setup (dependencies) update.

1.0.0b22 (2024-01-26)
---------------------
- Tox configuration has been moved to pyproject.toml
- Setup update (now based on tox >= 4.0).
- Add support for Python 3.10, 3.11 and 3.12
- Drop support for Python 3.7
- Add support for PyPy 3.9 and 3.10
- Copyright year update.

1.0.0b20 (2022-01-29)
---------------------
- Drop support for Python 3.6
- Setup update.

1.0.0b18 (2021-10-13)
---------------------
- dll_path argument of load() can also be type os.PathLike.
- Copyright year update.
- Setup update.

1.0.0b17 (2020-11-10)
---------------------
- Add support for Python 3.9
- General update, improvements and cleanup.
- Setup update and improvements.
- Fixed docs setup.

1.0.0b7 (2020-03-08)
--------------------
- Drop support for Python2
- Update of license info.
- Setup update.

1.0.0b4 (2019-07-10)
--------------------
- Last release for Python2

1.0.0b3 (2018-05-22)
--------------------
- Update of the required setuptools version.

1.0.0b2 (2018-02-26)
--------------------
- Improvement and simplification of setup and packaging.

1.0.0b1 (2017-11-18)
--------------------
- First 'official' version.

0.1.1 (2005-10-05)
------------------
- Initial version.