bluer-objects 6.377.1__py3-none-any.whl → 6.464.1__py3-none-any.whl

bluer_objects/.abcli/alias.sh

@@ -1,8 +1,5 @@
 #! /usr/bin/env bash
 
-alias @ai=bluer_ai
-alias @i=bluer_ai
-
 alias @assets=bluer_objects_assets
 
 alias @create_test_asset=bluer_objects_create_test_asset
@@ -12,7 +9,6 @@ alias @download=bluer_objects_download
 alias @gif=bluer_objects_gif
 
 alias @cache=bluer_objects_mlflow_cache
-alias @ref="bluer_objects_mlflow_cache read"
 alias @tags=bluer_objects_mlflow_tags
 
 alias @clone=bluer_objects_clone
@@ -30,18 +26,18 @@ alias @metadata=bluer_objects_metadata
 
 alias @mlflow=bluer_objects_mlflow
 
-alias @mysql=abcli_mysql
+alias @pdf=bluer_objects_pdf
 
-alias @objects=bluer_objects
+alias @upload=bluer_objects_upload
 
-alias @pdf=bluer_objects_pdf
+# ignore
+alias @i=bluer_ai
+alias @ai=bluer_ai
+
+alias @objects=bluer_objects
 
-alias @random=bluer_ai_string_random
+alias @ref="bluer_objects_mlflow_cache read"
 
 alias @select=bluer_ai_select
 
 alias @storage=bluer_ai_storage
-
-alias @upload=bluer_objects_upload
-
-alias @web=bluer_objects_web

bluer_objects/.abcli/assets/cd.sh

@@ -3,7 +3,7 @@
 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 volume=$(bluer_ai_option "$options" vol $BLUER_OBJECTS_DEFAULT_ASSETS_VOL)
 
     local path=$2
     path=$abcli_path_git/assets$volume/$path

bluer_objects/.abcli/assets/mv.sh

