CLAM

CLAM

CLAM is a recursive acronym for "CLAM, Load A Module". CLAM is a simple package manager for Bash shell which helps you install and manage shell scripts and rc files from GitHub.

Installation

git clone https://github.com/ArtBIT/bash-clam.git
source path/to/clam/init

Usage

Install a GitHub module and make one of its scripts executable

clam GitUsername/git-repo --exe some_script_from_that_repo
# some_script_from_that_repo is now an executable command

Install a GitHub module and source one of its scripts automatically

clam GitUsername/git-repo --source some_script_from_that_repo
# some_script_from_that_repo will now be sourced every time bash-clam is sourced

Run a GitHub project file directly

clam run https://github.com/ArtBIT/bash-tint/src/tint  "Running test: bold(%s) %s" "Test XYZ" "green([OK])"
# this would clone the project from github and run the file
#   - git clone https://github.com/ArtBIT/bash-tint into $HOME/.config/clam/clam_modules 
#   - bash $HOME/.config/clam/clam_modules/artbit_bash-tint "Running test: bold(%s) %s" "Test XYZ" "green([OK])"


# You can also omit the github origin (protocol + domain) altogether and just use the github URI
clam run ArtBIT/bash-oembed/oembed https://youtu.be/dQw4w9WgXcQ

Environment

export CLAM_COMMAND_NAME=mollusk
# clam is registered as `mollusk` instead of `clam`
mollusk status

License

MIT