Mark GraphQL Playground as obsolete

samples/Samples.Authorization/Program.cs

@@ -61,13 +61,13 @@
 // configure the graphql endpoint at "/graphql"
 app.UseGraphQL("/graphql");
 // configure Playground at "/ui/graphql"
-app.UseGraphQLPlayground(
+app.UseGraphQLGraphiQL(
     "/ui/graphql",
-    new GraphQL.Server.Ui.Playground.PlaygroundOptions
+    new GraphQL.Server.Ui.GraphiQL.GraphiQLOptions
     {
         GraphQLEndPoint = "/graphql",
         SubscriptionsEndPoint = "/graphql",
-        RequestCredentials = GraphQL.Server.Ui.Playground.RequestCredentials.Include,
+        RequestCredentials = GraphQL.Server.Ui.GraphiQL.RequestCredentials.Include,
     });
 // -------------------------------------
 

samples/Samples.Authorization/Samples.Authorization.csproj

@@ -19,7 +19,7 @@
 
   <ItemGroup>
     <ProjectReference Include="..\..\src\Transports.AspNetCore\Transports.AspNetCore.csproj" />
-    <ProjectReference Include="..\..\src\Ui.Playground\Ui.Playground.csproj" />
+    <ProjectReference Include="..\..\src\Ui.GraphiQL\Ui.GraphiQL.csproj" />
   </ItemGroup>
 
 </Project>

samples/Samples.AzureFunctions/GraphQL.cs

@@ -1,5 +1,5 @@
 using GraphQL.Server.Transports.AspNetCore;
-using GraphQL.Server.Ui.Playground;
+using GraphQL.Server.Ui.GraphiQL;
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.Azure.WebJobs;
@@ -21,12 +21,12 @@ public static IActionResult RunGraphQL(
     }
 
     [FunctionName("Playground")]
-    public static IActionResult RunPlayground(
+    public static IActionResult RunGraphiQL(
         [HttpTrigger(AuthorizationLevel.Anonymous, "get")] HttpRequest request,
         ILogger log)
     {
-        log.LogInformation("C# HTTP trigger function processed a request for the GraphQL Playground UI.");
+        log.LogInformation("C# HTTP trigger function processed a request for the GraphiQL UI.");
 
-        return new PlaygroundActionResult(opts => opts.GraphQLEndPoint = "/api/graphql"); // /api/graphql route will call RunGraphQL method
+        return new GraphiQLActionResult(opts => opts.GraphQLEndPoint = "/api/graphql"); // /api/graphql route will call RunGraphQL method
     }
 }

samples/Samples.AzureFunctions/Samples.AzureFunctions.csproj

@@ -11,7 +11,6 @@
   <ItemGroup>
     <ProjectReference Include="..\..\src\Transports.AspNetCore\Transports.AspNetCore.csproj" />
     <ProjectReference Include="..\..\src\Ui.GraphiQL\Ui.GraphiQL.csproj" />
-    <ProjectReference Include="..\..\src\Ui.Playground\Ui.Playground.csproj" />
     <ProjectReference Include="..\Samples.Schemas.Chat\Samples.Schemas.Chat.csproj" />
   </ItemGroup>
   <ItemGroup>

samples/Samples.Basic/Program.cs

@@ -15,10 +15,10 @@
 app.UseWebSockets();
 // configure the graphql endpoint at "/graphql"
 app.UseGraphQL("/graphql");
-// configure Playground at "/"
-app.UseGraphQLPlayground(
+// configure GraphiQL at "/"
+app.UseGraphQLGraphiQL(
     "/",
-    new GraphQL.Server.Ui.Playground.PlaygroundOptions
+    new GraphQL.Server.Ui.GraphiQL.GraphiQLOptions
     {
         GraphQLEndPoint = "/graphql",
         SubscriptionsEndPoint = "/graphql",

samples/Samples.Basic/Samples.Basic.csproj

@@ -10,7 +10,7 @@
   <ItemGroup>
     <ProjectReference Include="..\..\src\Transports.AspNetCore\Transports.AspNetCore.csproj" />
     <ProjectReference Include="..\Samples.Schemas.Chat\Samples.Schemas.Chat.csproj" />
-    <ProjectReference Include="..\..\src\Ui.Playground\Ui.Playground.csproj" />
+    <ProjectReference Include="..\..\src\Ui.GraphiQL\Ui.GraphiQL.csproj" />
   </ItemGroup>
 
 </Project>

samples/Samples.Complex/Startup.cs

@@ -60,6 +60,7 @@ public void Configure(IApplicationBuilder app)
             ReadFormOnPost = true,
         });
 
+#pragma warning disable CS0618 // Type or member is obsolete
         app.UseGraphQLPlayground(options: new PlaygroundOptions
         {
             BetaUpdates = true,
@@ -87,6 +88,7 @@ public void Configure(IApplicationBuilder app)
                 ["MyHeader2"] = 42,
             },
         });
+#pragma warning restore CS0618 // Type or member is obsolete
 
         app.UseGraphQLGraphiQL(options: new GraphiQLOptions
         {

samples/Samples.Complex/StartupWithRouting.cs

@@ -65,6 +65,7 @@ public void Configure(IApplicationBuilder app)
                 ReadFormOnPost = true,
             });
 
+#pragma warning disable CS0618 // Type or member is obsolete
             endpoints.MapGraphQLPlayground(options: new PlaygroundOptions
             {
                 BetaUpdates = true,
@@ -92,6 +93,7 @@ public void Configure(IApplicationBuilder app)
                     ["MyHeader2"] = 42,
                 },
             });
