bluer-objects 6.307.1__tar.gz → 6.317.1__tar.gz

{bluer_objects-6.307.1/bluer_objects.egg-info → bluer_objects-6.317.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.307.1
+Version: 6.317.1
 Summary: 🌀 Object management in Bash.
 Home-page: https://github.com/kamangir/bluer-objects
 Author: Arash Abadpour (Kamangir)
@@ -65,6 +65,6 @@ pip install bluer-objects
 
 [![pylint](https://github.com/kamangir/bluer-objects/actions/workflows/pylint.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/pylint.yml) [![pytest](https://github.com/kamangir/bluer-objects/actions/workflows/pytest.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/pytest.yml) [![bashtest](https://github.com/kamangir/bluer-objects/actions/workflows/bashtest.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/bashtest.yml) [![PyPI version](https://img.shields.io/pypi/v/bluer-objects.svg)](https://pypi.org/project/bluer-objects/) [![PyPI - Downloads](https://img.shields.io/pypi/dd/bluer-objects)](https://pypistats.org/packages/bluer-objects)
 
-built by 🌀 [`bluer README`](https://github.com/kamangir/bluer-objects/tree/main/bluer_objects/README), based on 🌀 [`bluer_objects-6.307.1`](https://github.com/kamangir/bluer-objects).
+built by 🌀 [`bluer README`](https://github.com/kamangir/bluer-objects/tree/main/bluer_objects/README), based on 🌀 [`bluer_objects-6.317.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.118.1`](https://github.com/kamangir/blueness).

{bluer_objects-6.307.1 → bluer_objects-6.317.1}/README.md

@@ -31,4 +31,4 @@ pip install bluer-objects
 
 [![pylint](https://github.com/kamangir/bluer-objects/actions/workflows/pylint.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/pylint.yml) [![pytest](https://github.com/kamangir/bluer-objects/actions/workflows/pytest.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/pytest.yml) [![bashtest](https://github.com/kamangir/bluer-objects/actions/workflows/bashtest.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/bashtest.yml) [![PyPI version](https://img.shields.io/pypi/v/bluer-objects.svg)](https://pypi.org/project/bluer-objects/) [![PyPI - Downloads](https://img.shields.io/pypi/dd/bluer-objects)](https://pypistats.org/packages/bluer-objects)
 
-built by 🌀 [`bluer README`](https://github.com/kamangir/bluer-objects/tree/main/bluer_objects/README), based on 🌀 [`bluer_objects-6.307.1`](https://github.com/kamangir/bluer-objects).
+built by 🌀 [`bluer README`](https://github.com/kamangir/bluer-objects/tree/main/bluer_objects/README), based on 🌀 [`bluer_objects-6.317.1`](https://github.com/kamangir/bluer-objects).

bluer_objects-6.317.1/bluer_objects/.abcli/file.sh

@@ -0,0 +1,19 @@
+#! /usr/bin/env bash
+
+function bluer_objects_file() {
+    local options=$1
+    local do_sudo=$(bluer_ai_option_int "$options" sudo 0)
+
+    local task=$2
+
+    local prefix=""
+    [[ "$do_sudo" == 1 ]] &&
+        prefix="sudo -E"
+
+    local filename=$3
+
+    $prefix $(which python) -m bluer_objects.file \
+        "$task" \
+        --filename "$filename" \
+        "${@:4}"
+}

bluer_objects-6.317.1/bluer_objects/.abcli/tests/file.sh

@@ -0,0 +1,64 @@
+#! /usr/bin/env bash
+
+function test_file_asset() {
+    echo $abcli_path_git/bluer-objects/bluer_objects/.abcli/tests/file.sh
+}
+
+function test_file_replace() {
+    local options=$1
+
+    local filename=$abcli_path_git/file.sh
+
+    cp -v \
+        $(test_file_asset) \
+        $filename
+    [[ $? -ne 0 ]] && return 1
+
+    bluer_objects_file - \
+        replace \
+        $filename \
+        --this function+local \
+        --that FUNCTION+LOCAL \
+        --cat 1 \
+        "${@:2}"
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    # ---
+
+    bluer_objects_file - \
+        replace \
+        $filename \
+        --this "FUNCTION test_file_asset() {+echo" \
+        --that ":)+:(" \
+        --cat 1 \
+        --whole_line 1 \
+        "${@:2}"
+    [[ $? -ne 0 ]] && return 1
+    rm -v $filename
+}
+
+function test_file_size() {
+    local options=$1
+
+    local size=$(bluer_objects_file - \
+        size \
+        $(test_file_asset))
+
+    bluer_ai_assert \
+        "$size" \
+        "1.18 kB"
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    # ---
+
+    local size=$(bluer_objects_file - \
+        size \
+        $(test_file_asset) \
+        --pretty 0)
+
+    bluer_ai_assert \
+        "$size" \
+        "1209"
+}

{bluer_objects-6.307.1 → bluer_objects-6.317.1}/bluer_objects/.abcli/tests/help.sh

@@ -38,6 +38,10 @@ function test_bluer_objects_help() {
         \
         "@ls" \
         \
+        "@file" \
+        "@file replace" \
+        "@file size" \
+        \
         "@host" \
         "@host get" \
         "@host reboot" \

{bluer_objects-6.307.1 → bluer_objects-6.317.1}/bluer_objects/README/__init__.py

@@ -41,6 +41,7 @@ def build_me() -> bool:
                 "assets",
                 "clone",
                 "download",
+                "file",
                 "gif",
                 "host",
                 "ls",

{bluer_objects-6.307.1 → bluer_objects-6.317.1}/bluer_objects/__init__.py

@@ -4,7 +4,7 @@ ICON = "🌀"
 
 DESCRIPTION = f"{ICON} Object management in Bash."
 
-VERSION = "6.307.1"
+VERSION = "6.317.1"
 
 REPO_NAME = "bluer-objects"
 

bluer_objects-6.317.1/bluer_objects/file/__main__.py

@@ -0,0 +1,101 @@
+import argparse
+from tqdm import tqdm
+
+from blueness import module
+from blueness.argparse.generic import sys_exit
+from bluer_options import string
+
+from bluer_objects import file, NAME
+from bluer_objects.logger import logger
+
+NAME = module.name(__file__, NAME)
+
+parser = argparse.ArgumentParser(NAME)
+parser.add_argument(
+    "task",
+    type=str,
+    help="replace | size",
+)
+parser.add_argument(
+    "--filename",
+    type=str,
+)
+parser.add_argument(
+    "--this",
+    type=str,
+    help="<this-1+this-2+this-3>",
+)
+parser.add_argument(
+    "--that",
+    type=str,
+    help="<that-1+that-2+that-3>",
+)
+parser.add_argument(
+    "--pretty",
+    type=int,
+    default=1,
+    help="0 | 1",
+)
+parser.add_argument(
+    "--save",
+    type=int,
+    default=1,
+    help="0 | 1",
+)
+parser.add_argument(
+    "--whole_line",
+    type=int,
+    default=0,
+    help="0 | 1",
+)
+parser.add_argument(
+    "--log",
+    type=int,
+    default=0,
+    help="0 | 1",
+)
+parser.add_argument(
+    "--cat",
+    type=int,
+    default=0,
+    help="0 | 1",
+)
+args = parser.parse_args()
+
+success = False
+if args.task == "replace":
+    logger.info(
+        f'{NAME}.{args.task}: "{args.this}" -> "{args.that}" in {args.filename}'
+    )
+
+    success, content = file.load_text(
+        args.filename,
+        log=args.log == 1,
+    )
+    if success:
+        for this, that in tqdm(zip(args.this.split("+"), args.that.split("+"))):
+            if args.whole_line:
+                content = [that if line == this else line for line in content]
+            else:
+                content = [line.replace(this, that) for line in content]
+
+        if args.save == 1:
+            success = file.save_text(
+                args.filename,
+                content,
+                log=args.log == 1,
+            )
+
+        if success and args.cat:
+            for line in content:
+                if any(this in line for this in args.this.split("+")):
+                    logger.info(line)
+
+elif args.task == "size":
+    size = file.size(args.filename)
+    print(string.pretty_bytes(size) if args.pretty == 1 else size)
+    success = True
+else:
+    success = None
+
+sys_exit(logger, NAME, args.task, success)

bluer_objects-6.317.1/bluer_objects/help/file.py

@@ -0,0 +1,59 @@
+from typing import List
+
+from bluer_options.terminal import show_usage, xtra
+
+
+def help_replace(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = xtra("sudo", mono=mono)
+
+    args = [
+        "--cat 1",
+        "--save 0",
+        "--this this-1+this-2",
+        "--that that-1+that-2",
+        "--whole_line 1",
+    ]
+
+    return show_usage(
+        [
+            "@file",
+            f"[{options}]",
+            "replace",
+            "<filename>",
+        ]
+        + args,
+        "<this> -> <that> in <filename>.",
+        mono=mono,
+    )
+
+
+def help_size(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = "-"
+
+    args = [
+        "--pretty 0",
+    ]
+
+    return show_usage(
+        [
+            "@file",
+            f"[{options}]",
+            "size",
+            "<filename>",
+        ]
+        + args,
+        "size of <filename>",
+        mono=mono,
+    )
+
+
+help_functions = {
+    "replace": help_replace,
+    "size": help_size,
+}

{bluer_objects-6.307.1 → bluer_objects-6.317.1}/bluer_objects/help/functions.py

@@ -6,6 +6,7 @@ from bluer_objects.help.clone import help_clone
 from bluer_objects.help.create_test_asset import help_create_test_asset
 from bluer_objects.help.download import help_download
 from bluer_objects.help.gif import help_functions as help_gif
+from bluer_objects.help.file import help_functions as help_file
 from bluer_objects.help.host import help_functions as help_host
 from bluer_objects.help.ls import help_ls
 from bluer_objects.help.metadata import help_functions as help_metadata
@@ -21,6 +22,7 @@ help_functions.update(
         "clone": help_clone,
         "create_test_asset": help_create_test_asset,
         "download": help_download,
+        "file": help_file,
         "gif": help_gif,
         "host": help_host,
         "ls": help_ls,

bluer_objects-6.317.1/bluer_objects/logger/stitch.py

@@ -0,0 +1,107 @@
+from typing import List
+import numpy as np
+
+from blueness import module
+from bluer_options import string
+
+from bluer_objects import NAME
+from bluer_objects.logger import logger
+
+NAME = module.name(__file__, NAME)
+
+
+def stitch_images(
+    list_of_images: List[np.ndarray],
+    cols: int = -1,
+    rows: int = -1,
+    log: bool = False,
+) -> np.ndarray:
+    if not list_of_images:
+        return np.zeros((1, 1, 3), dtype=np.uint8)
+
+    list_of_images = list_of_images.copy()
+
+    if rows == -1:
+        rows = int(np.floor(np.sqrt(len(list_of_images))))
+        cols = -1
+
+    if cols == -1:
+        cols = int(np.ceil(len(list_of_images) / rows))
+
+    if log:
+        logger.info(
+            "{}.stitch_images[{}x{}]({}): {}".format(
+                NAME,
+                rows,
+                cols,
+                len(list_of_images),
+                ", ".join(
+                    [string.pretty_shape_of_matrix(image) for image in list_of_images]
+                ),
+            )
+        )
+
+    for image in list_of_images:
+        if len(image.shape) == 2:
+            image = np.stack([image, image, image], axis=2)
+
+    if rows == 1:
+        output = np.zeros(
+            (
+                max([image.shape[0] for image in list_of_images]),
+                sum([image.shape[1] for image in list_of_images]),
+                3,
+            ),
+            dtype=np.uint8,
+        )
+        x: int = 0
+        for image in list_of_images:
+            x_new = x + image.shape[1]
+
+            output[
+                : image.shape[0],
+                x:x_new,
+                :,
+            ] = image
+
+            x = x_new
+
+        return output
+
+    if cols == 1:
+        output = np.zeros(
+            (
+                sum([image.shape[0] for image in list_of_images]),
+                max([image.shape[1] for image in list_of_images]),
+                3,
+            ),
+            dtype=np.uint8,
+        )
+        y: int = 0
+        for image in list_of_images:
+            y_new = y + image.shape[0]
+
+            output[
+                y:y_new,
+                : image.shape[1],
+                :,
+            ] = image
+
+            y = y_new
+
+        return output
+
+    return stitch_images(
+        list_of_images=[
+            stitch_images(
+                list_of_images[row * cols : (row + 1) * cols],
+                cols=cols,
+                rows=1,
+                log=log,
+            )
+            for row in range(rows)
+        ],
+        cols=1,
+        rows=rows,
+        log=log,
+    )

bluer_objects-6.317.1/bluer_objects/tests/test_logger_stitch_images.py

@@ -0,0 +1,47 @@
+import pytest
+import numpy as np
+import random
+
+from bluer_objects.logger.stitch import stitch_images
+
+
+@pytest.mark.parametrize(
+    ["count"],
+    [[count] for count in range(10)],
+)
+@pytest.mark.parametrize(
+    ["cols"],
+    [[cols] for cols in [-1, 1, 3]],
+)
+@pytest.mark.parametrize(
+    ["rows"],
+    [[rows] for rows in [-1, 1, 3]],
+)
+def test_logger_stitch_images(
+    count: int,
+    cols: int,
+    rows: int,
+):
+    rng = np.random.default_rng()
+
+    list_of_images = list_of_images = [
+        rng.integers(
+            0,
+            256,
+            (
+                random.randint(1, 512),
+                random.randint(1, 512),
+                random.choice([1, 3]),
+            ),
+            dtype=np.uint8,
+        )
+        for _ in range(count)
+    ]
+
+    image = stitch_images(
+        list_of_images,
+        cols=cols,
+        rows=rows,
+        log=True,
+    )
+    assert isinstance(image, np.ndarray)

{bluer_objects-6.307.1 → bluer_objects-6.317.1/bluer_objects.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.307.1
+Version: 6.317.1
 Summary: 🌀 Object management in Bash.
 Home-page: https://github.com/kamangir/bluer-objects
 Author: Arash Abadpour (Kamangir)
@@ -65,6 +65,6 @@ pip install bluer-objects
 
 [![pylint](https://github.com/kamangir/bluer-objects/actions/workflows/pylint.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/pylint.yml) [![pytest](https://github.com/kamangir/bluer-objects/actions/workflows/pytest.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/pytest.yml) [![bashtest](https://github.com/kamangir/bluer-objects/actions/workflows/bashtest.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/bashtest.yml) [![PyPI version](https://img.shields.io/pypi/v/bluer-objects.svg)](https://pypi.org/project/bluer-objects/) [![PyPI - Downloads](https://img.shields.io/pypi/dd/bluer-objects)](https://pypistats.org/packages/bluer-objects)
 
-built by 🌀 [`bluer README`](https://github.com/kamangir/bluer-objects/tree/main/bluer_objects/README), based on 🌀 [`bluer_objects-6.307.1`](https://github.com/kamangir/bluer-objects).
+built by 🌀 [`bluer README`](https://github.com/kamangir/bluer-objects/tree/main/bluer_objects/README), based on 🌀 [`bluer_objects-6.317.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.118.1`](https://github.com/kamangir/blueness).

{bluer_objects-6.307.1 → bluer_objects-6.317.1}/bluer_objects.egg-info/SOURCES.txt

@@ -65,6 +65,7 @@ bluer_objects/.abcli/storage/status.sh
 bluer_objects/.abcli/tests/README.sh
 bluer_objects/.abcli/tests/clone.sh
 bluer_objects/.abcli/tests/create_test_asset.sh
+bluer_objects/.abcli/tests/file.sh
 bluer_objects/.abcli/tests/gif.sh
 bluer_objects/.abcli/tests/help.sh
 bluer_objects/.abcli/tests/host.sh
@@ -111,6 +112,7 @@ bluer_objects/help/assets.py
 bluer_objects/help/clone.py
 bluer_objects/help/create_test_asset.py
 bluer_objects/help/download.py
+bluer_objects/help/file.py
 bluer_objects/help/functions.py
 bluer_objects/help/gif.py
 bluer_objects/help/host.py
@@ -128,6 +130,7 @@ bluer_objects/host/functions.py
 bluer_objects/logger/__init__.py
 bluer_objects/logger/image.py
 bluer_objects/logger/matrix.py
+bluer_objects/logger/stitch.py
 bluer_objects/metadata/__init__.py
 bluer_objects/metadata/__main__.py
 bluer_objects/metadata/enums.py
@@ -175,6 +178,7 @@ bluer_objects/tests/test_graphics_text.py
 bluer_objects/tests/test_log_image_grid.py
 bluer_objects/tests/test_logger.py
 bluer_objects/tests/test_logger_matrix.py
+bluer_objects/tests/test_logger_stitch_images.py
 bluer_objects/tests/test_markdown.py
 bluer_objects/tests/test_metadata.py
 bluer_objects/tests/test_metadata_flatten.py

bluer_objects-6.307.1/bluer_objects/.abcli/file.sh

@@ -1,8 +0,0 @@
-#! /usr/bin/env bash
-
-function bluer_objects_file() {
-    python3 -m bluer_objects.file \
-        "$1" \
-        --filename "$2" \
-        "${@:3}"
-}

bluer_objects-6.307.1/bluer_objects/file/__main__.py

@@ -1,56 +0,0 @@
-import argparse
-from tqdm import tqdm
-
-from blueness import module
-from blueness.argparse.generic import sys_exit
-from bluer_options import string
-
-from bluer_objects import file, NAME
-from bluer_objects.logger import logger
-
-NAME = module.name(__file__, NAME)
-
-parser = argparse.ArgumentParser(NAME)
-parser.add_argument(
-    "task",
-    type=str,
-    help="replace | size",
-)
-parser.add_argument(
-    "--filename",
-    type=str,
-)
-parser.add_argument(
-    "--this",
-    type=str,
-    help="<this-1+this-2+this-3>",
-)
-parser.add_argument(
-    "--that",
-    type=str,
-    help="<that-1+that-2+that-3>",
-)
-parser.add_argument(
-    "--size",
-    type=int,
-    default=16,
-)
-args = parser.parse_args()
-
-success = False
-if args.task == "replace":
-    logger.info(f"{NAME}.{args.task}: {args.this} -> {args.that} in {args.filename}")
-
-    success, content = file.load_text(args.filename)
-    if success:
-        for this, that in tqdm(zip(args.this.split("+"), args.that.split("+"))):
-            content = [line.replace(this, that) for line in content]
-
-        success = file.save_text(args.filename, content)
-elif args.task == "size":
-    print(string.pretty_bytes(file.size(args.filename)))
-    success = True
-else:
-    success = None
-
-sys_exit(logger, NAME, args.task, success)