zrb 0.28.0__py3-none-any.whl → 1.0.0__py3-none-any.whl

zrb/builtin/devtool/install/tmux/tmux.py

@@ -1,45 +0,0 @@
-import os
-
-from zrb.builtin.devtool.install._group import devtool_install_group
-from zrb.builtin.devtool.install._helper import write_config
-from zrb.runner import runner
-from zrb.task.cmd_task import CmdTask
-from zrb.task.flow_task import FlowTask
-from zrb.task.task import Task
-from zrb.task_input.str_input import StrInput
-
-_CURRENT_DIR = os.path.dirname(__file__)
-_SHELL_SCRIPT_DIR = os.path.join(_CURRENT_DIR, "..", "..", "..", "..", "shell-scripts")
-
-install_tmux = FlowTask(
-    name="tmux",
-    group=devtool_install_group,
-    description="Terminal multiplexer",
-    inputs=[
-        StrInput(
-            name="tmux-config-file",
-            shortcut="c",
-            prompt="Tmux config file",
-            default="~/.tmux.conf",
-        )
-    ],
-    steps=[
-        CmdTask(
-            name="install-tmux",
-            cmd_path=[
-                os.path.join(_SHELL_SCRIPT_DIR, "_common-util.sh"),
-                os.path.join(_CURRENT_DIR, "install.sh"),
-            ],
-            preexec_fn=None,
-        ),
-        Task(
-            name="configure-tmux",
-            run=write_config(
-                template_file=os.path.join(_CURRENT_DIR, "resource", "config.sh"),
-                config_file="{{input.tmux_config_file}}",
-            ),
-        ),
-    ],
-    retry=0,
-)
-runner.register(install_tmux)

zrb/builtin/devtool/install/zsh/install.sh

@@ -1,65 +0,0 @@
-# Install Zsh
-if command_exists zsh
-then
-    log_info "zsh is already installed."
-else
-    log_info "Installing zsh..."
-    if [ "$OS_TYPE" = "Darwin" ]
-    then
-        if command_exists brew
-        then
-            brew install zsh
-        else
-            log_info "Homebrew not found. Please install Homebrew and try again."
-            exit 1
-        fi
-    elif [ "$OS_TYPE" = "Linux" ]
-    then
-        if command_exists pkg
-        then
-            try_sudo pkg update
-            try_sudo pkg install -y zsh
-        elif command_exists apt
-        then
-            try_sudo apt update
-            try_sudo apt install -y zsh
-        elif command_exists yum
-        then
-            try_sudo yum install -y zsh
-        elif command_exists dnf
-        then
-            try_sudo dnf install -y zsh
-        elif command_exists pacman
-        then
-            try_sudo pacman -Syu --noconfirm zsh
-        elif command_exists snap
-        then
-            try_sudo snap install zsh
-        else
-            log_info "No known package manager found. Please install zsh manually."
-            exit 1
-        fi
-    else
-        log_info "Unsupported OS type. Please install zsh manually."
-        exit 1
-    fi
-fi
-
-if command_exists chsh
-then
-    log_info "Changing default shell to zsh..."
-    chsh -s $(which zsh)
-else
-    log_info "chsh command not found. Please change the default shell manually."
-fi
-
-if [ -d "$HOME/.oh-my-zsh" ]
-then
-    log_info "oh-my-zsh is already installed"
-else
-    log_info "Installing oh-my-zsh"
-    sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended
-fi
-
-log_info "Installing zinit"
-bash -c "$(curl -fsSL https://git.io/zinit-install)"

zrb/builtin/devtool/install/zsh/resource/config.sh

