encommon 0.21.0__py3-none-any.whl → 0.22.1__py3-none-any.whl

encommon/webkit/scripts/duration.js

@@ -0,0 +1,150 @@
+/*
+Functions and routines associated with Enasis Network Common Library.
+
+This file is part of Enasis Network software eco-system. Distribution
+is permitted, for more information consult the project license file.
+*/
+
+
+
+function duration(
+  seconds,
+) {
+  // Convert the provided seconds in a human friendly format.
+
+  assert(!isnull(seconds));
+
+
+  let element =
+    $('<div/>').addClass(
+      'encommon_duration');
+
+
+  if (isstr(seconds))
+    seconds = _since(seconds);
+
+  seconds =
+    Math.floor(seconds);
+
+
+  if (seconds < 0)
+    seconds *= -1;
+
+  if (seconds < 5) {
+
+    element.append(
+      $('<span/>')
+      .addClass('_unit')
+      .text('now'));
+
+    return element; }
+
+
+  let result = [];
+
+  let remain = seconds;
+
+  let groups = {
+    year: 31536000,
+    month: 2592000,
+    week: 604800,
+    day: 86400,
+    hour: 3600,
+    minute: 60};
+
+  let maps = {
+    year: 'y',
+    month: 'mon',
+    week: 'w',
+    day: 'd',
+    hour: 'h',
+    minute: 'm',
+    second: 's'};
+
+
+  for (
+    let [unit, seconds]
+    of Object.entries(groups)
+  ) {
+
+    if (remain < seconds)
+      continue;
+
+    let value =
+      Math.floor(
+        remain / seconds);
+
+    remain %= seconds;
+
+    let append =
+      {unit, value};
+
+    result.push(append); }
+
+
+  if ((remain >= 1
+        && seconds > 60)
+      || seconds < 60)
+
+    result.push(
+      {'unit': 'second',
+       'value': remain});
+
+
+  let length = result.length;
+
+  if (length >= 2) {
+
+    let _result =
+      result[length - 1];
+
+    let unit = _result.unit;
+
+    if (unit === 'second')
+      result.pop(); }
+
+
+  for (
+    let {unit, value}
+    of result
+  ) {
+
+    let _value =
+      $('<span/>')
+      .addClass('_value')
+      .text(value);
+
+    element.append(_value);
+
+    let _unit =
+      $('<span/>')
+      .addClass(`_unit`)
+      .text(maps[unit]);
+
+    element.append(_unit); }
+
+
+  return element; }
+
+
+
+function _since(
+  value,
+) {
+  // Determine the time in seconds occurring since instance.
+
+  assert(!isnull(value));
+
+
+  let date =
+    new Date(value);
+
+  let time =
+    date.getTime();
+
+
+  assert(time);
+
+  delta = Date.now() - time;
+
+  return delta / 1000; }

encommon/webkit/scripts/helpers.js