+#pragma warning restore CS0618 // Type or member is obsolete
 
             endpoints.MapGraphQLGraphiQL(options: new GraphiQLOptions
             {

samples/Samples.Cors/Program.cs

@@ -29,7 +29,7 @@
     // configure the graphql endpoint at "/graphql"
     endpoints.MapGraphQL("/graphql")
         .RequireCors("MyCorsPolicy");
-    // configure Playground at "/"
-    endpoints.MapGraphQLPlayground("/");
+    // configure GraphiQL at "/"
+    endpoints.MapGraphQLGraphiQL("/");
 });
 await app.RunAsync();

samples/Samples.Cors/Samples.Cors.csproj

@@ -10,7 +10,7 @@
   <ItemGroup>
     <ProjectReference Include="..\..\src\Transports.AspNetCore\Transports.AspNetCore.csproj" />
     <ProjectReference Include="..\Samples.Schemas.Chat\Samples.Schemas.Chat.csproj" />
-    <ProjectReference Include="..\..\src\Ui.Playground\Ui.Playground.csproj" />
+    <ProjectReference Include="..\..\src\Ui.GraphiQL\Ui.GraphiQL.csproj" />
   </ItemGroup>
 
 </Project>

samples/Samples.EndpointRouting/Program.cs

@@ -19,7 +19,7 @@
 {
     // configure the graphql endpoint at "/graphql"
     endpoints.MapGraphQL("/graphql");
-    // configure Playground at "/"
-    endpoints.MapGraphQLPlayground("/");
+    // configure GraphiQL at "/"
+    endpoints.MapGraphQLGraphiQL("/");
 });
 await app.RunAsync();

samples/Samples.EndpointRouting/Samples.EndpointRouting.csproj

@@ -10,7 +10,7 @@
   <ItemGroup>
     <ProjectReference Include="..\..\src\Transports.AspNetCore\Transports.AspNetCore.csproj" />
     <ProjectReference Include="..\Samples.Schemas.Chat\Samples.Schemas.Chat.csproj" />
-    <ProjectReference Include="..\..\src\Ui.Playground\Ui.Playground.csproj" />
+    <ProjectReference Include="..\..\src\Ui.GraphiQL\Ui.GraphiQL.csproj" />
   </ItemGroup>
 
 </Project>

samples/Samples.MultipleSchemas/Program.cs

@@ -16,18 +16,18 @@
 app.UseGraphQL<MultipleSchema.Cats.CatsSchema>("/cats/graphql");
 // configure the graphql endpoint at "/dogs/graphql"
 app.UseGraphQL<MultipleSchema.Dogs.DogsSchema>("/dogs/graphql");
