Functions/GenXdev.AI.Queries/Get-AIMetaLanguage.cs
|
// ################################################################################
// Part of PowerShell module : GenXdev.AI.Queries // Original cmdlet filename : Get-AIMetaLanguage.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.AI.Queries { /// <summary> /// <para type="synopsis"> /// Gets the configured default language for image metadata operations. /// </para> /// /// <para type="description"> /// This cmdlet retrieves the default language used by the GenXdev.AI module /// for image metadata operations. It checks Global variables first (unless /// SkipSession is specified), then falls back to persistent preferences, and /// finally uses system defaults. /// </para> /// /// <para type="description"> /// PARAMETERS /// </para> /// /// <para type="description"> /// -Language <string><br/> /// Optional language override. If specified, this language will be returned /// instead of retrieving from configuration.<br/> /// - <b>Position</b>: 0<br/> /// - <b>Default</b>: null<br/> /// </para> /// /// <para type="description"> /// -PreferencesDatabasePath <string><br/> /// Database path for preference data files.<br/> /// - <b>Aliases</b>: DatabasePath<br/> /// - <b>Default</b>: null<br/> /// </para> /// /// <para type="description"> /// -SessionOnly <SwitchParameter><br/> /// Use alternative settings stored in session for AI preferences like Language, /// Image collections, etc.<br/> /// - <b>Default</b>: false<br/> /// </para> /// /// <para type="description"> /// -ClearSession <SwitchParameter><br/> /// Clear the session setting (Global variable) before retrieving.<br/> /// - <b>Default</b>: false<br/> /// </para> /// /// <para type="description"> /// -SkipSession <SwitchParameter><br/> /// Dont use alternative settings stored in session for AI preferences like /// Language, Image collections, etc.<br/> /// - <b>Aliases</b>: FromPreferences<br/> /// - <b>Default</b>: false<br/> /// </para> /// /// <example> /// <para>Get the currently configured language from Global variables or preferences.</para> /// <para>Detailed explanation of the example.</para> /// <code> /// Get-AIMetaLanguage /// </code> /// </example> /// /// <example> /// <para>Get the configured language only from persistent preferences, ignoring any session setting.</para> /// <para>Detailed explanation of the example.</para> /// <code> /// Get-AIMetaLanguage -SkipSession /// </code> /// </example> /// /// <example> /// <para>Clear the session language setting and then get the language from persistent preferences.</para> /// <para>Detailed explanation of the example.</para> /// <code> /// Get-AIMetaLanguage -ClearSession /// </code> /// </example> /// /// <example> /// <para>Use alias to get the current language configuration.</para> /// <para>Detailed explanation of the example.</para> /// <code> /// getimgmetalang /// </code> /// </example> /// </summary> [Cmdlet(VerbsCommon.Get, "AIMetaLanguage")] [OutputType(typeof(string))] [Alias("getimgmetalang")] public partial class GetAIMetaLanguageCommand : PSGenXdevCmdlet { /// <summary> /// Optional language override. If specified, this language will be returned /// instead of retrieving from configuration. /// </summary> [Parameter( Position = 0, Mandatory = false, HelpMessage = "The default language for image metadata operations")] [ValidateSet( "Afrikaans", "Akan", "Albanian", "Amharic", "Arabic", "Armenian", "Azerbaijani", "Basque", "Belarusian", "Bemba", "Bengali", "Bihari", "Bosnian", "Breton", "Bulgarian", "Cambodian", "Catalan", "Cherokee", "Chichewa", "Chinese (Simplified)", "Chinese (Traditional)", "Corsican", "Croatian", "Czech", "Danish", "Dutch", "English", "Esperanto", "Estonian", "Ewe", "Faroese", "Filipino", "Finnish", "French", "Frisian", "Ga", "Galician", "Georgian", "German", "Greek", "Guarani", "Gujarati", "Haitian Creole", "Hausa", "Hawaiian", "Hebrew", "Hindi", "Hungarian", "Icelandic", "Igbo", "Indonesian", "Interlingua", "Irish", "Italian", "Japanese", "Javanese", "Kannada", "Kazakh", "Kinyarwanda", "Kirundi", "Kongo", "Korean", "Krio (Sierra Leone)", "Kurdish", "Kurdish (Soranî)", "Kyrgyz", "Laothian", "Latin", "Latvian", "Lingala", "Lithuanian", "Lozi", "Luganda", "Luo", "Macedonian", "Malagasy", "Malay", "Malayalam", "Maltese", "Maori", "Marathi", "Mauritian Creole", "Moldavian", "Mongolian", "Montenegrin", "Nepali", "Nigerian Pidgin", "Northern Sotho", "Norwegian", "Norwegian (Nynorsk)", "Occitan", "Oriya", "Oromo", "Pashto", "Persian", "Polish", "Portuguese (Brazil)", "Portuguese (Portugal)", "Punjabi", "Quechua", "Romanian", "Romansh", "Runyakitara", "Russian", "Scots Gaelic", "Serbian", "Serbo-Croatian", "Sesotho", "Setswana", "Seychellois Creole", "Shona", "Sindhi", "Sinhalese", "Slovak", "Slovenian", "Somali", "Spanish", "Spanish (Latin American)", "Sundanese", "Swahili", "Swedish", "Tajik", "Tamil", "Tatar", "Telugu", "Thai", "Tigrinya", "Tonga", "Tshiluba", "Tumbuka", "Turkish", "Turkmen", "Twi", "Uighur", "Ukrainian", "Urdu", "Uzbek", "Vietnamese", "Welsh", "Wolof", "Xhosa", "Yiddish", "Yoruba", "Zulu")] public string Language { get; set; } /// <summary> /// Database path for preference data files. /// </summary> [Parameter( Mandatory = false, HelpMessage = "Database path for preference data files")] [Alias("DatabasePath")] public string PreferencesDatabasePath { get; set; } /// <summary> /// Use alternative settings stored in session for AI preferences like Language, /// Image collections, etc. /// </summary> [Parameter( Mandatory = false, HelpMessage = "Use alternative settings stored in session for AI " + "preferences like Language, Image collections, 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 AI preferences like /// Language, Image collections, etc. /// </summary> [Parameter( Mandatory = false, HelpMessage = "Dont use alternative settings stored in session " + "for AI preferences like Language, Image collections, etc")] [Alias("FromPreferences")] public SwitchParameter SkipSession { get; set; } /// <summary> /// Begin processing - initialization logic /// </summary> protected override void BeginProcessing() { } /// <summary> /// Process record - main cmdlet logic /// </summary> protected override void ProcessRecord() { // Check if Language is provided and not empty if (!string.IsNullOrWhiteSpace(Language)) { WriteObject(Language); return; } // Copy identical parameters to Get-GenXdevPreference var invocationParams = CopyIdenticalParamValues("GenXdev.Data\\Get-GenXdevPreference"); // Add specific parameters invocationParams["Name"] = "AIMetaLanguage"; // Compute default value: invoke Get-DefaultWebLanguage since Language is null var gdwlParams = CopyIdenticalParamValues("GenXdev.Helpers\\Get-DefaultWebLanguage"); var defaultValueScript = ScriptBlock.Create("param ($gdwlParams) GenXdev.Helpers\\Get-DefaultWebLanguage @gdwlParams"); var defaultValueResult = defaultValueScript.Invoke(gdwlParams); var defaultValue = ((PSObject)defaultValueResult[0]).BaseObject.ToString(); invocationParams["DefaultValue"] = defaultValue; // Invoke Get-GenXdevPreference with the param // eters var script = ScriptBlock.Create("param($params) GenXdev.Data\\Get-GenXdevPreference @params"); var results = script.Invoke(invocationParams); // Write the result as string var result = ((PSObject)results[0]).BaseObject.ToString(); WriteObject(result); } /// <summary> /// End processing - cleanup logic /// </summary> protected override void EndProcessing() { } } } |