@@ -0,0 +1,247 @@
+/*
+Functions and routines associated with Enasis Network Common Library.
+
+This file is part of Enasis Network software eco-system. Distribution
+is permitted, for more information consult the project license file.
+*/
+
+
+
+function assert(
+  condition,
+) {
+  // Assert the provided condition similar how using Python.
+
+  if (condition)
+    return true;
+
+  throw new Error('Assertion'); }
+
+
+
+function whenready(
+  callback,
+) {
+  // Attach the callback to the window session ready state.
+
+  assert(!isnull(callback));
+
+  let state =
+    document.readyState;
+
+  if (state == 'loading')
+    document
+    .addEventListener(
+      'DOMContentLoaded',
+      callback);
+
+  else callback(); }
+
+
+
+function isnull(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  let haystack = [null, undefined];
+
+  if (haystack.includes(value))
+    return true;
+
+  return false; }
+
+
+
+function isempty(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  if (isstr(value))
+    return value.length == 0;
+
+  if (isdict(value)) {
+
+    let keys =
+      Object.keys(value)
+      .length;
+
+    if (length == 0)
+        return true; }
+
+  if (islist(value))
+    return value.length == 0;
+
+  return isnull(value); }
+
+
+
+function isbool(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  let haystack = [true, false];
+
+  if (haystack.includes(value))
+    return true;
+
+  return false; }
+
+
+
+function isstr(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  if (typeof value === 'string')
+    return true;
+
+  return false; }
+
+
+
+function isnum(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  if (typeof value === 'number')
+    return true;
+
+  return false; }
+
+
+
+function isquery(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  try {
+
+    if (value.enquery)
+      return true; }
+
+  catch (e) { }
+
+  return false; }
+
+
+
+function isnode(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  if (value instanceof Node)
+    return true;
+
+  return false; }
+
+
+
+function isnodes(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  if (value instanceof NodeList)
+    return true;
+
+  return false; }
+
+
+
+function istime(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  let date =
+    new Date(value);
+
+  if (!isNaN(date.getTime()))
+      return true;
+
+  return false; }
+
+
+
+function islist(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  if (Array.isArray(value))
+    return true;
+
+  return false; }
+
+
+
+function isdict(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  if (typeof(value) == 'object'
+      && !isnull(value)
+      && !Array.isArray(value))
+    return true;
+
+  return false; }
+
+
+
+function istrue(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  if (value === true)
+    return true;
+
+  return false; }
+
+
+
+function isfalse(
+  value,
+) {
+  // Return the boolean indicating the conditional outcome.
+
+  if (value === false)
+    return true;
+
+  return false; }
+
+
+
+function loads(
+  value,
+) {
+  // Return the object value from the provided JSON string.
+
+  assert(isstr(value));
+
+  return JSON.parse(value); }
+
+
+
+function dumps(
+  value,
+  indent=null,
+) {
+  // Return the JSON string from the provided object value.
+
+  assert(!isnull(value));
+  assert(!isstr(value));
+
+  let returned =
+    JSON.stringify(
+      value, null, indent);
+
+  return returned; }

encommon/webkit/scripts/image.js

@@ -0,0 +1,39 @@
+/*
+Functions and routines associated with Enasis Network Common Library.
+
+This file is part of Enasis Network software eco-system. Distribution
+is permitted, for more information consult the project license file.
+*/
+
+
+
+function svgicon(
+  image,
+  dimension=null,
+) {
+  // Return the simple construct for SVG based icon images.
+
+  assert(!isnull(image));
+
+
+  let element =
+    $('<div/>').addClass(
+      'encommon_svgicon');
+
+
+  element.attr(
+    'data-image',
+    image);
+
+  if (!isnull(dimension)) {
+
+    element.css(
+      'height',
+      dimension);
+
+    element.css(
+      'width',
+      dimension); }
+
+
+  return element; }

encommon/webkit/scripts/message.js

@@ -0,0 +1,31 @@
+/*
+Functions and routines associated with Enasis Network Common Library.
+
+This file is part of Enasis Network software eco-system. Distribution
+is permitted, for more information consult the project license file.
+*/
+
+
+
+function message(
+  level,
+  about=null,
+) {
+  // Generate the severity based toast like message element.
+
+  assert(!isnull(level));
+
+
+  let element =
+    $('<div/>').addClass(
+      'encommon_message');
+
+
+  element.attr(
+    'data-level',
+    level);
+
+  element.html(about);
+
+
+  return element; }

encommon/webkit/scripts/moderate.js

@@ -0,0 +1,71 @@
+/*
+Functions and routines associated with Enasis Network Common Library.
+
+This file is part of Enasis Network software eco-system. Distribution
+is permitted, for more information consult the project license file.
+*/
+
+
+
+function moderate(
+  label=null,
+  icon=null,
+  small=null,
+) {
+  // Construct for containing a wide variety of value types.
+
+
+  let element =
+    $('<div/>').addClass(
+      'encommon_moderate');
+
+
+  if (!isnull(icon)) {
+
+    if (isstr(icon))
+      icon = svgicon(icon);
+
+    let _icon =
+      $('<div/>')
+      .addClass('_icon')
+      .replace(icon);
+
+    element.append(_icon); }
+
+
+  let value =
+    $('<div/>')
+    .addClass('_value');
+
+
+  let _value = false;
+
+  if (!isnull(label)) {
+
+    let _label =
+      $('<div/>')
+      .addClass('_label')
+      .html(label);
+
+    value.append(_label);
+
+    _value = true; }
+
+
+  if (!isnull(small)) {
+
+    let _small =
+      $('<div/>')
+      .addClass('_small')
+      .html(small);
+
+    value.append(_small);
+
+    _value = true; }
+
+
+  if (istrue(_value))
+    element.append(value);
+
+
+  return element; }

