tigger 0.0.0 → 0.0.2

package/README.md

@@ -0,0 +1,21 @@
+# Tigger
+
+Tales the fun out of using the GitHub API.
+
+## Installation
+
+With [npm](https://www.npmjs.com/):
+
+    npm install tigger
+
+You can also clone the repository with [Git](https://git-scm.com/)...
+
+    git clone https://github.com/djalbat/tigger.git
+
+...then install the dependencies with npm from within the project's root directory:
+
+    npm install
+
+## Contact
+
+- james.smith@djalbat.com

package/bin/constants.js

@@ -0,0 +1,19 @@
+"use strict";
+
+const END = "end",
+      DATA = "data",
+      BLOB_TYPE = "blob",
+      BLOB_MODE = "100644",
+      EMPTY_STRING = "",
+      GITHUB_API_HOST = "https://api.github.com",
+      APPLICATION_VND_GITHUB_VS_JSON = "application/vnd.github.v3+json";
+
+module.exports = {
+  END,
+  DATA,
+  BLOB_TYPE,
+  BLOB_MODE,
+  EMPTY_STRING,
+  GITHUB_API_HOST,
+  APPLICATION_VND_GITHUB_VS_JSON
+};

package/bin/example/handler/alterIssue.js

@@ -0,0 +1,30 @@
+"use strict";
+
+const { asynchronousUtilities } = require("necessary");
+
+const getIssueOperation = require("../operation/getIssue"),
+      alterIssueOperation = require("../operation/alterIssue"),
+      getCommentsOperation = require("../operation/getComments");
+
+const { sequence } = asynchronousUtilities;
+
+function alterIssueHandler(context) {
+  const operations = [
+          alterIssueOperation,
+          getIssueOperation,
+          getCommentsOperation
+        ],
+        state = "closed",
+        issueNumber = 1;
+
+  Object.assign(context, {
+    state,
+    issueNumber
+  });
+
+  sequence(operations, () => {
+    ///
+  }, context);
+}
+
+module.exports = alterIssueHandler;

package/bin/example/handler/commit.js

@@ -0,0 +1,44 @@
+"use strict";
+
+const { asynchronousUtilities } = require("necessary");
+
+const postCommitSHAOperation = require("../operation/postCommitSHA"),
+      getBaseTreeSHAOperation = require("../operation/getBaseTreeSHA"),
+      postUpdatedHeadOperation = require("../operation/postUpdatedHead"),
+      postCommitTreeSHAOperation = require("../operation/postCommitTreeSHA"),
+      getLatestCommitSHAOperation = require("../operation/getLatestCommitSHA"),
+      postReadmeFileContentOperation = require("../operation/postReadmeFileContent"),
+      postMetaJSONFileContentOperation = require("../operation/postMetaJSONFileContent");
+
+const { sequence } = asynchronousUtilities;
+
+function commitHandler(context) {
+  const commitMessage = "...",
+        readmeFilePath = "...",
+        metaJSONFilePath = "...",
+        readmeFileContent = "...",
+        metaJSONFileContent = "...",
+        operations = [
+          getLatestCommitSHAOperation,
+          getBaseTreeSHAOperation,
+          postReadmeFileContentOperation,
+          postMetaJSONFileContentOperation,
+          postCommitTreeSHAOperation,
+          postCommitSHAOperation,
+          postUpdatedHeadOperation
+        ];
+
+  Object.assign(context, {
+    commitMessage,
+    readmeFilePath,
+    metaJSONFilePath,
+    readmeFileContent,
+    metaJSONFileContent
+  });
+
+  sequence(operations, () => {
+    ///
+  }, context);
+}
+
+module.exports = commitHandler;

package/bin/example/handler/createComment.js

@@ -0,0 +1,30 @@
+"use strict";
+
+const { asynchronousUtilities } = require("necessary");
+
+const getIssueOperation = require("../operation/getIssue"),
+      getCommentsOperation = require("../operation/getComments"),
+      createCommentOperation = require("../operation/createComment");
+
+const { sequence } = asynchronousUtilities;
+
+function createCommentHandler(context) {
+  const operations = [
+          createCommentOperation,
+          getIssueOperation,
+          getCommentsOperation
+        ],
+        issueNumber = 1,
+        description = "...";
+
+  Object.assign(context, {
+    description,
+    issueNumber
+  });
+
+  sequence(operations, () => {
+    ///
+  }, context);
+}
+
+module.exports = createCommentHandler;

package/bin/example/handler/createIssue.js

@@ -0,0 +1,28 @@
+"use strict";
+
+const { asynchronousUtilities } = require("necessary");
+
+const getIssueOperation = require("../operation/getIssue"),
+      createIssueOperation = require("../operation/createIssue");
+
+const { sequence } = asynchronousUtilities;
+
+function createIssueHandler(context) {
+  const operations = [
+          createIssueOperation,
+          getIssueOperation
+        ],
+        title = "...",
+        description = "...";
+
+  Object.assign(context, {
+    title,
+    description
+  });
+
+  sequence(operations, () => {
+    ///
+  }, context);
+}
+
+module.exports = createIssueHandler;

package/bin/example/handler/editComment.js

@@ -0,0 +1,32 @@
+"use strict";
+
+const { asynchronousUtilities } = require("necessary");
+
+const getIssueOperation = require("../operation/getIssue"),
+      getCommentsOperation = require("../operation/getComments"),
+      editCommentOperation = require("../operation/editComment");
+
+const { sequence } = asynchronousUtilities;
+
+function editCommentHandler(context) {
+  const operations = [
+          editCommentOperation,
+          getIssueOperation,
+          getCommentsOperation
+        ],
+        issueNumber = 1,
+        description = "...",
+        commentIdentifier = 123;
+
+  Object.assign(context, {
+    description,
+    issueNumber,
+    commentIdentifier
+  });
+
+  sequence(operations, () => {
+    debugger
+  }, context);
+}
+
+module.exports = editCommentHandler;

package/bin/example/handler/editIssue.js

@@ -0,0 +1,32 @@
+"use strict";
+
+const { asynchronousUtilities } = require("necessary");
+
+const getIssueOperation = require("../operation/getIssue"),
+      editIssueOperation = require("../operation/editIssue"),
+      getCommentsOperation = require("../operation/getComments");
+
+const { sequence } = asynchronousUtilities;
+
+function editIssueHandler(context) {
+  const operations = [
+          editIssueOperation,
+          getIssueOperation,
+          getCommentsOperation
+        ],
+        title = "...",
+        issueNumber = 1,
+        description = "...";
+
+  Object.assign(context, {
+    title,
+    description,
+    issueNumber
+  });
+
+  sequence(operations, () => {
+    ///
+  }, context);
+}
+
+module.exports = editIssueHandler;

package/bin/example/handler/issue.js

@@ -0,0 +1,26 @@
+"use strict";
+
+const { asynchronousUtilities } = require("necessary");
+
+const getIssueOperation = require("../operation/getIssue"),
+      getCommentsOperation = require("../operation/getComments");
+
+const { sequence } = asynchronousUtilities;
+
+function issueHandler(context) {
+  const operations = [
+          getIssueOperation,
+          getCommentsOperation
+        ],
+        issueNumber = 1;
+
+  Object.assign(context, {
+    issueNumber
+  });
+
+  sequence(operations, () => {
+    ///
+  }, context);
+}
+
+module.exports = issueHandler;

package/bin/example/handler/issues.js

@@ -0,0 +1,24 @@
+"use strict";
+
+const { asynchronousUtilities } = require("necessary");
+
+const getIssuesOperation = require("../operation/getIssues");
+
+const { sequence } = asynchronousUtilities;
+
+function issuesHandler(context) {
+  const operations = [
+          getIssuesOperation
+        ],
+        state = "open";
+
+  Object.assign(context, {
+    state
+  });
+
+  sequence(operations, () => {
+    ///
+  }, context);
+}
+
+module.exports = issuesHandler;

package/bin/example/handler/removeComment.js

@@ -0,0 +1,30 @@
+"use strict";
+
+const { asynchronousUtilities } = require("necessary");
+
+const getIssueOperation = require("../operation/getIssue"),
+      getCommentsOperation = require("../operation/getComments"),
+      removeCommentOperation = require("../operation/removeComment");
+
+const { sequence } = asynchronousUtilities;
+
+function removeCommentHandler(context) {
+  const operations = [
+          removeCommentOperation,
+          getIssueOperation,
+          getCommentsOperation
+        ],
+        issueNumber = 1,
+        commentIdentifier = 123;
+
+  Object.assign(context, {
+    issueNumber,
+    commentIdentifier
+  });
+
+  sequence(operations, () => {
+    ///
+  }, context);
+}
+
+module.exports = removeCommentHandler;

package/bin/example/operation/alterIssue.js

@@ -0,0 +1,29 @@
+"use strict";
+
+const { issueUtilities } = require("../../..");  ///
+
+const { alterIssuePatchRequest } = issueUtilities;
+
+function alterIssueOperation(next, done, context) {
+  const { repository, state, issueNumber, userAgent, gitHubAccessToken } = context;
+
+  alterIssuePatchRequest(repository, state, issueNumber, userAgent, gitHubAccessToken, (error, json) => {
+    if (error) {
+      done();
+
+      return;
+    }
+
+    const { message = null } = json;
+
+    if (message !== null) {
+      done();
+
+      return;
+    }
+
+    next();
+  });
+}
+
+module.exports = alterIssueOperation;

package/bin/example/operation/createComment.js

@@ -0,0 +1,29 @@
+"use strict";
+
+const { commentUtilities } = require("../../../");  ///
+
+const { createCommentPostRequest } = commentUtilities;
+
+function createCommentOperation(next, done, context) {
+  const { repository, description, issueNumber, userAgent, gitHubAccessToken } = context;
+
+  createCommentPostRequest(repository, description, issueNumber, userAgent, gitHubAccessToken, (error, json) => {
+    if (error) {
+      done();
+
+      return;
+    }
+
+    const { message = null } = json;
+
+    if (message !== null) {
+      done();
+
+      return;
+    }
+
+    next();
+  });
+}
+
+module.exports = createCommentOperation;

package/bin/example/operation/createIssue.js

@@ -0,0 +1,36 @@
+"use strict";
+
+const { issueUtilities } = require("../../..");  ///
+
+const { createIssuePostRequest } = issueUtilities
+
+function createIssueOperation(next, done, context) {
+  const { repository, title, description, userAgent, gitHubAccessToken } = context;
+
+  createIssuePostRequest(repository, title, description, userAgent, gitHubAccessToken, (error, json) => {
+    if (error) {
+      done();
+
+      return;
+    }
+
+    const { message = null } = json;
+
+    if (message !== null) {
+      done();
+
+      return;
+    }
+
+    const { number } = json,
+          issueNumber = number; ///
+
+    Object.assign(context, {
+      issueNumber
+    });
+
+    next();
+  });
+}
+
+module.exports = createIssueOperation;

package/bin/example/operation/editComment.js

@@ -0,0 +1,29 @@
+"use strict";
+
+const { commentUtilities } = require("../../..");  ///
+
+const { editCommentPatchRequest } = commentUtilities;
+
+function editCommentOperation(next, done, context) {
+  const { repository, description, commentIdentifier, userAgent, gitHubAccessToken } = context;
+
+  editCommentPatchRequest(repository, description, commentIdentifier, userAgent, gitHubAccessToken, (error, json) => {
+    if (error) {
+      done();
+
+      return;
+    }
+
+    const { message = null } = json;
+
+    if (message !== null) {
+      done();
+
+      return;
+    }
+
+    next();
+  });
+}
+
+module.exports = editCommentOperation;

package/bin/example/operation/editIssue.js

@@ -0,0 +1,29 @@
+"use strict";
+
+const { issueUtilities } = require("../../..");  ///
+
+const { editIssuePatchRequest } = issueUtilities;
+
+function editIssueOperation(next, done, context) {
+  const { repository, title, description, issueNumber, userAgent, gitHubAccessToken } = context;
+
+  editIssuePatchRequest(repository, title, description, issueNumber, userAgent, gitHubAccessToken, (error, json) => {
+    if (error) {
+      done();
+
+      return;
+    }
+
+    const { message = null } = json;
+
+    if (message !== null) {
+      done();
+
+      return;
+    }
+
+    next();
+  });
+}
+
+module.exports = editIssueOperation;

package/bin/example/operation/getBaseTreeSHA.js

@@ -0,0 +1,36 @@
+"use strict";
+
+const { commitUtilities } = require("../../..");  ///
+
+const { baseTreeSHAGetRequest } = commitUtilities
+
+function getBaseTreeSHAOperation(next, done, context) {
+  const { repository, userAgent, clientId, clientSecret, latestCommitSHA } = context;
+
+  baseTreeSHAGetRequest(repository, latestCommitSHA, userAgent, clientId, clientSecret, (error, json) => {
+    if (error) {
+      done();
+
+      return;
+    }
+
+    const { tree = null } = json;
+
+    if (tree === null) {
+      done();
+
+      return;
+    }
+
+    const { sha } = tree,
+          baseTreeSHA = sha;  ///
+
+    Object.assign(context, {
+      baseTreeSHA
+    });
+
+    next();
+  });
+}
+
+module.exports = getBaseTreeSHAOperation;

package/bin/example/operation/getComments.js

@@ -0,0 +1,36 @@
+"use strict";
+
+const { commentUtilities } = require("../../..");  ///
+
+const { commentsGetRequest } = commentUtilities;
+
+function getCommentsOperation(next, done, context) {
+  const { repository, issueNumber, userAgent, clientId, clientSecret } = context;
+
+  commentsGetRequest(repository, issueNumber, userAgent, clientId, clientSecret, (error, json) => {
+    if (error) {
+      done();
+
+      return;
+    }
+
+    const { message = null } = json;
+
+    if (message !== null) {
+      done();
+
+      return;
+    }
+
+    const { issue } = context,
+          comments = json;  ///
+
+    Object.assign(issue, {
+      comments
+    });
+
+    next();
+  });
+}
+
+module.exports = getCommentsOperation;

package/bin/example/operation/getIssue.js

@@ -0,0 +1,35 @@
+"use strict";
+
+const { issueUtilities } = require("../../..");  ///
+
+const { issueGetRequest } = issueUtilities;
+
+function getIssueOperation(next, done, context) {
+  const { repository, issueNumber, userAgent, clientId, clientSecret } = context;
+
+  issueGetRequest(repository, issueNumber, userAgent, clientId, clientSecret, (error, json) => {
+    if (error) {
+      done();
+
+      return;
+    }
+
+    const { message = null } = json;
+
+    if (message !== null) {
+      done();
+
+      return;
+    }
+
+    const issue = json; ///
+
+    Object.assign(context, {
+      issue
+    });
+
+    next();
+  });
+}
+
+module.exports = getIssueOperation;

package/bin/example/operation/getIssues.js

@@ -0,0 +1,35 @@
+"use strict";
+
+const { issueUtilities } = require("../../..");  ///
+
+const { issuesGetRequest } = issueUtilities;
+
+function getIssuesOperation(next, done, context) {
+  const { repository, state, userAgent, clientId, clientSecret } = context;
+
+  issuesGetRequest(repository, state, userAgent, clientId, clientSecret, (error, json) => {
+    if (error) {
+      done();
+
+      return;
+    }
+
+    const { message = null } = json;
+
+    if (message !== null) {
+      done();
+
+      return;
+    }
+
+    const issues = json;  ///
+
+    Object.assign(context, {
+      issues
+    });
+
+    next();
+  });
+}
+
+module.exports = getIssuesOperation;

package/bin/example/operation/getLatestCommitSHA.js

@@ -0,0 +1,36 @@
+"use strict";
+
+const { commitUtilities } = require("../../..");  ///
+
+const { latestCommitSHAGetRequest } = commitUtilities;
+
+function getLatestCommitSHAOperation(next, done, context) {
+  const { repository, userAgent, clientId, clientSecret } = context;
+
+  latestCommitSHAGetRequest(repository, userAgent, clientId, clientSecret, (error, json) => {
+    if (error) {
+      done();
+
+      return;
+    }
+
+    const { object = null } = json;
+
+    if (object === null) {
+      done();
+
+      return;
+    }
+
+    const { sha } = object,
+          latestCommitSHA = sha;  ///
+
+    Object.assign(context, {
+      latestCommitSHA
+    });
+
+    next();
+  });
+}
+
+module.exports = getLatestCommitSHAOperation;