Installation and testing

Install using pip

python -m pip install numpy  # not mandatory but highly recommended
python -m pip install jtypes.javabridge

Install without pip

# Make sure numpy is installed (not mandatory but highly recommended)
python setup.py install

Dependencies

The jtypes.javabridge requires Python 2.7 or above, NumPy (not mandatory but highly recommended) and the Java Runtime Environment (JRE) (a C compiler is not required).

Linux

On CentOS 6, the dependencies can be installed as follows:

yum install gcc numpy java-1.7.0-openjdk-devel
curl -O https://raw.github.com/pypa/pip/master/contrib/get-pip.py
python get-pip.py

On Fedora 19, the dependencies can be installed as follows:

yum install gcc numpy java-1.7.0-openjdk-devel python-pip openssl

On Ubuntu 13, 14 and Debian 7, the dependencies can be installed as follows:

apt-get install openjdk-7-jdk python-pip python-numpy

On Arch Linux, the dependencies can be installed as follows:

pacman -S jdk7-openjdk python2-pip python2-numpy base-devel

MacOS X

  1. Install the Xcode command-line tools. There are two ways:
    1. Install Xcode from the Mac App Store. (You can also download it from Apple’s Mac Dev Center, but that may require membership in the Apple Developer Program.) Install the Xcode command-line tools by starting Xcode, going to Preferences, click on “Downloads” in the toolbar, and click the “Install” button on the line “Command Line Tools.” For MacOS 10.9 and Xcode 5 and above, you may have to install the command-line tools by typing xcode-select --install and following the prompts.
    2. Download the Xcode command-line tools from Apple’s Mac Dev Center and install. This may require membership in the Apple Developer Program.
  2. Create and activate a virtualenv virtual environment if you don’t want to clutter up your system-wide python installation with new packages.
  3. python -m pip install numpy # not mandatory but highly recommended
  4. python -m pip install jtypes.javabridge

Windows

If you do not have a C compiler installed, you can install Microsoft Visual C++ Build Tools to perform the compile steps. The compiler installation can be found in https://visualstudio.microsoft.com/visual-cpp-build-tools/.

You should install a Java Development Kit (JDK) appropriate for your Java project. The Windows build is tested with the Oracle JDK 1.7. You also need to install the Java Runtime Environment (JRE). Note that the bitness needs to match your python: if you use a 32-bit Python, then you need a 32-bit JRE; if you use a 64-bit Python, then you need a 64-bit JRE.

The paths to PIP and Python should be in your PATH (set PATH=%PATH%;c:\\Python27;c:\\Python27\\scripts if Python and PIP installed to the default locations). The following steps should perform the install:

  1. Run Command Prompt as administrator. Set the path to Python and PIP if needed.

  2. Issue the command:

    python -m pip install jtypes.javabridge
    

Running the unit tests

Running the unit tests requires Nose. Some of the tests require Python 2.7 or above.

  1. Build and install in the source code tree so that the unit tests can run:

    python setup.py develop
    
  2. Run the unit tests:

    python -m jt.javabridge.tests
    

You must build the extensions in-place on Windows, then run tests if you use setup to run the tests:

python setup.py build_ext -i
python setup.py tests

See the section Unit testing for how to run unit tests for your own projects that use jtypes.javabridge.