Synchronize and fix styling of __init.py__ files

Replicates graphql/graphql-js@86f6e82

Author: Cito

graphql/__init__.py

@@ -46,8 +46,9 @@
 
 # Create and operate on GraphQL type definitions and schema.
 from .type import (
-    GraphQLSchema,
     # Definitions
+    GraphQLSchema,
+    GraphQLDirective,
     GraphQLScalarType,
     GraphQLObjectType,
     GraphQLInterfaceType,
@@ -57,10 +58,7 @@
     GraphQLInputObjectType,
     GraphQLList,
     GraphQLNonNull,
-    GraphQLDirective,
-    # "Enum" of Type Kinds
-    TypeKind,
-    # Scalars
+    # Standard GraphQL Scalars
     specified_scalar_types,
     GraphQLInt,
     GraphQLFloat,
@@ -72,14 +70,16 @@
     GraphQLIncludeDirective,
     GraphQLSkipDirective,
     GraphQLDeprecatedDirective,
+    # "Enum" of Type Kinds
+    TypeKind,
     # Constant Deprecation Reason
     DEFAULT_DEPRECATION_REASON,
+    # GraphQL Types for introspection.
+    introspection_types,
     # Meta-field definitions.
     SchemaMetaFieldDef,
     TypeMetaFieldDef,
     TypeNameMetaFieldDef,
-    # GraphQL Types for introspection.
-    introspection_types,
     # Predicates
     is_schema,
     is_directive,
@@ -167,6 +167,7 @@
     get_location,
     # Lex
     Lexer,
+    TokenKind,
     # Parse
     parse,
     parse_value,
@@ -178,12 +179,11 @@
     ParallelVisitor,
     TypeInfoVisitor,
     Visitor,
-    TokenKind,
-    DirectiveLocation,
     BREAK,
     SKIP,
     REMOVE,
     IDLE,
+    DirectiveLocation,
     # Predicates
     is_definition_node,
     is_executable_definition_node,
@@ -196,9 +196,11 @@
     is_type_extension_node,
     # Types
     SourceLocation,
-    # AST nodes
     Location,
     Token,
+    # AST nodes
+    Node,
+    # Each kind of AST node
     NameNode,
     DocumentNode,
     DefinitionNode,
@@ -254,7 +256,7 @@
     InputObjectTypeExtensionNode,
 )
 
-# Execute GraphQL queries.
+# Execute GraphQL documents.
 from .execution import (
     execute,
     default_field_resolver,
@@ -341,10 +343,10 @@
     lexicographic_sort_schema,
     # Print a GraphQLSchema to GraphQL Schema language.
     print_schema,
-    # Prints the built-in introspection schema in the Schema Language format.
-    print_introspection_schema,
     # Print a GraphQLType to GraphQL Schema language.
     print_type,
+    # Prints the built-in introspection schema in the Schema Language format.
+    print_introspection_schema,
     # Create a GraphQLType from a GraphQL language AST.
     type_from_ast,
     # Create a Python value from a GraphQL language AST with a Type.
@@ -374,18 +376,19 @@
     # Determine if a string is a valid GraphQL name.
     is_valid_name_error,
     # Compare two GraphQLSchemas and detect breaking changes.
-    find_breaking_changes,
-    find_dangerous_changes,
     BreakingChange,
     BreakingChangeType,
     DangerousChange,
     DangerousChangeType,
+    find_breaking_changes,
+    find_dangerous_changes,
 )
 
 __all__ = [
     "graphql",
     "graphql_sync",
     "GraphQLSchema",
+    "GraphQLDirective",
     "GraphQLScalarType",
     "GraphQLObjectType",
     "GraphQLInterfaceType",
@@ -395,8 +398,6 @@
     "GraphQLInputObjectType",
     "GraphQLList",
     "GraphQLNonNull",
-    "GraphQLDirective",
-    "TypeKind",
     "specified_scalar_types",
     "GraphQLInt",
     "GraphQLFloat",
@@ -407,11 +408,12 @@
     "GraphQLIncludeDirective",
     "GraphQLSkipDirective",
     "GraphQLDeprecatedDirective",
+    "TypeKind",
     "DEFAULT_DEPRECATION_REASON",
+    "introspection_types",
     "SchemaMetaFieldDef",
     "TypeMetaFieldDef",
     "TypeNameMetaFieldDef",
-    "introspection_types",
     "is_schema",
     "is_directive",
     "is_type",
@@ -489,6 +491,7 @@
     "Source",
     "get_location",
     "Lexer",
+    "TokenKind",
     "parse",
     "parse_value",
     "parse_type",
@@ -497,12 +500,11 @@
     "ParallelVisitor",
     "TypeInfoVisitor",
     "Visitor",
-    "TokenKind",
-    "DirectiveLocation",
     "BREAK",
     "SKIP",
     "REMOVE",
     "IDLE",
+    "DirectiveLocation",
     "is_definition_node",
     "is_executable_definition_node",
     "is_selection_node",
@@ -515,6 +517,7 @@
     "SourceLocation",
     "Location",
     "Token",
+    "Node",
     "NameNode",
     "DocumentNode",
     "DefinitionNode",
@@ -625,8 +628,8 @@
     "extend_schema",
     "lexicographic_sort_schema",
     "print_schema",
-    "print_introspection_schema",
     "print_type",
+    "print_introspection_schema",
     "type_from_ast",
     "value_from_ast",
     "value_from_ast_untyped",

graphql/error/__init__.py

@@ -5,10 +5,15 @@
 """
 
 from .graphql_error import GraphQLError
+
 from .syntax_error import GraphQLSyntaxError
+
 from .located_error import located_error
+
 from .print_error import print_error
+
 from .format_error import format_error
+
 from .invalid import INVALID, InvalidType
 
 __all__ = [

graphql/error/format_error.py

@@ -7,7 +7,7 @@
 __all__ = ["format_error"]
 
 
-def format_error(error: "GraphQLError") -> dict:
+def format_error(error: "GraphQLError") -> Dict[str, Any]:
     """Format a GraphQL error
 
     Given a GraphQLError, format it according to the rules described by the "Response

graphql/execution/__init__.py

@@ -13,7 +13,9 @@
     ExecutionResult,
     Middleware,
 )
