documentation/lib/git/url_prefix.js
Tom MacWright 25152edeb9 style(prettier): Use prettier for code formatting (#710)
* style(prettier): Use prettier for code formatting

This saves us style issues. Also adds husky and lint-staged for pre-commit testing

Refs https://github.com/documentationjs/documentation/issues/709
2017-04-10 14:25:45 -04:00

77 lines
2.4 KiB
JavaScript

/* @flow */
'use strict';
var fs = require('fs');
var path = require('path');
var gitUrlParse = require('git-url-parse');
var getRemoteOrigin = require('remote-origin-url');
/**
* Sometimes git will [pack refs](https://git-scm.com/docs/git-pack-refs)
* in order to save space on disk and
* duck under limits of numbers of files in folders. CircleCI in particular
* does this by default. This method parses that `packed-refs` file
*
* @private
* @param {string} packedRefs string contents of the packed refs file
* @param {string} branchName the branch name to resolve to
* @returns {string} sha hash referring to current tree
*/
function parsePackedRefs(packedRefs, branchName) {
return packedRefs
.split(/\n/)
.filter(line => line[0] !== '#' && line[0] !== '^')
.reduce(
(memo, line) => {
memo[line.split(' ')[1]] = line.split(' ')[0];
return memo;
},
{}
)[branchName];
}
/**
* Given a a root directory, find its git configuration and figure out
* the HTTPS URL at the base of that GitHub repository.
*
* @param {string} root path at the base of this local repo
* @returns {string} base HTTPS url of the GitHub repository
* @throws {Error} if the root is not a git repo
*/
function getGithubURLPrefix(root /*: string*/) {
var sha;
try {
var head = fs.readFileSync(path.join(root, '.git', 'HEAD'), 'utf8');
var branch = head.match(/ref\: (.*)/);
if (branch) {
var branchName = branch[1];
var branchFileName = path.join(root, '.git', branchName);
var packedRefsName = path.join(root, '.git', 'packed-refs');
if (fs.existsSync(branchFileName)) {
sha = fs.readFileSync(branchFileName, 'utf8');
} else if (fs.existsSync(packedRefsName)) {
// packed refs are a compacted version of the refs folder. usually
// you have a folder filled with files that just contain sha
// hashes. since this folder can be really big, packed refs
// stores all the refs in one file instead.
sha = parsePackedRefs(
fs.readFileSync(packedRefsName, 'utf8'),
branchName
);
}
} else {
sha = head;
}
if (sha) {
return gitUrlParse(getRemoteOrigin.sync(root)).toString('https') +
'/blob/' +
sha.trim() +
'/';
}
} catch (e) {
return null;
}
}
module.exports = getGithubURLPrefix;
module.exports.parsePackedRefs = parsePackedRefs;