Metadata-Version: 2.1
Name: jni
Version: 1.0.0b20
Summary: Python bridge for the Java Native Interface.
Home-page: https://pypi.org/project/jni/
Author: Adam Karpierz
Author-email: adam@karpierz.net
Maintainer: Adam Karpierz
Maintainer-email: adam@karpierz.net
License: Creative Commons BY-NC-ND 4.0 License ; https://creativecommons.org/licenses/by-nc-nd/4.0 ;
        Copyright (c) 2004-2022 Adam Karpierz, All Rights Reserved, Licensed under proprietary License
Download-URL: https://pypi.org/project/jni/
Project-URL: Documentation, https://jni.readthedocs.io/
Project-URL: Source, https://github.com/karpierz/jni
Project-URL: Issues, https://github.com/karpierz/jni/issues
Keywords: jni, jvm, jtypes, jt, jpype, jep, pyjnius, jpy, javabridge,,pyjava, jcc, py4j, jython, java, pythonjava, rubicon-java
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Free for non-commercial use
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: Polish
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: Stackless
Classifier: Programming Language :: Java
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Libraries :: Java Libraries
Requires-Python: <4.0.0,>=3.7.0
Description-Content-Type: text/x-rst; charset=UTF-8
Provides-Extra: cffi
Provides-Extra: cython
Provides-Extra: doc
Provides-Extra: test
License-File: LICENSE

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

  .. 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 (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 <adam@karpierz.net>

.. |package| replace:: jni
.. |package_bold| replace:: **jni**
.. |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.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.


