↓ Skip to main content
Sibling

🏃‍♂️ Usage

·210 words

🆒 Utility commands
#

The sibling introduce the following utility commands.

  • change working directory the sibling directory.
    • cdnext
    • cdprev
    • cdlast
    • cdfirst
    • cdrand
  • list the sibling directory.
    • lsnext
    • lsprev
    • lsfirst
    • lslast
    • lsrand

cdnext and cdprev allow the integer argument to repeat the traversing.

To install the above utility commands into your environment, write the snippet (eval "$(sibling --init bash)") into your .bash_profile, and restart the bash session.

🏃‍♂️ Usage
# 

get next/previous sibling directory name.

Usage: sibling [OPTIONS] [DIR]

Arguments:
  [DIR]  the directory for listing the siblings [default: .]

Options:
  -a, --absolute      print the directory name in the absolute path
  -l, --list          list the sibling directories
  -p, --progress      print the progress of traversing directories
  -P, --parent        print parent directory, when no more sibling directories
  -s, --step <COUNT>  specify the number of times to execute sibling [default: 1]
  -t, --type <TYPE>   specify the nexter type [default: next]
                      [possible values: first, last, previous, next, random, keep]
  -h, --help          Print help
  -V, --version       Print version

sibling prints the next directory name with 0 status code. The next directory is decided by the traversing type. Available values are: next, previous, first, last, keep and random, default is next.

After visiting the final directory, the sibling prints nothing and exits with a non zero status code.