Welcome to the shFlags wiki!

shFlags is a port of the Google gflags library for Unix shell. The code is written in a way to be as portable as possible to work across a wide array of Unix variants. It is also tested with shUnit2 to maintain code quality.

If you'd like to get started with shFlags, feel free to read the documentation.

Overview

shFlags is a Unix shell library to simplify the handling of command-line flags.

Tested Operating Systems

shFlags is tested on the following OSes using the Travis CI continuous integration framework.

• Ubuntu Linux -- 18.04 LTS, 16.04 LTS, 14.04 LTS
• macOS 13 (Ventura)

Tested Shells

Command	Description
ash	Ash (BusyBox ash shell)
bash	BASH (GNU Bourne Again SHell)
dash	DASH
ksh	Korn Shell
mksh	MirBSD Korn Shell
pdksh	pdksh (the Public Domain Korn Shell)
sh	Bourne Shell on Linux, or DASH shell on macOS.
zsh	Zsh

Development and testing of shFlags was done by Kate Ward. See http://forestent.com/ for more info.

Downloading

Recent releases

Recent releases are available at https://github.com/kward/shflags/releases.

The most recent code is always available at https://github.com/kward/shflags.

All releases

The 1.0.x and 1.2.x release series are stable releases. The 1.1.x series (skipped) and 1.3.x release series are development releases.

Release	Date
1.3.0	Aug 24 2023
1.2.3	Jan 25 2018
1.2.2	Oct 18 2017
1.2.1	Aug 17 2017
1.2.0	Jan 10 2016
1.0.3	May 10 2009
1.0.2	Nov 17 2008
1.0.1	Jul 11 2008
1.0.0	Jun 18 2008

Miscellaneous

Licensing

shFlags is licensed under Apache v2.0. The contents and copyright of this site and all provided source code are owned by Kate Ward.

Full disclosure

Although I am currently an employee of Google Switzerland, the shflags port of gflags is not meant to reflect in any way on the work I do for Google, nor is this a work product of Google. This software is not supported or endorsed by Google, and they should not be contacted for any problems you encounter with this product.