bluer-objects 6.223.1__py3-none-any.whl → 6.231.1__py3-none-any.whl

bluer_objects/README/functions.py

@@ -3,12 +3,24 @@ import os
 import yaml
 
 from blueness import module
-from bluer_options.env import get_env
 
-from bluer_objects import NAME as MY_NAME, ICON as MY_ICON
+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 markdown
+from bluer_objects.README.utils import (
+    apply_legacy,
+    process_assets,
+    process_details,
+    process_envs,
+    process_help,
+    process_include,
+    process_mermaid,
+    process_objects,
+    process_variable,
+    signature,
+    variables,
+)
 from bluer_objects.logger import logger
 
 MY_NAME = module.name(__file__, MY_NAME)
@@ -56,156 +68,47 @@ def build(
 
     table_of_items = markdown.generate_table(items, cols=cols) if cols > 0 else items
 
-    signature = [
-        "",
-        " ".join(
-            [
-                f"[![pylint](https://github.com/kamangir/{REPO_NAME}/actions/workflows/pylint.yml/badge.svg)](https://github.com/kamangir/{REPO_NAME}/actions/workflows/pylint.yml)",
-                f"[![pytest](https://github.com/kamangir/{REPO_NAME}/actions/workflows/pytest.yml/badge.svg)](https://github.com/kamangir/{REPO_NAME}/actions/workflows/pytest.yml)",
-                f"[![bashtest](https://github.com/kamangir/{REPO_NAME}/actions/workflows/bashtest.yml/badge.svg)](https://github.com/kamangir/{REPO_NAME}/actions/workflows/bashtest.yml)",
-                f"[![PyPI version](https://img.shields.io/pypi/v/{MODULE_NAME}.svg)](https://pypi.org/project/{MODULE_NAME}/)",
-                f"[![PyPI - Downloads](https://img.shields.io/pypi/dd/{MODULE_NAME})](https://pypistats.org/packages/{MODULE_NAME})",
-            ]
-        ),
-        "",
-        "built by {} [`{}`]({}), based on {}[`{}-{}`]({}).".format(
-            MY_ICON,
-            "bluer README",
-            "https://github.com/kamangir/bluer-objects/tree/main/bluer_objects/README",
-            f"{ICON} " if ICON else "",
-            NAME,
-            VERSION,
-            f"https://github.com/kamangir/{REPO_NAME}",
-        ),
-    ]
-
     success, template = file.load_text(template_filename)
     if not success:
         return success
 
-    def apply_legacy(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
-
     if legacy_mode:
-        logger.info("applying legacy conversions...")
-        template = [apply_legacy(line) for line in template]
+        template = apply_legacy(template)
 
     content: List[str] = []
     mermaid_started: bool = False
-    variables: Dict[str, str] = {}
     for template_line in template:
         if template_line.startswith("ignore:::"):
-            content_section = [template_line.split(":::", 1)[1].strip()]
-        else:
-            while "env:::" in template_line:
-                env_name = template_line.split("env:::", 1)[1]
-                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}")
-
-            if template_line.startswith("set:::"):
-                key, value = template_line.split("set:::", 1)[1].split(" ", 1)
-                variables[key] = value
-                logger.info(f"{key} = {value}")
-                continue
-
-            for key, value in variables.items():
-                template_line = template_line.replace(
-                    f"get:::{key}",
-                    value,
-                )
-
-            if "assets:::" in template_line:
-                template_line = " ".join(
-                    [
-                        (
-                            (
-                                "![image](https://github.com/{}/blob/main/{}?raw=true)".format(
-                                    assets_repo,
-                                    token.split(":::")[1].strip(),
-                                )
-                                if any(
-                                    token.endswith(extension)
-                                    for extension in ["png", "jpg", "jpeg", "gif"]
-                                )
-                                else "[{}](https://github.com/{}/blob/main/{})".format(
-                                    file.name_and_extension(
-                                        token.split(":::")[1].strip()
-                                    ),
-                                    assets_repo,
-                                    token.split(":::")[1].strip(),
-                                )
-                            )
-                            if token.startswith("assets:::")
-                            else token
-                        )
-                        for token in template_line.split(" ")
-                    ]
-                )
-
-            if "object:::" in template_line:
-                template_line = " ".join(
-                    [
-                        (
-                            "[{}](https://{}.{}/{}.tar.gz)".format(
-                                token.split(":::")[1].strip(),
-                                env.S3_PUBLIC_STORAGE_BUCKET,
-                                env.S3_STORAGE_ENDPOINT_URL.split("https://", 1)[1],
-                                token.split(":::")[1].strip(),
-                            )
-                            if token.startswith("object:::")
-                            else token
-                        )
-                        for token in template_line.split(" ")
-                    ]
-                )
-
-            content_section: List[str] = [template_line]
-
-            if template_line.startswith("details:::"):
-                suffix = template_line.split(":::", 1)[1]
-                if suffix:
-                    content_section = [
-                        "",
-                        "<details>",
-                        f"<summary>{suffix}</summary>",
-                        "",
-                    ]
-                else:
-                    content_section = [
-                        "",
-                        "</details>",
-                        "",
-                    ]
-            elif template_line.startswith("metadata:::"):
-                object_name_and_key = template_line.split(":::", 1)[1]
-                if ":::" not in object_name_and_key:
-                    object_name_and_key += ":::"
-                object_name, key = object_name_and_key.split(":::", 1)
-
-                value = get_from_object(
-                    object_name,
-                    key,
-                    {},
-                    download=True,
-                )
-
-                content_section = (
+            content += [template_line.split(":::", 1)[1].strip()]
+            continue
+
+        template_line = process_envs(template_line)
+
+        for key, value in variables.items():
+            template_line = template_line.replace(
+                f"get:::{key}",
+                value,
+            )
+
+        if "metadata:::" in template_line:
+            object_name_and_key = template_line.split("metadata:::", 1)[1]
+            if " " in object_name_and_key:
+                object_name_and_key = object_name_and_key.split(" ", 1)[0]
+            if ":::" not in object_name_and_key:
+                object_name_and_key += ":::"
+            object_name, key = object_name_and_key.split(":::", 1)
+
+            value = get_from_object(
+                object_name,
+                key,
+                {},
+                download=True,
+            )
+
+            logger.info(f"metadata[{object_name_and_key}] = {value}")
+
+            if template_line.startswith("metadata:::"):
+                content += (
                     ["```yaml"]
                     + yaml.dump(
                         value,
@@ -213,84 +116,70 @@ def build(
                     ).split("\n")
                     + ["```"]
                 )
-            elif template_line.startswith("```mermaid"):
-                mermaid_started = True
-                logger.info("🧜🏽‍♀️  detected ...")
-            elif mermaid_started and template_line.startswith("```"):
-                mermaid_started = False
-            elif mermaid_started:
-                if '"' in template_line and ":::folder" not in template_line:
-                    template_line_pieces = template_line.split('"')
-                    if len(template_line_pieces) != 3:
-                        logger.error(
-                            f"🧜🏽‍♀️  mermaid line not in expected format: {template_line}."
-                        )
-                        return False
-
-                    template_line_pieces[1] = (
-                        template_line_pieces[1]
-                        .replace("<", "&lt;")
-                        .replace(">", "&gt;")
-                        .replace(" ", "<br>")
-                        .replace("~~", " ")
-                    )
-
-                    content_section = ['"'.join(template_line_pieces)]
-            elif "items:::" in template_line:
-                content_section = table_of_items
-            elif "signature:::" in template_line:
-                content_section = signature
-            elif "include:::" in template_line:
-                include_filename_relative = template_line.split(" ")[1].strip()
-                include_filename = file.absolute(
-                    include_filename_relative,
-                    file.path(template_filename),
-                )
-
-                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} ...")
-            elif "help:::" in template_line:
-                if help_function is not None:
-                    help_command = template_line.split("help:::")[1].strip()
-
-                    tokens = help_command.strip().split(" ")[1:]
-
-                    help_content = help_function(tokens)
-                    if not help_content:
-                        logger.warning(f"help not found: {help_command}: {tokens}")
-                        return False
+                continue
 
-                    logger.info(f"+= help: {help_command}")
-                    print(help_content)
-                    content_section = [
-                        "```bash",
-                        help_content,
-                        "```",
-                    ]
+            template_line = template_line.replace(
+                f"metadata:::{object_name}:::{key}",
+                str(value),
+            )
+
+        if template_line.startswith("set:::"):
+            process_variable(template_line)
+            continue
+
+        template_line = process_assets(template_line, assets_repo)
+
+        template_line = process_objects(template_line)
+
+        if template_line.startswith("details:::"):
+            content += process_details(template_line)
+            continue
+
+        if "items:::" in template_line:
+            content += table_of_items
+            continue
+
+        if "include:::" in template_line:
+            content += process_include(
+                template_line,
+                file.path(template_filename),
+            )
+            continue
+
+        if "signature:::" in template_line:
+            content += signature(
+                REPO_NAME,
+                NAME,
+                ICON,
+                MODULE_NAME,
+                VERSION,
+            )
+            continue
+
+        if "help:::" in template_line:
+            if help_function is None:
+                logger.warning("help_function not found.")
             else:
-                for macro, macro_value in macros.items():
-                    if macro in template_line:
-                        content_section = macro_value
-                        break
+                content += process_help(
+                    template_line,
+                    help_function,
+                )
+            continue
+
+        content_section = [template_line]
+        if template_line.startswith("```mermaid"):
+            mermaid_started = True
+            logger.info("🧜🏽‍♀️  detected ...")
+        elif mermaid_started and template_line.startswith("```"):
+            mermaid_started = False
+        elif mermaid_started:
+            if '"' in template_line and ":::folder" not in template_line:
+                content_section = process_mermaid(template_line)
+        else:
+            for macro, macro_value in macros.items():
+                if macro in template_line:
+                    content_section = macro_value
+                    break
 
         content += content_section
 

bluer_objects/README/utils.py

@@ -0,0 +1,235 @@
+from typing import List, Tuple, Dict, Union, Callable
+
+from bluer_options.env import get_env
+from bluer_objects import file
+from bluer_objects import env
+from bluer_objects import NAME as MY_NAME, ICON as MY_ICON
+
+from bluer_objects.logger import logger
+
+
+variables: Dict[str, str] = {}
+
+
+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
+
+
+def process_assets(
+    template_line: str,
+    assets_repo: str,
+) -> str:
+    if "assets:::" in template_line:
+        template_line = " ".join(
+            [
+                (
+                    (
+                        "![image](https://github.com/{}/blob/main/{}?raw=true)".format(
+                            assets_repo,
+                            token.split(":::")[1].strip(),
+                        )
+                        if any(
+                            token.endswith(extension)
+                            for extension in ["png", "jpg", "jpeg", "gif"]
+                        )
+                        else "[{}](https://github.com/{}/blob/main/{})".format(
+                            file.name_and_extension(token.split(":::")[1].strip()),
+                            assets_repo,
+                            token.split(":::")[1].strip(),
+                        )
+                    )
+                    if token.startswith("assets:::")
+                    else token
+                )
+                for token in template_line.split(" ")
+            ]
+        )
+
+    return template_line
+
+
+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
+
+
+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
+
+
+def process_help(
+    template_line: str,
+    help_function: Union[Callable[[List[str]], str], None] = None,
+) -> 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.warning(f"help not found: {help_command}: {tokens}")
+        return False
+
+    logger.info(f"+= help: {help_command}")
+    print(help_content)
+    content_section = [
+        "```bash",
+        help_content,
+        "```",
+    ]
+
+    return content_section
+
+
+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
+
+
+def process_mermaid(template_line: str) -> List[str]:
+    template_line_pieces = template_line.split('"')
+    if len(template_line_pieces) != 3:
+        logger.error(f"🧜🏽‍♀️  mermaid line not in expected format: {template_line}.")
+        return False
+
+    template_line_pieces[1] = (
+        template_line_pieces[1]
+        .replace("<", "&lt;")
+        .replace(">", "&gt;")
+        .replace(" ", "<br>")
+        .replace("~~", " ")
+    )
+
+    return ['"'.join(template_line_pieces)]
+
+
+def process_objects(template_line: str) -> str:
+    if "object:::" in template_line:
+        template_line = " ".join(
+            [
+                (
+                    "[{}](https://{}.{}/{}.tar.gz)".format(
+                        token.split(":::")[1].strip(),
+                        env.S3_PUBLIC_STORAGE_BUCKET,
+                        env.S3_STORAGE_ENDPOINT_URL.split("https://", 1)[1],
+                        token.split(":::")[1].strip(),
+                    )
+                    if token.startswith("object:::")
+                    else token
+                )
+                for token in template_line.split(" ")
+            ]
+        )
+
+    return template_line
+
+
+def process_variable(template_line: str):
+    key, value = template_line.split("set:::", 1)[1].split(" ", 1)
+    variables[key] = value
+    logger.info(f"{key} = {value}")
+
+
+def signature(
+    REPO_NAME: str,
+    NAME: str,
+    ICON: str,
+    MODULE_NAME: str,
+    VERSION: str,
+) -> List[str]:
+    return [
+        "",
+        " ".join(
+            [
+                f"[![pylint](https://github.com/kamangir/{REPO_NAME}/actions/workflows/pylint.yml/badge.svg)](https://github.com/kamangir/{REPO_NAME}/actions/workflows/pylint.yml)",
+                f"[![pytest](https://github.com/kamangir/{REPO_NAME}/actions/workflows/pytest.yml/badge.svg)](https://github.com/kamangir/{REPO_NAME}/actions/workflows/pytest.yml)",
+                f"[![bashtest](https://github.com/kamangir/{REPO_NAME}/actions/workflows/bashtest.yml/badge.svg)](https://github.com/kamangir/{REPO_NAME}/actions/workflows/bashtest.yml)",
+                f"[![PyPI version](https://img.shields.io/pypi/v/{MODULE_NAME}.svg)](https://pypi.org/project/{MODULE_NAME}/)",
+                f"[![PyPI - Downloads](https://img.shields.io/pypi/dd/{MODULE_NAME})](https://pypistats.org/packages/{MODULE_NAME})",
+            ]
+        ),
+        "",
+        "built by {} [`{}`]({}), based on {}[`{}-{}`]({}).".format(
+            MY_ICON,
+            "bluer README",
+            "https://github.com/kamangir/bluer-objects/tree/main/bluer_objects/README",
+            f"{ICON} " if ICON else "",
+            NAME,
+            VERSION,
+            f"https://github.com/kamangir/{REPO_NAME}",
+        ),
+    ]

bluer_objects/__init__.py

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

bluer_objects/storage/WebDAV.py

@@ -4,6 +4,7 @@ from webdav3.client import Client
 from bluer_objects.storage.base import StorageInterface
 from bluer_objects import env, file, path
 from bluer_objects import objects
+from bluer_objects.storage.policies import DownloadPolicy
 from bluer_objects.logger import logger
 
 
@@ -56,6 +57,7 @@ class WebDAVInterface(StorageInterface):
         object_name: str,
         filename: str = "",
         log: bool = True,
+        policy: DownloadPolicy = DownloadPolicy.NONE,
     ) -> bool:
         local_path = objects.path_of(
             object_name=object_name,
@@ -80,6 +82,7 @@ class WebDAVInterface(StorageInterface):
             object_name=object_name,
             filename=filename,
             log=log,
+            policy=policy,
         )
 
     def upload(

bluer_objects/storage/WebDAVrequest.py

@@ -8,6 +8,7 @@ from tqdm import tqdm
 from bluer_objects.storage.base import StorageInterface
 from bluer_objects import env, file, path
 from bluer_objects import objects
+from bluer_objects.storage.policies import DownloadPolicy
 from bluer_objects.logger import logger
 
 
@@ -136,6 +137,7 @@ class WebDAVRequestInterface(StorageInterface):
         object_name: str,
         filename: str = "",
         log: bool = True,
+        policy: DownloadPolicy = DownloadPolicy.NONE,
     ) -> bool:
         if filename:
             local_path = objects.path_of(
@@ -176,6 +178,7 @@ class WebDAVRequestInterface(StorageInterface):
                     object_name=object_name,
                     filename=filename,
                     log=log,
+                    policy=policy,
                 )
 
             logger.error(f"failed to download: {response.status_code}")
@@ -193,6 +196,7 @@ class WebDAVRequestInterface(StorageInterface):
                 object_name=object_name,
                 filename=filename_,
                 log=log,
+                policy=policy,
             ):
                 return False
 

