bluer-objects 6.309.1__tar.gz → 6.322.1__tar.gz

{bluer_objects-6.309.1/bluer_objects.egg-info → bluer_objects-6.322.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.309.1
+Version: 6.322.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.309.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.322.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.118.1`](https://github.com/kamangir/blueness).

{bluer_objects-6.309.1 → bluer_objects-6.322.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.309.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.322.1`](https://github.com/kamangir/bluer-objects).

bluer_objects-6.322.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.322.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.309.1 → bluer_objects-6.322.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.309.1 → bluer_objects-6.322.1}/bluer_objects/README/__init__.py

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

{bluer_objects-6.309.1 → bluer_objects-6.322.1}/bluer_objects/__init__.py

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

bluer_objects-6.322.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.309.1 → bluer_objects-6.322.1}/bluer_objects/file/save.py

@@ -1,4 +1,4 @@
-from typing import Any, Dict, List
+from typing import Any, Dict, List, Union
 import yaml
 import numpy as np
 import json
@@ -30,9 +30,15 @@ def finish_saving(
     success: bool,
     message: str,
     log: bool = True,
+    exception: Union[Exception, None] = None,
 ) -> bool:
     if not success:
-        crash_report(f"{message}: failed.")
+        crash_report(
+            "{}: failed: {}".format(
+                message,
+                exception,
+            )
+        )
     elif log:
         logger.info(message)
 
@@ -246,12 +252,14 @@ def save_yaml(
     if not prepare_for_saving(filename):
         return False
 
+    exception = None
     success = True
     try:
         with open(filename, "w") as f:
             yaml.dump(data, f)
-    except:
+    except Exception as e:
         success = False
+        exception = e
 
     return finish_saving(
         success,
@@ -261,4 +269,5 @@ def save_yaml(
             filename,
         ),
         log,
+        exception,
     )

bluer_objects-6.322.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.309.1 → bluer_objects-6.322.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.309.1 → bluer_objects-6.322.1/bluer_objects.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.309.1
+Version: 6.322.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.309.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.322.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.118.1`](https://github.com/kamangir/blueness).

{bluer_objects-6.309.1 → bluer_objects-6.322.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

bluer_objects-6.309.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.309.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)