graphql 0.16.0 → 2.0.15
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/.yardopts +5 -0
- data/lib/generators/graphql/core.rb +69 -0
- data/lib/generators/graphql/enum_generator.rb +27 -0
- data/lib/generators/graphql/field_extractor.rb +31 -0
- data/lib/generators/graphql/input_generator.rb +50 -0
- data/lib/generators/graphql/install/mutation_root_generator.rb +34 -0
- data/lib/generators/graphql/install/templates/base_mutation.erb +10 -0
- data/lib/generators/graphql/install/templates/mutation_type.erb +12 -0
- data/lib/generators/graphql/install_generator.rb +197 -0
- data/lib/generators/graphql/interface_generator.rb +27 -0
- data/lib/generators/graphql/loader_generator.rb +21 -0
- data/lib/generators/graphql/mutation_create_generator.rb +22 -0
- data/lib/generators/graphql/mutation_delete_generator.rb +22 -0
- data/lib/generators/graphql/mutation_generator.rb +30 -0
- data/lib/generators/graphql/mutation_update_generator.rb +22 -0
- data/lib/generators/graphql/object_generator.rb +50 -0
- data/lib/generators/graphql/orm_mutations_base.rb +40 -0
- data/lib/generators/graphql/relay.rb +49 -0
- data/lib/generators/graphql/relay_generator.rb +21 -0
- data/lib/generators/graphql/scalar_generator.rb +22 -0
- data/lib/generators/graphql/templates/base_argument.erb +6 -0
- data/lib/generators/graphql/templates/base_connection.erb +8 -0
- data/lib/generators/graphql/templates/base_edge.erb +8 -0
- data/lib/generators/graphql/templates/base_enum.erb +6 -0
- data/lib/generators/graphql/templates/base_field.erb +7 -0
- data/lib/generators/graphql/templates/base_input_object.erb +7 -0
- data/lib/generators/graphql/templates/base_interface.erb +9 -0
- data/lib/generators/graphql/templates/base_object.erb +7 -0
- data/lib/generators/graphql/templates/base_scalar.erb +6 -0
- data/lib/generators/graphql/templates/base_union.erb +6 -0
- data/lib/generators/graphql/templates/enum.erb +11 -0
- data/lib/generators/graphql/templates/graphql_controller.erb +52 -0
- data/lib/generators/graphql/templates/input.erb +9 -0
- data/lib/generators/graphql/templates/interface.erb +10 -0
- data/lib/generators/graphql/templates/loader.erb +19 -0
- data/lib/generators/graphql/templates/mutation.erb +16 -0
- data/lib/generators/graphql/templates/mutation_create.erb +20 -0
- data/lib/generators/graphql/templates/mutation_delete.erb +20 -0
- data/lib/generators/graphql/templates/mutation_update.erb +21 -0
- data/lib/generators/graphql/templates/node_type.erb +9 -0
- data/lib/generators/graphql/templates/object.erb +10 -0
- data/lib/generators/graphql/templates/query_type.erb +15 -0
- data/lib/generators/graphql/templates/scalar.erb +17 -0
- data/lib/generators/graphql/templates/schema.erb +30 -0
- data/lib/generators/graphql/templates/union.erb +9 -0
- data/lib/generators/graphql/type_generator.rb +135 -0
- data/lib/generators/graphql/union_generator.rb +33 -0
- data/lib/graphql/analysis/ast/analyzer.rb +84 -0
- data/lib/graphql/analysis/ast/field_usage.rb +57 -0
- data/lib/graphql/analysis/ast/max_query_complexity.rb +22 -0
- data/lib/graphql/analysis/ast/max_query_depth.rb +22 -0
- data/lib/graphql/analysis/ast/query_complexity.rb +230 -0
- data/lib/graphql/analysis/ast/query_depth.rb +55 -0
- data/lib/graphql/analysis/ast/visitor.rb +269 -0
- data/lib/graphql/analysis/ast.rb +81 -0
- data/lib/graphql/analysis.rb +2 -5
- data/lib/graphql/analysis_error.rb +1 -0
- data/lib/graphql/backtrace/inspect_result.rb +50 -0
- data/lib/graphql/backtrace/table.rb +141 -0
- data/lib/graphql/backtrace/traced_error.rb +54 -0
- data/lib/graphql/backtrace/tracer.rb +80 -0
- data/lib/graphql/backtrace.rb +58 -0
- data/lib/graphql/coercion_error.rb +13 -0
- data/lib/graphql/dataloader/null_dataloader.rb +24 -0
- data/lib/graphql/dataloader/request.rb +19 -0
- data/lib/graphql/dataloader/request_all.rb +19 -0
- data/lib/graphql/dataloader/source.rb +164 -0
- data/lib/graphql/dataloader.rb +311 -0
- data/lib/graphql/date_encoding_error.rb +16 -0
- data/lib/graphql/deprecation.rb +9 -0
- data/lib/graphql/dig.rb +19 -0
- data/lib/graphql/execution/directive_checks.rb +37 -0
- data/lib/graphql/execution/errors.rb +93 -0
- data/lib/graphql/execution/interpreter/argument_value.rb +28 -0
- data/lib/graphql/execution/interpreter/arguments.rb +88 -0
- data/lib/graphql/execution/interpreter/arguments_cache.rb +105 -0
- data/lib/graphql/execution/interpreter/execution_errors.rb +29 -0
- data/lib/graphql/execution/interpreter/handles_raw_value.rb +18 -0
- data/lib/graphql/execution/interpreter/resolve.rb +77 -0
- data/lib/graphql/execution/interpreter/runtime.rb +994 -0
- data/lib/graphql/execution/interpreter.rb +226 -0
- data/lib/graphql/execution/lazy/lazy_method_map.rb +98 -0
- data/lib/graphql/execution/lazy.rb +75 -0
- data/lib/graphql/execution/lookahead.rb +311 -0
- data/lib/graphql/execution/multiplex.rb +45 -0
- data/lib/graphql/execution.rb +18 -0
- data/lib/graphql/execution_error.rb +34 -1
- data/lib/graphql/filter.rb +53 -0
- data/lib/graphql/integer_decoding_error.rb +17 -0
- data/lib/graphql/integer_encoding_error.rb +36 -0
- data/lib/graphql/introspection/base_object.rb +13 -0
- data/lib/graphql/introspection/directive_location_enum.rb +12 -5
- data/lib/graphql/introspection/directive_type.rb +30 -10
- data/lib/graphql/introspection/dynamic_fields.rb +12 -0
- data/lib/graphql/introspection/entry_points.rb +22 -0
- data/lib/graphql/introspection/enum_value_type.rb +21 -8
- data/lib/graphql/introspection/field_type.rb +26 -10
- data/lib/graphql/introspection/input_value_type.rb +64 -14
- data/lib/graphql/introspection/introspection_query.rb +7 -76
- data/lib/graphql/introspection/schema_type.rb +42 -17
- data/lib/graphql/introspection/type_kind_enum.rb +11 -5
- data/lib/graphql/introspection/type_type.rb +104 -16
- data/lib/graphql/introspection.rb +104 -13
- data/lib/graphql/invalid_name_error.rb +11 -0
- data/lib/graphql/invalid_null_error.rb +36 -8
- data/lib/graphql/language/block_string.rb +99 -0
- data/lib/graphql/language/cache.rb +37 -0
- data/lib/graphql/language/definition_slice.rb +41 -0
- data/lib/graphql/language/document_from_schema_definition.rb +335 -0
- data/lib/graphql/language/generation.rb +16 -86
- data/lib/graphql/language/lexer.rb +1436 -705
- data/lib/graphql/language/lexer.rl +172 -64
- data/lib/graphql/language/nodes.rb +617 -105
- data/lib/graphql/language/parser.rb +1524 -430
- data/lib/graphql/language/parser.y +348 -73
- data/lib/graphql/language/printer.rb +386 -0
- data/lib/graphql/language/sanitized_printer.rb +222 -0
- data/lib/graphql/language/token.rb +16 -3
- data/lib/graphql/language/visitor.rb +169 -25
- data/lib/graphql/language.rb +30 -0
- data/lib/graphql/load_application_object_failed_error.rb +22 -0
- data/lib/graphql/name_validator.rb +11 -0
- data/lib/graphql/pagination/active_record_relation_connection.rb +85 -0
- data/lib/graphql/pagination/array_connection.rb +79 -0
- data/lib/graphql/pagination/connection.rb +253 -0
- data/lib/graphql/pagination/connections.rb +135 -0
- data/lib/graphql/pagination/mongoid_relation_connection.rb +25 -0
- data/lib/graphql/pagination/relation_connection.rb +228 -0
- data/lib/graphql/pagination/sequel_dataset_connection.rb +28 -0
- data/lib/graphql/pagination.rb +6 -0
- data/lib/graphql/parse_error.rb +24 -0
- data/lib/graphql/query/context.rb +266 -12
- data/lib/graphql/query/fingerprint.rb +26 -0
- data/lib/graphql/query/input_validation_result.rb +34 -7
- data/lib/graphql/query/null_context.rb +52 -0
- data/lib/graphql/query/result.rb +63 -0
- data/lib/graphql/query/validation_pipeline.rb +114 -0
- data/lib/graphql/query/variable_validation_error.rb +27 -3
- data/lib/graphql/query/variables.rb +75 -24
- data/lib/graphql/query.rb +359 -92
- data/lib/graphql/railtie.rb +13 -0
- data/lib/graphql/rake_task/validate.rb +63 -0
- data/lib/graphql/rake_task.rb +146 -0
- data/lib/graphql/relay/range_add.rb +52 -0
- data/lib/graphql/relay.rb +3 -0
- data/lib/graphql/rubocop/graphql/base_cop.rb +36 -0
- data/lib/graphql/rubocop/graphql/default_null_true.rb +43 -0
- data/lib/graphql/rubocop/graphql/default_required_true.rb +43 -0
- data/lib/graphql/rubocop.rb +4 -0
- data/lib/graphql/runtime_type_error.rb +5 -0
- data/lib/graphql/schema/addition.rb +245 -0
- data/lib/graphql/schema/argument.rb +395 -0
- data/lib/graphql/schema/base_64_bp.rb +26 -0
- data/lib/graphql/schema/base_64_encoder.rb +21 -0
- data/lib/graphql/schema/build_from_definition/resolve_map/default_resolve.rb +47 -0
- data/lib/graphql/schema/build_from_definition/resolve_map.rb +78 -0
- data/lib/graphql/schema/build_from_definition.rb +492 -0
- data/lib/graphql/schema/built_in_types.rb +12 -0
- data/lib/graphql/schema/directive/deprecated.rb +18 -0
- data/lib/graphql/schema/directive/feature.rb +66 -0
- data/lib/graphql/schema/directive/flagged.rb +57 -0
- data/lib/graphql/schema/directive/include.rb +25 -0
- data/lib/graphql/schema/directive/one_of.rb +12 -0
- data/lib/graphql/schema/directive/skip.rb +25 -0
- data/lib/graphql/schema/directive/transform.rb +60 -0
- data/lib/graphql/schema/directive.rb +212 -0
- data/lib/graphql/schema/enum.rb +176 -0
- data/lib/graphql/schema/enum_value.rb +77 -0
- data/lib/graphql/schema/field/connection_extension.rb +80 -0
- data/lib/graphql/schema/field/scope_extension.rb +22 -0
- data/lib/graphql/schema/field.rb +862 -0
- data/lib/graphql/schema/field_extension.rb +156 -0
- data/lib/graphql/schema/find_inherited_value.rb +36 -0
- data/lib/graphql/schema/finder.rb +155 -0
- data/lib/graphql/schema/input_object.rb +258 -0
- data/lib/graphql/schema/interface.rb +113 -0
- data/lib/graphql/schema/introspection_system.rb +164 -0
- data/lib/graphql/schema/invalid_type_error.rb +1 -0
- data/lib/graphql/schema/late_bound_type.rb +37 -0
- data/lib/graphql/schema/list.rb +86 -0
- data/lib/graphql/schema/loader.rb +228 -0
- data/lib/graphql/schema/member/base_dsl_methods.rb +124 -0
- data/lib/graphql/schema/member/build_type.rb +178 -0
- data/lib/graphql/schema/member/graphql_type_names.rb +21 -0
- data/lib/graphql/schema/member/has_arguments.rb +376 -0
- data/lib/graphql/schema/member/has_ast_node.rb +20 -0
- data/lib/graphql/schema/member/has_deprecation_reason.rb +25 -0
- data/lib/graphql/schema/member/has_directives.rb +113 -0
- data/lib/graphql/schema/member/has_fields.rb +163 -0
- data/lib/graphql/schema/member/has_interfaces.rb +88 -0
- data/lib/graphql/schema/member/has_path.rb +25 -0
- data/lib/graphql/schema/member/has_unresolved_type_error.rb +15 -0
- data/lib/graphql/schema/member/has_validators.rb +31 -0
- data/lib/graphql/schema/member/relay_shortcuts.rb +73 -0
- data/lib/graphql/schema/member/scoped.rb +21 -0
- data/lib/graphql/schema/member/type_system_helpers.rb +38 -0
- data/lib/graphql/schema/member/validates_input.rb +33 -0
- data/lib/graphql/schema/member.rb +39 -0
- data/lib/graphql/schema/mutation.rb +85 -0
- data/lib/graphql/schema/non_null.rb +67 -0
- data/lib/graphql/schema/null_mask.rb +11 -0
- data/lib/graphql/schema/object.rb +117 -0
- data/lib/graphql/schema/printer.rb +72 -128
- data/lib/graphql/schema/relay_classic_mutation.rb +179 -0
- data/lib/graphql/schema/resolver/has_payload_type.rb +106 -0
- data/lib/graphql/schema/resolver.rb +402 -0
- data/lib/graphql/schema/scalar.rb +68 -0
- data/lib/graphql/schema/subscription.rb +148 -0
- data/lib/graphql/schema/timeout.rb +123 -0
- data/lib/graphql/schema/type_expression.rb +29 -5
- data/lib/graphql/schema/type_membership.rb +51 -0
- data/lib/graphql/schema/union.rb +81 -0
- data/lib/graphql/schema/unique_within_type.rb +34 -0
- data/lib/graphql/schema/validator/allow_blank_validator.rb +29 -0
- data/lib/graphql/schema/validator/allow_null_validator.rb +26 -0
- data/lib/graphql/schema/validator/exclusion_validator.rb +33 -0
- data/lib/graphql/schema/validator/format_validator.rb +48 -0
- data/lib/graphql/schema/validator/inclusion_validator.rb +35 -0
- data/lib/graphql/schema/validator/length_validator.rb +59 -0
- data/lib/graphql/schema/validator/numericality_validator.rb +82 -0
- data/lib/graphql/schema/validator/required_validator.rb +82 -0
- data/lib/graphql/schema/validator.rb +171 -0
- data/lib/graphql/schema/warden.rb +413 -0
- data/lib/graphql/schema/wrapper.rb +24 -0
- data/lib/graphql/schema.rb +1179 -104
- data/lib/graphql/static_validation/all_rules.rb +14 -0
- data/lib/graphql/static_validation/base_visitor.rb +200 -0
- data/lib/graphql/static_validation/definition_dependencies.rb +198 -0
- data/lib/graphql/static_validation/error.rb +46 -0
- data/lib/graphql/static_validation/interpreter_visitor.rb +14 -0
- data/lib/graphql/static_validation/literal_validator.rb +113 -22
- data/lib/graphql/static_validation/rules/argument_literals_are_compatible.rb +59 -11
- data/lib/graphql/static_validation/rules/argument_literals_are_compatible_error.rb +48 -0
- data/lib/graphql/static_validation/rules/argument_names_are_unique.rb +31 -0
- data/lib/graphql/static_validation/rules/argument_names_are_unique_error.rb +30 -0
- data/lib/graphql/static_validation/rules/arguments_are_defined.rb +62 -8
- data/lib/graphql/static_validation/rules/arguments_are_defined_error.rb +37 -0
- data/lib/graphql/static_validation/rules/directives_are_defined.rb +20 -13
- data/lib/graphql/static_validation/rules/directives_are_defined_error.rb +29 -0
- data/lib/graphql/static_validation/rules/directives_are_in_valid_locations.rb +32 -26
- data/lib/graphql/static_validation/rules/directives_are_in_valid_locations_error.rb +31 -0
- data/lib/graphql/static_validation/rules/fields_are_defined_on_type.rb +21 -23
- data/lib/graphql/static_validation/rules/fields_are_defined_on_type_error.rb +32 -0
- data/lib/graphql/static_validation/rules/fields_have_appropriate_selections.rb +55 -18
- data/lib/graphql/static_validation/rules/fields_have_appropriate_selections_error.rb +31 -0
- data/lib/graphql/static_validation/rules/fields_will_merge.rb +390 -70
- data/lib/graphql/static_validation/rules/fields_will_merge_error.rb +53 -0
- data/lib/graphql/static_validation/rules/fragment_names_are_unique.rb +30 -0
- data/lib/graphql/static_validation/rules/fragment_names_are_unique_error.rb +29 -0
- data/lib/graphql/static_validation/rules/fragment_spreads_are_possible.rb +54 -37
- data/lib/graphql/static_validation/rules/fragment_spreads_are_possible_error.rb +35 -0
- data/lib/graphql/static_validation/rules/fragment_types_exist.rb +26 -16
- data/lib/graphql/static_validation/rules/fragment_types_exist_error.rb +29 -0
- data/lib/graphql/static_validation/rules/fragments_are_finite.rb +13 -19
- data/lib/graphql/static_validation/rules/fragments_are_finite_error.rb +29 -0
- data/lib/graphql/static_validation/rules/fragments_are_named.rb +16 -0
- data/lib/graphql/static_validation/rules/fragments_are_named_error.rb +26 -0
- data/lib/graphql/static_validation/rules/fragments_are_on_composite_types.rb +25 -20
- data/lib/graphql/static_validation/rules/fragments_are_on_composite_types_error.rb +30 -0
- data/lib/graphql/static_validation/rules/fragments_are_used.rb +22 -33
- data/lib/graphql/static_validation/rules/fragments_are_used_error.rb +29 -0
- data/lib/graphql/static_validation/rules/input_object_names_are_unique.rb +30 -0
- data/lib/graphql/static_validation/rules/input_object_names_are_unique_error.rb +30 -0
- data/lib/graphql/static_validation/rules/mutation_root_exists.rb +17 -0
- data/lib/graphql/static_validation/rules/mutation_root_exists_error.rb +26 -0
- data/lib/graphql/static_validation/rules/no_definitions_are_present.rb +41 -0
- data/lib/graphql/static_validation/rules/no_definitions_are_present_error.rb +25 -0
- data/lib/graphql/static_validation/rules/one_of_input_objects_are_valid.rb +66 -0
- data/lib/graphql/static_validation/rules/one_of_input_objects_are_valid_error.rb +29 -0
- data/lib/graphql/static_validation/rules/operation_names_are_valid.rb +36 -0
- data/lib/graphql/static_validation/rules/operation_names_are_valid_error.rb +28 -0
- data/lib/graphql/static_validation/rules/query_root_exists.rb +17 -0
- data/lib/graphql/static_validation/rules/query_root_exists_error.rb +26 -0
- data/lib/graphql/static_validation/rules/required_arguments_are_present.rb +22 -21
- data/lib/graphql/static_validation/rules/required_arguments_are_present_error.rb +35 -0
- data/lib/graphql/static_validation/rules/required_input_object_attributes_are_present.rb +59 -0
- data/lib/graphql/static_validation/rules/required_input_object_attributes_are_present_error.rb +35 -0
- data/lib/graphql/static_validation/rules/subscription_root_exists.rb +17 -0
- data/lib/graphql/static_validation/rules/subscription_root_exists_error.rb +26 -0
- data/lib/graphql/static_validation/rules/unique_directives_per_location.rb +56 -0
- data/lib/graphql/static_validation/rules/unique_directives_per_location_error.rb +29 -0
- data/lib/graphql/static_validation/rules/variable_default_values_are_correctly_typed.rb +36 -18
- data/lib/graphql/static_validation/rules/variable_default_values_are_correctly_typed_error.rb +39 -0
- data/lib/graphql/static_validation/rules/variable_names_are_unique.rb +24 -0
- data/lib/graphql/static_validation/rules/variable_names_are_unique_error.rb +29 -0
- data/lib/graphql/static_validation/rules/variable_usages_are_allowed.rb +103 -39
- data/lib/graphql/static_validation/rules/variable_usages_are_allowed_error.rb +38 -0
- data/lib/graphql/static_validation/rules/variables_are_input_types.rb +22 -14
- data/lib/graphql/static_validation/rules/variables_are_input_types_error.rb +32 -0
- data/lib/graphql/static_validation/rules/variables_are_used_and_defined.rb +92 -70
- data/lib/graphql/static_validation/rules/variables_are_used_and_defined_error.rb +37 -0
- data/lib/graphql/static_validation/type_stack.rb +85 -24
- data/lib/graphql/static_validation/validation_context.rb +25 -46
- data/lib/graphql/static_validation/validation_timeout_error.rb +25 -0
- data/lib/graphql/static_validation/validator.rb +46 -15
- data/lib/graphql/static_validation.rb +6 -3
- data/lib/graphql/string_encoding_error.rb +20 -0
- data/lib/graphql/subscriptions/action_cable_subscriptions.rb +247 -0
- data/lib/graphql/subscriptions/broadcast_analyzer.rb +81 -0
- data/lib/graphql/subscriptions/default_subscription_resolve_extension.rb +58 -0
- data/lib/graphql/subscriptions/event.rb +144 -0
- data/lib/graphql/subscriptions/instrumentation.rb +28 -0
- data/lib/graphql/subscriptions/serialize.rb +158 -0
- data/lib/graphql/subscriptions.rb +306 -0
- data/lib/graphql/tracing/active_support_notifications_tracing.rb +21 -0
- data/lib/graphql/tracing/appoptics_tracing.rb +173 -0
- data/lib/graphql/tracing/appsignal_tracing.rb +51 -0
- data/lib/graphql/tracing/data_dog_tracing.rb +100 -0
- data/lib/graphql/tracing/instrumentation_tracing.rb +83 -0
- data/lib/graphql/tracing/new_relic_tracing.rb +51 -0
- data/lib/graphql/tracing/notifications_tracing.rb +59 -0
- data/lib/graphql/tracing/platform_tracing.rb +122 -0
- data/lib/graphql/tracing/prometheus_tracing/graphql_collector.rb +32 -0
- data/lib/graphql/tracing/prometheus_tracing.rb +67 -0
- data/lib/graphql/tracing/scout_tracing.rb +54 -0
- data/lib/graphql/tracing/statsd_tracing.rb +42 -0
- data/lib/graphql/tracing.rb +94 -0
- data/lib/graphql/type_kinds.rb +50 -22
- data/lib/graphql/types/big_int.rb +23 -0
- data/lib/graphql/types/boolean.rb +18 -0
- data/lib/graphql/types/float.rb +19 -0
- data/lib/graphql/types/id.rb +24 -0
- data/lib/graphql/types/int.rb +36 -0
- data/lib/graphql/types/iso_8601_date.rb +45 -0
- data/lib/graphql/types/iso_8601_date_time.rb +76 -0
- data/lib/graphql/types/json.rb +25 -0
- data/lib/graphql/types/relay/base_connection.rb +49 -0
- data/lib/graphql/types/relay/base_edge.rb +29 -0
- data/lib/graphql/types/relay/connection_behaviors.rb +154 -0
- data/lib/graphql/types/relay/default_relay.rb +21 -0
- data/lib/graphql/types/relay/edge_behaviors.rb +64 -0
- data/lib/graphql/types/relay/has_node_field.rb +41 -0
- data/lib/graphql/types/relay/has_nodes_field.rb +41 -0
- data/lib/graphql/types/relay/node.rb +15 -0
- data/lib/graphql/types/relay/node_behaviors.rb +19 -0
- data/lib/graphql/types/relay/page_info.rb +11 -0
- data/lib/graphql/types/relay/page_info_behaviors.rb +25 -0
- data/lib/graphql/types/relay.rb +39 -0
- data/lib/graphql/types/string.rb +29 -0
- data/lib/graphql/types.rb +11 -0
- data/lib/graphql/unauthorized_error.rb +29 -0
- data/lib/graphql/unauthorized_field_error.rb +23 -0
- data/lib/graphql/unresolved_type_error.rb +35 -0
- data/lib/graphql/version.rb +2 -1
- data/lib/graphql.rb +86 -41
- data/readme.md +15 -101
- metadata +394 -279
- data/lib/graphql/analysis/analyze_query.rb +0 -73
- data/lib/graphql/analysis/max_query_complexity.rb +0 -25
- data/lib/graphql/analysis/max_query_depth.rb +0 -25
- data/lib/graphql/analysis/query_complexity.rb +0 -122
- data/lib/graphql/analysis/query_depth.rb +0 -54
- data/lib/graphql/argument.rb +0 -25
- data/lib/graphql/base_type.rb +0 -115
- data/lib/graphql/boolean_type.rb +0 -9
- data/lib/graphql/define/assign_argument.rb +0 -20
- data/lib/graphql/define/assign_enum_value.rb +0 -16
- data/lib/graphql/define/assign_object_field.rb +0 -21
- data/lib/graphql/define/assignment_dictionary.rb +0 -26
- data/lib/graphql/define/defined_object_proxy.rb +0 -32
- data/lib/graphql/define/instance_definable.rb +0 -79
- data/lib/graphql/define/non_null_with_bang.rb +0 -15
- data/lib/graphql/define/type_definer.rb +0 -30
- data/lib/graphql/define.rb +0 -8
- data/lib/graphql/directive/include_directive.rb +0 -10
- data/lib/graphql/directive/skip_directive.rb +0 -11
- data/lib/graphql/directive.rb +0 -49
- data/lib/graphql/enum_type.rb +0 -95
- data/lib/graphql/field.rb +0 -131
- data/lib/graphql/float_type.rb +0 -5
- data/lib/graphql/id_type.rb +0 -12
- data/lib/graphql/input_object_type.rb +0 -71
- data/lib/graphql/int_type.rb +0 -5
- data/lib/graphql/interface_type.rb +0 -38
- data/lib/graphql/internal_representation/node.rb +0 -81
- data/lib/graphql/internal_representation/rewrite.rb +0 -177
- data/lib/graphql/internal_representation.rb +0 -2
- data/lib/graphql/introspection/arguments_field.rb +0 -5
- data/lib/graphql/introspection/enum_values_field.rb +0 -13
- data/lib/graphql/introspection/fields_field.rb +0 -13
- data/lib/graphql/introspection/input_fields_field.rb +0 -12
- data/lib/graphql/introspection/interfaces_field.rb +0 -5
- data/lib/graphql/introspection/of_type_field.rb +0 -6
- data/lib/graphql/introspection/possible_types_field.rb +0 -11
- data/lib/graphql/introspection/schema_field.rb +0 -15
- data/lib/graphql/introspection/type_by_name_field.rb +0 -16
- data/lib/graphql/introspection/typename_field.rb +0 -15
- data/lib/graphql/list_type.rb +0 -46
- data/lib/graphql/non_null_type.rb +0 -43
- data/lib/graphql/object_type.rb +0 -93
- data/lib/graphql/query/arguments.rb +0 -76
- data/lib/graphql/query/directive_resolution.rb +0 -16
- data/lib/graphql/query/executor.rb +0 -45
- data/lib/graphql/query/literal_input.rb +0 -90
- data/lib/graphql/query/serial_execution/execution_context.rb +0 -31
- data/lib/graphql/query/serial_execution/field_resolution.rb +0 -82
- data/lib/graphql/query/serial_execution/operation_resolution.rb +0 -27
- data/lib/graphql/query/serial_execution/selection_resolution.rb +0 -42
- data/lib/graphql/query/serial_execution/value_resolution.rb +0 -107
- data/lib/graphql/query/serial_execution.rb +0 -41
- data/lib/graphql/query/type_resolver.rb +0 -25
- data/lib/graphql/scalar_type.rb +0 -53
- data/lib/graphql/schema/catchall_middleware.rb +0 -34
- data/lib/graphql/schema/middleware_chain.rb +0 -28
- data/lib/graphql/schema/possible_types.rb +0 -34
- data/lib/graphql/schema/reduce_types.rb +0 -68
- data/lib/graphql/schema/rescue_middleware.rb +0 -53
- data/lib/graphql/schema/timeout_middleware.rb +0 -67
- data/lib/graphql/schema/type_map.rb +0 -30
- data/lib/graphql/schema/validation.rb +0 -164
- data/lib/graphql/static_validation/arguments_validator.rb +0 -48
- data/lib/graphql/static_validation/message.rb +0 -36
- data/lib/graphql/string_type.rb +0 -5
- data/lib/graphql/union_type.rb +0 -38
- data/spec/graphql/analysis/analyze_query_spec.rb +0 -50
- data/spec/graphql/analysis/max_query_complexity_spec.rb +0 -62
- data/spec/graphql/analysis/max_query_depth_spec.rb +0 -100
- data/spec/graphql/analysis/query_complexity_spec.rb +0 -235
- data/spec/graphql/analysis/query_depth_spec.rb +0 -80
- data/spec/graphql/argument_spec.rb +0 -20
- data/spec/graphql/base_type_spec.rb +0 -24
- data/spec/graphql/boolean_type_spec.rb +0 -20
- data/spec/graphql/define/instance_definable_spec.rb +0 -55
- data/spec/graphql/directive_spec.rb +0 -77
- data/spec/graphql/enum_type_spec.rb +0 -31
- data/spec/graphql/execution_error_spec.rb +0 -61
- data/spec/graphql/field_spec.rb +0 -92
- data/spec/graphql/float_type_spec.rb +0 -15
- data/spec/graphql/id_type_spec.rb +0 -32
- data/spec/graphql/input_object_type_spec.rb +0 -162
- data/spec/graphql/int_type_spec.rb +0 -15
- data/spec/graphql/interface_type_spec.rb +0 -56
- data/spec/graphql/internal_representation/rewrite_spec.rb +0 -120
- data/spec/graphql/introspection/directive_type_spec.rb +0 -50
- data/spec/graphql/introspection/input_value_type_spec.rb +0 -42
- data/spec/graphql/introspection/introspection_query_spec.rb +0 -10
- data/spec/graphql/introspection/schema_type_spec.rb +0 -45
- data/spec/graphql/introspection/type_type_spec.rb +0 -122
- data/spec/graphql/language/generation_spec.rb +0 -42
- data/spec/graphql/language/parser_spec.rb +0 -442
- data/spec/graphql/language/visitor_spec.rb +0 -49
- data/spec/graphql/list_type_spec.rb +0 -32
- data/spec/graphql/non_null_type_spec.rb +0 -31
- data/spec/graphql/object_type_spec.rb +0 -42
- data/spec/graphql/query/arguments_spec.rb +0 -25
- data/spec/graphql/query/context_spec.rb +0 -83
- data/spec/graphql/query/executor_spec.rb +0 -273
- data/spec/graphql/query/serial_execution/execution_context_spec.rb +0 -53
- data/spec/graphql/query/serial_execution/value_resolution_spec.rb +0 -66
- data/spec/graphql/query/type_resolver_spec.rb +0 -8
- data/spec/graphql/query/variables_spec.rb +0 -28
- data/spec/graphql/query_spec.rb +0 -363
- data/spec/graphql/scalar_type_spec.rb +0 -61
- data/spec/graphql/schema/catchall_middleware_spec.rb +0 -32
- data/spec/graphql/schema/middleware_chain_spec.rb +0 -42
- data/spec/graphql/schema/printer_spec.rb +0 -190
- data/spec/graphql/schema/reduce_types_spec.rb +0 -102
- data/spec/graphql/schema/rescue_middleware_spec.rb +0 -33
- data/spec/graphql/schema/timeout_middleware_spec.rb +0 -180
- data/spec/graphql/schema/type_expression_spec.rb +0 -38
- data/spec/graphql/schema/validation_spec.rb +0 -219
- data/spec/graphql/schema_spec.rb +0 -23
- data/spec/graphql/static_validation/rules/argument_literals_are_compatible_spec.rb +0 -63
- data/spec/graphql/static_validation/rules/arguments_are_defined_spec.rb +0 -48
- data/spec/graphql/static_validation/rules/directives_are_defined_spec.rb +0 -34
- data/spec/graphql/static_validation/rules/directives_are_in_valid_locations_spec.rb +0 -39
- data/spec/graphql/static_validation/rules/fields_are_defined_on_type_spec.rb +0 -60
- data/spec/graphql/static_validation/rules/fields_have_appropriate_selections_spec.rb +0 -31
- data/spec/graphql/static_validation/rules/fields_will_merge_spec.rb +0 -48
- data/spec/graphql/static_validation/rules/fragment_spreads_are_possible_spec.rb +0 -47
- data/spec/graphql/static_validation/rules/fragment_types_exist_spec.rb +0 -39
- data/spec/graphql/static_validation/rules/fragments_are_finite_spec.rb +0 -44
- data/spec/graphql/static_validation/rules/fragments_are_on_composite_types_spec.rb +0 -49
- data/spec/graphql/static_validation/rules/fragments_are_used_spec.rb +0 -25
- data/spec/graphql/static_validation/rules/required_arguments_are_present_spec.rb +0 -42
- data/spec/graphql/static_validation/rules/variable_default_values_are_correctly_typed_spec.rb +0 -44
- data/spec/graphql/static_validation/rules/variable_usages_are_allowed_spec.rb +0 -63
- data/spec/graphql/static_validation/rules/variables_are_input_types_spec.rb +0 -37
- data/spec/graphql/static_validation/rules/variables_are_used_and_defined_spec.rb +0 -53
- data/spec/graphql/static_validation/type_stack_spec.rb +0 -37
- data/spec/graphql/static_validation/validator_spec.rb +0 -69
- data/spec/graphql/string_type_spec.rb +0 -15
- data/spec/graphql/union_type_spec.rb +0 -31
- data/spec/spec_helper.rb +0 -18
- data/spec/support/dairy_app.rb +0 -309
- data/spec/support/dairy_data.rb +0 -23
- data/spec/support/minimum_input_object.rb +0 -16
- data/spec/support/star_wars_data.rb +0 -71
- data/spec/support/star_wars_schema.rb +0 -76
@@ -0,0 +1,253 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module GraphQL
|
4
|
+
module Pagination
|
5
|
+
# A Connection wraps a list of items and provides cursor-based pagination over it.
|
6
|
+
#
|
7
|
+
# Connections were introduced by Facebook's `Relay` front-end framework, but
|
8
|
+
# proved to be generally useful for GraphQL APIs. When in doubt, use connections
|
9
|
+
# to serve lists (like Arrays, ActiveRecord::Relations) via GraphQL.
|
10
|
+
#
|
11
|
+
# Unlike the previous connection implementation, these default to bidirectional pagination.
|
12
|
+
#
|
13
|
+
# Pagination arguments and context may be provided at initialization or assigned later (see {Schema::Field::ConnectionExtension}).
|
14
|
+
class Connection
|
15
|
+
class PaginationImplementationMissingError < GraphQL::Error
|
16
|
+
end
|
17
|
+
|
18
|
+
# @return [Object] A list object, from the application. This is the unpaginated value passed into the connection.
|
19
|
+
attr_reader :items
|
20
|
+
|
21
|
+
# @return [GraphQL::Query::Context]
|
22
|
+
attr_accessor :context
|
23
|
+
|
24
|
+
# @return [Object] the object this collection belongs to
|
25
|
+
attr_accessor :parent
|
26
|
+
|
27
|
+
# Raw access to client-provided values. (`max_page_size` not applied to first or last.)
|
28
|
+
attr_accessor :before_value, :after_value, :first_value, :last_value
|
29
|
+
|
30
|
+
# @return [String, nil] the client-provided cursor. `""` is treated as `nil`.
|
31
|
+
def before
|
32
|
+
if defined?(@before)
|
33
|
+
@before
|
34
|
+
else
|
35
|
+
@before = @before_value == "" ? nil : @before_value
|
36
|
+
end
|
37
|
+
end
|
38
|
+
|
39
|
+
# @return [String, nil] the client-provided cursor. `""` is treated as `nil`.
|
40
|
+
def after
|
41
|
+
if defined?(@after)
|
42
|
+
@after
|
43
|
+
else
|
44
|
+
@after = @after_value == "" ? nil : @after_value
|
45
|
+
end
|
46
|
+
end
|
47
|
+
|
48
|
+
# @return [Hash<Symbol => Object>] The field arguments from the field that returned this connection
|
49
|
+
attr_accessor :arguments
|
50
|
+
|
51
|
+
# @param items [Object] some unpaginated collection item, like an `Array` or `ActiveRecord::Relation`
|
52
|
+
# @param context [Query::Context]
|
53
|
+
# @param parent [Object] The object this collection belongs to
|
54
|
+
# @param first [Integer, nil] The limit parameter from the client, if it provided one
|
55
|
+
# @param after [String, nil] A cursor for pagination, if the client provided one
|
56
|
+
# @param last [Integer, nil] Limit parameter from the client, if provided
|
57
|
+
# @param before [String, nil] A cursor for pagination, if the client provided one.
|
58
|
+
# @param arguments [Hash] The arguments to the field that returned the collection wrapped by this connection
|
59
|
+
# @param max_page_size [Integer, nil] A configured value to cap the result size. Applied as `first` if neither first or last are given and no `default_page_size` is set.
|
60
|
+
# @param default_page_size [Integer, nil] A configured value to determine the result size when neither first or last are given.
|
61
|
+
def initialize(items, parent: nil, field: nil, context: nil, first: nil, after: nil, max_page_size: :not_given, default_page_size: :not_given, last: nil, before: nil, edge_class: nil, arguments: nil)
|
62
|
+
@items = items
|
63
|
+
@parent = parent
|
64
|
+
@context = context
|
65
|
+
@field = field
|
66
|
+
@first_value = first
|
67
|
+
@after_value = after
|
68
|
+
@last_value = last
|
69
|
+
@before_value = before
|
70
|
+
@arguments = arguments
|
71
|
+
@edge_class = edge_class || self.class::Edge
|
72
|
+
# This is only true if the object was _initialized_ with an override
|
73
|
+
# or if one is assigned later.
|
74
|
+
@has_max_page_size_override = max_page_size != :not_given
|
75
|
+
@max_page_size = if max_page_size == :not_given
|
76
|
+
nil
|
77
|
+
else
|
78
|
+
max_page_size
|
79
|
+
end
|
80
|
+
@has_default_page_size_override = default_page_size != :not_given
|
81
|
+
@default_page_size = if default_page_size == :not_given
|
82
|
+
nil
|
83
|
+
else
|
84
|
+
default_page_size
|
85
|
+
end
|
86
|
+
end
|
87
|
+
|
88
|
+
def max_page_size=(new_value)
|
89
|
+
@has_max_page_size_override = true
|
90
|
+
@max_page_size = new_value
|
91
|
+
end
|
92
|
+
|
93
|
+
def max_page_size
|
94
|
+
if @has_max_page_size_override
|
95
|
+
@max_page_size
|
96
|
+
else
|
97
|
+
context.schema.default_max_page_size
|
98
|
+
end
|
99
|
+
end
|
100
|
+
|
101
|
+
def has_max_page_size_override?
|
102
|
+
@has_max_page_size_override
|
103
|
+
end
|
104
|
+
|
105
|
+
def default_page_size=(new_value)
|
106
|
+
@has_default_page_size_override = true
|
107
|
+
@default_page_size = new_value
|
108
|
+
end
|
109
|
+
|
110
|
+
def default_page_size
|
111
|
+
if @has_default_page_size_override
|
112
|
+
@default_page_size
|
113
|
+
else
|
114
|
+
context.schema.default_page_size
|
115
|
+
end
|
116
|
+
end
|
117
|
+
|
118
|
+
def has_default_page_size_override?
|
119
|
+
@has_default_page_size_override
|
120
|
+
end
|
121
|
+
|
122
|
+
attr_writer :first
|
123
|
+
# @return [Integer, nil]
|
124
|
+
# A clamped `first` value.
|
125
|
+
# (The underlying instance variable doesn't have limits on it.)
|
126
|
+
# If neither `first` nor `last` is given, but `default_page_size` is
|
127
|
+
# present, default_page_size is used for first. If `default_page_size`
|
128
|
+
# is greater than `max_page_size``, it'll be clamped down to
|
129
|
+
# `max_page_size`. If `default_page_size` is nil, use `max_page_size`.
|
130
|
+
def first
|
131
|
+
@first ||= begin
|
132
|
+
capped = limit_pagination_argument(@first_value, max_page_size)
|
133
|
+
if capped.nil? && last.nil?
|
134
|
+
capped = limit_pagination_argument(default_page_size, max_page_size) || max_page_size
|
135
|
+
end
|
136
|
+
capped
|
137
|
+
end
|
138
|
+
end
|
139
|
+
|
140
|
+
# This is called by `Relay::RangeAdd` -- it can be overridden
|
141
|
+
# when `item` needs some modifications based on this connection's state.
|
142
|
+
#
|
143
|
+
# @param item [Object] An item newly added to `items`
|
144
|
+
# @return [Edge]
|
145
|
+
def range_add_edge(item)
|
146
|
+
edge_class.new(item, self)
|
147
|
+
end
|
148
|
+
|
149
|
+
attr_writer :last
|
150
|
+
# @return [Integer, nil] A clamped `last` value. (The underlying instance variable doesn't have limits on it)
|
151
|
+
def last
|
152
|
+
@last ||= limit_pagination_argument(@last_value, max_page_size)
|
153
|
+
end
|
154
|
+
|
155
|
+
# @return [Array<Edge>] {nodes}, but wrapped with Edge instances
|
156
|
+
def edges
|
157
|
+
@edges ||= nodes.map { |n| @edge_class.new(n, self) }
|
158
|
+
end
|
159
|
+
|
160
|
+
# @return [Class] A wrapper class for edges of this connection
|
161
|
+
attr_accessor :edge_class
|
162
|
+
|
163
|
+
# @return [GraphQL::Schema::Field] The field this connection was returned by
|
164
|
+
attr_accessor :field
|
165
|
+
|
166
|
+
# @return [Array<Object>] A slice of {items}, constrained by {@first_value}/{@after_value}/{@last_value}/{@before_value}
|
167
|
+
def nodes
|
168
|
+
raise PaginationImplementationMissingError, "Implement #{self.class}#nodes to paginate `@items`"
|
169
|
+
end
|
170
|
+
|
171
|
+
# A dynamic alias for compatibility with {Relay::BaseConnection}.
|
172
|
+
# @deprecated use {#nodes} instead
|
173
|
+
def edge_nodes
|
174
|
+
nodes
|
175
|
+
end
|
176
|
+
|
177
|
+
# The connection object itself implements `PageInfo` fields
|
178
|
+
def page_info
|
179
|
+
self
|
180
|
+
end
|
181
|
+
|
182
|
+
# @return [Boolean] True if there are more items after this page
|
183
|
+
def has_next_page
|
184
|
+
raise PaginationImplementationMissingError, "Implement #{self.class}#has_next_page to return the next-page check"
|
185
|
+
end
|
186
|
+
|
187
|
+
# @return [Boolean] True if there were items before these items
|
188
|
+
def has_previous_page
|
189
|
+
raise PaginationImplementationMissingError, "Implement #{self.class}#has_previous_page to return the previous-page check"
|
190
|
+
end
|
191
|
+
|
192
|
+
# @return [String] The cursor of the first item in {nodes}
|
193
|
+
def start_cursor
|
194
|
+
nodes.first && cursor_for(nodes.first)
|
195
|
+
end
|
196
|
+
|
197
|
+
# @return [String] The cursor of the last item in {nodes}
|
198
|
+
def end_cursor
|
199
|
+
nodes.last && cursor_for(nodes.last)
|
200
|
+
end
|
201
|
+
|
202
|
+
# Return a cursor for this item.
|
203
|
+
# @param item [Object] one of the passed in {items}, taken from {nodes}
|
204
|
+
# @return [String]
|
205
|
+
def cursor_for(item)
|
206
|
+
raise PaginationImplementationMissingError, "Implement #{self.class}#cursor_for(item) to return the cursor for #{item.inspect}"
|
207
|
+
end
|
208
|
+
|
209
|
+
private
|
210
|
+
|
211
|
+
# @param argument [nil, Integer] `first` or `last`, as provided by the client
|
212
|
+
# @param max_page_size [nil, Integer]
|
213
|
+
# @return [nil, Integer] `nil` if the input was `nil`, otherwise a value between `0` and `max_page_size`
|
214
|
+
def limit_pagination_argument(argument, max_page_size)
|
215
|
+
if argument
|
216
|
+
if argument < 0
|
217
|
+
argument = 0
|
218
|
+
elsif max_page_size && argument > max_page_size
|
219
|
+
argument = max_page_size
|
220
|
+
end
|
221
|
+
end
|
222
|
+
argument
|
223
|
+
end
|
224
|
+
|
225
|
+
def decode(cursor)
|
226
|
+
context.schema.cursor_encoder.decode(cursor, nonce: true)
|
227
|
+
end
|
228
|
+
|
229
|
+
def encode(cursor)
|
230
|
+
context.schema.cursor_encoder.encode(cursor, nonce: true)
|
231
|
+
end
|
232
|
+
|
233
|
+
# A wrapper around paginated items. It includes a {cursor} for pagination
|
234
|
+
# and could be extended with custom relationship-level data.
|
235
|
+
class Edge
|
236
|
+
attr_reader :node
|
237
|
+
|
238
|
+
def initialize(node, connection)
|
239
|
+
@connection = connection
|
240
|
+
@node = node
|
241
|
+
end
|
242
|
+
|
243
|
+
def parent
|
244
|
+
@connection.parent
|
245
|
+
end
|
246
|
+
|
247
|
+
def cursor
|
248
|
+
@cursor ||= @connection.cursor_for(@node)
|
249
|
+
end
|
250
|
+
end
|
251
|
+
end
|
252
|
+
end
|
253
|
+
end
|
@@ -0,0 +1,135 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module GraphQL
|
4
|
+
module Pagination
|
5
|
+
# A schema-level connection wrapper manager.
|
6
|
+
#
|
7
|
+
# Attach as a plugin.
|
8
|
+
#
|
9
|
+
# @example Adding a custom wrapper
|
10
|
+
# class MySchema < GraphQL::Schema
|
11
|
+
# connections.add(MyApp::SearchResults, MyApp::SearchResultsConnection)
|
12
|
+
# end
|
13
|
+
#
|
14
|
+
# @example Removing default connection support for arrays (they can still be manually wrapped)
|
15
|
+
# class MySchema < GraphQL::Schema
|
16
|
+
# connections.delete(Array)
|
17
|
+
# end
|
18
|
+
#
|
19
|
+
# @see {Schema.connections}
|
20
|
+
class Connections
|
21
|
+
class ImplementationMissingError < GraphQL::Error
|
22
|
+
end
|
23
|
+
|
24
|
+
def initialize(schema:)
|
25
|
+
@schema = schema
|
26
|
+
@wrappers = {}
|
27
|
+
add_default
|
28
|
+
end
|
29
|
+
|
30
|
+
def add(nodes_class, implementation)
|
31
|
+
@wrappers[nodes_class] = implementation
|
32
|
+
end
|
33
|
+
|
34
|
+
def delete(nodes_class)
|
35
|
+
@wrappers.delete(nodes_class)
|
36
|
+
end
|
37
|
+
|
38
|
+
def all_wrappers
|
39
|
+
all_wrappers = {}
|
40
|
+
@schema.ancestors.reverse_each do |schema_class|
|
41
|
+
if schema_class.respond_to?(:connections) && (c = schema_class.connections)
|
42
|
+
all_wrappers.merge!(c.wrappers)
|
43
|
+
end
|
44
|
+
end
|
45
|
+
all_wrappers
|
46
|
+
end
|
47
|
+
|
48
|
+
def wrapper_for(items, wrappers: all_wrappers)
|
49
|
+
impl = nil
|
50
|
+
|
51
|
+
items.class.ancestors.each { |cls|
|
52
|
+
impl = wrappers[cls]
|
53
|
+
break if impl
|
54
|
+
}
|
55
|
+
|
56
|
+
impl
|
57
|
+
end
|
58
|
+
|
59
|
+
# Used by the runtime to wrap values in connection wrappers.
|
60
|
+
# @api Private
|
61
|
+
def wrap(field, parent, items, arguments, context)
|
62
|
+
return items if GraphQL::Execution::Interpreter::RawValue === items
|
63
|
+
wrappers = context ? context.namespace(:connections)[:all_wrappers] : all_wrappers
|
64
|
+
impl = wrapper_for(items, wrappers: wrappers)
|
65
|
+
|
66
|
+
if impl
|
67
|
+
impl.new(
|
68
|
+
items,
|
69
|
+
context: context,
|
70
|
+
parent: parent,
|
71
|
+
field: field,
|
72
|
+
max_page_size: field.has_max_page_size? ? field.max_page_size : context.schema.default_max_page_size,
|
73
|
+
default_page_size: field.has_default_page_size? ? field.default_page_size : context.schema.default_page_size,
|
74
|
+
first: arguments[:first],
|
75
|
+
after: arguments[:after],
|
76
|
+
last: arguments[:last],
|
77
|
+
before: arguments[:before],
|
78
|
+
arguments: arguments,
|
79
|
+
edge_class: edge_class_for_field(field),
|
80
|
+
)
|
81
|
+
else
|
82
|
+
raise ImplementationMissingError, "Couldn't find a connection wrapper for #{items.class} during #{field.path} (#{items.inspect})"
|
83
|
+
end
|
84
|
+
end
|
85
|
+
|
86
|
+
# use an override if there is one
|
87
|
+
# @api private
|
88
|
+
def edge_class_for_field(field)
|
89
|
+
conn_type = field.type.unwrap
|
90
|
+
conn_type_edge_type = conn_type.respond_to?(:edge_class) && conn_type.edge_class
|
91
|
+
if conn_type_edge_type && conn_type_edge_type != Pagination::Connection::Edge
|
92
|
+
conn_type_edge_type
|
93
|
+
else
|
94
|
+
nil
|
95
|
+
end
|
96
|
+
end
|
97
|
+
protected
|
98
|
+
|
99
|
+
attr_reader :wrappers
|
100
|
+
|
101
|
+
private
|
102
|
+
|
103
|
+
def add_default
|
104
|
+
add(Array, Pagination::ArrayConnection)
|
105
|
+
|
106
|
+
if defined?(ActiveRecord::Relation)
|
107
|
+
add(ActiveRecord::Relation, Pagination::ActiveRecordRelationConnection)
|
108
|
+
end
|
109
|
+
|
110
|
+
if defined?(Sequel::Dataset)
|
111
|
+
add(Sequel::Dataset, Pagination::SequelDatasetConnection)
|
112
|
+
end
|
113
|
+
|
114
|
+
if defined?(Mongoid::Criteria)
|
115
|
+
add(Mongoid::Criteria, Pagination::MongoidRelationConnection)
|
116
|
+
end
|
117
|
+
|
118
|
+
# Mongoid 5 and 6
|
119
|
+
if defined?(Mongoid::Relations::Targets::Enumerable)
|
120
|
+
add(Mongoid::Relations::Targets::Enumerable, Pagination::MongoidRelationConnection)
|
121
|
+
end
|
122
|
+
|
123
|
+
# Mongoid 7
|
124
|
+
if defined?(Mongoid::Association::Referenced::HasMany::Targets::Enumerable)
|
125
|
+
add(Mongoid::Association::Referenced::HasMany::Targets::Enumerable, Pagination::MongoidRelationConnection)
|
126
|
+
end
|
127
|
+
|
128
|
+
# Mongoid 7.3+
|
129
|
+
if defined?(Mongoid::Association::Referenced::HasMany::Enumerable)
|
130
|
+
add(Mongoid::Association::Referenced::HasMany::Enumerable, Pagination::MongoidRelationConnection)
|
131
|
+
end
|
132
|
+
end
|
133
|
+
end
|
134
|
+
end
|
135
|
+
end
|
@@ -0,0 +1,25 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
require "graphql/pagination/relation_connection"
|
3
|
+
|
4
|
+
module GraphQL
|
5
|
+
module Pagination
|
6
|
+
class MongoidRelationConnection < Pagination::RelationConnection
|
7
|
+
def relation_offset(relation)
|
8
|
+
relation.options.skip
|
9
|
+
end
|
10
|
+
|
11
|
+
def relation_limit(relation)
|
12
|
+
relation.options.limit
|
13
|
+
end
|
14
|
+
|
15
|
+
def relation_count(relation)
|
16
|
+
# Mongo's `.count` doesn't apply limit or skip, which we need. So we have to load _everything_!
|
17
|
+
relation.to_a.count
|
18
|
+
end
|
19
|
+
|
20
|
+
def null_relation(relation)
|
21
|
+
relation.without_options.none
|
22
|
+
end
|
23
|
+
end
|
24
|
+
end
|
25
|
+
end
|
@@ -0,0 +1,228 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
require "graphql/pagination/connection"
|
3
|
+
|
4
|
+
module GraphQL
|
5
|
+
module Pagination
|
6
|
+
# A generic class for working with database query objects.
|
7
|
+
class RelationConnection < Pagination::Connection
|
8
|
+
def nodes
|
9
|
+
load_nodes
|
10
|
+
@nodes
|
11
|
+
end
|
12
|
+
|
13
|
+
def has_previous_page
|
14
|
+
if @has_previous_page.nil?
|
15
|
+
@has_previous_page = if after_offset && after_offset > 0
|
16
|
+
true
|
17
|
+
elsif last
|
18
|
+
# See whether there are any nodes _before_ the current offset.
|
19
|
+
# If there _is no_ current offset, then there can't be any nodes before it.
|
20
|
+
# Assume that if the offset is positive, there are nodes before the offset.
|
21
|
+
limited_nodes
|
22
|
+
!(@paged_nodes_offset.nil? || @paged_nodes_offset == 0)
|
23
|
+
else
|
24
|
+
false
|
25
|
+
end
|
26
|
+
end
|
27
|
+
@has_previous_page
|
28
|
+
end
|
29
|
+
|
30
|
+
def has_next_page
|
31
|
+
if @has_next_page.nil?
|
32
|
+
@has_next_page = if before_offset && before_offset > 0
|
33
|
+
true
|
34
|
+
elsif first
|
35
|
+
if @nodes && @nodes.count < first
|
36
|
+
false
|
37
|
+
else
|
38
|
+
relation_larger_than(sliced_nodes, @sliced_nodes_offset, first)
|
39
|
+
end
|
40
|
+
else
|
41
|
+
false
|
42
|
+
end
|
43
|
+
end
|
44
|
+
@has_next_page
|
45
|
+
end
|
46
|
+
|
47
|
+
def cursor_for(item)
|
48
|
+
load_nodes
|
49
|
+
# index in nodes + existing offset + 1 (because it's offset, not index)
|
50
|
+
offset = nodes.index(item) + 1 + (@paged_nodes_offset || 0) - (relation_offset(items) || 0)
|
51
|
+
encode(offset.to_s)
|
52
|
+
end
|
53
|
+
|
54
|
+
private
|
55
|
+
|
56
|
+
# @param relation [Object] A database query object
|
57
|
+
# @param _initial_offset [Integer] The number of items already excluded from the relation
|
58
|
+
# @param size [Integer] The value against which we check the relation size
|
59
|
+
# @return [Boolean] True if the number of items in this relation is larger than `size`
|
60
|
+
def relation_larger_than(relation, _initial_offset, size)
|
61
|
+
relation_count(set_limit(relation, size + 1)) == size + 1
|
62
|
+
end
|
63
|
+
|
64
|
+
# @param relation [Object] A database query object
|
65
|
+
# @return [Integer, nil] The offset value, or nil if there isn't one
|
66
|
+
def relation_offset(relation)
|
67
|
+
raise "#{self.class}#relation_offset(relation) must return the offset value for a #{relation.class} (#{relation.inspect})"
|
68
|
+
end
|
69
|
+
|
70
|
+
# @param relation [Object] A database query object
|
71
|
+
# @return [Integer, nil] The limit value, or nil if there isn't one
|
72
|
+
def relation_limit(relation)
|
73
|
+
raise "#{self.class}#relation_limit(relation) must return the limit value for a #{relation.class} (#{relation.inspect})"
|
74
|
+
end
|
75
|
+
|
76
|
+
# @param relation [Object] A database query object
|
77
|
+
# @return [Integer, nil] The number of items in this relation (hopefully determined without loading all records into memory!)
|
78
|
+
def relation_count(relation)
|
79
|
+
raise "#{self.class}#relation_count(relation) must return the count of records for a #{relation.class} (#{relation.inspect})"
|
80
|
+
end
|
81
|
+
|
82
|
+
# @param relation [Object] A database query object
|
83
|
+
# @return [Object] A modified query object which will return no records
|
84
|
+
def null_relation(relation)
|
85
|
+
raise "#{self.class}#null_relation(relation) must return an empty relation for a #{relation.class} (#{relation.inspect})"
|
86
|
+
end
|
87
|
+
|
88
|
+
# @return [Integer]
|
89
|
+
def offset_from_cursor(cursor)
|
90
|
+
decode(cursor).to_i
|
91
|
+
end
|
92
|
+
|
93
|
+
# Abstract this operation so we can always ignore inputs less than zero.
|
94
|
+
# (Sequel doesn't like it, understandably.)
|
95
|
+
def set_offset(relation, offset_value)
|
96
|
+
if offset_value >= 0
|
97
|
+
relation.offset(offset_value)
|
98
|
+
else
|
99
|
+
relation.offset(0)
|
100
|
+
end
|
101
|
+
end
|
102
|
+
|
103
|
+
# Abstract this operation so we can always ignore inputs less than zero.
|
104
|
+
# (Sequel doesn't like it, understandably.)
|
105
|
+
def set_limit(relation, limit_value)
|
106
|
+
if limit_value > 0
|
107
|
+
relation.limit(limit_value)
|
108
|
+
elsif limit_value == 0
|
109
|
+
null_relation(relation)
|
110
|
+
else
|
111
|
+
relation
|
112
|
+
end
|
113
|
+
end
|
114
|
+
|
115
|
+
def calculate_sliced_nodes_parameters
|
116
|
+
if defined?(@sliced_nodes_limit)
|
117
|
+
return
|
118
|
+
else
|
119
|
+
next_offset = relation_offset(items) || 0
|
120
|
+
relation_limit = relation_limit(items)
|
121
|
+
|
122
|
+
if after_offset
|
123
|
+
next_offset += after_offset
|
124
|
+
end
|
125
|
+
|
126
|
+
if before_offset && after_offset
|
127
|
+
if after_offset < before_offset
|
128
|
+
# Get the number of items between the two cursors
|
129
|
+
space_between = before_offset - after_offset - 1
|
130
|
+
relation_limit = space_between
|
131
|
+
else
|
132
|
+
# The cursors overextend one another to an empty set
|
133
|
+
@sliced_nodes_null_relation = true
|
134
|
+
end
|
135
|
+
elsif before_offset
|
136
|
+
# Use limit to cut off the tail of the relation
|
137
|
+
relation_limit = before_offset - 1
|
138
|
+
end
|
139
|
+
|
140
|
+
@sliced_nodes_limit = relation_limit
|
141
|
+
@sliced_nodes_offset = next_offset
|
142
|
+
end
|
143
|
+
end
|
144
|
+
|
145
|
+
# Apply `before` and `after` to the underlying `items`,
|
146
|
+
# returning a new relation.
|
147
|
+
def sliced_nodes
|
148
|
+
@sliced_nodes ||= begin
|
149
|
+
calculate_sliced_nodes_parameters
|
150
|
+
paginated_nodes = items
|
151
|
+
|
152
|
+
if @sliced_nodes_null_relation
|
153
|
+
paginated_nodes = null_relation(paginated_nodes)
|
154
|
+
else
|
155
|
+
if @sliced_nodes_limit
|
156
|
+
paginated_nodes = set_limit(paginated_nodes, @sliced_nodes_limit)
|
157
|
+
end
|
158
|
+
|
159
|
+
if @sliced_nodes_offset
|
160
|
+
paginated_nodes = set_offset(paginated_nodes, @sliced_nodes_offset)
|
161
|
+
end
|
162
|
+
end
|
163
|
+
|
164
|
+
paginated_nodes
|
165
|
+
end
|
166
|
+
end
|
167
|
+
|
168
|
+
# @return [Integer, nil]
|
169
|
+
def before_offset
|
170
|
+
@before_offset ||= before && offset_from_cursor(before)
|
171
|
+
end
|
172
|
+
|
173
|
+
# @return [Integer, nil]
|
174
|
+
def after_offset
|
175
|
+
@after_offset ||= after && offset_from_cursor(after)
|
176
|
+
end
|
177
|
+
|
178
|
+
# Apply `first` and `last` to `sliced_nodes`,
|
179
|
+
# returning a new relation
|
180
|
+
def limited_nodes
|
181
|
+
@limited_nodes ||= begin
|
182
|
+
calculate_sliced_nodes_parameters
|
183
|
+
if @sliced_nodes_null_relation
|
184
|
+
# it's an empty set
|
185
|
+
return sliced_nodes
|
186
|
+
end
|
187
|
+
relation_limit = @sliced_nodes_limit
|
188
|
+
relation_offset = @sliced_nodes_offset
|
189
|
+
|
190
|
+
if first && (relation_limit.nil? || relation_limit > first)
|
191
|
+
# `first` would create a stricter limit that the one already applied, so add it
|
192
|
+
relation_limit = first
|
193
|
+
end
|
194
|
+
|
195
|
+
if last
|
196
|
+
if relation_limit
|
197
|
+
if last <= relation_limit
|
198
|
+
# `last` is a smaller slice than the current limit, so apply it
|
199
|
+
relation_offset += (relation_limit - last)
|
200
|
+
relation_limit = last
|
201
|
+
end
|
202
|
+
else
|
203
|
+
# No limit, so get the last items
|
204
|
+
sliced_nodes_count = relation_count(sliced_nodes)
|
205
|
+
relation_offset += (sliced_nodes_count - [last, sliced_nodes_count].min)
|
206
|
+
relation_limit = last
|
207
|
+
end
|
208
|
+
end
|
209
|
+
|
210
|
+
@paged_nodes_offset = relation_offset
|
211
|
+
paginated_nodes = items
|
212
|
+
paginated_nodes = set_offset(paginated_nodes, relation_offset)
|
213
|
+
if relation_limit
|
214
|
+
paginated_nodes = set_limit(paginated_nodes, relation_limit)
|
215
|
+
end
|
216
|
+
paginated_nodes
|
217
|
+
end
|
218
|
+
end
|
219
|
+
|
220
|
+
# Load nodes after applying first/last/before/after,
|
221
|
+
# returns an array of nodes
|
222
|
+
def load_nodes
|
223
|
+
# Return an array so we can consistently use `.index(node)` on it
|
224
|
+
@nodes ||= limited_nodes.to_a
|
225
|
+
end
|
226
|
+
end
|
227
|
+
end
|
228
|
+
end
|
@@ -0,0 +1,28 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
require "graphql/pagination/relation_connection"
|
3
|
+
|
4
|
+
module GraphQL
|
5
|
+
module Pagination
|
6
|
+
# Customizes `RelationConnection` to work with `Sequel::Dataset`s.
|
7
|
+
class SequelDatasetConnection < Pagination::RelationConnection
|
8
|
+
private
|
9
|
+
|
10
|
+
def relation_offset(relation)
|
11
|
+
relation.opts[:offset]
|
12
|
+
end
|
13
|
+
|
14
|
+
def relation_limit(relation)
|
15
|
+
relation.opts[:limit]
|
16
|
+
end
|
17
|
+
|
18
|
+
def relation_count(relation)
|
19
|
+
# Remove order to make it faster
|
20
|
+
relation.order(nil).count
|
21
|
+
end
|
22
|
+
|
23
|
+
def null_relation(relation)
|
24
|
+
relation.where(false)
|
25
|
+
end
|
26
|
+
end
|
27
|
+
end
|
28
|
+
end
|
@@ -0,0 +1,6 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
require "graphql/pagination/array_connection"
|
3
|
+
require "graphql/pagination/active_record_relation_connection"
|
4
|
+
require "graphql/pagination/connections"
|
5
|
+
require "graphql/pagination/mongoid_relation_connection"
|
6
|
+
require "graphql/pagination/sequel_dataset_connection"
|
@@ -0,0 +1,24 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
module GraphQL
|
3
|
+
class ParseError < GraphQL::Error
|
4
|
+
attr_reader :line, :col, :query
|
5
|
+
def initialize(message, line, col, query, filename: nil)
|
6
|
+
if filename
|
7
|
+
message += " (#{filename})"
|
8
|
+
end
|
9
|
+
|
10
|
+
super(message)
|
11
|
+
@line = line
|
12
|
+
@col = col
|
13
|
+
@query = query
|
14
|
+
end
|
15
|
+
|
16
|
+
def to_h
|
17
|
+
locations = line ? [{ "line" => line, "column" => col }] : []
|
18
|
+
{
|
19
|
+
"message" => message,
|
20
|
+
"locations" => locations,
|
21
|
+
}
|
22
|
+
end
|
23
|
+
end
|
24
|
+
end
|