pl-puppetdb-ruby 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d0a1afa1ff2b6914268c1cc3872c03bc00ccf34e
+  data.tar.gz: f9293bb504fcb8aef8876db1887c269bdf2afae5
+SHA512:
+  metadata.gz: b5b66af95faddc9f0355c5e1ff0ef7a617cb32fb6ec883cbb3cfdf2701773ee65b374621ec7165a8a2f9c8f20cd736943c0b4ca009672c1bf3317cf0ecca6846
+  data.tar.gz: 8eb00096fad175271a91fd77552dbbb056ca8a0b3fe3c130aa21ba51b9e951d6942ee2f3e992291fece5608fd5cf279d4f3fbc2c7a34328c3260a9321360b851

data/CHANGELOG.md

@@ -0,0 +1,71 @@
+# Change log
+
+All notable changes to this project will be documented in this file.
+Each new release typically also includes the latest modulesync defaults.
+These should not impact the functionality of the module.
+
+## Unreleased
+
+**Implemented enhancements:**
+
+- Add AccessDeniedError, UnauthorizedError and ForbiddenError exceptions
+- Silence warnings about unspecified exception types in spec tests
+- Add support for Puppet Enterprise RBAC token authentication
+- Add support for loading configuration defaults from Puppet Enterprise Client Tools configuration files
+  <https://puppet.com/docs/pe/2018.1/installing_pe_client_tools.html#configuring-and-using-client-tools>
+
+## [v1.1.1](https://github.com/voxpupuli/puppetdb-ruby/tree/v1.1.1) (2017-08-17)
+[Full Changelog](https://github.com/voxpupuli/puppetdb-ruby/compare/1.1.0...v1.1.1)
+
+**Fixed bugs:**
+
+- Rubygem is broken for 1.1.0 [\#31](https://github.com/voxpupuli/puppetdb-ruby/issues/31)
+
+**Merged pull requests:**
+
+- Add badges [\#30](https://github.com/voxpupuli/puppetdb-ruby/pull/30) ([raphink](https://github.com/raphink))
+
+## [1.1.0](https://github.com/voxpupuli/puppetdb-ruby/tree/1.1.0) (2017-08-17)
+[Full Changelog](https://github.com/voxpupuli/puppetdb-ruby/compare/1.0.0...1.1.0)
+
+**Closed issues:**
+
+- Improve documentation  [\#22](https://github.com/voxpupuli/puppetdb-ruby/issues/22)
+- support for PQL in PuppetDB::Query [\#16](https://github.com/voxpupuli/puppetdb-ruby/issues/16)
+- Any plans to revive this project? [\#12](https://github.com/voxpupuli/puppetdb-ruby/issues/12)
+
+**Merged pull requests:**
+
+- Add PQL support [\#28](https://github.com/voxpupuli/puppetdb-ruby/pull/28) ([raphink](https://github.com/raphink))
+
+## [1.0.0](https://github.com/voxpupuli/puppetdb-ruby/tree/1.0.0) (2017-08-02)
+**Implemented enhancements:**
+
+- Preparatory cleanup for refactor [\#21](https://github.com/voxpupuli/puppetdb-ruby/pull/21) ([dhollinger](https://github.com/dhollinger))
+- Allow usage of unauthenticated PuppetDB over SSL [\#14](https://github.com/voxpupuli/puppetdb-ruby/pull/14) ([cassianoleal](https://github.com/cassianoleal))
+
+**Closed issues:**
+
+- Refactor to support v4 endpoints [\#20](https://github.com/voxpupuli/puppetdb-ruby/issues/20)
+- API V4 Example [\#13](https://github.com/voxpupuli/puppetdb-ruby/issues/13)
+- 'summarize-by' parameter not supported [\#9](https://github.com/voxpupuli/puppetdb-ruby/issues/9)
+- Thanks! [\#6](https://github.com/voxpupuli/puppetdb-ruby/issues/6)
+- Only GET requests supported [\#4](https://github.com/voxpupuli/puppetdb-ruby/issues/4)
+
+**Merged pull requests:**
+
+- rename gemspec to fix deploy [\#27](https://github.com/voxpupuli/puppetdb-ruby/pull/27) ([dhollinger](https://github.com/dhollinger))
+- Remove branches restriction in travis.yml [\#26](https://github.com/voxpupuli/puppetdb-ruby/pull/26) ([dhollinger](https://github.com/dhollinger))
+- Add rubygems deploy key [\#25](https://github.com/voxpupuli/puppetdb-ruby/pull/25) ([dhollinger](https://github.com/dhollinger))
+- Release 1.0.0 [\#24](https://github.com/voxpupuli/puppetdb-ruby/pull/24) ([dhollinger](https://github.com/dhollinger))
+- Update Docs for Release 1.0.0 [\#23](https://github.com/voxpupuli/puppetdb-ruby/pull/23) ([dhollinger](https://github.com/dhollinger))
+- Add command API support [\#19](https://github.com/voxpupuli/puppetdb-ruby/pull/19) ([bekbulatov](https://github.com/bekbulatov))
+- \(maint\) Transfer ownership to Vox Pupuli [\#18](https://github.com/voxpupuli/puppetdb-ruby/pull/18) ([rlinehan](https://github.com/rlinehan))
+- "Voxpupulify" [\#17](https://github.com/voxpupuli/puppetdb-ruby/pull/17) ([nibalizer](https://github.com/nibalizer))
+- Add Contributing Guidelines [\#7](https://github.com/voxpupuli/puppetdb-ruby/pull/7) ([rlinehan](https://github.com/rlinehan))
+- Feature/fix readme [\#3](https://github.com/voxpupuli/puppetdb-ruby/pull/3) ([robinbowes](https://github.com/robinbowes))
+- Update README with correct initialization of client [\#1](https://github.com/voxpupuli/puppetdb-ruby/pull/1) ([ccaum](https://github.com/ccaum))
+
+
+
+\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

data/LICENSE

@@ -0,0 +1,17 @@
+puppetdb-ruby
+
+Copyright (C) 2013 Puppet Labs Inc
+
+Puppet Labs can be contacted at: info@puppetlabs.com
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -0,0 +1,248 @@
+# puppetdb-ruby
+
+[![Build Status](https://img.shields.io/travis/voxpupuli/puppetdb-ruby.svg)](https://travis-ci.org/voxpupuli/puppetdb-ruby)
+[![Gem Version](https://img.shields.io/gem/v/puppetdb-ruby.svg)](https://rubygems.org/gems/puppetdb-ruby)
+[![Gem Downloads](https://img.shields.io/gem/dt/puppetdb-ruby.svg)](https://rubygems.org/gems/puppetdb-ruby)
+[![By VoxPupuli](https://img.shields.io/badge/voxpupuli-%F0%9F%90%B1-orange.svg)](https://voxpupuli.org/)
+
+a simple gem for interacting with the
+[PuppetDB](https://github.com/puppetlabs/puppetdb) API.
+
+This library was migrated from [puppetlabs](https://github.com/puppetlabs)
+ownership to VoxPupuli on 19 October 2016.
+
+## Installation
+
+Installing from Ruby CLI:
+```
+gem install puppetdb-ruby
+```
+
+Include in Gemfile:
+``` ruby
+gem 'puppetdb-ruby'
+```
+
+## Usage
+
+Require the puppetdb gem in your ruby code.
+
+```ruby
+require 'puppetdb'
+
+# Defaults to latest API version.
+```
+
+#### Create a new connection:
+
+Non-SSL:
+``` ruby
+client = PuppetDB::Client.new({:server => 'http://localhost:8080'})
+```
+
+SSL with cert-based authentication:
+``` ruby
+client = PuppetDB::Client.new({
+    server_urls: 'https://localhost:8081',
+    cacert: '/path/to/ca.pem'
+    cert: '/path/to/certfile.pem',
+    key: '/path/to/keyfile.pem'
+    })
+```
+
+SSL with PE RBAC token based authentication:
+``` ruby
+client = PuppetDB::Client.new({
+    :server_urls => "https://localhost:8081",
+    :token  => "my_pe_rbac_token",
+    :cacert => "/path/to/cacert.pem",
+    })
+```
+
+Configure connections to multiple PuppetDB's via `server_urls`
+``` ruby
+client = PuppetDB::Client.new({
+    :server_urls => "https://localhost:8081,https://localhost:8083",
+    :token  => "my_pe_rbac_token",
+    :cacert => "/path/to/cacert.pem",
+    })
+```
+
+SSL with PE RBAC token based authentication, using all settings from PE Client Tools configurations:
+``` ruby
+client = PuppetDB::Client.new()
+```
+
+Note: When using cert-based authentication you must specify the full pem structure. When using token based authentication
+you must NOT provide the pem structure and instead pass ':token' and ':cacert' (or allow them to be read from the
+PE Client Tools configuration).
+
+#### Query API usage
+
+The Query Feature allows the user to request data from PuppetDB using the Query endpoints. It defaults to the latest version of the Query Endpoint.
+
+Currently, `puppetdb-ruby` only supports the [AST Query Language](https://docs.puppet.com/puppetdb/5.0/api/query/v4/ast.html).
+
+Support for the [PQL Query Language](https://docs.puppet.com/puppetdb/5.0/api/query/tutorial-pql.html) is planned for a future release.
+
+Example:
+``` ruby
+response = client.request(
+  'nodes',
+  [:and,
+    [:'=', ['fact', 'kernel'], 'Linux'],
+    [:>, ['fact', 'uptime_days'], 30]
+  ],
+  {:limit => 10}
+)
+
+nodes = response.data
+
+# queries are composable
+
+uptime = PuppetDB::Query[:>, [:fact, 'uptime_days'], 30]
+redhat = PuppetDB::Query[:'=', [:fact, 'osfamily'], 'RedHat']
+debian = PuppetDB::Query[:'=', [:fact, 'osfamily'], 'Debian']
+
+client.request uptime.and(debian)
+client.request uptime.and(redhat)
+client.request uptime.and(debian.or(redhat))
+```
+
+If you have configured multiple PuppetDB's via [`server_urls`](https://puppet.com/docs/puppetdb/latest/pdb_client_tools.html#step-3-install-and-configure-the-puppetdb-cli)
+then you can query in `:failover` mode. This will query each PuppetDB in `server_urls`
+in order until it gets a successful response. It will fail with an `APIError` only if all queries fail.
+
+``` ruby
+response = client.request(
+  'nodes',
+  [:"=", "certname", "foo"],
+  {
+    :limit => 10
+    :query_mode => :failover
+  }
+)
+```
+
+See the [PuppetDB API Docs](https://docs.puppet.com/puppetdb/5.0/api/index.html) for more.
+
+
+#### PQL Queries usage
+
+PQL queries are supported by using the empty endpoint.
+
+Example:
+``` ruby
+response = client.request(
+  '',
+  'resources[title] { nodes { deactivated is null } }',
+  {:limit => 10}
+)
+
+resources = response.data
+```
+
+See the [PuppetDB API Docs](https://docs.puppet.com/puppetdb/5.0/api/query/v4/pql.html) for more on PQL queries.
+
+
+#### Command API Usage
+
+The Command Feature allows the user to execute REST Commands against the PuppetDB Command API Endpoints. It defaults to the latest version of the Command Endpoint.
+
+The command method takes three arguments:
+
+* `command`: a string identifying the command
+* `payload`: a valid JSON object of any sort. It’s up to an individual handler function to determine how to interpret that object.
+* `version`: a JSON integer describing what version of the given command you’re attempting to invoke. The version of the command also indicates the version of the wire format to use for the command.
+
+Example:
+``` ruby
+client.command(
+  'deactivate node',
+  {'certname' => 'test1', 'producer_timestamp' => '2015-01-01'},
+  3
+)
+```
+
+See the PuppetDB [Commands Endpoint Docs](https://docs.puppet.com/puppetdb/5.0/api/command/v1/commands.html) for more information.
+
+#### Query the status endpoint(s)
+
+You can get the status of all configured PuppetDB's by querying the `/status/v1/services` endpoints.
+``` ruby
+client.status
+
+# The result will be of the form (one entry per server)
+# {
+#   "http://localhost:8080": {
+#     "puppetdb-status": {
+#       "service_version": "6.3.1-SNAPSHOT",
+#       "service_status_version": 1,
+#       "detail_level": "info",
+#       "state": "running",
+#       "status": {
+#         "maintenance_mode?": false,
+#         "queue_depth": 0,
+#         "read_db_up?": true,
+#         "write_db_up?": true
+#       },
+#       "active_alerts": [
+#       ]
+#     },
+#     "status-service": {
+#       "service_version": "1.1.0",
+#       "service_status_version": 1,
+#       "detail_level": "info",
+#       "state": "running",
+#       "status": {
+#       },
+#       "active_alerts": [
+#       ]
+#     }
+#   }
+# }
+```
+
+#### Export an archive of PuppetDB
+
+You can [`export`](https://puppet.com/docs/puppetdb/5.1/anonymization.html#using-the-export-command) an archive
+of your PuppetDB to a file. Optionally you can override the `anonymization_profile` (default: none).
+
+``` ruby
+client.export('path/for/new_puppetdb_export.tar.gz', anonymization_profile: :high)
+```
+
+#### Import an archive into PuppetDB
+
+Once you have a PuppetDB export, it can be loaded into PuppetDB with [`import`](https://puppet.com/docs/puppetdb/5.1/anonymization.html#using-the-import-command).
+
+``` ruby
+client.import('path/to/existing_puppetdb_export.tar.gz')
+```
+
+## Tests
+
+```
+bundle install
+bundle exec rspec
+```
+
+## Issues & Contributions
+
+File issues or feature requests using [GitHub
+issues](https://github.com/voxpupuli/puppetdb-ruby/issues).
+
+If you are interested in contributing to this project, please see the
+[Contribution Guidelines](CONTRIBUTING.md)
+
+## Authors
+
+This module was donated to VoxPupuli by Puppet Inc on 10-19-2016.
+
+Nathaniel Smith <nathaniel@puppetlabs.com>
+Lindsey Smith <lindsey@puppetlabs.com>
+Ruth Linehan <ruth@puppetlabs.com>
+
+## License
+
+See LICENSE.

data/lib/puppetdb.rb

@@ -0,0 +1,8 @@
+require 'puppetdb/version'
+require 'puppetdb/client'
+require 'puppetdb/query'
+require 'puppetdb/response'
+require 'puppetdb/error'
+require 'puppetdb/config'
+
+module PuppetDB; end

data/lib/puppetdb/client.rb

@@ -0,0 +1,197 @@
+require 'httparty'
+require 'logger'
+
+require 'puppetdb/error'
+
+module PuppetDB
+  class FixSSLConnectionAdapter < HTTParty::ConnectionAdapter
+    def attach_ssl_certificates(http, options)
+      http.ca_file = options[:cacert]
+      http.cert    = OpenSSL::X509::Certificate.new(File.read(options[:cert])) if options[:cert]
+      http.key     = OpenSSL::PKey::RSA.new(File.read(options[:key])) if options[:key]
+
+      http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+    end
+  end
+
+  class Client
+    include HTTParty
+    attr_reader :use_ssl
+    attr_writer :logger
+
+    def hash_includes?(hash, *sought_keys)
+      sought_keys.each { |x| return false unless hash.include?(x) }
+      true
+    end
+
+    def debug(msg)
+      @logger.debug(msg) if @logger
+    end
+
+    def initialize(settings = {}, query_api_version = 4, command_api_version = 1, admin_api_version = 1)
+      config = Config.new(settings, load_files: true)
+      @query_api_version = query_api_version
+      @command_api_version = command_api_version
+      @admin_api_version = admin_api_version
+
+      @servers = config.server_urls
+      pem    = config.pem
+      token  = config.token
+      puts config.config
+      puts pem
+      puts token.nil?
+      puts @servers
+
+      @servers.each do |server|
+        scheme = URI.parse(server).scheme
+        @use_ssl ||= scheme == 'https'
+
+        unless %w[http https].include? scheme
+          error_msg = "Configuration error: server_url '#{server}' must specify a protocol of either http or https"
+          raise error_msg
+        end
+      end
+
+      return unless @use_ssl
+      unless hash_includes?(pem, :cacert, :cert, :key) || (pem[:cert].nil? && pem[:key].nil?)
+        error_msg = 'Configuration error: https:// specified, but configuration is incomplete. It requires cacert and either cert and key, or a valid token.'
+        raise error_msg
+      end
+
+      self.class.default_options = pem
+      self.class.headers('X-Authentication' => token) if token
+      self.class.connection_adapter(FixSSLConnectionAdapter)
+    end
+
+    def raise_if_error(response)
+      raise UnauthorizedError, response if response.code == 401
+      raise ForbiddenError, response if response.code == 403
+      raise APIError, response if response.code.to_s =~ %r{^[4|5]}
+    end
+
+    def request(endpoint, query, opts = {})
+      path = "/pdb/query/v#{@query_api_version}"
+      if endpoint == ''
+        # PQL
+        json_query = query
+      else
+        path += "/#{endpoint}"
+        query = PuppetDB::Query.maybe_promote(query)
+        json_query = query.build
+      end
+
+      query_mode = opts.delete(:query_mode) || :first
+      filtered_opts = { 'query' => json_query }
+      opts.each do |k, v|
+        if k == :counts_filter
+          filtered_opts['counts-filter'] = JSON.dump(v)
+        else
+          filtered_opts[k.to_s.sub('_', '-')] = v
+        end
+      end
+
+      debug("#{path} #{json_query} #{opts}")
+
+      if query_mode == :first
+        self.class.base_uri(@servers.first)
+        ret = self.class.get(path, body: filtered_opts)
+        raise_if_error(ret)
+
+        total = ret.headers['X-Records']
+        total = ret.parsed_response.length if total.nil?
+
+        Response.new(ret.parsed_response, total)
+      elsif query_mode == :failover
+
+        ret = nil
+        @servers.each do |server|
+          self.class.base_uri(server)
+          ret = self.class.get(path, body: filtered_opts)
+          if ret.code < 400
+            total = ret.headers['X-Records']
+            total = ret.parsed_response.length if total.nil?
+
+            return Response.new(ret.parsed_response, total)
+          else
+            debug("query on '#{server}' failed with #{ret.code}")
+          end
+        end
+        raise APIError, ret
+      else
+        raise ArgumentError, "Query mode '#{query_mode}' is not supported (try :first or :failover)."
+      end
+    end
+
+    def command(command, payload, version)
+      path = "/pdb/cmd/v#{@command_api_version}"
+
+      query = {
+        'command' => command,
+        'version' => version,
+        'certname' => payload['certname']
+      }
+
+      debug("#{path} #{query} #{payload}")
+
+      self.class.base_uri(@servers.first)
+      ret = self.class.post(
+        path,
+        query: query,
+        body: payload.to_json,
+        headers: {
+          'Accept'       => 'application/json',
+          'Content-Type' => 'application/json'
+        }
+      )
+      raise_if_error(ret)
+
+      Response.new(ret.parsed_response)
+    end
+
+    def export(filename, opts = {})
+      self.class.base_uri(@servers.first)
+      path = "/pdb/admin/v#{@admin_api_version}/archive"
+
+      # Allow opts to override anonymization_profile, but enforce
+      # stream_body to avoid using memory
+      params = { anonymization_profile: 'none' }.
+               merge(opts).
+               merge(stream_body: true)
+
+      File.open(filename, 'w') do |file|
+        self.class.get(path, params) do |fragment|
+          if [301, 302].include?(fragment.code)
+            debug 'Skip streaming write for redirect'
+          elsif fragment.code == 200
+            file.write(fragment)
+          else
+            raise StandardError, "Non-success status code while streaming #{fragment.code}"
+          end
+        end
+      end
+    end
+
+    def import(filename)
+      self.class.base_uri(@servers.first)
+      path = "/pdb/admin/v#{@admin_api_version}/archive"
+      self.class.post(path, body: { archive: File.open(filename) })
+    end
+
+    def status
+      status_endpoint = '/status/v1/services'
+      status_map = {}
+
+      @servers.each do |server|
+        self.class.base_uri(server)
+        ret = self.class.get(status_endpoint)
+
+        status_map[server] = if ret.code >= 400
+                               { error: "Unable to build JSON object from server: #{server}" }
+                             else
+                               ret.parsed_response
+                             end
+      end
+      status_map
+    end
+  end
+end

data/lib/puppetdb/config.rb

@@ -0,0 +1,87 @@
+require 'json'
+
+class PuppetDB::Config
+  def initialize(overrides = nil, load_files = false)
+    @overrides = {}
+    overrides.each { |k, v| @overrides[k.to_sym] = v } unless overrides.nil?
+
+    @load_files = load_files
+  end
+
+  def load_file(path)
+    File.open(path) { |f| JSON.parse(f.read, symbolize_names: true) }
+  end
+
+  def puppetlabs_root
+    '/etc/puppetlabs'
+  end
+
+  def global_conf
+    File.join(puppetlabs_root, 'client-tools', 'puppetdb.conf')
+  end
+
+  def user_root
+    File.join(Dir.home, '.puppetlabs')
+  end
+
+  def user_conf
+    File.join(user_root, 'client-tools', 'puppetdb.conf')
+  end
+
+  def default_cacert
+    "#{puppetlabs_root}/puppet/ssl/certs/ca.pem"
+  end
+
+  def defaults
+    {
+      cacert: default_cacert,
+      token_file: File.join(user_root, 'token')
+    }
+  end
+
+  def load_config
+    config = defaults
+    if @load_files
+      if File.exist?(global_conf) && File.readable?(global_conf)
+        config = config.merge(load_file(global_conf))
+      end
+
+      if @overrides[:config_file]
+        config = config.merge(load_file(@overrides[:config_file]))
+      elsif File.exist?(user_conf) && File.readable?(user_conf)
+        config = config.merge(load_file(user_conf))
+      end
+    end
+
+    config.merge(@overrides)
+  end
+
+  def config
+    @config ||= load_config
+  end
+
+  def load_token
+    if @config.include?(:token)
+      @config[:token]
+    elsif File.readable?(config[:token_file])
+      File.read(config[:token_file]).strip
+    end
+  end
+
+  def token
+    @token ||= load_token
+  end
+
+  def server_urls
+    return config[:server_urls].split(',') if config[:server_urls].is_a?(String)
+    config[:server_urls] || []
+  end
+
+  def pem
+    @config.select { |k, _| [:cacert, :cert, :key].include?(k) }
+  end
+
+  def [](key)
+    @config[key]
+  end
+end

data/lib/puppetdb/error.rb

@@ -0,0 +1,17 @@
+module PuppetDB
+  class APIError < RuntimeError
+    attr_reader :code, :response
+    def initialize(response)
+      @response = response
+    end
+  end
+
+  class AccessDeniedError < APIError
+  end
+
+  class ForbiddenError < AccessDeniedError
+  end
+
+  class UnauthorizedError < AccessDeniedError
+  end
+end

data/lib/puppetdb/query.rb

@@ -0,0 +1,58 @@
+require 'json'
+
+module PuppetDB
+  class Query
+    attr_reader :sexpr
+
+    def initialize(query = [])
+      @sexpr = query
+    end
+
+    def self.[](*args)
+      Query.new(args)
+    end
+
+    def self.maybe_promote(query)
+      return Query.new(query) unless query.class == Query
+      query
+    end
+
+    def empty?
+      @sexpr.empty?
+    end
+
+    def compose(query)
+      query = self.class.maybe_promote(query)
+
+      # If an operand is the empty query ([]), compose returns a copy
+      # of the non-empty operand. If both operands are empty, the
+      # empty query is returned. If both operands are non-empty, the
+      # compose continues.
+      if query.empty? && !empty?
+        Query.new(@sexpr)
+      elsif empty? && !query.empty?
+        Query.new(query.sexpr)
+      elsif empty? && query.empty?
+        Query.new([])
+      else
+        yield query
+      end
+    end
+
+    def and(query)
+      compose(query) { |q| Query.new([:and, @sexpr, q.sexpr]) }
+    end
+
+    def or(query)
+      compose(query) { |q| Query.new([:or, @sexpr, q.sexpr]) }
+    end
+
+    def push(query)
+      compose(query) { |q| Query.new(@sexpr.dup.push(q.sexpr)) }
+    end
+
+    def build
+      JSON.dump(@sexpr)
+    end
+  end
+end

data/lib/puppetdb/response.rb

@@ -0,0 +1,10 @@
+module PuppetDB
+  class Response
+    attr_reader :data, :total_records
+
+    def initialize(data, total_records = nil)
+      @data = data
+      @total_records = total_records
+    end
+  end
+end

data/lib/puppetdb/version.rb

@@ -0,0 +1,3 @@
+module PuppetDB
+  VERSION = '2.0.0'.freeze
+end

metadata

@@ -0,0 +1,154 @@
+--- !ruby/object:Gem::Specification
+name: pl-puppetdb-ruby
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Austin Blatt
+- Vox Pupuli
+- Nathaniel Smith
+- Lindsey Smith
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-04-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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: rspec
+  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: mocha
+  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
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.48.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.48.1
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.15.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.15.1
+- !ruby/object:Gem::Dependency
+  name: github_changelog_generator
+  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'
+description: 
+email: austin.blatt@puppet.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/puppetdb.rb
+- lib/puppetdb/client.rb
+- lib/puppetdb/config.rb
+- lib/puppetdb/error.rb
+- lib/puppetdb/query.rb
+- lib/puppetdb/response.rb
+- lib/puppetdb/version.rb
+homepage: https://github.com/austb/puppetdb-ruby
+licenses:
+- apache
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.14.1
+signing_key: 
+specification_version: 4
+summary: Simple Ruby client library for PuppetDB API
+test_files: []