gutsy 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: da3a90cbf88bebcc6de078248e83b515338e5be3
+  data.tar.gz: d9fdb9b74896ff504fe4e45f529fda7ee97f3a8c
+SHA512:
+  metadata.gz: 3386699eea4d6be07d403c3fedee8efdc5024bf369e3a926af9d7a111aa02bb5ba87e72d686580258656067e8081513aa7167508d1aa8680eaa74536a7bb00fd
+  data.tar.gz: 036a6f184c812021f132f8519fb03b362c7ede9a747022e5e808e5938efca651d4cc3c2d394b2a1c874c535336342cfe0adb68c9090ed3ac7727f71456935184

data/.gitignore

@@ -0,0 +1,4 @@
+*.log
+output/*
+*.gem
+

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

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

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at max.fierke@iorahealth.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in example_app_client.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,62 @@
+PATH
+  remote: .
+  specs:
+    gutsy (0.1.0)
+      activesupport (>= 3.2)
+      heroics (~> 0.0.17)
+      json_schema (~> 0.13)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (4.1.11)
+      i18n (~> 0.6, >= 0.6.9)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.1)
+      tzinfo (~> 1.1)
+    diff-lcs (1.2.5)
+    erubis (2.7.0)
+    excon (0.51.0)
+    heroics (0.0.17)
+      erubis (~> 2.0)
+      excon
+      moneta
+      multi_json (>= 1.9.2)
+      netrc
+    i18n (0.7.0)
+    json (1.8.3)
+    json_schema (0.13.0)
+    minitest (5.8.3)
+    moneta (0.8.0)
+    multi_json (1.12.1)
+    netrc (0.11.0)
+    rake (10.5.0)
+    rspec (3.5.0)
+      rspec-core (~> 3.5.0)
+      rspec-expectations (~> 3.5.0)
+      rspec-mocks (~> 3.5.0)
+    rspec-core (3.5.2)
+      rspec-support (~> 3.5.0)
+    rspec-expectations (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-mocks (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-support (3.5.0)
+    thread_safe (0.3.5)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.12)
+  gutsy!
+  rake (~> 10.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   1.12.5

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Iora Health
+
+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,56 @@
+# Gutsy
+
+<center>
+<pre>
+                                                                                
+                                                      ╓▄╖,                      
+       ,▄▓▓▒░░     ╓▄▓▓█▓▄µ ╓▄▄▄▒▄╗╦,              ╓▓▓▓▓▒░║▓                    
+      ╟▓▓▓▓▄▄▄▌   ▓█▓▓▓▓▄╙▓╦ ╚▓▓▓▓▓█▒▒▒░~         ▐▓▓▓▓▓▓▓▓▓                    
+      ╟▓▓▓▓██▓Å▒ ▐▓▓▓▓╣▓▓▌▐█▒▒▓█░╬░░░-⌐  `.        ▓▓▓▓▓▓▓▓▓                    
+       ▀Φ▓▓▓▓▓Θ ▓▓▓▓▓▓▓▓▓▒╬▓▓▓▌δ░░░░"░      W,▓▓▓Θ `█▓▒▓▓▓▀▀                    
+         └▓▀▓  ╣▓▓▓▓▓▓▓▓▓▓▓▓▀▓▄╬░           └Γ▀▓▓█▄    ▓Γ                       
+           ▓ ▓▓▓▓▓▓▓▓▓▓▓▄▓▓▓▀▓▓▌▌            └▌╙▓▓▓▄  ▓▀                        
+           ╙▓▄▓▓▓▓▓▓▓▓▓▀▓▓▓▓▓▌╬▒                ^▓▓▓▄▓█                         
+            ▓▓ █  ╠▓▓▓▌▓▓▓▓▓▓▓▌Ü                  ▀▓▓▓                          
+                   █▓▓▒▓▓▓▓▓▓▓╣Ö`^```        ,      Γ                           
+                    █▓▓▓▓▓▓▓▓▌▓δ^^^^` ░░.  ,,                                   
+                     ╙▓▓▓▓▓▓▓▓▓▓▌▒▒▒▄░╣▄▄▒▒▒`                                   
+                     ,▓▓▓▓▓▓▓██▓▓▓▓▓▓▓▓▓▓▓▓▌░╤                                  
+       ▄ ,▄         ▄▓▓▓▓▓▓▓▓╣╬δ▒▓▓▓▄▓▓▓▓▓▓▓▓╦                                  
+    ╚╣▓▓▓▓▄       ╒▓▓▓▓▓▓▓▓▓▓Ñ░-▓▓▓▓▓▒   ▀█▓▓▓▓▌▄                               
+       ▀▀▓▓▓▓▌    ╙▓▓▓▓▓▀╒▓▓╡  ╫▓▒╫▓▓Θ      ▀▓▓▓▓▓╛              ▄▄▄▄▄▓▓▓▓      
+          ▀▓▓▓▌   ╙▀╫▓▄▄╦▓▓▓▒╦╥▓▓╣▓▓▓▒       ,▄▓▓▓y         ▄▓▓▄▓▓█▀ΓΓ▀ΓΓ.      
+           ▓▓▓▌    ▄▓▓▓▓▓▓▓▓▓▓▒▓▓╠╫▓▌░     ╔▓▓▓▓▌▄         ▓▓▓▓▓▓█              
+            ▓▌▌     █▓▓▓▓▓▓▓▓▓▓▓▓▒▓▓▀`   ╓▓▓▓▓▓▌δ         ╙▓▓▓▓▀                
+             ▓─      ▀▓▓▓▓▓▓▓▓▓▓▓▓▓▌   ,▓▓▓▓▓▓▒            ▐▓▓█                 
+             ▓        ╙▓▓▓▓▓▓█╢▓▓▓▓▓▌ ▓▓▓▓▓▓▀`             ▓▌                   
+             ▌δ         █▓▓▓▌░ ╙▓▓▀▀╘▓▓▓▓▓▓`              ╒▓▌                   
+            ▐▓ ▌╓p╦▄▄▄▄,▓▓▓▓▓▌╦░▓█    ▓▓▓▓Σ               ▌▓µ                   
+            ▓▌▄▓▓▓▄╠▓╣▌▄▓▓▓▓▓▓▓Θ╫▌    ^▓▓▓▌╕             ╬ ▓                    
+             ▀▀▓▓▓▓▓▄▌δ▓▓▓▓█▓▓Θ⌐╟▌      ▓▓▓▌░           ╒Γ▐▓∩                   
+                .▀█▓▓▓▄▓▓▓█ ▓▓░ ▒⌐       ▓▓▓▌╗▄╗╗QQQQ▒▒▓▌▓▓▌                    
+                     Γ▓▓▒`  ▓▓░⌐▓         █▓▓▓▓▓▓▓▓███▀▀▀▀▀                     
+                       ▓▌   ▓▓▌╦█          ╙▀                                   
+                       ╫Σ  ƒ▓ΘΓ▓▄                                               
+                       ╫▒ ▄█░░4                                                 
+                       ▐▌╫▓░▄╝                                                  
+                       ▐▓▓▓▓▀                                                   
+                       ▐▓▌▌                                                     
+                        ^▀Γ    
+</pre>
+</center>
+
+Gutsy generates RubyGem wrappers and documentation for [heroics](https://github.com/interagent/heroics)-generated API clients from JSON schema. It's the Ruby side of the coin to [`braise`](https://github.com/IoraHealth/braise).
+
+## Usage
+
+```bash
+$ gem install gutsy
+$ gutsy generate AppName /path/to/schema.json /path/for/output/
+```
+
+Check out your generated API gem! You'll probably want to edit the `gemspec`, `README.md`, and `LICENSE.txt` to better fit your needs.
+
+## License
+
+See [LICENSE.txt](LICENSE.txt)

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "gutsy"
+
+# 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

data/bin/gutsy

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "gutsy"
+
+Gutsy.initialize!

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/gutsy.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gutsy/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "gutsy"
+  spec.version       = Gutsy::VERSION
+  spec.authors       = ["Iora Health"]
+  spec.email         = ["rubygems@iorahealth.com"]
+
+  spec.summary       = "Generates heroics-powered API client gem wrappers from JSON Schema"
+  spec.description   = spec.summary
+  spec.homepage      = "https://github.com/IoraHealth/gutsy"
+  spec.license       = "MIT"
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.require_paths = ["lib"]
+
+  spec.executables << 'gutsy'
+
+  spec.add_runtime_dependency "heroics", "~> 0.0.17"
+  spec.add_runtime_dependency "json_schema", "~> 0.13"
+  spec.add_runtime_dependency "activesupport", ">= 3.2"
+
+  spec.add_development_dependency "bundler", "~> 1.12"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/lib/gutsy/cli.rb

@@ -0,0 +1,7 @@
+module Gutsy
+  module Cli
+    # Perhaps one day there will be code here
+  end
+end
+
+require 'gutsy/generator'

data/lib/gutsy/generator.rb

@@ -0,0 +1,202 @@
+module Gutsy
+  module Cli
+    class Generator
+      extend Forwardable
+
+      class State
+        attr_reader :app_name
+        attr_accessor :resources
+
+        def initialize(app_name, resources=[])
+          @app_name = app_name
+          @resources = resources
+        end
+
+        def gem_name
+          @gem_name_snake ||= "#{app_name.underscore}_client"
+        end
+
+        def gem_name_snake
+          gem_name
+        end
+
+        def gem_name_pascal
+          @gem_name_pascal ||= gem_name.camelize(:upper)
+        end
+
+        def copyright_year
+          @copyright_year ||= Time.now.year
+        end
+
+        def copyright_owner
+          @copyright_owner ||= "YOUR_NAME_HERE"
+        end
+
+        def twine
+          binding
+        end
+      end
+
+      class ResourceState
+        attr_reader :resource_name, :gem_name_pascal
+
+        def initialize(resource_name, gem_name_pascal)
+          @resource_name = resource_name
+          @gem_name_pascal = gem_name_pascal
+        end
+
+        def twine
+          binding
+        end
+      end
+
+      attr_reader :app_name
+
+      def initialize(app_name, schema_path, output_path)
+        @state = State.new(app_name)
+        @schema_path = schema_path
+        @output_path = output_path
+      end
+
+      def generate!
+        create_output_dir
+
+        schema = load_and_validate_schema!
+
+        state.resources = map_schema_to_resources(schema)
+
+        scaffold_gem
+
+        generate_heroics_client
+
+        puts "Generated client gem can be found in... #{output_path}"
+      end
+
+      private
+
+      attr_reader :state, :schema_path, :output_path
+      attr_accessor :schema
+      def_delegators :state, :app_name, :gem_name_snake, :gem_name_pascal
+
+      def create_output_dir
+        print "Creating #{output_path}..."
+        Dir.mkdir(output_path, 0755) unless Dir.exist?(output_path)
+        puts "OK"
+      end
+
+      def load_and_validate_schema!
+        print "Validating schema against draft-04 JSON Schema..."
+        draft04_uri = URI.parse("http://json-schema.org/draft-04/hyper-schema")
+        draft04 = JsonSchema.parse!(JSON.parse(draft04_uri.read))
+
+        schema_json = JSON.parse(File.read(schema_path))
+
+        schema = JsonSchema.parse!(schema_json)
+        schema.expand_references!
+
+        draft04.validate!(schema)
+        puts "OK"
+
+        schema
+      end
+
+      def map_schema_to_resources(schema)
+        resources = Hash[schema.definitions.map do |key, resource|
+          links = Hash[resource.links.map do |link|
+            link.schema.expand_references! if link.schema
+            properties = link.schema.try(:properties) || {}
+            [link.title.downcase.to_sym, OpenStruct.new(properties: properties)]
+          end]
+          [key.to_sym, OpenStruct.new(title: key.camelize, links: links)]
+        end]
+        resources
+      end
+
+      def scaffold_gem
+        print "Creating gem directory structure..."
+        template_dirs.each do |dir|
+          dir = dir.gsub('app_client', gem_name_snake)
+          dir_path = File.join(output_path, dir)
+          Dir.mkdir(dir_path, 0755) unless Dir.exist?(dir_path)
+        end
+        puts "OK"
+
+        [
+          ".gitignore",
+          "Gemfile",
+          "LICENSE.txt",
+          "Rakefile",
+          "README.md",
+        ].each do |file|
+          copy_file file
+        end
+
+        copy_file "app_client.gemspec",
+                  as: "#{gem_name_snake}.gemspec"
+
+        copy_file "lib/app_client.rb",
+                  as: "lib/#{gem_name_snake}.rb"
+
+        [
+          "version.rb",
+          "v1/adapter.rb"
+        ].each do |file|
+          copy_file "lib/app_client/#{file}",
+                    as: "lib/#{gem_name_snake}/#{file}"
+        end
+
+        state.resources.each do |key, resource|
+          copy_file "lib/app_client/v1/resource.rb",
+                    as: "lib/#{gem_name_snake}/v1/#{key.to_s.underscore}.rb",
+                    binding: ResourceState.new(key.to_s, gem_name_pascal).twine
+        end
+      end
+
+      def generate_heroics_client
+        print "Generating Heroics client for JSON Schema..."
+        unless system "heroics-generate \
+          #{gem_name_pascal}::V1::Adapters::Http \
+          #{schema_path} \
+          http://#{app_name.downcase}/api/v1 > \
+          #{output_path}/lib/#{gem_name_snake}/v1/adapters/http.rb"
+          puts "FAIL"
+          puts "Please see stacktrace or heroics errors"
+        end
+        puts "OK"
+      end
+
+      # Derived from Methadone::Cli (https://github.com/davetron5000/methadone/blob/935444f9deb81100a33ec3234effbeb65acbc080/lib/methadone/cli.rb)
+      def copy_file(relative_path,options = {})
+        relative_path = File.join(relative_path.split(/\//))
+
+        template_path = File.join(template_dir, "#{relative_path}.erb")
+        template = ERB.new(File.read(template_path), nil, '-')
+
+        output_relative_path ||= options[:as] || relative_path
+
+        file_output_path = File.join(output_path, output_relative_path)
+
+        print "Copying #{file_output_path}..."
+
+        erb_binding = options[:binding] || state.twine
+
+        File.open(file_output_path, 'w') do |file|
+          file.puts template.result(erb_binding)
+          file.chmod(0755) if options[:executable]
+        end
+
+        print "OK\n"
+      end
+
+      def template_dir
+        @template_dir ||= File.join(File.dirname(__FILE__), '..', '..', 'templates', 'app_client')
+      end
+
+      def template_dirs
+        Dir["#{template_dir}/**/*"].
+          select { |x| File.directory? x }.
+          map { |dir| dir.gsub(/^#{template_dir}\//,'') }
+      end
+    end
+  end
+end

data/lib/gutsy/version.rb

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

data/lib/gutsy.rb

@@ -0,0 +1,72 @@
+require 'active_support'
+require 'active_support/core_ext/object/try'
+require 'active_support/core_ext/string/inflections'
+require 'erb'
+require 'json_schema'
+require 'open-uri'
+require 'gutsy/version'
+require 'gutsy/cli'
+
+module Gutsy
+  def self.initialize!
+    args = ARGV
+
+    command = args[0]
+
+    case command
+    when "generate"
+      unless args.length == 4
+        puts <<-TEXT
+Error: Not enough arguments for command 'generate'
+
+Usage: gutsy generate [app_name] [schema_path] [output_path]
+
+DESCRIPTION
+    Generates a gem scaffold and resource API clients on top of a heroics-generated client.
+
+ARGUMENTS
+    [app_name]    - CamelCased name of your application
+    [schema_path] - Path to your JSON Schema file
+    [output_path] - Path to output generated API client gem.
+                    (Will be created if it doesn't exist)
+TEXT
+        exit 1
+      end
+      app_name = args[1]
+      schema_path = File.expand_path(args[2])
+      output_path = File.expand_path(args[3])
+
+      generator = Gutsy::Cli::Generator.new(app_name, schema_path, output_path)
+
+      begin
+        generator.generate!
+      rescue => e
+        puts "FAIL"
+        puts e.message
+        puts e.backtrace.join("\n")
+        exit 1
+      end
+
+      exit 0
+    when "version"
+      puts "Gutsy version #{Gutsy::VERSION}"
+      exit 0
+    else
+      puts <<-TEXT
+Usage: gutsy [command] [options]
+
+DESCRIPTION
+    Generates gem wrappers around heroics-generated API clients
+    built with JSON Schema. (Enough layers of generation for ya?)
+
+COMMANDS
+    generate      scaffolds out an API client
+    version       returns the gutsy version
+    help          displays this message
+
+Shouts out Mr. Gutsy. Keep on plugging in the Wasteland.
+      TEXT
+      exit 0
+    end
+  end
+end

data/templates/app_client/Gemfile.erb

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in <%= gem_name_snake %>.gemspec
+gemspec

data/templates/app_client/LICENSE.txt.erb

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) <%= copyright_year %> <%= copyright_owner %>
+
+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/templates/app_client/README.md.erb

@@ -0,0 +1,91 @@
+# <%= app_name %> Ruby Client
+
+<%= app_name %> is an application that does things. This gem provides a wrapper around an HTTP Client generated from <%= app_name %>'s JSON Schema using [heroics](https://github.com/interagent/heroics).
+
+
+## Usage
+
+Add this to your Gemfile
+
+```
+gem '<%= gem_name_snake %>' #, git: 'git@github.com:USER/REPO.git', tag: 'v0.1.0'
+```
+
+### Rails Setup
+
+* Add to an initializer (e.g. `config/initializers/<%= gem_name_snake %>.rb`)
+
+  ```ruby
+  <%= gem_name_pascal %>.configure do |config|
+    config.base_url   = "http://<%= app_name.downcase %>.dev"
+    config.api_key    = "i-am-api-user"
+    config.api_secret = "very-secret-sssshhh"
+    # or OAuth access token
+    # config.access_token = "SHA-goodness"
+  end
+  ```
+
+### Example
+
+```
+class SomeResourceLister
+  attr_accessor :client
+
+  def initialize(access_token)
+    @client = <%= gem_name_pascal %>::V1::SomeResource.new(access_token: access_token)
+  end
+
+  def call
+    response = client.list({ "start_time" => Time.now.iso8601, "end_time" => (Time.now + 7.days).iso8601 })
+
+    if response.ok?
+      response.some_resources
+    else
+      response.errors
+    end
+  end
+end
+```
+
+## API
+
+All Client and Resource API methods return an Object mirroring the JSON response of the <%= app_name.capitalize %> API call, with the added method `ok?`, indicating whether the call was a success (`2xx`), or whether the call was invalid (`422`). Other failures will raise an `Excon::Errors::Error` such as an `Excon::Errors::HTTPStatusError`.
+
+The methods supported by each Resource API are generated by heroics and are determined by the JSON schema. In most cases, the Resource APIs found in `lib/<%= gem_name_snake %>` just proxy method calls to the API adapter (by default the heroics-generated API adapter).
+
+<% resources.each do |key, resource| %>
+
+### <%= resource.title.camelize %>
+
+#### `::new(client=nil, access_token: nil, api_key: nil, api_secret: nil, options: {})`
+
+Called with no arguments, `client` defaults to a newly created heroics client instance using the authentication details specified in an initializer/with `<%= gem_name_pascal %>.configure`. Passing an optional argument will override the authentication specified in `<%= gem_name_pascal %>.configuration` for the instance.
+
+#### Methods
+
+<% resource.links.each do |key, link| -%>
+<% if key == :list || key == :create -%>
+##### `#<%= key %>(body)`
+
+* `body` - Hash containing the following properties:
+  <% link.properties.each do |key, prop| -%>
+  * `<%= key %>` - <%= prop.description %>
+  <% end -%>
+<% end -%>
+<% if key == :info || key == :destroy -%>
+##### `#<%= key %>(id)`
+
+* `id` - <%= resource.title.titleize %> identifier
+
+<% end -%>
+<% if key == :update -%>
+##### `#<%= key %>(id, body)`
+
+* `id` - <%= resource.title.titleize %> identifier
+* `body` - Hash containing the following properties:
+  <% link.properties.each do |key, prop| -%>
+  * `<%= key %>` - <%= prop.description %>
+  <% end -%>
+<% end -%>
+<% end -%>
+<% end -%>

data/templates/app_client/Rakefile.erb

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/templates/app_client/app_client.gemspec.erb

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$LOAD_PATH.push File.expand_path("lib/<%= gem_name_snake %>", __FILE__)
+require "./lib/<%= gem_name_snake %>/version"
+
+Gem::Specification.new do |s|
+  s.name        = '<%= gem_name_snake %>'
+  s.version     = <%= gem_name_pascal %>::VERSION
+  s.authors     = ["AUTHOR"]
+  s.email       = "author@localhost"
+  s.summary     = "Gutsy-generated gem for <%= app_name %> client"
+  s.description = "<%= app_name %> API client generated by gutsy from JSON Schema"
+
+  s.files         = `git ls-files`.split "\n"
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split "\n"
+  s.require_paths = ['lib']
+
+  s.add_dependency 'multi_json'
+  s.add_dependency 'heroics', '~> 0.0.17'
+  s.add_dependency 'recursive-open-struct', '~> 1.0'
+  s.add_dependency 'excon', '>= 0.49.0', '< 1.0'
+
+  s.add_development_dependency 'rake'
+end

data/templates/app_client/lib/app_client/v1/adapter.rb.erb

@@ -0,0 +1,66 @@
+module <%= gem_name_pascal %>
+  module V1
+    # Empty namespace, needed for heroics-generated HTTP client
+    module Adapters; end
+
+    module Adapter
+      def initialize(client=nil, access_token: nil, api_key: nil, api_secret: nil, options: {})
+        @client = if client
+          client
+        else
+          config          = <%= gem_name_pascal %>.configuration
+          access_token  ||= config.access_token
+          api_key       ||= config.api_key
+          api_secret    ||= config.api_secret
+          options         = config.options.merge!(options)
+
+          # Workaround issue with some TLS setups (haproxy)
+          # Prevents :443 being added to hostname for TLS
+          Excon.defaults[:omit_default_port] = true
+
+          if access_token
+            config.adapter_factory.connect_oauth(access_token, options)
+          elsif api_key && api_secret
+            config.adapter_factory.connect(api_secret, options.merge!({
+              user: config.api_key
+            }))
+          else
+            raise 'access_token or API key & secret are required to connect to <%= app_name.downcase %> API'
+          end
+        end
+      end
+
+      def method_missing(name, *args)
+        if resource_caller.respond_to?(name)
+          begin
+            response = resource_caller.send(name, *args)
+            response[:ok?] = true
+          rescue Excon::Errors::UnprocessableEntity => e
+            response = MultiJson.load(e.response.body)
+            response[:ok?] = false
+          end
+
+          RecursiveOpenStruct.new(response, recurse_over_arrays: true)
+        else
+          raise NoMethodError.new("'#{resource_name}' API adapter '#{to_s}' does not respond to ##{name}")
+        end
+      end
+
+      def resource_name
+        raise "Please define a name for this resource"
+      end
+
+      def adapter_class
+        client.class
+      end
+
+      protected
+
+      attr_accessor :client
+
+      def resource_caller
+        client.send(resource_name)
+      end
+    end
+  end
+end

data/templates/app_client/lib/app_client/v1/resource.rb.erb

@@ -0,0 +1,11 @@
+module <%= gem_name_pascal %>
+  module V1
+    class <%= resource_name.camelize %>
+      include Adapter
+
+      def resource_name
+        "<%= resource_name.underscore %>"
+      end
+    end
+  end
+end

data/templates/app_client/lib/app_client/version.rb.erb

@@ -0,0 +1,3 @@
+module <%= gem_name_pascal %>
+  VERSION = "0.1.0"
+end

data/templates/app_client/lib/app_client.rb.erb

@@ -0,0 +1,58 @@
+require 'multi_json'
+require 'recursive-open-struct'
+require '<%= gem_name_snake %>/v1/adapter'
+
+Dir.glob(File.join(File.dirname(__FILE__), "<%= gem_name_snake %>", '**', '*.rb')).each do |file|
+  require file
+end
+
+module <%= gem_name_pascal %>
+  class << self
+    attr_accessor :configuration
+  end
+
+  # Configure <%= gem_name_pascal %> someplace sensible,
+  # like config/initializers/<%= gem_name_snake %>.rb
+  #
+  # @example
+  #   <%= gem_name_pascal %>.configure do |config|
+  #     config.base_url = 'http://<%= app_name.downcase %>.dev'
+  #     # Specify credentials for OAuth browser-flow
+  #     config.access_token = 'randomness'
+  #     # or server-side flow
+  #     config.api_key    = 'i-am-app'
+  #     config.api_secret = 'am-secret-dont-tell'
+  #   end
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration) if block_given?
+  end
+
+  class Configuration
+    attr_accessor :access_token, :api_key, :api_secret,
+                  :base_url, :options,
+                  :adapter_factory, :api_version
+
+    def options
+      @options ||= {}
+    end
+
+    def api_version
+      @api_version ||= 'v1'
+    end
+
+    def api_version=(version)
+      options[:url] = "#{base_url}/api/#{version}"
+      @api_version = version
+    end
+
+    def adapter_factory
+      @adapter_factory ||= <%= gem_name_pascal %>.const_get("#{api_version.upcase}")::Adapters::Http
+    end
+
+    def base_url=(url)
+      options[:url] = "#{url}/api/#{api_version}"
+      @base_url = url
+    end
+  end
+end

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: gutsy
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Iora Health
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: heroics
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.17
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.17
+- !ruby/object:Gem::Dependency
+  name: json_schema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !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: Generates heroics-powered API client gem wrappers from JSON Schema
+email:
+- rubygems@iorahealth.com
+executables:
+- gutsy
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/gutsy
+- bin/setup
+- gutsy.gemspec
+- lib/gutsy.rb
+- lib/gutsy/cli.rb
+- lib/gutsy/generator.rb
+- lib/gutsy/version.rb
+- templates/app_client/.gitignore.erb
+- templates/app_client/Gemfile.erb
+- templates/app_client/LICENSE.txt.erb
+- templates/app_client/README.md.erb
+- templates/app_client/Rakefile.erb
+- templates/app_client/app_client.gemspec.erb
+- templates/app_client/lib/app_client.rb.erb
+- templates/app_client/lib/app_client/v1/adapter.rb.erb
+- templates/app_client/lib/app_client/v1/adapters/.gitkeep
+- templates/app_client/lib/app_client/v1/resource.rb.erb
+- templates/app_client/lib/app_client/version.rb.erb
+homepage: https://github.com/IoraHealth/gutsy
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Generates heroics-powered API client gem wrappers from JSON Schema
+test_files: []