auser-butterfly 0.0.2

data/History.txt

@@ -0,0 +1,4 @@
+== 0.0.1 2009-03-23
+
+* 1 major enhancement:
+  * Initial release

data/Manifest.txt

@@ -0,0 +1,24 @@
+History.txt
+Manifest.txt
+PostInstall.txt
+README.rdoc
+Rakefile
+bin/flutter
+butterfly.gemspec
+examples/example.json
+examples/example.yml
+lib/butterfly.rb
+lib/butterfly/adaptor_base.rb
+lib/butterfly/adaptors/json_file_adaptor.rb
+lib/butterfly/adaptors/yaml_file_adaptor.rb
+lib/butterfly/core/string.rb
+lib/butterfly/default.rb
+lib/butterfly/request.rb
+lib/butterfly/response.rb
+lib/butterfly/server.rb
+script/console
+script/destroy
+script/generate
+test/test_butterfly_request.rb
+test/test_butterfly_server.rb
+test/test_helper.rb

data/PostInstall.txt

@@ -0,0 +1,7 @@
+
+For more information on butterfly, see http://butterfly.rubyforge.org
+
+NOTE: Change this information in PostInstall.txt 
+You can also delete it if you don't want it.
+
+

data/README.rdoc

@@ -0,0 +1,48 @@
+= Butterfly
+
+http://blog.xnot.org
+
+== DESCRIPTION:
+
+An HTTP mini server to query against modular adaptors
+
+== FEATURES/PROBLEMS:
+
+  It's new
+
+== SYNOPSIS:
+
+  Check out the tests
+
+== REQUIREMENTS:
+
+* thin
+
+== INSTALL:
+
+* sudo gem install auser-butterfly
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 Ari Lerner, CloudTeam, AT&Ti
+
+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/Rakefile

@@ -0,0 +1,28 @@
+%w[rubygems rake rake/clean fileutils newgem rubigen].each { |f| require f }
+require File.dirname(__FILE__) + '/lib/butterfly'
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new('butterfly', Butterfly::VERSION) do |p|
+  p.developer('Ari Lerner', 'arilerner@mac.com')
+  p.changes              = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.post_install_message = 'PostInstall.txt' # TODO remove if post-install message not required
+  p.rubyforge_name       = p.name # TODO this is default value
+  # p.extra_deps         = [
+  #   ['activesupport','>= 2.0.2'],
+  # ]
+  p.extra_dev_deps = [
+    ['newgem', ">= #{::Newgem::VERSION}"]
+  ]
+  
+  p.clean_globs |= %w[**/.DS_Store tmp *.log]
+  path = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
+  p.remote_rdoc_dir = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')
+  p.rsync_args = '-av --delete --ignore-errors'
+end
+
+require 'newgem/tasks' # load /tasks/*.rake
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+# task :default => [:spec, :features]

data/bin/flutter

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require "#{File.dirname(__FILE__)}/../lib/butterfly"
+
+Butterfly::Server.new({}).start!

