bluer-objects 6.271.1__tar.gz → 6.282.1__tar.gz

{bluer_objects-6.271.1/bluer_objects.egg-info → bluer_objects-6.282.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.271.1
+Version: 6.282.1
 Summary: 🌀 Object management in Bash.
 Home-page: https://github.com/kamangir/bluer-objects
 Author: Arash Abadpour (Kamangir)
@@ -46,6 +46,7 @@ pip install bluer-objects
 
 # aliases
 
+[@assets](https://github.com/kamangir/bluer-objects/blob/main/bluer_objects/docs/aliases/assets.md), 
 [@clone](https://github.com/kamangir/bluer-objects/blob/main/bluer_objects/docs/aliases/clone.md), 
 [@download](https://github.com/kamangir/bluer-objects/blob/main/bluer_objects/docs/aliases/download.md), 
 [@gif](https://github.com/kamangir/bluer-objects/blob/main/bluer_objects/docs/aliases/gif.md), 
@@ -64,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.271.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.282.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.118.1`](https://github.com/kamangir/blueness).

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/README.md

@@ -12,6 +12,7 @@ pip install bluer-objects
 
 # aliases
 
+[@assets](./bluer_objects/docs/aliases/assets.md), 
 [@clone](./bluer_objects/docs/aliases/clone.md), 
 [@download](./bluer_objects/docs/aliases/download.md), 
 [@gif](./bluer_objects/docs/aliases/gif.md), 
@@ -30,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.271.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.282.1`](https://github.com/kamangir/bluer-objects).

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/bluer_objects/.abcli/alias.sh

@@ -2,6 +2,8 @@
 
 alias @ai=bluer_ai
 
+alias @assets=bluer_objects_assets
+
 alias @create_test_asset=bluer_objects_create_test_asset
 
 alias @download=bluer_objects_download

bluer_objects-6.282.1/bluer_objects/.abcli/assets/cd.sh

@@ -0,0 +1,20 @@
+#! /usr/bin/env bash
+
+function bluer_objects_assets_cd() {
+    local options=$1
+    local do_create=$(bluer_ai_option_int "$options" create 0)
+    local volume=$(bluer_ai_option "$options" vol)
+
+    local path=$2
+    path=$abcli_path_git/assets$volume/$path
+
+    if [[ "$do_create" == 1 ]]; then
+        mkdir -pv $path
+        [[ $? -ne 0 ]] && return 1
+    fi
+
+    cd $path
+    [[ $? -ne 0 ]] && return 1
+
+    bluer_ai_log "🔗 $path"
+}

bluer_objects-6.282.1/bluer_objects/.abcli/assets/mv.sh

@@ -0,0 +1,34 @@
+#! /usr/bin/env bash
+
+function bluer_objects_assets_mv() {
+    local options=$1
+    local do_create=$(bluer_ai_option_int "$options" create 0)
+    local extension=$(bluer_ai_option "$options" extension jpg)
+    local volume=$(bluer_ai_option "$options" vol)
+
+    local path=$2
+    path=$abcli_path_git/assets$volume/$path
+
+    if [[ "$do_create" == 1 ]]; then
+        mkdir -pv $path
+        [[ $? -ne 0 ]] && return 1
+    fi
+
+    bluer_ai_log "Downloads/.$extension -> assets$volume/path"
+
+    mv -v \
+        $HOME/Downloads/*.$extension \
+        $path
+    [[ $? -ne 0 ]] && return 1
+
+    local push_options=$3
+    local do_push=$(bluer_ai_option_int "$push_options" push 0)
+    [[ "$do_push" == 0 ]] &&
+        return 0
+
+    bluer_ai_git \
+        assets$volume \
+        push \
+        "$path += " \
+        $push_options
+}

bluer_objects-6.282.1/bluer_objects/.abcli/assets/publish.sh

@@ -0,0 +1,37 @@
+#! /usr/bin/env bash
+
+function bluer_objects_assets_publish() {
+    local options=$1
+
+    local do_download=$(bluer_ai_option_int "$options" download 0)
+    local do_pull=$(bluer_ai_option_int "$options" pull 1)
+    local do_push=$(bluer_ai_option_int "$options" push 0)
+    local extensions=$(bluer_ai_option "$options" extensions png)
+
+    [[ "$do_pull" == 1 ]] &&
+        bluer_ai_git \
+            assets \
+            pull \
+            ~all
+
+    local object_name=$(bluer_ai_clarify_object $2 .)
+
+    [[ "$do_download" == 1 ]] &&
+        bluer_objects_download - $object_name
+
+    bluer_ai_eval dryrun=$do_dryrun \
+        python3 -m bluer_objects.assets \
+        publish \
+        --object_name $object_name \
+        --extensions $extensions \
+        "${@:3}"
+    [[ $? -ne 0 ]] && return 1
+
+    [[ "$do_push" == 1 ]] &&
+        bluer_ai_git \
+            assets \
+            push \
+            "$object_name update."
+
+    return 0
+}

bluer_objects-6.282.1/bluer_objects/.abcli/assets.sh

@@ -0,0 +1,15 @@
+#! /usr/bin/env bash
+
+function bluer_objects_assets() {
+    local task=$1
+
+    local function_name=bluer_objects_assets_$task
+    if [[ $(type -t $function_name) == "function" ]]; then
+        $function_name "${@:2}"
+        return
+    fi
+
+    python3 -m bluer_objects.assets "$@"
+}
+
+bluer_ai_source_caller_suffix_path /assets

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/bluer_objects/.abcli/tests/gif.sh

@@ -12,6 +12,7 @@ function test_bluer_objects_gif() {
     bluer_objects_gif \
         ~upload,$options \
         $source_object_name \
+        --frame_count 20 \
         --frame_duration 200 \
         --output_filename test.gif \
         --scale 2 \

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/bluer_objects/.abcli/tests/help.sh

@@ -8,6 +8,11 @@ function test_bluer_objects_help() {
 
     local module
     for module in \
+        "@assets" \
+        "@assets cd" \
+        "@assets mv" \
+        "@assets publish" \
+        \
         "@cp" \
         \
         "@create_test_asset" \

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/bluer_objects/README/__init__.py

@@ -30,18 +30,29 @@ def build_me() -> bool:
             ),
         )
         for path in [
+            "../docs/aliases",
+            "../docs",
             "../..",
             ".",
-            # aliases
-            "../docs/aliases/clone.md",
-            "../docs/aliases/download.md",
-            "../docs/aliases/gif.md",
-            "../docs/aliases/host.md",
-            "../docs/aliases/ls.md",
-            "../docs/aliases/metadata.md",
-            "../docs/aliases/mlflow.md",
-            "../docs/aliases/upload.md",
-            # modules
-            "../mlflow/lock",
+        ]
+        + [
+            f"../docs/aliases/{alias}.md"
+            for alias in [
+                "assets",
+                "clone",
+                "download",
+                "gif",
+                "host",
+                "ls",
+                "metadata",
+                "mlflow",
+                "upload",
+            ]
+        ]
+        + [
+            f"../mlflow/{module_name}"
+            for module_name in [
+                "lock",
+            ]
         ]
     )

bluer_objects-6.282.1/bluer_objects/README/consts.py

@@ -0,0 +1,21 @@
+from typing import Union
+
+github_kamangir = "https://github.com/kamangir"
+
+
+def asset_volume(volume: Union[str, int] = "") -> str:
+    return f"{github_kamangir}/assets{str(volume)}/raw/main"
+
+
+assets = asset_volume(volume="")
+assets2 = asset_volume(volume="2")
+
+
+def assets_path(
+    suffix: str,
+    volume: Union[str, int] = "",
+) -> str:
+    return "{}/{}".format(
+        asset_volume(volume=volume),
+        suffix,
+    )

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/bluer_objects/README/functions.py

@@ -42,6 +42,7 @@ def build(
     help_function: Union[Callable[[List[str]], str], None] = None,
     legacy_mode: bool = True,
     assets_repo: str = "kamangir/assets",
+    download: bool = True,
 ) -> bool:
     if path:
         if path.endswith(".md"):
@@ -103,7 +104,7 @@ def build(
                 object_name,
                 key,
                 {},
-                download=True,
+                download=download,
             )
 
             logger.info(f"metadata[{object_name_and_key}] = {value}")

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/bluer_objects/__init__.py

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

bluer_objects-6.282.1/bluer_objects/assets/__main__.py

@@ -0,0 +1,57 @@
+import argparse
+
+from blueness import module
+from blueness.argparse.generic import sys_exit
+
+from bluer_objects import NAME
+from bluer_objects.assets.functions import publish
+from bluer_objects.logger import logger
+
+NAME = module.name(__file__, NAME)
+
+parser = argparse.ArgumentParser(NAME)
+parser.add_argument(
+    "task",
+    type=str,
+    help="publish",
+)
+parser.add_argument(
+    "--arg",
+    type=bool,
+    default=0,
+    help="0|1",
+)
+parser.add_argument(
+    "--object_name",
+    type=str,
+)
+parser.add_argument(
+    "--extensions",
+    type=str,
+    default="png",
+    help="png+txt",
+)
+parser.add_argument(
+    "--prefix",
+    type=str,
+    default="",
+)
+parser.add_argument(
+    "--asset_name",
+    type=str,
+    default="",
+)
+args = parser.parse_args()
+
+success = False
+if args.task == "publish":
+    success = publish(
+        object_name=args.object_name,
+        list_of_extensions=args.extensions.split("+"),
+        prefix=args.prefix,
+        asset_name=args.asset_name,
+    )
+else:
+    success = None
+
+sys_exit(logger, NAME, args.task, success)

bluer_objects-6.282.1/bluer_objects/assets/functions.py

@@ -0,0 +1,62 @@
+import os
+from typing import List
+import glob
+from tqdm import tqdm
+
+from blueness import module
+
+from bluer_objects import objects, file
+from bluer_objects.env import abcli_path_git
+from bluer_objects import NAME
+from bluer_objects.logger import logger
+
+
+NAME = module.name(__file__, NAME)
+
+
+def publish(
+    object_name: str,
+    list_of_extensions: List[str],
+    prefix: str = "",
+    asset_name: str = "",
+    log: bool = True,
+) -> bool:
+    if not asset_name:
+        asset_name = object_name
+    logger.info(
+        "{}.publish: {}/{}.* for {} -> {}".format(
+            NAME,
+            object_name,
+            prefix,
+            ", ".join(list_of_extensions),
+            asset_name,
+        )
+    )
+
+    for extension in tqdm(list_of_extensions):
+        for filename in glob.glob(
+            objects.path_of(
+                filename=f"{prefix}*.{extension}",
+                object_name=object_name,
+            )
+        ):
+            published_filename = os.path.join(
+                abcli_path_git,
+                "assets",
+                asset_name,
+                file.name_and_extension(filename).replace(
+                    object_name,
+                    asset_name,
+                ),
+            )
+
+            if not file.copy(
+                filename,
+                published_filename,
+                log=log,
+            ):
+                return False
+
+    logger.info(f"🔗  https://github.com/kamangir/assets/tree/main/{asset_name}")
+
+    return True

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/bluer_objects/graphics/__main__.py

@@ -34,6 +34,12 @@ parser.add_argument(
     type=str,
     help="blank: <object-name>.gif",
 )
+parser.add_argument(
+    "--frame_count",
+    default=-1,
+    type=int,
+    help="-1: all",
+)
 parser.add_argument(
     "--frame_duration",
     default=150,
@@ -72,6 +78,7 @@ if args.task == "generate_animated_gif":
             ),
             object_name=args.object_name,
         ),
+        frame_count=args.frame_count,
         frame_duration=args.frame_duration,
         scale=args.scale,
     )

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/bluer_objects/graphics/gif.py

@@ -15,6 +15,7 @@ NAME = module.name(__file__, NAME)
 def generate_animated_gif(
     list_of_images: List[str],
     output_filename: str,
+    frame_count: int = -1,
     frame_duration: int = 150,
     scale: int = 1,
     log: bool = True,
@@ -22,6 +23,9 @@ def generate_animated_gif(
     if not list_of_images:
         return True
 
+    if frame_count != -1:
+        list_of_images = list_of_images[:frame_count]
+
     max_width = 0
     max_height = 0
     frames = []
@@ -67,7 +71,7 @@ def generate_animated_gif(
     except Exception:
         success = False
 
-    message = "{}.generate_animated_gif({}x{}x{}) -scale={}-> {} @ {:.2f}ms".format(
+    message = "{}.generate_animated_gif({}x{}x{}) -scale={}-> {} @ {:.2f}ms{}".format(
         NAME,
         len(list_of_images),
         height,
@@ -75,6 +79,7 @@ def generate_animated_gif(
         scale,
         output_filename,
         frame_duration,
+        "" if frame_count == -1 else " [{} frame(s)]".format(frame_count),
     )
 
     if success:

bluer_objects-6.282.1/bluer_objects/help/assets.py

@@ -0,0 +1,96 @@
+from typing import List
+
+from bluer_options.terminal import show_usage, xtra
+from bluer_ai.help.git import push_options
+
+
+def help_cd(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = "".join(
+        [
+            xtra("create,", mono=mono),
+            "vol=<2>",
+        ]
+    )
+
+    return show_usage(
+        [
+            "@assets",
+            "cd",
+            f"[{options}]",
+            "[<path>]",
+        ],
+        "cd assets volume.",
+        mono=mono,
+    )
+
+
+def help_mv(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = "".join(
+        [
+            xtra("create,", mono=mono),
+            "extension=<png>,vol=<2>",
+        ]
+    )
+
+    return show_usage(
+        [
+            "@assets",
+            "mv",
+            f"[{options}]",
+            "[<path>]",
+            "[push,{}]".format(
+                push_options(
+                    mono=mono,
+                    uses_actions=False,
+                    uses_pull_request=False,
+                    uses_workflows=False,
+                )
+            ),
+        ],
+        "mv assets to volume.",
+        mono=mono,
+    )
+
+
+def help_publish(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = "".join(
+        [
+            xtra("download,", mono=mono),
+            "extensions=<png+txt>",
+            xtra(",~pull,", mono=mono),
+            "push",
+        ]
+    )
+
+    args = [
+        "[--asset_name <other-object-name>]",
+        "[--prefix <prefix>]",
+    ]
+
+    return show_usage(
+        [
+            "@assets",
+            "publish",
+            f"[{options}]",
+            "[.|<object-name>]",
+        ]
+        + args,
+        "<object-name>/<prefix> -> assets.",
+        mono=mono,
+    )
+
+
+help_functions = {
+    "cd": help_cd,
+    "mv": help_mv,
+    "publish": help_publish,
+}

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/bluer_objects/help/functions.py

@@ -1,6 +1,7 @@
 from bluer_ai.help.generic import help_functions as generic_help_functions
 
 from bluer_objects import ALIAS
+from bluer_objects.help.assets import help_functions as help_assets
 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
@@ -16,6 +17,7 @@ help_functions = generic_help_functions(plugin_name=ALIAS)
 
 help_functions.update(
     {
+        "assets": help_assets,
         "clone": help_clone,
         "create_test_asset": help_create_test_asset,
         "download": help_download,

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/bluer_objects/help/gif.py

@@ -10,6 +10,7 @@ def help_gif(
     options = xtra("~download,dryrun,~upload", mono=mono)
 
     args = [
+        "[--frame_count <100>]",
         "[--frame_duration <150>]",
         "[--output_filename <object-name>.gif]",
         "[--scale <1>]",

bluer_objects-6.282.1/bluer_objects/tests/test_README_assets.py

@@ -0,0 +1,35 @@
+import pytest
+from bluer_objects.README.consts import assets_path, asset_volume
+
+
+@pytest.mark.parametrize(
+    ["suffix"],
+    [
+        ["this"],
+        ["that/which"],
+    ],
+)
+@pytest.mark.parametrize(
+    ["volume"],
+    [
+        [""],
+        ["2"],
+        [2],
+    ],
+)
+def test_README_assets(
+    suffix: str,
+    volume: str,
+):
+    volume_path = asset_volume(volume=volume)
+    assert isinstance(volume_path, str)
+    assert volume_path.endswith(volume_path)
+
+    path = assets_path(
+        suffix=suffix,
+        volume=volume,
+    )
+
+    assert isinstance(path, str)
+    assert path.endswith(suffix)
+    assert volume_path in path

{bluer_objects-6.271.1 → bluer_objects-6.282.1}/bluer_objects/tests/test_graphics_gif.py

@@ -24,4 +24,6 @@ def test_graphics_gif_generate_animated_gif(
         list_of_images,
         objects.path_of("test.gif", test_object),
         scale=scale,
+        frame_count=10,
+        frame_duration=100,
     )

{bluer_objects-6.271.1 → bluer_objects-6.282.1/bluer_objects.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.271.1
+Version: 6.282.1
 Summary: 🌀 Object management in Bash.
 Home-page: https://github.com/kamangir/bluer-objects
 Author: Arash Abadpour (Kamangir)
@@ -46,6 +46,7 @@ pip install bluer-objects
 
 # aliases
 
+[@assets](https://github.com/kamangir/bluer-objects/blob/main/bluer_objects/docs/aliases/assets.md), 
 [@clone](https://github.com/kamangir/bluer-objects/blob/main/bluer_objects/docs/aliases/clone.md), 
 [@download](https://github.com/kamangir/bluer-objects/blob/main/bluer_objects/docs/aliases/download.md), 
 [@gif](https://github.com/kamangir/bluer-objects/blob/main/bluer_objects/docs/aliases/gif.md), 
@@ -64,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.271.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.282.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.118.1`](https://github.com/kamangir/blueness).