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

encommon/times/common.py

@@ -23,6 +23,9 @@ NUMERISH = compile(
 SNAPABLE = compile(
     r'^(\-|\+)[\d\@a-z\-\+]+$')
 
+UNITIME = Union[
+    int | float | str]
+
 STRINGNOW = {
     'None', None,
     'null', 'now'}

encommon/times/unitime.py

@@ -7,14 +7,27 @@ is permitted, for more information consult the project license file.
 
 
 
+from re import compile
 from re import match as re_match
 
+from .common import UNITIME
 from .parse import since_time
 
 
 
+NOTATE = compile(
+    r'^(\d+(s|m|h|d|w|y))*$')
+
+STRINT = compile(
+    r'^\d+$')
+
+STRFLT = compile(
+    r'^\d+\.\d+$')
+
+
+
 def unitime(
-    input: int | float | str,
+    input: UNITIME,
 ) -> int:
     """
     Return the seconds in integer format for provided input.
@@ -32,23 +45,22 @@ def unitime(
     :returns: Seconds in integer format for provided input.
     """
 
-    notate = r'^(\d+(s|m|h|d|w|y))*$'
-    strint = r'^\d+$'
-    strflt = r'^\d+\.\d+$'
-
     if isinstance(input, str):
 
-        if re_match(notate, input):
-            input = since_time(
-                'now', f'+{input}')
-
-        elif re_match(strint, input):
+        if re_match(STRINT, input):
             input = int(input)
 
-        elif re_match(strflt, input):
+        elif re_match(STRFLT, input):
             input = int(
                 input.split('.')[0])
 
+        elif re_match(NOTATE, input):
+            input = since_time(
+                'now', f'+{input}')
+
+        else:  # NOCVR
+            raise ValueError('input')
+
     if isinstance(input, float):
         input = int(input)
 

encommon/version.txt

@@ -1 +1 @@
-0.21.0
+0.22.1

encommon/webkit/__init__.py

@@ -0,0 +1,15 @@
+"""
+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.
+"""
+
+
+
+from .content import Content
+
+
+
+__all__ = [
+    'Content']

encommon/webkit/content.py

@@ -0,0 +1,94 @@
+"""
+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.
+"""
+
+
+
+from pathlib import Path
+from typing import Optional
+
+from ..utils import read_text
+
+
+
+IMAGES = (
+    Path(__file__).parent
+    / 'images')
+
+SCRIPTS = (
+    Path(__file__).parent
+    / 'scripts')
+
+STYLES = (
+    Path(__file__).parent
+    / 'styles')
+
+
+
+class Content:
+    """
+    Access common content used with application interfaces.
+    """
+
+
+    @classmethod
+    def images(
+        cls,
+        name: str,
+    ) -> Optional[str]:
+        """
+        Return the contents requested stored within the project.
+
+        :param name: Which file in the project will be returned.
+        :returns: Contents requested stored within the project.
+        """
+
+        path = IMAGES / f'{name}.svg'
+
+        if not path.exists():
+            return None
+
+        return read_text(path)
+
+
+    @classmethod
+    def scripts(
+        cls,
+        name: str,
+    ) -> Optional[str]:
+        """
+        Return the contents requested stored within the project.
+
+        :param name: Which file in the project will be returned.
+        :returns: Contents requested stored within the project.
+        """
+
+        path = SCRIPTS / f'{name}.js'
+
+        if not path.exists():
+            return None
+
+        return read_text(path)
+
+
+    @classmethod
+    def styles(
+        cls,
+        name: str,
+    ) -> Optional[str]:
+        """
+        Return the contents requested stored within the project.
+
+        :param name: Which file in the project will be returned.
+        :returns: Contents requested stored within the project.
+        """
+
+        path = STYLES / f'{name}.css'
+
+        if not path.exists():
+            return None
+
+        return read_text(path)

encommon/webkit/images/enasis.svg

@@ -0,0 +1,174 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  height="442px"
+  viewBox="0 0 442 442"
+  width="442px">
+  <path
+    fill="none"
+    opacity="1.000000"
+    stroke="none"
+  	d="M443.000000,362.000000C443.000000,388.980438 443.000000,415.960846
+       443.000000,442.940491C295.666656,442.939697 148.333313,442.939697
+       1.000000,442.939697C1.000000,416.232025 1.000000,389.584686 1.246922,
+       362.450500C1.493844,361.963654 1.971579,361.833344 2.438007,
+       361.898834C76.779030,361.974976 150.653625,361.986176 224.528229,
+       361.989563C225.356949,361.989594 226.185684,361.887695 227.258835,
+       361.846863C227.858200,361.679779 227.968231,361.402130 227.898834,
+       360.561066C227.920670,337.391663 227.877014,314.688629 227.846848,
+       291.741150C227.679779,291.141785 227.402145,291.031769 226.561096,
+       291.101166C181.894318,291.035675 137.693909,291.035675 93.356239,
+       291.035675C93.356239,278.401245 93.356239,266.375610 93.356239,
+       253.833344C114.811584,253.833344 135.912979,253.833344 157.258820,
+       253.846848C157.858231,253.679764 157.968246,253.402115 157.898834,
+       252.561066C157.920670,230.391678 157.877014,208.688644 157.846863,
+       186.741180C157.679764,186.141769 157.402115,186.031754 156.561066,
+       186.101166C135.197708,186.035690 114.300705,186.035690 93.401344,
+       186.035690C93.401344,174.644379 93.401344,163.949188 93.401344,
+       153.000000C99.278572,153.000000 104.756264,153.006500 110.233948,
+       152.998962C149.160767,152.945358 188.087570,152.888901 227.258820,
+       152.846848C227.858231,152.679764 227.968246,152.402115 227.898834,
+       151.561066C227.920654,128.391678 227.876999,105.688644 227.846848,
+       82.741180C227.679779,82.141800 227.402145,82.031769 226.561081,
+       82.101173C152.220505,82.025017 78.346275,82.013817 4.472044,
+       82.010468C3.643328,82.010429 2.814607,82.112343 1.743549,
+       82.100548C1.334140,82.022949 1.167070,82.011475 1.000000,
+       82.000000C1.000000,55.019562 1.000000,28.039125 1.000004,
+       1.059518C148.333344,1.060348 295.666687,1.060348 443.000000,
+       1.060348C443.000000,27.768024 443.000000,54.415356 442.531342,
+       81.531342C412.142517,82.000000 382.222321,82.000000 351.415222,
+       82.000000C351.415222,123.653839 351.415222,164.554214 351.415222,
+       205.454575C350.966827,205.579773 350.518433,205.704956 350.070038,
+       205.830139C343.114441,197.728653 336.079834,189.693375 329.222595,
+       181.509491C319.928558,170.417343 310.816833,159.172531 301.539551,
+       148.066193C293.828949,138.835388 285.949310,129.745880 278.222260,
+       120.528641C268.605591,109.057358 258.889954,97.660851 249.595901,
+       85.931870C246.401871,81.901085 242.961899,81.272049 237.925476,
+       82.576553C237.925476,109.195648 237.925476,135.915100 237.925476,
+       163.074326C214.387756,163.074326 191.461670,163.074326 168.355743,
+       163.074326C168.355743,202.565430 168.355743,241.605698 168.355743,
+       281.095032C191.633194,281.095032 214.559387,281.095032 238.105438,
+       281.095032C238.105438,308.250610 238.105438,334.963623 238.105438,
+       361.716949C245.658249,361.716949 252.580795,361.716949 260.067413,
+       361.716949C260.067413,320.406921 260.067413,279.375366 260.067413,
+       237.015121C262.169159,238.927551 263.465485,239.863388 264.460052,
+       241.051788C270.793762,248.619995 277.025909,256.273224 283.359283,
+       263.841766C290.758545,272.684021 298.269073,281.433197 305.654938,
+       290.286530C315.137909,301.653595 324.545349,313.083771 333.984467,
+       324.487427C341.744415,333.862488 349.657501,343.116394 357.207214,
+       352.657837C362.100006,358.841400 367.019470,362.673401 376.012756,
+       362.302307C398.308044,361.382202 420.666748,362.000000 443.000000,
+       362.000000z"/>
+  <path
+    fill="#009999"
+    opacity="1.000000"
+    stroke="none"
+  	d="M443.000000,361.531342C420.666748,362.000000 398.308044,361.382202
+       376.012756,362.302307C367.019470,362.673401 362.100006,358.841400
+       357.207214,352.657837C349.657501,343.116394 341.744415,333.862488
+       333.984467,324.487427C324.545349,313.083771 315.137909,301.653595
+       305.654938,290.286530C298.269073,281.433197 290.758545,272.684021
+       283.359283,263.841766C277.025909,256.273224 270.793762,248.619995
+       264.460052,241.051788C263.465485,239.863388 262.169159,238.927551
+       260.067413,237.015121C260.067413,279.375366 260.067413,320.406921
+       260.067413,361.716949C252.580795,361.716949 245.658249,361.716949
+       238.105438,361.716949C238.105438,334.963623 238.105438,308.250610
+       238.105438,281.095032C214.559387,281.095032 191.633194,281.095032
+       168.355743,281.095032C168.355743,241.605698 168.355743,202.565430
+       168.355743,163.074326C191.461670,163.074326 214.387756,163.074326
+       237.925476,163.074326C237.925476,135.915100 237.925476,109.195648
+       237.925476,82.576553C242.961899,81.272049 246.401871,81.901085
+       249.595901,85.931870C258.889954,97.660851 268.605591,109.057358
+       278.222260,120.528641C285.949310,129.745880 293.828949,138.835388
+       301.539551,148.066193C310.816833,159.172531 319.928558,170.417343
+       329.222595,181.509491C336.079834,189.693375 343.114441,197.728653
+       350.070038,205.830139C350.518433,205.704956 350.966827,205.579773
+       351.415222,205.454575C351.415222,164.554214 351.415222,123.653839
+       351.415222,82.000000C382.222321,82.000000 412.142517,82.000000
+       442.531342,82.000000C443.000000,175.020889 443.000000,268.041779
+       443.000000,361.531342z"/>
+  <path
+    fill="#009999"
+    opacity="1.000000"
+    stroke="none"
+  	d="M157.014389,253.833344C135.912979,253.833344 114.811584,253.833344
+       93.356239,253.833344C93.356239,266.375610 93.356239,278.401245
+       93.356239,291.035675C137.693909,291.035675 181.894318,291.035675
+       226.688522,291.244324C227.457138,291.639679 227.640823,291.817230
+       227.833344,291.985596C227.877014,314.688629 227.920670,337.391663
+       227.755676,360.688477C227.360291,361.457092 227.182755,361.640778
+       227.014404,361.833344C226.185684,361.887695 225.356949,361.989594
+       224.528229,361.989563C150.653625,361.986176 76.779030,361.974976
+       2.281695,361.753479C1.446564,361.352936 1.226912,361.172058 1.000000,
+       361.000000C1.000000,268.645782 1.000000,176.291550 1.169742,
+       83.336273C1.562412,82.554184 1.777880,82.364670 1.985888,
+       82.166664C2.814607,82.112343 3.643328,82.010429 4.472044,
+       82.010468C78.346275,82.013817 152.220505,82.025017 226.688522,
+       82.244339C227.457108,82.639717 227.640778,82.817253 227.833344,
+       82.985611C227.876999,105.688644 227.920654,128.391678 227.755676,
+       151.688507C227.360291,152.457108 227.182755,152.640793 227.014389,
+       152.833344C188.087570,152.888901 149.160767,152.945358 110.233948,
+       152.998962C104.756264,153.006500 99.278572,153.000000 93.401344,
+       153.000000C93.401344,163.949188 93.401344,174.644379 93.401344,
+       186.035690C114.300705,186.035690 135.197708,186.035690 156.688507,
+       186.244324C157.457108,186.639709 157.640793,186.817245 157.833344,
+       186.985611C157.877014,208.688644 157.920670,230.391678 157.755676,
+       252.688507C157.360291,253.457108 157.182755,253.640793 157.014389,
+       253.833344z"/>
+  <path
+    fill="#009999"
+    opacity="1.000000"
+    stroke="none"
+  	d="M1.743549,82.100548C1.777880,82.364670 1.562412,82.554184 1.169742,
+       82.867615C1.000000,83.000000 1.000000,82.500000 1.000000,
+       82.250000C1.167070,82.011475 1.334140,82.022949 1.743549,82.100548z"/>
+  <path
+    fill="#009999"
+    opacity="1.000000"
+    stroke="none"
+  	d="M1.000000,361.250000C1.226912,361.172058 1.446564,361.352936 1.815267,
+       361.687988C1.971579,361.833344 1.493844,361.963654 1.246922,
+       361.981812C1.000000,362.000000 1.000000,361.500000 1.000000,
+       361.250000z"/>
+  <path
+    fill="#009999"
+    opacity="1.000000"
+    stroke="none"
+  	d="M227.846848,82.741180C227.640778,82.817253 227.457108,82.639717
+       227.154877,82.309830C227.402145,82.031769 227.679779,82.141800
+       227.846848,82.741180z"/>
+  <path
+    fill="#009999"
+    opacity="1.000000"
+    stroke="none"
+  	d="M227.258820,152.846848C227.182755,152.640793 227.360291,
+       152.457108 227.690186,152.154846C227.968246,152.402115 227.858231,
+       152.679764 227.258820,152.846848z"/>
+  <path
+    fill="#009999"
+    opacity="1.000000"
+    stroke="none"
+  	d="M157.846848,186.741180C157.640793,186.817245 157.457108,
+       186.639709 157.154846,186.309814C157.402115,186.031754 157.679764,
+       186.141769 157.846848,186.741180z"/>
+  <path
+    fill="#009999"
+    opacity="1.000000"
+    stroke="none"
+  	d="M157.258820,253.846848 C157.182755,253.640793 157.360291,
+       253.457108 157.690186,253.154846 C157.968246,253.402115 157.858231,
+       253.679764 157.258820,253.846848z"/>
+  <path
+    fill="#009999"
+    opacity="1.000000"
+    stroke="none"
+  	d="M227.846848,291.741150 C227.640823,291.817230 227.457138,
+       291.639679 227.154877,291.309814 C227.402145,291.031769 227.679779,
+       291.141785 227.846848,291.741150z"/>
+  <path
+    fill="#009999"
+    opacity="1.000000"
+    stroke="none"
+  	d="M227.258835,361.846863C227.182755,361.640778 227.360291,
+       361.457092 227.690186,361.154846C227.968231,361.402130 227.858200,
+       361.679779 227.258835,361.846863z"/>
+</svg>

encommon/webkit/images/failure.svg

@@ -0,0 +1,15 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  height="24px"
+  viewBox="0 0 24 24"
+  width="24px"
+  fill="#ff6666">
+  <path
+    d="M12 4c-4.42 0-8 3.58-8 8s3.58 8 8 8 8-3.58 8-8-3.58-8-8-8zm1
+       13h-2v-2h2v2zm0-4h-2V7h2v6z"
+    opacity=".25"/>
+  <path
+    d="M11.99 2C6.47 2 2 6.48 2 12s4.47 10 9.99 10C17.52 22 22 17.52 22
+       12S17.52 2 11.99 2zM12 20c-4.42 0-8-3.58-8-8s3.58-8 8-8 8 3.58 8 8-3.58
+       8-8 8zm-1-5h2v2h-2zm0-8h2v6h-2z"/>
+</svg>

encommon/webkit/images/information.svg

@@ -0,0 +1,18 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  height="24px"
+  viewBox="0 0 24 24"
+  width="24px"
+  fill="#089bd8">
+  <path
+    d="M0 0h24v24H0V0z"
+    fill="none"/>
+  <path
+    d="M12 4c-4.41 0-8 3.59-8 8s3.59 8 8 8 8-3.59 8-8-3.59-8-8-8zm1
+       13h-2v-6h2v6zm0-8h-2V7h2v2z"
+    opacity=".25"/>
+  <path
+    d="M11 7h2v2h-2zm0 4h2v6h-2zm1-9C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48
+       10-10S17.52 2 12 2zm0 18c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59
+       8-8 8z"/>
+</svg>

encommon/webkit/images/success.svg

@@ -0,0 +1,18 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  height="24px"
+  viewBox="0 0 24 24"
+  width="24px"
+  fill="#66ff66">
+  <path
+    d="M0 0h24v24H0V0z"
+    fill="none"/>
+  <path
+    d="M12 4c-4.41 0-8 3.59-8 8s3.59 8 8 8 8-3.59 8-8-3.59-8-8-8zm-2 13-4-4
+       1.41-1.41L10 14.17l6.59-6.59L18 9l-8 8z"
+    opacity=".25"/>
+  <path
+    d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0
+       18c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8zm4.59-12.42L10
+       14.17l-2.59-2.58L6 13l4 4 8-8z"/>
+</svg>

encommon/webkit/images/warning.svg

@@ -0,0 +1,16 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  height="24px"
+  viewBox="0 0 24 24"
+  width="24px"
+  fill="#ffff66">
+  <path
+    d="M0 0h24v24H0V0z"
+    fill="none"/>
+  <path
+    d="M12 5.99L4.47 19h15.06L12 5.99zM13 18h-2v-2h2v2zm-2-4v-4h2v4h-2z"
+    opacity=".25"/>
+  <path
+    d="M12 2L1 21h22L12 2zm0 3.99L19.53 19H4.47L12 5.99zM11
+       16h2v2h-2zm0-6h2v4h-2z"/>
+</svg>

encommon/webkit/index.html

@@ -0,0 +1,218 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Common Library</title>
+
+    <!-- meta data -->
+    <meta charset="utf-8">
+    <meta
+     name="viewport"
+     content="width=device-width, initial-scale=1.0">
+    <!-- meta data -->
+
+    <!-- link hrefs -->
+    <link rel="icon" href="images/enasis.svg">
+    <link rel="stylesheet" href="styles/default.css">
+    <link rel="stylesheet" href="styles/datagrid.css">
+    <link rel="stylesheet" href="styles/datetime.css">
+    <link rel="stylesheet" href="styles/duration.css">
+    <link rel="stylesheet" href="styles/image.css">
+    <link rel="stylesheet" href="styles/message.css">
+    <link rel="stylesheet" href="styles/moderate.css">
+    <link rel="stylesheet" href="styles/numeric.css">
+    <link rel="stylesheet" href="styles/statate.css">
+    <!-- link hrefs -->
+
+    <!-- scripts -->
+    <script src="scripts/default.js"></script>
+    <script src="scripts/helpers.js"></script>
+    <script src="scripts/datagrid.js"></script>
+    <script src="scripts/datetime.js"></script>
+    <script src="scripts/duration.js"></script>
+    <script src="scripts/image.js"></script>
+    <script src="scripts/message.js"></script>
+    <script src="scripts/moderate.js"></script>
+    <script src="scripts/numeric.js"></script>
+    <script src="scripts/statate.js"></script>
+    <!-- scripts -->
+
+    <!-- overrides -->
+    <style>
+
+      body {
+        padding: .75rem 1rem .75rem 1rem; }
+
+      .encommon_message {
+        margin: .1rem 0 .1rem 0; }
+
+      :root {
+        --svgicon-failure: url('../images/failure.svg');
+        --svgicon-information: url('../images/information.svg');
+        --svgicon-success: url('../images/success.svg');
+        --svgicon-warning: url('../images/warning.svg'); }
+
+    </style>
+    <!-- overrides -->
+
+  </head>
+  <body>
+
+
+    <!-- introduction -->
+    <h1>Enasis Network Vanilla Elements</h1>
+    <p>This page helps demonstrate the various elements available in
+    the <a href="https://github.com/enasisnetwork">Enasis Network</a>
+    vanilla JavaScript library. All CSS is based on REM unit.</p>
+    <p>It is a long-term goal that all the CSS also be responsive to
+    the latest and most common mobile devices.</p>
+    <!-- introduction -->
+
+
+    <!-- message function -->
+    <h2>Simple Toast Generator</h2>
+    <div id="message"></div>
+    <script>
+
+      let _MESSAGE =
+        'Lorem ipsum dolor sit amet,'
+        + ' conseteur adipiscing.';
+
+      let _MESSAGES = [
+        'success',
+        'failure',
+        'information',
+        'warning'];
+
+      _MESSAGES.forEach(
+        (x) => {
+
+          let append = () => {
+
+            let element =
+              message(x, _MESSAGE);
+
+            $('#message')
+              .append(element);
+
+            $('#message')
+              .append($('<br/>')); }
+
+          whenready(append); });
+
+    </script>
+    <!-- message function -->
+
+
+    <!-- datagrid function -->
+    <h2>Simple Table Generator</h2>
+    <div id="datagrid"></div>
+    <script>
+
+
+      let _FIELDS = {
+        'moderate': 'Moderate',
+        'statate': 'Statate',
+        'plain': 'Plaintext',
+        'numeric': 'Numeric',
+        'datestamp': 'Timestamp',
+        'duration': 'Duration'};
+
+
+      let _VALUES = [
+
+        {'moderate':
+           moderate(
+             'Value One',
+             'information',
+             'value_one'),
+         'datestamp':
+           datestamp(
+             '2024-04-20T16:20:00Z'),
+         'duration':
+           duration(
+             '2024-04-20T16:20:00Z'),
+         'statate':
+           statate(
+             'success',
+             'Success',
+             'All seems normal'),
+         'numeric':
+           numeric_count(1e10 + 1e8),
+         'plain': _MESSAGE},
+
+        {'moderate':
+           moderate(
+             'Value Two',
+             'information',
+             'value_two'),
+         'datestamp':
+           datestamp(
+             '2024-04-20T16:20:00Z'),
+         'duration':
+           duration(
+             '2024-04-20T16:20:00Z'),
+         'statate':
+           statate(
+             'failure',
+             'Failure',
+             'Something is wrong'),
+         'numeric':
+           numeric_bytes(1e10 + 1e8),
+         'plain': _MESSAGE},
+
+        {'moderate':
+           moderate(
+             'Value Three',
+             'information',
+             'value_three'),
+         'datestamp':
+           datestamp(
+             '2024-04-20T16:20:00Z'),
+         'duration':
+           duration(
+             '2024-04-20T16:20:00Z'),
+         'statate':
+           statate(
+             'information',
+             'Waiting',
+             'Waiting on status'),
+         'numeric':
+           numeric_ftemp(69),
+         'plain': _MESSAGE},
+
+        {'moderate':
+           moderate(
+             'Value Four',
+             'information',
+             'value_four'),
+         'datestamp':
+           datestamp(
+             '2024-04-20T16:20:00Z'),
+         'duration':
+           duration(
+             '2024-04-20T16:20:00Z'),
+         'statate':
+           statate(
+             'warning',
+             'Warning',
+             'What is going on'),
+         'numeric':
+           numeric_cftemp(69),
+         'plain': _MESSAGE}];
+
+
+      whenready(function() {
+
+        let element =
+          datagrid(_FIELDS, _VALUES);
+
+        $('#datagrid')
+          .replace(element); });
+
+
+    </script>
+    <!-- datagrid function -->
+
+
+  </body>
+</html>