data/butterfly.gemspec

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{butterfly}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Ari Lerner"]
+  s.date = %q{2009-04-03}
+  s.default_executable = %q{flutter}
+  s.description = %q{An HTTP mini server to query against modular adaptors}
+  s.email = ["arilerner@mac.com"]
+  s.executables = ["flutter"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "PostInstall.txt", "README.rdoc"]
+  s.files = ["History.txt", "Manifest.txt", "PostInstall.txt", "README.rdoc", "Rakefile", "bin/flutter", "butterfly.gemspec", "examples/example.json", "examples/example.yml", "lib/butterfly.rb", "lib/butterfly/adaptor_base.rb", "lib/butterfly/adaptors/json_file_adaptor.rb", "lib/butterfly/adaptors/yaml_file_adaptor.rb", "lib/butterfly/core/string.rb", "lib/butterfly/default.rb", "lib/butterfly/request.rb", "lib/butterfly/response.rb", "lib/butterfly/server.rb", "script/console", "script/destroy", "script/generate", "test/test_butterfly_request.rb", "test/test_butterfly_server.rb", "test/test_helper.rb"]
+  s.has_rdoc = true
+  s.homepage = %q{http://blog.xnot.org}
+  s.post_install_message = %q{PostInstall.txt}
+  s.rdoc_options = ["--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{butterfly}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{An HTTP mini server to query against modular adaptors}
+  s.test_files = ["test/test_butterfly_request.rb", "test/test_butterfly_server.rb", "test/test_helper.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<newgem>, [">= 1.2.3"])
+      s.add_development_dependency(%q<hoe>, [">= 1.8.0"])
+    else
+      s.add_dependency(%q<newgem>, [">= 1.2.3"])
+      s.add_dependency(%q<hoe>, [">= 1.8.0"])
+    end
+  else
+    s.add_dependency(%q<newgem>, [">= 1.2.3"])
+    s.add_dependency(%q<hoe>, [">= 1.8.0"])
+  end
+end

data/examples/example.json

@@ -0,0 +1 @@
+{"server" : {"name" : "maggie", "winner" : "false", "poolparty" : {"the":"boss"}}}

data/examples/example.yml

@@ -0,0 +1,7 @@
+:server:
+  :name: localhost
+  :load: 0.10
+  :hostname: "amigos"
+  :services:
+    :apache
+    :ssh

data/lib/butterfly.rb

@@ -0,0 +1,34 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+module Butterfly
+  VERSION = '0.0.2' unless Butterfly.const_defined?("VERSION")
+  
+  def self.reload!
+    @reloading = true
+    butterfly_file = __FILE__
+    $LOADED_FEATURES.delete(butterfly_file)
+    ::Kernel.load butterfly_file
+    @reloading = false    
+  end
+end
+
+class Hash
+  def method_missing(m,*a,&block)
+    if has_key?(m)
+      self[m]
+    else
+      super
+    end
+  end
+end
+
+%w(rubygems thin dslify).each do |lib|
+  require lib
+end
+
+%w(string).each {|lib| require "#{File.dirname(__FILE__)}/butterfly/core/#{lib}" }
+
+%w(default adaptor_base response request server).each do |lib|
+  require "#{File.dirname(__FILE__)}/butterfly/#{lib}"
+end

data/lib/butterfly/adaptor_base.rb

@@ -0,0 +1,47 @@
+module Butterfly
+  class AdaptorBase
+    
+    def get(req, resp)
+      raise Exception.new("Your adaptor does not support get")
+    end
+    
+    def put(req, resp)
+      raise Exception.new("Your adaptor does not support put")
+    end
+    
+    def post(req, resp)
+      raise Exception.new("Your adaptor does not support post")
+    end
+    
+    def delete(req, resp)
+      raise Exception.new("Your adaptor does not support delete")
+    end
+    
+    def handle_call(req, resp)
+      update_request!
+      self.send req.request_method, req, resp
+    end
+    
+    def initialize(o={})
+      @time_til_stale = o[:time_til_stale] || Default.time_til_stale
+    end
+    
+    private
+    def parse_path(env)
+      env["REQUEST_URI"].gsub(/\//, '')
+    end
+    def update_request!
+      reload! if (Time.now.to_i - last_loaded_at >= @time_til_stale)
+    end
+    def last_loaded_at
+      @last_loaded_at ||= Time.now.to_i
+    end
+    def reload!
+      @last_loaded_at = Time.now.to_i
+    end
+  end
+end
+
+%w(yaml_file json_file).each do |lib|
+  require "#{File.dirname(__FILE__)}/adaptors/#{lib}_adaptor"
+end

data/lib/butterfly/adaptors/json_file_adaptor.rb

@@ -0,0 +1,33 @@
+require "json"
+
+module Butterfly
+  class JsonFileAdaptor < AdaptorBase
+    attr_reader :data
+    def initialize(o={})      
+      @file = o[:file] + ".json"
+      super
+    end
+    def get(req, resp)
+      if data.has_key?(req.params[0].to_s)
+        body = "", current_data = data  
+        req.params.each do |param|
+          current_data = current_data[param.to_s]
+        end
+        current_data
+      else
+        resp.fail!
+        "Not found"
+      end
+    end
+    
+    private
+    
+    def data
+      @data ||= reload!
+    end
+    def reload!
+      super 
+      @data = JSON.parse(open(@file).read)
+    end
+  end
+end

data/lib/butterfly/adaptors/yaml_file_adaptor.rb

@@ -0,0 +1,33 @@
+require "yaml"
+
+module Butterfly
+  class YamlFile < AdaptorBase
+    attr_reader :data
+    def initialize(o={})
+      @time_til_stale = o[:time_til_stale] || Default.time_til_stale
+      @file = o[:file] + ".yml"
+    end
+    def get(req, resp)
+      if data.has_key?(req.params[0])
+        body = "", current_data = data        
+        req.params.each do |param|
+          current_data = current_data[param]
+        end
+        current_data
+      else
+        resp.fail!
+        "Not found"
+      end
+    end
+    
+    private
+    
+    def data
+      @data ||= reload!
+    end
+    def reload!
+      super 
+      @data = YAML::load(open(@file).read)
+    end
+  end
+end

data/lib/butterfly/core/string.rb

@@ -0,0 +1,5 @@
+class String
+  def camel_case
+    gsub(/(^|_|-)(.)/) { $2.upcase }
+  end
+end

data/lib/butterfly/default.rb

@@ -0,0 +1,20 @@
+module Butterfly
+  class Default
+    include Dslify
+    
+    default_options(
+      :host => "localhost",
+      :port => 8081,
+      :time_til_stale => 10, # 10 seconds between cache updates
+      :adaptor => "JsonFile",
+      :adaptor_opts => {
+        :file => "#{File.dirname(__FILE__)}/../../examples/example"
+      }
+    )
+    
+    def self.method_missing(m,*a,&block)
+      default_options.include?(m) ? default_options[m] : super
+    end
+    
+  end
+end

data/lib/butterfly/request.rb

@@ -0,0 +1,20 @@
+module Butterfly
+  class Request
+    attr_reader :env
+    def initialize(env)
+      @env = env
+    end
+    def route_param
+      @route_param ||= params.shift
+    end
+    def params
+      @params ||= env["REQUEST_URI"].split("?")[0].split(".")[0].split("/").reject {|a| a.empty? }.map {|a| a.to_sym }
+    end
+    def request_method
+      env["REQUEST_METHOD"].downcase.to_sym
+    end
+    def request_type
+      env["REQUEST_URI"].split(".")[-1]
+    end
+  end
+end

data/lib/butterfly/response.rb

@@ -0,0 +1,49 @@
+require "rubygems"
+require "json"
+module Butterfly
+  class Response
+    attr_reader :request, :body, :status, :headers
+    
+    def initialize req, b=nil
+      @request = req
+      @headers = {}
+      @body = b
+    end
+    def return!(b)
+      @body ||= b
+      [status, prepare_headers, prepare_body]
+    end
+    def prepare_headers
+      add_header("ContentType", choose_response_type)
+      headers
+    end
+    def prepare_body
+      case request.request_type
+      when "json"
+        body.to_json
+      else
+        body.to_s
+      end
+    end
+    def add_header(k,v)
+      @headers[k] = v unless @headers.include?(k)
+    end
+    def status
+      @status ||= 200
+    end
+    def success!
+      @status = 200
+    end
+    def fail!
+      @status = 404
+    end
+    def choose_response_type
+      case request.request_type
+      when "json"
+        "application/json"
+      else
+        "text/plain"
+      end
+    end
+  end
+end

data/lib/butterfly/server.rb

@@ -0,0 +1,43 @@
+module Butterfly
+  class Server
+    attr_reader :app, :host, :port
+    attr_accessor :adaptor_name
+    def initialize(opts={})
+      @host = opts.delete(:host) || Default.host
+      @port = opts.delete(:port) || Default.port
+      @adaptor_opts = Default.default_options[:adaptor_opts].merge(opts)
+      @app = self
+    end
+
+    def start!
+      Thin::Server.start(@host, @port, app)
+    end
+
+    def reload!
+      Butterfly.reload!
+    end
+
+    def reloading?
+      @reloading == true
+    end
+    
+    def should_reload?
+      true
+    end
+    
+    def call(env)
+      reload! if should_reload?
+      
+      @request = Request.new env
+      @response = Response.new @request
+      
+      body = get_adaptor(@request.route_param).send(:handle_call, @request, @response) rescue "Error"
+      
+      @response.return!(body)
+    end
+    
+    def get_adaptor(p=Default.adaptor)
+      @adaptor ||= Butterfly.const_get("#{p.to_s.camel_case}Adaptor").new(@adaptor_opts)
+    end
+  end
+end

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/butterfly.rb'}"
+puts "Loading butterfly gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/test/test_butterfly_request.rb

@@ -0,0 +1,24 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestButterflyRequest < Test::Unit::TestCase
+  context "params" do
+    before do
+      @env = {
+        "REQUEST_METHOD" => "GET",
+        "REQUEST_URI" => "/server"
+      }
+    end
+    it "should parse the query into 1 part [:server] when the path is /server" do
+      Butterfly::Request.new(@env).params.should == [:server]
+    end
+    it "should parse the query into 2 items when the path is /server/item" do
+      Butterfly::Request.new(@env.merge("REQUEST_URI" => "/server/item")).params.should == [:server, :item]
+    end
+    it "should parse the query into 3 items when the path is /server/item/two" do
+      Butterfly::Request.new(@env.merge("REQUEST_URI" => "/server/item/two")).params.should == [:server, :item, :two]
+    end
+    it "should not explode with a ?" do
+      Butterfly::Request.new(@env.merge("REQUEST_URI" => "/server/item/two?pop=dance")).params.should == [:server, :item, :two]
+    end
+  end
+end

data/test/test_butterfly_server.rb

@@ -0,0 +1,16 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestButterflyServer < Test::Unit::TestCase
+  context "server" do
+    before do
+      @server = Butterfly::Server.new({:host => "0.0.0.0", :port => 10000})
+    end
+    it "should set the host and port properly when passed in as a hash" do
+      @server.host.should == "0.0.0.0"
+      @server.port.should == 10000
+    end
+    it "should respond to call (for rack)" do
+      @server.respond_to?(:call).should == true
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,6 @@
+require 'stringio'
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/butterfly'
+require "rubygems"
+require "matchy"
+require "context"

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification 
+name: auser-butterfly
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Ari Lerner
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-03 00:00:00 -07:00
+default_executable: flutter
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: newgem
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.0
+    version: 
+description: An HTTP mini server to query against modular adaptors
+email: 
+- arilerner@mac.com
+executables: 
+- flutter
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- README.rdoc
+files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- README.rdoc
+- Rakefile
+- bin/flutter
+- butterfly.gemspec
+- examples/example.json
+- examples/example.yml
+- lib/butterfly.rb
+- lib/butterfly/adaptor_base.rb
+- lib/butterfly/adaptors/json_file_adaptor.rb
+- lib/butterfly/adaptors/yaml_file_adaptor.rb
+- lib/butterfly/core/string.rb
+- lib/butterfly/default.rb
+- lib/butterfly/request.rb
+- lib/butterfly/response.rb
+- lib/butterfly/server.rb
+- script/console
+- script/destroy
+- script/generate
+- test/test_butterfly_request.rb
+- test/test_butterfly_server.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://blog.xnot.org
+post_install_message: PostInstall.txt
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: butterfly
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: An HTTP mini server to query against modular adaptors
+test_files: 
+- test/test_butterfly_request.rb
+- test/test_butterfly_server.rb
+- test/test_helper.rb