lablup / atom-live-code-runner

ATOM package to run code snippets using Sorna API server

live-code-runner

ATOM editor package to run code snippets via Backend.AI Cloud server (https://cloud.backend.ai) or on-premise Backend.AI server.

Description

live-code-runner is ATOM editor package to add remote code execution feature using Backend.AI Cloud Service. live-code-runner uses Backend.AI framework and Backend.AI API. Currently, Backend.AI supports 15 programming languages now.

You can run your code (or code snippet) without installing or setting any programming environment with this package. All you need to run code is

• Install live-code-runner package.
• Get Backend.AI Cloud API access / secret key at Backend.AI Cloud
• Type your keys on package preferences page.
• You are ready to go!

<iframe width="853" height="480" src="https://www.youtube.com/embed/IVX1SClEaMY" frameborder="0" allowfullscreen></iframe>

How-to

1. Search and install live-code-runner via preferences - install.
2. Get your own API key pair (API key / Secret key) at Backend.AI Cloud Service. If you have set up your own Backend.AI on-premise server, you can your own server endpoint and API key set.
3. Type your API key pair on preferences page (preferences - packages - live-code-runner)
4. Write your code on editor.
5. Run code by

• Choose Run code on Backend.AI Cloud at context menu
• Type backend and choose live-code-runner: Run at command palette.

6. Execution result will be shown at bottom pane.

Supporting modes

Here we list the latest versions of our supported kernel iamges.
"*" in the Query mode column means that it supports preservation of global contexts across different query runs.

Language	Image Name	Version	Batch	Query	Input Hook	TTY	Runtime Impl.
C	lablup/kernel-c	6.3	O	O	O		GCC on Alpine 3.6
C++ (14)	lablup/kernel-cpp	6.3	O	O			GCC on Alpine 3.6
Go	lablup/kernel-go	1.9	O	O
Haskell	lablup/kernel-haskell	8.2	O	O
Java	lablup/kernel-java	8.0	O	O
Linux Console	lablup/kernel-git	-	-	-	-	O	Bash on Alpine 3.6
Lua	lablup/kernel-lua	5.3	O	O
Node.js	lablup/kernel-nodejs	6.11	O	O
Octave	lablup/kernel-octave	4.2	O	O
Python	lablup/kernel-python	2.7	O	O	O		temporarily unsupported
Python	lablup/kernel-python	3.6	O	O*	O
Rust	lablup/kernel-rust	1.17	O	O
PHP	lablup/kernel-php	7.1	O	O
R	lablup/kernel-r	3.3	O	O			CRAN R

Deep-Learning Framework	Image Name	Version	Batch	Query	Input Hook	TTY	Runtime Impl.
TensorFlow	lablup/kernel-python-tensorflow	1.8-1.3	O	O*	O		Bundled w/Keras 2
PyTorch	lablup/kernel-python-torch	2.0-0.2	O	O*	O
Theano	lablup/kernel-python-theano	1.0	O	O*	O		Bundled w/Keras 2
CNTK	lablup/kernel-python-cntk	(WIP)	O	O*	O		Bundled w/Keras 2

Languages (to be ready soon)

• Swift (via Swift opensource version)

Working

• Multi-file support (is already supported via CLI, but not in JavaScript SDK yet.)
• Virtual Folder mount / navigation (is already supported via CLI, but not in JavaScript SDK yet.)

Troubleshooting

1. My language is not recognized

• Make sure that language name of your code is correctly recognized by ATOM. You can see the grammar of current editor at the right side of bottom bar. If your language is not supported by ATOM, please install language support packages. For instance, install language-r package to add R language support.

atom-live-code-runner's Issues

Enable Theano support

• Theano instances are ready. Let's enable Theano support.

Pckg rename to/add 'Backend.AI'

We need to rename pckg to let users search with keyword 'backend', 'Backend.AI'.

Having trouble entering API keys

How do you enter the API key?

Plugin Totally Not Working & I gives me this error..

[Enter steps to reproduce:]

1. ...
2. ...

Atom: 1.57.0 ia32
Electron: 9.4.4
OS: Microsoft Windows 10 Education
Thrown From: live-code-runner package 5.3.0

Stack Trace

Failed to load the live-code-runner package

At Cannot find module 'C:\Users\Hansana\.atom\packages\live-code-runner\node_modules\backend.ai-client\backend.ai-client.js'. Please verify that the package.json has a valid "main" entry

Error: Cannot find module 'C:\Users\Hansana\.atom\packages\live-code-runner\node_modules\backend.ai-client\backend.ai-client.js'. Please verify that the package.json has a valid "main" entry
    at tryPackage (internal/modules/cjs/loader.js:301:19)
    at Function.Module._findPath (internal/modules/cjs/loader.js:532:18)
    at Module._resolveFilename (internal/modules/cjs/loader.js:784:27)
    at o._resolveFilename (electron/js2c/renderer_init.js:43:689)
    at Function.get_Module._resolveFilename (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:157820)
    at Module.require (/app.asar/static/index.js:61:43)
    at require (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:149153)
    at /packages/live-code-runner/lib/live-code-runner.js:11:28)
    at /packages/live-code-runner/lib/live-code-runner.js:420:2)
    at Module.get_Module._compile (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:149837)
    at Object.value [as .js] (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:153385)
    at Module.load (internal/modules/cjs/loader.js:815:32)
    at Module._load (internal/modules/cjs/loader.js:727:14)
    at Function.Module._load (electron/js2c/asar.js:769:28)
    at Module.require (/app.asar/static/index.js:72:46)
    at require (internal/modules/cjs/helpers.js:74:18)
    at customRequire (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:1:802772)
    at requireModule (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:14:1191588)
    at Package.requireMainModule (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:3520819)
    at ~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:3507359
    at Package.measure (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:3506159)
    at Package.load (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:3506932)
    at PackageManager.loadAvailablePackage (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:384071)
    at PackageManager.loadPackage (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:382799)
    at PackageManager.activatePackage (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:385371)
    at ~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:914488
    at r (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:11:909094)
    at n (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:14:1190911)
    at ChildProcess.<anonymous> (~/AppData/Local/atom/app-1.57.0/resources/app/static/<embedded>:14:1191117)
    at ChildProcess.emit (events.js:223:5)

Commands

Non-Core Packages

live-code-runner 5.3.0 

Console view for progress message

• Console view for progress message
• Reduce the notifications
• New workflow: run → open console → print progress on console

Inline I/O support

• Inline I/O support

Migrate to official backend.ai node library

• Migrate to official backend.ai node library ( https://github.com/lablup/backend.ai-client-js )

kernel indicator on result pane

• kernel indicator on result pane
• for better working ui

Randomize session identifier

• Backend.AI 1.0.X has bug with session identifier handling (resolved in 1.1.0)
• Let editor support randomize session identifier to avoid the bug with Backend.AI 1.0.X

README.md for package description

• README.md for package description

V2 API support

• Let live code runner support V2 API.
• V2 API adds
• inline I/O
• Multi-type sequential output
• stop / start / waiting support

Add link to sorna cloud API site for API key creation

• Add link to sorna cloud API site for API key creation

stderr handler is not working

• Although stderr is given from server, error output does not work now.
• After printing error messages, code runner flushes error messages.

Customizable API key store

• Customizable API key storage and UI

Elapsed time gauge

• Elapsed time gauge (like modern IDEs)

Failed to load the live-code-runner package

Cannot find module 'C:\Users\Hansana.atom\packages\live-code-runner\node_modules\backend.ai-client\backend.ai-client.js'. Please verify that the package.json has a valid "main" entry

Error: Cannot find module 'C:\Users\Hansana.atom\packages\live-code-runner\node_modules\backend.ai-client\backend.ai-client.js'. Please verify that the package.json has a valid "main" entry
at tryPackage (internal/modules/cjs/loader.js:301:19)
at Function.Module._findPath (internal/modules/cjs/loader.js:532:18)
at Module._resolveFilename (internal/modules/cjs/loader.js:784:27)
at o._resolveFilename (electron/js2c/renderer_init.js:43:689)
at Function.get_Module._resolveFilename (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:157820)
at Module.require (file:///C:/Users/Hansana/AppData/Local/atom/app-1.57.0/resources/app.asar/static/index.js:61:43)
at require (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:149153)
at Object. (file:///C:/Users/Hansana/.atom/packages/live-code-runner/lib/live-code-runner.js:11:28)
at Object. (file:///C:/Users/Hansana/.atom/packages/live-code-runner/lib/live-code-runner.js:420:2)
at Module.get_Module._compile (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:149837)
at Object.value [as .js] (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:153385)
at Module.load (internal/modules/cjs/loader.js:815:32)
at Module._load (internal/modules/cjs/loader.js:727:14)
at Function.Module._load (electron/js2c/asar.js:769:28)
at Module.require (file:///C:/Users/Hansana/AppData/Local/atom/app-1.57.0/resources/app.asar/static/index.js:72:46)
at require (internal/modules/cjs/helpers.js:74:18)
at customRequire (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:1:802772)
at requireModule (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:14:1191588)
at Package.requireMainModule (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:3520819)
at C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:3507359
at Package.measure (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:3506159)
at Package.load (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:3506932)
at PackageManager.loadAvailablePackage (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:384071)
at PackageManager.loadPackage (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:382799)
at PackageManager.activatePackage (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:385371)
at C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:914488
at r (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:11:909094)
at n (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:14:1190911)
at ChildProcess. (C:\Users\Hansana\AppData\Local\atom\app-1.57.0\resources\app\static<embedded>:14:1191117)
at ChildProcess.emit (events.js:223:5)

result panel to be side-by-side

• result panel to be side-by-side
• bottom panel shows log, progress and messages
• result panel shows result including text, image, etc.

UI for code execution result

• UI for code execution result

Create appropriate code id hash

• Create appropriate code id hash
• It is not mandatory for now. However, we need to change from "test"

Modify continuation / input call to support V3 version

• Modify continuation / input call to support V3 version

Rewrite coffeescript into javascript ES6

• Rewrite coffeescript into javascript ES6
• For code compatibility with general javascript applications

Separate Sorna API Library

• Separate Sorna API Library
• Create reusuable javascript API library

Update to support backend.ai

• Update to support backend.ai cloud service.

Automatic language selection code

• Automatic language selection code
• Use it to create / refresh kernel\

Requirements

• Read language information from Atom
• Find special cases for kernel (e.g. TensorFlow written in Python)

Initialize / test ATOM package structure

• Initialize / test ATOM package structure
• Have to learn Coffeescript? T_T

GNU Octave support

• Octave language support

Package renaming

• Package renaming from sorna-code-runner to atom-live-code-runner

Code transfer routine via XHR

• Code transfer routine via XHR
• Uses API key pair to authorize