Merge branch 'main' of https://github.com/JordanMarr/FSharp.SystemCommandLine

Author: JordanMarr

README.md

@@ -1,4 +1,4 @@
-### FSharp.SystemCommandLine 
+### FSharp.SystemCommandLine (beta5)
 [![NuGet version (FSharp.SystemCommandLine)](https://img.shields.io/nuget/v/FSharp.SystemCommandLine.svg?style=flat-square)](https://www.nuget.org/packages/FSharp.SystemCommandLine/)
 
 The purpose of this library is to provide quality of life improvements when using the [`System.CommandLine`](https://github.com/dotnet/command-line-api) API in F#.
@@ -7,10 +7,10 @@ _[Click here to view the old beta 4 README](README-beta4.md)_
 
 ## Features
 
-* Mismatches between `inputs` and `setHandler` function parameters are caught at compile time
-* `Input.Option` helper method avoids the need to use the `System.CommandLine.Option` type directly (which conflicts with the F# `Option` type) 
-* `Input.OptionMaybe` and `Input.ArgumentMaybe` methods allow you to use F# `option` types in your handler function.
-* `Input.Context` method allows you to pass the `System.CommandLine.Invocation.InvocationContext` to your handler function.
+* Mismatches between `inputs` and `setAction` handler function parameters are caught at compile time
+* `Input.option` helper avoids the need to use the `System.CommandLine.Option` type directly (which conflicts with the F# `Option` type) 
+* `Input.optionMaybe` and `Input.argumentMaybe` helpers allow you to use F# `option` types in your handler function.
+* `Input.context` helper allows you to pass the `ActionContext` to your action function which is necessary for some operations.
 
 ## Examples
 
@@ -41,7 +41,7 @@ let main argv =
     }
 ```
 
-💥WARNING: You must declare `inputs` before `setHandler` or else the type checking will not work properly and you will get a build error!💥
+💥WARNING: You must declare `inputs` before `setAction` or else the type checking will not work properly and you will get a build error!💥
 
 ```batch
 > unzip.exe "c:\test\stuff.zip"
@@ -52,7 +52,7 @@ let main argv =
 ```
 
 
-_Notice that mismatches between the `setHandler` and the `inputs` are caught as a compile time error:_
+_Notice that mismatches between the `setAction` and the `inputs` are caught as a compile time error:_
 ![fs scl demo](https://user-images.githubusercontent.com/1030435/164288239-e0ff595d-cdb2-47f8-9381-50c89aedd481.gif)
 
 
@@ -84,7 +84,7 @@ let main argv =
             argument "zipfile" |> desc "The file to unzip",
             optionMaybe "--output" |> alias "-o" |> desc "The output directory"
         )
-        setHandler unzip
+        setAction unzip
     }
 ```
 
@@ -119,7 +119,7 @@ let deleteCmd =
         else 
             printfn $"{dir.FullName} does not exist."
 
-    let dir = argument "dir |> desc "The directory to delete"
+    let dir = argument "dir" |> desc "The directory to delete"
     let recursive = option "--recursive" |> def false
 
     command "delete" {
@@ -536,7 +536,7 @@ let main argv =
         commandLineConfiguration {
             description "Appends words together"
             inputs (words, separator)
-            setHandler app
+            setAction app
         }
 
     let parseResult = cfg.Parse(argv)
@@ -571,11 +571,11 @@ let main argv =
     }
 ```
 
-## Customizing the Default Pipeline
+## Command Line Configuration
 
-System.CommandLine has a `CommandLineBuilder` that allows the user to customize various behaviors.
+System.CommandLine has a `CommandLineConfiguration` that allows the user to customize various behaviors.
 
-FSharp.SystemCommandLine is configured to use the built-in defaults (via `CommandLineBuilder().UseDefaults()`), but you can easily override them via the `usePipeline` custom operation which gives you access to the `CommandLineBuilder`. 
+FSharp.SystemCommandLine uses the defaults from `CommandLineConfiguration`, but you can override them via the `configure` custom operation which gives you access to the `CommandLineConfiguration`. 
 
 For example, the default behavior intercepts input strings that start with a "@" character via the "TryReplaceToken" feature. This will cause an issue if you need to accept input that starts with "@". Fortunately, you can disable this via `usePipeline`:
 
@@ -598,7 +598,7 @@ let main argv =
 
     // The package option needs to accept strings that start with "@" symbol.
     // For example, "--package @shoelace-style/shoelace".
-    // To accomplish this, we will need to modify the default pipeline settings below.
+    // To accomplish this, we will need to modify the configuration below.
     let package = option "--package" |> alias "-p" |> desc "A package name that may have a leading '@' character."
 
     rootCommand argv {
@@ -608,11 +608,6 @@ let main argv =
             cfg.ResponseFileTokenReplacer <- null
         )
         inputs package
-        setHandler app
+        setAction app
     }
 ```
-
-As you can see, there are a lot of options that can be configured here (note that you need to `open System.CommandLine.Builder`):
-
-![image](https://user-images.githubusercontent.com/1030435/199282781-1800b79c-7638-4242-8ca0-777d7237e20a.png)
-