{"action":"created","comment":{"url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/comments/91435142","pull_request_review_id":11943041,"id":91435142,"diff_hunk":"@@ -16,14 +16,45 @@\n \n 'use strict';\n \n-// NOTE: this file is on the critical path for the startup of the user's\n-// application. The path-length here needs to be minimal.\n-\n var logger = require('@google/cloud-diagnostics-common').logger;\n-var Debuglet = require('./lib/debuglet.js');\n+var Debuglet = require('./debuglet.js');\n var path = require('path');\n var _ = require('lodash');\n \n+/**\n+ * <p class=\"notice\">\n+ *   **This is an experimental release of Stackdriver Debug.** This API is not \n+ *   covered by any SLA of deprecation policy and may be subject to backwards\n+ *   incompatible changes.\n+ * </p>\n+ * \n+ * This module provides Stackdriver Debugger support for Node.js applications. \n+ * [Stackdriver Debugger](https://cloud.google.com/debug/) is a feature of \n+ * [Google Cloud Platform](https://cloud.google.com/) that lets you debug your\n+ * applications in production without stopping or pausing your application.\n+ * \n+ * This module provides an agent that lets you automatically enable debugging\n+ * without changes to your application. \n+ * \n+ * A low level Client Library for the Debug will also be available through\n+ * this module, but is not present at the moment.\n+ * \n+ * @constructor\n+ * @alias module:debug","path":"src/index.js","position":32,"original_position":32,"commit_id":"1e996bb91ec72cdbaa945dc92fc900c1b7f972d5","original_commit_id":"1e996bb91ec72cdbaa945dc92fc900c1b7f972d5","user":{"login":"matthewloring","id":1485909,"avatar_url":"https://avatars.githubusercontent.com/u/1485909?v=3","gravatar_id":"","url":"https://api.github.com/users/matthewloring","html_url":"https://github.com/matthewloring","followers_url":"https://api.github.com/users/matthewloring/followers","following_url":"https://api.github.com/users/matthewloring/following{/other_user}","gists_url":"https://api.github.com/users/matthewloring/gists{/gist_id}","starred_url":"https://api.github.com/users/matthewloring/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matthewloring/subscriptions","organizations_url":"https://api.github.com/users/matthewloring/orgs","repos_url":"https://api.github.com/users/matthewloring/repos","events_url":"https://api.github.com/users/matthewloring/events{/privacy}","received_events_url":"https://api.github.com/users/matthewloring/received_events","type":"User","site_admin":false},"body":"What does the `:` syntax mean?","created_at":"2016-12-08T03:12:46Z","updated_at":"2016-12-08T03:13:12Z","html_url":"https://github.com/GoogleCloudPlatform/cloud-debug-nodejs/pull/180#discussion_r91435142","pull_request_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/180","_links":{"self":{"href":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/comments/91435142"},"html":{"href":"https://github.com/GoogleCloudPlatform/cloud-debug-nodejs/pull/180#discussion_r91435142"},"pull_request":{"href":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/180"}}},"pull_request":{"url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/180","id":96982114,"html_url":"https://github.com/GoogleCloudPlatform/cloud-debug-nodejs/pull/180","diff_url":"https://github.com/GoogleCloudPlatform/cloud-debug-nodejs/pull/180.diff","patch_url":"https://github.com/GoogleCloudPlatform/cloud-debug-nodejs/pull/180.patch","issue_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/issues/180","number":180,"state":"open","locked":false,"title":"API changes bring us closer to `google-cloud`","user":{"login":"ofrobots","id":79017,"avatar_url":"https://avatars.githubusercontent.com/u/79017?v=3","gravatar_id":"","url":"https://api.github.com/users/ofrobots","html_url":"https://github.com/ofrobots","followers_url":"https://api.github.com/users/ofrobots/followers","following_url":"https://api.github.com/users/ofrobots/following{/other_user}","gists_url":"https://api.github.com/users/ofrobots/gists{/gist_id}","starred_url":"https://api.github.com/users/ofrobots/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ofrobots/subscriptions","organizations_url":"https://api.github.com/users/ofrobots/orgs","repos_url":"https://api.github.com/users/ofrobots/repos","events_url":"https://api.github.com/users/ofrobots/events{/privacy}","received_events_url":"https://api.github.com/users/ofrobots/received_events","type":"User","site_admin":false},"body":"This change adapts the primary interface of this module to align it\r\nwith the API exposed by all the other Google Cloud API Client\r\nLibraries available via the `google-cloud` modules [1].\r\n\r\nThe primary change is that we return a Debug construtor as the return\r\nvalue from the module. This, in the future, will provide a Client\r\nLibrary interface to the Debug APIs. This can be used for programatic\r\naccess to list or modify breakpoints, logpoints etc. The constructor,\r\nlike other API clients, accepts authentication and other general\r\nconfiguration.\r\n\r\nAn instantiated debug object exposes a function `startAgent` that can\r\nbe used to activate the process-wide agent that enables the debugging\r\nof an application using the Stackdriver Debug UI in the Google Cloud\r\nconsole.\r\n\r\nFeel free to bike-shed on `startAgent` vs `start`.","created_at":"2016-12-07T18:39:03Z","updated_at":"2016-12-08T03:13:12Z","closed_at":null,"merged_at":null,"merge_commit_sha":"52c92e4161004e2985984246c056f8683a615ea1","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/180/commits","review_comments_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/180/comments","review_comment_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/issues/180/comments","statuses_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/statuses/1e996bb91ec72cdbaa945dc92fc900c1b7f972d5","head":{"label":"ofrobots:rename-module","ref":"rename-module","sha":"1e996bb91ec72cdbaa945dc92fc900c1b7f972d5","user":{"login":"ofrobots","id":79017,"avatar_url":"https://avatars.githubusercontent.com/u/79017?v=3","gravatar_id":"","url":"https://api.github.com/users/ofrobots","html_url":"https://github.com/ofrobots","followers_url":"https://api.github.com/users/ofrobots/followers","following_url":"https://api.github.com/users/ofrobots/following{/other_user}","gists_url":"https://api.github.com/users/ofrobots/gists{/gist_id}","starred_url":"https://api.github.com/users/ofrobots/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ofrobots/subscriptions","organizations_url":"https://api.github.com/users/ofrobots/orgs","repos_url":"https://api.github.com/users/ofrobots/repos","events_url":"https://api.github.com/users/ofrobots/events{/privacy}","received_events_url":"https://api.github.com/users/ofrobots/received_events","type":"User","site_admin":false},"repo":{"id":42900553,"name":"cloud-debug-nodejs","full_name":"ofrobots/cloud-debug-nodejs","owner":{"login":"ofrobots","id":79017,"avatar_url":"https://avatars.githubusercontent.com/u/79017?v=3","gravatar_id":"","url":"https://api.github.com/users/ofrobots","html_url":"https://github.com/ofrobots","followers_url":"https://api.github.com/users/ofrobots/followers","following_url":"https://api.github.com/users/ofrobots/following{/other_user}","gists_url":"https://api.github.com/users/ofrobots/gists{/gist_id}","starred_url":"https://api.github.com/users/ofrobots/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ofrobots/subscriptions","organizations_url":"https://api.github.com/users/ofrobots/orgs","repos_url":"https://api.github.com/users/ofrobots/repos","events_url":"https://api.github.com/users/ofrobots/events{/privacy}","received_events_url":"https://api.github.com/users/ofrobots/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/ofrobots/cloud-debug-nodejs","description":null,"fork":true,"url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs","forks_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/forks","keys_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/teams","hooks_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/hooks","issue_events_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/issues/events{/number}","events_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/events","assignees_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/assignees{/user}","branches_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/branches{/branch}","tags_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/tags","blobs_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/git/refs{/sha}","trees_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/statuses/{sha}","languages_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/languages","stargazers_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/stargazers","contributors_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/contributors","subscribers_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/subscribers","subscription_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/subscription","commits_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/commits{/sha}","git_commits_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/git/commits{/sha}","comments_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/comments{/number}","issue_comment_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/issues/comments{/number}","contents_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/contents/{+path}","compare_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/merges","archive_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/downloads","issues_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/issues{/number}","pulls_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/pulls{/number}","milestones_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/milestones{/number}","notifications_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/labels{/name}","releases_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/releases{/id}","deployments_url":"https://api.github.com/repos/ofrobots/cloud-debug-nodejs/deployments","created_at":"2015-09-22T00:05:17Z","updated_at":"2016-04-21T17:14:27Z","pushed_at":"2016-12-07T23:51:24Z","git_url":"git://github.com/ofrobots/cloud-debug-nodejs.git","ssh_url":"git@github.com:ofrobots/cloud-debug-nodejs.git","clone_url":"https://github.com/ofrobots/cloud-debug-nodejs.git","svn_url":"https://github.com/ofrobots/cloud-debug-nodejs","homepage":null,"size":1912,"stargazers_count":0,"watchers_count":0,"language":"JavaScript","has_issues":false,"has_downloads":false,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"GoogleCloudPlatform:master","ref":"master","sha":"e38dc5c190b1fc04640fbab78fe4d2bd5e061add","user":{"login":"GoogleCloudPlatform","id":2810941,"avatar_url":"https://avatars.githubusercontent.com/u/2810941?v=3","gravatar_id":"","url":"https://api.github.com/users/GoogleCloudPlatform","html_url":"https://github.com/GoogleCloudPlatform","followers_url":"https://api.github.com/users/GoogleCloudPlatform/followers","following_url":"https://api.github.com/users/GoogleCloudPlatform/following{/other_user}","gists_url":"https://api.github.com/users/GoogleCloudPlatform/gists{/gist_id}","starred_url":"https://api.github.com/users/GoogleCloudPlatform/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GoogleCloudPlatform/subscriptions","organizations_url":"https://api.github.com/users/GoogleCloudPlatform/orgs","repos_url":"https://api.github.com/users/GoogleCloudPlatform/repos","events_url":"https://api.github.com/users/GoogleCloudPlatform/events{/privacy}","received_events_url":"https://api.github.com/users/GoogleCloudPlatform/received_events","type":"Organization","site_admin":false},"repo":{"id":34679272,"name":"cloud-debug-nodejs","full_name":"GoogleCloudPlatform/cloud-debug-nodejs","owner":{"login":"GoogleCloudPlatform","id":2810941,"avatar_url":"https://avatars.githubusercontent.com/u/2810941?v=3","gravatar_id":"","url":"https://api.github.com/users/GoogleCloudPlatform","html_url":"https://github.com/GoogleCloudPlatform","followers_url":"https://api.github.com/users/GoogleCloudPlatform/followers","following_url":"https://api.github.com/users/GoogleCloudPlatform/following{/other_user}","gists_url":"https://api.github.com/users/GoogleCloudPlatform/gists{/gist_id}","starred_url":"https://api.github.com/users/GoogleCloudPlatform/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GoogleCloudPlatform/subscriptions","organizations_url":"https://api.github.com/users/GoogleCloudPlatform/orgs","repos_url":"https://api.github.com/users/GoogleCloudPlatform/repos","events_url":"https://api.github.com/users/GoogleCloudPlatform/events{/privacy}","received_events_url":"https://api.github.com/users/GoogleCloudPlatform/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/GoogleCloudPlatform/cloud-debug-nodejs","description":"Node.js library for Stackdriver Debugger: investigate your code’s behavior in production","fork":false,"url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs","forks_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/forks","keys_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/teams","hooks_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/hooks","issue_events_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/issues/events{/number}","events_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/events","assignees_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/assignees{/user}","branches_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/branches{/branch}","tags_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/tags","blobs_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/git/refs{/sha}","trees_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/statuses/{sha}","languages_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/languages","stargazers_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/stargazers","contributors_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/contributors","subscribers_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/subscribers","subscription_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/subscription","commits_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/commits{/sha}","git_commits_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/git/commits{/sha}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/comments{/number}","issue_comment_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/issues/comments{/number}","contents_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/contents/{+path}","compare_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/merges","archive_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/downloads","issues_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/issues{/number}","pulls_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls{/number}","milestones_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/milestones{/number}","notifications_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/labels{/name}","releases_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/releases{/id}","deployments_url":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/deployments","created_at":"2015-04-27T16:57:45Z","updated_at":"2016-11-23T16:01:22Z","pushed_at":"2016-12-07T23:51:35Z","git_url":"git://github.com/GoogleCloudPlatform/cloud-debug-nodejs.git","ssh_url":"git@github.com:GoogleCloudPlatform/cloud-debug-nodejs.git","clone_url":"https://github.com/GoogleCloudPlatform/cloud-debug-nodejs.git","svn_url":"https://github.com/GoogleCloudPlatform/cloud-debug-nodejs","homepage":"https://cloud.google.com/debugger/","size":2004,"stargazers_count":68,"watchers_count":68,"language":"JavaScript","has_issues":true,"has_downloads":false,"has_wiki":false,"has_pages":false,"forks_count":20,"mirror_url":null,"open_issues_count":3,"forks":20,"open_issues":3,"watchers":68,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/180"},"html":{"href":"https://github.com/GoogleCloudPlatform/cloud-debug-nodejs/pull/180"},"issue":{"href":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/issues/180"},"comments":{"href":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/issues/180/comments"},"review_comments":{"href":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/180/comments"},"review_comment":{"href":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/pulls/180/commits"},"statuses":{"href":"https://api.github.com/repos/GoogleCloudPlatform/cloud-debug-nodejs/statuses/1e996bb91ec72cdbaa945dc92fc900c1b7f972d5"}}}}
{"actor":{"display_login":"matthewloring"}}