@@ -1,147 +0,0 @@
-# If you come from bash you might have to change your $PATH.
-# export PATH=$HOME/bin:/usr/local/bin:$PATH
-
-# Path to your oh-my-zsh installation.
-export ZSH="$HOME/.oh-my-zsh"
-
-# Set name of the theme to load --- if set to "random", it will
-# load a random theme each time oh-my-zsh is loaded, in which case,
-# to know which specific one was loaded, run: echo $RANDOM_THEME
-# See https://github.com/ohmyzsh/ohmyzsh/wiki/Themes
-ZSH_THEME="candy"
-
-# Set list of themes to pick from when loading at random
-# Setting this variable when ZSH_THEME=random will cause zsh to load
-# a theme from this variable instead of looking in $ZSH/themes/
-# If set to an empty array, this variable will have no effect.
-# ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster" )
-
-# Uncomment the following line to use case-sensitive completion.
-# CASE_SENSITIVE="true"
-
-# Uncomment the following line to use hyphen-insensitive completion.
-# Case-sensitive completion must be off. _ and - will be interchangeable.
-# HYPHEN_INSENSITIVE="true"
-
-# Uncomment one of the following lines to change the auto-update behavior
-# zstyle ':omz:update' mode disabled  # disable automatic updates
-# zstyle ':omz:update' mode auto      # update automatically without asking
-# zstyle ':omz:update' mode reminder  # just remind me to update when it's time
-
-# Uncomment the following line to change how often to auto-update (in days).
-# zstyle ':omz:update' frequency 13
-
-# Uncomment the following line if pasting URLs and other text is messed up.
-# DISABLE_MAGIC_FUNCTIONS="true"
-
-# Uncomment the following line to disable colors in ls.
-# DISABLE_LS_COLORS="true"
-
-# Uncomment the following line to disable auto-setting terminal title.
-# DISABLE_AUTO_TITLE="true"
-
-# Uncomment the following line to enable command auto-correction.
-# ENABLE_CORRECTION="true"
-
-# Uncomment the following line to display red dots whilst waiting for completion.
-# You can also set it to another string to have that shown instead of the default red dots.
-# e.g. COMPLETION_WAITING_DOTS="%F{yellow}waiting...%f"
-# Caution: this setting can cause issues with multiline prompts in zsh < 5.7.1 (see #5765)
-# COMPLETION_WAITING_DOTS="true"
-
-# Uncomment the following line if you want to disable marking untracked files
-# under VCS as dirty. This makes repository status check for large repositories
-# much, much faster.
-# DISABLE_UNTRACKED_FILES_DIRTY="true"
-
-# Uncomment the following line if you want to change the command execution time
-# stamp shown in the history command output.
-# You can set one of the optional three formats:
-# "mm/dd/yyyy"|"dd.mm.yyyy"|"yyyy-mm-dd"
-# or set a custom format using the strftime function format specifications,
-# see 'man strftime' for details.
-# HIST_STAMPS="mm/dd/yyyy"
-
-# Would you like to use another custom folder than $ZSH/custom?
-# ZSH_CUSTOM=/path/to/new-custom-folder
-
-# Which plugins would you like to load?
-# Standard plugins can be found in $ZSH/plugins/
-# Custom plugins may be added to $ZSH_CUSTOM/plugins/
-# Example format: plugins=(rails git textmate ruby lighthouse)
-# Add wisely, as too many plugins slow down shell startup.
-plugins=(
-  git
-  kubectl
-)
-
-source $ZSH/oh-my-zsh.sh
-
-# User configuration
-
-# export MANPATH="/usr/local/man:$MANPATH"
-
-# You may need to manually set your language environment
-# export LANG=en_US.UTF-8
-
-# Preferred editor for local and remote sessions
-# if [[ -n $SSH_CONNECTION ]]; then
-#   export EDITOR='vim'
-# else
-#   export EDITOR='mvim'
-# fi
-
-# Compilation flags
-# export ARCHFLAGS="-arch x86_64"
-
-# Set personal aliases, overriding those provided by oh-my-zsh libs,
-# plugins, and themes. Aliases can be placed here, though oh-my-zsh
-# users are encouraged to define aliases within the ZSH_CUSTOM folder.
-# For a full list of active aliases, run `alias`.
-#
-# Example aliases
-# alias zshconfig="mate ~/.zshrc"
-# alias ohmyzsh="mate ~/.oh-my-zsh"
-
-source "$HOME/.local/share/zinit/zinit.git/zinit.zsh"
-autoload -Uz _zinit
-(( ${+_comps} )) && _comps[zinit]=_zinit
-
-# Load a few important annexes, without Turbo
-# (this is currently required for annexes)
-zinit light-mode for \
-    zdharma-continuum/zinit-annex-as-monitor \
-    zdharma-continuum/zinit-annex-bin-gem-node \
-    zdharma-continuum/zinit-annex-patch-dl \
-    zdharma-continuum/zinit-annex-rust
-### End of Zinit's installer chunk
-
-# Plugin history-search-multi-word loaded with investigating.
-zinit load zdharma-continuum/history-search-multi-word
-
-# Two regular plugins loaded without investigating.
-zinit light zsh-users/zsh-autosuggestions
-zinit light zdharma-continuum/fast-syntax-highlighting
-
-zinit light jonmosco/kube-ps1
-KUBE_PS1_SYMBOL_ENABLE=false
-KUBE_PS1_PREFIX=''
-KUBE_PS1_SUFFIX=' '
-KUBE_PS1_CTX_COLOR=cyan
-PROMPT='$(kube_ps1)'$PROMPT
-
-export COLORTERM=truecolor
-
-# Activate pyenv if exists
-if [ -d "${HOME}/.pyenv" ]
-then
-    export PYENV_ROOT="$HOME/.pyenv"
-    export PATH="$PYENV_ROOT/bin:$PATH"
-    eval "$(pyenv init --path)"
-fi
-
-# Activate local venv if exists
-if [ -f "${HOME}/.local-venv/bin/activate" ]
-then
-    source "${HOME}/.local-venv/bin/activate"
-fi