bluer_objects/storage/WebDAVzip.py

@@ -5,9 +5,10 @@ from webdav3.client import Client
 from tqdm import tqdm
 
 from bluer_objects.storage.base import StorageInterface
-from bluer_objects import env, file, path
+from bluer_objects import env
 from bluer_objects import objects
-from bluer_objects.host import zip, unzip
+from bluer_objects.host import unzip
+from bluer_objects.storage.policies import DownloadPolicy
 from bluer_objects.logger import logger
 
 
@@ -65,6 +66,7 @@ class WebDAVzipInterface(StorageInterface):
         object_name: str,
         filename: str = "",
         log: bool = True,
+        policy: DownloadPolicy = DownloadPolicy.NONE,
     ) -> bool:
         object_path = objects.object_path(
             object_name=object_name,
@@ -99,6 +101,7 @@ class WebDAVzipInterface(StorageInterface):
         return super().download(
             object_name=object_name,
             log=log,
+            policy=policy,
         )
 
     def ls(

bluer_objects/storage/__init__.py

@@ -5,6 +5,7 @@ from bluer_objects.storage.base import StorageInterface
 from bluer_objects.storage.WebDAV import WebDAVInterface
 from bluer_objects.storage.WebDAVrequest import WebDAVRequestInterface
 from bluer_objects.storage.WebDAVzip import WebDAVzipInterface
+from bluer_objects.storage.policies import DownloadPolicy
 from bluer_objects import env
 from bluer_objects.logger import logger
 
@@ -35,11 +36,13 @@ def download(
     object_name: str,
     filename: str = "",
     log: bool = True,
+    policy: DownloadPolicy = DownloadPolicy.NONE,
 ) -> bool:
     return interface.download(
         object_name=object_name,
         filename=filename,
         log=log,
+        policy=policy,
     )
 
 

bluer_objects/storage/base.py

@@ -3,6 +3,7 @@ import glob
 from typing import Tuple, List
 
 from bluer_objects import objects
+from bluer_objects.storage.policies import DownloadPolicy
 from bluer_objects.logger import logger
 
 
@@ -18,13 +19,19 @@ class StorageInterface:
         object_name: str,
         filename: str = "",
         log: bool = True,
+        policy: DownloadPolicy = DownloadPolicy.NONE,
     ) -> bool:
         if log:
             logger.info(
-                "{}.download {}{}".format(
+                "{}.download {}{}{}".format(
                     self.__class__.__name__,
                     object_name,
                     f"/{filename}" if filename else "",
+                    (
+                        ""
+                        if policy == DownloadPolicy.NONE
+                        else " - policy:{}".format(policy.name.lower())
+                    ),
                 )
             )
 

bluer_objects/storage/policies.py

@@ -0,0 +1,7 @@
+from enum import Enum, auto
+
+
+class DownloadPolicy(Enum):
+    NONE = auto()
+    DOESNT_EXIST = auto()
+    DIFFERENT = auto()

bluer_objects/storage/s3.py

@@ -11,6 +11,7 @@ from bluer_objects.storage.base import StorageInterface
 from bluer_objects.env import ABCLI_OBJECT_ROOT
 from bluer_objects import env, file, path
 from bluer_objects import objects
+from bluer_objects.storage.policies import DownloadPolicy
 from bluer_objects.logger import logger
 
 
@@ -121,6 +122,7 @@ class S3Interface(StorageInterface):
         object_name: str,
         filename: str = "",
         log: bool = True,
+        policy: DownloadPolicy = DownloadPolicy.NONE,
     ) -> bool:
         if filename:
             local_path = objects.path_of(
@@ -129,6 +131,11 @@ class S3Interface(StorageInterface):
                 create=True,
             )
 
+            if policy == DownloadPolicy.DOESNT_EXIST and file.exists(local_path):
+                if log:
+                    logger.info(f"✅ {filename}")
+                return True
+
             if not path.create(file.path(local_path)):
                 return False
 
@@ -160,6 +167,7 @@ class S3Interface(StorageInterface):
                 object_name=object_name,
                 filename=filename,
                 log=log,
+                policy=policy,
             )
 
         success, list_of_files = self.ls(
@@ -174,6 +182,7 @@ class S3Interface(StorageInterface):
                 object_name=object_name,
                 filename=filename_,
                 log=log,
+                policy=policy,
             ):
                 return False
 

