fauna 2.1.2 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 534fc367754718ef48a607ae41a65d4bb4a34868
-  data.tar.gz: 52a4a948e7bddb08eb830daef2dff25081b10342
+  metadata.gz: 79e3f29b34209d1fd34ebfb3a878fe2210cc6a34
+  data.tar.gz: eb8887d649b435f9e1064717c04232ace5af76d2
 SHA512:
-  metadata.gz: e5ed3b7fc306db43a75044561fa37e290a64a94521b8691706937bab01f98d639f44ce05953a37ace7e92e178461d03e7b309979424b6363f5dabf46255c0d33
-  data.tar.gz: 9fbccbc8cb75506a4adddb74ffe19ec0182b6f9a2da664b81aadc302902b0ed707fb6353c652b3818798f515608662e4ea08483cca077be3f86fe51c3295b0ce
+  metadata.gz: 9b23b487d4202f26858139562129d66132cfdc0d313067381acd077504a80bee7b74b22e084dc0cc4b4564857ad8ff90c9145dc3f58e7b9c79432ba458e0468f
+  data.tar.gz: 0ae0ecc0c29346e8aeb64228c67e9ca8f059de588c9acaa3de2b4cd165ab9228ef5dd8aaf5276263b1bc5ff98400c27ecf11357951a21e21888221a1841036d3

data/CHANGELOG

@@ -1,3 +1,10 @@
+2.2.0
+* Added `create_class`, `create_index`, `create_database`, `create_key`, `database`, `class`,
+  and `index` query functions.
+* Removed `count` query function.
+* Raises `Fauna::UnavailableError` for all 503s and for Faraday network errors.
+* Fix documentation errors and update links.
+
 2.1.2
 * Change default domain to `cloud.faunadb.com`.
 

data/README.md

@@ -1,6 +1,11 @@
 # FaunaDB
 
