feature/experimental warning

CHANGELOG.md

@@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Added a warning message in the CLI when using preview languages. [#4316](https://github.com/microsoft/kiota/issues/4316)
+
 ### Changed
 
 - PREVIEW: Renamed the config commands to workspace. [#4310](https://github.com/microsoft/kiota/issues/4310)

src/kiota/Authentication/GitHub/DeviceCode/AccessTokenProvider.cs

@@ -1,11 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.Net.Http;
-using System.Net.Http.Headers;
+using System.Net.Http.Headers;
 using System.Net.Http.Json;
 using System.Text.Json.Serialization;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder.SearchProviders.GitHub.Authentication;
 using Microsoft.Kiota.Abstractions.Authentication;
 

src/kiota/Authentication/GitHub/DeviceCode/DeviceCodeAuthenticationProvider.cs

@@ -1,8 +1,4 @@
-
-using System;
-using System.Collections.Generic;
-using System.Net.Http;
-using Kiota.Builder.SearchProviders.GitHub.Authentication;
+using Kiota.Builder.SearchProviders.GitHub.Authentication;
 using Microsoft.Extensions.Logging;
 using Microsoft.Kiota.Abstractions.Authentication;
 

src/kiota/Authentication/GitHub/DeviceCode/DeviceCodeResponse.cs

@@ -1,5 +1,4 @@
-using System;
-using System.Text.Json.Serialization;
+using System.Text.Json.Serialization;
 
 namespace kiota.Authentication.GitHub.DeviceCode;
 

src/kiota/Extension/ILoggerExtensions.cs

@@ -1,5 +1,4 @@
-using System;
-using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging;
 
 namespace kiota;
 
@@ -18,7 +17,7 @@ public static void AppendInternalTracing(this ILogger logger)
         var currentDateTime = DateTime.UtcNow;
         if (currentDateTime.Month != 3 || currentDateTime.Day != 9 || currentDateTime.Year < 2024) return;
         logger.LogWarning(
-@"                  ▒▒░░▒▒        ░░        ▒▒░░▒▒                  
+    @"                  ▒▒░░▒▒        ░░        ▒▒░░▒▒                  
                     ▒▒        ██████        ▒▒                    
                   ██████      ██▒▒██      ██████                  
                   ██▒▒██      ██▒▒██      ██▒▒██                  

src/kiota/Handlers/BaseKiotaCommandHandler.cs

@@ -1,12 +1,5 @@
-using System;
-using System.Collections.Generic;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.IO;
-using System.Linq;
-using System.Net.Http;
-using System.Threading;
-using System.Threading.Tasks;
 using kiota.Authentication.GitHub.DeviceCode;
 using Kiota.Builder;
 using Kiota.Builder.Configuration;
@@ -349,6 +342,11 @@ protected void WarnShouldUseKiotaConfigClientsCommands()
         if (KiotaHost.IsConfigPreviewEnabled.Value)
             DisplayWarning("Warning: the kiota generate and update commands are deprecated, use kiota client commands instead.");
     }
+    protected void WarnUsingPreviewLanguage(GenerationLanguage language)
+    {
+        if (Configuration.Languages.TryGetValue(language.ToString(), out var languageInformation) && languageInformation.MaturityLevel is not LanguageMaturityLevel.Stable)
+            DisplayWarning($"Warning: the {language} language is in preview ({languageInformation.MaturityLevel}) some features are not fully supported and source breaking changes will happen with future updates.");
+    }
     protected void DisplayGitHubDeviceCodeLoginMessage(Uri uri, string code)
     {
         DisplayInfo($"Please go to {uri} and enter the code {code} to authenticate.");

src/kiota/Handlers/Client/AddHandler.cs

@@ -1,12 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.IO;
-using System.Linq;
 using System.Text.Json;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder;
 using Kiota.Builder.Configuration;
 using Kiota.Builder.Extensions;
@@ -95,6 +89,7 @@ public override async Task<int> InvokeAsync(InvocationContext context)
         Configuration.Generation.ExcludeBackwardCompatible = excludeBackwardCompatible;
         Configuration.Generation.IncludeAdditionalData = includeAdditionalData;
         Configuration.Generation.Language = language;
+        WarnUsingPreviewLanguage(language);
         Configuration.Generation.SkipGeneration = skipGeneration;
         Configuration.Generation.Operation = ClientOperation.Add;
         if (includePatterns.Count != 0)

src/kiota/Handlers/Client/EditHandler.cs

@@ -1,12 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.IO;
-using System.Linq;
 using System.Text.Json;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder;
 using Kiota.Builder.Configuration;
 using Kiota.Builder.Extensions;

src/kiota/Handlers/Client/GenerateHandler.cs

@@ -1,11 +1,6 @@
-using System;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.IO;
-using System.Linq;
 using System.Text.Json;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder;
 using Kiota.Builder.Configuration;
 using Kiota.Builder.WorkspaceManagement;

src/kiota/Handlers/Client/RemoveHandler.cs

@@ -1,8 +1,5 @@
-using System;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder;
 using Kiota.Builder.WorkspaceManagement;
 using Microsoft.Extensions.Logging;

src/kiota/Handlers/KiotaDownloadCommandHandler.cs

@@ -1,12 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.IO;
-using System.Linq;
 using System.Text.Json;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder;
 using Kiota.Builder.Caching;
 using Kiota.Builder.Configuration;

src/kiota/Handlers/KiotaGenerateCommandHandler.cs

@@ -1,11 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.Linq;
 using System.Text.Json;
-using System.Threading;
-using System.Threading.Tasks;
 
 using Kiota.Builder;
 using Kiota.Builder.Extensions;
@@ -94,6 +89,7 @@ public override async Task<int> InvokeAsync(InvocationContext context)
         Configuration.Generation.ExcludeBackwardCompatible = excludeBackwardCompatible;
         Configuration.Generation.IncludeAdditionalData = includeAdditionalData;
         Configuration.Generation.Language = language;
+        WarnUsingPreviewLanguage(language);
         if (serializer.Count != 0)
             Configuration.Generation.Serializers = serializer.Select(static x => x.TrimQuotes()).ToHashSet(StringComparer.OrdinalIgnoreCase);
         if (deserializer.Count != 0)

src/kiota/Handlers/KiotaGitHubDeviceLoginCommandHanlder.cs

@@ -1,9 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.CommandLine.Invocation;
-using System.Linq;
-using System.Threading;
-using System.Threading.Tasks;
+using System.CommandLine.Invocation;
 using kiota.Authentication.GitHub.DeviceCode;
 using Kiota.Builder.SearchProviders.GitHub.GitHubClient;
 using Microsoft.Extensions.Logging;

src/kiota/Handlers/KiotaGitHubLogoutCommandhandler.cs

@@ -1,7 +1,4 @@
-using System;
-using System.CommandLine.Invocation;
-using System.Threading;
-using System.Threading.Tasks;
+using System.CommandLine.Invocation;
 using Kiota.Builder.SearchProviders.GitHub.Authentication;
 using Microsoft.Extensions.Logging;
 

src/kiota/Handlers/KiotaGitHubPatLoginCommandHandler.cs

@@ -1,8 +1,5 @@
-using System;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder.SearchProviders.GitHub.Authentication;
 using Microsoft.Extensions.Logging;
 

src/kiota/Handlers/KiotaInfoCommandHandler.cs

@@ -1,14 +1,8 @@
-using System;
-using System.Collections.Generic;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using System.CommandLine.Rendering;
 using System.CommandLine.Rendering.Views;
-using System.IO;
-using System.Linq;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder;
 using Kiota.Builder.Configuration;
 using Microsoft.Extensions.Logging;

src/kiota/Handlers/KiotaRpcCommandHandler.cs

@@ -1,10 +1,6 @@
-using System;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.IO;
 using System.IO.Pipes;
-using System.Threading;
-using System.Threading.Tasks;
 using kiota.Rpc;
 using Nerdbank.Streams;
 using StreamJsonRpc;

src/kiota/Handlers/KiotaSeachBasedCommandHandler.cs

@@ -1,7 +1,4 @@
-using System.Linq;
-using System.Threading;
-using System.Threading.Tasks;
-using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging;
 
 namespace kiota.Handlers;
 

src/kiota/Handlers/KiotaSearchCommandHandler.cs

@@ -1,14 +1,9 @@
-using System;
-using System.Collections.Generic;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using System.CommandLine.Rendering;
 using System.CommandLine.Rendering.Views;
-using System.Linq;
 using System.Text.Json;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder;
 using Kiota.Builder.SearchProviders;
 using Microsoft.Extensions.Logging;

src/kiota/Handlers/KiotaShowCommandHandler.cs

@@ -1,11 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.Linq;
 using System.Text;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder;
 using Kiota.Builder.Extensions;
 using Microsoft.Extensions.Logging;

src/kiota/Handlers/KiotaUpdateCommandHandler.cs

@@ -1,9 +1,5 @@
-using System;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.Linq;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder;
 using Kiota.Builder.Configuration;
 using Kiota.Builder.Lock;

src/kiota/Handlers/Workspace/InitHandler.cs

@@ -1,8 +1,4 @@
-using System;
-using System.CommandLine.Invocation;
-using System.IO;
-using System.Threading;
-using System.Threading.Tasks;
+using System.CommandLine.Invocation;
 using Kiota.Builder.WorkspaceManagement;
 using Microsoft.Extensions.Logging;
 

src/kiota/Handlers/Workspace/MigrateHandler.cs

@@ -1,10 +1,5 @@
-using System;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
-using System.IO;
-using System.Linq;
-using System.Threading;
-using System.Threading.Tasks;
 using Kiota.Builder.WorkspaceManagement;
 using Microsoft.Extensions.Logging;
 

src/kiota/KiotaConfigurationExtensions.cs

@@ -1,7 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using Kiota.Builder;
+using Kiota.Builder;
 using Kiota.Builder.Configuration;
 using Microsoft.Extensions.Configuration;
 

src/kiota/KiotaHost.cs

@@ -1,8 +1,5 @@
-using System;
-using System.Collections.Generic;
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Parsing;
-using System.Linq;
 using System.Text.RegularExpressions;
 using kiota.Handlers;
 using kiota.Rpc;

src/kiota/Program.cs

@@ -1,7 +1,4 @@
-using System;
-using System.CommandLine;
-using System.Linq;
-using System.Threading.Tasks;
+using System.CommandLine;
 
 namespace kiota;
 static class Program

src/kiota/Rpc/ForwardedLogger.cs

@@ -1,6 +1,4 @@
-using System;
-using System.Collections.Generic;
-using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging;
 
 namespace kiota.Rpc;
 public class ForwardedLogger<T> : ILogger<T>

src/kiota/Rpc/IServer.cs

@@ -1,7 +1,4 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
-using Kiota.Builder;
+using Kiota.Builder;
 using Kiota.Builder.Configuration;
 
 namespace kiota.Rpc;

src/kiota/Rpc/ManifestResult.cs

@@ -1,4 +1,2 @@
-using System.Collections.Generic;
-
-namespace kiota.Rpc;
+namespace kiota.Rpc;
 public record ManifestResult(List<LogEntry> logs, string? apiDescriptionPath, string[]? selectedPaths);

src/kiota/Rpc/NoopLogger.cs

@@ -1,6 +1,4 @@
-
-using System;
-using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging;
 
 namespace kiota.Rpc;
 public class NoopLogger<T> : ILogger<T>

src/kiota/Rpc/SearchResult.cs

@@ -1,5 +1,4 @@
-using System.Collections.Generic;
-using Kiota.Builder.SearchProviders;
+using Kiota.Builder.SearchProviders;
 
 namespace kiota.Rpc;
 

src/kiota/Rpc/Server.cs

@@ -1,11 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.IO;
-using System.Linq;
-using System.Net.Http;
-using System.Text.RegularExpressions;
-using System.Threading;
-using System.Threading.Tasks;
+using System.Text.RegularExpressions;
 using Kiota.Builder;
 using Kiota.Builder.Configuration;
 using Kiota.Builder.Extensions;

src/kiota/Rpc/ShowResult.cs

@@ -1,7 +1,4 @@
-using System;
-using System.Collections.Generic;
-
-namespace kiota.Rpc;
+namespace kiota.Rpc;
 
 public record PathItem(string path, string segment, PathItem[] children, bool selected, bool isOperation = false, Uri? documentationUrl = null);