mirror of
https://scm.univ-tours.fr/22107988t/rappaurio-sae501_502.git
synced 2025-08-30 01:05:58 +02:00
991 lines
29 KiB
JavaScript
991 lines
29 KiB
JavaScript
/**
|
||
* @name CeL function for console
|
||
*
|
||
* @fileoverview 本檔案包含了 console 操作用的 functions。<br />
|
||
* a.k.a. 一般論壇 (BBS) ANSI color 轉換程式。
|
||
*
|
||
* @since 2015/3/1 13:16:6
|
||
*/
|
||
|
||
'use strict';
|
||
|
||
// More examples: see /_test suite/test.js
|
||
|
||
// ------------------------------------------------------------------------------------------------
|
||
|
||
typeof CeL === 'function' && CeL.run({
|
||
name : 'interact.console',
|
||
// includes() @ data.code.compatibility.
|
||
require : 'data.code.compatibility.|data.native.to_RegExp_pattern',
|
||
|
||
// 為了方便格式化程式碼，因此將 module 函式主體另外抽出。
|
||
code : module_code
|
||
});
|
||
|
||
function module_code(library_namespace) {
|
||
|
||
// requiring
|
||
var to_RegExp_pattern = this.r('to_RegExp_pattern');
|
||
|
||
/**
|
||
* null module constructor
|
||
*
|
||
* @class console 處理的 functions
|
||
*/
|
||
var _// JSDT:_module_
|
||
= function() {
|
||
// null module constructor
|
||
};
|
||
|
||
/**
|
||
* for JSDT: 有 prototype 才會將之當作 Class
|
||
*/
|
||
_// JSDT:_module_
|
||
.prototype = {};
|
||
|
||
// -------------------------------------------------------------
|
||
|
||
/**
|
||
* 本 module 所有 library_namespace.debug() 可能使用到之相關函數，所須使用之最低 debug level。
|
||
*
|
||
* @type {ℕ⁰:Natural+0}
|
||
*
|
||
* @see function new_SGR(messages) @ base.js
|
||
*/
|
||
var min_debug = 3;
|
||
|
||
// -------------------------------------------------------------
|
||
//
|
||
|
||
/**
|
||
* parse style name
|
||
*
|
||
* @param {String|Object}style_name
|
||
* style name to parse
|
||
*
|
||
* @returns {String}style name
|
||
*
|
||
* @see <span title="Select Graphic Rendition">SGR</span> parameters
|
||
*/
|
||
function SGR_style_name(style_name) {
|
||
library_namespace.debug({
|
||
// gettext_config:{"id":"search-style-name-$1-in-`sgr_code.style_name_alias`"}
|
||
T : [ 'Search style name [%1] in `SGR_code.style_name_alias`...',
|
||
style_name ]
|
||
}, min_debug, 'SGR_style_name');
|
||
if (typeof style_name !== 'object'
|
||
&& (style_name in SGR_code.style_name_alias))
|
||
style_name = SGR_code.style_name_alias[style_name];
|
||
if (library_namespace.is_debug() && (typeof style_name === 'object'
|
||
//
|
||
|| !(style_name in SGR_code.style_data))) {
|
||
library_namespace.warn([ 'SGR_style_name: ', {
|
||
// gettext_config:{"id":"unknown-style-name-$1"}
|
||
T : [ 'Unknown style name: [%1].', style_name ]
|
||
} ]);
|
||
}
|
||
return style_name;
|
||
}
|
||
|
||
/**
|
||
* parse style value
|
||
*
|
||
* @param style_value
|
||
* style value to parse
|
||
* @param {String}[style_name]
|
||
* style name to referrer
|
||
*
|
||
* @returns {String} style value
|
||
*/
|
||
function SGR_style_value(style_value, style_name) {
|
||
// TODO: using "brightred", "boldred"
|
||
// http://git-scm.com/docs/git-config#Documentation/git-config.txt-color
|
||
|
||
if (typeof style_value !== 'object'
|
||
&& (style_value in SGR_code.color_index)) {
|
||
if (typeof style_name !== 'string' || !(style_name in color_shift)) {
|
||
// Expects value in color_shift.
|
||
library_namespace.warn([ 'SGR_style_value: ', {
|
||
// gettext_config:{"id":"invalid-name-of-color-$1"}
|
||
T : [ 'Invalid name of color: [%1].', style_name ]
|
||
} ]);
|
||
return;
|
||
}
|
||
// color_shift[style_name] +
|
||
return SGR_code.color_index[style_value];
|
||
}
|
||
|
||
if (style_value in SGR_style_value.alias)
|
||
style_value = SGR_style_value.alias[style_value];
|
||
|
||
if (typeof style_value === 'boolean') {
|
||
if ((style_name in SGR_code.style_data)
|
||
&& SGR_code.style_data[style_name][style_value ? 0 : 1] === undefined) {
|
||
library_namespace.warn([ {
|
||
// gettext_config:{"id":"invalid-value-$1-of-style-$2"}
|
||
T : [ 'Invalid value [%1] of style: [%2]:',
|
||
//
|
||
style_value, style_name ]
|
||
}, {
|
||
// gettext_config:{"id":"unable-to-convert-the-value-to-a-style"}
|
||
T : '無法將真偽值轉為樣式。'
|
||
} ]);
|
||
return;
|
||
}
|
||
return style_value;
|
||
}
|
||
|
||
if (isNaN(style_value) || (style_value |= 0) < 0) {
|
||
library_namespace.warn([ {
|
||
// gettext_config:{"id":"invalid-value-$1-of-style-$2"}
|
||
T : [ 'Invalid value [%1] of style: [%2]:',
|
||
//
|
||
style_value, style_name ]
|
||
}, {
|
||
// gettext_config:{"id":"the-style-value-is-not-a-number"}
|
||
T : '欲設定的樣式值並非數字。'
|
||
} ]);
|
||
return;
|
||
}
|
||
|
||
// do more check.
|
||
if ((style_name in SGR_code.style_data)
|
||
&& !SGR_code.style_data[style_name].includes(style_value))
|
||
if (style_name in color_shift) {
|
||
if (style_value >= color_shift[style_name])
|
||
style_value -= color_shift[style_name];
|
||
} else {
|
||
library_namespace.warn([ {
|
||
// gettext_config:{"id":"invalid-value-$1-of-style-$2"}
|
||
T : [ 'Invalid value [%1] of style: [%2]:',
|
||
//
|
||
style_value, style_name ]
|
||
}, {
|
||
// gettext_config:{"id":"the-style-value-is-not-in-the-style-sheet-$1-that-can-be-set"}
|
||
T : [ '樣式值不在可設定的樣式資料[%1]中。',
|
||
//
|
||
SGR_code.style_data[style_name] ]
|
||
} ]);
|
||
return;
|
||
}
|
||
|
||
return style_value;
|
||
}
|
||
|
||
SGR_style_value.alias = {
|
||
'true' : true,
|
||
'false' : false
|
||
};
|
||
|
||
/**
|
||
* check if the style value is "reset" or not.
|
||
*
|
||
* @param style_value
|
||
* style value to check
|
||
*
|
||
* @returns {Boolean} the style value is "reset".
|
||
*/
|
||
function is_reset_style(style_value) {
|
||
return style_value === 0 || style_value === '0';
|
||
}
|
||
|
||
/**
|
||
* parse and add style to {SGR_style}(this).<br />
|
||
* 注意: 一般論壇 (BBS) 使用 VT100，遇到 \x20 (space) 即會終止解析而跳出。 但本函式依然會跳過空白而解析之。
|
||
*
|
||
* @param style
|
||
* style to add
|
||
*
|
||
* @returns {SGR_style}(this)
|
||
*/
|
||
function SGR_style_add(style) {
|
||
if (!style && !is_reset_style(style))
|
||
// skip.
|
||
return this;
|
||
|
||
library_namespace.debug({
|
||
// gettext_config:{"id":"searching-style-{$2}-$1-in-sgr_code.style_value_alias"}
|
||
T : [ 'Searching style {%2} [%1] in SGR_code.style_value_alias...',
|
||
typeof JSON === 'object' ? JSON.stringify(style) : style,
|
||
typeof style ]
|
||
}, min_debug, 'SGR_style_add');
|
||
if (typeof style !== 'object')
|
||
while (style in SGR_code.style_value_alias) {
|
||
library_namespace.debug({
|
||
// gettext_config:{"id":"find-style-$1-normalized-to-→-$2"}
|
||
T : [ 'Find style [%1] normalized to → [%2]', style,
|
||
SGR_code.style_value_alias[style] ]
|
||
}, min_debug, 'SGR_style_add');
|
||
style = SGR_code.style_value_alias[style];
|
||
}
|
||
|
||
library_namespace.debug({
|
||
// gettext_config:{"id":"parse-{$2}-$1-if-it-is-a-primitive-value"}
|
||
T : [ 'Parse {%2} [%1] if it is a primitive value.',
|
||
typeof JSON === 'object' ? JSON.stringify(style) : style,
|
||
typeof style ]
|
||
}, min_debug, 'SGR_style_add');
|
||
if (typeof style === 'string') {
|
||
if (style.includes(SGR_code.separator)) {
|
||
style = style.split(SGR_code.separator);
|
||
|
||
} else if (isNaN(style)) {
|
||
library_namespace.debug({
|
||
// gettext_config:{"id":"test-if-$1-is-+-style-name"}
|
||
T : [ 'Test if [%1] is "[+-] style name".', style ]
|
||
}, min_debug, 'SGR_style_add');
|
||
// "+bright"
|
||
var matched = style.match(/^([+\-])([^=]*?)$/);
|
||
if (matched && (matched[2] = SGR_style_name(matched[2].trim()))) {
|
||
matched[1] = matched[1] !== '-';
|
||
if (undefined === SGR_style_value(matched[1], matched[2]))
|
||
library_namespace.warn([ 'SGR_style_add: ', {
|
||
// gettext_config:{"id":"invalid-configuration-of-style-$1"}
|
||
T : [ 'Invalid configuration of style: [%1].',
|
||
// Expects integer.
|
||
matched[2] ]
|
||
} ]);
|
||
else {
|
||
library_namespace.debug({
|
||
// gettext_config:{"id":"set-style-$1-=-$2"}
|
||
T : [ 'Set style "%1" = %2.', matched[2],
|
||
matched[1] ]
|
||
}, min_debug, 'SGR_style_add');
|
||
this[matched[2]] = matched[1];
|
||
}
|
||
return this;
|
||
}
|
||
|
||
library_namespace.debug({
|
||
T : [
|
||
// gettext_config:{"id":"test-if-$1-is-style-name-=-style-value-(0-1-false-true-...)"}
|
||
'Test if [%1] is "style name = style value (0, 1, false, true, ...)".'
|
||
//
|
||
, style ]
|
||
}, min_debug, 'SGR_style_add');
|
||
matched = style.match(/^([^=]+)=(.+)$/);
|
||
if (matched && (matched[1] = SGR_style_name(matched[1].trim()))) {
|
||
if (undefined !== (matched[2] = SGR_style_value(matched[2]
|
||
.trim(), matched[1])))
|
||
this[matched[1]] = matched[2];
|
||
return this;
|
||
}
|
||
|
||
// 死馬當活馬醫。
|
||
style = SGR_style_name(style);
|
||
} else {
|
||
style |= 0;
|
||
}
|
||
} else if (typeof style === 'number') {
|
||
style |= 0;
|
||
}
|
||
|
||
if (library_namespace.is_Object(style) || style instanceof SGR_style) {
|
||
library_namespace.debug({
|
||
T : [
|
||
// gettext_config:{"id":"parse-{$2}-$1-if-it-is-a-object"}
|
||
'Parse {%2} [%1] if it is a object.',
|
||
typeof JSON === 'object' ? JSON.stringify(style)
|
||
: style, typeof style ]
|
||
}, min_debug, 'SGR_style_add');
|
||
Object.keys(style).some(
|
||
function(style_name) {
|
||
var style_value = style[style_name];
|
||
if (!(style_name = SGR_style_name(style_name))) {
|
||
// 已於 SGR_style_name() 警告過。
|
||
return;
|
||
}
|
||
|
||
style_value = SGR_style_value(style_value, style_name);
|
||
if (style_value !== undefined) {
|
||
library_namespace.debug({
|
||
T : [ 'Set style "%1" = [%2].', style_name,
|
||
style_value ]
|
||
}, min_debug + 1, 'SGR_style_add');
|
||
this[style_name] = style_value;
|
||
} else if (is_reset_style(style_value)) {
|
||
library_namespace.debug({
|
||
// gettext_config:{"id":"reset-style-{$2}-$1"}
|
||
T : [ 'Reset style {%2} [%1].', style,
|
||
typeof style ]
|
||
}, min_debug + 1, 'SGR_style_add');
|
||
this.to_reset();
|
||
return true;
|
||
}
|
||
}, this);
|
||
|
||
} else if (Array.isArray(style)) {
|
||
style.forEach(function(value) {
|
||
this.add(value);
|
||
}, this);
|
||
|
||
} else if (30 <= style && style <= 37) {
|
||
this.foreground = style;
|
||
} else if (40 <= style && style <= 47) {
|
||
this.background = style;
|
||
} else if (is_reset_style(style)) {
|
||
library_namespace.debug({
|
||
// gettext_config:{"id":"reset-style-{$2}-$1"}
|
||
T : [ 'Reset style {%2} [%1].', style, typeof style ]
|
||
}, min_debug, 'SGR_style_add');
|
||
this.to_reset();
|
||
} else if (library_namespace.is_debug()) {
|
||
library_namespace.warn([ 'SGR_style_add: ', {
|
||
// gettext_config:{"id":"unknown-style-$1"}
|
||
T : [ 'Unknown style: [%1].', style ]
|
||
} ]);
|
||
}
|
||
|
||
return this;
|
||
}
|
||
|
||
/**
|
||
* SGR style Class
|
||
*
|
||
* @param [style]
|
||
* style to set
|
||
*
|
||
* @returns {SGR_style}(this)
|
||
*/
|
||
function SGR_style(style, options) {
|
||
if (false)
|
||
if (library_namespace.is_Object(options))
|
||
this.options = options;
|
||
// 對於 Object.create(null)，這邊會出錯。
|
||
library_namespace.debug('Set style ['
|
||
+ (typeof JSON === 'object' ? JSON.stringify(style) : style)
|
||
+ ']', min_debug, 'SGR_style');
|
||
this.add(style);
|
||
library_namespace.debug('Set style ['
|
||
+ (typeof JSON === 'object' ? JSON.stringify(style) : style)
|
||
+ '] finished.', min_debug + 1, 'SGR_style');
|
||
}
|
||
|
||
/**
|
||
* indicate the color styles.<br />
|
||
* 實際上應該列出所有設定值超過一種的樣式/格式名。
|
||
*
|
||
* @type {Object}
|
||
*/
|
||
var color_shift = {
|
||
foreground : 30,
|
||
background : 40
|
||
};
|
||
|
||
Object.assign(SGR_style.prototype, {
|
||
add : SGR_style_add,
|
||
forEach : function(callback, thisArg) {
|
||
// 下面當前不使用。
|
||
if (false) {
|
||
var style_names = Object.keys(this);
|
||
if (this.options)
|
||
// remove 'options'.
|
||
style_names.splice(style_names.indexOf('options'), 2);
|
||
style_names.forEach(callback, thisArg || this);
|
||
}
|
||
|
||
Object.keys(this).forEach(callback, thisArg || this);
|
||
},
|
||
|
||
to_reset : function() {
|
||
library_namespace.debug('Reset style.', min_debug,
|
||
'SGR_style.prototype.to_reset');
|
||
this.forEach(function(style_name) {
|
||
delete this[style_name];
|
||
});
|
||
this.reset = true;
|
||
return this;
|
||
},
|
||
|
||
clone : function(options) {
|
||
library_namespace.debug('Clone style [' + this + '].', min_debug,
|
||
'SGR_style.prototype.clone');
|
||
var result = new SGR_style();
|
||
this.forEach(function(style_name) {
|
||
result[style_name] = this[style_name];
|
||
});
|
||
if (false)
|
||
if (options = options || this.options)
|
||
result.options = options;
|
||
return result;
|
||
},
|
||
|
||
to_Array : function() {
|
||
var array = [];
|
||
if (library_namespace.is_debug(min_debug))
|
||
library_namespace.debug('style [' + Object.keys(this) + ']', 1,
|
||
'SGR_style.prototype.to_Array');
|
||
if (false)
|
||
for ( var name in this)
|
||
library_namespace.debug('[' + name + ']', min_debug + 1);
|
||
this.forEach(function(style_name) {
|
||
var value = this[style_name];
|
||
library_namespace.debug('style "' + style_name + '" ['
|
||
+ SGR_code.style_data[style_name] + '] = ('
|
||
+ (typeof value) + ') [' + value + ']', min_debug + 1,
|
||
'SGR_style.prototype.to_Array');
|
||
if (style_name in color_shift) {
|
||
if (typeof value === 'boolean')
|
||
value = SGR_code.style_data[style_name]
|
||
// 0: on, 1: off.
|
||
[value ? 0 : 1];
|
||
else if (value < color_shift[style_name])
|
||
// 正常情況。
|
||
value += color_shift[style_name];
|
||
else if (isNaN(value))
|
||
library_namespace.warn('Invalid ' + style_name
|
||
+ ' color [' + value + ']');
|
||
} else if (typeof value !== 'number')
|
||
// 正常情況。
|
||
value = SGR_code.style_data[style_name]
|
||
// 0: on, 1: off.
|
||
[value ? 0 : 1];
|
||
if (typeof value === 'number')
|
||
array.push(value);
|
||
// else: e.g., reset.
|
||
});
|
||
library_namespace.debug('style array [' + array + ']',
|
||
min_debug + 1, 'SGR_style.prototype.to_Array');
|
||
array.sort();
|
||
library_namespace.debug('sorted style array [' + array + ']',
|
||
min_debug, 'SGR_style.prototype.to_Array');
|
||
return array;
|
||
},
|
||
// (): use default CSI
|
||
// (false): No CSI
|
||
toString : function(CSI, end_code) {
|
||
var code = this.to_Array().join(SGR_code.separator);
|
||
library_namespace.debug('code [' + code + ']', min_debug,
|
||
'SGR_style.prototype.toString');
|
||
// 假如有設定 .reset，那應該會有 '0'。
|
||
// 否則代表是空的 style，此時不回傳以避免被當作 reset。
|
||
if (code && (CSI || CSI === undefined))
|
||
code = (CSI || SGR_code.CSI) + code
|
||
+ (end_code || SGR_code.end_code);
|
||
return code;
|
||
}
|
||
});
|
||
|
||
// -------------------------------------------------------------
|
||
|
||
/**
|
||
* cf. String.prototype.split ( separator, limit )
|
||
*
|
||
* @returns [ {SGR_code} ]
|
||
*/
|
||
function SGR_split(separator, limit) {
|
||
// TODO
|
||
throw new Error('SGR_split: Not Yet Implemented!');
|
||
}
|
||
|
||
/**
|
||
* cf. String.prototype.slice ( start, end )
|
||
*
|
||
* @returns {SGR_code}
|
||
*/
|
||
function SGR_slice() {
|
||
var result = new SGR_code(this.text.split(start, end));
|
||
result.style = this.style.split(start, end);
|
||
result.style.forEach(function(style, index) {
|
||
result[index] = result[index].clone();
|
||
});
|
||
return result;
|
||
}
|
||
|
||
/**
|
||
* 會改變 (this)!<br />
|
||
* cf. Array.prototype.concat ( ...arguments )
|
||
*
|
||
* @param {String|SGR_code}value
|
||
*
|
||
* @returns {SGR_code} (this)
|
||
*/
|
||
function SGR_concat(value) {
|
||
var index = 0, length = argument.length,
|
||
//
|
||
text_list = [ this.text ], value;
|
||
for (; index < length; index++)
|
||
if (is_SGR_code(value = argument[index])) {
|
||
// treat as {SGR_code}
|
||
text_list = text_list.join('');
|
||
this.style.forEach(function(style, index) {
|
||
this.style[text_list.length + index] = style;
|
||
}, this);
|
||
text_list = [ text_list, value.text ];
|
||
} else if (value)
|
||
// treat as {String}
|
||
text_list.push(value);
|
||
this.text = text_list.join('');
|
||
return this;
|
||
}
|
||
|
||
/**
|
||
* parse styled text.
|
||
*
|
||
* @param {String}styled_text
|
||
* text with style
|
||
* @param {Object}[options]
|
||
* options : { CSI : '' }
|
||
*
|
||
* @returns {Array} [ text, style ]
|
||
*/
|
||
function SGR_parse(styled_text, options) {
|
||
// console.log('to_RegExp_pattern: ' + typeof to_RegExp_pattern);
|
||
// console.log('to_RegExp_pattern: ' + to_RegExp_pattern);
|
||
var text_now = '', style = [], matched, lastIndex = 0,
|
||
//
|
||
pattern = new RegExp(to_RegExp_pattern(options.CSI || SGR_code.CSI)
|
||
+ '([\\d{1,3}\\s\\' + (options.separator || SGR_code.separator)
|
||
+ ']*)'
|
||
+ to_RegExp_pattern(options.end_code || SGR_code.end_code), 'g');
|
||
|
||
while (matched = pattern.exec(styled_text)) {
|
||
library_namespace.debug(matched.join(), min_debug, 'SGR_parse');
|
||
text_now += styled_text.slice(lastIndex, matched.index);
|
||
style[text_now.length] = new SGR_style(matched[1] || 0);
|
||
lastIndex = pattern.lastIndex;
|
||
}
|
||
|
||
return [ text_now + styled_text.slice(lastIndex), style ];
|
||
}
|
||
|
||
/**
|
||
* parse text token with style.
|
||
*
|
||
* @param {Array}text_Array
|
||
* text token and style.<br /> [ {String}text, {Object}style,
|
||
* {String}text, .. ]<br />
|
||
* 預設 [0] 為 text，之後 style, text, style, ... 交替
|
||
* @param {Object}[options]
|
||
* options : { CSI : '' }
|
||
*
|
||
* @returns {Array} [ text, style ]
|
||
*/
|
||
function SGR_parse_list(text_Array, options) {
|
||
var text_now = '', style = [],
|
||
//
|
||
index = 0, length = text_Array.length, text_length;
|
||
|
||
for (; index < length; index++) {
|
||
if (typeof text_Array[index] !== 'object')
|
||
text_now += text_Array[index++];
|
||
if (index < length)
|
||
if (style[text_length = text_now.length])
|
||
style[text_length].add(text_Array[index]);
|
||
else
|
||
style[text_length] = new SGR_style(text_Array[index]);
|
||
}
|
||
|
||
return [ text_now, style ];
|
||
}
|
||
|
||
/**
|
||
* get / set SGR style.
|
||
*
|
||
* @param {integer}index
|
||
* index of text
|
||
* @param {Object|String|Boolean}[style]
|
||
* the style to set.<br />
|
||
* undefined: 從頭遍歷，取得某一 index 的 style。比起 `true` 取得的更準確。<br />
|
||
* 0: reset style (e.g., normal color)<br />
|
||
* null: remove style<br />
|
||
* true: 單純取得某一 index 的 style，不從頭遍歷。如此取得的可能是錯誤的 style。<br />
|
||
* others: 設定 style。
|
||
* @param {integer}[to_index]
|
||
*
|
||
* @returns {SGR_style}
|
||
*/
|
||
function SGR_style_at(index, style, to_index) {
|
||
index |= 0;
|
||
if (style === null) {
|
||
// e.g., .style_at(index, null)
|
||
delete this.style[index];
|
||
return;
|
||
}
|
||
|
||
if (style === true) {
|
||
// e.g., .style_at(index, true)
|
||
return this.style[index];
|
||
}
|
||
|
||
var style_now;
|
||
// 從頭遍歷。
|
||
library_namespace.debug('Start traversing to ' + index, min_debug,
|
||
'SGR_style_at');
|
||
this.style.some(function(this_style, this_index) {
|
||
if (this_index > index)
|
||
return true;
|
||
|
||
library_namespace.debug('Traversing to index ' + this_index,
|
||
min_debug + 1, 'SGR_style_at');
|
||
if (style_now) {
|
||
// TODO: reduce. 決定最短顯示法。
|
||
style_now.add(this_style);
|
||
} else
|
||
style_now = this_style.clone();
|
||
});
|
||
|
||
if (!style_now)
|
||
style_now = new SGR_style();
|
||
|
||
if (style) {
|
||
// 設定
|
||
library_namespace.debug('Set style of "' + this.text + '"[' + index
|
||
+ '] = [' + style + ']', min_debug, 'SGR_style_at');
|
||
if (!this.style[index])
|
||
this.style[index] = style_now;
|
||
style_now.add(style = new SGR_style(style));
|
||
|
||
library_namespace
|
||
.debug('Set `to_index`', min_debug, 'SGR_style_at');
|
||
if (index < to_index) {
|
||
// TODO: 更有效率點。
|
||
while (index < to_index)
|
||
if (this.style[index]) {
|
||
var inter_style = this.style[index];
|
||
delete inter_style.reset;
|
||
style.forEach(function(style_name) {
|
||
// 覆寫設定。
|
||
delete inter_style[style_name];
|
||
})
|
||
}
|
||
}
|
||
} else if (is_reset_style(style)) {
|
||
this.style[index] = style_now.add(0);
|
||
} else {
|
||
// e.g., .style_at(index)
|
||
}
|
||
|
||
return style_now;
|
||
}
|
||
|
||
/**
|
||
* get full stylied String.
|
||
*
|
||
* @param {Boolean}[get_Array]
|
||
* get Array, else String.
|
||
*
|
||
* @returns {String}
|
||
*/
|
||
function SGR_style_toString(get_Array) {
|
||
var sequence = this.text.split('');
|
||
this.style.forEach(function(style, index) {
|
||
sequence[index] = style.toString()
|
||
// 在最後一個 item 時可能只剩 style。
|
||
+ (sequence[index] || '');
|
||
}, this);
|
||
return get_Array ? sequence : sequence.join('');
|
||
}
|
||
|
||
/**
|
||
* 測試 value 是否為 SGR_code instance。
|
||
*
|
||
* @param value
|
||
* 測試值。
|
||
*
|
||
* @returns {Boolean} 測試值為 SGR_code instance
|
||
*/
|
||
function is_SGR_code(value) {
|
||
return value instanceof SGR_code;
|
||
}
|
||
|
||
// -------------------------------------------------------------
|
||
|
||
/**
|
||
* ANSI escape code (or escape sequences) Class
|
||
*
|
||
* @param {String|Array}text
|
||
* text / text token
|
||
* @param {Object}[options]
|
||
* options : { CSI : '' }
|
||
*
|
||
* @see <a href="https://en.wikipedia.org/wiki/ANSI_escape_code#graphics"
|
||
* accessdate="2015/3/1 8:1" title="ANSI escape code (or escape
|
||
* sequences)"><span title="Select Graphic Rendition">SGR</span>
|
||
* parameters</a><br />
|
||
* <a href="http://vt100.net/docs/vt510-rm/SGR" accessdate="2015/3/1
|
||
* 8:1">SGR—Select Graphic Rendition</a>
|
||
*/
|
||
function SGR_code(text, options) {
|
||
if (false)
|
||
if (typeof options === 'string')
|
||
options = {
|
||
CSI : options
|
||
};
|
||
|
||
if (false) {
|
||
console.trace([ text, library_namespace.is_Object(text), options,
|
||
library_namespace.is_Object(options) ]);
|
||
}
|
||
if (library_namespace.is_Object(text) && !options) {
|
||
// 把 text 當作 options。
|
||
options = text;
|
||
text = null;
|
||
}
|
||
|
||
if (library_namespace.is_Object(options))
|
||
this.options = options;
|
||
|
||
options = Array.isArray(text) ? SGR_parse_list(text, options
|
||
|| Object.create(null))
|
||
// String(): 標準化 / normalization
|
||
: SGR_parse(String(text), options || Object.create(null));
|
||
|
||
this.text = options[0];
|
||
|
||
// {inner}private properties
|
||
// this.style[ index ] = new SGR_style();
|
||
this.style = options[1];
|
||
}
|
||
|
||
Object.assign(SGR_code.prototype, {
|
||
// SGR_style_to_HTML(style_mapping)
|
||
// to_HTML : SGR_style_to_HTML,
|
||
|
||
// style : SGR_style,
|
||
slice : SGR_slice,
|
||
// split : SGR_split,
|
||
concat : SGR_concat,
|
||
// TODO:
|
||
// splice : SGR_splice,
|
||
// chunk : SGR_chunk,
|
||
|
||
style_at : SGR_style_at,
|
||
// toJSON : SGR_style_toString,
|
||
toString : SGR_style_toString
|
||
});
|
||
|
||
/**
|
||
* ECMA-48 8.3.117 SGR - SELECT GRAPHIC RENDITION<br />
|
||
* 為允許使用者參照，因此放在 public。<br />
|
||
* 注意: 一般論壇 (BBS) 使用 VT100，僅支援如 reset, bold, blink, reverse, foreground,
|
||
* background。
|
||
*
|
||
* @type {Object}
|
||
*/
|
||
SGR_code.style_data = {
|
||
// name : [ on, off ]
|
||
// reset / normal
|
||
reset : [ 0, ],
|
||
// bold or increased intensity (bright / highlight / 高亮)
|
||
bold : [ 1, 22 ],
|
||
// faint, decreased intensity or second colour
|
||
faint : [ 2, 22 ],
|
||
// singly underlined (mono only)
|
||
underline : [ 4, 24 ],
|
||
// blink / 閃爍
|
||
// 5: slowly blinking less then 150 per minute,
|
||
// 6: rapidly blinking
|
||
blink : [ 5, 25 ],
|
||
// negative / positive image (反白, reverse type)
|
||
reverse : [ 7, 27 ],
|
||
// concealed characters (invisible image) 隱瞞,隱匿,隱蔽,隱藏來源
|
||
conceal : [ 8, 28 ],
|
||
// display (text color, foreground color, 文字部份前景色):
|
||
// 30–37
|
||
foreground : [ , library_namespace.platform.Windows
|
||
// Windows console 不支援 39。(e.g. node.js 下)
|
||
&& library_namespace.platform.nodejs ? 37 : 39 ],
|
||
// background color (背景色 / 底色): 40–47
|
||
background : [ , 49 ],
|
||
// Overlined / Not overlined
|
||
overline : [ 53, 55 ]
|
||
};
|
||
|
||
/**
|
||
* style name alias<br />
|
||
* 為允許使用者添增，因此放在 public。
|
||
*/
|
||
SGR_code.style_name_alias = {
|
||
normal : 'reset',
|
||
bright : 'bold',
|
||
highlight : 'bold',
|
||
hidden : 'conceal',
|
||
text : 'foreground',
|
||
color : 'foreground',
|
||
fg : 'foreground',
|
||
bg : 'background'
|
||
};
|
||
|
||
/**
|
||
* 添增 color name alias。
|
||
*
|
||
* @example <code>
|
||
|
||
// 使設定格式時，可使用中文顏色名稱。
|
||
CeL.interact.console.SGR.add_color_alias('黑紅綠黃藍紫青白'.split(''));
|
||
|
||
* </code>
|
||
*
|
||
* @param {Array}color_list
|
||
* color name list
|
||
*/
|
||
function add_color_alias(color_list) {
|
||
if (Array.isArray(color_list)) {
|
||
color_list.forEach(function(color, index) {
|
||
SGR_code.color_index[color] = index;
|
||
});
|
||
}
|
||
}
|
||
|
||
/**
|
||
* style value alias: style_value_alias[alias] = normalized<br />
|
||
* 為允許使用者添增，因此放在 public。
|
||
*/
|
||
SGR_code.style_value_alias = Object.create(null);
|
||
// SGR_code.color_index.black = 0
|
||
SGR_code.color_index = Object.create(null);
|
||
SGR_code.color = 'black,red,green,yellow,blue,magenta,cyan,white'
|
||
.split(',');
|
||
// 鎖定物件。
|
||
Object.seal(SGR_code.color);
|
||
add_color_alias(SGR_code.color);
|
||
|
||
// 一些初始設定。
|
||
|
||
// alias of number
|
||
(function() {
|
||
for ( var property in SGR_code.style_data) {
|
||
var value = SGR_code.style_data[property];
|
||
if (typeof value[0] === 'number')
|
||
SGR_code.style_value_alias[value[0]] = '+' + property;
|
||
if (typeof value[1] === 'number')
|
||
SGR_code.style_value_alias[value[1]] = '-' + property;
|
||
}
|
||
})();
|
||
// 鎖定物件。
|
||
Object.seal(SGR_code.style_data);
|
||
|
||
Object.assign(SGR_code, {
|
||
min_debug_level : min_debug,
|
||
add_color_alias : add_color_alias,
|
||
/**
|
||
* {String} Control Sequence Introducer, or Control Sequence Initiator.<br />
|
||
* "\x1b" : [Esc]<br />
|
||
* some 論壇 (BBS): 按 Esc 兩次, '\x1b\x1b['。
|
||
*
|
||
* @see https://en.wikipedia.org/wiki/ANSI_escape_code#Sequence_elements
|
||
*/
|
||
CSI : '\x1b[',
|
||
// do not modify this value!
|
||
default_CSI : '\x1b[',
|
||
separator : ';',
|
||
end_code : 'm',
|
||
|
||
is_SGR : is_SGR_code
|
||
});
|
||
|
||
// export
|
||
_.SGR = SGR_code;
|
||
_.SGR_style = SGR_style;
|
||
|
||
if (false) {
|
||
var SGR_style = CeL.interact.console.SGR_style;
|
||
console.log('Showing ' + (new SGR_style('fg=blue')).toString() + 'blue'
|
||
+ (new SGR_style({
|
||
reset : true
|
||
})).toString() + ' text');
|
||
|
||
// for SGR: @see test.js
|
||
}
|
||
|
||
// ----------------------------------------------------------------------------------------------------------------
|
||
|
||
function console_status() {
|
||
return {
|
||
// size. 注意: 這兩個值可能會被覆寫。
|
||
width : process.stdout.columns || 80,
|
||
height : process.stdout.rows || 25
|
||
};
|
||
}
|
||
|
||
_.console_status = console_status;
|
||
|
||
// ----------------------------------------------------------------------------------------------------------------
|
||
// CLI progress bar
|
||
|
||
// https://github.com/visionmedia/node-progress
|
||
// https://github.com/bubkoo/ascii-progress
|
||
// https://github.com/AndiDittrich/Node.CLI-Progress
|
||
function Progress_bar(max_value, options) {
|
||
if (max_value > 0)
|
||
this.max_value = max_value;
|
||
this.start_time = Date.now();
|
||
if (options) {
|
||
Object.assign(this, options);
|
||
if (this.rtl && !options.start_quote && !options.end_quote) {
|
||
var quote = this.end_quote;
|
||
this.end_quote = this.start_quote;
|
||
this.start_quote = quote;
|
||
}
|
||
}
|
||
}
|
||
|
||
_.Progress_bar = Progress_bar;
|
||
|
||
Progress_bar.prototype = {
|
||
progress_value : 0,
|
||
max_value : 1,
|
||
// 方向 direction
|
||
rtl : false,
|
||
|
||
start_quote : ' [',
|
||
end_quote : '] ',
|
||
use_quote : true,
|
||
|
||
// single character
|
||
filled : '=',
|
||
blank : ' ',
|
||
show : show_progress,
|
||
tick : tick_progress,
|
||
|
||
// schema. TODO
|
||
format : '\r%{pre_text}%{start_quote}%{bar}%{end_quote}%{post_text}'
|
||
}
|
||
|
||
function show_progress(progress_value, post_text, pre_text) {
|
||
var max_dots = this.bar_width;
|
||
if (!max_dots) {
|
||
// - 1: 預防顯示到最後一個字元，會自動跳行。
|
||
max_dots = console_status().width - 1;
|
||
}
|
||
max_dots |= 0;
|
||
if (this.pre_text)
|
||
max_dots -= this.pre_text.length;
|
||
if (this.post_text)
|
||
max_dots -= this.post_text.length;
|
||
if (this.use_quote) {
|
||
max_dots -= this.left_quote.length + this.right_quote.length;
|
||
}
|
||
|
||
// current progress value
|
||
this.progress_value = +progress_value || 0;
|
||
this.percentage = Math
|
||
.round(100 * this.progress_value / this.max_value)
|
||
+ '%';
|
||
// TODO: .eta
|
||
this.completed = this.progress_value >= this.max_value;
|
||
var progress_dots = Math.round(max_dots * this.progress_value
|
||
/ this.max_value);
|
||
|
||
var bar_text = [ this.pre_text || '',
|
||
this.use_quote && this.start_quote || '',
|
||
this.filled.repeat(progress_dots),
|
||
this.blank.repeat(max_dots - progress_dots),
|
||
this.use_quote && this.end_quote || '',
|
||
// suffix
|
||
this.post_text || '' ];
|
||
if (this.rtl) {
|
||
bar_text.reverse();
|
||
}
|
||
library_namespace.log_temporary(bar_text.join('\n'));
|
||
}
|
||
|
||
function tick_progress(delta, post_text, pre_text) {
|
||
this.show(this.progress_value + delta, post_text, pre_text);
|
||
}
|
||
|
||
return (_// JSDT:_module_
|
||
);
|
||
}
|