miscutils-api¶

антипаттерн-свалка различных полезных функций используемых другими библиотеками

In [1]:
// загрузка в браузер: 
//     <script src="lib/polyfill.min.js"></script>
//     <script src="lib/miscutils.js"></script> 

// загрузка в исходнике нода integra-node-red:
//     var { isEmpty, flatten } = this.context().global.get('miscutils')

// загрузка в function ноде integra-node-red:
//     var {randomElem} = global.get('miscutils')

// загрузка в nodejs:
require("babel-polyfill")
Object.assign(global, require('./miscutils.js'))
'ok'

miscutils-api
miscutils v1.44
Out[1]:
'ok'

ticks epochtime pass identity isnull notnull inc dec first second last spreadarg not flip range isArray isNumber isObject isString isFunction nextChar prevChar randomId randomNum randomElem areEqualValues comparePreserve compareStringsAsc compareStringsDesc compareNumbersAsc compareNumbersDesc compareKeys compareValues addition difference sum product valueOf mapToKey map filter reduce forEach find mapKeys filterKeys reduceKeys forEachKey findKey mapValues filterValues reduceValues forEachValue findValue applyAfter groupBy unique toUTC roundDate addOwnProp fromEntries getNested splitBy isEmpty isGuid isIdentifier capitalize decapitalize truncate flatten dismissCircular stringify parsePoint parsePolygon parseJson parseTimeSpan timespanToSeconds quoteAwareSplitBy splitPath splitLines splitByComma splitBySpace getDirs getFiles sleep xmlToJson getWeekNumber sortKeys padLeft padRight updateUrl

ticks¶

возвращает количество миллисекунд просшедших с 01/01/1970

In [2]:
ticks()
Out[2]:
1662456215481

epochtime¶

возвращает количество секунд просшедших с 01/01/1970

In [3]:
epochtime()
Out[3]:
1662456218.152

pass¶

ничего не делает и возвращает undefined

In [4]:
console.log(pass())

undefined

identity¶

возвращает первый аргумент

In [5]:
[ identity(1), identity('hi!') ]
Out[5]:
[ 1, 'hi!' ]

isnull¶

проверяет аргумент на отсутствие значения

In [6]:
[ isnull(0), isnull(1), isnull(''), isnull('hi!'), isnull(false), isnull(true), 
  isnull(undefined), isnull(null), isnull(NaN), isnull([]), isnull({}) ]
Out[6]:
[
  true,  false, true,
  false, true,  false,
  true,  true,  true,
  false, false
]

notnull¶

проверяет аргумент на наличие значения

In [7]:
[ isnull(0), isnull(1), isnull(''), isnull('hi!'), isnull(false), isnull(true), 
  isnull(undefined), isnull(null), isnull(NaN), isnull([]), isnull({}) ]
Out[7]:
[
  true,  false, true,
  false, true,  false,
  true,  true,  true,
  false, false
]

inc¶

инкрементирует аргумент

In [8]:
[ inc(1), inc(2) ]
Out[8]:
[ 2, 3 ]

dec¶

декрементирует аргумент

In [9]:
[ dec(2), dec(3) ]
Out[9]:
[ 1, 2 ]

first¶

возвращает первый элемент последовательности

In [10]:
[ first([]), first([1,2]), first([1,2,3]) ]
Out[10]:
[ undefined, 1, 1 ]

second¶

возвращает второй элемент последовательности

In [11]:
[ second([]), second([1,2]), second([1,2,3]) ]
Out[11]:
[ undefined, 2, 2 ]

last¶

возвращает последний элемент последовательности

In [12]:
[ last([]), last([1,2]), last([1,2,3]) ]
Out[12]:
[ undefined, 2, 3 ]

spreadarg¶

преобразует функцию принимающую множество аргументов в функцию принимающую один аргумент

In [13]:
var foo  = (a,b) => a+b;
var pair = [1,2];
spreadarg(foo)(pair)
Out[13]:
3

not¶

преобразует функцию в ее отрицание

In [14]:
var foo = (x) => x == 'apple';
[ foo('apple'), foo('orange'), not(foo)('apple'), not(foo)('orange') ]
Out[14]:
[ true, false, false, true ]

flip¶

меняет местами первый и второй аргументы функции

