Resolve merge conflicts.

Author: CodyGramlich

.travis.yml

@@ -1,29 +1,26 @@
 sudo: false
 language: node_js
 node_js:
-  - '6'
-  - '5'
-  - '4'
-
+- '11'
+- '10'
+- '8'
 cache:
   directories:
-    - node_modules
+  - node_modules
 before_install: npm install -g npm@latest
 before_script:
-  - npm run lint
-  # - npm run build # will need this when we do sauce testing of compiled files
+- npm run lint
 script:
-  - npm run test-coverage
-  # - npm run test-dist # test the compiled files
+- npm run test-coverage
 after_success:
-  - npm run codecov
+- npm run codecov
 before_deploy:
-    - npm run build
+- npm run build
 deploy:
   provider: npm
   skip_cleanup: true
   on:
     tags: true
   email: clayreimann@gmail.com
   api_key:
-    secure: TZHqJ9Kh2Qf0GAVDjEOQ01Ez6rGMYHKwVLOKTbnb7nSzF7iiGNT4UwzvYawm0T9p1k7X1WOqW3l7OEbIwoKl7/9azT4BBJm7qUMRfB9Zio5cL3rKubJVz7+LEEIW4iBeDWLanhUDgy9BO2JKCt8bfp/U2tltgXtu9Fm/UFPALI8=
+    secure: WnLh1m02aF7NvFNILCZ8KsjPuDeSddQI87y8dwAixStr2FhQyz8FIKZN2Qj1N1Q9ZJvBETe5HWs1c9yOjTKBkD0d/eU2hlpnB9WXEFRJVDjiUuMnpAMMvuqTZwYg6kXq5N+of95PX58AYiBiV/qwsdUr/MgjEEYLt5UZgRYQRvE=

README.md