-Ruby driver for [FaunaDB](https://faunadb.com).
+[![Build Status](https://img.shields.io/travis/faunadb/faunadb-ruby/master.svg?maxAge=21600)](https://travis-ci.org/faunadb/faunadb-ruby)
+[![Coverage Status](https://img.shields.io/codecov/c/github/faunadb/faunadb-ruby/master.svg?maxAge=21600)](https://codecov.io/gh/faunadb/faunadb-ruby/branch/master)
+[![Gem Version](https://img.shields.io/gem/v/fauna.svg?maxAge=21600)](https://rubygems.org/gems/fauna)
+[![License](https://img.shields.io/badge/license-MPL_2.0-blue.svg?maxAge=2592000)](https://raw.githubusercontent.com/faunadb/faunadb-ruby/master/LICENSE)
+
+Ruby driver for [FaunaDB](https://fauna.com).
 
 ## Installation
 
@@ -16,6 +21,15 @@ And then execute:
 
     $ bundle
 
+## Documentation
+
+The driver documentation is [hosted on GitHub Pages](https://faunadb.github.io/faunadb-ruby/).
+
+Please see the [FaunaDB Documentation](https://fauna.com/documentation) for
+a complete API reference, or look in
+[`/test`](https://github.com/faunadb/faunadb-ruby/tree/master/test) for more
+examples.
+
 ## Compatibility
 
 Tested and compatible with the following ruby versions:
@@ -95,39 +109,28 @@ $fauna.query { delete user[:ref] }
 ## Running Tests
 
 You can run tests against FaunaDB Cloud yourself.
-[Create an admin key](https://faunadb.com/account/keys) and set
-`FAUNA_ROOT_KEY` environment variable to it's secret. Then run `rake test`:
+[Create an admin key](https://fauna.com/account/keys) and set
+`FAUNA_ROOT_KEY` environment variable to it's secret. Then run `rake spec`:
 
 ```bash
 export FAUNA_ROOT_KEY='kqnPAbijGhkgAAC03-36hjCvcTnWf4Pl8w97UE1HeWo'
-rake test
+rake spec
 ```
 
 To run a single test, use e.g. `ruby test/client_test.rb`.
 
 Coverage is automatically run as part of the tests. After running tests, check
 `coverage/index.html` for the coverage report. If using jruby, use
-`JRUBY_OPTS="--debug" bundle exec rake test` to ensure coverage is generated
+`JRUBY_OPTS="--debug" bundle exec rake spec` to ensure coverage is generated
 correctly.
 
-## Documenting
-
-Use `rake rdoc` to generate documentation.
-
-## Further Reading
-
-Please see the [FaunaDB Documentation](https://faunadb.com/documentation) for
-a complete API reference, or look in
-[`/test`](https://github.com/faunadb/faunadb-ruby/tree/master/test) for more
-examples.
-
 ## Contributing
 
 GitHub pull requests are very welcome.
 
 ## LICENSE
 
-Copyright 2016 [Fauna, Inc.](https://faunadb.com/)
+Copyright 2016 [Fauna, Inc.](https://fauna.com/)
 
 Licensed under the Mozilla Public License, Version 2.0 (the
 "License"); you may not use this software except in compliance with

data/fauna.gemspec

@@ -5,7 +5,7 @@ Gem::Specification.new do |s|
   s.name = 'fauna'
   s.version = Fauna::VERSION.dup
   s.author = 'Fauna, Inc.'
-  s.email = 'priority@faunadb.com'
+  s.email = 'priority@fauna.com'
   s.summary = 'FaunaDB Ruby driver'
   s.description = 'Ruby driver for FaunaDB.'
   s.homepage = 'https://github.com/faunadb/faunadb-ruby'
@@ -22,5 +22,5 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency 'json', '~> 1.8'
   s.add_development_dependency 'rspec', '~> 3.4'
   s.add_development_dependency 'rubocop', '~> 0.38.0'
-  s.add_development_dependency 'coveralls', '= 0.8.14'
+  s.add_development_dependency 'codecov', '~> 0.1.5'
 end

data/lib/fauna.rb

@@ -7,7 +7,7 @@ require 'zlib'
 require 'time'
 
 ##
-# Main namespace for the FaunaDB client.
+# Main namespace for the FaunaDB driver.
 module Fauna; end
 
 require 'fauna/version'

data/lib/fauna/client.rb

@@ -24,7 +24,7 @@ module Fauna
     attr_reader :connection_timeout
     # Callback that will be passed a +RequestResult+ after every completed request.
     attr_reader :observer
-    # Faraday adapter in use.
+    # Faraday[https://github.com/lostisland/faraday] adapter in use.
     attr_reader :adapter
 
     ##
@@ -65,7 +65,7 @@ module Fauna
     ##
     # Issues a query to FaunaDB.
     #
-    # Queries are built via the Query helpers. See {FaunaDB Query API}[https://faunadb.com/documentation/queries]
+    # Queries are built via the Query helpers. See {FaunaDB Query API}[https://fauna.com/documentation/queries]
     # for information on constructing queries.
     #
     # +expression+:: A query expression
@@ -79,7 +79,7 @@ module Fauna
     #
     # <code>client.query { add(1, 2, subtract(3, 2)) }</code>
     #
-    # Reference: {Executing FaunaDB Queries}[https://faunadb.com/documentation#queries]
+    # Reference: {Executing FaunaDB Queries}[https://fauna.com/documentation#queries]
     #
     # :category: Query Methods
     def query(expression = nil, &expr_block)
@@ -94,7 +94,7 @@ module Fauna
     # Creates a Fauna::Page for paging/iterating over a set.
     #
     # +set+:: A set query to paginate over.
-    # +params+:: A list of parameters to pass to {paginate}[https://faunadb.com/documentation/queries#read_functions-paginate_set].
+    # +params+:: A list of parameters to pass to {paginate}[https://fauna.com/documentation/queries#read_functions-paginate_set].
     # +fauna_map+:: Optional block to wrap the generated paginate query with. The block will be run in a query context.
     #               The paginate query will be passed into the block as an argument.
     def paginate(set, params = {}, &fauna_map)
@@ -107,7 +107,7 @@ module Fauna
     # +path+:: Path to +GET+.
     # +query+:: Query parameters to append to the path.
     #
-    # Reference: {FaunaDB REST API}[https://faunadb.com/documentation/rest]
+    # Reference: {FaunaDB REST API}[https://fauna.com/documentation/rest]
     #
     # :category: REST Methods
     def get(path, query = {})
@@ -120,7 +120,7 @@ module Fauna
     # +path+:: Path to +POST+.
     # +data+:: Data to post as the body. +data+ is automatically converted to JSON.
     #
-    # Reference: {FaunaDB REST API}[https://faunadb.com/documentation/rest]
+    # Reference: {FaunaDB REST API}[https://fauna.com/documentation/rest]
     #
     # :category: REST Methods
     def post(path, data = {})
@@ -133,7 +133,7 @@ module Fauna
     # +path+:: Path to +PUT+.
     # +data+:: Data to post as the body. +data+ is automatically converted to JSON.
     #
-    # Reference: {FaunaDB REST API}[https://faunadb.com/documentation/rest]
+    # Reference: {FaunaDB REST API}[https://fauna.com/documentation/rest]
     #
     # :category: REST Methods
     def put(path, data = {})
@@ -146,7 +146,7 @@ module Fauna
     # +path+:: Path to +PATCH+.
     # +data+:: Data to post as the body. +data+ is automatically converted to JSON.
     #
-    # Reference: {FaunaDB REST API}[https://faunadb.com/documentation/rest]
+    # Reference: {FaunaDB REST API}[https://fauna.com/documentation/rest]
     #
     # :category: REST Methods
     def patch(path, data = {})
@@ -158,7 +158,7 @@ module Fauna
     #
     # +path+:: Path to +DELETE+.
     #
-    # Reference: {FaunaDB REST API}[https://faunadb.com/documentation/rest]
+    # Reference: {FaunaDB REST API}[https://fauna.com/documentation/rest]
     #
     # :category: REST Methods
     def delete(path)
@@ -168,7 +168,7 @@ module Fauna
     ##
     # Ping FaunaDB.
     #
-    # Reference: {FaunaDB Rest API}[https://faunadb.com/documentation#rest-other].
+    # Reference: {FaunaDB Rest API}[https://fauna.com/documentation#rest-other].
     #
     # :category: REST Methods
     def ping(params = {})
@@ -209,7 +209,22 @@ module Fauna
       path = path.to_s
 
       start_time = Time.now
-      response = perform_request action, path, query, data
+      begin
+        response = perform_request action, path, query, data
+      rescue Faraday::ClientError => e
+        end_time = Time.now
+
+        message = e.class.name
+        unless e.message.nil?
+          message += ": #{e.message}"
+        end
+
+        request_result = RequestResult.new(self,
+            action, path, query, data,
+            nil, nil, nil, nil,
+            start_time, end_time)
+        raise UnexpectedError.new(message, request_result)
+      end
       end_time = Time.now
 
       response_raw = response.body
@@ -223,7 +238,7 @@ module Fauna
 
       @observer.call(request_result) unless @observer.nil?
 
-      if response_json.nil?
+      if response_json.nil? && response.status != 503
         fail UnexpectedError.new('Invalid JSON.', request_result)
       end
 
@@ -237,6 +252,8 @@ module Fauna
         req.body = FaunaJson.to_json(data) unless data.nil?
         req.url(path || '')
       end
+    rescue Faraday::ConnectionFailed, Faraday::TimeoutError, Faraday::SSLError => e
+      raise UnavailableError.new(e)
     end
   end
 

data/lib/fauna/context.rb

@@ -46,7 +46,7 @@ module Fauna
     # +path+:: Path to +GET+.
     # +query+:: Query parameters to append to the path.
     #
-    # Reference: {FaunaDB REST API}[https://faunadb.com/documentation/rest]
+    # Reference: {FaunaDB REST API}[https://fauna.com/documentation/rest]
     #
     # :category: Client Methods
     def self.get(path, query = {})
@@ -59,7 +59,7 @@ module Fauna
     # +path+:: Path to +POST+.
     # +data+:: Data to post as the body.
     #
-    # Reference: {FaunaDB REST API}[https://faunadb.com/documentation/rest]
+    # Reference: {FaunaDB REST API}[https://fauna.com/documentation/rest]
     #
     # :category: Client Methods
     def self.post(path, data = {})
@@ -72,7 +72,7 @@ module Fauna
     # +path+:: Path to +PUT+.
     # +data+:: Data to post as the body.
     #
-    # Reference: {FaunaDB REST API}[https://faunadb.com/documentation/rest]
+    # Reference: {FaunaDB REST API}[https://fauna.com/documentation/rest]
     #
     # :category: Client Methods
     def self.put(path, data = {})
@@ -85,7 +85,7 @@ module Fauna
     # +path+:: Path to +PATCH+.
     # +data+:: Data to post as the body.
     #
-    # Reference: {FaunaDB REST API}[https://faunadb.com/documentation/rest]
+    # Reference: {FaunaDB REST API}[https://fauna.com/documentation/rest]
     #
     # :category: Client Methods
     def self.patch(path, data = {})
@@ -98,7 +98,7 @@ module Fauna
     # +path+:: Path to +DELETE+.
     # +data+:: Data to post as the body.
     #
-    # Reference: {FaunaDB REST API}[https://faunadb.com/documentation/rest]
+    # Reference: {FaunaDB REST API}[https://fauna.com/documentation/rest]
     #
     # :category: Client Methods
     def self.delete(path)
@@ -108,7 +108,7 @@ module Fauna
     ##
     # Issues a query to FaunaDB with the current client context.
     #
-    # Queries are built via the Query helpers. See {FaunaDB Query API}[https://faunadb.com/documentation/queries]
+    # Queries are built via the Query helpers. See {FaunaDB Query API}[https://fauna.com/documentation/queries]
     # for information on constructing queries.
     #
     # +expression+:: A query expression
@@ -122,7 +122,7 @@ module Fauna
     # Creates a Fauna::Page for paging/iterating over a set with the current client context.
     #
     # +set+:: A set query to paginate over.
-    # +params+:: A list of parameters to pass to {paginate}[https://faunadb.com/documentation/queries#read_functions-paginate_set].
+    # +params+:: A list of parameters to pass to {paginate}[https://fauna.com/documentation/queries#read_functions-paginate_set].
     # +fauna_map+:: Optional block to wrap the generated paginate query with. The block will be run in a query context.
     #               The paginate query will be passed into the block as an argument.
     def self.paginate(set, params = {}, &fauna_map)

data/lib/fauna/errors.rb

@@ -20,7 +20,7 @@ module Fauna
 
   ##
   # Error returned by the FaunaDB server.
-  # For documentation of error types, see the docs[https://faunadb.com/documentation#errors].
+  # For documentation of error types, see the docs[https://fauna.com/documentation#errors].
   class FaunaError < RuntimeError
     # List of ErrorData objects returned by the server.
     attr_reader :errors
@@ -55,34 +55,52 @@ module Fauna
       end
     end
 
-    # Creates a new error from a given RequestResult.
+    # Creates a new error from a given RequestResult or Exception.
     def initialize(request_result)
-      @request_result = request_result
-      errors_raw = UnexpectedError.get_or_raise request_result, request_result.response_content, :errors
-      @errors = catch :invalid_response do
-        throw :invalid_response unless errors_raw.is_a? Array
-        errors_raw.map { |error| ErrorData.from_hash(error) }
-      end
+      message = nil
 
-      if @errors.nil?
-        fail UnexpectedError.new('Error data has an unexpected format.', request_result)
-      elsif @errors.empty?
-        fail UnexpectedError.new('Error data returned was blank.', request_result)
-      end
+      if request_result.is_a? RequestResult
+        @request_result = request_result
 
-      message = @errors.map do |error|
-        msg = 'Error'
-        msg += " at #{error.position}" unless error.position.nil?
-        msg += ": #{error.code} - #{error.description}"
+        begin
+          errors_raw = UnexpectedError.get_or_raise request_result, request_result.response_content, :errors
+          @errors = catch :invalid_response do
+            throw :invalid_response unless errors_raw.is_a? Array
+            errors_raw.map { |error| ErrorData.from_hash(error) }
+          end
 
-        unless error.failures.nil?
-          msg += ' (' + error.failures.map do |failure|
-            "Failure at #{failure.field}: #{failure.code} - #{failure.description}"
-          end.join(' ') + ')'
-        end
+          if @errors.nil?
+            fail UnexpectedError.new('Error data has an unexpected format.', request_result)
+          elsif @errors.empty?
+            fail UnexpectedError.new('Error data returned was blank.', request_result)
+          end
 
-        msg
-      end.join(' ')
+          message = @errors.map do |error|
+            msg = 'Error'
+            msg += " at #{error.position}" unless error.position.nil?
+            msg += ": #{error.code} - #{error.description}"
+
+            unless error.failures.nil?
+              msg += ' (' + error.failures.map do |failure|
+                "Failure at #{failure.field}: #{failure.code} - #{failure.description}"
+              end.join(' ') + ')'
+            end
+
+            msg
+          end.join(' ')
+        rescue UnexpectedError => e
+          if request_result.status_code != 503
+            raise e
+          end
+
+          message = request_result.response_raw
+        end
+      elsif request_result.is_a? Exception
+        message = request_result.class.name
+        unless request_result.message.nil?
+          message += ": #{request_result.message}"
+        end
+      end
 
       super(message)
     end
@@ -117,7 +135,7 @@ module Fauna
     ##
     # Error code.
     #
-    # Reference: {FaunaDB Error codes}[https://faunadb.com/documentation#errors]
+    # Reference: {FaunaDB Error codes}[https://fauna.com/documentation#errors]
     attr_reader :code
     # Error description.
     attr_reader :description
@@ -148,7 +166,7 @@ module Fauna
 
   ##
   # Part of ErrorData.
-  # For more information, see the {docs}[https://faunadb.com/documentation#errors-invalid_data].
+  # For more information, see the {docs}[https://fauna.com/documentation#errors-invalid_data].
   class Failure
     # Failure code.
     attr_reader :code

data/lib/fauna/objects.rb

@@ -2,7 +2,7 @@ module Fauna
   ##
   # A Ref.
   #
-  # Reference: {FaunaDB Special Types}[https://faunadb.com/documentation/queries-values-special_types]
+  # Reference: {FaunaDB Special Types}[https://fauna.com/documentation/queries-values-special_types]
   class Ref
     # The raw ref string.
     attr_accessor :value
@@ -63,7 +63,7 @@ module Fauna
   ##
   # A SetRef.
   #
-  # Reference: {FaunaDB Special Types}[https://faunadb.com/documentation/queries-values-special_types]
+  # Reference: {FaunaDB Special Types}[https://fauna.com/documentation/queries-values-special_types]
   class SetRef
     # The raw set hash.
     attr_accessor :value
@@ -73,7 +73,7 @@ module Fauna
     #
     # +params+:: Hash of parameters to build the SetRef with.
     #
-    # Reference: {FaunaDB Special Types}[https://faunadb.com/documentation/queries-values-special_types]
+    # Reference: {FaunaDB Special Types}[https://fauna.com/documentation/queries-values-special_types]
     def initialize(params = {})
       self.value = params
     end

data/lib/fauna/page.rb

@@ -46,7 +46,7 @@ module Fauna
     #
     # +client+:: Client to execute queries with.
     # +set+:: A set query to paginate over.
-    # +params+:: A list of parameters to pass to {paginate}[https://faunadb.com/documentation/queries#read_functions-paginate_set].
+    # +params+:: A list of parameters to pass to {paginate}[https://fauna.com/documentation/queries#read_functions-paginate_set].
     # +lambda+:: Optional lambda to map the generated paginate query with. The block will be run in a query context.
     #            An element from the current page will be passed into the block as an argument. See #map for more info.
     def initialize(client, set, params = {}, &lambda)
@@ -128,7 +128,7 @@ module Fauna
     ##
     # Returns a copy of the page with the given +params+ set.
     #
-    # See {paginate}[https://faunadb.com/documentation/queries#read_functions-paginate_set] for more details.
+    # See {paginate}[https://fauna.com/documentation/queries#read_functions-paginate_set] for more details.
     def with_params(params = {})
       with_dup do |page|
         page_params = page.instance_variable_get(:@params)

data/lib/fauna/query.rb

@@ -42,7 +42,7 @@ module Fauna
     ##
     # Construct a ref value
     #
-    # Reference: {FaunaDB Values}[https://faunadb.com/documentation/queries#values]
+    # Reference: {FaunaDB Values}[https://fauna.com/documentation/queries#values]
     def ref(str, id = nil)
       if id.nil?
         Ref.new(str)
@@ -59,7 +59,7 @@ module Fauna
     #   Fauna.query { { x: 1, y: add(1, 2) } }
     #   Fauna.query { object(x: 1, y: add(1, 2)) }
     #
-    # Reference: {FaunaDB Basic Forms}[https://faunadb.com/documentation/queries#basic_forms]
+    # Reference: {FaunaDB Basic Forms}[https://fauna.com/documentation/queries#basic_forms]
     def object(fields)
       Expr.new object: Expr.wrap_values(fields)
     end
@@ -75,7 +75,7 @@ module Fauna
     #
     # Expression example: <code>Fauna.query { let({ x: 2 }, add(1, var(:x))) }</code>.
     #
-    # Reference: {FaunaDB Basic Forms}[https://faunadb.com/documentation/queries#basic_forms]
+    # Reference: {FaunaDB Basic Forms}[https://fauna.com/documentation/queries#basic_forms]
     def let(vars, expr = nil, &block)
       in_ =
         if block.nil?
@@ -97,7 +97,7 @@ module Fauna
     ##
     # A var expression
     #
-    # Reference: {FaunaDB Basic Forms}[https://faunadb.com/documentation/queries#basic_forms]
+    # Reference: {FaunaDB Basic Forms}[https://fauna.com/documentation/queries#basic_forms]
     def var(name)
       Expr.new var: Expr.wrap(name)
     end
@@ -105,7 +105,7 @@ module Fauna
     ##
     # An if expression
     #
-    # Reference: {FaunaDB Basic Forms}[https://faunadb.com/documentation/queries#basic_forms]
+    # Reference: {FaunaDB Basic Forms}[https://fauna.com/documentation/queries#basic_forms]
     def if_(condition, then_, else_)
       Expr.new if: Expr.wrap(condition), then: Expr.wrap(then_), else: Expr.wrap(else_)
     end
@@ -113,7 +113,7 @@ module Fauna
     ##
     # A do expression
     #
-    # Reference: {FaunaDB Basic Forms}[https://faunadb.com/documentation/queries#basic_forms]
+    # Reference: {FaunaDB Basic Forms}[https://fauna.com/documentation/queries#basic_forms]
     def do_(*expressions)
       Expr.new do: Expr.wrap_varargs(expressions)
     end
@@ -121,7 +121,7 @@ module Fauna
     ##
     # A lambda expression
     #
-    # Reference: {FaunaDB Basic Forms}[https://faunadb.com/documentation/queries#basic_forms]
+    # Reference: {FaunaDB Basic Forms}[https://fauna.com/documentation/queries#basic_forms]
     #
     # This form generates #var objects for you, and is called like:
     #
@@ -159,7 +159,7 @@ module Fauna
     ##
     # A raw lambda expression
     #
-    # Reference: {FaunaDB Basic Forms}[https://faunadb.com/documentation/queries#basic_forms]
+    # Reference: {FaunaDB Basic Forms}[https://fauna.com/documentation/queries#basic_forms]
     #
     # See also #lambda.
     def lambda_expr(var, expr)
@@ -174,7 +174,7 @@ module Fauna
     # Only one of +lambda_expr+ or +lambda_block+ should be provided.
     # For example: <code>Fauna.query { map(collection) { |a| add a, 1 } }</code>.
     #
-    # Reference: {FaunaDB Collections}[https://faunadb.com/documentation/queries#collection_functions]
+    # Reference: {FaunaDB Collections}[https://fauna.com/documentation/queries#collection_functions]
     def map(collection, lambda_expr = nil, &lambda_block)
       Expr.new map: Expr.wrap(lambda_expr || lambda_block), collection: Expr.wrap(collection)
     end
@@ -185,7 +185,7 @@ module Fauna
     # Only one of +lambda_expr+ or +lambda_block+ should be provided.
     # For example: <code>Fauna.query { foreach(collection) { |a| delete a } }</code>.
     #
-    # Reference: {FaunaDB Collections}[https://faunadb.com/documentation/queries#collection_functions]
+    # Reference: {FaunaDB Collections}[https://fauna.com/documentation/queries#collection_functions]
     def foreach(collection, lambda_expr = nil, &lambda_block)
       Expr.new foreach: Expr.wrap(lambda_expr || lambda_block), collection: Expr.wrap(collection)
     end
@@ -196,7 +196,7 @@ module Fauna
     # Only one of +lambda_expr+ or +lambda_block+ should be provided.
     # For example: <code>Fauna.query { filter(collection) { |a| equals a, 1 } }</code>.
     #
-    # Reference: {FaunaDB Collections}[https://faunadb.com/documentation/queries#collection_functions]
+    # Reference: {FaunaDB Collections}[https://fauna.com/documentation/queries#collection_functions]
     def filter(collection, lambda_expr = nil, &lambda_block)
       Expr.new filter: Expr.wrap(lambda_expr || lambda_block), collection: Expr.wrap(collection)
     end
@@ -204,7 +204,7 @@ module Fauna
     ##
     # A take expression
     #
-    # Reference: {FaunaDB Collections}[https://faunadb.com/documentation/queries#collection_functions]
+    # Reference: {FaunaDB Collections}[https://fauna.com/documentation/queries#collection_functions]
     def take(number, collection)
       Expr.new take: Expr.wrap(number), collection: Expr.wrap(collection)
     end
@@ -212,7 +212,7 @@ module Fauna
     ##
     # A drop expression
     #
-    # Reference: {FaunaDB Collections}[https://faunadb.com/documentation/queries#collection_functions]
+    # Reference: {FaunaDB Collections}[https://fauna.com/documentation/queries#collection_functions]
     def drop(number, collection)
       Expr.new drop: Expr.wrap(number), collection: Expr.wrap(collection)
     end
@@ -220,7 +220,7 @@ module Fauna
     ##
     # A prepend expression
     #
-    # Reference: {FaunaDB Collections}[https://faunadb.com/documentation/queries#collection_functions]
+    # Reference: {FaunaDB Collections}[https://fauna.com/documentation/queries#collection_functions]
     def prepend(collection, elements)
       Expr.new prepend: Expr.wrap(elements), collection: Expr.wrap(collection)
     end
@@ -228,7 +228,7 @@ module Fauna
     ##
     # An append expression
     #
-    # Reference: {FaunaDB Collections}[https://faunadb.com/documentation/queries#collection_functions]
+    # Reference: {FaunaDB Collections}[https://fauna.com/documentation/queries#collection_functions]
     def append(collection, elements)
       Expr.new append: Expr.wrap(elements), collection: Expr.wrap(collection)
     end
@@ -238,7 +238,7 @@ module Fauna
     ##
     # A get expression
     #
-    # Reference: {FaunaDB Read functions}[https://faunadb.com/documentation/queries#read_functions]
+    # Reference: {FaunaDB Read functions}[https://fauna.com/documentation/queries#read_functions]
     def get(ref, params = {})
       Expr.new Expr.wrap_values(params).merge(get: Expr.wrap(ref))
     end
@@ -246,7 +246,7 @@ module Fauna
     ##
     # A paginate expression
     #
-    # Reference: {FaunaDB Read functions}[https://faunadb.com/documentation/queries#read_functions]
+    # Reference: {FaunaDB Read functions}[https://fauna.com/documentation/queries#read_functions]
     def paginate(set, params = {})
       Expr.new Expr.wrap_values(params).merge(paginate: Expr.wrap(set))
     end
@@ -254,25 +254,17 @@ module Fauna
     ##
     # An exists expression
     #
-    # Reference: {FaunaDB Read functions}[https://faunadb.com/documentation/queries#read_functions]
+    # Reference: {FaunaDB Read functions}[https://fauna.com/documentation/queries#read_functions]
     def exists(ref, params = {})
       Expr.new Expr.wrap_values(params).merge(exists: Expr.wrap(ref))
     end
 
-    ##
-    # A count expression
-    #
-    # Reference: {FaunaDB Read functions}[https://faunadb.com/documentation/queries#read_functions]
-    def count(set, params = {})
-      Expr.new Expr.wrap_values(params).merge(count: Expr.wrap(set))
-    end
-
     # :section: Write Functions
 
     ##
     # A create expression
     #
-    # Reference: {FaunaDB Write functions}[https://faunadb.com/documentation/queries#write_functions]
+    # Reference: {FaunaDB Write functions}[https://fauna.com/documentation/queries#write_functions]
     def create(class_ref, params)
       Expr.new create: Expr.wrap(class_ref), params: Expr.wrap(params)
     end
@@ -280,7 +272,7 @@ module Fauna
     ##
     # An update expression
     #
-    # Reference: {FaunaDB Write functions}[https://faunadb.com/documentation/queries#write_functions]
+    # Reference: {FaunaDB Write functions}[https://fauna.com/documentation/queries#write_functions]
     def update(ref, params)
       Expr.new update: Expr.wrap(ref), params: Expr.wrap(params)
     end
@@ -288,7 +280,7 @@ module Fauna
     ##
     # A replace expression
     #
-    # Reference: {FaunaDB Write functions}[https://faunadb.com/documentation/queries#write_functions]
+    # Reference: {FaunaDB Write functions}[https://fauna.com/documentation/queries#write_functions]
     def replace(ref, params)
       Expr.new replace: Expr.wrap(ref), params: Expr.wrap(params)
     end
@@ -296,7 +288,7 @@ module Fauna
     ##
     # A delete expression
     #
-    # Reference: {FaunaDB Write functions}[https://faunadb.com/documentation/queries#write_functions]
+    # Reference: {FaunaDB Write functions}[https://fauna.com/documentation/queries#write_functions]
     def delete(ref)
       Expr.new delete: Expr.wrap(ref)
     end
@@ -304,7 +296,7 @@ module Fauna
     ##
     # An insert expression
     #
-    # Reference: {FaunaDB Write functions}[https://faunadb.com/documentation/queries#write_functions]
+    # Reference: {FaunaDB Write functions}[https://fauna.com/documentation/queries#write_functions]
     def insert(ref, ts, action, params)
       Expr.new insert: Expr.wrap(ref), ts: Expr.wrap(ts), action: Expr.wrap(action), params: Expr.wrap(params)
     end
@@ -312,17 +304,49 @@ module Fauna
     ##
     # A remove expression
     #
-    # Reference: {FaunaDB Write functions}[https://faunadb.com/documentation/queries#write_functions]
+    # Reference: {FaunaDB Write functions}[https://fauna.com/documentation/queries#write_functions]
     def remove(ref, ts, action)
       Expr.new remove: Expr.wrap(ref), ts: Expr.wrap(ts), action: Expr.wrap(action)
     end
 
+    ##
+    # A create class expression
+    #
+    # Reference: {FaunaDB Write functions}[https://fauna.com/documentation/queries#write_functions]
+    def create_class(params)
+      Expr.new create_class: Expr.wrap(params)
+    end
+
+    ##
+    # A create index expression
+    #
+    # Reference: {FaunaDB Write functions}[https://fauna.com/documentation/queries#write_functions]
+    def create_index(params)
+      Expr.new create_index: Expr.wrap(params)
+    end
+
+    ##
+    # A create database expression
+    #
+    # Reference: {FaunaDB Write functions}[https://fauna.com/documentation/queries#write_functions]
+    def create_database(params)
+      Expr.new create_database: Expr.wrap(params)
+    end
+
+    ##
+    # A create key expression
+    #
+    # Reference: {FaunaDB Write functions}[https://fauna.com/documentation/queries#write_functions]
+    def create_key(params)
+      Expr.new create_key: Expr.wrap(params)
+    end
+
     # :section: Set Functions
 
     ##
     # A match expression
     #
-    # Reference: {FaunaDB Sets}[https://faunadb.com/documentation/queries#sets]
+    # Reference: {FaunaDB Sets}[https://fauna.com/documentation/queries#sets]
     def match(index, *terms)
       Expr.new match: Expr.wrap(index), terms: Expr.wrap_varargs(terms)
     end
@@ -330,7 +354,7 @@ module Fauna
     ##
     # A union expression
     #
-    # Reference: {FaunaDB Sets}[https://faunadb.com/documentation/queries#sets]
+    # Reference: {FaunaDB Sets}[https://fauna.com/documentation/queries#sets]
     def union(*sets)
       Expr.new union: Expr.wrap_varargs(sets)
     end
@@ -338,7 +362,7 @@ module Fauna
     ##
     # An intersection expression
     #
-    # Reference: {FaunaDB Sets}[https://faunadb.com/documentation/queries#sets]
+    # Reference: {FaunaDB Sets}[https://fauna.com/documentation/queries#sets]
     def intersection(*sets)
       Expr.new intersection: Expr.wrap_varargs(sets)
     end
@@ -346,7 +370,7 @@ module Fauna
     ##
     # A difference expression
     #
-    # Reference: {FaunaDB Sets}[https://faunadb.com/documentation/queries#sets]
+    # Reference: {FaunaDB Sets}[https://fauna.com/documentation/queries#sets]
     def difference(*sets)
       Expr.new difference: Expr.wrap_varargs(sets)
     end
@@ -354,7 +378,7 @@ module Fauna
     ##
     # A distinct expression
     #
-    # Reference: {FaunaDB Sets}[https://faunadb.com/documentation/queries#sets]
+    # Reference: {FaunaDB Sets}[https://fauna.com/documentation/queries#sets]
     def distinct(set)
       Expr.new distinct: Expr.wrap(set)
     end
@@ -365,7 +389,7 @@ module Fauna
     # Only one of +target_expr+ or +target_block+ should be provided.
     # For example: <code>Fauna.query { join(source) { |x| match some_index, x } }</code>.
     #
-    # Reference: {FaunaDB Sets}[https://faunadb.com/documentation/queries#sets]
+    # Reference: {FaunaDB Sets}[https://fauna.com/documentation/queries#sets]
     def join(source, target_expr = nil, &target_block)
       Expr.new join: Expr.wrap(source), with: Expr.wrap(target_expr || target_block)
     end
@@ -375,7 +399,7 @@ module Fauna
     ##
     # A login function
     #
-    # Reference: {FaunaDB Authentication}[https://faunadb.com/documentation/queries#auth_functions]
+    # Reference: {FaunaDB Authentication}[https://fauna.com/documentation/queries#auth_functions]
     def login(ref, params)
       Expr.new login: Expr.wrap(ref), params: Expr.wrap(params)
     end
@@ -383,7 +407,7 @@ module Fauna
     ##
     # A logout function
     #
-    # Reference: {FaunaDB Authentication}[https://faunadb.com/documentation/queries#auth_functions]
+    # Reference: {FaunaDB Authentication}[https://fauna.com/documentation/queries#auth_functions]
     def logout(all_tokens)
       Expr.new logout: Expr.wrap(all_tokens)
     end
@@ -391,7 +415,7 @@ module Fauna
     ##
     # An identify function
     #
-    # Reference: {FaunaDB Authentication}[https://faunadb.com/documentation/queries#auth_functions]
+    # Reference: {FaunaDB Authentication}[https://fauna.com/documentation/queries#auth_functions]
     def identify(ref, password)
       Expr.new identify: Expr.wrap(ref), password: Expr.wrap(password)
     end
@@ -401,7 +425,7 @@ module Fauna
     ##
     # A concat function
     #
-    # Reference: {FaunaDB String Functions}[https://faunadb.com/documentation/queries#string_functions]
+    # Reference: {FaunaDB String Functions}[https://fauna.com/documentation/queries#string_functions]
     def concat(strings, separator = nil)
       if separator.nil?
         Expr.new concat: Expr.wrap(strings)
@@ -413,7 +437,7 @@ module Fauna
     ##
     # A casefold function
     #
-    # Reference: {FaunaDB String Functions}[https://faunadb.com/documentation/queries#string_functions]
+    # Reference: {FaunaDB String Functions}[https://fauna.com/documentation/queries#string_functions]
     def casefold(string)
       Expr.new casefold: Expr.wrap(string)
     end
@@ -423,7 +447,7 @@ module Fauna
     ##
     # A time expression
     #
-    # Reference: {FaunaDB Time Functions}[https://faunadb.com/documentation/queries#time_functions]
+    # Reference: {FaunaDB Time Functions}[https://fauna.com/documentation/queries#time_functions]
     def time(string)
       Expr.new time: Expr.wrap(string)
     end
@@ -431,7 +455,7 @@ module Fauna
     ##
     # An epoch expression
     #
-    # Reference: {FaunaDB Time Functions}[https://faunadb.com/documentation/queries#time_functions]
+    # Reference: {FaunaDB Time Functions}[https://fauna.com/documentation/queries#time_functions]
     def epoch(number, unit)
       Expr.new epoch: Expr.wrap(number), unit: Expr.wrap(unit)
     end
@@ -439,7 +463,7 @@ module Fauna
     ##
     # A date expression
     #
-    # Reference: {FaunaDB Time Functions}[https://faunadb.com/documentation/queries#time_functions]
+    # Reference: {FaunaDB Time Functions}[https://fauna.com/documentation/queries#time_functions]
     def date(string)
       Expr.new date: Expr.wrap(string)
     end
@@ -449,15 +473,39 @@ module Fauna
     ##
     # A next_id function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation#queries-misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation#queries-misc_functions]
     def next_id
       Expr.new next_id: nil
     end
 
+    ##
+    # A database function
+    #
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation#queries-misc_functions]
+    def database(name)
+      Expr.new database: Expr.wrap(name)
+    end
+
+    ##
+    # A class function
+    #
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation#queries-misc_functions]
+    def class_(name)
+      Expr.new class: Expr.wrap(name)
+    end
+
+    ##
+    # An index function
+    #
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation#queries-misc_functions]
+    def index(name)
+      Expr.new index: Expr.wrap(name)
+    end
+
     ##
     # An equals function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation#queries-misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation#queries-misc_functions]
     def equals(*values)
       Expr.new equals: Expr.wrap_varargs(values)
     end
@@ -465,7 +513,7 @@ module Fauna
     ##
     # A contains function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def contains(path, in_)
       Expr.new contains: Expr.wrap(path), in: Expr.wrap(in_)
     end
@@ -473,7 +521,7 @@ module Fauna
     ##
     # A select function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def select(path, from, params = {})
       Expr.new Expr.wrap_values(params).merge(select: Expr.wrap(path), from: Expr.wrap(from))
     end
@@ -481,7 +529,7 @@ module Fauna
     ##
     # An add function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def add(*numbers)
       Expr.new add: Expr.wrap_varargs(numbers)
     end
@@ -489,7 +537,7 @@ module Fauna
     ##
     # A multiply function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def multiply(*numbers)
       Expr.new multiply: Expr.wrap_varargs(numbers)
     end
@@ -497,7 +545,7 @@ module Fauna
     ##
     # A subtract function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def subtract(*numbers)
       Expr.new subtract: Expr.wrap_varargs(numbers)
     end
@@ -505,7 +553,7 @@ module Fauna
     ##
     # A divide function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def divide(*numbers)
       Expr.new divide: Expr.wrap_varargs(numbers)
     end
@@ -513,7 +561,7 @@ module Fauna
     ##
     # A modulo function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def modulo(*numbers)
       Expr.new modulo: Expr.wrap_varargs(numbers)
     end
@@ -521,7 +569,7 @@ module Fauna
     ##
     # A less than function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def lt(*values)
       Expr.new lt: Expr.wrap_varargs(values)
     end
@@ -529,7 +577,7 @@ module Fauna
     ##
     # A less than or equal function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def lte(*values)
       Expr.new lte: Expr.wrap_varargs(values)
     end
@@ -537,7 +585,7 @@ module Fauna
     ##
     # A greater than function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def gt(*values)
       Expr.new gt: Expr.wrap_varargs(values)
     end
@@ -545,7 +593,7 @@ module Fauna
     ##
     # A greater than or equal function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def gte(*values)
       Expr.new gte: Expr.wrap_varargs(values)
     end
@@ -553,7 +601,7 @@ module Fauna
     ##
     # An and function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def and_(*booleans)
       Expr.new and: Expr.wrap_varargs(booleans)
     end
@@ -561,7 +609,7 @@ module Fauna
     ##
     # An or function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def or_(*booleans)
       Expr.new or: Expr.wrap_varargs(booleans)
     end
@@ -569,7 +617,7 @@ module Fauna
     ##
     # A not function
     #
-    # Reference: {FaunaDB Miscellaneous Functions}[https://faunadb.com/documentation/queries#misc_functions]
+    # Reference: {FaunaDB Miscellaneous Functions}[https://fauna.com/documentation/queries#misc_functions]
     def not_(boolean)
       Expr.new not: Expr.wrap(boolean)
     end

data/lib/fauna/version.rb

@@ -1,4 +1,4 @@
 module Fauna
   # The version of the Fauna gem
-  VERSION = '2.1.2'.freeze
+  VERSION = '2.2.0'.freeze
 end

data/spec/errors_spec.rb

@@ -31,6 +31,15 @@ RSpec.describe 'Fauna Errors' do
     Fauna::Client.new(adapter: [:test, stubs])
   end
 
+  # Create client with stub adapter responding to / with the given exception
+  def stub_error(exception)
+    stubs = Faraday::Adapter::Test::Stubs.new
+    stubs.get '/' do
+      fail exception
+    end
+    Fauna::Client.new(adapter: [:test, stubs])
+  end
+
   it 'sets request result' do
     expect { client.post '', foo: 'bar' }.to raise_error do |err|
       expect(err).to be_a(Fauna::BadRequest)
@@ -114,10 +123,25 @@ RSpec.describe 'Fauna Errors' do
   end
 
   describe Fauna::UnavailableError do
-    it 'is handled' do
+    it 'handles fauna 503' do
       stub_client = stub_get 503, '{"errors": [{"code": "unavailable", "description": "on vacation"}]}'
       expect { stub_client.get '' }.to raise_fauna_error(Fauna::UnavailableError, 'unavailable')
     end
+
+    it 'handles upstream 503' do
+      stub_client = stub_get 503, 'Unable to reach server'
+      expect { stub_client.get '' }.to raise_error(Fauna::UnavailableError, 'Unable to reach server')
+    end
+
+    it 'handles timeout error' do
+      stub_client = stub_error Faraday::TimeoutError.new('timeout')
+      expect { stub_client.get '' }.to raise_error(Fauna::UnavailableError, 'Faraday::TimeoutError: timeout')
+    end
+
+    it 'handles connection error' do
+      stub_client = stub_error Faraday::ConnectionFailed.new('connection refused')
+      expect { stub_client.get '' }.to raise_error(Fauna::UnavailableError, 'Faraday::ConnectionFailed: connection refused')
+    end
   end
 
   describe Fauna::UnexpectedError do
@@ -144,5 +168,9 @@ RSpec.describe 'Fauna Errors' do
     it 'raised for empty errors' do
       expect { stub_get(500, '{"errors": []}').get('') }.to raise_error(Fauna::UnexpectedError, /blank/)
     end
+
+    it 'raised for parsing error' do
+      expect { stub_error(Faraday::ParsingError.new('parse error')).get('') }.to raise_error(Fauna::UnexpectedError, /parse error/)
+    end
   end
 end

data/spec/fauna_helper.rb

@@ -23,6 +23,11 @@ module FaunaTestHelpers
     @server_client
   end
 
+  def admin_client
+    fail 'Admin client not initialized' if @admin_client.nil?
+    @admin_client
+  end
+
   def create_test_db
     @db_ref = Fauna::Ref.new "databases/faunadb-ruby-test-#{random_string}"
 
@@ -31,6 +36,7 @@ module FaunaTestHelpers
 
     begin
       server_key = root.query { create ref('keys'), database: @db_ref, role: 'server' }
+      admin_key = root.query { create ref('keys'), database: @db_ref, role: 'admin' }
     rescue
       root.query { delete @db_ref }
       @db_ref = nil
@@ -39,6 +45,8 @@ module FaunaTestHelpers
 
     @server_secret = server_key[:secret]
     @server_client = get_client secret: @server_secret
+    @admin_secret = admin_key[:secret]
+    @admin_client = get_client secret: @admin_secret
   end
 
   def destroy_test_db

data/spec/query_spec.rb

@@ -320,20 +320,6 @@ RSpec.describe Fauna::Query do
     end
   end
 
-  describe '#count' do
-    before do
-      @x_value = random_number
-      @x_refs = (1..3).collect { create_instance(x: @x_value)[:ref] }
-    end
-
-    it 'performs count' do
-      set = Fauna::Query.match(@test_by_x, @x_value)
-
-      # Count is only approximate; should be equal to @x_refs.length
-      expect(client.query { count set }).to be_a(Integer)
-    end
-  end
-
   describe '#create' do
     it 'performs create' do
       instance = client.query { create(@test_class, {}) }
@@ -406,6 +392,48 @@ RSpec.describe Fauna::Query do
     end
   end
 
+  describe '#create_class' do
+    it 'creates a class' do
+      # Create a class
+      ref = client.query { create_class(name: random_string) }[:ref]
+
+      # Assert it was created
+      expect(client.query { exists(ref) }).to be(true)
+    end
+  end
+
+  describe '#create_index' do
+    it 'creates an index' do
+      # Create an index
+      class_ref = client.query { create(ref('classes'), name: random_string) }[:ref]
+      ref = client.query { create_index(name: random_string, source: class_ref) }[:ref]
+
+      # Assert it was created
+      expect(client.query { exists(ref) }).to be(true)
+    end
+  end
+
+  describe '#create_database' do
+    it 'creates a database' do
+      # Create a database
+      ref = admin_client.query { create_database(name: random_string) }[:ref]
+
+      # Assert it was created
+      expect(admin_client.query { exists(ref) }).to be(true)
+    end
+  end
+
+  describe '#create_key' do
+    it 'creates a key' do
+      # Create a key
+      db_ref = admin_client.query { create(ref('databases'), name: random_string) }[:ref]
+      ref = admin_client.query { create_key(database: db_ref, role: 'server') }[:ref]
+
+      # Assert it was created
+      expect(admin_client.query { exists(ref) }).to be(true)
+    end
+  end
+
   describe 'sets' do
     before do
       @x_value = random_number
@@ -593,6 +621,40 @@ RSpec.describe Fauna::Query do
     end
   end
 
+  describe '#database' do
+    it 'gets an existing database' do
+      # Create a database
+      name = random_string
+      ref = admin_client.query { create_database(name: name) }[:ref]
+
+      # Get the database ref
+      expect(admin_client.query { database(name) }).to eq(ref)
+    end
+  end
+
+  describe '#class' do
+    it 'gets an existing class' do
+      # Create a class
+      name = random_string
+      ref = client.query { create_class(name: name) }[:ref]
+
+      # Get the class ref
+      expect(client.query { class_(name) }).to eq(ref)
+    end
+  end
+
+  describe '#index' do
+    it 'gets an existing index' do
+      # Create an index
+      class_ref = client.query { create_class(name: random_string) }[:ref]
+      name = random_string
+      ref = client.query { create_index(name: name, source: class_ref) }[:ref]
+
+      # Get the index ref
+      expect(client.query { index(name) }).to eq(ref)
+    end
+  end
+
   describe '#equals' do
     it 'performs equals' do
       expect(client.query { equals(1, 1, 1) }).to be(true)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fauna
 version: !ruby/object:Gem::Version
-  version: 2.1.2
+  version: 2.2.0
 platform: ruby
 authors:
 - Fauna, Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-06 00:00:00.000000000 Z
+date: 2016-12-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -81,21 +81,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.38.0
 - !ruby/object:Gem::Dependency
-  name: coveralls
+  name: codecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.14
+        version: 0.1.5
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.14
+        version: 0.1.5
 description: Ruby driver for FaunaDB.
-email: priority@faunadb.com
+email: priority@fauna.com
 executables: []
 extensions: []
 extra_rdoc_files:
@@ -158,7 +158,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
 summary: FaunaDB Ruby driver