In [15]:
flip(console.log)('A','B')

B A

range¶

возвращает последовательность чисел от нуля до значения аргумента, не включая его

In [16]:
[ range(1), range(3) ]
Out[16]:
[ [ 0 ], [ 0, 1, 2 ] ]

isArray¶

проверяет что аргумент является массивом

In [17]:
[ isArray([]), isArray({}), isArray([1,2,3]), isArray(null), isNumber(NaN), isArray('') ]
Out[17]:
[ true, false, true, false, false, false ]

isNumber¶

проверяет что аргумент является числом

In [18]:
[ isNumber(123), isNumber({}), isNumber([1,2,3]), isNumber(null), isNumber(NaN), isArray('') ]
Out[18]:
[ true, false, false, false, false, false ]

isObject¶

проверяет что аргумент является объектом

In [19]:
[ isObject(123), isObject([]), isObject({}), isObject([1,2,3]), isObject(null), isObject(NaN) ]
Out[19]:
[ false, true, true, true, false, false ]

isString¶

проверяет что аргумент является строкой

In [20]:
[ isString('hi!'), isString({}), isString([1,2,3]), isString(null), isString(NaN), isString('') ]
Out[20]:
[ true, false, false, false, false, false ]

isFunction¶

проверяет что аргумент является функцией

In [21]:
[ isFunction(foo), isFunction({}), isFunction([1,2,3]), isFunction(null), isFunction(NaN), isFunction('') ]
Out[21]:
[ true, false, false, false, false, false ]

nextChar¶

возвращает следующий по алфавиту символ

In [22]:
[ nextChar('a'), nextChar('b'), nextChar('c') ]
Out[22]:
[ 'b', 'c', 'd' ]

prevChar¶

возвращает предыдущий по алфавиту символ

In [23]:
[ prevChar('b'), prevChar('c'), prevChar('d') ]
Out[23]:
[ 'a', 'b', 'c' ]

randomId¶

возвращает случайный строковый идентификатор

In [24]:
[ randomId(), randomId() ]
Out[24]:
[ 'gaaedzbs', 'wuedh' ]

randomNum¶

возвращает случайное целое число из диапазона включая начало и конец

In [25]:
[ randomNum(1,10), randomNum(1,2) ]
Out[25]:
[ 7, 2 ]

randomElem¶

возвращает случайный элемент последовательности

In [26]:
[ randomElem([1,2,3]) ]
Out[26]:
[ 1 ]

areEqualValues¶

сравнивает значения пары аргументов по следующей формуле
(x == y) || (x == null && y == null) || (String(x) === String(y))

необходимо использовать эту функцию для сравнения значений параметров

In [27]:
areEqualValues(null, undefined)
Out[27]:
true

comparePreserve¶

функция упорядочивания всегда возвращающая ноль т.е. одинаковый порядок

In [28]:
[ comparePreserve(1,1), comparePreserve(1,2) ]
Out[28]:
[ 0, 0 ]

compareStringsAsc¶

функция упорядочивания строк по алфавиту

In [29]:
[ compareStringsAsc('ab','bb'), compareStringsAsc('ab','ab'), compareStringsAsc('bb','ab') ]
Out[29]:
[ -1, 0, 1 ]

compareStringsDesc¶

функция упорядочивания строк в порядке обратном алфавитному

In [30]:
[ compareStringsDesc('ab','bb'), compareStringsDesc('ab','ab'), compareStringsDesc('bb','ab') ]
Out[30]:
[ 1, 0, -1 ]

compareNumbersAsc¶

функция упорядочивания чисел по возрастанию

In [31]:
[ compareNumbersAsc(12,13), compareNumbersAsc(12,12), compareNumbersAsc(13,12) ]
Out[31]:
[ -1, 0, 1 ]

compareNumbersDesc¶

функция упорядочивания чисел по убыванию

In [32]:
[ compareNumbersDesc(12,13), compareNumbersDesc(12,12), compareNumbersDesc(13,12) ]
Out[32]:
[ 1, 0, -1 ]

compareKeys¶

преобразует функцию упорядочивания в функцию упорядочивания ключей словаря

In [33]:
var data = Object.entries({ 'a1': 11, 'z1': 31, 'b1': 21 })
data.sort(compareKeys(compareStringsAsc))
Out[33]:
[ [ 'a1', 11 ], [ 'b1', 21 ], [ 'z1', 31 ] ]

