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

encommon/webkit/styles/tagues.css

@@ -0,0 +1,45 @@
+/*
+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.
+*/
+
+
+
+/******************************************/
+/* Standard structure for tagues elements */
+/******************************************/
+
+div.encommon_tagues {
+  display: inline-block;
+  white-space: normal; }
+
+
+
+/******************************************/
+/* Extended structure for tagues elements */
+/******************************************/
+
+div.encommon_tagues
+ >._value {
+  background-color: rgba(var(--gritty), .2);
+  border-color: rgba(var(--pretty), .3);
+  border-radius: .2rem .2rem .2rem .2rem;
+  border-style: solid;
+  border-width: .1rem .1rem .1rem .1rem;
+  display: inline-block;
+  font-family: monospace;
+  font-size: .9rem;
+  margin: .1rem .1rem .1rem .1rem;
+  padding: .1rem .2rem .1rem .2rem; }
+
+
+
+/********************************************/
+/* Extended structure for datagrid elements */
+/********************************************/
+
+table.encommon_datagrid
+ >tbody>tr>td:has(.encommon_tagues) {
+  text-align: center; }

encommon/webkit/test/__init__.py

@@ -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.
+"""
+
+
+
+from typing import Any
+
+from selenium.webdriver.remote.webdriver import WebDriver
+
+
+
+def _executejs(
+    driver: WebDriver,
+    script: str,
+    *args: Any,
+    wrap: bool = True,
+) -> Any:  # noqa: ANN401
+    """
+    Evaluate the provided JavaScript using the test driver.
+
+    :param driver: Selenium driver provided by the library.
+    :param script: Actual code that is executed with engine.
+    :param args: Positional arguments passed for downstream.
+    :param wrap: Determines if script is wrapped in return.
+    """
+
+    script = (
+        f'return {script};'
+        if wrap else script)
+
+    result = (
+        driver  # type: ignore[no-untyped-call]
+        .execute_script(script, *args))
+
+    return result

encommon/webkit/test/conftest.py

@@ -0,0 +1,52 @@
+"""
+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 typing import Iterator
+
+from pytest import fixture
+
+from selenium import webdriver
+from selenium.webdriver.chrome.options import Options
+from selenium.webdriver.remote.webdriver import WebDriver
+
+from ..content import Content
+
+
+
+@fixture
+def content() -> Content:
+    """
+    Construct the instance for use in the downstream tests.
+
+    :returns: Newly constructed instance of related class.
+    """
+
+    return Content()
+
+
+
+@fixture
+def driver() -> Iterator[WebDriver]:
+    """
+    Construct the instance for use in the downstream tests.
+
+    :returns: Newly constructed instance of related class.
+    """
+
+    options = Options()
+
+    options.add_argument('--headless')
+
+    driver = (
+        webdriver
+        .Chrome(options=options))
+
+    yield driver
+
+    driver.quit()

encommon/webkit/test/test_color.py

@@ -0,0 +1,64 @@
+"""
+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 typing import TYPE_CHECKING
+
+from selenium.webdriver.remote.webdriver import WebDriver
+
+from . import _executejs
+
+if TYPE_CHECKING:
+    from ..content import Content
+
+
+
+def test_colordiv(
+    content: 'Content',
+    driver: WebDriver,
+) -> None:
+    """
+    Perform various tests associated with relevant routines.
+
+    :param content: Primary class instance for the content.
+    :param driver: Selenium driver provided by the library.
+    """
+
+
+    driver.get(
+        f"""
+        data:text/html;
+        charset=utf-8,
+        <html>
+          <head>
+            <script>
+        {content.scripts('default')}
+        {content.scripts('helpers')}
+        {content.scripts('color')}
+            </script>
+          </head>
+          <body></body>
+        </html>
+        """)
+
+
+    outcome = _executejs(
+        driver,
+        'let element ='
+        ' colordiv(...arguments);'
+        'return'
+        ' element[0].outerHTML;',
+        '#FF00CC',
+        wrap=False)
+
+
+    assert outcome == (
+        '<div class="encommon_colordiv">'
+        '<div class="_value" style="'
+        'background-color: rgb(255, 0, 204);'
+        '"></div></div>')

encommon/webkit/test/test_content.py

@@ -0,0 +1,98 @@
+"""
+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 typing import TYPE_CHECKING
+
+from ...types import inrepr
+from ...types import instr
+from ...types import lattrs
+
+if TYPE_CHECKING:
+    from ..content import Content
+
+
+
+def test_Content(
+    content: 'Content',
+) -> None:
+    """
+    Perform various tests associated with relevant routines.
+
+    :param content: Primary class instance for the content.
+    """
+
+
+    attrs = lattrs(content)
+
+    assert attrs == []
+
+
+    assert inrepr(
+        'content.Content',
+        content)
+
+    assert isinstance(
+        hash(content), int)
+
+    assert instr(
+        'content.Content',
+        content)
+
+
+    script = (
+        content
+        .scripts('default'))
+
+    assert script is not None
+
+
+    styles = (
+        content
+        .styles('default'))
+
+    assert styles is not None
+
+
+    image = (
+        content
+        .images('enasis'))
+
+    assert image is not None
+
+
+
+def test_Content_cover(
+    content: 'Content',
+) -> None:
+    """
+    Perform various tests associated with relevant routines.
+
+    :param content: Primary class instance for the content.
+    """
+
+
+    script = (
+        content
+        .scripts('doesnotexist'))
+
+    assert script is None
+
+
+    styles = (
+        content
+        .styles('doesnotexist'))
+
+    assert styles is None
+
+
+    image = (
+        content
+        .images('doesnotexist'))
+
+    assert image is None

