Devdays Осень 2017/jupyter kernel

Описание

Работающий Jupyter kernel for java lang

Технологии: Python, Java

Ссылка на репозиторий

Видео

Состав команды

• Антон Егоров — автоматическая сборка и установка, история команд /history.
• Зубаков Алексей — руководитель проекта, Java составляющая ядра(обертка JShell на Java).
• Калинин Владислав — Java и Python составляющие ядра(Kernel на Python, java2py bridge, вывод переменных/методов: /vars, /methods).

Features

• Исполнение java кода
• История команд
• autocomplete(по возможности)

Функциональность

• Запланировано и сделано:

   * минимальный рабочий java kernel для jupyter без дополнительных фичей
   * фичи jshell внутри jupyter notebookl (/vars, /methods, etc.)
   * автоматическая установка и сборка
   * вывод ошибок
   * автокомплит    

• Запланировано и не сделано:

   * связь с jshell напрямую из python

• Не запланировани и сделано:

   * установка связи с jshell через java classes
   * простейший парсинг java сниппетов
   

Как запустить

Инструкция есть в репозитории

В вашей системе уже должен быть установлен Jupyter.

Запустите установочный скрипт

sudo ./setup.py install

Лучше дать ему привилегии. Скрипт попытается вызвать команду jupyter kernelspec list, и если хоть одно ядро уже подключено к Jupyter-у, то скрипт узнает путь, куда нужно скопировать необходимые для запуска Java-ядра файлы. Если это сделать не получится, то будет предложено вручную ввести путь к папке, в которой Jupyter узнаёт информацию о ядрах. Например, это может быть путь /usr/local/share/jupyter/kernels. Также скрипт должен проверить наличие и при необходимости установить библиотеку py4j для Python. Если установка прошла успешно, то запустить Jupyter с Java-ядром можно командой

jupyter console --kernel java

В числе файлов в репозитории есть файл java_src/target/jserver.jar, включающий в себя Java-составляющую ядра. Пересобрать его, при необходимости, можно выполнив команду

mvn clean install

в папке java_src.

Buglist

• Не ругается на ошибку вида System.out.println(10
• Не ругается на незакрытый многострочный комментарий /*
• Графики выводятся не в самом ноутбуке, а в отдельном окне
• Автокомплит не работает внутри вложенных конструкций
• Не всегда корректно подсвечивается синтаксис java в браузере
• Не убивается процесс с java при экстренном завершении