mirror of https://github.com/shadoll/just-commons.git synced 2025-12-20 03:26:43 +00:00

Files

sHa c359858ee9 Replace manual confirmations with [confirm] attribute in destructive commands

- Add [confirm] attribute to all destructive operations:
  - volumes-clean-all, volumes-remove, volumes-remove-pattern
  - postgres-drop-database, postgres-restore
  - mysql-drop-database, mysql-restore
- Remove manual read -p confirmations and conditional logic
- Simplifies code and uses Just's built-in confirmation system
- Ensures consistent confirmation behavior across all destructive operations

This provides better UX and cleaner code using Just's native features.

2025-09-27 01:44:12 +03:00

3.4 KiB

Raw Blame History

Just Commons

Universal Just command recipes for container management across projects.

Overview

This repository contains reusable Just recipes for:

Container operations: start, stop, restart, logs, shell, exec, status
Registry authentication: login, logout, status checks for GitHub Container Registry
Image operations: build, push, pull, tag, test, info, clean
Database operations: PostgreSQL and MySQL database management

Usage

Add as a Git submodule to your project:

git submodule add git@github.com:shadoll/just-commons.git

Import in your justfile:

# Import universal commands
import 'just-commons/core.just'        # Core utilities
import 'just-commons/container.just'   # Container operations
import 'just-commons/registry.just'    # Registry authentication
import 'just-commons/images.just'      # Image operations

# Import database and volume commands (optional)
import 'just-commons/postgres.just'    # PostgreSQL operations
import 'just-commons/mysql.just'       # MySQL operations
import 'just-commons/volumes.just'     # Volume management

Files

Core Files

core.just - Core utilities (_detect_runtime, _detect_compose, env-check)
container.just - Universal container operations (start, stop, logs, shell, exec, status)
registry.just - GitHub Container Registry authentication (registry-login, registry-logout, registry-check)
images.just - Universal image operations (image-build, image-push, image-pull, image-tag, etc.)

Database Files (Optional)

postgres.just - PostgreSQL operations (postgres-sql, postgres-check, postgres-list-databases, etc.)
mysql.just - MySQL operations (mysql-sql, mysql-check, mysql-list-databases, etc.)

Volume Management (Optional)

volumes.just - Volume operations (volumes-clean-all, volumes-remove, volumes-list, etc.)

Command Structure

Container commands: No prefix (start, stop, logs, shell, exec, status, restart)
All other commands: Prefixed by file type (image-, registry-, postgres-, mysql-)

Usage Examples

# Container operations (no prefix)
just start postgres
just logs postgres
just shell postgres

# Image operations (image- prefix)
just image-build postgres
just image-push postgres v1.0.0

# Registry operations (registry- prefix)
just registry-login
just registry-check

# Database operations (database- prefix)
just postgres-sql "SELECT version();"
just postgres-check
just mysql-sql "SELECT VERSION();"

# Volume operations (volumes- prefix)
just volumes-list "myproject_*"
just volumes-clean-all
just volumes-remove "old_volume"

Requirements

Just Command Runner

This library requires Just 1.14.0 or later to support the group attribute for organized command display.

Installation on Ubuntu 24.04 LTS

Method 1: Snap (Recommended for latest version)

sudo snap install just --classic

Method 2: Manual Installation from GitHub

# Get the latest version
JUST_VERSION=$(curl -s "https://api.github.com/repos/casey/just/releases/latest" | grep -Po '"tag_name": "\K[0-9.]+')

# Download and install
wget -qO just.tar.gz "https://github.com/casey/just/releases/latest/download/just-${JUST_VERSION}-x86_64-unknown-linux-musl.tar.gz"
tar -xzf just.tar.gz
sudo mv just /usr/local/bin/
chmod +x /usr/local/bin/just

# Verify installation
just --version

Other Requirements

Docker or Podman
Git

3.4 KiB Raw Blame History