encommon/webkit/test/test_datagrid.py

@@ -0,0 +1,90 @@
+"""
+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 typing import TYPE_CHECKING
+
+from selenium.webdriver.remote.webdriver import WebDriver
+
+from . import _executejs
+
+if TYPE_CHECKING:
+    from ..content import Content
+
+
+
+def test_datagrid(
+    content: 'Content',
+    driver: WebDriver,
+) -> None:
+    """
+    Perform various tests associated with relevant routines.
+
+    :param content: Primary class instance for the content.
+    :param driver: Selenium driver provided by the library.
+    """
+
+
+    driver.get(
+        f"""
+        data:text/html;
+        charset=utf-8,
+        <html>
+          <head>
+            <script>
+        {content.scripts('default')}
+        {content.scripts('helpers')}
+        {content.scripts('datagrid')}
+            </script>
+          </head>
+          <body></body>
+        </html>
+        """)
+
+
+    fields = {
+        'foo': 'Foo',
+        'bar': 'Bar'}
+
+    values = [
+        {'foo': '1',
+         'bar': 1},
+        {'foo': '2',
+         'bar': 2}]
+
+
+    outcome = _executejs(
+        driver,
+        'let element ='
+        ' datagrid(...arguments);'
+        'return'
+        ' element[0].outerHTML;',
+        fields,
+        values,
+        wrap=False)
+
+
+    assert outcome == (
+        '<table class="encommon_datagrid">'
+        '<thead>'
+        '<tr>'
+        '<th>Bar</th>'
+        '<th>Foo</th>'
+        '</tr>'
+        '</thead>'
+        '<tbody>'
+        '<tr>'
+        '<td>1</td>'
+        '<td>1</td>'
+        '</tr>'
+        '<tr>'
+        '<td>2</td>'
+        '<td>2</td>'
+        '</tr>'
+        '</tbody>'
+        '</table>')

encommon/webkit/test/test_datetime.py

@@ -0,0 +1,75 @@
+"""
+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 typing import TYPE_CHECKING
+
+from selenium.webdriver.remote.webdriver import WebDriver
+
+from . import _executejs
+
+if TYPE_CHECKING:
+    from ..content import Content
+
+
+
+def test_datestamp(
+    content: 'Content',
+    driver: WebDriver,
+) -> None:
+    """
+    Perform various tests associated with relevant routines.
+
+    :param content: Primary class instance for the content.
+    :param driver: Selenium driver provided by the library.
+    """
+
+
+    driver.get(
+        f"""
+        data:text/html;
+        charset=utf-8,
+        <html>
+          <head>
+            <script>
+        {content.scripts('default')}
+        {content.scripts('helpers')}
+        {content.scripts('datetime')}
+            </script>
+          </head>
+          <body></body>
+        </html>
+        """)
+
+
+    outcome = _executejs(
+        driver,
+        'let element ='
+        ' datestamp(...arguments);'
+        'return'
+        ' element[0].outerHTML;',
+        '2024-04-20T16:20:00Z',
+        wrap=False)
+
+
+    assert outcome == (
+        '<div class="encommon_datestamp">'
+        '<span class="_value _year">2024</span>'
+        '<span class="_delim _slash">-</span>'
+        '<span class="_value _month">04</span>'
+        '<span class="_delim _slash">-</span>'
+        '<span class="_value _day">20</span>'
+        '<span class="_delim _space">&nbsp;</span>'
+        '<span class="_value _hours">16</span>'
+        '<span class="_delim _colon">:</span>'
+        '<span class="_value _minutes">20</span>'
+        '<span class="_delim _colon">:</span>'
+        '<span class="_value _seconds">00</span>'
+        '<span class="_delim _space">&nbsp;</span>'
+        '<span class="_tzname">UTC</span>'
+        '</div>')