streamjoin/fairy

scripts make life easier

Fairy

The shell scripts I ever programmed are just like little fairies who get jobs done magically. May you feel helpful with them.

While the scripts in this repository are more or less application-specific, you may checkout the Fairy-commons repository for common script libraries.

About This Repository

This repository contains submodules as dependencies. Therefore, you should run the following command to get the complete source code:

git clone --recursive https://github.com/streamjoin/fairy.git

When there are updates of the submodules at the remote of this repository, use the following command to pull the changes:

git submodule update --init --recursive

Use the following command to synchronize the submodules with their corresponding remote repositories:

git submodule update --init --remote

Resources

Before looking into the following references, you may consider leveraging the bootstrapping facilities crafted based on my years of experience to initiate your shell programming in a more elegant way.

• Google Shell Style Guide
• Bash Guide for Beginners (by Machtelt Garrels)
• Shell常用招式大全之入门篇
• Best Practices for Writing Bash Scripts (by Kevin van Zonneveld)
• progrium/bashstyle (by Jeff Lindsay)
• Bash Scripting Best Practices (by Yaroslav Tkachenko)
• Bash best practices (by Bert Van Vreckem)

fairy's Issues

Support positional arguments

Need to provide a general approach to support positional arguments in bash scripts.

To achieve this, two key points need to do:

1. Use || to concatenate all arg_set_opt_var entries with the tail to be arg_set_pos_var (TODO). To this end, we need arg_set_opt_var to return non-zero for no value assignment.

2. In arg_set_pos_var, use one global variable __POS_ARG_CURSOR to count the positional index, and assign positional argument value to global variables POS_ARG_VAR_XX where XX is expanded from __POS_ARG_CURSOR.