Merge pull request #103 from github/add-graphql

Add GraphQL query examples

Author: kdaigle

README.md

@@ -11,5 +11,6 @@ But here it is, broken down:
 * _api_: here's a bunch of sample code relating to the API. Subdirectories in this
 category are broken up by language. Do you have a language sample you'd like added?
 Make a pull request and we'll consider it.
+* _graphql_: here's a bunch of sample GraphQL queries that can be run against our [GitHub GraphQL API](https://developers.github.com/early-access/graphql).
 * _hooks_: wanna find out how to write a consumer for [our web hooks](https://developer.github.com/webhooks/)? The examples in this subdirectory show you how. We are open for more contributions via pull requests.
 * _pre-receive-hooks_: this one contains [pre-receive-hooks](https://help.github.com/enterprise/admin/guides/developer-workflow/about-pre-receive-hooks/) that can block commits on GitHub Enterprise that do not fit your requirements. Do you have more great examples? Create a pull request and we will check it out.

graphql/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gem "httparty"

graphql/Gemfile.lock

@@ -0,0 +1,15 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    httparty (0.14.0)
+      multi_xml (>= 0.5.2)
+    multi_xml (0.5.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  httparty
+
+BUNDLED WITH
+   1.11.2

graphql/README.md

@@ -0,0 +1,10 @@
+# GitHub GraphQL API: Query Samples
+
+This repository holds query samples for the GitHub GraphQL API. It's an easy way to get started using the GraphQL API for common workflows. You can copy and paste these queries into [GraphQL Explorer](https://developer.github.com/early-access/graphql/explorer) or you can use the included script.
+
+### How to use the included script
+
+1. Generate a [personal access token](https://help.github.com/articles/creating-an-access-token-for-command-line-use/) for use with these queries.
+1. Run `bundle install`.
+1. Pick the name of one of the included queries like `viewer.graphql`.
+1. Run `TOKEN=<OAuth Token> bin/run-query viewer.graphql`. Replace `<OAuth Token>` with your personal access token.

graphql/bin/run-query

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+
+require "httparty"
+
+query_file_name = ARGV[0]
+unless query_file_name
+  print "Please provide a file name from 'queries'."
+  exit
+end
+
+query_file_path = File.expand_path(File.join("queries", query_file_name))
+query = File.read(query_file_path)
+
+response = HTTParty.post("https://api.github.com/graphql",
+  :headers => {
+    "User-Agent"    => "github/graphql-samples",
+    "Authorization" => "token #{ENV["TOKEN"]}",
+    "Content-Type"  => "application/json"
+  },
+  :body => {:query => query}.to_json
+)
+
+puts "=== Results from #{File.basename(query_file_name)}"
+puts JSON.pretty_generate(response)
+puts

graphql/queries/repositories_with_stargazers.graphql

@@ -0,0 +1,22 @@
+query {
+  viewer {
+    repositories(last: 30) {
+      edges {
+        node {
+          owner {
+            login
+          }
+          name
+          stargazers(first: 5) {
+            totalCount
+            edges {
+              node {
+                login
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

graphql/queries/viewer.graphql

@@ -0,0 +1,5 @@
+query {
+  viewer {
+    login
+  }
+}