Add the specifiedBy type system directive

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## Unreleased
 
 - Bug Fix: [Validate type references for invalid wrapped types](https://github.com/absinthe-graphql/absinthe/pull/1195)
+- Feature: [Add `specifiedBy` type system directive](https://github.com/absinthe-graphql/absinthe/pull/1193)
 - Breaking Bugfix: [Validate repeatable directives on schemas](https://github.com/absinthe-graphql/absinthe/pull/1179)
 - Bug Fix: Adds **optional fix** for non compliant built-in scalar Int type. `use Absinthe.Schema, use_spec_compliant_int_scalar: true` in your schema to use the fixed Int type. It is also advisable to upgrade for custom types if you are leveraging the use of integers outside the GraphQl standard. [#1131](https://github.com/absinthe-graphql/absinthe/pull/1131).
 - Feature: [Support error tuples when scalar parsing fails](https://github.com/absinthe-graphql/absinthe/pull/1187)

lib/absinthe/phase/document/validation/known_directives.ex

@@ -64,7 +64,7 @@ defmodule Absinthe.Phase.Document.Validation.KnownDirectives do
   defp error_unknown(node) do
     %Phase.Error{
       phase: __MODULE__,
-      message: "Unknown directive `#{node.name}'.",
+      message: "Unknown directive `#{node.name}`.",
       locations: [node.source_location]
     }
   end
@@ -75,7 +75,7 @@ defmodule Absinthe.Phase.Document.Validation.KnownDirectives do
 
     %Phase.Error{
       phase: __MODULE__,
-      message: "Directive `#{node.name}' may not be used on #{placement_name}.",
+      message: "Directive `#{node.name}` may not be used on #{placement_name}.",
       locations: [node.source_location]
     }
   end

lib/absinthe/schema/notation.ex

@@ -1600,7 +1600,7 @@ defmodule Absinthe.Schema.Notation do
     attrs =
       attrs
       |> Keyword.put(:identifier, identifier)
-      |> Keyword.put_new(:name, to_string(identifier))
+      |> Keyword.put_new(:name, default_name(Schema.DirectiveDefinition, identifier))
       |> Keyword.update(:description, nil, &wrap_in_unquote/1)
 
     scoped_def(env, Schema.DirectiveDefinition, identifier, attrs, block)
@@ -1979,6 +1979,11 @@ defmodule Absinthe.Schema.Notation do
     |> Atom.to_string()
   end
 
+  defp default_name(Schema.DirectiveDefinition, identifier) do
+    identifier
+    |> Atom.to_string()
+  end
+
   defp default_name(_, identifier) do
     identifier
     |> Atom.to_string()

lib/absinthe/schema/prototype/notation.ex

@@ -34,6 +34,17 @@ defmodule Absinthe.Schema.Prototype.Notation do
         expand &__MODULE__.expand_deprecate/2
       end
 
+      directive :specified_by do
+        description "Exposes a URL that specifies the behavior of this scalar."
+
+        repeatable false
+
+        arg :url, non_null(:string),
+          description: "The URL that specifies the behavior of this scalar."
+
+        on [:scalar]
+      end
+
       def pipeline(pipeline) do
         pipeline
         |> Absinthe.Pipeline.without(Absinthe.Phase.Schema.Validation.QueryTypeMustBeObject)

lib/absinthe/type/built_ins/introspection.ex

@@ -54,7 +54,11 @@ defmodule Absinthe.Type.BuiltIns.Introspection do
   object :__directive do
     description "Represents a directive"
 
-    field :name, non_null(:string)
+    field :name,
+      type: non_null(:string),
+      resolve: fn _, %{adapter: adapter, source: source} ->
+        {:ok, adapter.to_external_name(source.name, :field)}
+      end
 
     field :description, :string
 

test/absinthe/integration/execution/introspection/directives_test.exs

@@ -72,6 +72,23 @@ defmodule Elixir.Absinthe.Integration.Execution.Introspection.DirectivesTest do
                       "onFragment" => true,
                       "onOperation" => false,
                       "isRepeatable" => false
+                    },
+                    %{
+                      "isRepeatable" => false,
+                      "locations" => ["SCALAR"],
+                      "name" => "specifiedBy",
+                      "onField" => false,
+                      "onFragment" => false,
+                      "onOperation" => false,
+                      "args" => [
+                        %{
+                          "name" => "url",
+                          "type" => %{
+                            "kind" => "NON_NULL",
+                            "ofType" => %{"kind" => "SCALAR", "name" => "String"}
+                          }
+                        }
+                      ]
                     }
                   ]
                 }

test/absinthe/introspection_test.exs

@@ -71,6 +71,16 @@ defmodule Absinthe.IntrospectionTest do
                         "onField" => true,
                         "onFragment" => true,
                         "onOperation" => false
+                      },
+                      %{
+                        "description" =>
+                          "Exposes a URL that specifies the behavior of this scalar.",
+                        "isRepeatable" => false,
+                        "locations" => ["SCALAR"],
+                        "name" => "specifiedBy",
+                        "onField" => false,
+                        "onFragment" => false,
+                        "onOperation" => false
                       }
                     ]
                   }

test/absinthe/phase/document/validation/known_directives_test.exs

@@ -5,12 +5,12 @@ defmodule Absinthe.Phase.Document.Validation.KnownDirectivesTest do
     phase: @phase,
     async: true
 
-  alias Absinthe.{Blueprint}
+  alias Absinthe.Blueprint
 
   def unknown_directive(name, line) do
     bad_value(
       Blueprint.Directive,
-      "Unknown directive `#{name}'.",
+      "Unknown directive `#{name}`.",
       line,
       name: name
     )
@@ -19,7 +19,7 @@ defmodule Absinthe.Phase.Document.Validation.KnownDirectivesTest do
   def misplaced_directive(name, placement, line) do
     bad_value(
       Blueprint.Directive,
-      "Directive `#{name}' may not be used on #{placement}.",
+      "Directive `#{name}` may not be used on #{placement}.",
       line,
       name: name
     )

test/absinthe/strict_schema_test.exs

@@ -34,7 +34,7 @@ defmodule Absinthe.StrictSchemaTest do
       variables = %{"input" => %{"naiveDatetime" => "2017-01-27T20:31:55"}}
 
       assert_error_message(
-        "Unknown directive `foo_bar_directive'.",
+        "Unknown directive `foo_bar_directive`.",
         run(document, Absinthe.Fixtures.StrictSchema,
           adapter: Absinthe.Adapter.StrictLanguageConventions,
           variables: variables