graphql-docs 1.8.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 664552097194b2af829edfabafa819abd4ce8d82e9c170d6345e3c8dd91028b3
-  data.tar.gz: 74187b8b707df6c49a4645c26784fde7b0b92c8664b2223a3c093f83ac80a160
+  metadata.gz: ea32dc7266ed5483301f965839b71b611f17df3e87cdb1de18ed3ccbd4ff601e
+  data.tar.gz: 292fb21272e4293d4ed23ae996281d34522487ab71f47a13ae7943185407f2c1
 SHA512:
-  metadata.gz: 3c531188f4244965dae3d0b8561a19813a1e17e75a50d50b4d5635dac9f0f8883772104f713c004aec888d50f757cd53798004a03ef9dbc3f70569323e38174b
-  data.tar.gz: abfead7c929a259f12abadb2952e31363767f089c5cc6bafd33a19adab0f9be376c5e86a8f5e20a82532b38a5aff6b14736ec64c5527a78a94c8a87876c13e51
+  metadata.gz: e3108decb47aeaeddf1fdeef7c0f48cf55c03c0e413fb3354f595284977629704159ccaf0b6b574b5d0845301021fc6211a819138bdf6a63589dccb2e46cabff
+  data.tar.gz: 609e77fd5c372af5c23edc1893470ee835cae90f9f0587100542b2d6cd020c155973e78f7e0d59561d384bcced55dbc0bae436512af0fe1615b4ff97183d2ee6

data/.rubocop.yml

@@ -1,5 +1,5 @@
 inherit_gem:
-  rubocop-github:
+  rubocop-standard:
     - config/default.yml
 
 Style/StringLiterals:

data/README.md

@@ -109,7 +109,7 @@ In your ERB layouts, there are several helper methods you can use. The helper me
 * `slugify(str)` - This slugifies the given string.
 * `include(filename, opts)` - This embeds a template from your `includes` folder, passing along the local options provided.
 * `markdownify(string)` - This converts a string into HTML via CommonMarker.
-* `graphql_operation_types`, `graphql_mutation_types`, `graphql_object_types`, `graphql_interface_types`, `graphql_enum_types`, `graphql_union_types`, `graphql_input_object_types`, `graphql_scalar_types` - Collections of the various GraphQL types.
+* `graphql_operation_types`, `graphql_mutation_types`, `graphql_object_types`, `graphql_interface_types`, `graphql_enum_types`, `graphql_union_types`, `graphql_input_object_types`, `graphql_scalar_types`, `graphql_directive_types` - Collections of the various GraphQL types.
 
 To call these methods within templates, you must use the dot notation, such as `<%= slugify.(text) %>`.
 
@@ -127,8 +127,8 @@ The following options are available:
 | `delete_output` | Deletes `output_dir` before generating content. | `false` |
 | `pipeline_config` | Defines two sub-keys, `pipeline` and `context`, which are used by `html-pipeline` when rendering your output. | `pipeline` has `ExtendedMarkdownFilter`, `EmojiFilter`, and `TableOfContentsFilter`. `context` has `gfm: false` and `asset_root` set to GitHub's CDN. |
 | `renderer` | The rendering class to use. | `GraphQLDocs::Renderer`
-| `templates` | The templates to use when generating HTML. You may override any of the following keys: `default`, `includes`, `operations`, `objects`, `mutations`, `interfaces`, `enums`, `unions`, `input_objects`, `scalars`. | The defaults are found in _lib/graphql-docs/layouts/_.
-| `landing_pages` | The landing page to use when generating HTML for each type. You may override any of the following keys: `index`, `query`, `object`, `mutation`, `interface`, `enum`, `union`, `input_object`, `scalar`. | The defaults are found in _lib/graphql-docs/layouts/_.
+| `templates` | The templates to use when generating HTML. You may override any of the following keys: `default`, `includes`, `operations`, `objects`, `mutations`, `interfaces`, `enums`, `unions`, `input_objects`, `scalars`, `directives`. | The defaults are found in _lib/graphql-docs/layouts/_.
+| `landing_pages` | The landing page to use when generating HTML for each type. You may override any of the following keys: `index`, `query`, `object`, `mutation`, `interface`, `enum`, `union`, `input_object`, `scalar`, `directive`. | The defaults are found in _lib/graphql-docs/landing\_pages/_.
 | `classes` | Additional class names you can provide to certain elements. | The full list is available in _lib/graphql-docs/configuration.rb_.
 | `notices` | A proc used to add notices to schema members. See *Customizing Notices* section below. | `nil` |
 