+
 from .middleware import MiddlewareManager
+
 from .values import get_directive_values
 
 __all__ = [

graphql/language/__init__.py

@@ -4,11 +4,16 @@
 GraphQL language.
 """
 
+from .source import Source
+
 from .location import get_location, SourceLocation
+
 from .lexer import Lexer, TokenKind, Token
+
 from .parser import parse, parse_type, parse_value
+
 from .printer import print_ast
-from .source import Source
+
 from .visitor import (
     visit,
     Visitor,
@@ -19,6 +24,7 @@
     REMOVE,
     IDLE,
 )
+
 from .ast import (
     Location,
     Node,

graphql/type/__init__.py

@@ -115,7 +115,9 @@
 
 # Common built-in scalar instances.
 from .scalars import (
+    # Predicate
     is_specified_scalar_type,
+    # Standard GraphQL Scalars
     specified_scalar_types,
     GraphQLInt,
     GraphQLFloat,
@@ -125,17 +127,19 @@
 )
 
 from .introspection import (
-    # "Enum" of Type Kinds
-    TypeKind,
-    # GraphQL Types for introspection.
+    # Predicate
     is_introspection_type,
+    # GraphQL Types for introspection.
     introspection_types,
+    # "Enum" of Type Kinds
+    TypeKind,
     # Meta-field definitions.
     SchemaMetaFieldDef,
     TypeMetaFieldDef,
     TypeNameMetaFieldDef,
 )
 
+# Validate GraphQL schema.
 from .validate import validate_schema, assert_valid_schema
 
 __all__ = [
@@ -234,9 +238,9 @@
     "GraphQLString",
     "GraphQLBoolean",
     "GraphQLID",
-    "TypeKind",
     "is_introspection_type",
     "introspection_types",
+    "TypeKind",
     "SchemaMetaFieldDef",
     "TypeMetaFieldDef",
     "TypeNameMetaFieldDef",

graphql/utilities/__init__.py

@@ -4,7 +4,7 @@
 the GraphQL language and type objects.
 """
 
-# The GraphQL query recommended for a full schema introspection.
+# Produce the GraphQL query recommended for a full schema introspection.
 from .introspection_query import get_introspection_query
 
 # Get the target Operation from a Document.

graphql/validation/__init__.py

@@ -10,6 +10,7 @@
 
 from .rules import ValidationRule, ASTValidationRule, SDLValidationRule
 
+# All validation rules in the GraphQL Specification.
 from .specified_rules import specified_rules
 
 # Spec Section: "Executable Definitions"