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

encommon/webkit/scripts/datagrid.js

@@ -0,0 +1,105 @@
+/*
+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 datagrid(
+  fields,
+  values,
+) {
+  // Construct the table with the header using the contents.
+
+  assert(!isnull(fields));
+  assert(!isnull(values));
+
+
+  let element =
+    $('<table/>').addClass(
+      'encommon_datagrid');
+
+
+  element.append(
+    _table_header(fields));
+
+  element.append(
+    _table_records(
+      fields, values));
+
+
+  return element; }
+
+
+
+function _table_header(
+  fields,
+) {
+  // Construct the header for use with the table contents.
+
+  let element = $('<thead/>');
+  let trow = $('<tr/>');
+
+
+  let _fields =
+    Object.keys(fields);
+
+  _fields.forEach(key => {
+
+    let tcell = $('<th/>');
+
+    let value = fields[key];
+
+    tcell.text(value);
+
+    trow.append(tcell); });
+
+
+  element.append(trow);
+
+  return element; }
+
+
+
+function _table_records(
+  fields,
+  values,
+) {
+  // Construct the records for use with the table contents.
+
+  let element = $('<tbody/>');
+
+
+  values.forEach(record => {
+
+    let trow = $('<tr/>');
+
+
+    let _fields =
+      Object.keys(fields);
+
+    _fields.forEach(key => {
+
+      let tcell = $('<td/>');
+      let value = record[key];
+
+      if (isquery(value))
+        tcell.html(
+          value[0].outerHTML);
+
+      else if (isnode(value))
+        tcell.html(
+          value.outerHTML);
+
+      else if (!isnull(value))
+        tcell.text(value);
+
+      trow.append(tcell); });
+
+
+    element.append(trow); });
+
+
+  return element; }

encommon/webkit/scripts/datetime.js

@@ -0,0 +1,160 @@
+/*
+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 datestamp(
+  value,
+) {
+  // Return the timestamp using provided format for instance.
+
+  assert(!isnull(value));
+
+
+  let element =
+    $('<div/>').addClass(
+      'encommon_datestamp');
+
+
+  let date =
+    new Date(value);
+
+  let time =
+    date.getTime();
+
+  assert(time);
+
+
+  let pad = num =>
+    String(num)
+    .padStart(2, '0');
+
+  let source_month =
+    pad(date.getMonth() + 1);
+
+  let source_day =
+    pad(date.getDate());
+
+  let source_year =
+    date.getFullYear();
+
+  let source_hours =
+    pad(date.getHours());
+
+  let source_minutes =
+    pad(date.getMinutes());
+
+  let source_seconds =
+    pad(date.getSeconds());
+
+  let source_tzname =
+    _tzname(date);
+
+  if (source_tzname == 'GMT')
+    source_tzname = 'UTC';
+
+
+  element.append(
+    $('<span/>')
+    .addClass('_value')
+    .addClass('_year')
+    .text(source_year));
+
+  element.append(
+    $('<span/>')
+    .addClass('_delim')
+    .addClass('_slash')
+    .text('-'));
+
+  element.append(
+    $('<span/>')
+    .addClass('_value')
+    .addClass('_month')
+    .text(source_month));
+
+  element.append(
+    $('<span/>')
+    .addClass('_delim')
+    .addClass('_slash')
+    .text('-'));
+
+  element.append(
+    $('<span/>')
+    .addClass('_value')
+    .addClass('_day')
+    .text(source_day));
+
+  element.append(
+    $('<span/>')
+    .addClass('_delim')
+    .addClass('_space')
+    .html('&nbsp;'));
+
+  element.append(
+    $('<span/>')
+    .addClass('_value')
+    .addClass('_hours')
+    .text(source_hours));
+
+  element.append(
+    $('<span/>')
+    .addClass('_delim')
+    .addClass('_colon')
+    .text(':'));
+
+  element.append(
+    $('<span/>')
+    .addClass('_value')
+    .addClass('_minutes')
+    .text(source_minutes));
+
+  element.append(
+    $('<span/>')
+    .addClass('_delim')
+    .addClass('_colon')
+    .text(':'));
+
+  element.append(
+    $('<span/>')
+    .addClass('_value')
+    .addClass('_seconds')
+    .text(source_seconds));
+
+  element.append(
+    $('<span/>')
+    .addClass('_delim')
+    .addClass('_space')
+    .html('&nbsp;'));
+
+  element.append(
+    $('<span/>')
+    .addClass('_tzname')
+    .text(source_tzname));
+
+
+  return element; }
+
+
+
+function _tzname(
+  date,
+) {
+  // Return the located timezone object for the provided date.
+
+  assert(!isnull(date));
+
+  let tzname =
+    new Intl.DateTimeFormat(
+      'en-US',
+      {'timeZoneName': 'short'})
+    .formatToParts(date)
+    .find(
+      x =>
+      x.type === 'timeZoneName')
+    .value;
+
+  return tzname; }

encommon/webkit/scripts/default.js

@@ -0,0 +1,327 @@
+/*
+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 (global) {
+  // jQuery like object for use in Enasis Network projects.
+
+  'use strict';
+
+  global.$ = $;
+
+
+  function $(selector) {
+
+    if (!(this instanceof $))
+      return new $(selector);
+
+
+    if (!selector) {
+
+      this.length = 0;
+      this.elements = [];
+
+      return this; }
+
+
+    if (isquery(selector))
+      return selector;
+
+    else if (isnodes(selector))
+      this.elements = selector;
+
+    else if (isnode(selector))
+      this.elements = [selector];
+
+    else if (isstr(selector))
+      _enquery(this, selector);
+
+
+   this.length =
+      this.elements
+      .length;
+
+    this.elements
+      .forEach(
+        (x, y) =>
+        { this[y] = x; }); }
+
+
+  $.prototype
+    .enquery = true;
+
+  $.prototype
+    .each = _enquery_each;
+
+  $.prototype
+    .clone = _enquery_clone;
+
+  $.prototype
+    .css = _enquery_css;
+
+  $.prototype
+    .addClass = _enquery_addcls;
+
+  $.prototype
+    .remClass = _enquery_remcls;
+
+  $.prototype
+    .hide = _enquery_hide;
+
+  $.prototype
+    .show = _enquery_show;
+
+  $.prototype
+    .text = _enquery_text;
+
+  $.prototype
+    .html = _enquery_html;
+
+  $.prototype
+    .append = _enquery_append;
+
+  $.prototype
+    .replace = _enquery_replace;
+
+  $.prototype
+    .attr = _enquery_attr;
+
+})(window);
+
+
+
+function _enquery(
+  source,
+  selector,
+) {
+  // Helper function for Enasis Network jQuery replacement.
+
+  const create = /^<(\w+)\/>$/;
+
+  assert(isstr(selector));
+
+  if (!create.test(selector))
+    source.elements =
+      document
+      .querySelectorAll(selector);
+
+  else {
+
+    let tagName =
+      selector
+      .match(create)[1];
+
+    let element =
+      document
+      .createElement(tagName);
+
+    source.elements = [element]; } }
+
+
+
+function _enquery_each(
+  element,
+) {
+  // Helper function for Enasis Network jQuery replacement.
+
+  let items = this.elements;
+
+  this.elements.forEach(
+    (x, y) =>
+    element.call(x, y, x));
+
+  return this; }
+
+
+
+function _enquery_css(
+  name,
+  value,
+) {
+  // Helper function for Enasis Network jQuery replacement.
+
+  function _each() {
+    this.style[name] = value; }
+
+  return this.each(_each); }
+
+
+
+function _enquery_addcls(
+  name,
+) {
+  // Helper function for Enasis Network jQuery replacement.
+
+  function _each() {
+    this.classList
+      .add(name); }
+
+  return this.each(_each); }
+
+
+
+function _enquery_remcls(
+  name,
+) {
+  // Helper function for Enasis Network jQuery replacement.
+
+  function _each() {
+    this.classList
+      .remove(name); }
+
+  return this.each(_each); }
+
+
+
+function _enquery_hide() {
+  // Helper function for Enasis Network jQuery replacement.
+
+  let returned =
+    this.css('display', 'none');
+
+  return returned; }
+
+
+
+function _enquery_show() {
+  // Helper function for Enasis Network jQuery replacement.
+
+  let returned =
+    this.css('display', 'block');
+
+  return returned; }
+
+
+
+function _enquery_text(
+  text,
+) {
+  // Helper function for Enasis Network jQuery replacement.
+
+  if (text === undefined) {
+
+    if (this.length > 0)
+      return this[0].textContent;
+
+    return undefined; }
+
+  else {
+
+    function _each() {
+      this.textContent = text; }
+
+    return this.each(_each); } }
+
+
+
+function _enquery_html(
+  html,
+) {
+  // Helper function for Enasis Network jQuery replacement.
+
+  if (html === undefined) {
+
+    if (this.length > 0)
+      return this[0].innerHTML;
+
+    return undefined; }
+
+  else {
+
+    if (isquery(html))
+      html = html[0].outerHTML;
+
+    else if (isnode(html))
+      html = html.outerHTML;
+
+    function _each() {
+      this.innerHTML = html; }
+
+    return this.each(_each); } }
+
+
+
+function _enquery_append(
+  element,
+) {
+  // Helper function for Enasis Network jQuery replacement.
+
+  assert(element.enquery)
+
+  let nodes = element.elements;
+
+
+  function _each(index) {
+
+    nodes.forEach(
+      (x) => {
+        const element =
+          index < 1 ?
+          x : node.cloneNode(true);
+        this
+        .appendChild(element); }); }
+
+
+  return this.each(_each); }
+
+
+
+function _enquery_replace(
+  element,
+) {
+  // Helper function for Enasis Network jQuery replacement.
+
+  assert(element.enquery)
+
+  let nodes = element.elements;
+
+
+  function _each(index) {
+
+    nodes.forEach(
+      (x) => {
+        const element =
+          index < 1 ?
+          x : x.cloneNode(true);
+        this
+        .replaceChildren(element); }); }
+
+
+  return this.each(_each); }
+
+
+
+function _enquery_attr(
+  name,
+  value,
+) {
+  // Helper function for Enasis Network jQuery replacement.
+
+  if (this.length === 0)
+    return undefined;
+
+  if (value !== undefined)
+    this[0]
+      .setAttribute(name, value);
+
+  let returned =
+    this[0]
+    .getAttribute(name);
+
+  return returned; }
+
+
+
+function _enquery_clone() {
+
+  let clones =
+    Array
+    .from(this.elements)
+    .map(x => x.cloneNode(true));
+
+  return $(clones); }

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; }