compareValues¶

преобразует функцию упорядочивания в функцию упорядочивания значений словаря

In [34]:
var data = Object.entries({ 'a1': 11, 'z1': 31, 'b1': 21 })
data.sort(compareValues(compareNumbersDesc))
Out[34]:
[ [ 'z1', 31 ], [ 'b1', 21 ], [ 'a1', 11 ] ]

addition¶

складывает два аргумента

In [35]:
addition(1,2)
Out[35]:
3

difference¶

вычитает второй аргумент из первого

In [36]:
difference(1,2)
Out[36]:
-1

sum¶

складывает все аргументы

In [37]:
[ sum(1,2,3), sum(1), sum() ]
Out[37]:
[ 6, 1, 0 ]

product¶

перемножает все аргументы

In [38]:
[ product(1,2,3), product(1), product() ]
Out[38]:
[ 6, 1, 1 ]

valueOf¶

возвращает функцию считывающую из объекта атрибут с заданным именем

In [39]:
var obj = { a: 123, b: 321 }
valueOf('a')(obj)
Out[39]:
123

mapToKey¶

преобразовывает массив словарь, где ключем каждого элемента является: либо значение заданного атрибута либо результат преобразования функцией

In [40]:
var arr = [ {a:1}, {a:2}, {a:3} ]
console.log(mapToKey('a')(arr))
console.log(mapToKey(x => x.a+1)(arr))

{ '1': { a: 1 }, '2': { a: 2 }, '3': { a: 3 } }
{ '2': { a: 1 }, '3': { a: 2 }, '4': { a: 3 } }

map¶

функциональная форма функции Array.prototype.map
для словаря элементом последовательности будет пара ключ-значение

In [41]:
console.log(map(inc)([1,2,3]))
console.log(map(spreadarg(addition))({a:1,b:2,c:3}))

[ 2, 3, 4 ]
[ 'a1', 'b2', 'c3' ]

filter¶

функциональная форма функции Array.prototype.filter
для словаря элементом последовательности будет пара ключ-значение

In [42]:
console.log(filter(x => x%2)([1,2,3]))
console.log(filter(([k,v]) => v%2)({a:1,b:2,c:3}))

[ 1, 3 ]
[ [ 'a', 1 ], [ 'c', 3 ] ]

reduce¶

функциональная форма функции Array.prototype.reduce
для словаря элементом последовательности будет пара ключ-значение

In [43]:
console.log(reduce(addition)([1,2,3]))
console.log(reduce(addition)({a:1,b:2,c:3}))

6
a,1b,2c,3

forEach¶

функциональная форма функции Array.prototype.forEach
для словаря элементом последовательности будет пара ключ-значение

In [44]:
forEach((x,i) => console.log(i,x))([1,2,3])
forEach((x,i) => console.log(i,x))({a:1,b:2,c:3})

0 1
1 2
2 3
0 [ 'a', 1 ]
1 [ 'b', 2 ]
2 [ 'c', 3 ]

find¶

функциональная форма функции Array.prototype.forEach
для словаря элементом последовательности будет пара ключ-значение

In [45]:
console.log(find(x => x%2)([1,2,3]))
console.log(find(([k,v]) => v%2)({a:1,b:2,c:3}))

1
[ 'a', 1 ]

mapKeys¶

