An open API service indexing awesome lists of open source software.

https://github.com/artbit/bash-clam

Bash package manager
https://github.com/artbit/bash-clam

bash bash-hacks bash-scripting

Last synced: 10 months ago
JSON representation

Bash package manager

Awesome Lists containing this project

README

          

# CLAM
[![GitHub license](https://img.shields.io/github/license/ArtBIT/bash-clam.svg)](https://github.com/ArtBIT/bash-clam) [![GitHub stars](https://img.shields.io/github/stars/ArtBIT/bash-clam.svg)](https://github.com/ArtBIT/bash-clam) [![awesomeness](https://img.shields.io/badge/awesomeness-maximum-red.svg)](https://github.com/ArtBIT/bash-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
```bash
export CLAM_COMMAND_NAME=mollusk
# clam is registered as `mollusk` instead of `clam`
mollusk status
```

# License

[MIT](LICENSE.md)