Skip to main content

Illumon fork of jpy Bi-directional Python-Java bridge

Project description

Illumon jpy
===========

This package is fork of jpy https://github.com/bcdev/jpy.git

- This fork of "jpy" adds custom extensions for the "illumon-iris" Python package.

Installation
------------

- Note that "illumon-jpy" is not compatible with "jpy" as they both install shared libraries with the same name.
- If you already have "jpy" installed, it should be removed before installing "illumon-jpy"

```

# Remove jpy if it is currently installed
pip uninstall jpy

# Install illumon-jpy
pip install illumon-jpy

```

Usage
-----

>>> import illumon
>>> ...


*************
jpy Changelog
*************

Version 0.9
===========

This version includes a number of contributions from supportive GitHub users. Thanks to all of you!

Fixes
-----

* Corrected Java reference count of complex PyObject passed back and forth to methods (issue #120). Fix by sbarnoud.
* Fixed problem where default methods on Java 8 Interfaces were not found (issue #102). Fix by Charles P. Wright.
* Fixed error caused by missing `sys.argv` in Python when called from Java (issue #81). Fix by Dave Voutila.
* Fixed problem where calling jpy.get_type() too many times causes a memory access error (issue #74). Fix by Dave Voutila.
* Fixed a corruption when retrieving long values (#72). Fix by chipkent.
* Fixed fatal error when stopping python session (issue #70, #77). Fix by Dave Voutila.

Improvements
------------

* Can now use pip to install Python `jpy` package directly from GitHub (#83).
This works for Linux and OS X where C compilers are available by default
and should work on Windows with Visual Studio 15 installed.
Contribution by Dave Voutila.
* Java `PyObject` is now serializable. Contribution by Mario Briggs.
* Improved Varargs method matching. You may pass in either an array (as in the
past) or individual Python arguments, the match for a varargs method call is
the minimum match for each of the arguments. Zero length arrays (i.e. no
arguments) are also permitted with a match value of 10.
* `jpy.type_translations` dictionary for callbacks when instantiating Python objects.
* `jpy.VerboseExceptions` enables full Java stack traces.
* More Python exceptions are translated to the corresponding Java type.
* Globals and locals are converted when executing code with PyLib, to allow variables to be
used across statement invocation; and interrogated from Java.
* PyObject wrappers for dictionary, list, and introspection functions to tell
you whether or not you can convert the object.
* Support for isAssignable checks when dealing with Python Strings and primitives, to allow
matches for argument types such as `java.lang.Comparable` or `java.lang.Number`.

Version 0.8
===========

Fixes
-----

* Java interface types don't include methods of extended interfaces (issue #64)
* Loading of jpy DLL fails for user-specific Python installations on Windows (issue #58)
* Java interface types didn't expose java.lang.Object methods (issue #57)
* Java 1-arg static method was confused with a zero-arg non-static method (issue #54)
* Python interpreter crash occurred when executing del statement on Java arrays (issue #52)
* Python extensions loaded from Java couldn't see Python symbols (Linux) (issue #38)

Improvements
------------

* It is now possible to use jpy Java API to work with multiple Python installations (issue #35).
A tool called 'jpyutil.py' can be used to write configuration files that determine the required shared libraries
for a given Python versions.
A new Java system property 'jpy.config' is used to point to a desired configuration file.
* Simplified jpy installation (issue #15):
- removed need to add JVM path to PATH (Windows) / LD_LIBRARY_PATH (Unix) environment variable
- removed need to compile Java module using Maven
- removed need to specify JDK_HOME environment variable, if JAVA_HOME already points to a JDK
* Added 'jclass' attribute to Python type that wraps a Java class (issue #63) .
* Java API extensions
- new jpy.org.PyObject.executeCode() methods
- new jpy.org.PyModule.getBuiltins() method
- new jpy.org.PyModule.getMain() method
- new jpy.org.PyModule.extendSysPath() method
* Java API configuration changes:
- System property jpy.jpyLib:
- System property jpy.jdlLib:
- System property jpy.pythonLib:
- System property jpy.config:
- Loaded from
# File ./jpyconfig.properties
# Resource /jpyconfig.properties
# File ${jpy.config}
* Python API configuration changes:
- Loaded from
# File ./jpyconfig.py
# Resource ${jpy-module}/jpyconfig.py
- Attribute java_home
- Attribute jvm_dll
* Python API extensions
- new jpyutil module
# jpyutil.init_jvm(...)
# jpyutil.preload_jvm_lib(...)
- new jpyutil tool
# usage: jpyutil.py [-h] [--out OUT] [--java_home JAVA_HOME] [--jvm_dll JVM_DLL]
* Added basic support for Java Scripting Engine API (issue #53)

Other changes
-------------
* Switched to Apache 2.0 license from version 0.8 and later (issue #60)


Version 0.7.5
=============

* Fixed bad pointer in C-code which caused unpredictable crashes (issue #43)


Version 0.7.4
=============

* Fixed a problem where jpy crashes with unicode arguments (issue #42)
* Fixed segmentation fault occurring occasionally during installation of jpy (issue #40)
* Improved Java exception messages on Python errors (issue #39)


Version 0.7.3
=============

* Fixed problem where a Java primitive array argument has occasionally not been initialised by a
related Python buffer argument (issue #37)


Version 0.7.2
=============

* Added backward compatibility with Python 2.7 (issue #34).
* Added Java parameter annotation 'output' (issue #36).
This is used to optimise passing Python buffer arguments where Java primitive arrays are expected.
* Removed debugging prints of the form "JNI_OnLoad: ..."
* Corrected documentation of jpy.array(type, init) function, which was said to be jpy.array(type, length)
* Removed console dumps that occurred when calling from Java proxies into Python
* Updated Java API documentation and added it to Sphinx doc folder (doc/_static/java-apidoc)
* Added new diagnostic F_ERR flag to Java class PyLib.Diag
* Java class PyLib is no longer instantiable


Version 0.7.1
=============

* Updated README and added MANIFEST.in after recognising that the jpy-0.7.zip distribution misses most of the
required source files and learning what to do on this case.


Version 0.7
===========

* Initial version.



Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

illumon_jpy-1.20180430.24-cp27-cp27m-win_amd64.whl (102.7 kB view details)

Uploaded CPython 2.7mWindows x86-64

illumon_jpy-1.20180430.24-cp27-cp27m-macosx_10_13_x86_64.whl (102.2 kB view details)

Uploaded CPython 2.7mmacOS 10.13+ x86-64

File details

Details for the file illumon_jpy-1.20180430.24-cp27-cp27m-win_amd64.whl.

File metadata

File hashes

Hashes for illumon_jpy-1.20180430.24-cp27-cp27m-win_amd64.whl
Algorithm Hash digest
SHA256 2f8862c845903d451890d4d5246da77e7a825414350a06ac8516f66625cb5dd2
MD5 139defd844440a662140e1836532a6f1
BLAKE2b-256 8b2c5af899fd07ab11dc219b3c989debe2eedcae7dbfc58027dca2255add19ed

See more details on using hashes here.

File details

Details for the file illumon_jpy-1.20180430.24-cp27-cp27m-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for illumon_jpy-1.20180430.24-cp27-cp27m-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 ade8255a63dbdae070c213d0aa701fe06c0263de6938a7a6cf8e87d941e45ccf
MD5 49863926fa220d537e0b8570698c01f7
BLAKE2b-256 e42a32888ccc360b85abdf435963513fd2b6931df4966d3a43a308a4e5eaa3bb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page