Version 1.0.2.0

Author: PowerCommands

Docs/DialogService.md

@@ -0,0 +1,56 @@
+# DialogServices
+
+The **DialogService** contains some static helper for you to present dialogs 
+
+## ListDialog
+
+The ```ListDialog``` is an easy way to let the user select items from a list of strings.
+
+https://github.com/PowerCommands/PowerCommands2022/assets/102176789/10945ee0-947d-4af3-aef5-27ad8ff6be4b
+
+```
+[PowerCommandDesign( description: "A demo of the DialogService.List.",
+                         example: "list")]
+public class ListCommand : CommandBase<PowerCommandsConfiguration>
+{
+    public ListCommand(string identifier, PowerCommandsConfiguration configuration) : base(identifier, configuration) { }
+
+    public override RunResult Run()
+    {
+        var selectedItems = DialogService.ListDialog("Which teams participated in the Stanley Cup final season 2022/23?", new() { "New York Rangers", "Colorado Avalanche", "Vegas Knights", "Pittsburgh Penguins", "Florida Panthers", "Detroit Red Wings", "Toronto Maple Leafs" });
+        WriteHeadLine("You selected");
+        foreach (var item in selectedItems) WriteLine(item);
+        if (selectedItems.Count == 2 && selectedItems.Any(t => t == "Vegas Knights") && selectedItems.Any(t => t == "Florida Panthers"))
+        {
+            WriteSuccessLine("\nYour absolutely right, and Vegas Knights won the Stanley Cup title!");
+        }
+        else
+        {
+            WriteFailureLine("\nIncorrect, the participants in the final was Vegas Knights Vs Florida Panthers and Vegas won the Stanley Cup title!");
+        }
+        return Ok();
+    }
+}
+```
+## SecretPromptDialog
+The ```SecretPromptDialog``` is a helper dialog to collect password, tokens or other sensitive stuff. The input is masked, the user must confirm the secret, and the secret is not logged to the log file. 
+It is very simple to use, just like this.
+```
+var password = DialogService.SecretPromptDialog("Enter secret:");
+```
+
+## QuestionAnswerDialog and YesNoDialog
+This dialog either prompt a question and returns the answer as an string or with the ```YesNoDialog``` prompts a question and returns a bool.
+
+
+
+
+Read more about:
+
+[Design your Command](Design_command.md)
+
+[Input](Input.md)
+
+[PowerCommands Attribute](PowerCommandAttribute.md)
+
+[Back to start](https://github.com/PowerCommands/PowerCommands2022/blob/main/Docs/README.md)

Docs/Input.md

@@ -56,6 +56,8 @@ The path is a special value if your command only should have an input that is a
 
 Read more about:
 
+[Dialog services](DialogService.md)
+
 [Design your Command](Design_command.md)
 
 [Options](Options.md)

Docs/images/VS_solution_option.png

@@ -35,6 +35,10 @@ https://github.com/PowerCommands/PowerCommands2022/assets/102176789/d8ad92f0-93a
 
 [Handling the Input](Docs/Input.md)
 
+[Dialog services](Docs/DialogService.md)
+
+https://github.com/PowerCommands/PowerCommands2022/assets/102176789/10945ee0-947d-4af3-aef5-27ad8ff6be4b
+
 [Using Options](Docs/Options.md)
 
 [Simple automated test](Docs/Test.md)

README.md

@@ -8,9 +8,19 @@ Copy the .zip file into the user project template directory. By default, this di
 
 Open Visual Studio and write Power in the searchbox, you should find the PowerCommand template.
 
+I recommend you to use the option ```Place solution in the same directory``` some experimental features for update and create commands using a template the Core depends on that.
+
+![Alt text](../Docs/images/VS_solution_option.png?raw=true "Command Base")
+
 
 # What is new?
 
+**Released 2023-06-30**
+- Toolbar functionality moved to own ```ToolbarService``` and reworked it completely, not using timers anymore that caused problems, so it is now a more stable feature (but still a bit experimental).
+- Added PasswordPromptDialog to the ```DialogService```.
+- New List feature, display a list which selectable items.
+- ```DirCommand``` is now a Core command instead of a Demo command.
+- It is now possible to move the cursor up and down with ```CTRL``` + (```⬆️```  or ⬇️).
 ## Version 1.0.1.0
 **Released 2023-06-20**
 ### Toolbar styled Commands

Templates/PowerCommands.zip

@@ -1,15 +1,15 @@
 using PainKiller.PowerCommands.ReadLine;
 using PainKiller.PowerCommands.ReadLine.Events;
-using System.Timers;
 
 namespace $safeprojectname$.BaseClasses
 {
     public abstract class CommandWithToolbarBase<TConfig> : CommandBase<TConfig> where TConfig : new()
     {
         protected string LatestHighlightedCommand = string.Empty;
-        private readonly System.Timers.Timer _overflowTimer;
+        
+        private bool _toolbarIsInitialized;
         private readonly bool _autoShowToolbar;
-        private readonly ConsoleColor[]? _colors;
+        private ConsoleColor[]? _colors;
         protected List<string> Labels = new();
         protected PowerCommandsToolbarAttribute? ToolbarAttribute;
         protected CommandWithToolbarBase(string identifier, TConfig configuration, bool autoShowToolbar = true, ConsoleColor[]? colors = null) : base(identifier, configuration)
@@ -18,47 +18,41 @@ protected CommandWithToolbarBase(string identifier, TConfig configuration, bool
             _colors = colors;
             ReadLineService.CommandHighlighted += ReadLineService_CommandHighlighted;
             ToolbarAttribute = this.GetToolbarAttribute();
-            var overflowMilliseconds = ToolbarAttribute?.Timer ?? 500;
-            _overflowTimer = new System.Timers.Timer(Math.Clamp(overflowMilliseconds, 500, 5000));
-            ReadLineService.CmdLineTextChanged += ReadLineService_CmdLineTextChanged;
-        }
-        protected virtual void ReadLineService_CmdLineTextChanged(object? sender, CmdLineTextChangedArgs e)
-        {
-            if (!e.CmdText.StartsWith(Identifier) && LatestHighlightedCommand == Identifier) ClearToolbar();
         }
+        
         public override RunResult Run()
         {
-            ClearToolbar();
             return Ok();
         }
-        protected void ReadLineService_CommandHighlighted(object? sender, CommandHighlightedArgs e)
+
+        public override void RunCompleted()
+        {
+            ToolbarService.ClearToolbar();
+            base.RunCompleted();
+        }
+
+        protected virtual void ReadLineService_CommandHighlighted(object? sender, CommandHighlightedArgs e)
         {
             LatestHighlightedCommand = e.CommandName;
             if (e.CommandName != Identifier) return;
-            if (_autoShowToolbar)
-            {
-                _overflowTimer.Elapsed += InitializeToolbar;
-                _overflowTimer.AutoReset = true;
-                _overflowTimer.Enabled = true;
-            }
+            if (_autoShowToolbar) DrawToolbar();
         }
-        private void InitializeToolbar(object? sender, ElapsedEventArgs e)
+        private void InitializeToolbar()
         {
             var attribute = this.GetPowerCommandAttribute();
             var suggestions = ToolbarAttribute == null ? Labels.ToList() : ToolbarAttribute.Labels.Split(ConfigurationGlobals.ArraySplitter).ToList();
             if (suggestions.Count == 0) suggestions.AddRange(attribute.Suggestions.Split(ConfigurationGlobals.ArraySplitter));
             if (suggestions.Count == 0) return;
             Labels.Clear();
             Labels.AddRange(suggestions);
-            DrawToolbar();
+            var attributeToolbar = this.GetToolbarAttribute();
+            if (attributeToolbar != null) _colors = attributeToolbar.Colors;
+            _toolbarIsInitialized = true;
         }
         protected void DrawToolbar()
         {
-            DialogService.DrawToolbar(Labels.ToArray(), _colors);
-
-            _overflowTimer.Elapsed -= InitializeToolbar;
-            _overflowTimer.Stop();
+            if(!_toolbarIsInitialized) InitializeToolbar();
+            ToolbarService.DrawToolbar(Labels.ToArray(), _colors);
         }
-        protected void ClearToolbar() => DialogService.ClearToolbar(Labels.ToArray());
     }
 }

Templates/README.md

@@ -1,6 +1,4 @@
-using PainKiller.PowerCommands.Core.Commands;
-
-namespace PainKiller.PowerCommands.MyExampleCommands.Commands;
+namespace $safeprojectname$.Commands;
 
 [PowerCommandDesign(description: "List the content of the working directory or this applications app directory, with the option to open the directory with the File explorer ",
     options: "open|app",

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

@@ -75,17 +75,9 @@ private RunResult Get()
     private RunResult Create()
     {
         var name = Input.SingleQuote;
-        Console.Write("Enter secret: ");
-        var password = PasswordPromptService.Service.ReadPassword();
-        Console.WriteLine();
-        Console.Write("Confirm secret: ");
-        var passwordConfirm = PasswordPromptService.Service.ReadPassword();
-
-        if (password != passwordConfirm)
-        {
-            Console.WriteLine();
-            return BadParameterError("Passwords do not match");
-        }
+        var password = DialogService.SecretPromptDialog("Enter secret:");
+        if (string.IsNullOrEmpty(password)) return BadParameterError("Passwords do not match");
+        
         var secret = new SecretItemConfiguration { Name = name };
         var val = SecretService.Service.SetSecret(name, password, secret.Options, EncryptionService.Service.EncryptString);
 

…MyExampleCommands/Commands/DirCommand.cs …owerCommands.Core/COMMANDS/DirCommand.cssrc/PainKiller.PowerCommands/PainKiller.PowerCommands.MyExampleCommands/Commands/DirCommand.cs renamed to Templates/src/Core/PainKiller.PowerCommands.Core/COMMANDS/DirCommand.cs src/PainKiller.PowerCommands/PainKiller.PowerCommands.MyExampleCommands/Commands/DirCommand.cs renamed to Templates/src/Core/PainKiller.PowerCommands.Core/COMMANDS/DirCommand.cs

@@ -16,7 +16,6 @@
   </TemplateData>
   <TemplateContent>
     <Project TargetFileName="PainKiller.PowerCommands.Core.csproj" File="PainKiller.PowerCommands.Core.csproj" ReplaceParameters="true">
-      <Folder Name="Properties" TargetFolderName="Properties" />
       <Folder Name="BaseClasses" TargetFolderName="BaseClasses">
         <ProjectItem ReplaceParameters="true" TargetFileName="CommandBase.cs">CommandBase.cs</ProjectItem>
         <ProjectItem ReplaceParameters="true" TargetFileName="CommandWithToolbarBase.cs">CommandWithToolbarBase.cs</ProjectItem>
@@ -30,6 +29,7 @@
         <ProjectItem ReplaceParameters="true" TargetFileName="CommandTemplate.cs">CommandTemplate.cs</ProjectItem>
         <ProjectItem ReplaceParameters="true" TargetFileName="CommandUpdate.cs">CommandUpdate.cs</ProjectItem>
         <ProjectItem ReplaceParameters="true" TargetFileName="DescribeCommand.cs">DescribeCommand.cs</ProjectItem>
+        <ProjectItem ReplaceParameters="true" TargetFileName="DirCommand.cs">DirCommand.cs</ProjectItem>
         <ProjectItem ReplaceParameters="true" TargetFileName="ExitCommand.cs">ExitCommand.cs</ProjectItem>
         <ProjectItem ReplaceParameters="true" TargetFileName="LogCommand.cs">LogCommand.cs</ProjectItem>
         <ProjectItem ReplaceParameters="true" TargetFileName="MasterCommando.cs">MasterCommando.cs</ProjectItem>
@@ -72,6 +72,7 @@
         <ProjectItem ReplaceParameters="true" TargetFileName="ReflectionService.cs">ReflectionService.cs</ProjectItem>
         <ProjectItem ReplaceParameters="true" TargetFileName="ShellService.cs">ShellService.cs</ProjectItem>
         <ProjectItem ReplaceParameters="true" TargetFileName="StorageService.cs">StorageService.cs</ProjectItem>
+        <ProjectItem ReplaceParameters="true" TargetFileName="ToolbarService.cs">ToolbarService.cs</ProjectItem>
         <ProjectItem ReplaceParameters="true" TargetFileName="ZipService.cs">ZipService.cs</ProjectItem>
       </Folder>
       <ProjectItem ReplaceParameters="false" TargetFileName="DocsDB.data">DocsDB.data</ProjectItem>