webspeak 0.0.1

data/History.txt

@@ -0,0 +1,4 @@
+== 0.0.1 2007-10-21
+
+* 1 major enhancement:
+  * Initial release

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2007 Darren Boyd
+
+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/Manifest.txt

@@ -0,0 +1,42 @@
+History.txt
+License.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/webspeak
+bin/webspeak_listener
+config/hoe.rb
+config/requirements.rb
+examples/google_cookies.rb
+examples/web_search.rb
+lib/webspeak.rb
+lib/webspeak/console_app.rb
+lib/webspeak/http_dialect.rb
+lib/webspeak/http_listener.rb
+lib/webspeak/request.rb
+lib/webspeak/response_accessor.rb
+lib/webspeak/session.rb
+lib/webspeak/version.rb
+log/debug.log
+script/destroy
+script/generate
+script/txt2html
+setup.rb
+spec/http_dialect_spec.rb
+spec/http_listener_spec.rb
+spec/parse_request_servlet_spec.rb
+spec/request_spec.rb
+spec/response_accessor_spec.rb
+spec/session_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/webspeak_spec.rb
+tasks/deployment.rake
+tasks/environment.rake
+tasks/rspec.rake
+tasks/website.rake
+website/index.html
+website/index.txt
+website/javascripts/rounded_corners_lite.inc.js
+website/stylesheets/screen.css
+website/template.rhtml

data/README.txt

@@ -0,0 +1 @@
+README

data/Rakefile

@@ -0,0 +1,4 @@
+require 'config/requirements'
+require 'config/hoe' # setup Hoe + all gem configuration
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }

data/bin/webspeak

@@ -0,0 +1,64 @@
+#!/usr/bin/env ruby
+#
+#  Created by Darren Boyd on 2007-9-24.
+#  Copyright (c) 2007. All rights reserved.
+
+begin
+  require 'rubygems'
+rescue LoadError
+  # no rubygems to load, so we fail silently
+end
+
+require 'optparse'
+
+# NOTE: the option -p/--path= is given as an example, and should probably be replaced in your application.
+
+OPTIONS = {
+}
+MANDATORY_OPTIONS = %w(  )
+
+parser = OptionParser.new do |opts|
+  begin
+    opts.banner = <<BANNER_END
+Usage: #{File.basename($0)} [options] <file> [<file> ...]
+
+Options are:
+BANNER_END
+    opts.on("-c", "--console", "Run in console mode.") {OPTIONS[:console] = true}
+
+    opts.on("-h", "--help",
+            "Show this help message.") { puts opts; exit }
+
+    opts.parse!(ARGV)
+    
+    if ARGV.empty? and !OPTIONS[:console]
+      $stderr.puts "Please provide a file."
+      $stderr.puts opts
+      exit 1
+    end
+    
+    if MANDATORY_OPTIONS && MANDATORY_OPTIONS.find { |option| OPTIONS[option.to_sym].nil? }
+      $stderr.puts opts
+      exit 1
+    end
+  rescue SystemExit => e
+    raise e
+  rescue Exception => e
+    $stderr.puts e.message
+    $stderr.puts opts
+    exit 1
+  end
+end
+
+require 'webspeak'
+
+if OPTIONS[:console]
+  libs = " -r webspeak/console_app"
+  libs << (" -r " + ARGV.join(" -r ")) unless ARGV.empty?
+  exec "irb --noinspect #{libs}"
+else
+  @interpreter = WebSpeak::HTTP::Base.new
+  ARGV.each do |file|
+    @interpreter.instance_eval(File.read(file), file)
+  end
+end

data/bin/webspeak_listener

@@ -0,0 +1,46 @@
+#!/usr/bin/env ruby
+#
+#  Created by Darren Boyd on 2007-9-24.
+#  Copyright (c) 2007. All rights reserved.
+
+begin
+  require 'rubygems'
+rescue LoadError
+  # no rubygems to load, so we fail silently
+end
+
+require 'optparse'
+
+# NOTE: the option -p/--path= is given as an example, and should probably be replaced in your application.
+
+OPTIONS = {
+  :path     => '~'
+}
+MANDATORY_OPTIONS = %w(  )
+
+parser = OptionParser.new do |opts|
+  opts.banner = <<BANNER
+This application is wonderful because...
+
+Usage: #{File.basename($0)} [options]
+
+Options are:
+BANNER
+  opts.separator ""
+  opts.on("-p", "--path=PATH", String,
+          "The root path for selecting files",
+          "Default: ~") { |OPTIONS[:path]| }
+  opts.on("-h", "--help",
+          "Show this help message.") { puts opts; exit }
+  opts.parse!(ARGV)
+
+  if MANDATORY_OPTIONS && MANDATORY_OPTIONS.find { |option| OPTIONS[option.to_sym].nil? }
+    puts opts; exit
+  end
+end
+
+path = OPTIONS[:path]
+
+# do stuff
+require 'webspeak'
+WebSpeak::HTTPListener.new().listen