@@ -9,7 +9,7 @@
 [![Travis](https://img.shields.io/travis/github-tools/github.svg?maxAge=60)][travis-ci]
 [![Codecov](https://img.shields.io/codecov/c/github/github-tools/github.svg?maxAge=2592000)][codecov]
 
-Github.js provides a minimal higher-level wrapper around Github's API.
+`Github.js` provides a minimal higher-level wrapper around Github's API.
 
 ## Usage
 
@@ -71,7 +71,7 @@ clayreimann.listStarredRepos(function(err, repos) {
 should include updated JSDoc.
 
 ## Installation
-Github.js is available from `npm` or [unpkg][unpkg].
+`Github.js` is available from `npm` or [unpkg][unpkg].
 
 ```shell
 npm install github-api
@@ -86,10 +86,7 @@ npm install github-api
 ```
 
 ## Compatibility
-`Github.js` is tested on Node.js:
-* 6.x
-
-Note: `Github.js` uses Promise, hence it will not work in Node.js < 4 without polyfill.
+`Github.js` is tested on node's LTS and current versions.
 
 [codecov]: https://codecov.io/github/github-tools/github?branch=master
 [docs]: http://github-tools.github.io/github/

lib/GitHub.js

@@ -34,7 +34,7 @@ class GitHub {
 
    /**
     * Create a new Gist wrapper
-    * @param {number} [id] - the id for the gist, leave undefined when creating a new gist
+    * @param {string} [id] - the id for the gist, leave undefined when creating a new gist
     * @return {Gist}
     */
    getGist(id) {

lib/Markdown.js

@@ -32,7 +32,7 @@ class Markdown extends Requestable {
     * @return {Promise} - the promise for the http request
     */
    render(options, cb) {
-      return this._request('POST', '/markdown', options, cb);
+      return this._request('POST', '/markdown', options, cb, true);
    }
 }
 

lib/Repository.js

@@ -14,7 +14,7 @@ import debug from 'debug';
 const log = debug('github:repository');
 
 /**
- * Respository encapsulates the functionality to create, query, and modify files.
+ * Repository encapsulates the functionality to create, query, and modify files.
  */
 class Repository extends Requestable {
    /**
@@ -188,7 +188,10 @@ class Repository extends Requestable {
     */
    listCommits(options, cb) {
       options = options || {};
-
+      if (typeof options === 'function') {
+         cb = options;
+         options = {};
+      }
       options.since = this._dateToISO(options.since);
       options.until = this._dateToISO(options.until);
 
@@ -334,16 +337,26 @@ class Repository extends Requestable {
     * @param {string} parent - the SHA of the parent commit
     * @param {string} tree - the SHA of the tree for this commit
     * @param {string} message - the commit message
+    * @param {Object} [options] - commit options
+    * @param {Object} [options.author] - the author of the commit
+    * @param {Object} [options.commiter] - the committer
     * @param {Requestable.callback} cb - will receive the commit that is created
     * @return {Promise} - the promise for the http request
     */
-   commit(parent, tree, message, cb) {
+   commit(parent, tree, message, options, cb) {
+      if (typeof options === 'function') {
+         cb = options;
+         options = {};
+      }
+
       let data = {
          message,
          tree,
          parents: [parent],
       };
 
+      data = Object.assign({}, options, data);
+
       return this._request('POST', `/repos/${this.__fullname}/git/commits`, data, cb)
          .then((response) => {
             this.__currentTree.sha = response.data.sha; // Update latest commit
@@ -494,6 +507,18 @@ class Repository extends Requestable {
       return this._request('POST', `/repos/${this.__fullname}/forks`, null, cb);
    }
 
+   /**
+    * Fork a repository to an organization
+    * @see https://developer.github.com/v3/repos/forks/#create-a-fork
+    * @param {String} org - organization where you'd like to create the fork.
+    * @param {Requestable.callback} cb - will receive the information about the newly created fork
+    * @return {Promise} - the promise for the http request
+    *
+    */
+   forkToOrg(org, cb) {
+      return this._request('POST', `/repos/${this.__fullname}/forks?organization=${org}`, null, cb);
+   }
+
    /**
     * List a repository's forks
     * @see https://developer.github.com/v3/repos/forks/#list-forks

lib/Requestable.js

@@ -124,7 +124,7 @@ class Requestable {
 
    /**
     * if a `Date` is passed to this function it will be converted to an ISO string
-    * @param {*} date - the object to attempt to cooerce into an ISO date string
+    * @param {*} date - the object to attempt to coerce into an ISO date string
     * @return {string} - the ISO representation of `date` or whatever was passed in if it was not a date
     */
    _dateToISO(date) {
@@ -235,7 +235,7 @@ class Requestable {
     * @param {string} path - the path to request
     * @param {Object} options - the query parameters to include
     * @param {Requestable.callback} [cb] - the function to receive the data. The returned data will always be an array.
-    * @param {Object[]} results - the partial results. This argument is intended for interal use only.
+    * @param {Object[]} results - the partial results. This argument is intended for internal use only.
     * @return {Promise} - a promise which will resolve when all pages have been fetched
     * @deprecated This will be folded into {@link Requestable#_request} in the 2.0 release.
     */

lib/User.js

@@ -81,6 +81,26 @@ class User extends Requestable {
       return this._request('GET', this.__getScopedUrl('orgs'), null, cb);
    }
 
+   /**
+    * List followers of a user
+    * @see https://developer.github.com/v3/users/followers/#list-followers-of-a-user
+    * @param {Requestable.callback} [cb] - will receive the list of followers
+    * @return {Promise} - the promise for the http request
+    */
+   listFollowers(cb) {
+      return this._request('GET', this.__getScopedUrl('followers'), null, cb);
+   }
+
+   /**
+    * List users followed by another user
+    * @see https://developer.github.com/v3/users/followers/#list-users-followed-by-another-user
+    * @param {Requestable.callback} [cb] - will receive the list of who a user is following
+    * @return {Promise} - the promise for the http request
+    */
+   listFollowing(cb) {
+      return this._request('GET', this.__getScopedUrl('following'), null, cb);
+   }
+
    /**
     * List the user's gists
     * @see https://developer.github.com/v3/gists/#list-a-users-gists
@@ -132,6 +152,23 @@ class User extends Requestable {
       return this._requestAllPages(this.__getScopedUrl('starred'), requestOptions, cb);
    }
 
+   /**
+    * Gets the list of starred gists for the user
+    * @see https://developer.github.com/v3/gists/#list-starred-gists
+    * @param {Object} [options={}] - any options to refine the search
+    * @param {Requestable.callback} [cb] - will receive the list of gists
+    * @return {Promise} - the promise for the http request
+    */
+   listStarredGists(options, cb) {
+      options = options || {};
+      if (typeof options === 'function') {
+         cb = options;
+         options = {};
+      }
+      options.since = this._dateToISO(options.since);
+      return this._request('GET', '/gists/starred', options, cb);
+   }
+
    /**
     * List email addresses for a user
     * @see https://developer.github.com/v3/users/emails/#list-email-addresses-for-a-user

package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-api",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "license": "BSD-3-Clause-Clear",
   "description": "A higher-level wrapper around the Github API.",
   "main": "dist/components/GitHub.js",
@@ -52,7 +52,7 @@
     "dist/*"
   ],
   "dependencies": {
-    "axios": "^0.15.2",
+    "axios": "^0.19.0",
     "debug": "^2.2.0",
     "js-base64": "^2.1.9",
     "utf8": "^2.1.1"

test/dist.spec/index.html

@@ -12,7 +12,7 @@
   <script>mocha.setup('bdd')</script>
   <script>
      describe('the dist file', function() {
-        it('should work', function(done) {
+        it('should load a Gist', function(done) {
            var github = new GitHub();
            var gist = github.getGist('e265df71e7532f3a4bdd');
            gist.read()
@@ -21,6 +21,24 @@
                  done();
               });
         });
+
+        it('should render markdown', function(done) {
+           var shouldBe = '<p>Hello world github/linguist#1 <strong>cool</strong>, and #1!</p>\n';
+           var github = new GitHub();
+           var markdown = github.getMarkdown();
+           const options = {
+              text: 'Hello world github/linguist#1 **cool**, and #1!',
+           };
+
+           markdown.render(options)
+              .then(function({data: html}) {
+                 console.log(html);
+                 if (html !== shouldBe) {
+                    throw new Error(html + ' should be ' + shouldBe)
+                 }
+                 done();
+              }).catch(done);
+        });
      });
   </script>
   <script>

test/markdown.spec.js

@@ -37,7 +37,7 @@ describe('Markdown', function() {
       };
       markdown.render(options)
          .then(function({data: html}) {
-            expect(html).to.be('<p>Hello world <a href="https://github.com/github/linguist/issues/1" class="issue-link js-issue-link" data-url="https://github.com/github/linguist/issues/1" data-id="1012654" data-error-text="Failed to load issue title" data-permission-text="Issue title is private">github/linguist#1</a> <strong>cool</strong>, and <a href="https://github.com/gollum/gollum/issues/1" class="issue-link js-issue-link" data-url="https://github.com/gollum/gollum/issues/1" data-id="183433" data-error-text="Failed to load issue title" data-permission-text="Issue title is private">#1</a>!</p>'); // eslint-disable-line
+            expect(html).to.be('<p>Hello world <a class="issue-link js-issue-link" data-error-text="Failed to load issue title" data-id="1012654" data-permission-text="Issue title is private" data-url="https://github.com/github/linguist/issues/1" data-hovercard-type="issue" data-hovercard-url="/github/linguist/issues/1/hovercard" href="https://github.com/github/linguist/issues/1">github/linguist#1</a> <strong>cool</strong>, and <a class="issue-link js-issue-link" data-error-text="Failed to load issue title" data-id="183433" data-permission-text="Issue title is private" data-url="https://github.com/gollum/gollum/issues/1" data-hovercard-type="issue" data-hovercard-url="/gollum/gollum/issues/1/hovercard" href="https://github.com/gollum/gollum/issues/1">gollum#1</a>!</p>'); // eslint-disable-line
             done();
          }).catch(done);
    });