zrb/builtin/devtool/install/zsh/zsh.py

@@ -1,46 +0,0 @@
-import os
-
-from zrb.builtin.devtool.install._group import devtool_install_group
-from zrb.builtin.devtool.install._helper import write_config
-from zrb.runner import runner
-from zrb.task.cmd_task import CmdTask
-from zrb.task.flow_task import FlowTask
-from zrb.task.task import Task
-from zrb.task_input.str_input import StrInput
-
-_CURRENT_DIR = os.path.dirname(__file__)
-_SHELL_SCRIPT_DIR = os.path.join(_CURRENT_DIR, "..", "..", "..", "..", "shell-scripts")
-
-
-install_zsh = FlowTask(
-    name="zsh",
-    group=devtool_install_group,
-    description="Zsh terminal + oh-my-zsh + zdharma",
-    inputs=[
-        StrInput(
-            name="zsh-config-file",
-            shortcut="c",
-            prompt="Zsh config file",
-            default="~/.zshrc",
-        )
-    ],
-    steps=[
-        CmdTask(
-            name="install-zsh",
-            cmd_path=[
-                os.path.join(_SHELL_SCRIPT_DIR, "_common-util.sh"),
-                os.path.join(_CURRENT_DIR, "install.sh"),
-            ],
-            preexec_fn=None,
-        ),
-        Task(
-            name="configure-zsh",
-            run=write_config(
-                template_file=os.path.join(_CURRENT_DIR, "resource", "config.sh"),
-                config_file="{{input.zsh_config_file}}",
-            ),
-        ),
-    ],
-    retry=0,
-)
-runner.register(install_zsh)

zrb/builtin/docker/__init__.py

@@ -1,5 +0,0 @@
-from zrb.builtin.docker._group import docker_group
-from zrb.builtin.docker.prune import prune_docker
-
-assert docker_group
-assert prune_docker

zrb/builtin/docker/_group.py

@@ -1,3 +0,0 @@
-from zrb.task_group.group import Group
-
-docker_group = Group(name="docker", description="Docker related commands")

zrb/builtin/docker/prune.py

