Metadata-Version: 2.4
Name: jni
Version: 1.3.0b7
Summary: Python bridge for the Java Native Interface.
Author-email: Adam Karpierz <adam@karpierz.net>
Maintainer-email: Adam Karpierz <adam@karpierz.net>
License-Expression: CC-BY-NC-ND-4.0 OR LicenseRef-Proprietary
Project-URL: Homepage, https://pypi.org/project/jni/
Project-URL: Documentation, https://karpierz.github.io/jni/
Project-URL: History, https://karpierz.github.io/jni/CHANGES.html
Project-URL: Download, https://pypi.org/project/jni/
Project-URL: Repository, https://github.com/karpierz/jni
Project-URL: Tracker, https://github.com/karpierz/jni/issues
Project-URL: Sponsoring, https://www.paypal.com/donate/?hosted_button_id=FX8L7CJUGLW7S
Keywords: java,jni,jvm,jt,jtypes,jpype,jep,pyjnius,jpy,pyjava,javabridge,jcc,py4j,jython,pythonjava,rubicon-java
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: Polish
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: C
Classifier: Programming Language :: Java
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: GraalPy
Classifier: Topic :: Software Development :: Libraries :: Java Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: <4.0.0,>=3.11.0
Description-Content-Type: text/x-rst; charset=UTF-8
License-File: LICENSE
Requires-Dist: typing-extensions>=4.16.0
Requires-Dist: pkg-about>=2.5.0
Requires-Dist: py-utlx>=2.5.0
Provides-Extra: cffi
Requires-Dist: cffi>=2.1.1; platform_python_implementation != "GraalVM" and extra == "cffi"
Provides-Extra: cython
Requires-Dist: cython>=3.3.1; extra == "cython"
Dynamic: license-file

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.

Requirements
============

- ATTENTION: currently works and tested only for Windows.

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

Prerequisites:

+ Java 1.8 or higher

  * Java Runtime (JRE) or Java Development Kit (JDK).

+ Python 3.11 or higher

  * https://www.python.org/
  * Java 17 is a primary test environment.

+ pip

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

To install run:

  .. parsed-literal::

    python -m pip install --upgrade |package|

Development
===========

Prerequisites:

+ Development is strictly based on *nox*. To install it run::

    python -m pip install --upgrade nox

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>

Sponsoring
==========

| If you would like to sponsor the development of this project, your contribution
  is greatly appreciated.
| As I am now retired, any support helps me dedicate more time to maintaining and
  improving this work.

`Donate`_

.. |package| replace:: jni
.. |package_bold| replace:: **jni**
.. |copyright| replace:: Copyright (c) 2004-2026 Adam Karpierz
.. |respository| replace:: https://github.com/karpierz/jni
.. _Development page: https://github.com/karpierz/jni
.. _PyPI record: https://pypi.org/project/jni/
.. _Documentation: https://karpierz.github.io/jni/
.. _Donate: https://www.paypal.com/donate/?hosted_button_id=FX8L7CJUGLW7S
