Added the capabillity to set option flags as MANDATORY.

Author: PowerCommands

Docs/Design_command.md

@@ -1,6 +1,6 @@
 # Design your command
 
-Think of your command as an one line command with some parameters in a cmd prompt environment, it should do a small amount of isolated task in a specific context, for example lets say you want to convert yaml file to json or xml. A good name could be **ConvertCommand**, as parameters you have a path to the input file, and a O for the format and a value to that option. That is a pretty good design for one Command. 
+Think of your command as an one line command with some parameters in a cmd prompt environment, it should do a small amount of isolated task in a specific context, for example lets say you want to convert yaml file to json or xml. A good name could be **ConvertCommand**, as parameters you have a path to the input file, and an option flag for the format and a value to that option. That is a pretty good design for one Command. 
 
  The usage of this command will look like this if I want to convert my yaml fil to json.
 
@@ -36,12 +36,17 @@ public class ConvertCommand : CommandBase<PowerCommandsConfiguration>
     }
 }
 ```
-Notice that the documentation for how this command will be used is created with the [PowerCommandDesign](PowerCommandDesignAttribute.md) attribute. I realize that the path option should be required, I can of course code this check in the Command but I do not need to do that, instead I declare that with the [PowerCommandDesign](PowerCommandDesignAttribute.md) attribute, I just add a **!** before the path option, this will be validated before the execution of the run command. The new design look like this.
+## Validation of mandatory option and value
+Notice that the documentation for how this command will be used is created with the [PowerCommandDesign](PowerCommandDesignAttribute.md) attribute. I realize that the path option should be both **mandatory** and must have a value, I can of course add code to do this check in the Command but I do not need to do that, instead I declare that with the [PowerCommandDesign](PowerCommandDesignAttribute.md) attribute, I just add a **!** before the path option, this will be validated before the execution of the run command. I also spell the option name in UPPERCASE letters which does the option **mandatory**.
+
+The new design look like this.
 ```
 [PowerCommandDesign(  description: "Converting yaml format to json or xml format",
-                            options: "!path|format",
+                          options: "!PATH|format",
                           example: "//Convert to json format|convert --path \"c:\\temp\\test.yaml\" --format json|//Convert to xml format|convert --path \"c:\\temp\\test.yaml\" --format xml")]
 ```                     
+Have a closer look at the !PATH option, it starts with a **!** and it consists of upperletter cases only **PATH**, with the use of the **!** sympol the option must have a value. With the use of uppercase letter the option it self is **mandatory**.  
+
 If I run the command empty I trigger a validation error.
 
 ![Alt text](images/convert_validation_error.png?raw=true "Describe convert command")

Docs/Options.md

@@ -1,6 +1,7 @@
 # Options
 
 Options is what the name implies, options for your command, lets have a look at this example below.
+
 ![Alt text](images/power_command_attribute.png?raw=true "Attributes")
 
 You could also se that this Command has two options separated with pipe **"path|format"**, first one named **path** and the other one is **format**. This will give the user autocomplete feedback when typing - and using the [Tab] tangent.
@@ -17,6 +18,18 @@ Sometimes you just want a option without a value, you can solve that like this:
 
 ``` var encrypt = input.HasOption("encrypt"); ```
 
+## Validation of mandatory option and value
+The option can trigger validation of **required value** and/or **mandatory** meaning the option is not optional. 
+
+- A starting **!** means that the option must have a value if the user adds it to the input, but it is still optional.
+- UPPERCASE option name means that the option must be included by the user input, but value is not required unless the option starts with the **!** symbol.
+
+The example below shows how the path option is both mandatory an requires a value.
+```
+[PowerCommandDesign(  description: "Converting yaml format to json or xml format",
+                          options: "!PATH|format",
+                          example: "//Convert to json format|convert --path \"c:\\temp\\test.yaml\" --format json|//Convert to xml format|convert --path \"c:\\temp\\test.yaml\" --format xml")]
+```
 ## The CommandBase class holds a list of the declared options with the input value
 That is another way to programatically work with the options.
 

Templates/PowerCommands.zip

@@ -79,7 +79,7 @@ public virtual void RunCompleted()
 
     #region Write helpers
     public void Write(string output, ConsoleColor? color = null) => _console.Write(GetType().Name, output, color);
-    public void WriteLine(string output) => _console.WriteLine(GetType().Name, output, null);
+    public void WriteLine(string output) => _console.WriteLine(GetType().Name, output);
     /// <summary>
     /// Could be use when passing the method to shell execute and you need to get back what was written and you do not want that in a logfile (a secret for example)
     /// </summary>

Templates/src/Core/PainKiller.PowerCommands.Core/BASECLASSES/CommandBase.cs

@@ -22,7 +22,7 @@ public void ShowDoc()
         var docSearch = Input.HasOption("docs") ? Input.GetOptionValue("docs").ToLower() : Input.SingleArgument.ToLower();
         var docs = StorageService<DocsDB>.Service.GetObject().Docs;
         var matchDocs = docs.Where(d => d.DocID.ToString().PadLeft(4, '0') == docSearch || d.Name.ToLower().Contains(docSearch) || d.Tags.ToLower().Contains(docSearch)).ToArray();
-        if (matchDocs.Length == 1)
+        if (matchDocs.Length == 1 || matchDocs.Select(d => d.DocID).Distinct().Count() == 1)
         {
             ShellService.Service.OpenWithDefaultProgram(matchDocs.First().Uri);
             return;

Templates/src/Core/PainKiller.PowerCommands.Core/COMMANDS/DescribeCommand.cs

@@ -30,11 +30,15 @@ public InputValidationResult ValidateAndInitialize()
         var optionInfos = attribute.Options.Split('|').Select(f => new PowerOption(f)).ToList();
         retVal.Options.AddRange(optionInfos);
 
-        foreach (var optionInfo in optionInfos.Where(f => f.IsRequired))
+        foreach (var optionInfo in optionInfos.Where(f => f.ValueIsRequired || f.IsMandatory))
         {
+            if (optionInfo.IsMandatory && !_input.HasOption(optionInfo.Name))
+            {
+                retVal.HasValidationError = true;
+                _logger.Invoke($"Option [{optionInfo.Name}] is mandatory");
+            }
             optionInfo.Value = _input.GetOptionValue(optionInfo.Name);
-
-            if (!string.IsNullOrEmpty(optionInfo.Value) || !_input.HasOption(optionInfo.Name)) continue;
+            if (!string.IsNullOrEmpty(optionInfo.Value) || !_input.HasOption(optionInfo.Name) || !optionInfo.ValueIsRequired) continue;
             _logger.Invoke($"Option [{optionInfo.Name}] is required to have a value or not used at all.");
             retVal.HasValidationError = true;
         }
@@ -43,18 +47,10 @@ public InputValidationResult ValidateAndInitialize()
         var requiredSecrets = attribute.Secrets.Split('|').Where(s => s.StartsWith('!')).ToArray();
         foreach (var secretName in requiredSecrets)
         {
-            if (IPowerCommandServices.DefaultInstance!.Configuration.Secret.Secrets == null)
-            {
-                _logger.Invoke($"Secret [{secretName}] is required");
-                retVal.HasValidationError = true;
-                break;
-            }
             var secret = IPowerCommandServices.DefaultInstance!.Configuration.Secret.Secrets.FirstOrDefault(s => s.Name.ToLower() == secretName.Replace("!","").ToLower());
-            if (secret == null)
-            {
-                _logger.Invoke($"Secret [{secretName.Replace("!","")}] is required");
-                retVal.HasValidationError = true;
-            }
+            if (secret != null) continue;
+            _logger.Invoke($"Secret [{secretName.Replace("!","")}] is required");
+            retVal.HasValidationError = true;
         }
         return retVal;
     }

Templates/src/Core/PainKiller.PowerCommands.Core/MANAGERS/InputValidationManager.cs

@@ -14,4 +14,10 @@
 		<ProjectReference Include="..\PainKiller.PowerCommands.Shared\PainKiller.PowerCommands.Shared.csproj" />
 	</ItemGroup>
 
+	<ItemGroup>
+	  <None Update="DocsDB.data">
+	    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+	  </None>
+	</ItemGroup>
+
 </Project>

Templates/src/Core/PainKiller.PowerCommands.Core/PainKiller.PowerCommands.Core.csproj

@@ -1,14 +1,18 @@
-namespace $safeprojectname$.DomainObjects.Core;
+using $safeprojectname$.Extensions;
+
+namespace $safeprojectname$.DomainObjects.Core;
 
 public class PowerOption
 {
     public PowerOption(string attributeValue)
     {
-        IsRequired = attributeValue.StartsWith("!");
+        IsMandatory = attributeValue.Replace("!", "").IsUppercaseOnly();
+        ValueIsRequired = attributeValue.StartsWith("!");
         Name = attributeValue.Replace("!", "");
     }
     public string Name { get; set; }
     public string Value { get; set; } = "";
     public string Raw => $"--{Name}";
-    public bool IsRequired { get; set; }
+    public bool ValueIsRequired { get; set; }
+    public bool IsMandatory { get; set; }
 }

Templates/src/Core/PainKiller.PowerCommands.Shared/DOMAINOBJECTS/CORE/PowerOption.cs

@@ -18,4 +18,5 @@ public static string ToOptionDescription(this string option)
     }
     public static string RemoveHtml(this string content) => Regex.Replace($"{content}", @"<[^>]*>", String.Empty);
     public static List<string> ExtractLinks(this string content) => new Regex("http(s)?://([\\w+?\\.\\w+])+([a-zA-Z0-9\\~\\!\\@\\#\\$\\%\\^\\&amp;\\*\\(\\)_\\-\\=\\+\\\\\\/\\?\\.\\:\\;\\'\\,]*)?", RegexOptions.IgnoreCase).Matches(content).Select(m => m.Value).ToList();
+    public static bool IsUppercaseOnly(this string input) => new Regex("^[A-Z]+$").IsMatch(input);
 }

Templates/src/Core/PainKiller.PowerCommands.Shared/EXTENSIONS/StringExtensions.cs

@@ -15,9 +15,11 @@
 		<ProjectReference Include="..\Core\PainKiller.PowerCommands.Shared\PainKiller.PowerCommands.Shared.csproj" />
 		<ProjectReference Include="..\$ext_projectname$Commands\$ext_projectname$Commands.csproj" />
 	</ItemGroup>
-
 	<ItemGroup>
 		<Folder Include="Extensions\" />
 	</ItemGroup>
-
+	<ItemGroup>
+		<ProjectCapability Include="ConfigurableFileNesting" />
+		<ProjectCapability Include="ConfigurableFileNestingFeatureEnabled" />
+	</ItemGroup>
 </Project>