функциональная форма функции Array.prototype.map (для словаря элементом последовательности будет ключ

In [46]:
console.log(mapKeys(inc)([1,2,3]))
console.log(mapKeys(k => nextChar(k))({a:1,b:2,c:3}))

[ 2, 3, 4 ]
[ 'b', 'c', 'd' ]

filterKeys¶

функциональная форма функции Array.prototype.filter
для словаря элементом последовательности будет ключ

In [47]:
console.log(filterKeys(x => x%2)([1,2,3]))
console.log(filterKeys(k => k =='b')({a:1,b:2,c:3}))

[ 1, 3 ]
[ 'b' ]

reduceKeys¶

функциональная форма функции Array.prototype.reduce
для словаря элементом последовательности будет ключ

In [48]:
console.log(reduceKeys(addition)([1,2,3]))
console.log(reduceKeys(addition)({a:1,b:2,c:3}))

6
abc

forEachKey¶

функциональная форма функции Array.prototype.forEach
для словаря элементом последовательности будет ключ

In [49]:
forEachKey((x,i) => console.log(i,x))([1,2,3])
forEachKey((x,i) => console.log(i,x))({a:1,b:2,c:3})

0 1
1 2
2 3
0 a
1 b
2 c

findKey¶

функциональная форма функции Array.prototype.find
для словаря элементом последовательности будет ключ

In [50]:
console.log(findKey(x => x%2)([1,2,3]))
console.log(findKey(k => k=='b')({a:1,b:2,c:3}))

1
b

mapValues¶

функциональная форма функции Array.prototype.map
для словаря элементом последовательности будет значение

In [51]:
console.log(mapValues(inc)([1,2,3]))
console.log(mapValues(inc)({a:1,b:2,c:3}))

[ 2, 3, 4 ]
[ 2, 3, 4 ]

filterValues¶

функциональная форма функции Array.prototype.filter
для словаря элементом последовательности будет значение

In [52]:
console.log(filterValues(x => x%2)([1,2,3]))
console.log(filterValues(x => x%2)({a:1,b:2,c:3}))

[ 1, 3 ]
[ 1, 3 ]

reduceValues¶

функциональная форма функции Array.prototype.reduce
для словаря элементом последовательности будет значение

In [53]:
console.log(reduceValues(addition)([1,2,3]))
console.log(reduceValues(addition)({a:1,b:2,c:3}))

6
6

forEachValue¶

функциональная форма функции Array.prototype.forEach
для словаря элементом последовательности будет значение

In [54]:
forEachValue((x,i) => console.log(i,x))([1,2,3])
forEachValue((x,i) => console.log(i,x))({a:1,b:2,c:3})

0 1
1 2
2 3
0 1
1 2
2 3

findValue¶

функциональная форма функции Array.prototype.find
для словаря элементом последовательности будет значение

In [55]:
console.log(findValue(x => x%2)([1,2,3]))
console.log(findValue(x => x%2)({a:1,b:2,c:3}))

1
1

applyAfter¶

создает функцию сначала преобразовывающую все свои аргументы при помощи заданной функции, а затем преобразованные аргументы подаются заданному оператору

In [56]:
var data = Object.entries({ 'a1': 11, 'z1': 31, 'b1': 21 })
data.sort(applyAfter(valueOf(1))(compareNumbersAsc))
Out[56]:
[ [ 'a1', 11 ], [ 'b1', 21 ], [ 'z1', 31 ] ]

groupBy¶

группирует элементы последовательности по значению их атрибута или результату выполнения преобразования

In [57]:
var arr = [ {a:1,b:1}, {a:1,b:2}, {a:2,b:3}, {a:2,b:4} ]
console.log(groupBy(arr, 'a'))
console.log(groupBy(arr, x => x.a+1))

{
  '1': [ { a: 1, b: 1 }, { a: 1, b: 2 } ],
  '2': [ { a: 2, b: 3 }, { a: 2, b: 4 } ]
}
{
  '2': [ { a: 1, b: 1 }, { a: 1, b: 2 } ],
  '3': [ { a: 2, b: 3 }, { a: 2, b: 4 } ]
}

unique¶

возвращает уникальные элементы последовательности

In [58]:
unique([1,2,2,3,3,1])
Out[58]:
[ 1, 2, 3 ]

xmlToJson¶

сконвертировать xml в json

In [2]:
const {JSDOM} = require('jsdom');

var xml = `<root>
    <section>
        <item attr1="attr1" attr2="attr2">val1</item>
        <item attr3="attr3" />
    </section>
</root>
`
var dom = new JSDOM(xml, { contentType: 'text/xml' }).window.document;

console.log(JSON.stringify(xmlToJson(dom), null, 2));

{
  "root": {
    "$text": [
      "\n    ",
      "\n"
    ],
    "section": {
      "$text": [
        "\n        ",
        "\n        ",
        "\n    "
      ],
      "item": [
        {
          "$attributes": {
            "attr1": "attr1",
            "attr2": "attr2"
          },
          "$text": "val1"
        },
        {
          "$attributes": {
            "attr3": "attr3"
          }
        }
      ]
    }
  }
}

getWeekNumber¶

для заданной даты возвращает номер недели в году начиная с 1

In [59]:
[ getWeekNumber(new Date()), getWeekNumber(new Date('01/01/2022 00:00')) ]
Out[59]:
[ 36, 1 ]

toUTC¶

конвертирует локальное время в UTC количество миллисекунд

In [60]:
[ new Date(), toUTC(new Date()) ]
Out[60]:
[ 2022-09-06T09:26:45.391Z, 1662456405000 ]

roundDate¶

округляет дату до указанного количества секунд

In [3]:
[
    new Date(),
    roundDate(new Date(), 60),       // округление до минут
    roundDate(new Date(), 60*60),    // округление до часов
    roundDate(new Date(), 24*60*60), // округление до дней
    roundDate(new Date()),
]
Out[3]:
[
  2023-01-09T07:58:16.586Z,
  2023-01-09T07:58:00.000Z,
  2023-01-09T07:00:00.000Z,
  2023-01-09T00:00:00.000Z,
  2023-01-09T00:00:00.000Z
]

addOwnProp¶

создает объекту дополнительное невидимое свойство

In [61]:
var obj = { a: 1 }
addOwnProp(obj, 'b',2);
[ obj.a, obj.b, obj ]
Out[61]:
[ 1, 2, { a: 1 } ]

fromEntries¶

тоже самое что Object.fromEntries

In [62]:
fromEntries([['a',1],['b',2]])
Out[62]:
{ a: 1, b: 2 }

getNested¶

альтернатива использованию null chain оператора ?.

In [63]:
var obj = { a: { b: { c: 1 } } }
getNested(obj, 'a', 'b', 'c')
Out[63]:
1

isEmpty¶

проверяет любую коллекцию на отсутствие элементов

In [64]:
[ isEmpty([]), isEmpty({}), isEmpty(''), isEmpty([1]), isEmpty({a:1}), isEmpty('hi!') ]
Out[64]:
[ true, true, true, false, false, false ]

sortKeys¶

сортирует ключи в объекте при помощи функции очередности по умолчанию сортирует по алфавиту

In [65]:
var obj = { 'a1': 11, 'z1': 31, 'b1': 21 }
var obj = sortKeys(obj)
obj
Out[65]:
{ a1: 11, b1: 21, z1: 31 }

padLeft¶

дополняет строку слева указанным символом до заданной длинны

In [66]:
[ padLeft('1', 3, '0'), padLeft('1') ]
Out[66]:
[ '001', '01' ]

padRight¶

дополняет строку справа указанным симповолом до заданной длинны

In [67]:
[ padRight('1', 3, '0'), padRight('1') ]
Out[67]:
[ '100', '10' ]

splitBy¶

разбивает текст на подстроки разделителем и удаляет пустые элементы

In [68]:
var text = '1 2 3   4'
splitBy(' ')(text)
Out[68]:
[ '1', '2', '3', '4' ]

isGuid¶

проверяет что строка является корректным гуидом

In [69]:
[ isGuid('42f44008-d0b3-4867-87df-a5a68db51b26'), isGuid('42f44008-d0b3-4867-87df-ERR') ]
Out[69]:
[ true, false ]

isIdentifier¶

проверяет что строка является корректным идентификатором для языка C#

In [70]:
[ isIdentifier('a123'), isIdentifier('1'), isIdentifier('_'), isIdentifier('') ]
Out[70]:
[ true, false, true, false ]

capitalize¶

переводит первую букву строки в верхний регистр

In [71]:
capitalize('item')
Out[71]:
'Item'

decapitalize¶

переводит первую букву строки в нижний регистр

In [72]:
decapitalize('Item')
Out[72]:
'item'

truncate¶

сокращает текст до указанной длинны

In [73]:
truncate('In recent years, the internet and its impact have grown tremendously', 16)
Out[73]:
'In recent years...'

flatten¶

без использования рекурсии выпрямляет структуру любой вложенности основанную на массивах в плоский массив

In [74]:
flatten([1,[[2],[[3]]],4])
Out[74]:
[ 1, 2, 3, 4 ]

dismissCircular¶

создает replacer функцию для JSON.stringify с заданием максимального уровня вложенности

In [75]:
var obj = { a: 1 }
obj.o   = obj
// JSON.stringify(obj) // TypeError: Converting circular structure to JSON
JSON.stringify(obj, dismissCircular(10))
Out[75]:
'{"a":1}'

stringify¶

ковертирует значение в JSON так же, как JSON.stringify, но обработкой рекурсивных ссылок атрибут maxdepth задает максимальную глубину рекурсии атрибут scape задает размер пробела

In [76]:
console.log(stringify({a:1}, {maxdepth:10,space:2}))
console.log(stringify({a:1}))

{
  "a": 1
}
{"a":1}

parsePoint¶

конвертирует POSTGIS строку с геоточкой в массив из двух элементов содержащий долготу и широту точки

In [77]:
[ parsePoint('POINT(50.22208228 53.2362814)'), parsePoint('') ]
Out[77]:
[ [ 50.22208228, 53.2362814 ], [] ]

parsePolygon¶

конвертирует POSTGIS строку с полигоном в массив пар содержащих долготу и широту точек полигона

In [78]:
parsePolygon('POLYGON((50.22205734252930 53.23633956909180,50.22212782475368 53.23635106308247,50.22213308362630 53.23633408754193,50.22205542015872 53.23632573239626,50.22205734252930 53.23633956909180))')
Out[78]:
[
  [ 50.2220573425293, 53.2363395690918 ],
  [ 50.22212782475368, 53.23635106308247 ],
  [ 50.2221330836263, 53.23633408754193 ],
  [ 50.22205542015872, 53.23632573239626 ],
  [ 50.2220573425293, 53.2363395690918 ]
]

parseJson¶

пытается сконвертировать строку в JSON при помощи JSON.parse и возвращает второй аргумент в случае ошибки

In [81]:
[ parseJson('{"a":1}'), parseJson('', []), parseJson('') ]
Out[81]:
[ { a: 1 }, [], {} ]

parseTimeSpan¶

конвертирует строковый интервал времени в структуру с именоваными атрибутами

In [3]:
function parse(input) {
    var ts = parseTimeSpan(input);
    console.log('parseTimeSpan:',input,ts);
}

parse('1d 2h 3m 4s')
parse('365d')
parse('24h')
parse('60m')
parse('61s')
parse('2h 30m')
parse('2h 30m 25s')
parse('3m 16s')
parse('4d 5h 30m')

parse('1д 2ч 3м 4с')
parse('365д')
parse('24ч')
parse('60м')
parse('61с')
parse('2h 30м')
parse('2ч 30м 25с')
parse('3м 16с')
parse('4д 5ч 30м')

parse('1.03:14:56.1667000')
parse('03:14:56.1667000')
parse('1.03:14:56')
parse('03:14:56')

parseTimeSpan: 1d 2h 3m 4s { days: 1, hours: 2, minutes: 3, seconds: 4 }
parseTimeSpan: 365d { days: 365, hours: 0, minutes: 0, seconds: 0 }
parseTimeSpan: 24h { days: 0, hours: 24, minutes: 0, seconds: 0 }
parseTimeSpan: 60m { days: 0, hours: 0, minutes: 60, seconds: 0 }
parseTimeSpan: 61s { days: 0, hours: 0, minutes: 0, seconds: 61 }
parseTimeSpan: 2h 30m { days: 0, hours: 2, minutes: 30, seconds: 0 }
parseTimeSpan: 2h 30m 25s { days: 0, hours: 2, minutes: 30, seconds: 25 }
parseTimeSpan: 3m 16s { days: 0, hours: 0, minutes: 3, seconds: 16 }
parseTimeSpan: 4d 5h 30m { days: 4, hours: 5, minutes: 30, seconds: 0 }
parseTimeSpan: 1д 2ч 3м 4с { days: 1, hours: 2, minutes: 3, seconds: 4 }
parseTimeSpan: 365д { days: 365, hours: 0, minutes: 0, seconds: 0 }
parseTimeSpan: 24ч { days: 0, hours: 24, minutes: 0, seconds: 0 }
parseTimeSpan: 60м { days: 0, hours: 0, minutes: 60, seconds: 0 }
parseTimeSpan: 61с { days: 0, hours: 0, minutes: 0, seconds: 61 }
parseTimeSpan: 2h 30м { days: 0, hours: 2, minutes: 30, seconds: 0 }
parseTimeSpan: 2ч 30м 25с { days: 0, hours: 2, minutes: 30, seconds: 25 }
parseTimeSpan: 3м 16с { days: 0, hours: 0, minutes: 3, seconds: 16 }
parseTimeSpan: 4д 5ч 30м { days: 4, hours: 5, minutes: 30, seconds: 0 }
parseTimeSpan: 1.03:14:56.1667000 { days: 1, hours: 3, minutes: 14, seconds: 56, ticks: 1667000 }
parseTimeSpan: 03:14:56.1667000 { days: 0, hours: 3, minutes: 14, seconds: 56, ticks: 1667000 }
parseTimeSpan: 1.03:14:56 { days: 1, hours: 3, minutes: 14, seconds: 56, ticks: 0 }
parseTimeSpan: 03:14:56 { days: 0, hours: 3, minutes: 14, seconds: 56, ticks: 0 }

timespanToSeconds¶

конвертирует строковый интервал времени в интервал в секундах

In [2]:
function parse(input) {
    var ts = timespanToSeconds(input);
    console.log('timespanToSeconds:',input,'=',ts+'s');
}

parse('1d 2h 3m 4s')
parse('365d')
parse('24h')
parse('60m')
parse('61s')
parse('2h 30m')
parse('2h 30m 25s')
parse('3m 16s')
parse('4d 5h 30m')

parse('1д 2ч 3м 4с')
parse('365д')
parse('24ч')
parse('60м')
parse('61с')
parse('2h 30м')
parse('2ч 30м 25с')
parse('3м 16с')
parse('4д 5ч 30м')

parse('1.03:14:56.1667000')
parse('03:14:56.1667000')
parse('1.03:14:56')
parse('03:14:56')

timespanToSeconds: 1d 2h 3m 4s = 93784s
timespanToSeconds: 365d = 31536000s
timespanToSeconds: 24h = 86400s
timespanToSeconds: 60m = 3600s
timespanToSeconds: 61s = 61s
timespanToSeconds: 2h 30m = 9000s
timespanToSeconds: 2h 30m 25s = 9025s
timespanToSeconds: 3m 16s = 196s
timespanToSeconds: 4d 5h 30m = 365400s
timespanToSeconds: 1д 2ч 3м 4с = 93784s
timespanToSeconds: 365д = 31536000s
timespanToSeconds: 24ч = 86400s
timespanToSeconds: 60м = 3600s
timespanToSeconds: 61с = 61s
timespanToSeconds: 2h 30м = 9000s
timespanToSeconds: 2ч 30м 25с = 9025s
timespanToSeconds: 3м 16с = 196s
timespanToSeconds: 4д 5ч 30м = 365400s
timespanToSeconds: 1.03:14:56.1667000 = 98096.1667s
timespanToSeconds: 03:14:56.1667000 = 11696.1667s
timespanToSeconds: 1.03:14:56 = 98096s
timespanToSeconds: 03:14:56 = 11696s

quoteAwareSplitBy¶

разбивает текст на подстроки разделителем с учетом того, что в тексте могут содержаться кавычки и скобки, затем удаляет пустые элементы

In [82]:
quoteAwareSplitBy('/')("Item/Link/?(search('Link/Zone'))/Item")
Out[82]:
[ 'Item', 'Link', "?(search('Link/Zone'))", 'Item' ]

splitPath¶

разбивает текст символом / с учетом кавычек и скобок, тоже самое что quoteAwareSplitBy('/')

In [83]:
splitPath("Item/Link/?(search('Link/Zone'))/Item")
Out[83]:
[ 'Item', 'Link', "?(search('Link/Zone'))", 'Item' ]

splitLines¶

разбивает текст символом переноса строки с учетом кавычек и скобок, тоже самое что quoteAwareSplitBy('\n')

In [84]:
splitLines("Item\nLink\n?(search('Link\nZone'))\nItem")
Out[84]:
[ 'Item', 'Link', "?(search('Link\nZone'))", 'Item' ]

splitByComma¶

разбивает текст запятыми с учетом кавычек и скобок, тоже самое что quoteAwareSplitBy(',')

In [86]:
splitByComma("Item,Link,?(search('Link,Zone')),Item")
Out[86]:
[ 'Item', 'Link', "?(search('Link,Zone'))", 'Item' ]

splitBySpace¶

разбивает текст пробелами с учетом кавычек и скобок, тоже самое что quoteAwareSplitBy(' ')

In [87]:
splitBySpace("Item Link ?(search('Link Zone')) Item")
Out[87]:
[ 'Item', 'Link', "?(search('Link Zone'))", 'Item' ]

updateUrl¶

обновляет строку с сетевым адресом атрибутами класса Url

In [2]:
var url = 'http://192.168.11.151:8888/notebooks/daisyjs/amjs/docs-miscutils.ipynb#sleep';
updateUrl(url, { host: '127.0.01', hash: 'updateUrl' })
Out[2]:
'http://127.0.0.1:8888/notebooks/daisyjs/amjs/docs-miscutils.ipynb#updateUrl'

getDirs¶

получает список подпапок в текущей папке

In [9]:
getDirs('.').then(console.log)
Out[9]:
Promise { <pending> }
[
  '/home/undwad/ipynb/daisyjs/amjs/.git',
  '/home/undwad/ipynb/daisyjs/amjs/.ipynb_checkpoints',
  '/home/undwad/ipynb/daisyjs/amjs/.node-red',
  '/home/undwad/ipynb/daisyjs/amjs/__pycache__',
  '/home/undwad/ipynb/daisyjs/amjs/archive',
  '/home/undwad/ipynb/daisyjs/amjs/assets',
  '/home/undwad/ipynb/daisyjs/amjs/debug',
  '/home/undwad/ipynb/daisyjs/amjs/dist',
  '/home/undwad/ipynb/daisyjs/amjs/js',
  '/home/undwad/ipynb/daisyjs/amjs/legacy',
  '/home/undwad/ipynb/daisyjs/amjs/logs',
  '/home/undwad/ipynb/daisyjs/amjs/node_modules',
  '/home/undwad/ipynb/daisyjs/amjs/nodes',
  '/home/undwad/ipynb/daisyjs/amjs/out',
  '/home/undwad/ipynb/daisyjs/amjs/package',
  '/home/undwad/ipynb/daisyjs/amjs/questdb',
  '/home/undwad/ipynb/daisyjs/amjs/static',
  '/home/undwad/ipynb/daisyjs/amjs/storage',
  '/home/undwad/ipynb/daisyjs/amjs/tmp'
]

getFiles¶

получает список всего содержимого директории

In [88]:
async function run() {
    var files = await getFiles('.')
    console.log(files.length, files.slice(0,10))
}

run()
Out[88]:
Promise { <pending> }
14590 [
  '/home/undwad/ipynb/daisyjs/core/.git/COMMIT_EDITMSG',
  '/home/undwad/ipynb/daisyjs/core/.git/FETCH_HEAD',
  '/home/undwad/ipynb/daisyjs/core/.git/HEAD',
  '/home/undwad/ipynb/daisyjs/core/.git/ORIG_HEAD',
  '/home/undwad/ipynb/daisyjs/core/.git/config',
  '/home/undwad/ipynb/daisyjs/core/.git/description',
  '/home/undwad/ipynb/daisyjs/core/.git/hooks/applypatch-msg.sample',
  '/home/undwad/ipynb/daisyjs/core/.git/hooks/commit-msg.sample',
  '/home/undwad/ipynb/daisyjs/core/.git/hooks/fsmonitor-watchman.sample',
  '/home/undwad/ipynb/daisyjs/core/.git/hooks/post-update.sample'
]

sleep¶

делает паузу на указанное количество миллисекунд

In [89]:
async function run() {
    var t0 = epochtime();
    console.log('time before sleep', t0)
    await sleep(3000)
    console.log('time after sleep', epochtime())
    console.log('seconds sleeped', epochtime()-t0)
}

run()

time before sleep 1662456513.491
Out[89]:
Promise { <pending> }
time after sleep 1662456516.495
seconds sleeped 3.003999948501587
In [4]:
system(`jupyter-nbconvert --output-dir=./static --to HTML docs-miscutils.ipynb`)

[NbConvertApp] Converting notebook docs-miscutils.ipynb to HTML
[NbConvertApp] Writing 868703 bytes to static/docs-miscutils.html
In [ ]: