jetson 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9f300ae4a79ccc92520c1787c974684bf8dff1d8
+  data.tar.gz: 6687fdda7e64f86c5014cb093c2dd84df8aace31
+SHA512:
+  metadata.gz: 8fd8267d28aa2f55cac3c2c1634b966e6b9c6a8edc3623bee36c51ef7577da24b6b0a709e87182c48f35c65972d19929bd695fb98374723ddc122fa878bff8a4
+  data.tar.gz: a1c930a4fe73bab70150187fa46b8ca6a570d6ff0bdda27d18230d529ed3be62433de1509c90d02d1734b5ee1b665b50233708803dadd0cf17e98d8bbdad73eb

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.2.3
+before_install: gem install bundler -v 1.10.6

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 blahed
+
+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,98 @@
+# Jetson
+
+Talk to JSON APIs in a convient ruby based console or use the DSL to make calls in your own code.
+
+Jetson provides a simple wrapper for working with JSON APIs – it's built for working with JSON in a friendly and convient way and tries to simplify it to the point of not having to remember complex command line switches or configuration options.
+
+*NOTE: Jetson is built to work with JSON APIs, if you need to work with APIs that aren't JSON based, this isn't the tool for you... sorry :(*
+
+## Installation
+
+```shell
+$ gem install jetson
+```
+
+### Usage
+
+You can work with Jetson in two different ways, the console or the DSL. The DSL actually powers the console, so you'll have a very similar experience regardless of what you choose to use based on your needs. The console is an IRB based environment for working with your API, and the DSL provides a set of methods that can be included in your own code or scripts.
+
+## Console / REPL
+
+To start the console, just run the jetson command with a hostname:
+
+```shell
+$ jetson localhost:3000
+localhost:3000>
+```
+
+The console is actually powered by IRB, so you can do anything you'd do in IRB within the console... and command history works. HTTP verbs (get, post, put, patch, delete) are available as methods in the console:
+
+```ruby
+# GET request
+localhost:3000> get '/foo'
+# GET request with params
+localhost:3000> get '/foo', {some: 'param'}
+# POST with json payload
+localhost:3000> post '/bar', {something: 'jsony'}
+```
+
+#### Cookies
+
+Each console starts with a session (sorta like a browser), so any requests that set cookies will store those cookies and send them with subsequent requests. If you need to clear the cookies/session you can use the `clear :cookies` method.
+
+#### Headers
+
+Every request will have the `Content-Type` and `Accept` header set to `application/json`. If you need to add additional headers you can set them by manipulating the `headers` attribute:
+
+```ruby
+localhost:3000> headers[:some_header] = 'some value'
+```
+
+Headers set using the `headers` attribute will persist and be applied to every request made after, you can clear headers using the `clear :headers` method.
+
+
+If you need to change headers on a per request basis, you can add a headers hash as the last argument to the request method:
+
+```ruby
+localhost:3000> post '/bar', {something: 'jsony'}, {some_header: 'some value'}
+```
+
+
+## DSL
+
+The Jetson DSL is handy for writing scripts, once you include the DSL you'll get access to all of the methods that console has. The one difference is that you'll need to call your http methods inside a `session` block to set the host name. The session block also persists headers and cookies on a global level.
+
+```ruby
+require 'jetson/dsl'
+
+extend Jetson::DSL
+
+session 'http://localhost:4567' do
+  set :verbose, true
+  set :headers, {foo: 'bar'}
+  set :cookies, {wee: 'hah'}
+  
+  get '/foo'
+  
+  res = get! ('/')
+  
+  puts res.status
+end
+
+```
+
+
+#### Setting headers and cookies
+
+While working within a `session` block you can use the `set` command to set headers or cookies. Both will be applied to ever request.
+
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/jetson.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/bin/dsl

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'jetson/dsl'
+
+extend Jetson::DSL
+
+session 'http://localhost:4567' do
+  set :verbose, true
+  set :headers, {foo: 'bar'}
+  set :cookies, {wee: 'hah'}
+  
+  get '/cookies'
+  get! '/'
+  # users = request!(:get, 'https://user:password@httpbin.org/hidden-basic-auth/user/password')
+end

data/bin/server

@@ -0,0 +1,26 @@
+require 'pp'
+require 'sinatra'
+require 'sinatra/cookies'
+require 'sinatra/json'
+
+get '/' do
+  pp request.env.select {|k, _| k[0] =~ /\A[A-Z]/ }
+  json cookies
+end
+
+post '/api' do
+  pp request.env.select {|k, _| k[0] =~ /\A[A-Z]/ }
+  puts cookies
+  puts request.body.read
+  json headers
+end
+
+get '/cookies' do
+  pp request.env.select {|k, _| k[0] =~ /\A[A-Z]/ }
+  cookies[:foo] = 'bar'
+  json cookies
+end
+
+get '/boo' do
+  asdf
+end

data/exe/jetson

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'jetson'
+
+Jetson::Console.start

data/jetson.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'jetson/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "jetson"
+  spec.version       = Jetson::VERSION
+  spec.authors       = ["blahed"]
+  spec.email         = ["trvsdnn@gmail.com"]
+
+  spec.summary       = "Talk to JSON APIs in a convient ruby based console or use the DSL to make calls in your own code."
+  spec.description   = "Jetson provides a simple wrapper for working with JSON APIs – it's built for working with JSON in a friendly and convient way and tries to simplify it to the point of not having to remember complex command line switches or configuration options."
+  spec.homepage      = "https://github.com/blahed/jetson"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+  
+  spec.add_dependency "rest-client", "~> 1.8.0"
+  spec.add_dependency "json_color", "~> 0.1.0"
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest"
+end

data/lib/jetson.rb

@@ -0,0 +1,8 @@
+require 'json'
+
+require 'jetson/dsl'
+require 'jetson/console'
+require 'jetson/version'
+
+module Jetson
+end

data/lib/jetson/commands.rb

@@ -0,0 +1,51 @@
+module Jetson
+  class Commands
+    extend Jetson::DSL
+    
+    def self.command(name, description = nil, &block)
+      @commands     ||= {}
+      @descriptions ||= {}
+      @descriptions[name] = description
+      @commands[name]     = block
+    end
+    
+    command :get, 'Perform a GET request' do |url, params|
+      params = eval(params) unless params.nil?
+      
+      request(:get, url, params)
+    end
+    
+    command :post, 'Perform a POST request' do |url, params|
+      params = eval(params) unless params.nil?
+      
+      request(:post, url, params)
+    end
+    
+    command :put, 'Perform a PUT request' do |url, params|
+      params = eval(params) unless params.nil?
+      
+      request(:put, url, params)
+    end
+    
+    command :patch, 'Perform a PATCH request' do |url, params|
+      params = eval(params) unless params.nil?
+      
+      request(:patch, url, params)
+    end
+    
+    command :delete, 'Perform a DELETE request' do |url, params|
+      params = eval(params) unless params.nil?
+      
+      request(:delete, url, params)
+    end
+      
+    command :help, 'Show this list' do
+      puts @descriptions.map { |name, desc| "#{name} - #{desc}" }.join("\n")
+    end
+    
+    def self.run(command, url, params)
+      @commands[command].call(url, params)
+    end
+    
+  end
+end

data/lib/jetson/console.rb

@@ -0,0 +1,83 @@
+require 'irb'
+require 'irb/completion'
+require 'irb/ext/save-history'
+
+module Jetson
+  class Console
+    class Context
+      include Jetson::DSL
+      
+      def initialize(host, *args)
+        @host    = normalize_host(host)
+        @verbose = true
+        @cookies = {}
+        @headers = {}
+      end
+      
+      def help
+        
+      end
+      
+      def to_s
+        @host.sub(/\Ahttps?:\/\//, '')
+      end
+    end
+    
+    def self.start
+      new.start
+    end
+    
+    def start
+      host, *args = ARGV
+      
+      ARGV.clear
+      IRB.setup nil
+
+      IRB.conf[:PROMPT]   = {}
+      IRB.conf[:IRB_NAME] = 'jetson'
+      IRB.conf[:PROMPT][:JETSON] = {
+        :PROMPT_I => "\033[1m%m>\033[0m ",
+        :PROMPT_N => nil,
+        :PROMPT_S => nil,
+        :PROMPT_C => nil,
+        :RETURN => "%s\n"
+      }
+      IRB.conf[:PROMPT_MODE]  = :JETSON
+      IRB.conf[:ECHO]         = false
+      IRB.conf[:RC]           = false
+      IRB.conf[:READLINE]     = true
+      IRB.conf[:SAVE_HISTORY] = 1000
+      IRB.conf[:HISTORY_FILE] = '~/.jetson'
+      
+      begin
+        dev_null = File.open('/dev/null', "w")
+        $stdout = dev_null
+        irb = IRB::Irb.new(IRB::WorkSpace.new(Context.new(host, *args)))
+      ensure
+        dev_null.close()
+        $stdout = STDOUT
+      end
+
+      
+      IRB.conf[:MAIN_CONTEXT] = irb.context
+
+      trap(:SIGINT) do
+        IRB.irb.signal_handle
+      end
+
+      begin
+        catch(:IRB_EXIT) do
+          irb.eval_input
+        end
+      ensure
+        IRB.irb_at_exit
+      end
+    end
+    
+    private
+    
+    def normalize_host
+      
+    end
+  end
+end

data/lib/jetson/dsl.rb

@@ -0,0 +1,105 @@
+require 'json'
+require 'uri'
+
+require 'json_color'
+require 'rest-client'
+
+module Jetson
+  module DSL
+    
+    def set(option, value)
+      instance_variable_set("@#{option}", value)
+    end
+    
+    def session(host, &block)
+      @host    = normalize_host(host)
+      @verbose = false
+      @cookies = {}
+      @headers = {}
+      
+      self.instance_eval &block
+    end
+    
+    def clear(resource = :all)
+      case resource
+      when :all
+        @cookies = {}
+        @headers = {}
+      when :headers
+        @headers = {}
+      when :cookies
+        @cookies = {}
+      end
+    end
+    
+    def request(method, url, *args)
+      response = request!(method, url, *args)
+      json     = parse_json(response.body) if response.headers[:content_type] =~ /json/
+            
+      print_request(response, json) if @verbose
+      
+      json
+    rescue RestClient::InternalServerError => err
+      puts "\033[1m#{method.to_s.upcase}\033[0m #{url} \033[31m#{err.response.code}\033[0m" 
+    end
+    
+    def request!(method, url, params = {}, headers = {})
+      options  = default_options
+      url      = URI.join(@host, url).to_s
+      
+      options.merge!(headers)
+      
+      if method == :get
+        options.merge!({params: params})
+        res = RestClient.send(method, url, options)
+      else
+        res = RestClient.send(method, url, params.to_json, options)
+      end
+      
+      @cookies.merge!(res.cookies)
+      
+      res
+    end
+    
+    [:get, :post, :put, :patch, :delete].each do |name|
+      define_method(name) { |url, *args| request(name, url, *args) }
+      define_method("#{name}!".to_sym) { |url, *args| request!(name, url,*args) }
+      alias_method name.upcase, name
+      alias_method "#{name.upcase}!".to_sym, "#{name}!".to_sym
+    end
+    
+    private
+    
+    def normalize_host(host)
+      host =~ /\Ahttp/ ? host : "http://#{host}"
+    end
+    
+    def parse_json(body)
+      JSON.parse(body)
+    rescue JSON::ParserError => err
+      puts "\033[31mUnable to parse JSON\033[0m"
+      puts err.backtrace
+      nil
+    end
+    
+    def default_options
+      options           = { content_type: :json, accept: :json }.merge(@headers)
+      options[:cookies] = @cookies unless @cookies.nil?
+      
+      options
+    end
+    
+    def print_request(response, json)
+      request = response.request
+      url     = request.url.sub(@host, '')
+      
+      puts "\033[1m#{request.method.to_s.upcase}\033[0m #{url} \033[32m#{response.code}\033[0m"
+      puts "\033[4mResponse\033[0m"
+      if json
+        puts JsonColor.colorize(JSON.pretty_generate(body))
+      else
+        puts response.body[0..100] + '...'
+      end
+    end
+  end
+end

data/lib/jetson/version.rb

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

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification
+name: jetson
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- blahed
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-11-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.8.0
+- !ruby/object:Gem::Dependency
+  name: json_color
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !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: minitest
+  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: Jetson provides a simple wrapper for working with JSON APIs – it's built
+  for working with JSON in a friendly and convient way and tries to simplify it to
+  the point of not having to remember complex command line switches or configuration
+  options.
+email:
+- trvsdnn@gmail.com
+executables:
+- jetson
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/dsl
+- bin/server
+- exe/jetson
+- jetson.gemspec
+- lib/jetson.rb
+- lib/jetson/commands.rb
+- lib/jetson/console.rb
+- lib/jetson/dsl.rb
+- lib/jetson/version.rb
+homepage: https://github.com/blahed/jetson
+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.6.7
+signing_key: 
+specification_version: 4
+summary: Talk to JSON APIs in a convient ruby based console or use the DSL to make
+  calls in your own code.
+test_files: []