acter 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 169bc9fba66570e92ebb5ee873a2abc1f750311bda5dc87c68d07ce88c695636
+  data.tar.gz: 200513d33f26c77d6bdbcb7551a242a700844ce058698df245f3383c7144eaa5
+SHA512:
+  metadata.gz: 7182c74161fec3f76f79f867fe81460dd1e952f702b8a58899724f34f199bbec8bc21c6b11f3dd393ab85e6277cebfddd22e55472564d2c48d48d3e3a904c3ef
+  data.tar.gz: 13dc24ce9f691c5b2cca7ebaa94ff1a6b3579ca456965a9c3c8e2db97ce949d852a5a352d992da60b4dfc223dcb4578581ed7f35fa70657c938f66ee6d07aeb6

data/.gitignore

@@ -0,0 +1,12 @@
+Gemfile.lock
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.5.3
+before_install: gem install bundler -v 1.16.1

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in acter.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2019 Smartling, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,63 @@
+# Acter
+
+Acter is a command line client for HTTP APIs described by a JSON schema (cf. https://json-schema.org).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'acter'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install acter
+
+## Usage
+
+    $ acter <subject> <action> <args...>
+
+Arguments may take the form `<param>=<value>` to set a request parameter, or `<Header>:<value>` to set an HTTP header for the request. As a special case, if the first argument does not contain `=` or `:`, it will be interpreted as `<subject>=<arg>`, i.e. the argument will be passed as a parameter named after the subject.
+
+Ensure that the JSON schema describing your API is in a file named `schema.json` or `schema.yml` in the current directory. If not, you will have to specify a path or URL using the `-s` option.
+
+To make acter your own, simply copy the executable or create a symlink with a new name.
+
+### Advanced Usage
+
+```ruby
+schema_data = Acter.load_schema_data(SCHEMA_PATH_OR_URL)
+begin
+  action = Acter::Action.new(ARGV, schema_data)
+rescue Acter::InvalidCommand => e
+  Acter.handle_invalid_command(e)
+  exit 1
+end
+result = action.send_request do |faraday_connection|
+  ##
+  ## apply middleware to connection or whatever
+  ##
+end
+puts result.render(render_options) do |faraday_response|
+  ##
+  ## return hash of conditional rendering options depending on the response,
+  ## action, phase of the moon, etc.
+  ##
+end
+exit 1 unless result.success?
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/syskill/acter.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/acter.gemspec

@@ -0,0 +1,33 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "acter/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "acter"
+  spec.version       = Acter::VERSION
+  spec.authors       = ["Ben Slusky"]
+  spec.email         = ["bslusky@smartling.com"]
+
+  spec.summary       = "Command line client for APIs described by JSON Schema"
+  spec.homepage      = "https://github.com/syskill/acter"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "faraday", "~> 0.14"
+  spec.add_dependency "faraday_middleware", "~> 0.12"
+  spec.add_dependency "multi_json", "~> 1.10"
+  spec.add_dependency "json_schema", "~> 0.16"
+  spec.add_dependency "rouge", "~> 1.11"
+  spec.add_dependency "term-ansicolor", "~> 1.6"
+  spec.add_dependency "activesupport"
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "acter"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/acter

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+
+require "acter"
+require "optparse"
+require "optparse/uri"
+require "pathname"
+
+schema_path = nil
+render_options = {}
+
+opt_parser = OptionParser.new do |opts|
+  opts.version = Acter::VERSION
+  opts.banner += "\n\nPerform HTTP requests defined by JSON schema\n\n"
+
+  opts.on("-sPATH", "--schema=PATH", URI, "Path to JSON schema") do |v|
+    schema_path = v.scheme ? v : Pathname.new(v.to_s)
+  end
+  opts.on("-H", "--[no-]show-headers", :OPTIONAL, TrueClass, "Output response headers (default: no)") do |v|
+    render_options[:show_headers] = v
+  end
+  opts.on("-b", "--[no-]show-body", :OPTIONAL, TrueClass, "Output response body (default: yes)") do |v|
+    render_options[:show_body] = v
+  end
+  opts.on("-c", "--[no-]color", :OPTIONAL, TrueClass, "Colorize output (default: only if output is a TTY)") do |v|
+    render_options[:color] = v
+  end
+  opts.on("-h", "--help", "Help for subject or action") do
+    Acter.help_wanted = true
+  end
+  opts.on("-V", "--version", "Version info") do
+    puts opts.ver
+    exit
+  end
+end
+
+begin
+  opt_parser.parse!
+rescue OptionParser::ParseError => e
+  puts e
+  puts opt_parser
+  exit 1
+end
+
+Acter.options_text = opt_parser.summarize
+Acter.run(ARGV, schema_path, render_options) or exit 1

data/lib/acter.rb

@@ -0,0 +1,77 @@
+require "acter/version"
+require "json_schema-cromulent_links"
+require "json_schema-example_parsing"
+require "multi_json"
+require "open-uri"
+require "pathname"
+require "yaml"
+
+module Acter
+  autoload :Action, "acter/action"
+  autoload :Error, "acter/error"
+  autoload :Help, "acter/help"
+  autoload :Request, "acter/request"
+  autoload :Response, "acter/response"
+  autoload :Result, "acter/result"
+
+  autoload :NoSchema, "acter/error"
+  autoload :InvalidSchema, "acter/error"
+  autoload :InvalidCommand, "acter/error"
+  autoload :InvalidSubject, "acter/error"
+  autoload :InvalidAction, "acter/error"
+  autoload :MissingParameters, "acter/error"
+  autoload :HelpWanted, "acter/error"
+
+  class << self
+    def load_schema_data(path = nil)
+      path ||= Pathname.glob("schema.{json,yml}").first or raise NoSchema
+      if path.is_a?(String)
+        uri = URI(path)
+        source = uri.scheme ? uri : Pathname.new(path)
+      elsif path.respond_to?(:read) && path.respond_to?(:to_s)
+        source = path
+      else
+        raise ArgumentError, "Argument to load_schema must be a String or a Pathname-like object"
+      end
+      if source.to_s =~ /\.ya?ml$/
+        YAML.load(source.read)
+      else
+        MultiJson.load(source.read)
+      end
+    end
+
+    def handle_invalid_command(exn)
+      puts exn
+      puts
+      help = Help.new(exn.schema)
+      case exn
+      when HelpWanted, MissingParameters
+        puts help.help_for_action(exn.action, exn.subject)
+      when InvalidAction
+        puts help.help_for_subject(exn.subject)
+      else
+        puts help.general_help
+      end
+    end
+
+    def run(args, schema_path = nil, render_options = nil)
+      schema_data = load_schema_data(schema_path)
+      action = Action.new(args, schema_data)
+      result = action.send_request
+      puts result.render(render_options)
+      result.success?
+    rescue InvalidCommand => e
+      handle_invalid_command(e)
+    rescue NoSchema
+      raise unless args.empty? || args == %w"help"
+      handle_invalid_command(InvalidCommand.new(nil))
+    end
+
+    def program_name
+      @program_name ||= File.basename($0, ".rb")
+    end
+
+    attr_accessor :help_wanted, :options_text
+    alias help_wanted? help_wanted
+  end
+end

data/lib/acter/action.rb

@@ -0,0 +1,104 @@
+require "acter/result"
+require "active_support/core_ext/object/try"
+require "active_support/core_ext/string/inflections"
+require "cgi"
+require "json_schema"
+require "multi_json"
+
+module Acter
+  class Action
+    def initialize(args, schema_data)
+      @subject, @name = args.shift(2)
+
+      @params = {}
+      @headers = {}
+      args.each_with_index do |arg, idx|
+        case
+        when /^(?<key>[^:=]+):(?<value>.*)/ =~ arg
+          warn "Value of header #{key.inspect} is empty" if value.empty?
+          @headers[key] = value
+        when /^(?<key>[^:=]+)=(?<value>.*)/ =~ arg
+          @params[key] = try_json_value(value)
+        when idx.zero?
+          @params[@subject] = try_json_value(arg)
+        else
+          raise ArgumentError, arg.inspect
+        end
+      end
+
+      @schema, errors = JsonSchema.parse(schema_data)
+      @schema or raise InvalidSchema.new("JSON schema parsing failed", errors)
+      result, errors = @schema.expand_references
+      result or raise InvalidSchema.new("JSON schema reference expansion failed", errors)
+
+      @base_url = @schema.links.find do |li|
+        li.href && li.rel == "self"
+      end.try(:href)
+      @base_url or raise InvalidSchema, "Schema has no valid link to self"
+
+      validate_link!
+      if Acter.help_wanted?
+        raise HelpWanted.new(@name, @subject, @schema)
+      end
+      validate_params!
+    end
+
+    attr_reader :name, :subject, :params, :headers, :schema,
+      :base_url, :link, :path
+
+    def send_request(&block)
+      req = Request.new(link.method, base_url, path, params, headers)
+      req.client(&block)
+      Result.new(req.send)
+    end
+
+  private
+
+    def try_json_value(str)
+      begin
+        MultiJson.load(%<{"_":#{str}}>)['_']
+      rescue MultiJson::ParseError
+        str
+      end
+    end
+
+    def validate_link!
+      schema.properties.key?(subject) or raise InvalidSubject.new(subject, schema)
+      @link = schema.properties[subject].cromulent_links.find {|li| li.title.underscore == name }
+      @link or raise InvalidAction.new(name, subject, schema)
+      @link
+    end
+
+    def validate_params!
+      missing_params = []
+      path_keys = link.href.scan(/\{\(([^)]+)\)\}/).map do |m|
+        path_param_base_name(m.first)
+      end
+      path_keys.uniq! and raise InvalidSchema, "Link #{link.pointer.inspect} has multiple path parameters with same base name"
+      path_params = path_keys.each_with_object({}) do |k, hsh|
+        if params.key?(k)
+          hsh[k.to_sym] = params.delete(k)
+        else
+          missing_params << k
+        end
+      end
+      if link.schema && link.schema.properties
+        unless (path_keys & link.schema.properties.keys).empty?
+          raise InvalidSchema, "Path parameter base names and property names of link #{link.pointer.inspect} are not unique"
+        end
+        if link.schema.required
+          missing_params.concat(link.schema.required - params.keys)
+        end
+      end
+      missing_params.empty? or raise MissingParameters.new(missing_params, name, subject, schema)
+      @path = link.href.gsub(/\{\(([^)]+)\)\}/) do
+        "%{#{path_param_base_name($1)}}"
+      end % path_params
+      @params
+    end
+
+    def path_param_base_name(str)
+      CGI.unescape(str).split("/").last
+    end
+  end
+end

data/lib/acter/error.rb

@@ -0,0 +1,91 @@
+module Acter
+  class Error < StandardError
+  end
+
+  class NoSchema < Error
+    def to_s
+      "Schema not found"
+    end
+  end
+
+  class InvalidSchema < Error
+    def initialize(message, errors = nil)
+      @message = message
+      @errors = Array(errors)
+    end
+    attr_reader :message
+    def to_s
+      @errors.dup.unshift(@message).join("\n\t")
+    end
+  end
+
+  class InvalidCommand < Error
+    def initialize(schema, subject = nil, action = nil, params = nil)
+      @schema = schema
+      @subject = subject
+      @action = action
+      @params = params
+    end
+    attr_reader :schema, :subject, :action, :params
+    def to_s
+      if @schema.nil?
+        "Command-line help"
+      else
+        "Invalid command"
+      end
+    end
+  end
+
+  class InvalidSubject < InvalidCommand
+    def initialize(subject, schema)
+      super(schema, subject)
+    end
+    def message
+      "Invalid subject"
+    end
+    def to_s
+      if @subject.nil? || @subject == "help"
+        "Command-line help"
+      else
+        "#{message}: #{@subject.inspect}"
+      end
+    end
+  end
+
+  class InvalidAction < InvalidCommand
+    def initialize(action, subject, schema)
+      super(schema, subject, action)
+    end
+    def message
+      "No valid link for action"
+    end
+    def to_s
+      if @action.nil? || @action == "help"
+        "Command-line help"
+      else
+        "#{message}: #{@subject.inspect} -> #{@action.inspect}"
+      end
+    end
+  end
+
+  class MissingParameters < InvalidCommand
+    def initialize(params, action, subject, schema)
+      super(schema, subject, action, params)
+    end
+    def message
+      "Missing required parameters"
+    end
+    def to_s
+      "#{message}: #{@params.map(&:inspect).join(", ")}"
+    end
+  end
+
+  class HelpWanted < InvalidCommand
+    def initialize(action, subject, schema)
+      super(schema, subject, action)
+    end
+    def to_s
+      "Command-line help"
+    end
+  end
+end

data/lib/acter/help.rb

@@ -0,0 +1,113 @@
+require "active_support/core_ext/string/inflections"
+require "cgi"
+require "json_schema"
+require "multi_json"
+require "stringio"
+
+module Acter
+  class Help
+    def initialize(schema)
+      @schema = schema
+    end
+
+    def general_help
+      StringIO.open do |s|
+        s.puts "USAGE:  #{Acter.program_name}#{Acter.options_text ? " [options]" : ""} <subject> <action> <params...>"
+        s.puts Acter.options_text if Acter.options_text
+        if @schema
+          s.puts
+          s.puts "Perform #{@schema.description} requests defined by JSON schema"
+          s.puts
+          s.puts "Valid subjects:"
+          @schema.properties.keys.sort.each do |subj|
+            s.puts "   #{subj}"
+          end
+        end
+        s.string
+      end
+    end
+
+    def help_for_subject(subject)
+      prop_schema = @schema.properties[subject]
+      StringIO.open do |s|
+        s.puts "USAGE:  #{Acter.program_name}#{Acter.options_text ? " [options]" : ""} #{subject} <action> <params...>"
+        s.puts Acter.options_text if Acter.options_text
+        s.puts
+        s.puts "Perform #{@schema.description} #{prop_schema.description} requests defined by JSON schema"
+        s.puts
+        s.puts "Valid actions:"
+        prop_schema.cromulent_links.each do |li|
+          s.puts "   #{example_command(li)}"
+          s.puts "      #{li.description}"
+        end
+        s.string
+      end
+    end
+
+    def help_for_action(action, subject)
+      link = @schema.properties[subject].cromulent_links.find {|li| li.title.underscore == action }
+      StringIO.open do |s|
+        s.puts "USAGE:  #{Acter.program_name}#{Acter.options_text ? " [options]" : ""} #{subject} #{example_command(link)}"
+        s.puts Acter.options_text if Acter.options_text
+        s.puts
+        s.puts link.description
+
+        if link.schema && link.schema.properties
+          s.puts
+          s.puts "Parameters:"
+          link.schema.properties.each do |name, prop_schema|
+            next if prop_schema.read_only?
+            descr = nil
+            if !prop_schema.default.nil?
+              descr = "default #{prop_schema.default.inspect}"
+            elsif !(ex = prop_schema.make_example).nil?
+              descr = "e.g. #{ex.inspect}"
+            elsif !prop_schema.enum.nil?
+              descr = prop_schema.enum.map(&:inspect).join(", ")
+            elsif !prop_schema.type.empty?
+              descr = prop_schema.type.map(&:capitalize).join("|")
+            end
+            descr = [descr, prop_schema.description].compact.join(" - ")
+            required = link.schema.required && link.schema.required.include?(name) ? " (REQUIRED)" : ""
+            s.puts "   #{name}#{required} : #{descr}"
+          end
+        end
+        s.string
+      end
+    end
+
+  private
+
+    def metasyntactic(property, subject = nil)
+      unless property.any_of.empty?
+        property.any_of.map(&method(:metasyntactic)).join("_or_")
+      else
+        path = property.reference ? property.reference.pointer : property.pointer
+        ###pc = path.split("/")
+        ###"#{pc[-3]}_#{pc[-1]}"
+        path.split("/").last
+      end
+    end
+
+    def example_command(link)
+      subject = link.pointer.split("/")[-3]
+      args = []
+      link.href.scan(/\{\(([^)]+)\)\}/).each do |m|
+        path = CGI.unescape(m.first)
+        basename = path.split("/").last
+        property = JsonPointer.evaluate(@schema, path) or
+          raise InvalidSchema, "Link #{link.pointer.inspect} has invalid path parameter #{path.inspect}"
+        meta = metasyntactic(property)
+        if basename == subject
+          args.unshift("[#{basename}=]<#{meta}>")
+        else
+          args << "#{basename}=<#{meta}>"
+        end
+      end
+      if link.schema && link.schema.properties
+        args << "<params...>"
+      end
+      args.unshift(link.title.underscore).join(" ")
+    end
+  end
+end

data/lib/acter/request.rb

@@ -0,0 +1,34 @@
+require "acter/response"
+require "faraday"
+require "faraday_middleware"
+
+module Acter
+  class Request
+    def initialize(method, base_url, path, params = nil, headers = nil)
+      @method = method.is_a?(Symbol) ? method : method.to_s.downcase
+      @base_url = base_url
+      @path = path
+      @params = Hash(params)
+      @headers = Hash(headers)
+    end
+
+    def client
+      unless @client && !block_given?
+        @client = Faraday.new(
+          url: @base_url,
+          headers: {'Accept' => "application/json"},
+        ) do |faraday|
+          faraday.request :json
+          yield faraday if block_given?
+          faraday.response :json, content_type: /\bjson(?:;|$)/
+          faraday.adapter Faraday.default_adapter
+        end
+      end
+      @client
+    end
+
+    def send
+      Response.new_from_faraday(client.send(@method, @path, @params, @headers))
+    end
+  end
+end

data/lib/acter/response.rb

@@ -0,0 +1,30 @@
+require "multi_json"
+
+module Acter
+  class Response
+    def initialize(status, headers, body)
+      @status = status
+      @success = (200..299).include?(status[/\d+/])
+      @headers = headers.sort.map {|a| a.join(": ") }
+      @body = case body
+        when String
+          @body_is_json = false
+          body
+        else
+          @body_is_json = true
+          MultiJson.dump(body, pretty: true)
+        end
+    end
+
+    def self.new_from_faraday(faraday_response)
+      status_string = "#{faraday_response.status} #{faraday_response.reason_phrase}"
+      new(status_string, faraday_response.headers, faraday_response.body)
+    end
+
+    attr_reader :status, :success, :headers, :body, :body_is_json
+    alias_method :success?, :success
+    alias_method :body_is_json?, :body_is_json
+    remove_method :success
+    remove_method :body_is_json
+  end
+end

data/lib/acter/result.rb

@@ -0,0 +1,55 @@
+require "forwardable"
+require "rouge"
+require "stringio"
+require "term/ansicolor"
+
+module Acter
+  class Result
+    extend Forwardable
+
+    DEFAULT_RENDER_OPTIONS = {
+      show_body: true,
+      show_headers: false,
+      color: :tty?,
+      theme: "monokai",
+    }
+
+    def initialize(response)
+      @response = response
+    end
+
+    attr_reader :response
+    def_delegator :@response, :success?
+
+    def render(options = nil)
+      options = DEFAULT_RENDER_OPTIONS.merge(Hash(options))
+      if block_given?
+        more_options = yield response
+        options.merge!(Hash(more_options))
+      end
+
+      colorize = options[:color] && (options[:color] != :tty? || $>.tty?)
+
+      StringIO.open do |s|
+        if colorize
+          s.puts Term::ANSIColor.bold(response.status)
+        else
+          s.puts response.status
+        end
+        if options[:show_headers]
+          response.headers.each(&s.method(:puts))
+        end
+        if options[:show_body]
+          s.puts
+          if colorize
+            lexer = response.body_is_json? ? Rouge::Lexers::JSON : Rouge::Lexers::HTML
+            s.puts Rouge::Formatters::Terminal256.format(lexer.new.lex(response.body), theme: options[:theme])
+          else
+            s.puts response.body
+          end
+        end
+        s.string
+      end
+    end
+  end
+end

data/lib/acter/version.rb

@@ -0,0 +1,3 @@
+module Acter
+  VERSION = "0.1.0"
+end

data/lib/json_schema-cromulent_links.rb

@@ -0,0 +1,16 @@
+require 'json_schema'
+require 'json_schema/schema'
+
+module JsonSchema
+  class Schema
+    def cromulent_links
+      links.select(&:cromulent?)
+    end
+
+    class Link
+      def cromulent?
+        href && method && title
+      end
+    end
+  end
+end

data/lib/json_schema-example_parsing.rb

@@ -0,0 +1,37 @@
+require 'json_schema'
+require 'json_schema/parser'
+require 'json_schema/schema'
+
+module JsonSchema
+  module ExampleParsing
+    def parse_schema(data, parent, fragment)
+      schema = super(data, parent, fragment)
+      schema.example = schema.data['example']
+      schema
+    end
+  end
+
+  class Parser
+    prepend ExampleParsing
+  end
+
+  class Schema
+    attr_schema :example
+
+    def make_example
+      if example
+        return example
+      end
+      if items
+        ex = items.make_example and return Array(ex)
+      end
+      unless any_of.empty?
+        any_of.each {|s| ex = s.make_example and return ex }
+      end
+      unless all_of.empty?
+        any_of.each {|s| ex = s.make_example and return ex }
+      end
+      nil
+    end
+  end
+end

metadata

@@ -0,0 +1,206 @@
+--- !ruby/object:Gem::Specification
+name: acter
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ben Slusky
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-05-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: json_schema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+- !ruby/object:Gem::Dependency
+  name: rouge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: term-ansicolor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  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: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- bslusky@smartling.com
+executables:
+- acter
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- acter.gemspec
+- bin/console
+- bin/setup
+- exe/acter
+- lib/acter.rb
+- lib/acter/action.rb
+- lib/acter/error.rb
+- lib/acter/help.rb
+- lib/acter/request.rb
+- lib/acter/response.rb
+- lib/acter/result.rb
+- lib/acter/version.rb
+- lib/json_schema-cromulent_links.rb
+- lib/json_schema-example_parsing.rb
+homepage: https://github.com/syskill/acter
+licenses:
+- MIT
+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.7.6
+signing_key: 
+specification_version: 4
+summary: Command line client for APIs described by JSON Schema
+test_files: []