Version 1.0.3.1

Author: PowerCommands

Docs/Job.md

@@ -14,12 +14,25 @@ Your PowerCommands application may of course have so other name and your command
 "powercommands.exe job argument1"
 ```
 
+## What if the command you want to run just once is not designed to quit?
+If the command inherits from the CommandBase class, which most if not all Commands are, you can use the option `--pc_force_quit` to quit the application after the command is finished. If the command is running as async, this could cause unexpected behavior, be aware of that.
+
 ## Run PowerCommand with a service account and use secrets
-If you want to run your PowerCommands application as a Windows scheduled task started by a service accounts that is not allowed to login on the machine, you need to do a couple of steps.
+If you want to run your PowerCommands application as a Windows scheduled task started by a service accounts that is not allowed to login on the machine, you need to do a couple of steps to make sure that the service account user can use the decryption functionality.
+The easy way is to delete the setup.yaml file in the application folder and start your Power Command application again, this will guide you through the setup.
+
+- First answer `y` to the question if you want to setup encryption.
+- Answer `y` to the question that you intend to run your application using a service account.
+- Last you need to update the `PowerCommandsConfiguration.yaml` file with the encryption element.
 
-- You need to copy the PainKiller directory from your %User%\AppData\Roaming to the corresponding one for the service account. 
-- Copy the environment variable _encryptionManager and create the same as a system environment variable. EncryptionService will look for the system environment variable if the user environment variable is not there. 
-- For your stored secrets you will need to to do the same thing and change target: User to target: Machine in the **PowerCommandsConfiguration.yaml** file.
+It could look something like this:
+```
+encryption:
+  sharedSecretEnvironmentKey: '_encryptionManager'
+  sharedSecretSalt: WJtOL/ZgbHwVhbL76JGFyA==
+  iterationCount: 10000
+  keySize: 256
+```
 
 Read more about:
 

PC_Nov_2023_src.zip

@@ -3,7 +3,15 @@ You could see PowerCommands as your CLI application starter kit. It is a structu
 
 [Follow progress on twitter](https://twitter.com/PowerCommands) <img src="https://github.com/PowerCommands/PowerCommands2022/blob/main/Docs/images/Twitter.png?raw=true" alt="drawing" width="20"/>
 
-**Latest release 2023-11-18**
+## Version 1.0.3.1
+**Released 2023-11-30**
+- Adjusted the Power Command to use be run with a service account and use encryption, update the setup to reflect this.
+- Added general option --pc_force_quit in CommandBase to be used with any command to force application to quit.
+- Improved encryption
+- Bug fix DialogService.ListDialog now handles 0 input more gracefully
+- Bug fix CommandBase now return RunResultStatus.Quit when using Quit()
+
+**Release 2023-11-18**
 - Updated to .NET 8
 - Using C# 12
 - Updated YamlDotNet to current latest stable version

README.md

@@ -16,6 +16,13 @@ I recommend you to use the option ```Place solution in the same directory``` som
 ![Alt text](../Docs/images/VS_solution_option.png?raw=true "Command Base")
 
 # What is new?
+## Version 1.0.3.1
+**Released 2023-11-30**
+- Adjusted the Power Command to use be run with a service account and use encryption, update the setup to reflect this.
+- Added general option --pc_force_quit in CommandBase to be used with any command to force application to quit.
+- Improved encryption
+- Bug fix DialogService.ListDialog now handles 0 input more gracefully
+- Bug fix CommandBase now return RunResultStatus.Quit when using Quit()
 ## Version 1.0.3.0
 **Released 2023-11-18**
 - Updated to .NET 8

Templates/PowerCommands.zip

@@ -8,4 +8,5 @@ public interface IConfigurationService
     string SaveChanges<T>(T configuration, string inputFileName = "") where T : new();
     void Create<T>(T configuration, string fullFileName) where T : new();
     YamlContainer<T> GetAppDataConfiguration<T>(string inputFileName = "") where T : new();
+    YamlContainer<T> GetByNodeName<T>(string filePath, string nodeName) where T : new();
 }

Templates/README.md

@@ -1,4 +1,5 @@
-using $safeprojectname$.Contracts;
+using System.Text;
+using $safeprojectname$.Contracts;
 using $safeprojectname$.DomainObjects;
 using $safeprojectname$.Extensions;
 using YamlDotNet.Serialization;
@@ -32,6 +33,46 @@ private ConfigurationService(){}
             return new YamlContainer<T>();
         }
     }
+    public YamlContainer<T> GetByNodeName<T>(string filePath, string nodeName) where T : new()
+    {
+        var stringBuilder = new StringBuilder();
+        stringBuilder.AppendLine("version: 1.0\r\nconfiguration:");
+        var nodeFound = false;
+        var nodeIndentation = 0;
+
+        using (var reader = new StreamReader(filePath))
+        {
+            while (reader.ReadLine() is { } line)
+            {
+                if (line.Trim().StartsWith(nodeName + ":"))
+                {
+                    nodeFound = true;
+                    nodeIndentation = line.TakeWhile(Char.IsWhiteSpace).Count();
+                    stringBuilder.AppendLine(line);
+                    continue;
+                }
+                if (!nodeFound) continue;
+                var currentIndentation = line.TakeWhile(Char.IsWhiteSpace).Count();
+                if (string.IsNullOrWhiteSpace(line) || currentIndentation <= nodeIndentation) break;
+                stringBuilder.AppendLine(line);
+            }
+        }
+
+        var yamlContent = stringBuilder.ToString();
+        var deserializer = new DeserializerBuilder()
+            .WithNamingConvention(CamelCaseNamingConvention.Instance)
+            .Build();
+        try
+        {
+            return deserializer.Deserialize<YamlContainer<T>>(yamlContent);
+        }
+        catch (Exception)
+        {
+            Console.WriteLine($"Could not deserialize the configuration file, default configuration will be loaded instead\nA template configuration file named default_{typeof(T).Name}.yaml will be created in application root.");
+            return new YamlContainer<T>();
+        }
+        
+    }
     public string SaveChanges<T>(T configuration, string inputFileName = "") where T : new()
     {
         if (configuration is null) return "";
@@ -45,7 +86,6 @@ private ConfigurationService(){}
         File.WriteAllText(fileName, yamlData);
         return fileName;
     }
-
     public void Create<T>(T configuration, string fullFileName) where T : new()
     {
         if (configuration is null) return;
@@ -67,9 +107,8 @@ private ConfigurationService(){}
     public YamlContainer<T> GetAppDataConfiguration<T>(string inputFileName = "") where T : new()
     {
         var directory = $"{Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData)}\\{nameof(PowerCommands)}";
-        if (!Directory.Exists(directory)) Directory.CreateDirectory(directory);
         var fileName = Path.Combine(directory, inputFileName);
-        if (!File.Exists(fileName)) throw new FileNotFoundException($"Could not find file {fileName}");
+        if (!File.Exists(fileName)) return new YamlContainer<T>();
         var yamlContent = File.ReadAllText(fileName);
         var deserializer = new DeserializerBuilder()
             .WithNamingConvention(CamelCaseNamingConvention.Instance)

Templates/src/Core/PainKiller.PowerCommands.Configuration/CONTRACTS/IConfigurationService.cs

@@ -7,6 +7,8 @@ public static class ConfigurationGlobals
     public const string SecurityFileName = "security.yaml";
     public const string WhatsNewFileName = "whats_new.md";
     public const char ArraySplitter = '|';
+    public const string SetupConfigurationFile = "setup.yaml";
+    public const string EncryptionEnviromentVariableName = "_encryptionManager";
 
     public static readonly string ApplicationDataFolder = $"{Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData)}\\{nameof(PowerCommands)}";
 }

Templates/src/Core/PainKiller.PowerCommands.Configuration/ConfigurationService.cs

@@ -4,4 +4,6 @@ public class EncryptionConfiguration
 {
     public string SharedSecretEnvironmentKey { get; set; } = "";
     public string SharedSecretSalt { get; set; } = "";
+    public int IterationCount { get; set; } = 10000;
+    public int KeySize { get; set; } = 256;
 }

Templates/src/Core/PainKiller.PowerCommands.Configuration/DOMAINOBJECTS/ConfigurationGlobals.cs

@@ -1,4 +1,6 @@
 using $safeprojectname$.DomainObjects;
+using YamlDotNet.Serialization.NamingConventions;
+using YamlDotNet.Serialization;
 
 namespace $safeprojectname$.Extensions;
 
@@ -15,4 +17,11 @@ public static string GetPath(this ArtifactPathsConfiguration configuration, stri
         return Path.Combine(ReplaceTags(paths[0], configuration.Name), ReplaceTags(paths[1], configuration.Name), ReplaceTags(paths[2], configuration.Name));
     }
     private static string ReplaceTags(string raw, string name) => raw.Replace("{appdata}", AppContext.BaseDirectory).Replace("{name}", name);
+    public static string GetYaml<T>(this T configuration) where T : new()
+    {
+        var serializer = new SerializerBuilder()
+            .WithNamingConvention(CamelCaseNamingConvention.Instance)
+            .Build();
+        return serializer.Serialize(configuration);
+    }
 }