@@ -153,7 +153,7 @@ A `notice` has the following options:
 Example of a `notices` proc that adds a notice to the `TeamDiscussion` type:
 
 ```ruby
-options[:notice] = (schema_member_path) -> {
+options[:notices] = ->(schema_member_path) {
   notices = []
 
   if schema_member_path == "TeamDiscussion"

data/graphql-docs.gemspec

@@ -38,6 +38,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'pry-byebug', '~> 3.6'
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rubocop'
-  spec.add_development_dependency 'rubocop-github'
+  spec.add_development_dependency 'rubocop-performance'
+  spec.add_development_dependency 'rubocop-standard'
   spec.add_development_dependency 'webmock', '~> 2.3'
 end

data/lib/graphql-docs/configuration.rb

@@ -37,6 +37,7 @@ module GraphQLDocs
         unions: "#{File.dirname(__FILE__)}/layouts/graphql_unions.html",
         input_objects: "#{File.dirname(__FILE__)}/layouts/graphql_input_objects.html",
         scalars: "#{File.dirname(__FILE__)}/layouts/graphql_scalars.html",
+        directives: "#{File.dirname(__FILE__)}/layouts/graphql_directives.html",
       },
 
       landing_pages: {
@@ -49,6 +50,7 @@ module GraphQLDocs
         union: "#{File.dirname(__FILE__)}/landing_pages/union.md",
         input_object: "#{File.dirname(__FILE__)}/landing_pages/input_object.md",
         scalar: "#{File.dirname(__FILE__)}/landing_pages/scalar.md",
+        directive: "#{File.dirname(__FILE__)}/landing_pages/directive.md",
 
         variables: {} # only used for ERB landing pages
       },

data/lib/graphql-docs/generator.rb

@@ -14,14 +14,14 @@ module GraphQLDocs
 
       @renderer = @options[:renderer].new(@parsed_schema, @options)
 
-      %i(operations objects mutations interfaces enums unions input_objects scalars).each do |sym|
+      %i(operations objects mutations interfaces enums unions input_objects scalars directives).each do |sym|
         if !File.exist?(@options[:templates][sym])
           raise IOError, "`#{sym}` template #{@options[:templates][sym]} was not found"
         end
         instance_variable_set("@graphql_#{sym}_template", ERB.new(File.read(@options[:templates][sym])))
       end
 
-      %i(index object query mutation interface enum union input_object scalar).each do |sym|
+      %i(index object query mutation interface enum union input_object scalar directive).each do |sym|
         if @options[:landing_pages][sym].nil?
           instance_variable_set("@#{sym}_landing_page", nil)
         elsif !File.exist?(@options[:landing_pages][sym])
@@ -58,6 +58,7 @@ module GraphQLDocs
       create_graphql_union_pages
       create_graphql_input_object_pages
       create_graphql_scalar_pages
+      create_graphql_directive_pages
 
       unless @graphql_index_landing_page.nil?
         write_file('static', 'index', @graphql_index_landing_page, trim: false)
@@ -95,6 +96,10 @@ module GraphQLDocs
         write_file('static', 'scalar', @graphql_scalar_landing_page, trim: false)
       end
 
+      unless @graphql_directive_landing_page.nil?
+        write_file('static', 'directive', @graphql_directive_landing_page, trim: false)
+      end
+
       if @options[:use_default_styles]
         assets_dir = File.join(File.dirname(__FILE__), 'layouts', 'assets')
         FileUtils.mkdir_p(File.join(@options[:output_dir], 'assets'))
@@ -196,6 +201,15 @@ module GraphQLDocs
       end
     end
 
+    def create_graphql_directive_pages
+      graphql_directive_types.each do |directive_type|
+        opts = default_generator_options(type: directive_type)
+
+        contents = @graphql_directives_template.result(OpenStruct.new(opts).instance_eval { binding })
+        write_file('directive', directive_type[:name], contents)
+      end
+    end
+
     private
 
     def default_generator_options(opts = {})

data/lib/graphql-docs/helpers.rb

@@ -62,6 +62,10 @@ module GraphQLDocs
       @parsed_schema[:scalar_types] || []
     end
 
+    def graphql_directive_types
+      @parsed_schema[:directive_types] || []
+    end
+
     def split_into_metadata_and_contents(contents, parse: true)
       opts = {}
       pieces = yaml_split(contents)

data/lib/graphql-docs/landing_pages/directive.md

