Fix remaining URLs so they point to latest GraphQL spec

wravery · wravery · commit 3bea5f46db88 · 2021-12-11T23:52:37.000-08:00
diff --git a/doc/fieldparams.md b/doc/fieldparams.md
@@ -120,7 +120,7 @@ implementation detail by client code. It automatically propagates through the
 field resolvers, and if there is a schema exception or one of the `getField`
 accessors throws another exception derived from `std::exception`, the
 `graphqlservice` library will automatically add the resulting path to the error
-report, accoring to the [spec](http://spec.graphql.org/June2018/#sec-Errors).
+report, accoring to the [spec](https://spec.graphql.org/October2021/#sec-Errors).
 
 ### Launch Policy
 
diff --git a/doc/responses.md b/doc/responses.md
@@ -7,7 +7,7 @@ As the comment in
 responses are not technically JSON-specific, although that is probably the most
 common way of representing them. These are the primitive types that may be
 represented in GraphQL, as of the
-[June 2018 spec](http://spec.graphql.org/June2018/#sec-Serialization-Format):
+[October 2021 spec](https://spec.graphql.org/October2021/#sec-Serialization-Format):
 
 ```c++
 enum class Type : uint8_t
diff --git a/include/graphqlservice/GraphQLResponse.h b/include/graphqlservice/GraphQLResponse.h
@@ -30,7 +30,7 @@ namespace graphql::response {
 
 // GraphQL responses are not technically JSON-specific, although that is probably the most common
 // way of representing them. These are the primitive types that may be represented in GraphQL, as
-// of the [June 2018 spec](http://spec.graphql.org/June2018/#sec-Serialization-Format).
+// of the [October 2021 spec](https://spec.graphql.org/October2021/#sec-Serialization-Format).
 enum class Type : uint8_t
 {
 	Map,	   // JSON Object
diff --git a/samples/today/nointrospection/SubscriptionObject.cpp b/samples/today/nointrospection/SubscriptionObject.cpp
@@ -85,7 +85,7 @@ service::AwaitableResolver Subscription::resolve_typename(service::ResolverParam
 void AddSubscriptionDetails(const std::shared_ptr<schema::ObjectType>& typeSubscription, const std::shared_ptr<schema::Schema>& schema)
 {
 	typeSubscription->AddFields({
-		schema::Field::Make(R"gql(nextAppointmentChange)gql"sv, R"md()md"sv, std::make_optional(R"md(Need to deprecate a [field](http://spec.graphql.org/June2018/#sec-Deprecation))md"sv), schema->LookupType(R"gql(Appointment)gql"sv)),
+		schema::Field::Make(R"gql(nextAppointmentChange)gql"sv, R"md()md"sv, std::make_optional(R"md(Need to deprecate a [field](https://spec.graphql.org/October2021/#sec-Schema-Introspection.Deprecation))md"sv), schema->LookupType(R"gql(Appointment)gql"sv)),
 		schema::Field::Make(R"gql(nodeChange)gql"sv, R"md()md"sv, std::nullopt, schema->WrapType(introspection::TypeKind::NON_NULL, schema->LookupType(R"gql(Node)gql"sv)), {
 			schema::InputValue::Make(R"gql(id)gql"sv, R"md()md"sv, schema->WrapType(introspection::TypeKind::NON_NULL, schema->LookupType(R"gql(ID)gql"sv)), R"gql()gql"sv)
 		})
diff --git a/samples/today/nointrospection/TodaySchema.cpp b/samples/today/nointrospection/TodaySchema.cpp
@@ -213,7 +213,7 @@ void AddTypesToSchema(const std::shared_ptr<schema::Schema>& schema)
 		{ service::s_namesTaskState[static_cast<size_t>(today::TaskState::New)], R"md()md"sv, std::nullopt },
 		{ service::s_namesTaskState[static_cast<size_t>(today::TaskState::Started)], R"md()md"sv, std::nullopt },
 		{ service::s_namesTaskState[static_cast<size_t>(today::TaskState::Complete)], R"md()md"sv, std::nullopt },
-		{ service::s_namesTaskState[static_cast<size_t>(today::TaskState::Unassigned)], R"md()md"sv, std::make_optional(R"md(Need to deprecate an [enum value](http://spec.graphql.org/June2018/#sec-Deprecation))md"sv) }
+		{ service::s_namesTaskState[static_cast<size_t>(today::TaskState::Unassigned)], R"md()md"sv, std::make_optional(R"md(Need to deprecate an [enum value](https://spec.graphql.org/October2021/#sec-Schema-Introspection.Deprecation))md"sv) }
 	});
 
 	typeCompleteTaskInput->AddInputValues({
diff --git a/samples/today/schema.today.graphql b/samples/today/schema.today.graphql
@@ -106,7 +106,7 @@ type Mutation {
     """
 type Subscription {
     nextAppointmentChange : Appointment @deprecated(
-        reason:"""Need to deprecate a [field](http://spec.graphql.org/June2018/#sec-Deprecation)"""
+        reason:"""Need to deprecate a [field](https://spec.graphql.org/October2021/#sec-Schema-Introspection.Deprecation)"""
     )
     nodeChange(id: ID!): Node!
 }
@@ -120,7 +120,7 @@ enum TaskState {
     Started
     Complete
     Unassigned @deprecated(
-        reason:"""Need to deprecate an [enum value](http://spec.graphql.org/June2018/#sec-Deprecation)"""
+        reason:"""Need to deprecate an [enum value](https://spec.graphql.org/October2021/#sec-Schema-Introspection.Deprecation)"""
     )
 }
 
diff --git a/samples/today/schema/SubscriptionObject.cpp b/samples/today/schema/SubscriptionObject.cpp
@@ -85,7 +85,7 @@ service::AwaitableResolver Subscription::resolve_typename(service::ResolverParam
 void AddSubscriptionDetails(const std::shared_ptr<schema::ObjectType>& typeSubscription, const std::shared_ptr<schema::Schema>& schema)
 {
 	typeSubscription->AddFields({
-		schema::Field::Make(R"gql(nextAppointmentChange)gql"sv, R"md()md"sv, std::make_optional(R"md(Need to deprecate a [field](http://spec.graphql.org/June2018/#sec-Deprecation))md"sv), schema->LookupType(R"gql(Appointment)gql"sv)),
+		schema::Field::Make(R"gql(nextAppointmentChange)gql"sv, R"md()md"sv, std::make_optional(R"md(Need to deprecate a [field](https://spec.graphql.org/October2021/#sec-Schema-Introspection.Deprecation))md"sv), schema->LookupType(R"gql(Appointment)gql"sv)),
 		schema::Field::Make(R"gql(nodeChange)gql"sv, R"md()md"sv, std::nullopt, schema->WrapType(introspection::TypeKind::NON_NULL, schema->LookupType(R"gql(Node)gql"sv)), {
 			schema::InputValue::Make(R"gql(id)gql"sv, R"md()md"sv, schema->WrapType(introspection::TypeKind::NON_NULL, schema->LookupType(R"gql(ID)gql"sv)), R"gql()gql"sv)
 		})
diff --git a/samples/today/schema/TodaySchema.cpp b/samples/today/schema/TodaySchema.cpp
@@ -216,7 +216,7 @@ void AddTypesToSchema(const std::shared_ptr<schema::Schema>& schema)
 		{ service::s_namesTaskState[static_cast<size_t>(today::TaskState::New)], R"md()md"sv, std::nullopt },
 		{ service::s_namesTaskState[static_cast<size_t>(today::TaskState::Started)], R"md()md"sv, std::nullopt },
 		{ service::s_namesTaskState[static_cast<size_t>(today::TaskState::Complete)], R"md()md"sv, std::nullopt },
-		{ service::s_namesTaskState[static_cast<size_t>(today::TaskState::Unassigned)], R"md()md"sv, std::make_optional(R"md(Need to deprecate an [enum value](http://spec.graphql.org/June2018/#sec-Deprecation))md"sv) }
+		{ service::s_namesTaskState[static_cast<size_t>(today::TaskState::Unassigned)], R"md()md"sv, std::make_optional(R"md(Need to deprecate an [enum value](https://spec.graphql.org/October2021/#sec-Schema-Introspection.Deprecation))md"sv) }
 	});
 
 	typeCompleteTaskInput->AddInputValues({
diff --git a/samples/validation/schema/schema.validation.graphql b/samples/validation/schema/schema.validation.graphql
@@ -1,7 +1,7 @@
 # Copyright (c) Microsoft Corporation. All rights reserved.
 # Licensed under the MIT License.
 
-"GraphQL validation [sample](http://spec.graphql.org/October2021/#example-19f2a)"
+"GraphQL validation [sample](https://spec.graphql.org/October2021/#example-19f2a)"
 type Query {
   dog: Dog
 }
diff --git a/src/GraphQLService.cpp b/src/GraphQLService.cpp
@@ -591,7 +591,7 @@ response::IdType ModifiedArgument<response::IdType>::convert(const response::Val
 
 void blockSubFields(const ResolverParams& params)
 {
-	// http://spec.graphql.org/June2018/#sec-Leaf-Field-Selections
+	// https://spec.graphql.org/October2021/#sec-Leaf-Field-Selections
 	if (params.selection != nullptr)
 	{
 		auto position = params.selection->begin();
@@ -676,7 +676,7 @@ AwaitableResolver ModifiedResult<response::IdType>::convert(
 
 void requireSubFields(const ResolverParams& params)
 {
-	// http://spec.graphql.org/June2018/#sec-Leaf-Field-Selections
+	// https://spec.graphql.org/October2021/#sec-Leaf-Field-Selections
 	if (params.selection == nullptr)
 	{
 		auto position = params.field.begin();
@@ -1455,7 +1455,7 @@ void SubscriptionDefinitionVisitor::visitField(const peg::ast_node& field)
 		name = child.string_view();
 	});
 
-	// http://spec.graphql.org/June2018/#sec-Single-root-field
+	// https://spec.graphql.org/October2021/#sec-Single-root-field
 	if (!_field.empty())
 	{
 		auto position = field.begin();
@@ -1698,7 +1698,7 @@ response::AwaitableValue Request::resolve(await_async launch, std::shared_ptr<Re
 		const bool isMutation = (operationDefinition.first == strMutation);
 		const auto resolverContext =
 			isMutation ? ResolverContext::Mutation : ResolverContext::Query;
-		// http://spec.graphql.org/June2018/#sec-Normal-and-Serial-Execution
+		// https://spec.graphql.org/October2021/#sec-Normal-and-Serial-Execution
 		const auto operationLaunch = isMutation ? await_async { std::launch::deferred } : launch;
 
 		OperationDefinitionVisitor operationVisitor(resolverContext,
diff --git a/src/JSONResponse.cpp b/src/JSONResponse.cpp
@@ -138,7 +138,7 @@ struct ResponseHandler : rapidjson::BaseReaderHandler<rapidjson::UTF8<>, Respons
 
 	bool Int(int i)
 	{
-		// http://spec.graphql.org/June2018/#sec-Int
+		// https://spec.graphql.org/October2021/#sec-Int
 		static_assert(sizeof(i) == 4, "GraphQL only supports 32-bit signed integers");
 		auto value = Value(Type::Int);
 
@@ -151,21 +151,21 @@ struct ResponseHandler : rapidjson::BaseReaderHandler<rapidjson::UTF8<>, Respons
 	{
 		if (i > static_cast<unsigned int>(std::numeric_limits<int>::max()))
 		{
-			// http://spec.graphql.org/June2018/#sec-Int
+			// https://spec.graphql.org/October2021/#sec-Int
 			throw std::overflow_error("GraphQL only supports 32-bit signed integers");
 		}
 		return Int(static_cast<int>(i));
 	}
 
 	bool Int64(int64_t /*i*/)
 	{
-		// http://spec.graphql.org/June2018/#sec-Int
+		// https://spec.graphql.org/October2021/#sec-Int
 		throw std::overflow_error("GraphQL only supports 32-bit signed integers");
 	}
 
 	bool Uint64(uint64_t /*i*/)
 	{
-		// http://spec.graphql.org/June2018/#sec-Int
+		// https://spec.graphql.org/October2021/#sec-Int
 		throw std::overflow_error("GraphQL only supports 32-bit signed integers");
 	}
 
diff --git a/src/Validation.cpp b/src/Validation.cpp

Original file line number	Diff line number	Diff line change
`@@ -30,7 +30,7 @@ namespace graphql::response {`
`30`	`30`
`31`	`31`	`// GraphQL responses are not technically JSON-specific, although that is probably the most common`
`32`	`32`	`// way of representing them. These are the primitive types that may be represented in GraphQL, as`
`33`		`-// of the [June 2018 spec](http://spec.graphql.org/June2018/#sec-Serialization-Format).`
	`33`	`+// of the [October 2021 spec](https://spec.graphql.org/October2021/#sec-Serialization-Format).`
`34`	`34`	`enum class Type : uint8_t`
`35`	`35`	`{`
`36`	`36`	`Map, // JSON Object`
Original file line number	Diff line number	Diff line change
`@@ -85,7 +85,7 @@ service::AwaitableResolver Subscription::resolve_typename(service::ResolverParam`
`85`	`85`	`void AddSubscriptionDetails(const std::shared_ptr<schema::ObjectType>& typeSubscription, const std::shared_ptr<schema::Schema>& schema)`
`86`	`86`	`{`
`87`	`87`	`typeSubscription->AddFields({`
`88`		`- schema::Field::Make(R"gql(nextAppointmentChange)gql"sv, R"md()md"sv, std::make_optional(R"md(Need to deprecate a [field](http://spec.graphql.org/June2018/#sec-Deprecation))md"sv), schema->LookupType(R"gql(Appointment)gql"sv)),`
	`88`	`+ schema::Field::Make(R"gql(nextAppointmentChange)gql"sv, R"md()md"sv, std::make_optional(R"md(Need to deprecate a [field](https://spec.graphql.org/October2021/#sec-Schema-Introspection.Deprecation))md"sv), schema->LookupType(R"gql(Appointment)gql"sv)),`
`89`	`89`	`schema::Field::Make(R"gql(nodeChange)gql"sv, R"md()md"sv, std::nullopt, schema->WrapType(introspection::TypeKind::NON_NULL, schema->LookupType(R"gql(Node)gql"sv)), {`
`90`	`90`	`schema::InputValue::Make(R"gql(id)gql"sv, R"md()md"sv, schema->WrapType(introspection::TypeKind::NON_NULL, schema->LookupType(R"gql(ID)gql"sv)), R"gql()gql"sv)`
`91`	`91`	`})`
Original file line number	Diff line number	Diff line change
`@@ -106,7 +106,7 @@ type Mutation {`
`106`	`106`	`"""`
`107`	`107`	`type Subscription {`
`108`	`108`	`nextAppointmentChange : Appointment @deprecated(`
`109`		`- reason:"""Need to deprecate a [field](http://spec.graphql.org/June2018/#sec-Deprecation)"""`
	`109`	`+ reason:"""Need to deprecate a [field](https://spec.graphql.org/October2021/#sec-Schema-Introspection.Deprecation)"""`
`110`	`110`	`)`
`111`	`111`	`nodeChange(id: ID!): Node!`
`112`	`112`	`}`
`@@ -120,7 +120,7 @@ enum TaskState {`
`120`	`120`	`Started`
`121`	`121`	`Complete`
`122`	`122`	`Unassigned @deprecated(`
`123`		`- reason:"""Need to deprecate an [enum value](http://spec.graphql.org/June2018/#sec-Deprecation)"""`
	`123`	`+ reason:"""Need to deprecate an [enum value](https://spec.graphql.org/October2021/#sec-Schema-Introspection.Deprecation)"""`
`124`	`124`	`)`
`125`	`125`	`}`
`126`	`126`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`# Copyright (c) Microsoft Corporation. All rights reserved.`
`2`	`2`	`# Licensed under the MIT License.`
`3`	`3`
`4`		`-"GraphQL validation [sample](http://spec.graphql.org/October2021/#example-19f2a)"`
	`4`	`+"GraphQL validation [sample](https://spec.graphql.org/October2021/#example-19f2a)"`
`5`	`5`	`type Query {`
`6`	`6`	`dog: Dog`
`7`	`7`	`}`
Original file line number	Diff line number	Diff line change
`@@ -591,7 +591,7 @@ response::IdType ModifiedArgument<response::IdType>::convert(const response::Val`
`591`	`591`
`592`	`592`	`void blockSubFields(const ResolverParams& params)`
`593`	`593`	`{`
`594`		`- // http://spec.graphql.org/June2018/#sec-Leaf-Field-Selections`
	`594`	`+ // https://spec.graphql.org/October2021/#sec-Leaf-Field-Selections`
`595`	`595`	`if (params.selection != nullptr)`
`596`	`596`	`{`
`597`	`597`	`auto position = params.selection->begin();`
`@@ -676,7 +676,7 @@ AwaitableResolver ModifiedResult<response::IdType>::convert(`
`676`	`676`
`677`	`677`	`void requireSubFields(const ResolverParams& params)`
`678`	`678`	`{`
`679`		`- // http://spec.graphql.org/June2018/#sec-Leaf-Field-Selections`
	`679`	`+ // https://spec.graphql.org/October2021/#sec-Leaf-Field-Selections`
`680`	`680`	`if (params.selection == nullptr)`
`681`	`681`	`{`
`682`	`682`	`auto position = params.field.begin();`
`@@ -1455,7 +1455,7 @@ void SubscriptionDefinitionVisitor::visitField(const peg::ast_node& field)`
`1455`	`1455`	`name = child.string_view();`
`1456`	`1456`	`});`
`1457`	`1457`
`1458`		`- // http://spec.graphql.org/June2018/#sec-Single-root-field`
	`1458`	`+ // https://spec.graphql.org/October2021/#sec-Single-root-field`
`1459`	`1459`	`if (!_field.empty())`
`1460`	`1460`	`{`
`1461`	`1461`	`auto position = field.begin();`
`@@ -1698,7 +1698,7 @@ response::AwaitableValue Request::resolve(await_async launch, std::shared_ptr<Re`
`1698`	`1698`	`const bool isMutation = (operationDefinition.first == strMutation);`
`1699`	`1699`	`const auto resolverContext =`
`1700`	`1700`	`isMutation ? ResolverContext::Mutation : ResolverContext::Query;`
`1701`		`- // http://spec.graphql.org/June2018/#sec-Normal-and-Serial-Execution`
	`1701`	`+ // https://spec.graphql.org/October2021/#sec-Normal-and-Serial-Execution`
`1702`	`1702`	`const auto operationLaunch = isMutation ? await_async { std::launch::deferred } : launch;`
`1703`	`1703`
`1704`	`1704`	`OperationDefinitionVisitor operationVisitor(resolverContext,`