data/config/hoe.rb

@@ -0,0 +1,70 @@
+require 'webspeak/version'
+
+AUTHOR = 'Darren Boyd'  # can also be an array of Authors
+EMAIL = "darren.boyd@gmail.com"
+DESCRIPTION = "description of gem"
+GEM_NAME = 'webspeak' # what ppl will type to install your gem
+RUBYFORGE_PROJECT = 'webspeak' # The unix name for your project
+HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+DOWNLOAD_PATH = "http://rubyforge.org/projects/#{RUBYFORGE_PROJECT}"
+
+@config_file = "~/.rubyforge/user-config.yml"
+@config = nil
+RUBYFORGE_USERNAME = "unknown"
+def rubyforge_username
+  unless @config
+    begin
+      @config = YAML.load(File.read(File.expand_path(@config_file)))
+    rescue
+      puts <<-EOS
+ERROR: No rubyforge config file found: #{@config_file}
+Run 'rubyforge setup' to prepare your env for access to Rubyforge
+ - See http://newgem.rubyforge.org/rubyforge.html for more details
+      EOS
+      exit
+    end
+  end
+  RUBYFORGE_USERNAME.replace @config["username"]
+end
+
+
+REV = nil 
+# UNCOMMENT IF REQUIRED: 
+# REV = `svn info`.each {|line| if line =~ /^Revision:/ then k,v = line.split(': '); break v.chomp; else next; end} rescue nil
+VERS = Webspeak::VERSION::STRING + (REV ? ".#{REV}" : "")
+RDOC_OPTS = ['--quiet', '--title', 'webspeak documentation',
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README",
+    "--inline-source"]
+
+class Hoe
+  def extra_deps 
+    @extra_deps.reject! { |x| Array(x).first == 'hoe' } 
+    @extra_deps
+  end 
+end
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+hoe = Hoe.new(GEM_NAME, VERS) do |p|
+  p.author = AUTHOR 
+  p.description = DESCRIPTION
+  p.email = EMAIL
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.test_globs = ["test/**/test_*.rb"]
+  p.clean_globs |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']  #An array of file patterns to delete on clean.
+  
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\\n\\n")
+  #p.extra_deps = []     # An array of rubygem dependencies [name, version], e.g. [ ['active_support', '>= 1.3.1'] ]
+  
+  #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
+  
+end
+
+CHANGES = hoe.paragraphs_of('History.txt', 0..1).join("\\n\\n")
+PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "#{RUBYFORGE_PROJECT}/#{GEM_NAME}"
+hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')

data/config/requirements.rb

@@ -0,0 +1,17 @@
+require 'fileutils'
+include FileUtils
+
+require 'rubygems'
+%w[rake hoe newgem rubigen].each do |req_gem|
+  begin
+    require req_gem
+  rescue LoadError
+    puts "This Rakefile requires the '#{req_gem}' RubyGem."
+    puts "Installation: gem install #{req_gem} -y"
+    exit
+  end
+end
+
+$:.unshift(File.join(File.dirname(__FILE__), %w[.. lib]))
+
+require 'webspeak'

data/examples/google_cookies.rb

@@ -0,0 +1,3 @@
+
+host 'www.google.com'
+get

data/examples/web_search.rb

@@ -0,0 +1,9 @@
+
+# setup our request information
+host 'www.google.com'
+path '/search'
+param 'q' => 'webspeak'
+get
+
+# display the body
+puts response.body

data/lib/webspeak.rb

@@ -0,0 +1,6 @@
+$:.unshift File.dirname(__FILE__)
+require 'webspeak/session'
+require 'webspeak/request'
+require 'webspeak/http_listener'
+require 'webspeak/http_dialect'
+require 'webspeak/response_accessor'

data/lib/webspeak/console_app.rb

@@ -0,0 +1,3 @@
+require "webspeak"
+self.include WebSpeak::HTTP::Dialect
+