{bluer_objects-6.223.1.dist-info → bluer_objects-6.231.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.223.1
+Version: 6.231.1
 Summary: 🌀 Object management in Bash.
 Home-page: https://github.com/kamangir/bluer-objects
 Author: Arash Abadpour (Kamangir)
@@ -64,6 +64,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.223.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.231.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.118.1`](https://github.com/kamangir/blueness).

{bluer_objects-6.223.1.dist-info → bluer_objects-6.231.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-bluer_objects/__init__.py,sha256=j4vKuCujvGTVb99MrpgT1HkCW_o0gIPtZNPXDSptg0I,315
+bluer_objects/__init__.py,sha256=ObgK0QNoNgfJkVpVSqCPbWvtul6Np2g-HnsCFjqIArY,315
 bluer_objects/__main__.py,sha256=Yqfov833_hJuRne19WrGhT5DWAPtdffpoMxeSXS7EGw,359
 bluer_objects/config.env,sha256=RjcpnbKfRqNyGLRB4z7M_OG9z2pOM032ck__53JqXqo,216
 bluer_objects/env.py,sha256=iw4QvaImqnavlsHwfkUScNHc7afDEJQKJSsHTtVJE78,2019
@@ -72,8 +72,9 @@ bluer_objects/.abcli/tests/web_where_am_ai.sh,sha256=BJ9G_m4id8cx_UB_l_jV2xY6AfQ
 bluer_objects/.abcli/web/is_accessible.sh,sha256=Luv_6IvpscRYx7f39V0RnkkNEWTRfVGyQVUeij3iqa0,262
 bluer_objects/.abcli/web/where_am_i.sh,sha256=QPBXFo6Ni4pZEoOx0rtuJUxk6tOlp0ESMyAc9YPy9zg,92
 bluer_objects/README/__init__.py,sha256=JwxdTVAK3LeUaw7rMJujOFIXZA59HaLCtxpsR1C-vpo,1311
-bluer_objects/README/functions.py,sha256=69aXmAVRN-WxUGfQf9x1LJj7eMTSW1LiOWk3XuwtyEA,11364
+bluer_objects/README/functions.py,sha256=JPr7kkBTwC8xbZptxDSUeey8PoHYCfssu3wuaff_S2k,5390
 bluer_objects/README/items.py,sha256=rTiOVd9fCoKUbFofBWjRV6oNDaH3XXdpL0XIPZqpy_w,951
+bluer_objects/README/utils.py,sha256=oZysOe-184SXz0yX_C8M_roTJ4wC8VRdyLpAezM0qb4,7139
 bluer_objects/file/__init__.py,sha256=c_79ipBkKl6OFDimOev0vnaVdpUk-Bl3oJUapOreMXc,681
 bluer_objects/file/__main__.py,sha256=v2IXWvZeh_B2sGYWzv1CiUY-7HWHXXghZM5M4IPjbu4,1277
 bluer_objects/file/classes.py,sha256=TRgeRP2yxInPkBnywhuB4BsoBcBRA3UmQzX1dI43UxU,872
@@ -126,13 +127,14 @@ bluer_objects/mlflow/testing.py,sha256=cJH5Ki02fJN_Xos1j9yvwQChXvMkOa9i12vtDKmkb
 bluer_objects/mlflow/lock/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 bluer_objects/mlflow/lock/__main__.py,sha256=xF_xq2UqAsEohSOHjxaFXaw9KopOEDg6LRDM5a4VAPQ,1138
 bluer_objects/mlflow/lock/functions.py,sha256=MOslqblNAOsRvILzLF4q6m2EAwCk4f4zEWQpsy8lVnM,3045
-bluer_objects/storage/WebDAV.py,sha256=s0KI5JIfvYcRfrroxsZdEjfnxX_8CiPC-fQ3f0Lrkjw,3140
-bluer_objects/storage/WebDAVrequest.py,sha256=H9GIVPQPjP1j-URZrxJ15Jxnf8qPgQx-dShaxaeAj1U,10101
-bluer_objects/storage/WebDAVzip.py,sha256=vfjk-7HF5EpQ9ad-ZGfPR_qOK57RQzAPXlWc3tIsq8A,4090
-bluer_objects/storage/__init__.py,sha256=CFo0m1ftBGFKBdUAy4FAilJCpXwKvVdXCrBMkmeTW1E,1735
+bluer_objects/storage/WebDAV.py,sha256=UftrpSDzJAtTeMEORNpOTbDhmRYAzgdTNbmrAkgzPTU,3279
+bluer_objects/storage/WebDAVrequest.py,sha256=Wp4rtlWif7sdu4VohxenT8YVmf-tmV9gbBYxuKFDR8M,10279
+bluer_objects/storage/WebDAVzip.py,sha256=EHbERaxnLUQqWSM12dwJYybvXCIqqo66uThvNBE8BHI,4212
+bluer_objects/storage/__init__.py,sha256=LY3pxxflaZ0KUSJJzlh0GEFH-HpshBntn5qs62uk0WQ,1866
 bluer_objects/storage/__main__.py,sha256=6T4gltrJ-3lihce2fm43UeWB1y09VInXHrVBnAAa_R4,2005
-bluer_objects/storage/base.py,sha256=CPMBGi7koKnEBVLJOeIq9T05xxfKFRg-BHjyWidlCKw,2081
-bluer_objects/storage/s3.py,sha256=kSvm68POErGaqSWZ0ds8zB0Fd5q4WJUZ95kQZSp3n7w,9395
+bluer_objects/storage/base.py,sha256=35G51iTsU99N_JQwUS2oatbACudAsiOrQ0E6fIz2cic,2396
+bluer_objects/storage/policies.py,sha256=xIuIhFjcWH7ptg_jUgfYTNnXqs9xaX4yU5qSOhmmxhI,125
+bluer_objects/storage/s3.py,sha256=30i9bqj5gGZQZ9YRAqcF5piThlFilsmYqI0eFXnJ3M8,9755
 bluer_objects/testing/__init__.py,sha256=DWY5ZtvCnHG_t9BDiqy_ArLOZi-nlyAtPVMLA1PPAMU,62
 bluer_objects/testing/__main__.py,sha256=hhJV9qn0V_8FxzNDcoHCHr4A7zf9UudnNGJCAPkTBGU,750
 bluer_objects/testing/functions.py,sha256=AXAfzWLcEPkbSYTehdahshjKJ45C4IJkRs_TgrHOntc,1355
@@ -169,8 +171,8 @@ bluer_objects/tests/test_web_is_accessible.py,sha256=2Y20NAEDMblg0MKnhnqcfw3XVKE
 bluer_objects/web/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 bluer_objects/web/__main__.py,sha256=xf2Ob54FI8JEokfGhFmiyOBdD9nBactwqmZvsKsdioU,624
 bluer_objects/web/functions.py,sha256=KNufAFOc6N3BYf83lN2rUpKUdsnzb2anWyp9koFRVUo,172
-bluer_objects-6.223.1.dist-info/licenses/LICENSE,sha256=ogEPNDSH0_dhiv_lT3ifVIdgIzHAqNA_SemnxUfPBJk,7048
-bluer_objects-6.223.1.dist-info/METADATA,sha256=tn5jTlzK9gEDio47tYMkSicLqxh6eCYAS9SuF3OeHGI,3678
-bluer_objects-6.223.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-bluer_objects-6.223.1.dist-info/top_level.txt,sha256=RX2TpddbnRkurda3G_pAdyeTztP2IhhRPx949GlEvQo,14
-bluer_objects-6.223.1.dist-info/RECORD,,
+bluer_objects-6.231.1.dist-info/licenses/LICENSE,sha256=ogEPNDSH0_dhiv_lT3ifVIdgIzHAqNA_SemnxUfPBJk,7048
+bluer_objects-6.231.1.dist-info/METADATA,sha256=K9N197qOMIX9IXRIdgkJFkIjDATJBrqB_ex64KFfiJ4,3678
+bluer_objects-6.231.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+bluer_objects-6.231.1.dist-info/top_level.txt,sha256=RX2TpddbnRkurda3G_pAdyeTztP2IhhRPx949GlEvQo,14
+bluer_objects-6.231.1.dist-info/RECORD,,