PU, short for Posix Utils

Cross-platform POSIX utilities for development workflows.

• Installation
  • NPM
  • Pacman (ArchLinux)
  • APT (Ubuntu)
• Usage
  • pu git-has-changed - Git Changed Detection
  • pu log - Fancy Logging
  • pu tadaa - An overly excited version of pu log success
  • pu install - Cross-Platform Package Installation
• License

Installation

NPM

npm install --save-dev @asd14/posix-utils

Pacman (ArchLinux)

TBD

APT (Ubuntu)

TBD

Usage

pu git-has-changed - Git Changed Detection

Check if a file has changed since a given git commit reference. This tool compares the current state of a file against its state at a specific commit, making it useful for conditional build steps, deployment decisions, and change detection in CI/CD pipelines.

The tool exits with code 0 if the file has changed, making it perfect for use in shell conditionals and npm scripts.

# In npm scripts - regenerate lock only if package.json changed
pu git-has-changed package.json --since HEAD~1 \
    && npm install

# Check against specific version tag
pu git-has-changed src/config.json --since v1.2.0 \
    && npm run rebuild-config

pu log - Fancy Logging

Print dated, colored, namespaced, multi-level, CI aware and pretty formatted log messages. Supports different log levels with automatic filtering and colored output.

Messages include timestamps and can be enhanced with key-value pairs for structured logging.

# Basic logging
pu log info "Build started"
pu log success "Deploy completed"
pu log error "Something went wrong"

# With variables
LOG_NAMESPACE="my-app"
pu log warning "Invalid parameter" \
    -v param-name "username" \
    -v param-value "null"

pu tadaa - An overly excited version of pu log success

Display celebratory "TADAA!" messages with decorative borders, stars, and optional content. Perfect for announcing successful operations, completed builds, or project milestones.

# Simple celebration
pu tadaa

# With title
pu tadaa "Build completed"

# Full celebration with message and note
pu tadaa "Deploy successful" "All services are running" \
    "Check logs for details, file:///var/log/deploy.log"

# Colors automatically disabled when piping or redirecting
pu tadaa "Build finished" | tee build.log

# Force colors even when piping
pu tadaa --color "Deploy completed" | less -R

pu install - Cross-Platform Package Installation

Cross-platform package installer that automatically detects the system package manager and installs the specified packages. Supports major Linux distributions, macOS, and npm packages.

Packages are validated for security (only alphanumeric characters, dots, underscores, hyphens, and plus signs allowed). Package manager flags can be passed after -- separator.

# Auto-detect package manager
pu install git curl jq

# Force specific package manager
pu install --package-manager npm typescript eslint

# Pass flags to package manager
pu install firefox -- --cask

# Install development dependencies
pu install build-essential git nodejs npm

License

MIT