Skip to content

Latest commit

 

History

History
 
 

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

DynamicJava

DynamicJava is a REPL for Java code.

IPython Kernel

DynamicJava includes a built-in IPython kernel. The kernel enables execution of Java code in the IPython terminal application as well as in its web based notebook interface.

Prerequisites

  1. Install IPython. It can be installed using pip with pip install ipython or through your package manager.

  2. Create a new IPython profile for DynamicJava. Run ipython profile create dynamicjava. This will create a new IPython profile in .ipython/profile_dynamicjava.

  3. Configure the new profile to run the DynamicJava kernel. Copy the following lines into .ipython/profile_dynamicjava/ipython_config.py, replacing DYNAMICJAVA_PATH with the file path of dynamicjava.jar. Any additional arguments to the JVM should be passed here.

    c.KernelManager.kernel_cmd = [
        "java",
        "-jar", "DYNAMICJAVA_PATH",
        "-kernel", "{connection_file}"
    ]
    c.Session.key = b''
    c.Session.keyfile = b''
    
  4. (Optional) To debug the kernel while it is running, add the following line to the kernel_cmd list.

    "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=1044",
    

    To use the debugger, follow the instructions to configure remote debugging for your IDE (Eclipse, IntelliJ)

  5. Configure the IPython Notebook Java syntax highlighting. Copy the files in profile/static/custom/ to .ipython/profile_dynamicjava/static/custom/.

Building and Running

  • To build the kernel, run ant jar.
  • The IPython console frontend can be run with ipython console --profile dynamicjava.
  • To run the web interface, run ipython notebook --profile dynamicjava.