@@ -1,24 +0,0 @@
-from zrb.builtin.docker._group import docker_group
-from zrb.runner import runner
-from zrb.task.cmd_task import CmdTask
-from zrb.task_input.bool_input import BoolInput
-
-prune_docker = CmdTask(
-    name="prune",
-    group=docker_group,
-    description="Prune unused images and volumes",
-    inputs=[
-        BoolInput(
-            name="all", shortcut="a", prompt="Remove all unused images", default=False
-        ),
-        BoolInput(
-            name="volume", shortcut="v", prompt="Prune anonymous volume", default=False
-        ),
-    ],
-    cmd=[
-        "docker system prune -f {% if input.all %}-a{% endif %} {% if input.volume %}--volumes{% endif %}",  # noqa
-        "docker image prune -f {% if input.all %}-a{% endif %}",
-        "docker system df",
-    ],
-)
-runner.register(prune_docker)

zrb/builtin/env/__init__.py

@@ -1,5 +0,0 @@
-from zrb.builtin.env._group import env_group
-from zrb.builtin.env.get import get_env
-
-assert env_group
-assert get_env

zrb/builtin/env/_group.py

@@ -1,3 +0,0 @@
-from zrb.task_group.group import Group
-
-env_group = Group(name="env", description="Environment variable management")

zrb/builtin/env/get.py

@@ -1,27 +0,0 @@
-from typing import Any
-
-from zrb.builtin.env._group import env_group
-from zrb.helper.accessories.color import colored
-from zrb.runner import runner
-from zrb.task.decorator import python_task
-from zrb.task.task import Task
-
-
-@python_task(
-    name="get", group=env_group, description="Get environment values", runner=runner
-)
-async def get_env(*args: Any, **kwargs: Any):
-    task: Task = kwargs["_task"]
-    env_map = task.get_env_map()
-    names = list(env_map.keys())
-    names.sort()
-    colored_equal = colored("=", color="grey", attrs=["dark"])
-    env_lines: list[str] = []
-    for name in names:
-        value = env_map[name]
-        colored_name = colored(name, color="green", attrs=["bold"])
-        colored_value = colored(value, attrs=["bold"])
-        env_lines.append(f"{colored_name}{colored_equal}{colored_value}")
-    line_separator = "\n    "
-    task.print_out(line_separator + line_separator.join(env_lines))
-    return env_map

zrb/builtin/eval.py

@@ -1,24 +0,0 @@
-from typing import Any
-
-from zrb.runner import runner
-from zrb.task.decorator import python_task
-from zrb.task_input.str_input import StrInput
-
-
-@python_task(
-    name="eval",
-    inputs=[
-        StrInput(
-            name="expression",
-            shortcut="e",
-            default="",
-            description="Python expression",
-        )
-    ],
-    description="Evaluate Python expression",
-    retry=0,
-    runner=runner,
-)
-async def evaluate(*args: str, **kwargs: Any):
-    expression: str = kwargs.get("expression", "")
-    return eval(expression)

zrb/builtin/explain/__init__.py

@@ -1,5 +0,0 @@
-from zrb.builtin.explain._group import explain_group
-from zrb.builtin.explain.task import explain_tasks
-
-assert explain_group
-assert explain_tasks

zrb/builtin/explain/_group.py

@@ -1,3 +0,0 @@
-from zrb.task_group.group import Group
-
-explain_group = Group(name="explain", description="Explain things")

zrb/builtin/explain/explanation/dry.md

@@ -1,7 +0,0 @@
-- D: Don't
-- R: Repeat
-- Y: Yourself
-
-Don't repeat yourself (DRY) is a principle of software development aimed at reducing repetition of information which is likely to change, replacing it with abstractions that are less likely to change, or using data normalization which avoids redundancy in the first place.
-
-Every piece of knowledge must have a single, unambiguous, authoritative representation within a system". The principle has been formulated by Andy Hunt and Dave Thomas in their book The Pragmatic Programmer.

zrb/builtin/explain/explanation/kiss.md

@@ -1,6 +0,0 @@
-- K: Keep
-- I: It
-- S: Simple
-- S: Stupid
-
-Keep it simple, stupid!", is a design principle noted by the U.S. Navy in 1960. First seen partly in American English by at least 1938, the KISS principle states that most systems work best if they are kept simple rather than made complicated; therefore, simplicity should be a key goal in design, and unnecessary complexity should be avoided.

zrb/builtin/explain/explanation/solid.md

@@ -1,9 +0,0 @@
-- S: Single Responsibility Principle
-- O: Open/Closed Principle
-- L: Liskov’s Substitution Principle
-- I: Interface Segregation Principle
-- D: Dependency Inversion Principle
-
-In software development, Object-Oriented Design plays a crucial role when it comes to writing flexible, scalable, maintainable, and reusable code. There are so many benefits of using OOD but every developer should also have the knowledge of the SOLID principle for good object-oriented design in programming. The SOLID principle was introduced by Robert C. Martin, also known as Uncle Bob and it is a coding standard in programming.
-
-The SOLID principle helps in reducing tight coupling. Tight coupling means a group of classes are highly dependent on one another which you should avoid in your code. Opposite of tight coupling is loose coupling and your code is considered as a good code when it has loosely-coupled classes. Loosely coupled classes minimize changes in your code, helps in making code more reusable, maintainable, flexible and stable.

zrb/builtin/explain/explanation/yagni.md

@@ -1,9 +0,0 @@
-- Y: You
-- A: Aren't
-- G: Gonna
-- N: Need
-- I: It
-
-YAGNI principle ("You Aren't Gonna Need It") is a practice in software development which states that features should only be added when required.
-
-As a part of the extreme programming (XP) philosophy, YAGNI trims away excess and inefficiency in development to facilitate the desired increased frequency of releases.

zrb/builtin/explain/explanation/zen-of-python.md

@@ -1,37 +0,0 @@
-Beautiful is better than ugly.
-
-Explicit is better than implicit.
-
-Simple is better than complex.
-
-Complex is better than complicated.
-
-Flat is better than nested.
-
-Sparse is better than dense.
-
-Readability counts.
-
-Special cases aren't special enough to break the rules.
-
-Although practicality beats purity.
-
-Errors should never pass silently.
-
-Unless explicitly silenced.
-
-In the face of ambiguity, refuse the temptation to guess.
-
-There should be one-- and preferably only one --obvious way to do it.
-
-Although that way may not be obvious at first unless you're Dutch.
-
-Now is better than never.
-
-Although never is often better than right now.
-
-If the implementation is hard to explain, it's a bad idea.
-
-If the implementation is easy to explain, it may be a good idea.
-
-Namespaces are one honking great idea – let's do more of those!

zrb/builtin/explain/task.py

@@ -1,13 +0,0 @@
-import os
-
-from zrb.builtin.explain._group import explain_group
-from zrb.runner import runner
-from zrb.task.wiki_task import create_wiki_tasks
-
-CURRENT_DIRECTORY = os.path.dirname(__file__)
-
-explain_tasks = create_wiki_tasks(
-    directory=os.path.join(CURRENT_DIRECTORY, "explanation"),
-    group=explain_group,
-    runner=runner,
-)

zrb/builtin/git/__init__.py

@@ -1,7 +0,0 @@
-from zrb.builtin.git._group import git_group
-from zrb.builtin.git.clear_branch import clear_git_branch
-from zrb.builtin.git.get_file_changes import get_git_file_changes
-
-assert git_group
-assert clear_git_branch
-assert get_git_file_changes

zrb/builtin/git/_group.py

@@ -1,3 +0,0 @@
-from zrb.task_group.group import Group
-
-git_group = Group(name="git", description="Git related commands")

zrb/builtin/git/clear_branch.py

