Compare commits

...

16 Commits

Author SHA1 Message Date
github-actions[bot]
7c09a7ff74 chore: update pre-commit hooks (#78)
Co-authored-by: ivuorinen <11024+ivuorinen@users.noreply.github.com>
2025-02-13 14:28:54 +02:00
88efedf26b feat: updates, docs, license fixes, new helpers 2025-02-12 01:05:37 +02:00
renovate[bot]
cdd68748e0 chore(deps): update node.js to v22.14.0 (#77)
Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2025-02-12 00:35:00 +02:00
github-actions[bot]
f8ff2699e6 chore: update pre-commit hooks (#76) 2025-02-10 14:19:32 +02:00
c5e06888b8 chore(config): update Brewfile, zed settings 2025-02-07 12:41:55 +02:00
renovate[bot]
4f138eee73 fix(container): update image python (3.13.1 → 3.13.2) (#75)
Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2025-02-07 10:02:48 +02:00
github-actions[bot]
90258e5105 chore: update pre-commit hooks (#74) 2025-02-06 13:44:34 +02:00
efc53fc9bf feat(ci): sync-labels from ivuorinen/actions 2025-02-05 09:09:31 +02:00
github-actions[bot]
f62c17d940 chore: update pre-commit hooks (#73)
Co-authored-by: ivuorinen <11024+ivuorinen@users.noreply.github.com>
2025-02-03 14:36:14 +02:00
github-actions[bot]
fb15b93887 chore: update pre-commit hooks (#72)
Co-authored-by: ivuorinen <11024+ivuorinen@users.noreply.github.com>
2025-01-30 09:44:16 +02:00
renovate[bot]
222276486a feat(github-action): update actions/setup-python (v5.3.0 → v5.4.0)
Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2025-01-28 22:37:48 +00:00
github-actions[bot]
4446d59e73 chore: update pre-commit hooks (#71) 2025-01-28 17:08:31 +02:00
a22709a0f0 chore(repo): add-submodules submodule ignore dirty 2025-01-28 14:54:58 +02:00
76598ad33b chore(config): tmux config tweaks, .ignore 2025-01-28 14:51:38 +02:00
56ccb7c136 chore(nvim): plugin tweaks, config tweaks 2025-01-24 01:33:58 +02:00
github-actions[bot]
b6d933d018 chore: update pre-commit hooks (#70) 2025-01-23 08:20:21 +02:00
39 changed files with 1686 additions and 474 deletions

View File

@@ -13,7 +13,7 @@ jobs:
pull-requests: write
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5.3.0
- uses: actions/setup-python@v5.4.0
- run: pip install pre-commit && pre-commit autoupdate
- uses: peter-evans/create-pull-request@v7
with:

23
.github/workflows/sync-labels.yml vendored Normal file
View File

@@ -0,0 +1,23 @@
---
name: Sync labels
# yamllint disable-line rule:truthy
on:
push:
branches:
- main
paths:
- .github/workflows/sync-labels.yml
- .github/labels.yml
schedule:
- cron: "34 5 * * *"
workflow_call:
workflow_dispatch:
jobs:
SyncLabels:
permissions:
issues: write
runs-on: ubuntu-latest
steps:
- uses: ivuorinen/actions/sync-labels@main

2
.nvmrc
View File

@@ -1 +1 @@
22.13.1
22.14.0

View File

@@ -23,7 +23,7 @@ repos:
args: [--autofix, --no-sort-keys]
- repo: https://github.com/igorshubovych/markdownlint-cli
rev: v0.43.0
rev: v0.44.0
hooks:
- id: markdownlint
args: [-c, .markdownlint.json, --fix]
@@ -49,7 +49,7 @@ repos:
- id: actionlint
- repo: https://github.com/renovatebot/pre-commit-hooks
rev: 39.117.2
rev: 39.169.3
hooks:
- id: renovate-config-validator

View File

@@ -1 +1 @@
3.13.1
3.13.2

View File

@@ -46,7 +46,7 @@ git submodule add --name tmux/tmux-dark-notify \
# Takes submodules and sets them to ignore all changes
for MODULE in $(git config --file .gitmodules --get-regexp path | awk '{ print $2 }'); do
echo "Ignoring submodule changes for submodule.${MODULE}..."
git config "submodule.${MODULE}.ignore" all
git config "submodule.${MODULE}.ignore" "dirty"
done
# Mark certain repositories shallow

View File

@@ -61,30 +61,28 @@ brew "apr"
brew "apr-util"
# Password hashing library and CLI utility
brew "argon2"
# Automatic configure script builder
brew "autoconf"
# Tool for generating GNU Standards-compliant Makefiles
brew "automake"
# GNU multiple precision arithmetic library
brew "gmp"
# GNU File, Shell, and Text utilities
brew "coreutils"
# Extendable version manager with support for Ruby, Node.js, Erlang & more
brew "asdf"
# Spell checker with better logic than ispell
brew "aspell"
# Automatic configure script builder
brew "autoconf"
# Collection of over 500 reusable autoconf macros
brew "autoconf-archive"
# GNU multiple precision arithmetic library
brew "gmp"
# Package compiler and linker metadata toolkit
brew "pkgconf"
# Automated text file generator
brew "autogen"
# Tool for generating GNU Standards-compliant Makefiles
brew "automake"
# Official Amazon AWS command-line interface
brew "awscli"
# Bourne-Again SHell, a UNIX command interpreter
brew "bash"
# Clone of cat(1) with syntax highlighting and Git integration
brew "bat"
# GNU File, Shell, and Text utilities
brew "coreutils"
# Bash Automated Testing System
brew "bats-core"
# Parser generator
@@ -151,8 +149,6 @@ brew "unbound"
brew "gnutls"
# GNU Pretty Good Privacy (PGP) package
brew "gnupg"
# Open source programming language to build simple/reliable/efficient software
brew "go"
# Library access to GnuPG
brew "gpgme"
# Manage your GnuPG keys with ease!

View File

@@ -93,11 +93,12 @@ autocmd({ 'FileType' }, {
-- Set filetype for SSH config directory
-- Pattern handles directories with files like:
-- .dotfiles/ssh/config.d/*, .ssh/config.local, .ssh/config.work
-- .dotfiles/ssh/config.d/*, .ssh/config.local, .ssh/config.work,
-- .ssh/shared.d/*, .ssh/local.d/*
autocmd({ 'BufRead', 'BufNewFile' }, {
desc = 'Set filetype for SSH config directory',
pattern = {
'*/?.ssh/{config|shared}.d/*',
'*/?.ssh/{config|shared|local}.d/*',
'*/?.ssh/config.local',
'*/?.ssh/config.work',
},

View File

@@ -18,11 +18,14 @@ return {
},
},
{ 'L3MON4D3/LuaSnip', version = 'v2.*' },
{ 'L3MON4D3/LuaSnip', version = 'v2.*', build = 'make install_jsregexp' },
-- Set of preconfigured snippets for different languages.
-- https://github.com/rafamadriz/friendly-snippets
{ 'rafamadriz/friendly-snippets' },
{
'rafamadriz/friendly-snippets',
config = function() require('luasnip.loaders.from_vscode').lazy_load() end,
},
-- Lua plugin to turn github copilot into a cmp source
-- https://github.com/giuxtaposition/blink-cmp-copilot

View File

@@ -148,70 +148,61 @@ return {
-- https://github.com/Bilal2453/luvit-meta
{ 'Bilal2453/luvit-meta', lazy = true },
-- Quickstart configs for Nvim LSP
-- https://github.com/neovim/nvim-lspconfig
{ 'neovim/nvim-lspconfig' },
-- Portable package manager for Neovim that runs everywhere Neovim runs.
-- Easily install and manage LSP servers, DAP servers, linters, and formatters.
-- https://github.com/williamboman/mason.nvim
{
'williamboman/mason.nvim',
version = '*',
cmd = 'Mason',
run = ':MasonUpdate',
opts = {},
},
-- Extensible UI for Neovim notifications and LSP progress messages.
-- https://github.com/j-hui/fidget.nvim
{
'j-hui/fidget.nvim',
version = '*',
opts = {},
},
-- Extension to mason.nvim that makes it easier to use lspconfig with mason.nvim.
-- https://github.com/williamboman/mason-lspconfig.nvim
{ 'williamboman/mason-lspconfig.nvim' },
-- Install and upgrade third party tools automatically
-- https://github.com/WhoIsSethDaniel/mason-tool-installer.nvim
{
'WhoIsSethDaniel/mason-tool-installer.nvim',
version = '*',
opts = {
auto_install = true,
auto_update = true,
ensure_installed = mason_tools,
},
},
-- JSON schemas for Neovim
-- https://github.com/b0o/SchemaStore.nvim
{ 'b0o/schemastore.nvim' },
-- Performant, batteries-included completion plugin for Neovim
-- https://github.com/saghen/blink.cmp
-- See lua/plugins/blink.lua for configs
{ 'saghen/blink.cmp' },
-- A simple wrapper for nvim-lspconfig and mason-lspconfig
-- to easily setup LSP servers.
-- https://github.com/junnplus/lsp-setup.nvim
{
'junnplus/lsp-setup.nvim',
dependencies = {
-- Quickstart configs for Nvim LSP
-- https://github.com/neovim/nvim-lspconfig
{ 'neovim/nvim-lspconfig' },
-- Portable package manager for Neovim that runs everywhere Neovim runs.
-- Easily install and manage LSP servers, DAP servers, linters, and formatters.
-- https://github.com/williamboman/mason.nvim
{
'williamboman/mason.nvim',
version = '*',
cmd = 'Mason',
run = ':MasonUpdate',
opts = {},
},
-- Extensible UI for Neovim notifications and LSP progress messages.
-- https://github.com/j-hui/fidget.nvim
{
'j-hui/fidget.nvim',
version = '*',
opts = {},
},
-- Extension to mason.nvim that makes it easier to use lspconfig with mason.nvim.
-- https://github.com/williamboman/mason-lspconfig.nvim
{ 'williamboman/mason-lspconfig.nvim' },
-- Install and upgrade third party tools automatically
-- https://github.com/WhoIsSethDaniel/mason-tool-installer.nvim
{
'WhoIsSethDaniel/mason-tool-installer.nvim',
version = '*',
opts = {
auto_install = true,
auto_update = true,
ensure_installed = mason_tools,
},
},
-- JSON schemas for Neovim
-- https://github.com/b0o/SchemaStore.nvim
{ 'b0o/schemastore.nvim' },
-- Performant, batteries-included completion plugin for Neovim
-- https://github.com/saghen/blink.cmp
-- See lua/plugins/blink.lua for configs
{ 'saghen/blink.cmp' },
},
opts = {
default_mappings = false,
mappings = {
gd = 'lua require"telescope.builtin".lsp_definitions()',
gi = 'lua require"telescope.builtin".lsp_implementations()',
gr = 'lua require"telescope.builtin".lsp_references()',
},
inlay_hints = {
enabled = true,
},
servers = lsp_servers,
},
config = function(_, opts)
@@ -315,16 +306,6 @@ return {
'stevearc/conform.nvim',
event = { 'BufWritePre' },
cmd = { 'ConformInfo' },
keys = {
{
'<leader>cf',
function()
require('conform').format { async = true, lsp_format = 'fallback' }
end,
mode = '',
desc = 'Format buffer',
},
},
opts = {
notify_on_error = false,
---@type nil|conform.FormatOpts|fun(bufnr: integer): nil|conform.FormatOpts
@@ -340,9 +321,9 @@ return {
lsp_format_opt = 'fallback'
end
-- Disable autoformat for files in a certain path
-- Disable autoformat for files in a certain paths
local bufname = vim.api.nvim_buf_get_name(bufnr)
if bufname:match '/node_modules/' then return end
if bufname:match '/node_modules|vendor/' then return end
return {
timeout_ms = 500,

1
config/tmux/.ignore Normal file
View File

@@ -0,0 +1 @@
plugins/*

View File

@@ -40,6 +40,8 @@ run-shell "$TMUX_PLUGINS/tmux-sensible/sensible.tmux"
run-shell "$TMUX_PLUGINS/tmux-window-name/tmux_window_name.tmux"
run-shell "$TMUX_PLUGINS/tmux-mode-indicator/mode_indicator.tmux"
run-shell "$TMUX_PLUGINS/tmux-suspend/suspend.tmux"
run-shell "$TMUX_PLUGINS/tmux-continuum/continuum.tmux"
run-shell "$TMUX_PLUGINS/tmux-sessionist/sessionist.tmux"
run-shell "$TMUX_PLUGINS/tmux-yank/yank.tmux"
run-shell "$TMUX_PLUGINS/tmux-current-pane-hostname/current_pane_hostname.tmux"
run-shell "$TMUX_PLUGINS/tmux-dark-notify/main.tmux"

View File

@@ -1,8 +1,11 @@
{
"telemetry": {
"metrics": false
},
"assistant": {
"default_model": {
"provider": "copilot_chat",
"model": "gpt-4o"
"model": "claude-3-5-sonnet"
},
"version": "2"
},

View File

@@ -180,8 +180,6 @@ n <Space>tmc * <Cmd>setlocal cursorline! cursorline?<CR>
Toggle 'cursorline'
n <Space>tmb * <Cmd>lua vim.o.bg = vim.o.bg == "dark" and "light" or "dark"; print(vim.o.bg)<CR>
Toggle 'background'
os <Space>cf * ~/.local/share/nvim/lazy/lazy.nvim/lua/lazy/core/handler/keys.lua
Format buffer
x # * vim/_defaults.lua
:help v_#-default
o % <Plug>(MatchitOperationForward)
@@ -190,9 +188,9 @@ n % <Plug>(MatchitNormalForward)
n & * :&&<CR>
:help &-default
n '? & :<C-U>echo ":Start" dispatch#start_focus(v:count > 1 ? 0 : v:count ? line(".") : -1)<CR>
n '! & <SNR>10_:.Start!
n '<Space> & <SNR>10_:.Start<Space>
n '<CR> & <SNR>10_:.Start<CR>
n '! & <SNR>28_:.Start!
n '<Space> & <SNR>28_:.Start<Space>
n '<CR> & <SNR>28_:.Start<CR>
x * * vim/_defaults.lua
:help v_star-default
v < * <gv
@@ -267,10 +265,10 @@ n ]h * <Cmd>lua MiniDiff.goto_hunk('next')<CR>
Next hunk
n ]d * vim/_defaults.lua
Jump to the next diagnostic
n `? & <SNR>10_:.FocusDispatch<CR>
n `! & <SNR>10_:.Dispatch!
n `<Space> & <SNR>10_:.Dispatch<Space>
n `<CR> & <SNR>10_:.Dispatch<CR>
n `? & <SNR>28_:.FocusDispatch<CR>
n `! & <SNR>28_:.Dispatch!
n `<Space> & <SNR>28_:.Dispatch<Space>
n `<CR> & <SNR>28_:.Dispatch<CR>
x a% <Plug>(MatchitVisualTextObject)
o ax <Plug>(textobj-xmlattr-attr-a)
x ax <Plug>(textobj-xmlattr-attr-a)
@@ -284,13 +282,13 @@ o g% <Plug>(MatchitOperationBackward)
x g% <Plug>(MatchitVisualBackward)
n g% <Plug>(MatchitNormalBackward)
n g`? & :<C-U>echo ":Spawn" dispatch#spawn_focus(v:count > 1 ? 0 : v:count ? line(".") : -1)<CR>
n g`! & <SNR>10_:.Spawn!
n g`<Space> & <SNR>10_:.Spawn<Space>
n g`<CR> & <SNR>10_:.Spawn<CR>
n g`! & <SNR>28_:.Spawn!
n g`<Space> & <SNR>28_:.Spawn<Space>
n g`<CR> & <SNR>28_:.Spawn<CR>
n g'? & :<C-U>echo ":Spawn" dispatch#spawn_focus(v:count > 1 ? 0 : v:count ? line(".") : -1)<CR>
n g'! & <SNR>10_:.Spawn!
n g'<Space> & <SNR>10_:.Spawn<Space>
n g'<CR> & <SNR>10_:.Spawn<CR>
n g'! & <SNR>28_:.Spawn!
n g'<Space> & <SNR>28_:.Spawn<Space>
n g'<CR> & <SNR>28_:.Spawn<CR>
x gS * :<C-U>lua MiniSplitjoin.toggle({ region = MiniSplitjoin.get_visual_region() })<CR>
Toggle arguments
n gS * v:lua.MiniSplitjoin.operator("toggle") . " "
@@ -372,9 +370,9 @@ x k * v:count == 0 ? 'gk' : 'k'
n k * v:count == 0 ? 'gk' : 'k'
Move up
n m? & :<C-U>echo ":Dispatch" dispatch#make_focus(v:count > 1 ? 0 : v:count ? line(".") : -1)<CR>
n m! & <SNR>10_:.Make!
n m<Space> & <SNR>10_:.Make<Space>
n m<CR> & <SNR>10_:.Make<CR>
n m! & <SNR>28_:.Make!
n m<Space> & <SNR>28_:.Make<Space>
n m<CR> & <SNR>28_:.Make<CR>
n shn * ~/.local/share/nvim/lazy/mini.nvim/lua/mini/surround.lua
Highlight next surrounding
n sFn * ~/.local/share/nvim/lazy/mini.nvim/lua/mini/surround.lua
@@ -458,6 +456,14 @@ x <Plug>(MatchitVisualBackward) * :<C-U>call matchit#Match_wrapper('',0,'v')<CR
x <Plug>(MatchitVisualForward) * :<C-U>call matchit#Match_wrapper('',1,'v')<CR>:if col("''") != col("$") | exe ":normal! m'" | endif<CR>gv``
n <Plug>(MatchitNormalBackward) * :<C-U>call matchit#Match_wrapper('',0,'n')<CR>
n <Plug>(MatchitNormalForward) * :<C-U>call matchit#Match_wrapper('',1,'n')<CR>
o <Plug>(textobj-xmlattr-attr-i) & <SNR>34_(save-cursor-pos):<C-U>call g:__textobj_xmlattr.do_by_pattern("select","attr-i","o")<CR>
v <Plug>(textobj-xmlattr-attr-i) & <SNR>34_(save-cursor-pos):<C-U>call g:__textobj_xmlattr.do_by_pattern("select","attr-i","v")<CR>
o <Plug>(textobj-xmlattr-attr-a) & <SNR>34_(save-cursor-pos):<C-U>call g:__textobj_xmlattr.do_by_pattern("select","attr-a","o")<CR>
v <Plug>(textobj-xmlattr-attr-a) & <SNR>34_(save-cursor-pos):<C-U>call g:__textobj_xmlattr.do_by_pattern("select","attr-a","v")<CR>
n <SNR>34_ * <SNR>34_
<SNR>34_(save-cursor-pos) * <SNR>34_save_cursor_pos()
n <SNR>28_:. & :<C-R>=getcmdline() =~ ',' ? "\0250" : ""<CR>
n <Plug>PlenaryTestFile * :lua require('plenary.test_harness').test_file(vim.fn.expand("%:p"))<CR>
s <Plug>luasnip-jump-prev * ~/.local/share/nvim/lazy/LuaSnip/plugin/luasnip.lua
LuaSnip: Jump to the previous node
s <Plug>luasnip-jump-next * ~/.local/share/nvim/lazy/LuaSnip/plugin/luasnip.lua
@@ -474,14 +480,6 @@ s <Plug>luasnip-expand-or-jump * ~/.local/share/nvim/lazy/LuaSnip/plugin/luasni
LuaSnip: Repeat last node expansion
n <Plug>luasnip-delete-check * ~/.local/share/nvim/lazy/LuaSnip/plugin/luasnip.lua
LuaSnip: Removes current snippet from jumplist
n <Plug>PlenaryTestFile * :lua require('plenary.test_harness').test_file(vim.fn.expand("%:p"))<CR>
o <Plug>(textobj-xmlattr-attr-i) & <SNR>14_(save-cursor-pos):<C-U>call g:__textobj_xmlattr.do_by_pattern("select","attr-i","o")<CR>
v <Plug>(textobj-xmlattr-attr-i) & <SNR>14_(save-cursor-pos):<C-U>call g:__textobj_xmlattr.do_by_pattern("select","attr-i","v")<CR>
o <Plug>(textobj-xmlattr-attr-a) & <SNR>14_(save-cursor-pos):<C-U>call g:__textobj_xmlattr.do_by_pattern("select","attr-a","o")<CR>
v <Plug>(textobj-xmlattr-attr-a) & <SNR>14_(save-cursor-pos):<C-U>call g:__textobj_xmlattr.do_by_pattern("select","attr-a","v")<CR>
n <SNR>14_ * <SNR>14_
<SNR>14_(save-cursor-pos) * <SNR>14_save_cursor_pos()
n <SNR>10_:. & :<C-R>=getcmdline() =~ ',' ? "\0250" : ""<CR>
x <C-S> * <Esc><Cmd>silent! update | redraw<CR>
Save and go to Normal mode
n <C-S> * :w!<CR>
@@ -494,4 +492,4 @@ n <C-L> * :lua vim.lsp.buf.signature_help()<CR>
Signature
```
- Generated on Tue 21 Jan 2025 15:03:23 EET
- Generated on Tue 21 Jan 2025 15:24:13 EET

View File

@@ -13,7 +13,7 @@ Some problematic code has been fixed per `shellcheck` suggestions.
## Sourced
| Script | Source |
| ----------------------- | ----------------- |
|-------------------------|-------------------|
| `x-dupes` | skx/sysadmin-util |
| `x-foreach` | mvdan/dotfiles |
| `x-multi-ping` | skx/sysadmin-util |

View File

@@ -23,8 +23,8 @@
VERBOSE="${VERBOSE:-0}"
# UTF-8 ftw
GITDIRTY="❌ "
GITCLEAN="✅ "
GIT_DIRTY="❌ "
GIT_CLEAN="✅ "
# Function to print messages if VERBOSE is enabled
# $1 - message (string)
@@ -41,7 +41,7 @@ catch()
# Function to check the git status of a directory
# $1 - directory (string)
gitdirty()
git_dirty()
{
local d="$1"
trap 'catch $? $LINENO' ERR
@@ -58,15 +58,15 @@ gitdirty()
# If we have `.git` folder, check it.
if [[ -d ".git" ]]; then
ISDIRTY=$(git diff --shortstat 2> /dev/null | tail -n1)
ICON="$GITCLEAN"
GIT_IS_DIRTY=$(git diff --shortstat 2> /dev/null | tail -n1)
ICON="$GIT_CLEAN"
[[ $ISDIRTY != "" ]] && ICON="$GITDIRTY"
[[ $GIT_IS_DIRTY != "" ]] && ICON="$GIT_DIRTY"
printf " %s %s\n" "$ICON" "$(pwd)"
else
# If it wasn't git repository, check subdirectories.
gitdirtyrepos ./*
git_dirty_repos ./*
fi
cd - > /dev/null || exit
fi
@@ -76,10 +76,10 @@ gitdirty()
# Function to check git status for multiple directories
# $@ - directories
gitdirtyrepos()
git_dirty_repos()
{
for x in "$@"; do
gitdirty "$x"
git_dirty "$x"
done
}
@@ -96,7 +96,7 @@ main()
11) echo "segfault occurred";;
esac' EXIT
gitdirtyrepos "$GIT_DIRTY_DIR"
git_dirty_repos "$GIT_DIRTY_DIR"
}
main "$@"

View File

@@ -1,7 +1,7 @@
#!/usr/bin/env bash
#
# Credit to ThePrimeagen, jessarcher
# https://github.com/jessarcher/dotfiles/blob/master/scripts/t
# Credit to ThePrimeagen, Jess Archer
# See https://github.com/jessarcher/dotfiles/blob/master/scripts/t
#
# Tweaks by Ismo Vuorinen <https://github.com/ivuorinen> 2025
# vim: ft=bash ts=2 sw=2 et
@@ -9,104 +9,135 @@
# Set environment variables for configuration with defaults
T_ROOT="${T_ROOT:-$HOME/Code}"
DOTFILES="${DOTFILES:-$HOME/.dotfiles}"
T_MAX_DEPTH="${T_MAX_DEPTH:-3}"
# Function to print an error message and exit
error_exit()
{
error_exit() {
echo "Error: $1" >&2
exit 1
}
get_directories()
{
local dirs=''
dirs+='# Directories\n'
dirs+=$(
find "$T_ROOT" \
-maxdepth 3 \
-mindepth 1 \
-type d \
-not -path '*/dist/*' \
-not -path '*/dist' \
-not -path '*/node_modules/*' \
-not -path '*/node_modules' \
-not -path '*/vendor/*' \
-not -path '*/vendor' \
-not -path '*/.idea/*' \
-not -path '*/.idea' \
-not -path '*/.vscode/*' \
-not -path '*/.vscode' \
-not -path '*/.git/*' \
-not -path '*/.git' \
-not -path '*/.svn/*' \
-not -path '*/.svn'
)
dirs+="$(printf "\n%s" "$DOTFILES")"
# Validate that T_ROOT exists
if [[ ! -d "$T_ROOT" ]]; then
error_exit "T_ROOT directory '$T_ROOT' does not exist."
fi
echo "$dirs"
# Check for required dependencies
check_dependencies() {
local T_DEPS=(tmux fzf find)
for cmd in "${T_DEPS[@]}"; do
if ! command -v "$cmd" &> /dev/null; then
error_exit "$cmd is not installed."
fi
done
}
check_tmux()
{
check_dependencies
# Generate an array of '-not -path' rules for each exclusion pattern
# without using namerefs.
generate_exclude_rules() {
local result_var="$1"
shift
local arr=()
for pattern in "$@"; do
# Exclude both the directory and any subdirectories under it.
arr+=( -not -path "*/${pattern}" -not -path "*/${pattern}/*" )
done
# Use eval to assign the array to the variable whose name was passed.
eval "$result_var=(\"\${arr[@]}\")"
}
get_directories() {
local exclude_patterns=(
".bzr" ".git" ".hg" ".idea" ".obsidian" ".run" ".svn" ".vscode"
"build" "dist" "node_modules" "out" "target" "vendor"
)
local exclude_rules=()
generate_exclude_rules exclude_rules "${exclude_patterns[@]}"
local dirs
# Use $'string' to correctly process escape sequences.
dirs=$'# Directories\n'
dirs+=$(find "$T_ROOT" \
-maxdepth "$T_MAX_DEPTH" \
-mindepth 1 \
-type d \
"${exclude_rules[@]}"
)
echo -e "$dirs"
}
check_tmux() {
if ! command -v tmux &> /dev/null; then
error_exit "tmux is not installed."
fi
# check to see that tmux server is running
# Ensure tmux server is running
if ! tmux info &> /dev/null; then
tmux start-server
fi
}
get_sessions()
{
get_sessions() {
check_tmux
local sessions=''
sessions+='# Sessions\n'
sessions+=$(tmux list-sessions -F "#{session_name}" 2> /dev/null)
T_TMUX_SESSIONS=$(tmux list-sessions -F "#{session_name}" 2> /dev/null)
echo "$sessions"
if [[ -z "$T_TMUX_SESSIONS" ]]; then
echo ""
return
fi
echo -e "# Sessions\n$T_TMUX_SESSIONS"
}
items=''
# Select the directory
# Determine selection from command-line argument or interactive fzf menu
if [[ $# -eq 1 ]]; then
selected="$1"
else
items+=$(get_sessions | sort)
items+='\n'
items+=$(get_directories | sort)
# Combine sessions and directories for selection
T_ITEMS="$(get_sessions | sort)
$(get_directories | sort)"
selected=$(echo -e "$items" | fzf) || exit 0 # Exit if no selection is made
# Use sort to order the entries and fzf for interactive selection
selected=$(echo "$T_ITEMS" | fzf) || exit 0
fi
# If user selected a header, exit
[[ ${selected:0:1} == "#" ]] && error_exit "You selected a header, why?"
# Reject selection if it is a header line
[[ ${selected:0:1} == "#" ]] && error_exit "Header selected. Please choose a valid session or directory."
# Exit if no directory was selected
[[ -z $selected ]] && error_exit "No directory selected."
[[ -z "$selected" ]] && error_exit "No directory or session selected."
# Sanitize the session name
session_name=$(basename "$selected")
# If we get nothing, we are dealing with a session
[[ $session_name == "" ]] && session_name="$selected"
# Remove dots from the session name as tmux doesn't like them
if [[ -z "$session_name" ]]; then
session_name="$selected"
fi
# Remove dots since tmux dislikes them
session_name="${session_name//./}"
# Try to switch to the tmux session
tmux switch-client -t "=$session_name"
# Attempt to switch to an existing session
tmux switch-client -t "=$session_name" 2>/dev/null
active_session=$(tmux display-message -p -F '#{session_name}' 2>/dev/null)
active_session=$(tmux display-message -p -F '#{session_name}' 2> /dev/null)
# echo "active session: $active_session"
if [ -n "$active_session" ] && [ "$active_session" == "$session_name" ]; then
if [[ "$active_session" == "$session_name" ]]; then
exit 0
fi
# Create a new tmux session or attach to an existing one
if tmux new-session -c "$selected" -d -s "$session_name" 2> /dev/null; then
tmux switch-client -t "$session_name"
# Create a new session (or attach to an existing one) based on the selection
if [ -z "$TMUX" ]; then
# Not inside tmux: create (or attach to) the session and attach.
tmux new-session -A -s "$session_name" -c "$selected"
else
tmux new -c "$selected" -A -s "$session_name"
# Inside tmux: check if the target session exists.
if tmux has-session -t "$session_name" 2>/dev/null; then
# Session exists; switch to it.
tmux switch-client -t "$session_name"
else
# Session does not exist; create it in detached mode and then switch.
tmux new-session -d -s "$session_name" -c "$selected"
tmux switch-client -t "$session_name"
fi
fi

54
local/bin/x-clean-vendordirs Executable file
View File

@@ -0,0 +1,54 @@
#!/usr/bin/env bash
# vim: ft=bash sw=2 ts=2 et
#
# Removes vendor and node_modules directories from the
# current directory and all subdirectories.
#
# Author: Ismo Vuorinen 2025
# License: MIT
# Check if the user has provided a directory as an argument
if [ "$1" ]; then
# Check if the directory exists
if [ -d "$1" ]; then
CLEANDIR="$1"
else
msgr err "Directory $1 does not exist."
exit 1
fi
else
CLEANDIR="."
fi
# Function to remove node_modules and vendor folders
remove_node_modules_vendor() {
local dir=$1
# If the directory is a symlink, skip it
if [ -L "$dir" ]; then
msgr msg "Skipping symlink $dir"
return
fi
# Check if the directory exists
if [ -d "$dir" ]; then
# If node_modules or vendor folder exists, remove it and all its contents
if [ -d "$dir/node_modules" ]; then
msgr run "Removing $dir/node_modules"
rm -rf "$dir/node_modules"
fi
if [ -d "$dir/vendor" ]; then
msgr run "Removing $dir/vendor"
rm -rf "$dir/vendor"
fi
# Recursively check subdirectories
for item in "$dir"/*; do
remove_node_modules_vendor "$item"
done
fi
}
# Start removing node_modules and vendor folders from the current working directory
remove_node_modules_vendor "$CLEANDIR"

View File

@@ -1,6 +1,7 @@
#!/usr/bin/env bash
#
# foreach <folder> <commands that should be run to each file>
# foreach "ls -d */" "git status" # run git status in each folder
#
# Source: https://github.com/mvdan/dotfiles/blob/master/.bin/foreach
@@ -11,6 +12,7 @@ for dir in $($cmd); do
(
echo "$dir"
cd "$dir" || exit 1
# shellcheck disable=SC2294,SC2034
eval "$@" # allow multiple commands like "foo && bar"
)
done

View File

@@ -1,7 +1,7 @@
#!/usr/bin/env bash
#
# Fetch the latest release version of a GitHub repository in tar.gz format (e.g. v1.0.0.tar.gz)
# Usage: x-gh-get-latest-release-targ <repo> [--get]
# Usage: x-gh-get-latest-release-targz <repo> [--get]
# Author: Ismo Vuorinen <https://github.com/ivuorinen> 2024
set -euo pipefail

View File

@@ -1,66 +1,190 @@
#!/usr/bin/env bash
#
# Get latest release version from GitHub
# Get latest release version, branch tag, or latest commit from GitHub
# Usage: x-gh-get-latest-version <repo>
# Author: Ismo Vuorinen <https://github.com/ivuorinen> 2024
set -euo pipefail
# Enable verbosity with VERBOSE=1
# Environment variables, more under get_release_version() and get_latest_branch_tag()
# functions. These can be overridden by the user.
GITHUB_API_URL="${GITHUB_API_URL:-https://api.github.com/repos}"
VERBOSE="${VERBOSE:-0}"
# Function to print usage information
usage()
{
echo "Usage: $0 <repo> (e.g. ivuorinen/dotfiles)"
# Prints a message if VERBOSE=1
msg() {
[[ "$VERBOSE" -eq 1 ]] && echo "$1"
}
# Show usage information
usage() {
cat <<EOF
Usage: $0 <repo> (e.g. ivuorinen/dotfiles)
Fetches the latest release version, latest branch tag, or latest commit SHA from GitHub.
Options:
- INCLUDE_PRERELEASES=1 Include prerelease versions (default: only stable releases).
- OLDEST_RELEASE=1 Fetch the oldest release instead of the latest.
- BRANCH=<branch> Fetch the latest tag from a specific branch (default: main).
- LATEST_COMMIT=1 Fetch the latest commit SHA from the specified branch.
- OUTPUT=json Return output as JSON (default: plain text).
- GITHUB_API_URL=<url> Override GitHub API URL (useful for GitHub Enterprise).
- GITHUB_TOKEN=<token> Use GitHub API token to increase rate limits (default: unauthenticated).
Requirements:
- curl
- jq (for JSON processing)
Examples:
# Fetch the latest stable release
$0 ivuorinen/dotfiles
# Fetch the latest release including prereleases
INCLUDE_PRERELEASES=1 $0 ivuorinen/dotfiles
# Fetch the oldest release
OLDEST_RELEASE=1 $0 ivuorinen/dotfiles
# Fetch the latest tag from the 'develop' branch
BRANCH=develop $0 ivuorinen/dotfiles
# Fetch the latest commit SHA from 'main' branch
LATEST_COMMIT=1 $0 ivuorinen/dotfiles
# Output result in JSON format
OUTPUT=json $0 ivuorinen/dotfiles
# Use GitHub API token for higher rate limits
GITHUB_TOKEN="your_personal_access_token" $0 ivuorinen/dotfiles
# Use GitHub Enterprise API
GITHUB_API_URL="https://github.example.com/api/v3/repos" $0 ivuorinen/dotfiles
EOF
exit 1
}
# Function to print messages if VERBOSE is enabled
# $1 - message (string)
msg()
{
[[ "$VERBOSE" -eq 1 ]] && echo "$1"
return 0
# Check that required dependencies are installed
check_dependencies() {
for cmd in curl jq; do
if ! command -v "$cmd" &>/dev/null; then
echo "Error: '$cmd' is required but not installed." >&2
exit 1
fi
done
}
# Function to fetch the latest release version from GitHub
# Fetches the latest release or the oldest if OLDEST_RELEASE=1
# $1 - GitHub repository (string)
get_latest_release()
{
local repo=$1
get_release_version() {
local repo="$1"
local include_prereleases="${INCLUDE_PRERELEASES:-0}"
local oldest_release="${OLDEST_RELEASE:-0}"
local api_url="${GITHUB_API_URL}/${repo}/releases"
local auth_header=()
if [[ -n "${GITHUB_TOKEN:-}" ]]; then
auth_header=(-H "Authorization: token $GITHUB_TOKEN")
fi
msg "Fetching release data from: $api_url (Include prereleases: $include_prereleases, Oldest: $oldest_release)"
local json_response
json_response=$(curl -sSL "${auth_header[@]}" "$api_url")
# Check for API errors
if echo "$json_response" | jq -e 'has("message")' >/dev/null; then
msg "GitHub API error: $(echo "$json_response" | jq -r '.message')"
exit 1
fi
local filter='.[] | select(.tag_name)'
[[ "$include_prereleases" -eq 0 ]] && filter+='.prerelease == false'
local version
version=$(curl -s "https://api.github.com/repos/${repo}/releases/latest" \
| grep "tag_name" \
| awk -F '"' '{print $4}')
if [[ "$oldest_release" -eq 1 ]]; then
version=$(echo "$json_response" | jq -r "[${filter}] | last.tag_name // empty")
else
version=$(echo "$json_response" | jq -r "[${filter}] | first.tag_name // empty")
fi
if [ -z "$version" ]; then
msg "Failed to fetch the latest release version for repository: $repo"
echo ""
if [[ -z "$version" ]]; then
msg "Failed to fetch release version for repository: $repo"
exit 1
fi
echo "$version"
return 0
}
# Fetches the latest tag from the specified branch
get_latest_branch_tag() {
local repo="$1"
local branch="${BRANCH:-main}"
local api_url="${GITHUB_API_URL}/${repo}/git/refs/tags"
msg "Fetching latest tag for branch '$branch' from: $api_url"
local json_response
json_response=$(curl -sSL "$api_url")
local version
version=$(echo "$json_response" | jq -r "[.[] | select(.ref | contains(\"refs/tags/$branch\"))] | last.ref | sub(\"refs/tags/\"; \"\") // empty")
if [[ -z "$version" ]]; then
msg "Failed to fetch latest tag for branch: $branch"
exit 1
fi
echo "$version"
}
# Fetches the latest commit SHA from the specified branch
get_latest_commit() {
local repo="$1"
local branch="${BRANCH:-main}"
local api_url="${GITHUB_API_URL}/${repo}/commits/$branch"
msg "Fetching latest commit SHA from: $api_url"
local json_response
json_response=$(curl -sSL "$api_url")
local sha
sha=$(echo "$json_response" | jq -r '.sha // empty')
if [[ -z "$sha" ]]; then
msg "Failed to fetch latest commit SHA for branch: $branch"
exit 1
fi
echo "$sha"
}
# Main function
main()
{
if [ "$#" -ne 1 ]; then
# $1 - GitHub repository (string)
main() {
if [[ $# -ne 1 ]]; then
usage
fi
local repo=$1
check_dependencies
msg "Fetching the latest release version for repository: $repo"
local repo="$1"
local result
local version
version=$(get_latest_release "$repo")
if [[ "${LATEST_COMMIT:-0}" -eq 1 ]]; then
result=$(get_latest_commit "$repo")
elif [[ -n "${BRANCH:-}" ]]; then
result=$(get_latest_branch_tag "$repo")
else
result=$(get_release_version "$repo")
fi
echo "$version"
return 0
if [[ "${OUTPUT:-text}" == "json" ]]; then
echo "{\"repository\": \"$repo\", \"result\": \"$result\"}"
else
echo "$result"
fi
}
main "$@"

View File

@@ -6,11 +6,12 @@
# License: MIT
VERSION="1.0.0"
SCRIPT_NAME="$(basename "$0")"
# Function to display usage
usage()
{
echo "Usage: x-localip [options] [interface]"
echo "Usage: $SCRIPT_NAME [options] [interface]"
echo "Options:"
echo " --help Show this help message"
echo " --version Show version information"
@@ -31,7 +32,7 @@ while [[ $# -gt 0 ]]; do
exit 0
;;
--version)
echo "x-localip version $VERSION"
echo "$SCRIPT_NAME version $VERSION"
exit 0
;;
--ipv4)

183
local/bin/x-multi-ping Executable file
View File

@@ -0,0 +1,183 @@
#!/usr/bin/env bash
# x-multi-ping: Multi-protocol ping wrapper in Bash
#
# Description:
# This script pings a list of hostnames using both IPv4 and IPv6 protocols.
# It uses the 'dig' command to resolve the hostnames and then pings each IP
# address found. The script can run once or loop indefinitely with a sleep
# interval between iterations.
#
# This script is based on the original work by Steve Kemp.
# Original work Copyright (c) 2014 by Steve Kemp.
#
# The code in the original repository may be modified and distributed under your choice of:
# * The Perl Artistic License (http://dev.perl.org/licenses/artistic.html) or
# * The GNU General Public License, version 2 or later (http://www.gnu.org/licenses/gpl2.txt).
#
# Modifications and enhancements by Ismo Vuorinen on 2025.
#
# Usage:
# x-multi-ping [--loop|--forever] [--sleep=N] hostname1 hostname2 ...
#
# Options:
# --help Display this help message.
# --verbose Enable verbose output.
# --loop, --forever Loop indefinitely.
# --sleep=N Sleep N seconds between iterations (default: 1).
#
# Examples:
# x-multi-ping example.com
# x-multi-ping --loop --sleep=5 example.com
# x-multi-ping --forever example.com example.org
#
# Dependencies:
# - dig (DNS lookup utility)
# - ping (ICMP ping utility)
# - ping6 (IPv6 ping utility) or ping -6 (alternative)
#
# Defaults
LOOP=0
SLEEP=1
VERBOSE=0
TIMEOUT=5
usage()
{
echo "Usage: $0 [--loop|--forever] [--sleep=N] hostname1 hostname2 ..."
echo "Options:"
echo " --help Display this help message."
echo " --verbose Enable verbose output."
echo " --loop, --forever Loop indefinitely."
echo " --sleep=N Sleep N seconds between iterations (default: 1)."
}
# Parse command-line options
while [[ $# -gt 0 ]]; do
case "$1" in
--help)
usage
exit 0
;;
--verbose)
# shellcheck disable=SC2034
VERBOSE=1
shift
;;
--loop | --forever)
LOOP=1
shift
;;
--sleep=*)
SLEEP="${1#*=}"
shift
;;
--sleep)
if [[ -n "$2" ]]; then
SLEEP="$2"
shift 2
else
echo "Error: --sleep requires a numeric value."
exit 1
fi
;;
--*)
echo "Unknown option: $1"
usage
exit 1
;;
*)
break
;;
esac
done
# Check for required hostnames
if [[ $# -lt 1 ]]; then
usage
exit 1
fi
# Dependency check for dig and ping
if ! command -v dig > /dev/null 2>&1; then
echo "The required 'dig' command is missing. Aborting."
exit 1
fi
if ! command -v ping > /dev/null 2>&1; then
echo "The required 'ping' command is missing. Aborting."
exit 1
fi
# Determine how to invoke IPv6 ping
if command -v ping6 > /dev/null 2>&1; then
PING6="ping6"
elif ping -6 -c1 ::1 > /dev/null 2>&1; then
PING6="ping -6"
else
echo "The required IPv6 ping command (ping6 or ping -6) is missing. Aborting."
exit 1
fi
# Function to remove any URI scheme and port from the hostname.
strip_hostname()
{
local host="$1"
# Remove leading scheme (e.g., http://) if present.
if [[ "$host" =~ ^[a-z]+://([^/]+)/? ]]; then
host="${BASH_REMATCH[1]}"
fi
# Remove a port if specified (e.g., example.com:80).
if [[ "$host" =~ ^([^:]+):[0-9]+$ ]]; then
host="${BASH_REMATCH[1]}"
fi
echo "$host"
}
# Function to ping a given host based on DNS lookups.
pingHost()
{
local original_host="$1"
local host
host=$(strip_hostname "$original_host")
for type in A AAAA; do
# Look up the DNS records for the host.
ips=$(dig +short "$host" "$type")
if [[ -z "$ips" ]]; then
echo "WARNING: Failed to resolve $host [$type]"
else
# For each IP address found, perform the appropriate ping.
while IFS= read -r ip; do
if [[ "$type" == "A" ]]; then
ping_binary="ping"
else
ping_binary="$PING6"
fi
# Execute ping with one packet and a timeout.
$ping_binary -c1 -w"$TIMEOUT" -W"$TIMEOUT" "$host" > /dev/null 2>&1
# shellcheck disable=SC2181
if [[ $? -eq 0 ]]; then
echo "Host $host - $ip - alive"
else
echo "Host $host - $ip - FAILED"
fi
done <<< "$ips"
fi
done
}
# Main loop: run once or forever based on the options.
if [[ $LOOP -eq 1 ]]; then
while true; do
for host in "$@"; do
pingHost "$host"
done
sleep "$SLEEP"
done
else
for host in "$@"; do
pingHost "$host"
done
fi

View File

@@ -1,37 +1,141 @@
#!/usr/bin/env bash
#
# List open (listened) ports, without the crud that
# usually comes with `lsof -i`
# List open (listened) ports in Markdown or JSON format.
#
# Modified by: Ismo Vuorinen <https://github.com/ivuorinen> 2020
# Modified by: Ismo Vuorinen <https://github.com/ivuorinen> 2020, 2025
# Originally from: https://www.commandlinefu.com/commands/view/8951
# Original author: https://www.commandlinefu.com/commands/by/wickedcpj
set -euo pipefail
# Function to print the header
print_header()
FORMAT="markdown"
# Function to print help message
print_help()
{
echo 'User: Command: PID: Port:'
echo '========================================================='
cat << EOF
Usage: $(basename "$0") [OPTIONS]
List open (listened) ports in a formatted table (Markdown) or JSON.
Options:
--json Output results in JSON format instead of Markdown
--help Show this help message
Examples:
$(basename "$0") # List open ports as a Markdown table
$(basename "$0") --json # List open ports in JSON format
EOF
exit 0
}
# Function to list open ports
# Function to print the Markdown table header
print_header()
{
echo "| User | Command | PID | Port |"
echo "|------------------|----------------------------|----------|---------|"
}
# Function to list open ports using lsof
list_open_ports_lsof()
{
lsof -i -P -n -sTCP:LISTEN +c 0 2> /dev/null | awk '
NR > 1 {
port = $9
sub(/.*:/, "", port) # Extract port number
printf "| %-16s | %-26s | %-8s | %-7s |\n", substr($3, 1, 16), substr($1, 1, 26), substr($2, 1, 8), port
}
' | sort -k3,3n | uniq
}
# Function to list open ports using ss (alternative)
list_open_ports_ss()
{
ss -ltpn 2> /dev/null | awk '
NR > 1 {
split($5, addr, ":")
port = addr[length(addr)]
user = $1
cmd = $7
sub(/users:\(\(/, "", cmd) # Cleanup command
sub(/\)\)/, "", cmd)
pid = "-"
match(cmd, /pid=([0-9]+)/, m)
if (m[1] != "") pid = m[1]
printf "| %-16s | %-26s | %-8s | %-7s |\n", substr(user, 1, 16), substr(cmd, 1, 26), substr(pid, 1, 8), port
}
' | sort -k3,3n | uniq
}
# Function to print JSON output
list_open_ports_json()
{
if command -v lsof &> /dev/null; then
lsof -i -P -n -sTCP:LISTEN +c 0 2> /dev/null | awk '
NR > 1 {
port = $9
sub(/.*:/, "", port) # Extract port number
printf "{\"user\": \"%s\", \"command\": \"%s\", \"pid\": \"%s\", \"port\": \"%s\"},\n", $3, $1, $2, port
}
' | sort -k3,3n | uniq | sed '$ s/,$//'
elif command -v ss &> /dev/null; then
ss -ltpn 2> /dev/null | awk '
NR > 1 {
split($5, addr, ":")
port = addr[length(addr)]
user = $1
cmd = $7
sub(/users:\(\(/, "", cmd)
sub(/\)\)/, "", cmd)
pid = "-"
match(cmd, /pid=([0-9]+)/, m)
if (m[1] != "") pid = m[1]
printf "{\"user\": \"%s\", \"command\": \"%s\", \"pid\": \"%s\", \"port\": \"%s\"},\n", user, cmd, pid, port
}
' | sort -k3,3n | uniq | sed '$ s/,$//'
else
echo "[]"
fi
}
# Function to determine available command
list_open_ports()
{
lsof -i 4 -P -n +c 0 \
| grep -i 'listen' \
| awk '{print $3, $1, $2, $9}' \
| sed 's/ [a-z0-9\.\*]*:/ /' \
| sort -k 3 -n \
| xargs printf '%-15s %-25s %-8s %-5s\n' \
| uniq
if [[ "$FORMAT" == "json" ]]; then
echo "["
list_open_ports_json
echo "]"
else
print_header
if command -v lsof &> /dev/null; then
list_open_ports_lsof
elif command -v ss &> /dev/null; then
list_open_ports_ss
else
echo "**Error:** Neither 'lsof' nor 'ss' is available."
exit 1
fi
fi
}
# Main function
main()
{
print_header
case "${1:-}" in
--json)
FORMAT="json"
;;
--help)
print_help
;;
"") ;;
*)
echo "Unknown option: $1"
print_help
;;
esac
list_open_ports
echo ""
}

281
local/bin/x-path Executable file
View File

@@ -0,0 +1,281 @@
#!/usr/bin/env bash
#
# x-path: A unified script to manipulate the PATH variable.
#
# This script supports four subcommands:
# - append (or a): Remove duplicates and append one or more directories.
# - prepend (or p): Remove duplicates and prepend one or more directories.
# - remove: Remove one or more directories from PATH.
# - check: Check if the directories (or all directories in PATH if none provided) are valid.
#
# All directory arguments are normalized (trailing slashes removed, except for "/"),
# and the current PATH is normalized before any operations.
#
# Usage:
# x-path <command> <directory1> [<directory2> ...]
#
# Examples:
# x-path append /usr/local/bin /opt/bin
# x-path p /home/user/bin
# x-path remove /usr/local/bin
# x-path check # Check all directories in PATH
# x-path check /usr/local/bin /bin
#
# Enable verbose output by setting:
# export VERBOSE=1
VERBOSE="${VERBOSE:-0}"
#######################################
# Normalize a directory by removing a trailing slash (unless the directory is "/").
# Globals:
# None
# Arguments:
# $1 - Directory path to normalize
# Returns:
# Echoes the normalized directory.
#######################################
normalize_dir()
{
local d="$1"
if [ "$d" != "/" ]; then
d="${d%/}"
fi
echo "$d"
}
#######################################
# Normalize the PATH variable by normalizing each of its components.
# Globals:
# PATH
# Arguments:
# None
# Returns:
# Updates and exports PATH.
#######################################
normalize_path_var()
{
local new_path=""
local d
IFS=':' read -r -a arr <<< "$PATH"
for d in "${arr[@]}"; do
d=$(normalize_dir "$d")
if [ -z "$new_path" ]; then
new_path="$d"
else
new_path="$new_path:$d"
fi
done
PATH="$new_path"
export PATH
}
#######################################
# Remove all occurrences of a normalized directory from PATH.
# Globals:
# PATH
# Arguments:
# $1 - Normalized directory to remove from PATH.
# Returns:
# Updates PATH.
#######################################
remove_from_path()
{
local d="$1"
PATH=":${PATH}:"
PATH="${PATH//:$d:/:}"
PATH="${PATH#:}"
PATH="${PATH%:}"
}
#######################################
# Append one or more directories to PATH.
# Globals:
# PATH, VERBOSE
# Arguments:
# One or more directory paths.
# Returns:
# Updates PATH.
#######################################
do_append()
{
local processed=""
local d
for arg in "$@"; do
d=$(normalize_dir "$arg")
if [[ " $processed " == *" $d "* ]]; then
continue
else
processed="$processed $d"
fi
if [ ! -d "$d" ]; then
[ "$VERBOSE" -eq 1 ] && echo "(?) Directory '$d' does not exist. Skipping."
continue
fi
remove_from_path "$d"
PATH="${PATH:+"$PATH:"}$d"
[ "$VERBOSE" -eq 1 ] && echo "Appended '$d' to PATH."
done
export PATH
}
#######################################
# Prepend one or more directories to PATH.
# Directories are processed in reverse order so that the first argument ends up leftmost.
# Globals:
# PATH, VERBOSE
# Arguments:
# One or more directory paths.
# Returns:
# Updates PATH.
#######################################
do_prepend()
{
local processed=""
local d
local -a arr=("$@")
local i
for ((i = ${#arr[@]} - 1; i >= 0; i--)); do
d=$(normalize_dir "${arr[i]}")
if [[ " $processed " == *" $d "* ]]; then
continue
else
processed="$processed $d"
fi
if [ ! -d "$d" ]; then
[ "$VERBOSE" -eq 1 ] && echo "(?) Directory '$d' does not exist. Skipping."
continue
fi
remove_from_path "$d"
PATH="$d${PATH:+":$PATH"}"
[ "$VERBOSE" -eq 1 ] && echo "Prepended '$d' to PATH."
done
export PATH
}
#######################################
# Remove one or more directories from PATH.
# Globals:
# PATH, VERBOSE
# Arguments:
# One or more directory paths.
# Returns:
# Updates PATH.
#######################################
do_remove()
{
local processed=""
local d
for arg in "$@"; do
d=$(normalize_dir "$arg")
if [[ " $processed " == *" $d "* ]]; then
continue
else
processed="$processed $d"
fi
case ":$PATH:" in
*":$d:"*)
remove_from_path "$d"
[ "$VERBOSE" -eq 1 ] && echo "Removed '$d' from PATH."
;;
*)
[ "$VERBOSE" -eq 1 ] && echo "(?) '$d' is not in PATH."
;;
esac
done
export PATH
}
#######################################
# Check the validity of directories.
# If arguments are provided, check those directories; otherwise, check all directories in PATH.
# Globals:
# PATH
# Arguments:
# Zero or more directory paths.
# Returns:
# Outputs the validity status of each directory.
#######################################
do_check()
{
local d
if [ "$#" -eq 0 ]; then
echo "Checking all directories in PATH:"
IFS=':' read -r -a arr <<< "$PATH"
for d in "${arr[@]}"; do
d=$(normalize_dir "$d")
if [ -d "$d" ]; then
echo "Valid: $d"
else
echo "Invalid: $d"
fi
done
else
for arg in "$@"; do
d=$(normalize_dir "$arg")
if [ -d "$d" ]; then
echo "Valid: $d"
else
echo "Invalid: $d"
fi
done
fi
}
#######################################
# Main routine: Parse subcommand and arguments, normalize PATH,
# and dispatch to the appropriate functionality.
#######################################
if [ "$#" -lt 1 ]; then
echo "Usage: $0 <command> <directory1> [<directory2> ...]"
echo "Commands:"
echo " append (or a) - Append directories to PATH"
echo " prepend (or p) - Prepend directories to PATH"
echo " remove - Remove directories from PATH"
echo " check - Check validity of directories (or all in PATH if none given)"
exit 1
fi
cmd="$1"
shift
# Normalize the current PATH variable.
normalize_path_var
case "$cmd" in
append | a)
[ "$#" -ge 1 ] || {
echo "Usage: $0 append <directory1> [<directory2> ...]"
exit 1
}
do_append "$@"
;;
prepend | p)
[ "$#" -ge 1 ] || {
echo "Usage: $0 prepend <directory1> [<directory2> ...]"
exit 1
}
do_prepend "$@"
;;
remove)
[ "$#" -ge 1 ] || {
echo "Usage: $0 remove <directory1> [<directory2> ...]"
exit 1
}
do_remove "$@"
;;
check)
# If no directories are provided, check all directories in PATH.
do_check "$@"
;;
*)
echo "Unknown command: $cmd"
echo "Usage: $0 <command> <directory1> [<directory2> ...]"
exit 1
;;
esac

View File

@@ -1,40 +1,44 @@
#!/usr/bin/env bash
#
# Add a directory to the beginning of the PATH if it's not already there.
# Usage: x-path-append <dir>
# Optimized script to append directories to PATH.
# For each given directory, it removes all duplicate occurrences from PATH
# and then appends it if the directory exists.
#
# Usage: x-path-append <directory1> [<directory2> ...]
#
# Enable verbose output by setting the environment variable VERBOSE=1.
#
# Author: Ismo Vuorinen <https://github.com/ivuorinen> 2024
# License: MIT
# Set verbosity with VERBOSE=1
VERBOSE="${VERBOSE:-0}"
# Function to print messages if VERBOSE is enabled
# $1 - message (string)
msg()
{
[[ "$VERBOSE" -eq 1 ]] && echo "$1"
# Ensure that at least one directory is provided.
[ "$#" -lt 1 ] && {
echo "Usage: $0 <directory> [<directory> ...]"
exit 1
}
if [ "$#" -ne 1 ]; then
echo "Usage: $0 <dir>"
exit 1
fi
for dir in "$@"; do
# Check if the specified directory exists.
if [ ! -d "$dir" ]; then
[ "$VERBOSE" -eq 1 ] && echo "(?) Directory '$dir' does not exist. Skipping."
continue
fi
dir="$1"
# Remove all duplicate occurrences of the directory from PATH.
case ":$PATH:" in
*":$dir:"*)
PATH=":${PATH}:"
PATH="${PATH//:$dir:/:}"
PATH="${PATH#:}"
PATH="${PATH%:}"
[ "$VERBOSE" -eq 1 ] && echo "Removed previous occurrences of '$dir' from PATH."
;;
*) ;;
esac
if echo "$PATH" | grep -qE "(^|:)$dir($|:)"; then
export PATH=$(echo -n "$PATH" | awk -v RS=: -v ORS=: "\$0 != \"$dir\"" | sed 's/:$//')
msg "Directory $dir has been removed from PATH"
else
msg "Directory $dir is not in PATH"
fi
if [ ! -d "$dir" ]; then
msg "(?) Directory $dir does not exist"
exit 0
fi
if echo "$PATH" | grep -qE "(^|:)$dir($|:)"; then
msg "(!) Directory $dir is already in PATH"
else
# Append the directory to PATH.
export PATH="${PATH:+"$PATH:"}$dir"
msg "(!) Directory $dir has been added to the end of PATH"
fi
[ "$VERBOSE" -eq 1 ] && echo "Appended '$dir' to PATH."
done

View File

@@ -1,33 +1,50 @@
#!/usr/bin/env bash
#
# Add a directory to the front of the PATH if it exists and is not already there
# Usage: x-path-prepend <dir>
# Optimized script to batch prepend directories to PATH.
# For each given directory, it removes all duplicate occurrences from PATH
# and then prepends it. Directories that do not exist are skipped.
#
# Usage: x-path-prepend <directory1> [<directory2> ...]
#
# Enable verbose output by setting the environment variable VERBOSE=1.
#
# Author: Ismo Vuorinen <https://github.com/ivuorinen> 2024
# License: MIT
# Set verbosity with VERBOSE=1
VERBOSE="${VERBOSE:-0}"
# Function to print messages if VERBOSE is enabled
# $1 - message (string)
msg()
{
[[ "$VERBOSE" -eq 1 ]] && echo "$1"
# Ensure that at least one argument is provided.
[ "$#" -lt 1 ] && {
echo "Usage: $0 <directory> [<directory> ...]"
exit 1
}
if [ "$#" -ne 1 ]; then
echo "Usage: $0 <dir>"
exit 1
fi
# Save the arguments in an array.
dirs=("$@")
dir="$1"
# Process the directories in reverse order so that the first argument ends up leftmost in PATH.
for ((idx = ${#dirs[@]} - 1; idx >= 0; idx--)); do
dir="${dirs[idx]}"
if [ ! -d "$dir" ]; then
msg "(?) Directory $dir does not exist"
exit 0
fi
# Check if the specified directory exists.
if [ ! -d "$dir" ]; then
[ "$VERBOSE" -eq 1 ] && echo "(?) Directory '$dir' does not exist. Skipping."
continue
fi
if echo "$PATH" | grep -qE "(^|:)$dir($|:)"; then
msg "(!) Directory $dir is already in PATH"
else
# Remove all duplicate occurrences of the directory from PATH using built-in string operations.
case ":$PATH:" in
*":$dir:"*)
PATH=":${PATH}:"
PATH="${PATH//:$dir:/:}"
PATH="${PATH#:}"
PATH="${PATH%:}"
[ "$VERBOSE" -eq 1 ] && echo "Removed duplicate occurrences of '$dir' from PATH."
;;
*) ;;
esac
# Prepend the directory to PATH.
export PATH="$dir${PATH:+":$PATH"}"
msg "(!) Directory $dir has been added to the front of PATH"
fi
[ "$VERBOSE" -eq 1 ] && echo "Prepended '$dir' to PATH."
done

View File

@@ -1,29 +1,41 @@
#!/usr/bin/env bash
#
# Remove a directory from the PATH
# Usage: x-path-remove <dir>
# Optimized script to remove directories from PATH.
# For each specified directory, all occurrences are removed from PATH.
#
# Usage: x-path-remove <directory1> [<directory2> ...]
#
# Enable verbose output by setting the environment variable VERBOSE=1.
#
# Author: Ismo Vuorinen <https://github.com/ivuorinen> 2024
# License: MIT
# Set verbosity with VERBOSE=1
VERBOSE="${VERBOSE:-0}"
# Function to print messages if VERBOSE is enabled
# $1 - message (string)
msg()
{
[[ "$VERBOSE" -eq 1 ]] && echo "$1"
# Ensure that at least one directory is provided.
[ "$#" -lt 1 ] && {
echo "Usage: $0 <directory> [<directory> ...]"
exit 1
}
if [ "$#" -ne 1 ]; then
echo "Usage: $0 <dir>"
exit 1
fi
for dir in "$@"; do
# Remove trailing slash if present, unless the directory is "/"
[ "$dir" != "/" ] && dir="${dir%/}"
dir="$1"
# Check if the directory is present in PATH.
case ":$PATH:" in
*":$dir:"*)
# Remove all occurrences of the directory from PATH using parameter expansion.
PATH=":${PATH}:"
PATH="${PATH//:$dir:/:}"
PATH="${PATH#:}"
PATH="${PATH%:}"
[ "$VERBOSE" -eq 1 ] && echo "Removed '$dir' from PATH."
;;
*)
[ "$VERBOSE" -eq 1 ] && echo "(?) '$dir' is not in PATH."
;;
esac
done
if ! echo "$PATH" | grep -qE "(^|:)$dir($|:)"; then
msg "(?) Directory $dir is not in PATH"
exit 0
fi
export PATH=$(echo -n "$PATH" | awk -v RS=: -v ORS=: "\$0 != \"$dir\"" | sed 's/:$//')
msg "(!) Directory $dir has been removed from PATH"
export PATH

View File

@@ -1,5 +1,6 @@
#!/usr/bin/env php
<?php
/**
* Quota usage
* Show quota usage
@@ -10,6 +11,7 @@
* @license MIT
* @author Ismo Vuorinen <https://github.com/ivuorinen>
*/
error_reporting(E_ALL);
$debug = false;

View File

@@ -1,4 +1,4 @@
#!/usr/bin/env sh
#!/usr/bin/env bash
#
# DESCRIPTION:
# Simple recording tool and wrapper around giph (ffmpeg).

View File

@@ -1,71 +1,137 @@
#!/usr/bin/env bash
# Check which PHP versions are installed with brew, and create aliases for each installation.
# Copyright (c) 2023 Ismo Vuorinen. All Rights Reserved.
# -----------------------------------------------------------------------------
# This script caches the list of PHP installations via Homebrew and generates
# shell aliases for each installation. Both the brew list and the generated
# alias definitions are stored in the XDG cache directory.
#
# If the brew list cache is invalid (older than CACHE_TTL), then both caches are
# regenerated. Otherwise, if only the alias cache is stale, it is regenerated
# from the brew list cache.
#
# Usage:
# source x-set-php-aliases.sh
#
# (C) 2023, 2025 Ismo Vuorinen. All Rights Reserved.
# -----------------------------------------------------------------------------
set -euo pipefail
# Set verbosity with VERBOSE=1 x-set-php-aliases
# Set verbosity level (0 by default; set to 1 or 2 for more detail)
VERBOSE="${VERBOSE:-0}"
# Enable debugging if verbosity is set to 2
[ "$VERBOSE" = "2" ] && set -x
# Check if brew is installed, if not exit.
# Exit early if Homebrew is not installed.
if ! command -v brew &> /dev/null; then
echo "Homebrew is not installed. Exiting."
exit 0
fi
# Function to read installed PHP versions using brew
get_php_versions()
# Determine Homebrew's prefix.
HOMEBREW_PREFIX="${HOMEBREW_PREFIX:-$(brew --prefix)}"
# Determine the XDG cache directory (default to ~/.cache).
XDG_CACHE="${XDG_CACHE_HOME:-$HOME/.cache}"
CACHE_DIR="${XDG_CACHE}/x-set-php-aliases"
mkdir -p "$CACHE_DIR"
# Define cache file paths.
BREW_LIST_CACHE="${CACHE_DIR}/brew_list.cache"
ALIASES_CACHE="${CACHE_DIR}/aliases.cache"
# Cache time-to-live in seconds (here 300 seconds = 5 minutes).
CACHE_TTL=300
# -----------------------------------------------------------------------------
# Function: cache_is_valid
# Returns 0 if the file exists and its modification time is within TTL.
# -----------------------------------------------------------------------------
cache_is_valid()
{
local versions=()
while IFS="" read -r line; do
versions+=("$line")
done < <(bkt -- brew list | grep '^php')
echo "${versions[@]}"
local file="$1"
local ttl="$2"
if [[ -f "$file" ]]; then
local mod_time
if stat --version &> /dev/null; then
mod_time=$(stat -c %Y "$file")
else
mod_time=$(stat -f %m "$file")
fi
local current_time
current_time=$(date +%s)
if ((current_time - mod_time < ttl)); then
return 0
fi
fi
return 1
}
# Function to create aliases for each PHP version
create_aliases()
# -----------------------------------------------------------------------------
# Function: generate_aliases
# Reads PHP formulas (one per line) from the specified file and prints out
# alias definitions for each valid PHP installation.
#
# The following aliases are created (assuming the formula is "php@80"):
#
# p80r : Raw PHP (executable only)
# p80 : PHP with an error reporting flag enabled
# p80s : Launches a PHP local server at localhost:9000
# p80c : Runs composer (if found) using this PHP and error reporting flag
# -----------------------------------------------------------------------------
generate_aliases()
{
local php_versions=("$@")
local brew_file="$1"
local php_error_reporting='-d error_reporting=22527'
local composer_path
composer_path=$(command -v composer 2> /dev/null || true)
for version in "${php_versions[@]}"; do
[ "$VERBOSE" = "1" ] && echo "Setting aliases for $version"
while IFS= read -r version || [[ -n "$version" ]]; do
# Remove any leading/trailing whitespace.
version=$(echo "$version" | xargs)
[[ -z "$version" ]] && continue
# Drop the dot from version (e.g., 8.0 -> 80)
# Compute an alias name: remove dots and replace "php@" with "p"
local php_abbr="${version//\./}"
# Replace "php@" with "p" so "php@80" becomes "p80"
local php_alias="${php_abbr//php@/p}"
# Fetch the exec path once
local php_exec="$HOMEBREW_PREFIX/opt/$version/bin/php"
if [ -f "$php_exec" ]; then
[ "$VERBOSE" = "1" ] && echo "-> php_exec $php_exec"
# Raw PHP without error_reporting flag.
alias "${php_alias}r"="$php_exec"
# PHP with error_reporting flag.
alias "$php_alias"="$php_exec $php_error_reporting"
# Local PHP Server.
alias "${php_alias}s"="$php_exec -S localhost:9000"
# Use composer with specific PHP and error_reporting flag on.
alias "${php_alias}c"="$php_exec $php_error_reporting $(which composer)"
local php_exec="${HOMEBREW_PREFIX}/opt/${version}/bin/php"
if [[ -x "$php_exec" ]]; then
echo "alias ${php_alias}r='$php_exec'"
echo "alias $php_alias='$php_exec $php_error_reporting'"
echo "alias ${php_alias}s='$php_exec -S localhost:9000'"
if [[ -n "$composer_path" ]]; then
echo "alias ${php_alias}c='$php_exec $php_error_reporting $composer_path'"
fi
else
[[ "$VERBOSE" -ge 1 ]] && echo "Executable not found: $php_exec (skipping alias for $version)"
fi
done
done < "$brew_file"
}
# Main function
main()
{
local php_versions
php_versions=($(get_php_versions))
create_aliases "${php_versions[@]}"
}
# -----------------------------------------------------------------------------
# Main Cache Update Logic
#
# If the brew list cache is stale (or missing), regenerate it and the aliases.
# If only the alias cache is stale, regenerate just the alias cache.
# -----------------------------------------------------------------------------
if ! cache_is_valid "$BREW_LIST_CACHE" "$CACHE_TTL"; then
[[ "$VERBOSE" -ge 1 ]] && echo "Brew list cache is stale or missing. Regenerating brew list and aliases."
# Regenerate the brew list cache (filtering only PHP formulas).
brew list | grep '^php' > "$BREW_LIST_CACHE"
# Generate the aliases cache from the new brew list.
generate_aliases "$BREW_LIST_CACHE" > "$ALIASES_CACHE"
else
[[ "$VERBOSE" -ge 1 ]] && echo "Using cached brew list from $BREW_LIST_CACHE."
if ! cache_is_valid "$ALIASES_CACHE" "$CACHE_TTL"; then
[[ "$VERBOSE" -ge 1 ]] && echo "Alias cache is stale or missing. Regenerating aliases."
generate_aliases "$BREW_LIST_CACHE" > "$ALIASES_CACHE"
fi
fi
main "$@"
# Source the cached alias definitions.
if [[ -f "$ALIASES_CACHE" ]]; then
# shellcheck source=/dev/null
source "$ALIASES_CACHE"
[[ "$VERBOSE" -ge 1 ]] && echo "Aliases loaded from cache."
else
[[ "$VERBOSE" -ge 1 ]] && echo "No alias cache found; no aliases were loaded."
fi

View File

@@ -1,78 +1,112 @@
#!/usr/bin/env bash
#
# x-sha256sum-matcher
#
# Check if two files are the same
# Compare two files by computing their SHA256 hashes.
#
# Ismo Vuorinen <https://github.com/ivuorinen> 2023
# MIT License
set -euo pipefail
# ENV Variables
: "${VERBOSE:=0}" # VERBOSE=1 x-sha256sum-matcher file1 file2
# Default settings
VERBOSE=0
# Return sha256sum for file
# $1 - filename (string)
get_sha256sum()
# Print usage/help message
usage()
{
sha256sum "$1" | head -c 64
cat << EOF
Usage: $0 [options] file1 file2
Compare two files by computing their SHA256 hashes.
Options:
-v Enable verbose output.
-h, --help Display this help message and exit.
EOF
}
# Print message if VERBOSE is enabled
# $1 - message (string)
msg()
# Check if a command exists
command_exists()
{
[[ "$VERBOSE" -eq 1 ]] && echo "$1"
command -v "$1" > /dev/null 2>&1
}
# Print error message and exit
# $1 - error message (string)
error()
{
msg "(!) ERROR: $1"
# Ensure sha256sum is available
if ! command_exists sha256sum; then
echo "Error: sha256sum command not found. Please install it." >&2
exit 1
}
fi
# Validate input arguments
validate_inputs()
{
if [ "$#" -ne 2 ]; then
echo "Usage: $0 file1 file2"
# Process command-line options
while [[ $# -gt 0 ]]; do
case "$1" in
-h | --help)
usage
exit 0
;;
-v)
VERBOSE=1
shift
;;
-*)
echo "Error: Unknown option: $1" >&2
usage
exit 1
;;
*)
break
;;
esac
done
# Validate input arguments: expect exactly 2 files
if [[ $# -ne 2 ]]; then
echo "Error: Two file arguments required." >&2
usage
exit 1
fi
file1="$1"
file2="$2"
# Check if files exist and are readable
for file in "$file1" "$file2"; do
if [[ ! -f "$file" ]]; then
echo "Error: File does not exist: $file" >&2
exit 1
elif [[ ! -r "$file" ]]; then
echo "Error: File is not readable: $file" >&2
exit 1
fi
}
done
# Check if file exists
# $1 - filename (string)
check_file_exists()
# Print verbose messages if enabled
msg()
{
local filename=$1
if [ ! -f "$filename" ]; then
error "File does not exist: $filename"
if [[ "$VERBOSE" -eq 1 ]]; then
echo "$1"
fi
}
# Main function
main()
# Compute SHA256 hash for a file using awk to extract the first field
get_sha256sum()
{
local file_1=$1
local file_2=$2
validate_inputs "$file_1" "$file_2"
check_file_exists "$file_1"
check_file_exists "$file_2"
local file_1_hash
local file_2_hash
file_1_hash=$(get_sha256sum "$file_1")
file_2_hash=$(get_sha256sum "$file_2")
if [ "$file_1_hash" != "$file_2_hash" ]; then
error "Files do not match"
else
msg "(*) Success: Files do match"
fi
sha256sum "$1" | awk '{print $1}'
}
main "$@"
msg "Computing SHA256 for '$file1'..."
hash1=$(get_sha256sum "$file1")
msg "SHA256 for '$file1': $hash1"
msg "Computing SHA256 for '$file2'..."
hash2=$(get_sha256sum "$file2")
msg "SHA256 for '$file2': $hash2"
if [[ "$hash1" != "$hash2" ]]; then
echo "Files do not match." >&2
exit 1
else
msg "Success: Files match."
exit 0
fi

View File

@@ -1,69 +1,192 @@
#!/usr/bin/env bash
# Generate thumbnails using ImageMagick (magick)
#
# Generate thumbnails using ImageMagick (magick) with MIME type filtering.
# https://imagemagick.org/script/download.php
#
# Defaults to current directory creating thumbnails with 1000x1000
# dimensions and 200px white borders around the original image.
# This script recursively processes images in a given directory (and its subdirectories)
# by using the `mimetype` command to detect file types. Files with MIME types that are not
# supported by ImageMagick (as defined in the ALLOWED_MIMETYPES array) are skipped.
#
# Defaults can be overridden with ENV variables like this:
# $ THMB_BACKGROUND=black x-thumbgen ~/images/
# Defaults (can be overridden by environment variables or command-line options):
# THUMB_SOURCE: Directory with images (provided as a positional argument)
# THUMB_OUTPUT: Directory to store thumbnails (default: same as THUMB_SOURCE)
# THUMB_BACKGROUND: Background color (default: white)
# THUMB_RESIZE: Resize dimensions (default: 800x800)
# THUMB_EXTENT: Canvas dimensions (default: 1000x1000)
# THUMB_SUFFIX: Suffix appended to filename (default: _thumb)
#
# Created by: Ismo Vuorinen <https://github.com/ivuorinen> 2015
# Options:
# -o output_directory Specify the output directory for thumbnails (default: same as source).
# -s suffix Specify a custom suffix for thumbnail filenames (default: _thumb).
# -h, --help Display this help message and exit.
#
# Example:
# THUMB_BACKGROUND=black x-thumbgen.sh -o ~/thumbnails ~/images/
#
# Author: Ismo Vuorinen <https://github.com/ivuorinen> 2015
# Improved in 2025
set -euo pipefail
# Default values
: "${THMB_SOURCE:=${1:-}}"
: "${THMB_BACKGROUND:=white}"
: "${THMB_RESIZE:=800x800}"
: "${THMB_EXTENT:=1000x1000}"
# Print usage information
usage()
{
echo "Usage: $0 /full/path/to/image/folder"
cat << EOF
Usage: $0 [options] source_directory
Options:
-o output_directory Specify the output directory for thumbnails (default: same as source).
-s suffix Specify a custom suffix for thumbnail filenames (default: _thumb).
-h, --help Display this help message and exit.
EOF
exit 1
}
# Check if ImageMagick is installed
# Default values (can be overridden by ENV variables)
THUMB_SOURCE=""
THUMB_OUTPUT=""
THUMB_BACKGROUND="${THUMB_BACKGROUND:-white}"
THUMB_RESIZE="${THUMB_RESIZE:-800x800}"
THUMB_EXTENT="${THUMB_EXTENT:-1000x1000}"
THUMB_SUFFIX="${THUMB_SUFFIX:-_thumb}"
# List of MIME types supported by ImageMagick (adjust as needed)
ALLOWED_MIMETYPES=("image/jpeg" "image/png" "image/gif" "image/bmp" "image/tiff" "image/webp")
check_magick_installed()
{
if ! command -v magick &> /dev/null; then
echo "magick not found in PATH, https://imagemagick.org/script/download.php"
echo "Error: 'magick' command not found. Please install ImageMagick from https://imagemagick.org/script/download.php" >&2
exit 1
fi
}
# Generate thumbnails
generate_thumbnails()
check_mimetype_installed()
{
local source=$1
magick \
"${source}/*" \
-resize "$THMB_RESIZE" \
-background "$THMB_BACKGROUND" \
-gravity center \
-extent "$THMB_EXTENT" \
-set filename:fname '%t_thumb.%e' +adjoin '%[filename:fname]'
if ! command -v mimetype &> /dev/null; then
echo "Error: 'mimetype' command not found. Please install it (e.g. via 'sudo apt install libfile-mimeinfo-perl' on Debian/Ubuntu)." >&2
exit 1
fi
}
# Main function
main()
# Helper function to check if a given MIME type is allowed
is_supported_mimetype()
{
# Validate input
if [ -z "$THMB_SOURCE" ]; then
local mt=$1
for allowed in "${ALLOWED_MIMETYPES[@]}"; do
if [[ "$mt" == "$allowed" ]]; then
return 0
fi
done
return 1
}
# Parse command-line options using getopts
parse_options()
{
while getopts ":o:s:h-:" opt; do
case $opt in
o)
THUMB_OUTPUT="$OPTARG"
;;
s)
THUMB_SUFFIX="$OPTARG"
;;
h)
usage
;;
-)
if [[ "$OPTARG" == "help" ]]; then
usage
else
echo "Error: Unknown option --$OPTARG" >&2
usage
fi
;;
\?)
echo "Error: Invalid option -$OPTARG" >&2
usage
;;
:)
echo "Error: Option -$OPTARG requires an argument." >&2
usage
;;
esac
done
shift $((OPTIND - 1))
# The remaining argument should be the source directory.
if [ $# -lt 1 ]; then
echo "Error: Source directory is required." >&2
usage
fi
# Check if the source directory is valid
if [ ! -d "$THMB_SOURCE" ]; then
echo "Invalid directory: $THMB_SOURCE"
THUMB_SOURCE="$1"
}
# Generate thumbnails recursively using find and filtering by MIME type
generate_thumbnails()
{
local source_dir=$1
local output_dir=$2
# Ensure the output directory exists (create if necessary)
if [ ! -d "$output_dir" ]; then
mkdir -p "$output_dir"
fi
# Recursively find all files.
while IFS= read -r -d '' file; do
# Use mimetype to determine the file's MIME type.
file_mimetype=$(mimetype -b "$file")
if ! is_supported_mimetype "$file_mimetype"; then
echo "Skipping unsupported MIME type '$file_mimetype' for file: $file" >&2
continue
fi
# Determine the relative path with respect to the source directory.
rel_path="${file#$source_dir/}"
dir="$(dirname "$rel_path")"
base="$(basename "$rel_path")"
filename="${base%.*}"
ext="${base##*.}"
# Create corresponding output subdirectory
out_dir="${output_dir}/${dir}"
mkdir -p "$out_dir"
outfile="${out_dir}/${filename}${THUMB_SUFFIX}.${ext}"
echo "Processing '$file' -> '$outfile'..."
magick "$file" \
-resize "$THUMB_RESIZE" \
-background "$THUMB_BACKGROUND" \
-gravity center \
-extent "$THUMB_EXTENT" \
"$outfile"
done < <(find "$source_dir" -type f -print0)
}
main()
{
parse_options "$@"
if [ -z "$THUMB_SOURCE" ]; then
echo "Error: Source directory not specified." >&2
usage
fi
if [ ! -d "$THUMB_SOURCE" ]; then
echo "Error: Source directory '$THUMB_SOURCE' does not exist or is not accessible." >&2
exit 1
fi
# If output directory is not specified, default to the source directory.
if [ -z "$THUMB_OUTPUT" ]; then
THUMB_OUTPUT="$THUMB_SOURCE"
fi
check_magick_installed
generate_thumbnails "$THMB_SOURCE"
check_mimetype_installed
generate_thumbnails "$THUMB_SOURCE" "$THUMB_OUTPUT"
}
main "$@"

View File

@@ -1,12 +1,92 @@
#!/bin/sh
#
# About
# -----
# Repeat the command until it fails - always run at least once.
# x-until-error: Repeatedly execute a command until it fails (non-zero exit status)
#
# Description:
# This script executes the given command repeatedly until it returns a non-zero
# exit status. It always runs the command at least once.
#
# This script is based on the original work by Steve Kemp.
# Original work Copyright (c) 2013 by Steve Kemp.
#
# The code in the original repository may be modified and distributed under your choice of:
# * The Perl Artistic License (http://dev.perl.org/licenses/artistic.html) or
# * The GNU General Public License, version 2 or later (http://www.gnu.org/licenses/gpl2.txt).
#
# Modifications and enhancements by Ismo Vuorinen on 2025.
#
# Usage:
# x-until-error [--sleep SECONDS] command [arguments...]
#
# Options:
# --sleep SECONDS Wait SECONDS (default: 1) between command executions.
# -h, --help Display this help message.
#
# Example:
# x-until-error --sleep 2 ls -l
"$@"
# Default sleep interval between executions.
SLEEP_INTERVAL=1
# If the status code was zero then repeat.
while [ $? -eq 0 ]; do
"$@"
# Function to display usage information.
usage()
{
cat << EOF
Usage: $0 [--sleep SECONDS] command [arguments...]
Repeats the given command until it fails (returns a non-zero exit status).
Options:
--sleep SECONDS Wait SECONDS (default: 1) between command executions.
-h, --help Display this help message.
Example:
$0 --sleep 2 ls -l
EOF
exit 1
}
# Parse command-line options.
while [ $# -gt 0 ]; do
case "$1" in
--sleep)
shift
if [ $# -eq 0 ]; then
echo "Error: --sleep requires a numeric argument." >&2
exit 1
fi
SLEEP_INTERVAL="$1"
shift
;;
-h | --help)
usage
;;
--) # End of options marker.
shift
break
;;
-*)
echo "Error: Unknown option: $1" >&2
usage
;;
*)
break
;;
esac
done
# Ensure a command is provided.
if [ $# -eq 0 ]; then
echo "Error: No command specified." >&2
usage
fi
# Execute the command repeatedly until it fails.
while true; do
"$@"
status=$?
if [ $status -ne 0 ]; then
exit $status
fi
sleep "$SLEEP_INTERVAL"
done

View File

@@ -1,24 +1,92 @@
#!/bin/sh
#
# About
# -----
# Repeat the command until it succeeds - always run at least once.
# x-until-success: Repeat the command until it succeeds - always run at least once.
#
# This script is based on the original work by Steve Kemp.
# Original work Copyright (c) 2013 by Steve Kemp.
#
# License
# -------
# The code in the original repository may be modified and distributed under your choice of:
# * The Perl Artistic License (http://dev.perl.org/licenses/artistic.html) or
# * The GNU General Public License, version 2 or later (http://www.gnu.org/licenses/gpl2.txt).
#
# Copyright (c) 2013 by Steve Kemp. All rights reserved.
# Modifications and enhancements by Ismo Vuorinen on 2025.
#
# This script is free software; you can redistribute it and/or modify it under
# the same terms as Perl itself.
# Usage:
# x-until-success [--sleep SECONDS] command [arguments...]
#
# The LICENSE file contains the full text of the license.
# Options:
# --sleep SECONDS Wait SECONDS (default: 1) between command executions.
# -h, --help Display this help message.
#
# Example:
# x-until-success --sleep 2 ls -l
# Run the first time.
"$@"
# Default sleep interval between command executions.
SLEEP_INTERVAL=1
# If the status code was not zero then repeat.
while [ $? -ne 0 ]; do
"$@"
# Display usage information.
usage()
{
cat << EOF
Usage: $0 [--sleep SECONDS] command [arguments...]
Repeats the given command until it succeeds (returns a zero exit status).
The command is always executed at least once.
Options:
--sleep SECONDS Wait SECONDS (default: 1) between command executions.
-h, --help Display this help message.
Example:
$0 --sleep 2 ping -c 1 google.com
EOF
exit 1
}
# Parse command-line options.
while [ $# -gt 0 ]; do
case "$1" in
--sleep)
shift
if [ $# -eq 0 ]; then
echo "Error: --sleep requires a numeric argument." >&2
usage
fi
SLEEP_INTERVAL="$1"
shift
;;
-h | --help)
usage
;;
--)
shift
break
;;
-*)
echo "Error: Unknown option: $1" >&2
usage
;;
*)
break
;;
esac
done
# Ensure that a command is provided.
if [ $# -eq 0 ]; then
echo "Error: No command specified." >&2
usage
fi
# Execute the command at least once.
"$@"
status=$?
# If the command did not succeed, repeat until it does.
while [ $status -ne 0 ]; do
sleep "$SLEEP_INTERVAL"
"$@"
status=$?
done
exit $status

View File

@@ -15,7 +15,7 @@ COLOR_P='\033[1;36m'
COLOR_S='\033[0;36m'
RESET='\033[0m'
# Print time-based personalized message, using figlet & lolcat if availible
# Print time-based personalized message, using figlet & lolcat if available
function welcome_greeting()
{
h=$(date +%H)
@@ -51,7 +51,7 @@ function welcome_sysinfo()
fi
}
# Print todays info: Date, IP, weather, etc
# Print today's info: Date, IP, weather, etc
function welcome_today()
{
timeout=1

View File

@@ -1,8 +1,17 @@
#!/bin/sh
#!/usr/bin/env bash
#
# Wait until a given host is down (determined by ping) then execute the
# given command
#
# This script is based on the original work by Steve Kemp.
# Original work Copyright (c) 2013 by Steve Kemp.
#
# The code in the original repository may be modified and distributed under your choice of:
# * The Perl Artistic License (http://dev.perl.org/licenses/artistic.html) or
# * The GNU General Public License, version 2 or later (http://www.gnu.org/licenses/gpl2.txt).
#
# Modifications and enhancements by Ismo Vuorinen on 2025.
#
# Usage:
# ./when-down HOST COMMAND...
#

View File

@@ -1,8 +1,17 @@
#!/bin/sh
#!/usr/bin/env bash
#
# Wait until a given host is online (determined by ping) then execute the
# given command
#
# This script is based on the original work by Steve Kemp.
# Original work Copyright (c) 2013 by Steve Kemp.
#
# The code in the original repository may be modified and distributed under your choice of:
# * The Perl Artistic License (http://dev.perl.org/licenses/artistic.html) or
# * The GNU General Public License, version 2 or later (http://www.gnu.org/licenses/gpl2.txt).
#
# Modifications and enhancements by Ismo Vuorinen on 2025.
#
# Usage:
# ./when-up HOST COMMAND...
#

View File

@@ -9,13 +9,13 @@ $dotfiles_env = getenv("DOTFILES") ?? '~/.dotfiles';
$dest = "$dotfiles_env/docs/aerospace-keybindings.md";
exec("aerospace config --get mode --json", $output);
$output = join(' ', $output);
$output = implode(' ', $output);
$config = json_decode($output, true);
$main = $config['main'];
unset($config['main']);
function process_section(string $title, array $array)
function process_section(string $title, array $array): string
{
$bindings = $array['binding'] ?? [];
ksort($bindings);