serve 0.9.0

data.tar.gz.sig

@@ -0,0 +1 @@
+SQ��!��꾩��:3��;ar�����X �O;`X�JhtE�VP�b�w��%զh��n(<
���,=ѝ���ydba�s�ҿ�wGY�ָC����u_83[�w	�A���`w�*����w�f�N��;��v���^V�wՠ��
�tR ,3Lj0v�~U�
H��[�&��:�-y���S�����C���y����|O�&��8���L��pTFn�+Gt����`�^��b��	M�f˿M�

data/History.txt

@@ -0,0 +1,3 @@
+== 0.9.0 (September 17, 2007)
+
+* Initial release

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2007 John W. Long
+
+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,22 @@
+History.txt
+License.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/serve
+config/hoe.rb
+config/requirements.rb
+lib/serve.rb
+lib/serve/version.rb
+lib/webrick/extensions.rb
+log/debug.log
+script/destroy
+script/generate
+setup.rb
+spec/serve_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+tasks/deployment.rake
+tasks/environment.rake
+tasks/rspec.rake
+tasks/website.rake

data/README.txt

@@ -0,0 +1,64 @@
+== What is Serve?
+
+Serve is a small Ruby script that makes it easy to start up an HTTP server
+in any directory. This is ideal for everything from HTML prototyping to simple
+file sharing.
+
+
+== Usage
+
+At a command prompt all you need to type to start serve is:
+
+  $ serve
+
+This will launch a WEBrick server which you can access from any Web browser at
+the following address:
+
+  http://localhost:3000
+
+Once the server is going it will output a running log of its activity. To
+stop the server at any time, type CTRL+C at the command prompt. By default the
+serve command serves up files from the current directory. To change this
+behavior, `cd` to the appropriate directory before starting serve.
+
+
+== Advanced Options
+
+The serve command automatically binds to 0.0.0.0 (localhost) and uses port
+3000 by default. To serve files over a different IP (that is bound to your
+computer) or port specify those options on the command line:
+
+  $ serve 4000               # a custom port
+
+  $ serve 192.168.1.6        # a custom IP
+
+  $ serve 192.168.1.6:4000   # a custom IP and port
+
+
+== Rails Applications
+
+For your convenience if the file "script/server" exists in the current
+directory the serve command will start that instead of launching a WEBrick
+server. You can specify the environment that you want to start the server
+with as an option on the command line:
+
+  $ serve production         # start script/server in production mode
+
+
+== Installation and Setup
+
+It is recommended that you install serve via RubyGems:
+
+  $ sudo gem install serve
+
+
+== License
+
+Serve is released under the MIT license and is copyright (c) John W. Long.
+A copy of the MIT license can be found in the LICENSE.txt file.
+
+
+Enjoy!
+
+--
+John Long :: http://wiseheartdesign.com

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/serve

@@ -0,0 +1,73 @@
+#!/usr/bin/env ruby
+
+lib = File.dirname(__FILE__) + '/../lib'
+if File.file?(lib + '/serve/version.rb')
+  $LOAD_PATH << lib
+else
+  require 'rubygems'
+  gem 'serve'
+end
+require 'serve'
+
+args = ARGV.join(' ')
+args.gsub!(%r{http://}, '')
+args = args.split(/[ :]/).compact
+
+help = args.delete('--help') || args.delete('-h') || false
+version = args.delete('--version') || args.delete('-v') || false
+environment = args.delete('production') || args.delete('test') || args.delete('test') || 'development'
+port = args.pop || 3000
+address = args.pop || '0.0.0.0'
+script = Dir.pwd + '/script/server'
+
+if args.size > 0
+  puts "invalid arguments"
+  puts ""
+  help = true
+end
+
+case
+when version
+  puts "Serve #{Serve.version}"
+when help
+  program = File.basename($0)
+  puts "Usage:"
+  puts "  #{program} [port] [environment]"
+  puts "  #{program} [address:port] [environment]"
+  puts "  #{program} [options]"
+  puts "  "
+  puts "Description:"
+  puts "  Starts a WEBrick server on the specified address and port with its document "
+  puts "  root set to the current working directory. By default the command uses "
+  puts "  0.0.0.0 for the address and 3000 for the port. This means that once the "
+  puts "  command has been started you can access the documents in the current "
+  puts "  directory with any Web browser at"
+  puts "  "
+  puts "    http://localhost:3000/"
+  puts "  "
+  puts "  If the Rails command script/server exists in the current directory the "
+  puts "  script will start that instead with the specified environment or the "
+  puts "  development environment if none is specified."
+  puts "  "
+  puts "  If the haml, redcloth, or bluecloth gems are installed the command can serve "
+  puts "  Haml, Sass, Textile, and Markdown for documents with haml, sass, textile, "
+  puts "  and markdown file extensions."
+  puts "  "
+  puts "Options:"
+  puts "  -h, --help      Show this message and quit."
+  puts "  -v, --version   Show the program version number and quit."
+else
+  unless File.file?(script) and File.executable?(script)
+    server = Serve::Server.new(
+      :Port => port,
+      :BindAddress => address,
+      :DocumentRoot => Dir.pwd,
+      :DirectoryIndex => %w(index.html index.txt index.text index.haml index.textile index.markdown),
+      :AppendExtensions => %w(html txt text haml textile markdown)
+    )
+    trap("INT") { server.shutdown }
+    server.start
+  else
+    system "#{script} -p #{port} -b #{address} -e #{environment}"
+  end
+end

data/config/hoe.rb

@@ -0,0 +1,70 @@
+require 'serve/version'
+
+AUTHOR = 'John W. Long'  # can also be an array of Authors
+EMAIL = "me@johnwlong.com"
+DESCRIPTION = "Serve is a small Ruby script that makes it easy to start up a WEBrick server in any directory. This is ideal for everything from HTML prototyping to simple file sharing."
+GEM_NAME = 'serve' # what ppl will type to install your gem
+RUBYFORGE_PROJECT = 'serve' # 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 = "jlong"
+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 = Serve::VERSION::STRING + (REV ? ".#{REV}" : "")
+RDOC_OPTS = ['--quiet', '--title', 'serve documentation',
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README.txt",
+    "--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 'serve'

data/lib/serve.rb

@@ -0,0 +1,94 @@
+require 'serve/version'
+require 'webrick/extensions'
+
+module Serve #:nodoc:
+  class FileTypeHandler < WEBrick::HTTPServlet::AbstractServlet #:nodoc:
+
+    def self.extension(extension)
+      WEBrick::HTTPServlet::FileHandler.add_handler(extension, self)
+    end
+
+    def initialize(server, name)
+      super
+      @script_filename = name
+    end
+
+    def do_GET(req, res)
+      begin
+        data = open(@script_filename){|io| io.read }
+        res.body = parse(data)
+        res['content-type'] = content_type
+      rescue StandardError => ex
+        raise
+      rescue Exception => ex
+        @logger.error(ex)
+        raise WEBrick::HTTPStatus::InternalServerError, ex.message
+      end
+    end
+
+    alias do_POST do_GET
+
+    protected
+
+      def content_type
+        'text/html'
+      end
+    
+      def parse(string)
+        string.dup
+      end
+
+  end
+
+  class TextileHandler < FileTypeHandler #:nodoc:
+    extension 'textile'
+
+    def parse(string)
+      require 'redcloth'
+      "<html><body>#{ RedCloth.new(string).to_html }</body></html>"
+    end
+  end
+
+  class MarkdownHandler < FileTypeHandler #:nodoc:
+    extension 'markdown'
+
+    def parse(string)
+      require 'bluecloth'
+      "<html><body>#{ BlueCloth.new(string).to_html }</body></html>"
+    end
+  end
+
+  class HamlHandler < FileTypeHandler #:nodoc:
+    extension 'haml'
+
+    def parse(string)
+      require 'haml'
+      engine = Haml::Engine.new(string,
+        :attr_wrapper => '"',
+        :filename => @script_filename
+      )
+      engine.render 
+    end
+  end
+
+  class SassHandler < FileTypeHandler #:nodoc:
+    extension 'sass'
+
+    def parse(string)
+      require 'sass'
+      engine = Sass::Engine.new(string,
+        :style => :expanded,
+        :filename => @script_filename
+      )
+      engine.render 
+    end
+
+    def content_type
+      'text/css'
+    end
+  end
+  
+  class Server < WEBrick::HTTPServer #:nodoc:
+  end
+  
+end

data/lib/serve/version.rb

@@ -0,0 +1,13 @@
+module Serve #:nodoc:
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 9
+    TINY  = 0
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+  
+  def self.version
+    VERSION::STRING
+  end
+end

data/lib/webrick/extensions.rb

@@ -0,0 +1,33 @@
+require 'webrick'
+
+module Serve #:nodoc:
+  module FileHandlerExtensions
+    
+    def self.included(base)
+      base.extend(self)
+      base.class_eval do
+        alias :search_file_without_auto_appending :search_file
+        alias :search_file :search_file_with_auto_appending
+      end
+    end
+    
+    def search_file_with_auto_appending(req, res, basename)
+      if result = search_file_without_auto_appending(req, res, basename)
+        return result
+      end
+      extensions = @config[:AppendExtensions]
+      basename = $1 if basename =~ %r{^(.*?)/$}
+      if extensions
+        extensions.each do |ext|
+          if result = search_file_without_auto_appending(req, res, "#{basename}.#{ext}")
+            return result
+          end
+        end
+      end
+      return nil
+    end
+    
+  end
+end
+
+WEBrick::HTTPServlet::FileHandler.class_eval { include Serve::FileHandlerExtensions }

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = 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]
+RubiGen::Scripts::Destroy.new.run(ARGV)