@@ -1,19 +0,0 @@
-from zrb.builtin.git._group import git_group
-from zrb.runner import runner
-from zrb.task.cmd_task import CmdTask
-
-clear_git_branch = CmdTask(
-    name="clear-branch",
-    group=git_group,
-    description="Clear branches",
-    cmd=[
-        "for BRANCH in $(git branch)",
-        "do",
-        '  if [ "$BRANCH" != "main" ] && [ "$BRANCH" != "*" ]',
-        "  then",
-        "    git branch -D $BRANCH",
-        "  fi",
-        "done",
-    ],
-)
-runner.register(clear_git_branch)

zrb/builtin/git/get_file_changes.py

@@ -1,69 +0,0 @@
-from typing import Any
-
-from zrb.builtin.git._group import git_group
-from zrb.helper.accessories.color import colored
-from zrb.helper.git.detect_changes import get_modified_file_states
-from zrb.helper.task import show_lines
-from zrb.runner import runner
-from zrb.task.decorator import python_task
-from zrb.task_input.bool_input import BoolInput
-from zrb.task_input.str_input import StrInput
-
-
-@python_task(
-    name="get-file-changes",
-    group=git_group,
-    description="Get modified files",
-    inputs=[
-        StrInput(
-            name="commit",
-            shortcut="c",
-            description="commit hash/tag",
-            prompt="Commit hash/Tag",
-            default="HEAD",
-        ),
-        BoolInput(
-            name="include-new",
-            description="include new files",
-            prompt="Include new files",
-            default=True,
-        ),
-        BoolInput(
-            name="include-removed",
-            description="include removed file",
-            prompt="Include removed file",
-            default=True,
-        ),
-        BoolInput(
-            name="include-updated",
-            description="include updated file",
-            prompt="Include updated file",
-            default=True,
-        ),
-    ],
-    runner=runner,
-)
-async def get_git_file_changes(*args: Any, **kwargs: Any):
-    commit = kwargs.get("commit", "HEAD")
-    include_new = kwargs.get("include_new", True)
-    include_removed = kwargs.get("include_removed", True)
-    include_updated = kwargs.get("include_updated", True)
-    modified_file_states = get_modified_file_states(commit)
-    modified_file_keys = []
-    output = []
-    for modified_file, state in modified_file_states.items():
-        if include_updated and state.minus and state.plus:
-            output.append(colored(f"+- {modified_file}", color="yellow"))
-            modified_file_keys.append(modified_file)
-            continue
-        if include_removed and state.minus and not state.plus:
-            output.append(colored(f"-- {modified_file}", color="red"))
-            modified_file_keys.append(modified_file)
-            continue
-        if include_new and state.plus and not state.minus:
-            output.append(colored(f"++ {modified_file}", color="green"))
-            modified_file_keys.append(modified_file)
-            continue
-    show_lines(kwargs["_task"], *output)
-    modified_file_keys.sort()
-    return "\n".join(modified_file_keys)

zrb/builtin/md5/__init__.py

@@ -1,7 +0,0 @@
-from zrb.builtin.md5._group import md5_group
-from zrb.builtin.md5.hash import hash_text_md5
-from zrb.builtin.md5.sum import sum_file_md5
-
-assert md5_group
-assert hash_text_md5
-assert sum_file_md5

zrb/builtin/md5/_group.py

@@ -1,3 +0,0 @@
-from zrb.task_group.group import Group
-
-md5_group = Group(name="md5", description="MD5 operations")

zrb/builtin/md5/hash.py

@@ -1,21 +0,0 @@
-import hashlib
-from typing import Any
-
-from zrb.builtin.md5._group import md5_group
-from zrb.runner import runner
-from zrb.task.decorator import python_task
-from zrb.task_input.str_input import StrInput
-
-
-@python_task(
-    name="hash",
-    group=md5_group,
-    inputs=[StrInput(name="text", shortcut="t", description="Text", default="")],
-    description="Hash md5",
-    retry=0,
-    runner=runner,
-)
-async def hash_text_md5(*args: str, **kwargs: Any):
-    text: str = kwargs.get("text", "")
-    hashed_text = hashlib.md5(text.encode()).hexdigest()
-    return hashed_text