@@ -0,0 +1,9 @@
+---
+title: Directives
+---
+
+# Directives
+
+Directives provide a way to describe alternate runtime execution and type validation behavior in a GraphQL document.
+
+For more information, see [the GraphQL spec](https://graphql.github.io/graphql-spec/draft/#sec-Language.Directives).

data/lib/graphql-docs/layouts/graphql_directives.html

@@ -0,0 +1,15 @@
+<h1><%= type[:name] %></h1>
+
+<%= include.('notices.html', notices: type[:notices]) %>
+
+<%= type[:description] %>
+
+<%= include.('locations.html', locations: type[:locations]) %>
+
+<% unless type[:arguments].empty? %>
+
+<h2>Arguments</h2>
+
+<%= include.('arguments.html', arguments: type[:arguments]) %>
+
+<% end %>

data/lib/graphql-docs/layouts/includes/locations.html

@@ -0,0 +1,9 @@
+<h2 id="locations">Locations</h2>
+
+<ul>
+
+<% locations.each do |location| %>
+  <li><%= location %></li>
+<% end %>
+
+</ul>

data/lib/graphql-docs/layouts/includes/sidebar.html

@@ -119,4 +119,18 @@
       <% end %>
     </ul>
   </li>
+
+  <li>
+    <p><a href="<%= base_url %>/directive">Directives</a></p>
+    <ul class="menu-root">
+      <% graphql_directive_types.().each do |type| %>
+      <% @name = type[:name] %>
+      <li>
+        <a href="<%= base_url %>/directive/<%= @name.downcase %>/" class="sidebar-link<% if title == @name %> current<% end %>">
+          <%= @name %>
+        </a>
+      </li>
+      <% end %>
+    </ul>
+  </li>
 </ul>

data/lib/graphql-docs/layouts/includes/values.html

@@ -1,4 +1,4 @@
-<h3 id="fields">Values</h3>
+<h3 id="values">Values</h3>
 
 <% values.each do |value| %>
 

data/lib/graphql-docs/parser.rb

@@ -27,6 +27,7 @@ module GraphQLDocs
         union_types: [],
         input_object_types: [],
         scalar_types: [],
+        directive_types: [],
       }
     end
 
@@ -133,13 +134,20 @@ module GraphQLDocs
         end
       end
 
-      @processed_schema[:mutation_types].sort_by! { |o| o[:name] }
-      @processed_schema[:object_types].sort_by! { |o| o[:name] }
-      @processed_schema[:interface_types].sort_by! { |o| o[:name] }
-      @processed_schema[:enum_types].sort_by! { |o| o[:name] }
-      @processed_schema[:union_types].sort_by! { |o| o[:name] }
-      @processed_schema[:input_object_types].sort_by! { |o| o[:name] }
-      @processed_schema[:scalar_types].sort_by! { |o| o[:name] }
+      @schema.directives.each_value do |directive|
+        data = {}
+        data[:notices] = @options[:notices].call(directive.name)
+
+        data[:name] = directive.name
+        data[:description] = directive.description
+        data[:locations] = directive.locations
+
+        data[:arguments], _ = fetch_fields(directive.arguments, directive.name)
+
+        @processed_schema[:directive_types] << data
+      end
+
+      sort_by_name!
 
       @processed_schema[:interface_types].each do |interface|
         interface[:implemented_by] = []
@@ -229,5 +237,12 @@ module GraphQLDocs
     def argument?(field)
       field.is_a?(::GraphQL::Argument)
     end
+
+    def sort_by_name!
+      @processed_schema.each_pair do |key, value|
+        next if key == :operation_types || key == :root_types
+        value.sort_by! { |o| o[:name] }
+      end
+    end
   end
 end

data/lib/graphql-docs/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module GraphQLDocs
-  VERSION = '1.8.0'.freeze
+  VERSION = '1.9.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: graphql-docs
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Garen Torikian
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-03-04 00:00:00.000000000 Z
+date: 2019-06-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: graphql
@@ -207,7 +207,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop-github
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-standard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -253,6 +267,7 @@ files:
 - lib/graphql-docs/configuration.rb
 - lib/graphql-docs/generator.rb
 - lib/graphql-docs/helpers.rb
+- lib/graphql-docs/landing_pages/directive.md
 - lib/graphql-docs/landing_pages/enum.md
 - lib/graphql-docs/landing_pages/index.md
 - lib/graphql-docs/landing_pages/input_object.md
@@ -296,6 +311,7 @@ files:
 - lib/graphql-docs/layouts/assets/webfonts/2C4B9D_E_0.woff
 - lib/graphql-docs/layouts/assets/webfonts/2C4B9D_E_0.woff2
 - lib/graphql-docs/layouts/default.html
+- lib/graphql-docs/layouts/graphql_directives.html
 - lib/graphql-docs/layouts/graphql_enums.html
 - lib/graphql-docs/layouts/graphql_input_objects.html
 - lib/graphql-docs/layouts/graphql_interfaces.html
@@ -309,6 +325,7 @@ files:
 - lib/graphql-docs/layouts/includes/deprecations.html
 - lib/graphql-docs/layouts/includes/fields.html
 - lib/graphql-docs/layouts/includes/input_fields.html
+- lib/graphql-docs/layouts/includes/locations.html
 - lib/graphql-docs/layouts/includes/notices.html
 - lib/graphql-docs/layouts/includes/possible_types.html
 - lib/graphql-docs/layouts/includes/sidebar.html