diff options
author | Matt A. Tobin <mattatobin@localhost.localdomain> | 2018-02-02 04:16:08 -0500 |
---|---|---|
committer | Matt A. Tobin <mattatobin@localhost.localdomain> | 2018-02-02 04:16:08 -0500 |
commit | 5f8de423f190bbb79a62f804151bc24824fa32d8 (patch) | |
tree | 10027f336435511475e392454359edea8e25895d /devtools/shared/indentation.js | |
parent | 49ee0794b5d912db1f95dce6eb52d781dc210db5 (diff) | |
download | UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.gz UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.lz UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.xz UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.zip |
Add m-esr52 at 52.6.0
Diffstat (limited to 'devtools/shared/indentation.js')
-rw-r--r-- | devtools/shared/indentation.js | 160 |
1 files changed, 160 insertions, 0 deletions
diff --git a/devtools/shared/indentation.js b/devtools/shared/indentation.js new file mode 100644 index 000000000..9d3cabcb7 --- /dev/null +++ b/devtools/shared/indentation.js @@ -0,0 +1,160 @@ +/* -*- indent-tabs-mode: nil; js-indent-level: 2; fill-column: 80 -*- */ +/* vim:set ts=2 sw=2 sts=2 et tw=80: + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ + +"use strict"; + +const Services = require("Services"); + +const EXPAND_TAB = "devtools.editor.expandtab"; +const TAB_SIZE = "devtools.editor.tabsize"; +const DETECT_INDENT = "devtools.editor.detectindentation"; +const DETECT_INDENT_MAX_LINES = 500; + +/** + * Get the indentation to use in an editor, or return false if the user has + * asked for the indentation to be guessed from some text. + * + * @return {false | Object} + * Returns false if the "detect indentation" pref is set. + * an object of the form {indentUnit, indentWithTabs}. + * |indentUnit| is the number of indentation units to use + * to indent a "block". + * |indentWithTabs| is a boolean which is true if indentation + * should be done using tabs. + */ +function getIndentationFromPrefs() { + let shouldDetect = Services.prefs.getBoolPref(DETECT_INDENT); + if (shouldDetect) { + return false; + } + + let indentWithTabs = !Services.prefs.getBoolPref(EXPAND_TAB); + let indentUnit = Services.prefs.getIntPref(TAB_SIZE); + return {indentUnit, indentWithTabs}; +} + +/** + * Given a function that can iterate over some text, compute the indentation to + * use. This consults various prefs to arrive at a decision. + * + * @param {Function} iterFunc A function of three arguments: + * (start, end, callback); where |start| and |end| describe + * the range of text lines to examine, and |callback| is a function + * to be called with the text of each line. + * + * @return {Object} an object of the form {indentUnit, indentWithTabs}. + * |indentUnit| is the number of indentation units to use + * to indent a "block". + * |indentWithTabs| is a boolean which is true if indentation + * should be done using tabs. + */ +function getIndentationFromIteration(iterFunc) { + let indentWithTabs = !Services.prefs.getBoolPref(EXPAND_TAB); + let indentUnit = Services.prefs.getIntPref(TAB_SIZE); + let shouldDetect = Services.prefs.getBoolPref(DETECT_INDENT); + + if (shouldDetect) { + let indent = detectIndentation(iterFunc); + if (indent != null) { + indentWithTabs = indent.tabs; + indentUnit = indent.spaces ? indent.spaces : indentUnit; + } + } + + return {indentUnit, indentWithTabs}; +} + +/** + * A wrapper for @see getIndentationFromIteration which computes the + * indentation of a given string. + * + * @param {String} string the input text + * @return {Object} an object of the same form as returned by + * getIndentationFromIteration + */ +function getIndentationFromString(string) { + let iteratorFn = function (start, end, callback) { + let split = string.split(/\r\n|\r|\n|\f/); + split.slice(start, end).forEach(callback); + }; + return getIndentationFromIteration(iteratorFn); +} + +/** + * Detect the indentation used in an editor. Returns an object + * with 'tabs' - whether this is tab-indented and 'spaces' - the + * width of one indent in spaces. Or `null` if it's inconclusive. + */ +function detectIndentation(textIteratorFn) { + // # spaces indent -> # lines with that indent + let spaces = {}; + // indentation width of the last line we saw + let last = 0; + // # of lines that start with a tab + let tabs = 0; + // # of indented lines (non-zero indent) + let total = 0; + + textIteratorFn(0, DETECT_INDENT_MAX_LINES, (text) => { + if (text.startsWith("\t")) { + tabs++; + total++; + return; + } + let width = 0; + while (text[width] === " ") { + width++; + } + // don't count lines that are all spaces + if (width == text.length) { + last = 0; + return; + } + if (width > 1) { + total++; + } + + // see how much this line is offset from the line above it + let indent = Math.abs(width - last); + if (indent > 1 && indent <= 8) { + spaces[indent] = (spaces[indent] || 0) + 1; + } + last = width; + }); + + // this file is not indented at all + if (total == 0) { + return null; + } + + // mark as tabs if they start more than half the lines + if (tabs >= total / 2) { + return { tabs: true }; + } + + // find most frequent non-zero width difference between adjacent lines + let freqIndent = null, max = 1; + for (let width in spaces) { + width = parseInt(width, 10); + let tally = spaces[width]; + if (tally > max) { + max = tally; + freqIndent = width; + } + } + if (!freqIndent) { + return null; + } + + return { tabs: false, spaces: freqIndent }; +} + +exports.EXPAND_TAB = EXPAND_TAB; +exports.TAB_SIZE = TAB_SIZE; +exports.DETECT_INDENT = DETECT_INDENT; +exports.getIndentationFromPrefs = getIndentationFromPrefs; +exports.getIndentationFromIteration = getIndentationFromIteration; +exports.getIndentationFromString = getIndentationFromString; |