encommon/webkit/scripts/numeric.js

@@ -0,0 +1,189 @@
+/*
+Functions and routines associated with Enasis Network Common Library.
+
+This file is part of Enasis Network software eco-system. Distribution
+is permitted, for more information consult the project license file.
+*/
+
+
+
+function numeric(
+  value,
+  unit=null,
+) {
+  // Construct for containing a wide variety of value types.
+
+  assert(!isnull(value));
+
+
+  let element =
+    $('<div/>').addClass(
+      'encommon_numeric');
+
+
+  if (!isnum(value))
+    value =
+      parseFloat(value);
+
+  value = Number(
+    value.toFixed(1));
+
+
+  let parts =
+    value.toString()
+    .split('.');
+
+
+  element.append(
+    $('<span/>')
+    .addClass('_value')
+    .text(parts[0]));
+
+
+  if (parts.length == 2) {
+
+    element.append(
+      $('<span/>')
+      .addClass('_delim')
+      .text('.'));
+
+    element.append(
+      $('<span/>')
+      .addClass('_decimal')
+      .text(parts[1])); }
+
+
+  if (!isnull(unit))
+
+    element.append(
+      $('<span/>')
+      .addClass('_unit')
+      .html(unit));
+
+
+  return element; }
+
+
+
+function numeric_count(
+  value,
+) {
+  // Construct for containing a wide variety of value types.
+
+  assert(!isnull(value));
+
+
+  if (!isnum(value))
+    value =
+      parseFloat(value);
+
+  let unit = '';
+
+  if (value >= 1e12) {
+    value /= 1e12;
+    unit = 'trillion'; }
+
+  else if (value >= 1e9) {
+    value /= 1e9;
+    unit = 'billion'; }
+
+  else if (value >= 1e6) {
+    value /= 1e6;
+    unit = 'million'; }
+
+  else if (value >= 1e3) {
+    value /= 1e3;
+    unit = 'thousand'; }
+
+
+  let element =
+    numeric(value, unit);
+
+
+  return element; }
+
+
+
+function numeric_bytes(
+  value,
+) {
+  // Construct for containing a wide variety of value types.
+
+  assert(!isnull(value));
+
+
+  if (!isnum(value))
+    value =
+      parseFloat(value);
+
+  let unit = 'B';
+
+  if (value >= 1e12) {
+    value /= 1e12;
+    unit = 'TB'; }
+
+  else if (value >= 1e9) {
+    value /= 1e9;
+    unit = 'GB'; }
+
+  else if (value >= 1e6) {
+    value /= 1e6;
+    unit = 'MB'; }
+
+  else if (value >= 1e3) {
+    value /= 1e3;
+    unit = 'KB'; }
+
+
+  let element =
+    numeric(value, unit);
+
+
+  return element; }
+
+
+
+function numeric_ftemp(
+  value,
+) {
+  // Construct for containing a wide variety of value types.
+
+  assert(!isnull(value));
+
+
+  if (!isnum(value))
+    value =
+      parseFloat(value);
+
+  let unit = '°F';
+
+
+  let element =
+    numeric(value, unit);
+
+
+  return element; }
+
+
+
+function numeric_cftemp(
+  value,
+) {
+  // Construct for containing a wide variety of value types.
+
+  assert(!isnull(value));
+
+
+  if (!isnum(value))
+    value =
+      parseFloat(value);
+
+  value = value * (9 / 5);
+  value += 32;
+
+
+  let element =
+    numeric_ftemp(value);
+
+
+  return element; }