{"action":"created","comment":{"url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/comments/183669042","pull_request_review_id":114703668,"id":183669042,"diff_hunk":"@@ -1,2 +1,162 @@\n # VSCode IoT.js Debug\n IoT.js and JerryScript debug adapter for Visual Studio Code.\n+\n+- [Introduction](#introduction)\n+- [Features](#features)\n+- [Requirements](#requirements)\n+- [How to start](#how-to-start)\n+- [How to use](#how-to-use)\n+- [License](#license)\n+\n+# Introduction\n+`IoT.js Debug` is a debugger exetension for [Visual Studio Code](https://code.visualstudio.com/) that lets you debug the code which is running on a device and lets you upload your code to the device, directly from the VSCode over websocket communication.\n+\n+# Features\n+Available Control commands:\n+- Continue command\n+- Pause command\n+- Step-over command\n+- Step-in command\n+- Step-out command\n+- Disconnect command\n+\n+Available features:\n+- Call stack display\n+- Handle source receive from the engine\n+\n+Currently in Progress features or commands:\n+- Set/Remove breakpoint\n+- Source sending to the engine\n+- Watch (evaluate expression)\n+\n+# Requirements\n+- The latest Vscode which is available [here](https://code.visualstudio.com/Download).\n+- An [IoT.js](https://github.com/Samsung/iotjs) or a [JerryScript](https://github.com/jerryscript-project/jerryscript) as an engine to run your code.\n+\n+- (For development) Requires [node.js](https://nodejs.org/en/) v8.x.x or higher (latest one is recommended) and [npm](https://www.npmjs.com) 5.x.x or higher to be able to work properly.\n+\n+# How to start\n+Getting the sources:\n+\n+```sh\n+# Clone the repository to your local drive:\n+$ git clone https://github.com/knightburton/vscode-iotjs-debug\n+\n+# Move into the directory\n+$ cd vscode-iotjs-debug\n+```\n+\n+The project requires node.js to build, the best way to install the node and the npm is the nvm (Node Version Manager):\n+\n+```sh\n+# Install the latest nvm with the following command\n+$ curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.9/install.sh | bash\n+\n+# Reload your .bashrc\n+$ source ~/.bashrc\n+```\n+\n+Use the proper node.js and node package manager version:\n+```sh\n+# Install the latest node.js and npm with the nvm tool\n+$ nvm install 9\n+\n+# If you have already installed the node.js and npm then make sure you are using the right version in the project folder\n+$ nvm use 9\n+```\n+\n+Install the project dependencies:\n+```sh\n+npm install\n+```\n+\n+For the first time you have to build the project to be able to start the extension host, this will build the project into the `out` folder:\n+```sh\n+npm run compile\n+```\n+\n+To start the extension you have to open the project in the VSCode and you have to navigate to the Debug view (Ctrl+Shift+D).\n+At the top of the debug panel you have to select the `Extension` option from the dropdown menu if you want to run the extension (or you have to select the `Extension Test` if you want to run the unit tests).\n+After you selected the `Extension` option you can start the debug session by pressing the `F5` key or click to the green triangle shaped button next to the dropdown menu.\n+This debug session will open up a new VSCode (Extension host) where our extension is installed and available.\n+\n+**Note:** When the extension host window is opened you do not have to rebuild the project if you make any changes on the code because of the vscode will automatically do that, only thing you have to do is restart the main debug session in the main vscode window by hit the restart button in the debug action bar or press the Ctrl+Shift+F5 key combination.\n+\n+# How to use\n+After the extension is running in the extension host window you have to open (or create a new) project folder where you have to define a `launch.json` configuration file inside the `.vscode` folder. In case of IoT.js Debug this configuration looks like this:\n+\n+```json\n+{\n+  \"version\": \"0.2.0\",\n+  \"configurations\": [\n+    {\n+      \"name\": \"IoT.js: Attach\",\n+      \"type\": \"iotjs\",\n+      \"request\": \"attach\",\n+      \"address\": \"localhost\",\n+      \"port\": 5001,\n+      \"localRoot\": \"${workspaceRoot}\",\n+      \"stopOnEntry\": false,\n+      \"debugLog\": true\n+    },\n+  ]\n+}\n+```\n+\n+Now you can connect to a running engine.\n+If you are using the IoT.js you have to do the following:\n+\n+```sh\n+# Open up a new terminal window and navigate into the IoT.js root folder\n+$ cd path/to/the/iotjs\n+\n+# Build the IoT.js with the following switches\n+$ ./tools/build.py --buildtype=debug --jerry-debugger\n+\n+# If you want to debug the IoT.js javascript modules\n+# then you have to turn off the snapshot in the IoT.js build\n+$ ./tools/build.py --buildtype=debug --jerry-debugger --no-snapshot\n+\n+# Run the IoT.js with the following switches\n+$ ./build/x86_64-linux/debug/bin/iotjs --start-debug-server {file}\n+\n+# To run with diferent port (the default is 5001)\n+$ ./build/x86_64-linux/debug/bin/iotjs --start-debug-server --jerry-debugger-port={number} {file}\n+\n+# To run with show opcodes\n+$ ./build/x86_64-linux/debug/bin/iotjs --start-debug-server --show-opcodes {file}\n+\n+# To run with source waiting mode (allows the on-the-fly source code sending)\n+# NOTE: This is not fully supported for now\n+$ ./build/x86_64-linux/debug/bin/iotjs --start-debug-server --debugger-wait-source\n+```\n+\n+If you are using only the JerryScript you have to do the following:","path":"README.md","position":134,"original_position":134,"commit_id":"be05bb48d06dc375358cd76d99f5b0e142f7a0ef","original_commit_id":"be05bb48d06dc375358cd76d99f5b0e142f7a0ef","user":{"login":"tdusnoki","id":32192767,"avatar_url":"https://avatars2.githubusercontent.com/u/32192767?v=4","gravatar_id":"","url":"https://api.github.com/users/tdusnoki","html_url":"https://github.com/tdusnoki","followers_url":"https://api.github.com/users/tdusnoki/followers","following_url":"https://api.github.com/users/tdusnoki/following{/other_user}","gists_url":"https://api.github.com/users/tdusnoki/gists{/gist_id}","starred_url":"https://api.github.com/users/tdusnoki/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tdusnoki/subscriptions","organizations_url":"https://api.github.com/users/tdusnoki/orgs","repos_url":"https://api.github.com/users/tdusnoki/repos","events_url":"https://api.github.com/users/tdusnoki/events{/privacy}","received_events_url":"https://api.github.com/users/tdusnoki/received_events","type":"User","site_admin":false},"body":"no \"the\" is necessary before JerryScript IMHO","created_at":"2018-04-24T09:47:30Z","updated_at":"2018-04-24T09:52:42Z","html_url":"https://github.com/knightburton/vscode-iotjs-debug/pull/16#discussion_r183669042","pull_request_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/16","author_association":"CONTRIBUTOR","_links":{"self":{"href":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/comments/183669042"},"html":{"href":"https://github.com/knightburton/vscode-iotjs-debug/pull/16#discussion_r183669042"},"pull_request":{"href":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/16"}}},"pull_request":{"url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/16","id":183674524,"html_url":"https://github.com/knightburton/vscode-iotjs-debug/pull/16","diff_url":"https://github.com/knightburton/vscode-iotjs-debug/pull/16.diff","patch_url":"https://github.com/knightburton/vscode-iotjs-debug/pull/16.patch","issue_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/issues/16","number":16,"state":"open","locked":false,"title":"Update the README.md","user":{"login":"knightburton","id":12102205,"avatar_url":"https://avatars0.githubusercontent.com/u/12102205?v=4","gravatar_id":"","url":"https://api.github.com/users/knightburton","html_url":"https://github.com/knightburton","followers_url":"https://api.github.com/users/knightburton/followers","following_url":"https://api.github.com/users/knightburton/following{/other_user}","gists_url":"https://api.github.com/users/knightburton/gists{/gist_id}","starred_url":"https://api.github.com/users/knightburton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/knightburton/subscriptions","organizations_url":"https://api.github.com/users/knightburton/orgs","repos_url":"https://api.github.com/users/knightburton/repos","events_url":"https://api.github.com/users/knightburton/events{/privacy}","received_events_url":"https://api.github.com/users/knightburton/received_events","type":"User","site_admin":false},"body":"IoT.js-Debug-DCO-1.0-Signed-off-by: Imre Kiss kissi.szeged@partner.samsung.com","created_at":"2018-04-24T09:31:48Z","updated_at":"2018-04-24T09:52:42Z","closed_at":null,"merged_at":null,"merge_commit_sha":"2a819636eecd70246ce91ebab047814ea3fa83c6","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/16/commits","review_comments_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/16/comments","review_comment_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/comments{/number}","comments_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/issues/16/comments","statuses_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/statuses/be05bb48d06dc375358cd76d99f5b0e142f7a0ef","head":{"label":"knightburton:readme","ref":"readme","sha":"be05bb48d06dc375358cd76d99f5b0e142f7a0ef","user":{"login":"knightburton","id":12102205,"avatar_url":"https://avatars0.githubusercontent.com/u/12102205?v=4","gravatar_id":"","url":"https://api.github.com/users/knightburton","html_url":"https://github.com/knightburton","followers_url":"https://api.github.com/users/knightburton/followers","following_url":"https://api.github.com/users/knightburton/following{/other_user}","gists_url":"https://api.github.com/users/knightburton/gists{/gist_id}","starred_url":"https://api.github.com/users/knightburton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/knightburton/subscriptions","organizations_url":"https://api.github.com/users/knightburton/orgs","repos_url":"https://api.github.com/users/knightburton/repos","events_url":"https://api.github.com/users/knightburton/events{/privacy}","received_events_url":"https://api.github.com/users/knightburton/received_events","type":"User","site_admin":false},"repo":{"id":129362613,"name":"vscode-iotjs-debug","full_name":"knightburton/vscode-iotjs-debug","owner":{"login":"knightburton","id":12102205,"avatar_url":"https://avatars0.githubusercontent.com/u/12102205?v=4","gravatar_id":"","url":"https://api.github.com/users/knightburton","html_url":"https://github.com/knightburton","followers_url":"https://api.github.com/users/knightburton/followers","following_url":"https://api.github.com/users/knightburton/following{/other_user}","gists_url":"https://api.github.com/users/knightburton/gists{/gist_id}","starred_url":"https://api.github.com/users/knightburton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/knightburton/subscriptions","organizations_url":"https://api.github.com/users/knightburton/orgs","repos_url":"https://api.github.com/users/knightburton/repos","events_url":"https://api.github.com/users/knightburton/events{/privacy}","received_events_url":"https://api.github.com/users/knightburton/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/knightburton/vscode-iotjs-debug","description":"IoT.js debug adapter for Visual Studio Code","fork":false,"url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug","forks_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/forks","keys_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/keys{/key_id}","collaborators_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/teams","hooks_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/hooks","issue_events_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/issues/events{/number}","events_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/events","assignees_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/assignees{/user}","branches_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/branches{/branch}","tags_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/tags","blobs_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/git/refs{/sha}","trees_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/git/trees{/sha}","statuses_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/statuses/{sha}","languages_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/languages","stargazers_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/stargazers","contributors_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/contributors","subscribers_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/subscribers","subscription_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/subscription","commits_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/commits{/sha}","git_commits_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/git/commits{/sha}","comments_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/comments{/number}","issue_comment_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/issues/comments{/number}","contents_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/contents/{+path}","compare_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/compare/{base}...{head}","merges_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/merges","archive_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/downloads","issues_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/issues{/number}","pulls_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls{/number}","milestones_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/milestones{/number}","notifications_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/labels{/name}","releases_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/releases{/id}","deployments_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/deployments","created_at":"2018-04-13T07:03:44Z","updated_at":"2018-04-24T09:51:13Z","pushed_at":"2018-04-24T09:51:12Z","git_url":"git://github.com/knightburton/vscode-iotjs-debug.git","ssh_url":"git@github.com:knightburton/vscode-iotjs-debug.git","clone_url":"https://github.com/knightburton/vscode-iotjs-debug.git","svn_url":"https://github.com/knightburton/vscode-iotjs-debug","homepage":null,"size":109,"stargazers_count":0,"watchers_count":0,"language":"TypeScript","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":2,"mirror_url":null,"archived":false,"open_issues_count":1,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0"},"forks":2,"open_issues":1,"watchers":0,"default_branch":"master"}},"base":{"label":"knightburton:master","ref":"master","sha":"33854b8229a84a160bf11c1881f30e5907309935","user":{"login":"knightburton","id":12102205,"avatar_url":"https://avatars0.githubusercontent.com/u/12102205?v=4","gravatar_id":"","url":"https://api.github.com/users/knightburton","html_url":"https://github.com/knightburton","followers_url":"https://api.github.com/users/knightburton/followers","following_url":"https://api.github.com/users/knightburton/following{/other_user}","gists_url":"https://api.github.com/users/knightburton/gists{/gist_id}","starred_url":"https://api.github.com/users/knightburton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/knightburton/subscriptions","organizations_url":"https://api.github.com/users/knightburton/orgs","repos_url":"https://api.github.com/users/knightburton/repos","events_url":"https://api.github.com/users/knightburton/events{/privacy}","received_events_url":"https://api.github.com/users/knightburton/received_events","type":"User","site_admin":false},"repo":{"id":129362613,"name":"vscode-iotjs-debug","full_name":"knightburton/vscode-iotjs-debug","owner":{"login":"knightburton","id":12102205,"avatar_url":"https://avatars0.githubusercontent.com/u/12102205?v=4","gravatar_id":"","url":"https://api.github.com/users/knightburton","html_url":"https://github.com/knightburton","followers_url":"https://api.github.com/users/knightburton/followers","following_url":"https://api.github.com/users/knightburton/following{/other_user}","gists_url":"https://api.github.com/users/knightburton/gists{/gist_id}","starred_url":"https://api.github.com/users/knightburton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/knightburton/subscriptions","organizations_url":"https://api.github.com/users/knightburton/orgs","repos_url":"https://api.github.com/users/knightburton/repos","events_url":"https://api.github.com/users/knightburton/events{/privacy}","received_events_url":"https://api.github.com/users/knightburton/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/knightburton/vscode-iotjs-debug","description":"IoT.js debug adapter for Visual Studio Code","fork":false,"url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug","forks_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/forks","keys_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/keys{/key_id}","collaborators_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/teams","hooks_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/hooks","issue_events_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/issues/events{/number}","events_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/events","assignees_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/assignees{/user}","branches_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/branches{/branch}","tags_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/tags","blobs_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/git/refs{/sha}","trees_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/git/trees{/sha}","statuses_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/statuses/{sha}","languages_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/languages","stargazers_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/stargazers","contributors_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/contributors","subscribers_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/subscribers","subscription_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/subscription","commits_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/commits{/sha}","git_commits_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/git/commits{/sha}","comments_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/comments{/number}","issue_comment_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/issues/comments{/number}","contents_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/contents/{+path}","compare_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/compare/{base}...{head}","merges_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/merges","archive_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/downloads","issues_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/issues{/number}","pulls_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls{/number}","milestones_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/milestones{/number}","notifications_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/labels{/name}","releases_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/releases{/id}","deployments_url":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/deployments","created_at":"2018-04-13T07:03:44Z","updated_at":"2018-04-24T09:51:13Z","pushed_at":"2018-04-24T09:51:12Z","git_url":"git://github.com/knightburton/vscode-iotjs-debug.git","ssh_url":"git@github.com:knightburton/vscode-iotjs-debug.git","clone_url":"https://github.com/knightburton/vscode-iotjs-debug.git","svn_url":"https://github.com/knightburton/vscode-iotjs-debug","homepage":null,"size":109,"stargazers_count":0,"watchers_count":0,"language":"TypeScript","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":2,"mirror_url":null,"archived":false,"open_issues_count":1,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0"},"forks":2,"open_issues":1,"watchers":0,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/16"},"html":{"href":"https://github.com/knightburton/vscode-iotjs-debug/pull/16"},"issue":{"href":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/issues/16"},"comments":{"href":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/issues/16/comments"},"review_comments":{"href":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/16/comments"},"review_comment":{"href":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/pulls/16/commits"},"statuses":{"href":"https://api.github.com/repos/knightburton/vscode-iotjs-debug/statuses/be05bb48d06dc375358cd76d99f5b0e142f7a0ef"}},"author_association":"OWNER"}}
{"actor":{"display_login":"tdusnoki"}}