@@ -2,23 +2,23 @@
 
 function bluer_objects_assets_mv() {
     local options=$1
-    local do_create=$(bluer_ai_option_int "$options" create 0)
+    local do_create=$(bluer_ai_option_int "$options" create 1)
     local extension=$(bluer_ai_option "$options" extension jpg)
-    local volume=$(bluer_ai_option "$options" vol)
+    local volume=$(bluer_ai_option "$options" vol $BLUER_OBJECTS_DEFAULT_ASSETS_VOL)
 
     local path=$2
-    path=$abcli_path_git/assets$volume/$path
+    local full_path=$abcli_path_git/assets$volume/$path/
 
     if [[ "$do_create" == 1 ]]; then
-        mkdir -pv $path
+        mkdir -pv $full_path
         [[ $? -ne 0 ]] && return 1
     fi
 
-    bluer_ai_log "Downloads/.$extension -> assets$volume/path"
+    bluer_ai_log "Downloads/.$extension -> assets$volume/$path"
 
     mv -v \
         $HOME/Downloads/*.$extension \
-        $path
+        $full_path
     [[ $? -ne 0 ]] && return 1
 
     local push_options=$3

bluer_objects/.abcli/assets/publish.sh

@@ -4,7 +4,10 @@ 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_pull=1
+    [[ "$BLUER_AI_WEB_STATUS" != "online" ]] && do_pull=0
+    do_pull=$(bluer_ai_option_int "$options" pull $do_pull)
     local do_push=$(bluer_ai_option_int "$options" push 0)
     local extensions=$(bluer_ai_option "$options" extensions png)
 

bluer_objects/.abcli/mlflow/tags/search.sh

@@ -1,12 +1,8 @@
 #! /usr/bin/env bash
 
 function bluer_objects_mlflow_tags_search() {
-    local options=$1
-    local is_explicit=$(bluer_ai_option_int "$options" explicit 0)
-
     python3 -m bluer_objects.mlflow \
         search \
-        --explicit_query $is_explicit \
-        --tags "$options" \
+        --tags "$1" \
         "${@:2}"
 }

bluer_objects/.abcli/tests/help.sh

@@ -3,9 +3,6 @@
 function test_bluer_objects_help() {
     local options=$1
 
-    # legacy, not tested:
-    #  - @mysql
-
     local module
     for module in \
         "@assets" \
@@ -89,10 +86,6 @@ function test_bluer_objects_help() {
         \
         "@upload" \
         \
-        "@web" \
-        "@web is_accessible" \
-        "@web where_am_i" \
-        \
         "@wait" \
         \
         "bluer_objects"; do

bluer_objects/.abcli/tests/mlflow_tags.sh

@@ -24,6 +24,6 @@ function test_bluer_objects_mlflow_tags_search() {
     local options=$1
 
     bluer_objects_mlflow_tags search \
-        cloned.firms_area-template-v1=True \
+        this=that,what,~who \
         --log 0
 }

bluer_objects/.abcli/tests/pdf.sh

@@ -3,11 +3,15 @@
 function test_bluer_objects_pdf_convert_inline() {
     local options=$1
 
+    local do_install=1
+    [[ "$abcli_is_mac" == true ]] &&
+        do_install=0
+
     local object_name=test_bluer_objects_pdf_convert-$(bluer_ai_string_timestamp)
 
     bluer_ai_eval ,$options \
         bluer_objects_pdf_convert \
-        inline,install,combine,$2 \
+        inline,install=$do_install,combine,$2 \
         bluer_objects \
         aliases,aliases/assets.md \
         $object_name \
@@ -19,11 +23,15 @@ function test_bluer_objects_pdf_convert_inline() {
 function test_bluer_objects_pdf_convert() {
     local options=$1
 
+    local do_install=1
+    [[ "$abcli_is_mac" == true ]] &&
+        do_install=0
+
     local object_name=test_bluer_objects_pdf_convert-2025-11-30-ci0cd7
 
     bluer_ai_eval ,$options \
         bluer_objects_pdf_convert \
-        install,combine,$2 \
+        install=$do_install,combine,$2 \
         $object_name \
         "${@:3}"
 

bluer_objects/README/__init__.py

@@ -1,60 +1,30 @@
 import os
 
-from blueness import module
-
 from bluer_options.help.functions import get_help
-from bluer_objects import NAME as MY_NAME
+
+from bluer_objects import NAME, VERSION, REPO_NAME, ICON
 from bluer_objects import file
+from bluer_objects.README.build.docs import docs
 from bluer_objects.README.functions import build
 from bluer_objects.README.items import Items
 from bluer_objects.help.functions import help_functions
-from bluer_objects.logger import logger
-
-MY_NAME = module.name(__file__, MY_NAME)
 
 
 def build_me() -> bool:
-    from bluer_objects import NAME, VERSION, REPO_NAME, ICON
-
     return all(
         build(
-            path=os.path.join(file.path(__file__), path),
+            items=readme.get("items", []),
+            path=os.path.join(file.path(__file__), readme["path"]),
             ICON=ICON,
             NAME=NAME,
             VERSION=VERSION,
             REPO_NAME=REPO_NAME,
+            macros=readme.get("macros", {}),
             help_function=lambda tokens: get_help(
                 tokens,
                 help_functions,
                 mono=True,
             ),
         )
-        for path in [
-            "../docs/aliases",
-            "../docs",
-            "../..",
-            ".",
-        ]
-        + [
-            f"../docs/aliases/{alias}.md"
-            for alias in [
-                "assets",
-                "clone",
-                "download",
-                "file",
-                "gif",
-                "host",
-                "ls",
-                "metadata",
-                "mlflow",
-                "pdf",
-                "upload",
-            ]
-        ]
-        + [
-            f"../mlflow/{module_name}"
-            for module_name in [
-                "lock",
-            ]
-        ]
+        for readme in docs
     )

bluer_objects/README/alias.py

@@ -4,6 +4,8 @@ from pathlib import Path
 import os
 import re
 
+from bluer_ai import NAME as BLUER_AI_NAME
+
 from bluer_objects import file
 
 
@@ -18,7 +20,11 @@ def list_of_aliases(
 
     alias_sh_path = os.path.join(
         module_path,
-        ".abcli/alias.sh",
+        (
+            ".abcli/plugins/alias.sh"
+            if module_name == BLUER_AI_NAME
+            else ".abcli/alias.sh"
+        ),
     )
 
     output: List[str] = []
@@ -41,16 +47,21 @@ def list_of_aliases(
         m = re.fullmatch(r"alias\s+@([^=]+)=.+", s.strip())
         return m.group(1) if m else ""
 
+    list_of_aliases = [
+        alias_name
+        for alias_name in sorted([extract_alias_name(line) for line in content])
+        if alias_name not in ["", "."]
+    ]
+
     return [
         (
             (
                 f"- [@{alias_name}](./{alias_name}.md)"
                 if itemized
-                else f"[@{alias_name}](./bluer_agent/docs/aliases/{alias_name}.md) "
+                else f"[@{alias_name}](./{module_name}/docs/aliases/{alias_name}.md) "
             )
             if as_markdown
             else alias_name
         )
-        for alias_name in sorted([extract_alias_name(line) for line in content])
-        if alias_name
+        for alias_name in list_of_aliases
     ]

bluer_objects/README/build/aliases.py

@@ -0,0 +1,23 @@
+from bluer_objects import NAME
+from bluer_objects.README.alias import list_of_aliases
+
+
+docs = [
+    {
+        "path": "../docs/aliases",
+        "macros": {
+            "aliases:::": list_of_aliases(
+                NAME,
+                itemized=True,
+            ),
+        },
+    },
+] + [
+    {
+        "path": f"../docs/aliases/{alias_name}.md",
+    }
+    for alias_name in list_of_aliases(
+        NAME,
+        as_markdown=False,
+    )
+]

bluer_objects/README/build/docs.py

@@ -0,0 +1,23 @@
+from bluer_objects import NAME
+from bluer_objects.README.build import modules
+from bluer_objects.README.alias import list_of_aliases
+from bluer_objects.README.build import aliases
+
+docs = (
+    [
+        {
+            "path": ".",
+        },
+        {
+            "path": "../..",
+            "macros": {
+                "aliases:::": list_of_aliases(NAME),
+            },
+        },
+        {
+            "path": "../docs",
+        },
+    ]
+    + aliases.docs
+    + modules.docs
+)

bluer_objects/README/build/modules.py

@@ -0,0 +1,9 @@
+docs = [
+    {
+        "path": f"../mlflow/{module_name}",
+    }
+    for module_name in [
+        "lock",
+        "serverless",
+    ]
+]

bluer_objects/README/consts.py

@@ -4,20 +4,25 @@ from typing import Union
 from bluer_objects.env import abcli_path_git
 
 github_kamangir = "https://github.com/kamangir"
-designs_repo = f"{github_kamangir}/bluer-designs/"
+designs_repo = f"{github_kamangir}/bluer-designs"
 
 
 def designs_url(suffix: str) -> str:
-    return f"{designs_repo}/blob/main/{suffix}"
+    return "{}/blob/main{}".format(
+        designs_repo,
+        f"/{suffix}" if suffix else "",
+    )
 
 
 def assets_url(
     suffix: str = "",
     volume: Union[str, int] = "",
+    blob: bool = False,
 ) -> str:
-    return "{}/assets{}/raw/main{}".format(
+    return "{}/assets{}/{}/main{}".format(
         github_kamangir,
         str(volume),
+        "blob" if blob else "raw",
         f"/{suffix}" if suffix else "",
     )
 

bluer_objects/README/functions.py

@@ -3,25 +3,24 @@ import os
 import yaml
 
 from blueness import module
-
+from bluer_options import env
+from bluer_options.logger import shorten_text
 from bluer_objects import NAME as MY_NAME
-from bluer_objects.metadata import get_from_object
-from bluer_objects import file, env
+from bluer_objects import file
 from bluer_objects import markdown
-from bluer_objects.README.utils import (
-    apply_legacy,
-    process_assets,
-    process_details,
-    process_envs,
-    process_help,
-    process_include,
-    process_mermaid,
-    process_objects,
-    process_title,
-    process_variable,
-    signature,
-    variables,
-)
+from bluer_objects.metadata import get_from_object
+from bluer_objects.README.process.assets import process_assets
+from bluer_objects.README.process.details import process_details
+from bluer_objects.README.process.envs import process_envs
+from bluer_objects.README.process.help import process_help
+from bluer_objects.README.process.include import process_include
+from bluer_objects.README.process.legacy import apply_legacy
+from bluer_objects.README.process.mermaid import process_mermaid
+from bluer_objects.README.process.national_internet import process_national_internet
+from bluer_objects.README.process.objects import process_objects
+from bluer_objects.README.process.title import process_title
+from bluer_objects.README.process.variables import process_variable, variables
+from bluer_objects.README.process.signature import signature
 from bluer_objects.logger import logger
 
 MY_NAME = module.name(__file__, MY_NAME)
@@ -42,7 +41,8 @@ def build(
     help_function: Union[Callable[[List[str]], str], None] = None,
     legacy_mode: bool = True,
     assets_repo: str = "kamangir/assets",
-    download: bool = True,
+    download: bool = env.BLUER_AI_WEB_STATUS != "offline",
+    verbose: bool = False,
 ) -> bool:
     if path:
         if path.endswith(".md"):
@@ -56,7 +56,7 @@ def build(
         MODULE_NAME = REPO_NAME
 
     logger.info(
-        "{}.build: {}-{}: {}[{}]: {} -{}> {}".format(
+        "{}.build: {}-{}: {}[{}]: {} -{}{}> {}".format(
             MY_NAME,
             NAME,
             VERSION,
@@ -64,10 +64,15 @@ def build(
             MODULE_NAME,
             template_filename,
             "+legacy-" if legacy_mode else "",
+            "download-" if download else "",
             filename,
         )
     )
 
+    if verbose:
+        logger.info(f"filename: {filename}")
+        logger.info(f"items: {items}")
+
     table_of_items = markdown.generate_table(items, cols=cols) if cols > 0 else items
 
     success, template = file.load_text(template_filename)
@@ -107,7 +112,7 @@ def build(
                 download=download,
             )
 
-            logger.info(f"metadata[{object_name_and_key}] = {value}")
+            logger.info(shorten_text(f"metadata[{object_name_and_key}] = {value}"))
 
             if template_line.startswith("metadata:::"):
                 content += (
@@ -195,10 +200,33 @@ def build(
                 content_section = process_mermaid(template_line)
         else:
             for macro, macro_value in macros.items():
-                if macro in template_line:
-                    content_section = macro_value
+                if macro not in template_line:
+                    continue
+
+                if template_line.replace(macro, "").strip():
+                    # this and that macro::: is going to be ...
+                    content_section = [
+                        template_line.replace(
+                            macro,
+                            (
+                                " ".join(macro_value)
+                                if isinstance(macro_value, list)
+                                else macro_value
+                            ),
+                        )
+                    ]
+                else:
+                    # macro:::
+                    content_section = (
+                        macro_value if isinstance(macro_value, list) else [macro_value]
+                    )
                     break
 
         content += content_section
 
+    content = process_national_internet(
+        filename,
+        content,
+    )
+
     return file.save_text(filename, content)

bluer_objects/README/process/assets.py

@@ -0,0 +1,36 @@
+from bluer_objects import file
+
+
+def process_assets(
+    template_line: str,
+    assets_repo: str,
+) -> str:
+    prefix = f"https://github.com/{assets_repo}/blob/main"
+
+    if "assets:::" in template_line:
+        template_line = " ".join(
+            [
+                (
+                    (
+                        "![image]({}/{}?raw=true)".format(
+                            prefix,
+                            token.split(":::")[1].strip(),
+                        )
+                        if any(
+                            token.endswith(extension)
+                            for extension in ["png", "jpg", "jpeg", "gif"]
+                        )
+                        else "[{}]({}/{})".format(
+                            file.name_and_extension(token.split(":::")[1].strip()),
+                            prefix,
+                            token.split(":::")[1].strip(),
+                        )
+                    )
+                    if token.startswith("assets:::")
+                    else token
+                )
+                for token in template_line.split(" ")
+            ]
+        )
+
+    return template_line

bluer_objects/README/process/details.py

@@ -0,0 +1,20 @@
+from typing import List
+
+
+def process_details(template_line: str) -> List[str]:
+    suffix = template_line.split(":::", 1)[1]
+    if suffix:
+        content_section = [
+            "",
+            "<details>",
+            f"<summary>{suffix}</summary>",
+            "",
+        ]
+    else:
+        content_section = [
+            "",
+            "</details>",
+            "",
+        ]
+
+    return content_section

bluer_objects/README/process/envs.py

@@ -0,0 +1,23 @@
+from bluer_options.env import get_env
+
+from bluer_objects.logger import logger
+
+
+def process_envs(template_line: str) -> str:
+    while "env:::" in template_line:
+        env_name = template_line.split("env:::", 1)[1]
+        if " " in env_name:
+            env_name = env_name.split(" ", 1)[0]
+        else:
+            if ":::" in env_name:
+                env_name = env_name.split(":::", 1)[0]
+
+        env_value = get_env(env_name)
+
+        template_line = template_line.replace(
+            f"env:::{env_name}",
+            env_value,
+        )
+        logger.info(f"{env_name} -> {env_value}")
+
+    return template_line

bluer_objects/README/process/help.py

@@ -0,0 +1,27 @@
+from typing import List, Union, Callable, Tuple
+
+from bluer_objects.logger import logger
+
+
+def process_help(
+    template_line: str,
+    help_function: Union[Callable[[List[str]], str], None] = None,
+) -> Tuple[bool, List[str]]:
+    help_command = template_line.split("help:::")[1].strip()
+
+    tokens = help_command.strip().split(" ")[1:]
+
+    help_content = help_function(tokens)
+    if not help_content:
+        logger.error(f"help not found: {help_command}: {tokens}")
+        return False, []
+
+    logger.info(f"+= help: {help_command}")
+    print(help_content)
+    content_section = [
+        "```bash",
+        help_content,
+        "```",
+    ]
+
+    return True, content_section

bluer_objects/README/process/include.py

@@ -0,0 +1,40 @@
+from typing import List
+
+from bluer_objects import file
+from bluer_objects import NAME as MY_NAME
+from bluer_objects.logger import logger
+
+
+def process_include(
+    template_line: str,
+    template_path: str,
+) -> List[str]:
+    include_filename_relative = template_line.split(" ")[1].strip()
+    include_filename = file.absolute(
+        include_filename_relative,
+        template_path,
+    )
+
+    success, content_section = file.load_text(include_filename)
+    if not success:
+        return success
+
+    content_section = [
+        line for line in content_section if not line.startswith("used by:")
+    ]
+
+    include_title = (template_line.split(" ", 2) + ["", "", ""])[2]
+    if include_title:
+        content_section = [f"## {include_title}"] + content_section[1:]
+
+    if "include:::noref" not in template_line:
+        content_section += [
+            "using [{}]({}).".format(
+                file.name(include_filename),
+                include_filename_relative,
+            )
+        ]
+
+    logger.info(f"{MY_NAME}.build: including {include_filename} ...")
+
+    return content_section

bluer_objects/README/process/legacy.py

@@ -0,0 +1,21 @@
+from typing import List
+
+from bluer_objects.logger import logger
+
+
+def apply_legacy_on_line(line: str) -> str:
+    for before, after in {
+        "yaml:::": "metadata:::",
+        "--help--": "help:::",
+        "--include": "include:::",
+        "--table--": "items:::",
+        "--signature--": "signature:::",
+    }.items():
+        line = line.replace(before, after)
+    return line
+
+
+def apply_legacy(template: List[str]) -> List[str]:
+    logger.info("applying legacy conversions...")
+    template = [apply_legacy_on_line(line) for line in template]
+    return template