data/lib/webspeak/http_dialect.rb

@@ -0,0 +1,71 @@
+module WebSpeak
+  module HTTP
+
+    module Dialect
+      def host(host)
+        request.host = host
+      end
+
+      def port(port)
+        request.port = port
+      end
+
+      def path(path)
+        request.path = path
+      end
+
+      def header(*args)
+        name, value = get_name_value_pair('header', args)
+        request.headers[name] = value
+      end
+
+      def query_param(*args)
+        name, value = get_name_value_pair('query_param', args)
+        request.query_params[name] = value
+      end
+      
+      def param(*args)
+        name, value = get_name_value_pair('param', args)
+        request.params[name] = value
+      end
+
+      def cookie(*args)
+        name, value = get_name_value_pair('cookie', args)
+        request.cookies[name] = value
+      end
+
+      def post
+        request.post()
+      end
+      
+      def get
+        request.get()
+      end
+      
+      def request
+        @request ||= WebSpeak::Request.new
+      end
+      
+      def response
+        @response_accessor = ResponseAccessor.new(request.response)
+      end
+
+    protected
+      def get_name_value_pair(method_name, args)
+        raise "wrong number of arguments for '#{method_name}'.  " + 
+        "Use either 'name' => 'value' or 'name', 'value'" if 
+        args.size < 1 || args.size > 2 || (args.size == 1 && (!args.class == Hash))
+        if args.length == 2
+          name, value = args[0,2]
+        else
+          name, value = args[0].keys.first, args[0].values.first
+        end
+        [name, value]
+      end
+    end
+
+    class Base
+      include Dialect
+    end
+  end
+end

data/lib/webspeak/http_listener.rb

@@ -0,0 +1,100 @@
+
+require 'webrick'
+require 'logger'
+
+module WebSpeak
+  class HTTPListener
+    include WEBrick
+
+    def initialize(port=8080)
+      @port = port
+      @logger = Log::new
+      @logger.level = Logger::ERROR
+    end 
+
+    def listen
+      $s = HTTPServer.new(:Port => @port, :Logger => @logger, :AccessLog => [])
+      $s.mount("/", ParseRequestServlet)
+      puts "Listening on port #{@port} and path '/'"
+      trap("INT") { $s.shutdown }
+      $s.start
+    end
+
+  end
+  
+  class ParseRequestServlet < WEBrick::HTTPServlet::AbstractServlet
+  
+  # def self.query_parsers
+  #   @query_parsers ||= []
+  # end
+  # 
+  # def self.parse_query(&parse_function)
+  #   raise "parse_query requires a block." unless parse_function
+  #   query_parsers << parse_function
+  # end
+  # 
+    def do_POST(req, res)
+      return if req.path == '/favicon.ico'
+
+      result = StringIO.new
+      def result.newline(n=1)
+        n.times { puts "" }
+        self
+      end
+
+      # Parse out the 'query' params
+      query_params = {}
+      if req.request_uri.query
+        req.request_uri.query.split("&").each do |qp|
+          name, value = qp.split("=", 2)
+          query_params[name] = value
+        end
+      end
+
+      result.newline.puts(
+      "# use <something>",
+      "",
+      "host '<your server>'",
+      "port 8080",
+      "path '#{req.request_uri.path}'",
+      "")
+
+      query_params.each do |name, value|
+        result.puts("query_param '#{name}' => '#{value}'")
+      end
+
+      headers_to_ignore = ["cookie", "content-length", "host"]
+
+      result.newline(2)
+      result.puts("# Some of these are probably not needed")
+      result.puts("# and can be safely removed for brevity.")
+      req.header.each do |header,values|
+        break if headers_to_ignore.include? header.downcase
+        values.each {|val| result.puts "header '#{header}' => '#{val}'"}
+      end
+      result.newline(2)
+      # 
+      #     ParseRequestServlet.query_parsers.each do |parser|
+      #       result.puts(parser.call(req.query))
+      #     end
+      #     result.newline(2)
+      #     
+      req.query.each do |name, value|
+        result.puts("param '#{name}' => '#{value}'")
+      end
+      result.newline(2)
+
+      req.cookies.each do |cookie|
+        result.puts("cookie '#{cookie.name}' => '#{cookie.value}'")
+      end
+      result.newline(2)
+
+      result.puts("post",
+      "")
+
+      res.body = result.string
+
+      @server.shutdown # we only listen to one request
+    end
+  end
+end