Custom culture

CSharpRepl.Services/Configuration.cs

@@ -5,6 +5,7 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
+using System.Globalization;
 using System.IO;
 using System.Linq;
 using System.Reflection;
@@ -80,7 +81,8 @@ public sealed class Configuration
         string[]? newLineKeyPatterns = null,
         string[]? submitPromptKeyPatterns = null,
         string[]? submitPromptDetailedKeyPatterns = null,
-        OpenAIConfiguration? openAIConfiguration = null)
+        OpenAIConfiguration? openAIConfiguration = null,
+        string? cultureName = null)
     {
         References = references?.ToHashSet() ?? new HashSet<string>();
         Usings = usings?.ToHashSet() ?? new HashSet<string>();
@@ -167,8 +169,12 @@ public sealed class Configuration
             newLine,
             submitPrompt,
             triggerOverloadList: new(new KeyPressPattern('('), new KeyPressPattern('['), new KeyPressPattern(','), new KeyPressPattern('<')));
+
+        Culture = string.IsNullOrWhiteSpace(cultureName) ? CultureInfo.CurrentCulture : CultureInfo.GetCultureInfo(cultureName, true);
     }
 
+    public CultureInfo Culture { get; }
+
     private static KeyPressPatterns ParseKeyPressPatterns(string[] keyPatterns)
         => keyPatterns.Select(ParseKeyPressPattern).ToArray();
 

CSharpRepl.Tests/CommandLineTests.cs

@@ -3,6 +3,7 @@
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
 using System;
+using System.Globalization;
 using CSharpRepl.Services;
 using CSharpRepl.Services.Roslyn.References;
 using Xunit;
@@ -83,6 +84,24 @@ public void ParseArguments_HelpArguments_SpecifiesHelp(string flag)
         Assert.NotNull(result);
         Assert.Contains("Usage: ", result.OutputForEarlyExit.Text);
     }
+
+    [Theory]
+    [InlineData("--culture", "en-gb")]
+    [InlineData("--culture", "en-GB")]
+    public void ParseArguments_CultureArguments_ProduceCulture(string flag, string cultureName)
+    {
+        var result = Parse($"{flag} {cultureName}");
+        Assert.NotNull(result);
+        Assert.Equal(new CultureInfo(cultureName), result.Culture);
+    }
+
+    [Theory]
+    [InlineData("--culture", "en-qwe")]
+    [InlineData("--culture", "asdf-GB")]
+    public void ParseArguments_CultureArguments_ShouldThrow(string flag, string cultureName)
+    {
+        Assert.Throws<CultureNotFoundException>(() => { Parse($"{flag} {cultureName}"); });
+    }
 
     [Fact]
     public void ParseArguments_ComplexCommandLine_ProducesConfiguration()
@@ -163,4 +182,4 @@ public void ParseArguments_DotNetSuggestUsingValue_IsAutocompleted()
 
     private static Configuration Parse(string[] commands) =>
         CommandLine.Parse(commands, ".csharprepl");
-}
+}

CSharpRepl/CSharpReplPromptCallbacks.cs

@@ -6,6 +6,7 @@
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Diagnostics;
+using System.Globalization;
 using System.Linq;
 using System.Net.Http;
 using System.Threading;
@@ -17,7 +18,6 @@
 using CSharpRepl.Services.Roslyn.Scripting;
 using CSharpRepl.Services.SymbolExploration;
 using CSharpRepl.Services.SyntaxHighlighting;
-using Microsoft.CodeAnalysis;
 using PrettyPrompt;
 using PrettyPrompt.Completion;
 using PrettyPrompt.Consoles;
