spec approvals

Author: DannyBen

examples/render-mandoc/docs/download.1

@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 3.2
 .\"
-.TH "download" "1" "July 2024" "Version 0.1.0" "Sample application"
+.TH "download" "1" "August 2024" "Version 0.1.0" "Sample application"
 .SH NAME
 \f[B]download\f[R] \- Sample application
 .SH SYNOPSIS

examples/render-mandoc/docs/download.md

@@ -1,6 +1,6 @@
 % download(1) Version 0.1.0 | Sample application
 % Lana Lang
-% July 2024
+% August 2024
 
 NAME
 ==================================================

lib/bashly/script/flag.rb

@@ -1,3 +1,5 @@
+require 'shellwords'
+
 module Bashly
   module Script
     class Flag < Base

spec/approvals/cli/doc/full

@@ -680,6 +680,32 @@ flag.long
 
   See https://bashly.dannyb.co/configuration/flag/#long
 
+flag.needs
+
+  Specify that this flag needs one or more additional flags. Use the long name
+  of these needed flags.
+
+    flags:
+    - long: --add
+      arg: alias
+    
+      # When using --add, --command and --target must also be provided
+      needs: [--command, --target]
+    
+    - long: --command
+      arg: command
+      help: Command for the alias
+      
+      # Note that this relationship is marked on both sides
+      needs: [--add]
+    
+    - long: --target
+      arg: target
+      help: Where to add the alias
+      needs: [--add]
+
+  See https://bashly.dannyb.co/configuration/flag/#needs
+
 flag.private
 
   Specify that this flag should not be displayed in the help text.

spec/approvals/cli/doc/index

@@ -42,6 +42,7 @@ flag.conflicts
 flag.default
 flag.help
 flag.long
+flag.needs
 flag.private
 flag.repeatable
 flag.required

spec/approvals/examples/conflicts

@@ -14,12 +14,15 @@ Usage:
 Options:
   --cache
     Enable cache
+    Conflicts: --no-cache
 
   --no-cache
     Disable cache
+    Conflicts: --cache, --fast
 
   --fast
     Run faster
+    Conflicts: --no-cache
 
   --help, -h
     Show this help

spec/approvals/examples/needs

@@ -14,13 +14,16 @@ Usage:
 Options:
   --add, -a ALIAS
     Alias to add
+    Needs: --command, --target
 
   --command, -c COMMAND
     Command for the alias
+    Needs: --add
 
   --target, -t TARGET
     Where to add the alias
     Allowed: global, local
+    Needs: --add
 
   --help, -h
     Show this help

spec/approvals/examples/render-mandoc

@@ -44,4 +44,4 @@ ISSUE TRACKER
 AUTHORS
        Lana Lang.
 
-Version 0.1.0                      July 2024                       download(1)
+Version 0.1.0                     August 2024                      download(1)

spec/approvals/libraries/render/mandoc/render-1-download.1

@@ -27,4 +27,4 @@ EXAMPLES
 
               download example.com ./output -f
 
-Version 0.1.0                      MONTH YEAR ... APPNAME
+Version 0.1.0                     MONTH YEAR ... APPNAME