-// configure Playground at "/cats/ui/playground" with relative link to api
-app.UseGraphQLPlayground(
-    "/cats/ui/playground",
-    new GraphQL.Server.Ui.Playground.PlaygroundOptions
+// configure GraphiQL at "/cats/ui/graphiql" with relative link to api
+app.UseGraphQLGraphiQL(
+    "/cats/ui/graphiql",
+    new GraphQL.Server.Ui.GraphiQL.GraphiQLOptions
     {
         GraphQLEndPoint = "../graphql",
         SubscriptionsEndPoint = "../graphql",
     });
-// configure Playground at "/dogs/ui/playground" with relative link to api
-app.UseGraphQLPlayground(
-    "/dogs/ui/playground",
-    new GraphQL.Server.Ui.Playground.PlaygroundOptions
+// configure GraphiQL at "/dogs/ui/graphiql" with relative link to api
+app.UseGraphQLGraphiQL(
+    "/dogs/ui/graphiql",
+    new GraphQL.Server.Ui.GraphiQL.GraphiQLOptions
     {
         GraphQLEndPoint = "../graphql",
         SubscriptionsEndPoint = "../graphql",

samples/Samples.MultipleSchemas/Samples.MultipleSchemas.csproj

@@ -8,7 +8,7 @@
 
   <ItemGroup>
     <ProjectReference Include="..\..\src\Transports.AspNetCore\Transports.AspNetCore.csproj" />
-    <ProjectReference Include="..\..\src\Ui.Playground\Ui.Playground.csproj" />
+    <ProjectReference Include="..\..\src\Ui.GraphiQL\Ui.GraphiQL.csproj" />
     <PackageReference Include="System.Reactive" Version="6.0.0" />
     <Using Include="GraphQL" />
     <Using Include="GraphQL.Types" />

src/Ui.Playground/Extensions/PlaygroundApplicationBuilderExtensions.cs

@@ -13,6 +13,7 @@ public static class PlaygroundApplicationBuilderExtensions
     /// <param name="options"> Options to customize <see cref="PlaygroundMiddleware"/>. If not set, then the default values will be used. </param>
     /// <param name="path">The path to the GraphQL Playground endpoint which defaults to '/ui/playground'</param>
     /// <returns> The reference to provided <paramref name="app"/> instance. </returns>
+    [Obsolete("GraphQL Playground has not been updated since 2019. Please use GraphiQL instead.")]
     public static IApplicationBuilder UseGraphQLPlayground(this IApplicationBuilder app, string path = "/ui/playground", PlaygroundOptions? options = null)
     {
         return app.UseWhen(

src/Ui.Playground/Extensions/PlaygroundEndpointRouteBuilderExtensions.cs

@@ -17,6 +17,7 @@ public static class PlaygroundEndpointRouteBuilderExtensions
     /// <param name="options">Options to customize <see cref="PlaygroundMiddleware"/>. If not set, then the default values will be used.</param>
     /// <param name="pattern">The route pattern.</param>
     /// <returns>The <see cref="IApplicationBuilder"/> received as parameter</returns>
+    [Obsolete("GraphQL Playground has not been updated since 2019. Please use GraphiQL instead.")]
     public static PlaygroundEndpointConventionBuilder MapGraphQLPlayground(this IEndpointRouteBuilder endpoints, string pattern = "ui/playground", PlaygroundOptions? options = null)
     {
         if (endpoints == null)

src/Ui.Playground/PlaygroundActionResult.cs

@@ -5,6 +5,7 @@ namespace GraphQL.Server.Ui.Playground;
 /// <summary>
 /// An action result that returns a Playground user interface.
 /// </summary>
+[Obsolete("GraphQL Playground has not been updated since 2019. Please use GraphiQL instead.")]
 public class PlaygroundActionResult : IActionResult
 {
     private readonly PlaygroundMiddleware _middleware;

src/Ui.Playground/PlaygroundMiddleware.cs

@@ -7,6 +7,7 @@ namespace GraphQL.Server.Ui.Playground;
 /// <summary>
 /// A middleware for GraphQL Playground UI.
 /// </summary>
+[Obsolete("GraphQL Playground has not been updated since 2019. Please use GraphiQL instead.")]
 public class PlaygroundMiddleware
 {
     private readonly PlaygroundOptions _options;

tests/ApiApprovalTests/ApiApprovalTests.cs

@@ -11,7 +11,9 @@ public class ApiApprovalTests
     [Theory]
     [InlineData(typeof(Server.Ui.Altair.AltairMiddleware))]
     [InlineData(typeof(Server.Ui.GraphiQL.GraphiQLMiddleware))]
+#pragma warning disable CS0618 // Type or member is obsolete
     [InlineData(typeof(Server.Ui.Playground.PlaygroundMiddleware))]
+#pragma warning restore CS0618 // Type or member is obsolete
     [InlineData(typeof(Server.Ui.Voyager.VoyagerMiddleware))]
     [InlineData(typeof(Server.Transports.AspNetCore.GraphQLHttpMiddleware<>))]
     public void public_api_should_not_change_unintentionally(Type type)

tests/ApiApprovalTests/net80+netcoreapp31/GraphQL.Server.Ui.Playground.approved.txt

@@ -11,12 +11,14 @@ namespace GraphQL.Server.Ui.Playground
         Dark = 0,
         Light = 1,
     }
+    [System.Obsolete("GraphQL Playground has not been updated since 2019. Please use GraphiQL instead.")]
     public class PlaygroundActionResult : Microsoft.AspNetCore.Mvc.IActionResult
     {
         public PlaygroundActionResult(GraphQL.Server.Ui.Playground.PlaygroundOptions options) { }
         public PlaygroundActionResult(System.Action<GraphQL.Server.Ui.Playground.PlaygroundOptions>? configure = null) { }
         public System.Threading.Tasks.Task ExecuteResultAsync(Microsoft.AspNetCore.Mvc.ActionContext context) { }
     }
+    [System.Obsolete("GraphQL Playground has not been updated since 2019. Please use GraphiQL instead.")]
     public class PlaygroundMiddleware
     {
         public PlaygroundMiddleware(Microsoft.AspNetCore.Http.RequestDelegate next, GraphQL.Server.Ui.Playground.PlaygroundOptions options) { }
@@ -59,6 +61,7 @@ namespace Microsoft.AspNetCore.Builder
 {
     public static class PlaygroundApplicationBuilderExtensions
     {
+        [System.Obsolete("GraphQL Playground has not been updated since 2019. Please use GraphiQL instead.")]
         public static Microsoft.AspNetCore.Builder.IApplicationBuilder UseGraphQLPlayground(this Microsoft.AspNetCore.Builder.IApplicationBuilder app, string path = "/ui/playground", GraphQL.Server.Ui.Playground.PlaygroundOptions? options = null) { }
     }
     public class PlaygroundEndpointConventionBuilder : Microsoft.AspNetCore.Builder.IEndpointConventionBuilder
@@ -67,6 +70,7 @@ namespace Microsoft.AspNetCore.Builder
     }
     public static class PlaygroundEndpointRouteBuilderExtensions
     {
+        [System.Obsolete("GraphQL Playground has not been updated since 2019. Please use GraphiQL instead.")]
         public static Microsoft.AspNetCore.Builder.PlaygroundEndpointConventionBuilder MapGraphQLPlayground(this Microsoft.AspNetCore.Routing.IEndpointRouteBuilder endpoints, string pattern = "ui/playground", GraphQL.Server.Ui.Playground.PlaygroundOptions? options = null) { }
     }
 }

tests/ApiApprovalTests/netstandard20/GraphQL.Server.Ui.Playground.approved.txt

@@ -11,12 +11,14 @@ namespace GraphQL.Server.Ui.Playground
         Dark = 0,
         Light = 1,
     }
+    [System.Obsolete("GraphQL Playground has not been updated since 2019. Please use GraphiQL instead.")]
     public class PlaygroundActionResult : Microsoft.AspNetCore.Mvc.IActionResult
     {
         public PlaygroundActionResult(GraphQL.Server.Ui.Playground.PlaygroundOptions options) { }
         public PlaygroundActionResult(System.Action<GraphQL.Server.Ui.Playground.PlaygroundOptions>? configure = null) { }
         public System.Threading.Tasks.Task ExecuteResultAsync(Microsoft.AspNetCore.Mvc.ActionContext context) { }
     }
+    [System.Obsolete("GraphQL Playground has not been updated since 2019. Please use GraphiQL instead.")]
     public class PlaygroundMiddleware
     {
         public PlaygroundMiddleware(Microsoft.AspNetCore.Http.RequestDelegate next, GraphQL.Server.Ui.Playground.PlaygroundOptions options) { }
@@ -59,6 +61,7 @@ namespace Microsoft.AspNetCore.Builder
 {
     public static class PlaygroundApplicationBuilderExtensions
     {
+        [System.Obsolete("GraphQL Playground has not been updated since 2019. Please use GraphiQL instead.")]
         public static Microsoft.AspNetCore.Builder.IApplicationBuilder UseGraphQLPlayground(this Microsoft.AspNetCore.Builder.IApplicationBuilder app, string path = "/ui/playground", GraphQL.Server.Ui.Playground.PlaygroundOptions? options = null) { }
     }
 }

tests/Samples.Authorization.Tests/EndToEndTests.cs

@@ -12,8 +12,8 @@ public class EndToEndTests
     private const string ACCESS_DENIED_RESPONSE = @"{""errors"":" + ACCESS_DENIED_ERRORS + "}";
 
     [Fact]
-    public Task Playground()
-        => new ServerTests<Program>().VerifyPlaygroundAsync("/ui/graphql");
+    public Task GraphiQL()
+        => new ServerTests<Program>().VerifyGraphiQLAsync("/ui/graphql");
 
     [Fact]
     public Task GraphQLGet_Success()

tests/Samples.AzureFunctions.Tests/EndToEndTests.cs

@@ -41,17 +41,17 @@ public async Task GraphQLPost()
     }
 
     [Fact]
-    public async Task Playground()
+    public async Task GraphiQL()
     {
         var (statusCode, contentType, body) = await ExecuteRequest(request =>
         {
             request.Method = "GET";
-        }, GraphQL.RunPlayground);
+        }, GraphQL.RunGraphiQL);
 
         statusCode.ShouldBe(200);
         contentType.ShouldBe("text/html");
         body.ShouldContain("<!DOCTYPE html>", Case.Insensitive);
-        body.ShouldContain("playground", Case.Insensitive);
+        body.ShouldContain("GraphiQL", Case.Insensitive);
     }
 
     private async Task<(int statusCode, string? contentType, string body)> ExecuteRequest(Action<HttpRequest> configureRequest, Func<HttpRequest, ILogger, IActionResult> func)

tests/Samples.Basic.Tests/EndToEndTests.cs

@@ -5,8 +5,8 @@ namespace Samples.Basic.Tests;
 public class EndToEndTests
 {
     [Fact]
-    public Task Playground()
-        => new ServerTests<Program>().VerifyPlaygroundAsync();
+    public Task GraphiQL()
+        => new ServerTests<Program>().VerifyGraphiQLAsync();
 
     [Fact]
     public Task GraphQLGet()

tests/Samples.Cors.Tests/EndToEndTests.cs

@@ -5,8 +5,8 @@ namespace Samples.Cors.Tests;
 public class EndToEndTests
 {
     [Fact]
-    public Task Playground()
-        => new ServerTests<Program>().VerifyPlaygroundAsync();
+    public Task GraphiQL()
+        => new ServerTests<Program>().VerifyGraphiQLAsync();
 
     [Fact]
     public Task GraphQLGet()

tests/Samples.EndpointRouting.Tests/EndToEndTests.cs

@@ -5,8 +5,8 @@ namespace Samples.EndpointRouting.Tests;
 public class EndToEndTests
 {
     [Fact]
-    public Task Playground()
-        => new ServerTests<Program>().VerifyPlaygroundAsync();
+    public Task GraphiQL()
+        => new ServerTests<Program>().VerifyGraphiQLAsync();
 
     [Fact]
     public Task GraphQLGet()

tests/Samples.MultipleSchemas.Tests/EndToEndTests.cs

@@ -10,12 +10,12 @@ public class EndToEndTests
     private const string DOG_RESPONSE = """{"data":{"dog":{"name":"Shadow"}}}""";
 
     [Fact]
-    public Task Cats_Playground()
-        => new ServerTests<Program>().VerifyPlaygroundAsync("/cats/ui/playground");
+    public Task Cats_GraphiQL()
+        => new ServerTests<Program>().VerifyGraphiQLAsync("/cats/ui/graphiql");
 
     [Fact]
-    public Task Dogs_Playground()
-        => new ServerTests<Program>().VerifyPlaygroundAsync("/dogs/ui/playground");
+    public Task Dogs_GraphiQL()
+        => new ServerTests<Program>().VerifyGraphiQLAsync("/dogs/ui/graphiql");
 
     [Fact]
     public Task Cats_GraphQLGet()