feat ✨ (helpers): implement snapshot helper (#51)

Signed-off-by: Luis Mayta <[email protected]>

Author: luismayta

.ci/linters/.codespell-ignores

@@ -2,3 +2,4 @@ cas
 wit
 NotIn
 notin
+fo

.pre-commit-config.yaml

@@ -92,6 +92,7 @@ repos:
         exclude: >
           (?x)^(
             zsh-core.plugin.zsh$|
+            pkg/helper/core.zsh$|
             .+\.provision/git/hooks/prepare-commit-msg$|
             .+\.tpl.sh$|
           )$
@@ -104,4 +105,4 @@ repos:
           - --verbose
       - id: hadolint
         args:
-          - --config=.ci/linters/.hadolint.yaml
+          - --config=.ci/linters/.hadolint.yaml

config/base.zsh

@@ -6,6 +6,7 @@ export CORE_MESSAGE_YAY="Please install Yay or use antibody bundle hadenlabs/zsh
 export CORE_MESSAGE_RVM="Please install rvm or use antibody bundle hadenlabs/zsh-rvm"
 export CORE_MESSAGE_RUST="Please install rust or use antibody bundle hadenlabs/zsh-rust"
 export CORE_MESSAGE_NVM="Please install nvm or use antibody bundle hadenlabs/zsh-nvm"
+export CORE_PROJECTS_BACKUP_PATH="${HOME}/backup"
 
 export ANDROID_HOME="${HOME}/Library/Android/sdk"
 export ANDROID_PLATFORM_VERSION="35"

internal/backup.zsh

@@ -0,0 +1,37 @@
+#!/usr/bin/env ksh
+# -*- coding: utf-8 -*-
+
+function core::internal::backup::snapshot {
+  if [[ -z "$CORE_PROJECTS_BACKUP_PATH" ]]; then
+    core::internal::message::error "❌ CORE_PROJECTS_BACKUP_PATH is not set"
+    return 1
+  fi
+
+  local module_path
+  module_path="$(core::internal::git::get_module_path)"
+
+  local branch="no-git"
+  if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+    branch="$(git rev-parse --abbrev-ref HEAD | tr '/' '-')"
+  fi
+
+  local dest="${CORE_PROJECTS_BACKUP_PATH}/${module_path}/${branch}"
+
+  core::internal::message::info "📦 Syncing backup → ${dest}"
+
+  mkdir -p "${dest}"
+
+  rsync -avhP --delete \
+    --exclude=".git" \
+    --exclude=".task" \
+    --exclude=".terraform" \
+    --exclude=".venv" \
+    --exclude="__pycache__" \
+    --exclude=".mypy_cache" \
+    --exclude=".pytest_cache" \
+    --exclude="node_modules" \
+    --exclude=".DS_Store" \
+    ./ "${dest}"
+
+  core::internal::message::success "✅ Backup saved to ${dest}"
+}

internal/git.zsh

@@ -0,0 +1,22 @@
+#!/usr/bin/env ksh
+# -*- coding: utf-8 -*-
+#
+function core::internal::git::get_module_path {
+  if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+    echo "unknown/unknown/$(basename "$(pwd)")"
+    return
+  fi
+
+  local remote_url
+  remote_url="$(git config --get remote.origin.url)"
+
+  if [[ "$remote_url" =~ ^git@([^:]+):(.+)\.git$ ]]; then
+    # [email protected]:hadenlabs/zsh-core.git → github.com/hadenlabs/zsh-core
+    echo "${BASH_REMATCH[1]}/${BASH_REMATCH[2]}"
+  elif [[ "$remote_url" =~ ^https?://([^/]+)/(.+)\.git$ ]]; then
+    # https://github.com/hadenlabs/zsh-core.git → github.com/hadenlabs/zsh-core
+    echo "${BASH_REMATCH[1]}/${BASH_REMATCH[2]}"
+  else
+    echo "unknown/unknown/$(basename "$(pwd)")"
+  fi
+}

internal/main.zsh

@@ -16,6 +16,12 @@ function core::internal::main::factory {
     esac
     # shellcheck source=/dev/null
     source "${ZSH_CORE_PATH}"/internal/helper.zsh
+
+    # shellcheck source=/dev/null
+    source "${ZSH_CORE_PATH}"/internal/git.zsh
+
+    # shellcheck source=/dev/null
+    source "${ZSH_CORE_PATH}"/internal/backup.zsh
 }
 
-core::internal::main::factory
+core::internal::main::factory

pkg/helper/backup.zsh

@@ -0,0 +1,6 @@
+#!/usr/bin/env ksh
+# -*- coding: utf-8 -*-
+
+function core::snapshot {
+  core::internal::backup::snapshot
+}

pkg/helper.zsh renamed to pkg/helper/core.zsh

@@ -182,4 +182,4 @@ fi
 function net {
     # check connection
     ping 8.8.8.8 | grep -E --only-match --color=never '[0-9\.]+ ms'
-}
+}

pkg/helper/main.zsh

@@ -0,0 +1,12 @@
+#!/usr/bin/env ksh
+# -*- coding: utf-8 -*-
+
+function core::pkg::helper::factory {
+    # shellcheck source=/dev/null
+    source "${ZSH_CORE_PATH}"/pkg/helper/backup.zsh
+
+    # shellcheck source=/dev/null
+    source "${ZSH_CORE_PATH}"/pkg/helper/core.zsh
+}
+
+core::pkg::helper::factory

pkg/main.zsh

@@ -15,7 +15,7 @@ function core::pkg::main::factory {
       ;;
     esac
     # shellcheck source=/dev/null
-    source "${ZSH_CORE_PATH}"/pkg/helper.zsh
+    source "${ZSH_CORE_PATH}"/pkg/helper/main.zsh
 
     # shellcheck source=/dev/null
     source "${ZSH_CORE_PATH}"/pkg/docker.zsh
@@ -24,4 +24,4 @@ function core::pkg::main::factory {
     source "${ZSH_CORE_PATH}"/pkg/alias.zsh
 }
 
-core::pkg::main::factory
+core::pkg::main::factory