@@ -50,7 +50,7 @@ protected override IEnumerable<(KeyPressPattern Pattern, KeyPressCallbackAsync C
     {
         yield return (
             new(ConsoleKey.F1),
-            async (text, caret, cancellationToken) => LaunchDocumentation(await roslyn.GetSymbolAtIndexAsync(text, caret)));
+            async (text, caret, cancellationToken) => LaunchDocumentation(await roslyn.GetSymbolAtIndexAsync(text, caret), configuration.Culture));
 
         yield return (
             new(ConsoleModifiers.Control, ConsoleKey.F1),
@@ -219,13 +219,13 @@ protected override Task<(IReadOnlyList<OverloadItem>, int ArgumentIndex)> GetOve
         }
     }
 
-    private static KeyPressCallbackResult? LaunchDocumentation(SymbolResult type)
+    private static KeyPressCallbackResult? LaunchDocumentation(SymbolResult type, CultureInfo culture)
     {
         if (type != SymbolResult.Unknown && type.SymbolDisplay is not null)
         {
-            var culture = System.Globalization.CultureInfo.CurrentCulture.Name;
-            LaunchBrowser($"https://docs.microsoft.com/{culture}/dotnet/api/{type.SymbolDisplay}");
+            LaunchBrowser($"https://docs.microsoft.com/{culture.Name}/dotnet/api/{type.SymbolDisplay}");
         }
+
         return null;
     }
 

CSharpRepl/CommandLine.cs

@@ -175,6 +175,11 @@ internal static class CommandLine
         description: "Launches an editor to edit the CSharpRepl configuration file. Reads the EDITOR environment variable."
     );
 
+    private static readonly Option<string> Culture = new(
+        aliases: new[] {"--culture"},
+        description: "Culture to use for access to the MSDN documentation. Defaults to the current culture."
+    );
+
     public static Configuration Parse(string[] args, string configFilePath)
     {
         var parseArgs = PreProcessArguments(args, configFilePath).ToArray();
@@ -195,7 +200,8 @@ public static Configuration Parse(string[] args, string configFilePath)
             References, Usings, Framework, Theme, UseTerminalPaletteTheme, Prompt, UseUnicode, UsePrereleaseNugets,
             StreamPipedInput, Trace, Version, Help, TabSize,
             OpenAIApiKey, OpenAIPrompt, OpenAIModel, OpenAIHistoryCount, OpenAITemperature, OpenAITopProbability,
-            TriggerCompletionListKeyBindings, NewLineKeyBindings, SubmitPromptKeyBindings, SubmitPromptDetailedKeyBindings, Configure
+            TriggerCompletionListKeyBindings, NewLineKeyBindings, SubmitPromptKeyBindings, SubmitPromptDetailedKeyBindings,
+            Configure, Culture,
         };
         var commandLine = new CommandLineBuilder(availableCommands)
             .EnableLegacyDoubleDashBehavior() // for passing tokens after "--" as load script arguments
@@ -247,7 +253,8 @@ public static Configuration Parse(string[] args, string configFilePath)
                 historyCount: commandLine.GetValueForOption(OpenAIHistoryCount) ?? OpenAICompleteService.DefaultHistoryEntryCount,
                 temperature: commandLine.GetValueForOption(OpenAITemperature) ?? OpenAICompleteService.DefaultTemperature,
                 topProbability: commandLine.GetValueForOption(OpenAITopProbability)
-            )
+            ),
+            cultureName: commandLine.GetValueForOption(Culture)
         );
 
         return config;
@@ -363,6 +370,7 @@ private static FormattedString GetHelp(string configFilePath)
             $"  [green]--usePrereleaseNugets[/]:                      {UsePrereleaseNugets.Description}" + NewLine +
             $"  [green]--streamPipedInput[/]:                         {StreamPipedInput.Description}" + NewLine +
             $"  [green]--tabSize[/] [cyan]<width>[/]:                          {TabSize.Description}" + NewLine +
+            $"  [green]--culture[/] [cyan]<culture name>[/]:                   {Culture.Description}" + NewLine +
             NewLine +
             $"  Key Bindings" + NewLine +
             $"  [green]--triggerCompletionListKeys[/] [cyan]<key-binding>[/]:  {TriggerCompletionListKeyBindings.Description}" + NewLine +