Skip to content

Latest commit

 

History

History
76 lines (50 loc) · 1.66 KB

shoe-xl.md

File metadata and controls

76 lines (50 loc) · 1.66 KB

TangoMan Shoe XL

ℹ️ Infos

📑 Description

Create self documented shell scripts with argument validation easily. Prefix a comment with two pound signs on the previous line of any function or variable you want documented with the "help" command. Features: - [X] colors - [X] commands - [X] help - [X] docbloc - [X] parameters - [X] validation - [X] flags - [X] install - [X] autocomplete - [X] generate_doc Warning: Functions and variables names should not contain dashes.

🔥 Usage

sh shoe-xl.sh [command] (--who "World") (--count 1) (--env "dev") (--flag) (--global)

🧱 Constants

  1. ALIAS
  • Script alias
  • Value: shoe
  1. VERSION
  • Constants are ignored (must be uppercase)
  • Value: 0.12.0-xl

🚩 Flags

  1. --flag
  • Enable FooBar mode
  1. --global
  • Install script globally

⚙️ Options

  1. --who
  • Description: Who do you want to say "hello" to ?
  • Constraint: /^[a-zA-Z-]+$/
  • Default: "World"
  1. --count
  • Description: How many times to say hello
  • Constraint: /^[1-9]$/
  • Default: 1
  1. --env
  • Description: Environment
  • Constraint: /^(prod|dev|test)$/
  • Default: "dev"

🤖 Commands

  1. hello
  • Say hello to arbitrary recipient
  1. generate_doc
  • Generate Markdown documentation

⚡ Self Install

  1. self_install
  • Install script and enable completion
  1. self_uninstall
  • Uninstall script from system
  1. self_update
  • Update script from @update-link

⚡ Help

  1. help
  • Print this help (default)