Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yaacov/argparse-sh
argparse.sh contains bash functions that streamlines the management of command-line arguments in Bash scripts
https://github.com/yaacov/argparse-sh
argparse argparser bash bash-script command-line command-line-parser
Last synced: about 2 months ago
JSON representation
argparse.sh contains bash functions that streamlines the management of command-line arguments in Bash scripts
- Host: GitHub
- URL: https://github.com/yaacov/argparse-sh
- Owner: yaacov
- License: mit
- Created: 2023-12-20T15:09:50.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-21T06:11:49.000Z (about 1 year ago)
- Last Synced: 2024-10-14T08:14:43.340Z (3 months ago)
- Topics: argparse, argparser, bash, bash-script, command-line, command-line-parser
- Language: Shell
- Homepage:
- Size: 39.1 KB
- Stars: 11
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# argparse-sh
### Introduction
`argparse.sh` contains bash functions that streamlines the management of command-line arguments in Bash scripts, enhancing the robustness and user-friendliness of your code. Its syntax is intentionally designed to be familiar to those who have experience with argument parsing libraries, providing a smooth and intuitive scripting experience.
### Features
- **Easy Integration**: Simply source `argparse.sh` in your script to start using.
- **Supports Various Argument Types**: Handles required, optional, and boolean flag arguments.
- **Default Values**: Define default values for optional arguments.
- **Automatic Help Generation**: Generates a help message based on defined arguments.
- **Error Handling**: Provides user-friendly error messages for missing or incorrect arguments.
[](https://asciinema.org/a/627909)
### Installation
clone the script repository.
```bash
git clone https://github.com/yaacov/argparse-sh.git
```
You can now source `argparse.sh` in your Bash scripts to leverage its argument parsing capabilities.
```bash
source /path/to/argparse.sh
# Your code here
```
### Usage
#### Defining Arguments with `define_arg`
The `define_arg` function allows you to define a new command-line argument. The syntax is:
```bash
define_arg "arg_name" ["default"] ["help text"] ["action"] ["required"]
```
| Parameter | Description | Optional | Default |
| --- | --- | --- | --- |
| arg_name | Name of the argument | No | |
| default | Default value for the argument | Yes | "" |
| help text | Description of the argument for the help message | Yes | "" |
| action | Type of the argument (string or store_true for flags) | Yes | "string" |
| required | Whether the argument is required (true or false) | Yes | "false" |
#### Setting Script Description with `set_description`
The optional `set_description` function sets a description for your script, which appears at the top of the automatically generated help message. Usage is straightforward:
```bash
set_description "Your script description here"
```
When not set, the help text will show without a description text.
#### Parsing Arguments with `parse_args`
After defining your arguments, use the `parse_args` function to parse the command-line inputs. Simply pass `"$@"` (the array of command-line arguments) to this function:
```bash
parse_args "$@"
```
This function will process the inputs based on the defined arguments and handle errors or help message requests automatically.
### Example
Here's a simple example of a script using argparse.sh:
```bash
#!/bin/bash
# Source the argparse script
source ./argparse.sh
# [Optional] Set script description
set_description "This is a simple script that greets the user."
# Define an argument
define_arg "name" "" "Name of the user" "string" "true"
# [Optional] Check for -h and --help
check_for_help "$@"
# Parse the arguments
parse_args "$@"
# Main script logic
echo "Hello, $name!"
```
Run this script using:
```bash
./yourscript.sh --name Alice
```
### Contributing
We warmly welcome contributions to `argparse.sh`. If you have an idea for an improvement or have spotted an issue, feel free to contribute. Start by forking the repository and cloning your fork to your local machine. Create a new branch for your feature or fix. Once you've made your changes, commit them with a clear and descriptive message. After committing your changes, push them to your fork on GitHub. Finally, submit a pull request from your branch to the main repository. We appreciate your efforts in enhancing `argparse.sh` and look forward to your valuable input!
### License
This project is licensed under the [MIT License](https://github.com/licenses/MIT).