Functions/GenXdev.Data.Preferences/Set-GenXdevDefaultPreference.cs
|
// ################################################################################
// Part of PowerShell module : GenXdev.Data.Preferences // Original cmdlet filename : Set-GenXdevDefaultPreference.cs // Original author : René Vaessen / GenXdev // Version : 1.302.2025 // ################################################################################ // Copyright (c) René Vaessen / GenXdev // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // ################################################################################ using System; using System.Collections; using System.Management.Automation; namespace GenXdev.Data.Preferences { /// <summary> /// <para type="synopsis"> /// Sets a default preference value in the GenXdev preferences store. /// </para> /// /// <para type="description"> /// This function manages default preferences in the GenXdev preference system. It /// handles storing values, removing preferences when values are empty, and ensures /// changes are synchronized across the system. The function supports null values by /// removing the preference entirely in such cases. When a value is provided, it is /// stored in the key-value store and synchronized across all consumers. /// </para> /// /// <para type="description"> /// PARAMETERS /// </para> /// /// <para type="description"> /// -Name <String><br/> /// Specifies the name (key) of the preference to set in the default store. This /// parameter is required and cannot be null or empty.<br/> /// - <b>Position</b>: 0<br/> /// - <b>Mandatory</b>: true<br/> /// </para> /// /// <para type="description"> /// -Value <String><br/> /// Specifies the value to store for the preference. Can be null or empty, which /// will result in removing the preference from the store.<br/> /// - <b>Position</b>: 1<br/> /// - <b>Mandatory</b>: false<br/> /// </para> /// /// <para type="description"> /// -PreferencesDatabasePath <String><br/> /// Database path for preference data files. This parameter is optional and can /// be used to override the default database path.<br/> /// - <b>Aliases</b>: DatabasePath<br/> /// - <b>Position</b>: 2<br/> /// - <b>Mandatory</b>: false<br/> /// </para> /// /// <para type="description"> /// -SessionOnly <SwitchParameter><br/> /// Use alternative settings stored in session for Data preferences like Language, /// Database paths, etc.<br/> /// - <b>Position</b>: named<br/> /// - <b>Default</b>: false<br/> /// </para> /// /// <para type="description"> /// -ClearSession <SwitchParameter><br/> /// Clear the session setting (Global variable) before retrieving.<br/> /// - <b>Position</b>: named<br/> /// - <b>Default</b>: false<br/> /// </para> /// /// <para type="description"> /// -SkipSession <SwitchParameter><br/> /// Dont use alternative settings stored in session for Data preferences like /// Language, Database paths, etc.<br/> /// - <b>Aliases</b>: FromPreferences<br/> /// - <b>Position</b>: named<br/> /// - <b>Default</b>: false<br/> /// </para> /// /// <example> /// <para>Set-GenXdevDefaultPreference -Name "Theme" -Value "Dark"</para> /// <para>Sets the default theme preference to "Dark".</para> /// <code> /// Set-GenXdevDefaultPreference -Name "Theme" -Value "Dark" /// </code> /// </example> /// /// <example> /// <para>setPreferenceDefault "EmailNotifications" "Disabled"</para> /// <para>Uses the alias to disable email notifications in defaults.</para> /// <code> /// setPreferenceDefault "EmailNotifications" "Disabled" /// </code> /// </example> /// </summary> [Cmdlet(VerbsCommon.Set, "GenXdevDefaultPreference")] [Alias("setPreferenceDefault")] public class SetGenXdevDefaultPreferenceCommand : PSGenXdevCmdlet { /// <summary> /// The name of the preference to set in defaults /// </summary> [Parameter( Mandatory = true, Position = 0, ValueFromPipelineByPropertyName = true, HelpMessage = "The name of the preference to set in defaults" )] [ValidateNotNullOrEmpty] [Alias("PreferenceName")] public string Name { get; set; } /// <summary> /// The value to store for the preference /// </summary> [Parameter( Mandatory = false, Position = 1, ValueFromPipelineByPropertyName = true, HelpMessage = "The value to store for the preference" )] [AllowNull] [AllowEmptyString] [Alias("PreferenceValue")] public string Value { get; set; } /// <summary> /// Database path for preference data files /// </summary> [Parameter( Mandatory = false, Position = 2, HelpMessage = "Database path for preference data files" )] [Alias("DatabasePath")] public string PreferencesDatabasePath { get; set; } /// <summary> /// Use alternative settings stored in session for Data preferences like Language, Database paths, etc /// </summary> [Parameter( Mandatory = false, HelpMessage = "Use alternative settings stored in session for Data preferences like Language, Database paths, etc" )] public SwitchParameter SessionOnly { get; set; } /// <summary> /// Clear the session setting (Global variable) before retrieving /// </summary> [Parameter( Mandatory = false, HelpMessage = "Clear the session setting (Global variable) before retrieving" )] public SwitchParameter ClearSession { get; set; } /// <summary> /// Dont use alternative settings stored in session for Data preferences like Language, Database paths, etc /// </summary> [Parameter( Mandatory = false, HelpMessage = "Dont use alternative settings stored in session for Data preferences like Language, Database paths, etc" )] [Alias("FromPreferences")] public SwitchParameter SkipSession { get; set; } protected override void BeginProcessing() { } protected override void ProcessRecord() { SetGenXdevDefaultPreference(Name, Value, PreferencesDatabasePath, SessionOnly.ToBool(), ClearSession.ToBool(), SkipSession.ToBool()); } protected override void EndProcessing() { } } } |