oddjob 1.6.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 38b952a30ef59eab2aecda48c84c792a02daff9e
+  data.tar.gz: 6d0f3456c227c1bef0888db3971a80671054ba1d
+SHA512:
+  metadata.gz: 71b6164c4462f00a4e7c6cb6385eec124b2d13aea477301ae205d4aac46ed288293ada192acc5499bfa106963ee2edca41e422da83bcd6f54dac620c55c09ef8
+  data.tar.gz: aab8882dd01c9585ec228f6a3ba481f9f746b0e906345bbef4fd7f3ae00817ce74fde44c3e9a38feffba4b58bcd8cc340934b26538165a138c3f4af582b8b68b

data/.gitignore

@@ -0,0 +1,7 @@
+*.swp
+.ruby-version
+.bundle
+vendor
+Gemfile.lock
+pkg
+doc

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Dependencies specified in oddjob.gemspec
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) Mike Fellows
+
+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,147 @@
+# oddjob #
+
+oddjob is a lightweight, command line controlled web server.  Built for
+development and testing purposes, it can be used to serve static content for
+local web development and has basic file upload capabilities.  It was initially
+created when web browsers  become more restrictive about displaying local files
+directly (*i.e.* file:// URLs).
+
+oddjob's file upload endpoint can be used directly via forms or ajax request you
+build yourself with a POST to the `/oj_upload` URL.  A basic file upload form
+is also available via a GET request to that same URL.  Upon upload the default
+behaviour is for the server to dump the entire upload POST request (header and
+body), followed by the contents of each uploaded file to STDOUT.  This is
+useful for small tests uploading text files, but if you need to upload larger
+or binary format files tell oddjob to save the files to a directory instead. If
+you upload and save the same file twice oddjob will not overwrite existing
+saved files, instead a unique name is generated by adding a number to the end
+of the file's name.
+
+It is easy to hack the oddjob script to build quick test jigs for web
+development. Sometimes using a simple test web server is easier than working
+with a full fledged development or production environment.  To hack the code
+download from the [github repo](https://github.com/MCF/oddjob) and run oddjob
+out of the included `bin` directory.
+
+## Installation ##
+
+oddjob is available as a ruby gem.  To install it for general command line
+use simply use gem like so:
+
+```sh
+gem install oddjob
+```
+
+In the unlikely event you would like it tied to a project add the following
+line to the project's Gemfile:
+
+```ruby
+gem 'oddjob'
+```
+
+And then execute:
+
+```sh
+bundle
+```
+
+You can also run oddjob directly from the git repo.  Clone the git repo and run
+oddjob directly from the repo's bin directory.
+
+## Usage ##
+
+Command line usage is:
+
+```
+oddjob [OPTIONS] [server_root]
+```
+
+Where the optional server_root argument will be the server's root directory.
+The default server root is the current working directory.
+
+The default file upload behaviour will print the contents of the HTTP POST
+request, and the contents of any uploaded files, to the server's STDOUT.  It is
+recommended that you only upload text files in this case.  If an output
+directory is specified all uploaded files are saved under their own names in
+this directory.  Pre-existing files are not overwritten, instead a number is
+added to the end of the new file names when saving.
+
+If a simulated network delay is specified the server will pause that many
+seconds before returning a response for file(s) uploaded to the file upload
+path: `/oj_upload`.
+
+The server will only respond to clients on localhost unless the `--allhosts`
+option is specified.  Be aware of the security implications of allowing any
+other host on your network to connect to the server if you use this option.
+
+An informational page is available at the `/oj_info` path that includes the
+command line usage.
+
+The default server port is 4400.
+
+Command line options:
+
+    -d, --delay=value                File upload simulated network delay
+    -a, --allhosts                   Allow connections from all hosts
+    -o, --output=value               Directory to save uploaded files
+    -p, --port=value                 Web server port to use
+        --version                    Display the version number and exit
+
+    -h, --help                       Display the usage message
+
+To stop oddjob use the normal interrupt key combination (usually Ctrl-C).
+
+## Examples ##
+
+```sh
+oddjob
+```
+
+Serves the files and directories in your current working directory at the
+`http://localhost:4400/` URL.  File upload is available at
+`http://localhost:4400/oj_upload`
+
+```sh
+oddjob -p 2222 -o ./uploads ./my-site
+```
+
+Serves the contents of the `./my-site` directory at the
+`http://localhost:2222/` URL, file upload is available at
+`http://localhost:2222/oj_upload` files are saved to the
+`./uploads` directory.
+
+## Environment ##
+
+oddjob is written in ruby and its only required dependency is a standard ruby
+install.  oddjob makes use of the built in ruby's
+[webrick](http://ruby-doc.org/stdlib-2.0.0/libdoc/webrick/rdoc/WEBrick.html)
+web server library.  No gems are required for running oddjob.  oddjob has been
+tested with ruby 1.8.7 and up.
+
+## Security ##
+
+By default oddjob serves to clients on localhost only (that is: browsers
+running on the same computer as oddjob).  If the `-a` option is used connections
+from any client on your network are allowed.  If you do not trust the users on
+your local network the `-a` option could be a security concern.  Anyone who can
+connect to your IP address can browse and download the files served by oddjob.
+
+oddjob will serve the contents of the directory specified on the command line,
+or the current working directory if no directory is specified. It does no
+filtering on the contents of the directory served, and the entire directory
+tree below the top level directory is available for browsing.
+
+## License ##
+
+oddjob is released under an [MIT style license](MIT-LICENSE).
+
+## Development ##
+
+After checking out the repo, run `bundle install` to install dependencies. Then, run
+`rake spec` to run the tests.  Oddjob can be run directly from the repo's bin
+directory for easy testing.
+
+## Contributing ##
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/MCF/oddjob.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/oddjob

@@ -0,0 +1,151 @@
+#!/usr/bin/env ruby
+
+#--
+# Copyright (c) Mike Fellows
+#
+# 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.
+#++
+
+begin
+  require 'rubygems'  # Ruby 1.8.7 compatible.
+  gem 'rake'
+rescue LoadError
+end
+
+begin
+  require 'oddjob'    # Installed as a gem.
+rescue LoadError
+  lib = File.expand_path('../lib', File.dirname( __FILE__))
+  $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+  require 'oddjob'    # Simply run from the repo, no gems.
+end
+
+def show_version
+  STDOUT.puts("Version: #{OddJob::VERSION}")
+  exit
+end
+
+def error(msg, suggest_usage = false)
+  STDERR.puts("ERORR: #{msg}")
+  STDERR.puts(" try the -h option for the command usage") if suggest_usage
+  exit 1
+end
+
+require 'optparse'
+
+opts = {}
+
+optparser = OptionParser.new do |o|
+  o.banner =  "Usage: #{File.basename($0)} [OPTIONS] [server_root]"
+  o.separator <<TXT
+
+Where the optional server_root argument will be the server's root directory.
+The default server root is the current working directory.
+
+The default file upload behaviour will print the contents of the HTTP POST
+request, and the contents of any uploaded files, to the server's STDOUT.  It is
+recommended that you only upload text files in this case.  If an output
+directory is specified all uploaded files are saved under their own names in
+this directory.  Pre-existing files are not overwritten, instead a number is
+added to the end of the new file names when saving.
+
+If a simulated network delay is specified the server will pause that many
+seconds before returning a response for file(s) uploaded to the file upload
+path: #{OddJob::UPLOAD_PATH}.
+
+The server will only respond to clients on localhost unless the --allhosts
+option is specified.  Be aware of the security implications of allowing any
+other host on your network to connect to the server if you use this option.
+
+An informational page is available at the #{OddJob::INFO_PATH} path.
+
+The default server port is #{OddJob::DEFAULT_PORT}.
+
+To stop the server use the normal interrupt key combination (usually Ctrl-C).
+
+TXT
+
+  o.on('-d', '--delay=value', Float,
+       'File upload simulated network delay') { |x| opts[:networkdelay] = x }
+  o.on('-a', '--allhosts',
+       'Allow connections from all hosts')    { opts[:allowall] = true }
+  o.on('-o', '--output=value', String,
+       'Directory to save uploaded files')    { |x| opts[:savedirectory] = x }
+  o.on('-p', '--port=value', Integer,
+       "Web server port to use")              { |x| opts[:port] = x }
+  o.on('--version',
+       'Display the version number and exit') { show_version() }
+
+  o.separator("")
+
+  o.on('-h', '--help', 'Display this message') { puts(o); exit }
+end
+
+theRest = []
+begin
+  theRest =  optparser.parse(ARGV)
+rescue
+  error($!.to_s, true)
+end
+
+error("too many arguments given", true) if theRest.size > 1
+
+if theRest.size == 1
+  opts[:serverroot] = theRest.pop
+
+  unless File.directory?(opts[:serverroot])
+    error([
+      "directory to serve does not exist or is not ",
+      "a directory: #{opts[:serverroot]}"
+    ].join(''))
+  end
+
+  if opts[:savedirectory] and not File.directory?(opts[:savedirectory])
+    error([
+      "output directory does not exist or is not ",
+      "a directory: #{opts[:savedirectory]}"
+    ].join(''))
+  end
+end
+
+if opts.has_key?(:port) and (opts[:port] < 0 or opts[:port] > 65535)
+  error("port specified is invalid: #{opts[:port]}")
+end
+
+if opts.has_key?(:networkdelay) and opts[:networkdelay] < 0
+  error("simulated delay cannot be negative: #{opts[:networkdelay]}")
+end
+
+opts[:usagemessage] = optparser.to_s
+
+begin
+  OddJob.server(opts)
+rescue Errno::EADDRINUSE => e
+  error([
+    "Could not bind to the port because it is already in use, ",
+    "port: #{opts[:port].nil? ? OddJob::DEFAULT_PORT : opts[:port]}"
+  ].join("\n"))
+rescue Errno::EACCES => e
+  error([
+    "Could not bind to the port due to insufficient permission, usually",
+    "this happens when a non root user attempts to use a privileged port",
+    "(between 1 and 1000).  Port requested: #{opts[:port]}"
+  ].join("\n"))
+end

data/lib/oddjob/version.rb

@@ -0,0 +1,3 @@
+module OddJob
+  VERSION = '1.6.0'
+end

data/lib/oddjob.rb

@@ -0,0 +1,288 @@
+#--
+# Copyright (c) Mike Fellows
+#
+# 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.
+#++
+
+require 'webrick'
+require 'oddjob/version'
+
+module OddJob
+
+  UPLOAD_PATH = '/oj_upload'
+  INFO_PATH = '/oj_info'
+  DEFAULT_PORT = 4400
+
+  ##
+  # Start the oddjob server.
+  #
+  # +opts+ is a hash.  Allowed keys are:
+  #
+  # * +:serverroot+ - directory to serve (default CWD)
+  # * +:savedirectory+ - where to save uploads (default dump to STDOUT)
+  # * +:usagemessage+ - the command line usage message to dispaly on info page
+  # * +:allowall+ - serve to clients other than on localhost? (default false)
+  # * +:networkdelay+ - simulated network delay (default no delay).
+  # * +:port+ - port to use. (default is in DEFAULT_PORT module constant)
+  #
+  # Runs the server until a TERM or INT signal is received (e.g. ctrl-c from
+  # the command line).
+  def OddJob.server(opts)
+    defaults = {
+      :serverroot     => ".",
+      :savedirectory  => nil,
+      :usagemessage   => nil,
+      :allowall       => false,
+      :networkdelay   => 0,
+      :port           => DEFAULT_PORT
+    }
+
+    options = defaults.merge(opts)
+
+    # Add any missing MIME types (http://bugs.ruby-lang.org/issues/5365)
+    m_types = WEBrick::HTTPUtils::DefaultMimeTypes.dup
+    m_types['js']  = 'application/javascript' unless m_types.has_key?('js')
+    m_types['svg'] = 'image/svg+xml'          unless m_types.has_key?('svg')
+
+    server = WEBrick::HTTPServer.new(
+      :Port          =>  options[:port],
+      :BindAddress   =>  options[:allowall] ? '0.0.0.0' : '127.0.0.1',
+      :MimeTypes     =>  m_types,
+      :DocumentRoot  =>  options[:serverroot]
+    )
+
+    server.mount(
+      INFO_PATH,
+      Info,
+      options[:usagemessage]
+    )
+
+    server.mount(
+      UPLOAD_PATH,
+      FileUpload,
+      options[:networkdelay],
+      options[:savedirectory]
+    )
+
+    ['TERM', 'INT'].each { |signal| trap(signal){ server.shutdown } }
+
+    server.start
+  end
+
+  ##
+  # A very basic utility for rendering OddJob specific pages.
+
+  module HtmlRender
+
+    ##
+    # Wrap +content+ in the standard page layout.  +title+ is set as the HTML
+    # page's title.
+    def page(content, title)
+      [
+        "<!DOCTYPE html>",
+        "<head>",
+        "  <title>OJ #{title}</title>",
+        "  <style>",
+        "  body {font:100% arial,sans-serif; margin:1.5em 5em 4em 5em;}",
+        "  a {text-decoration:none; color:rgb(248,157,30)}",
+        "  a:hover {color:rgb(239,131,0);}",
+        "  .header {font-size:0.75em; float:right; margin-bottom: 2.0em;}",
+        "  </style>",
+        "</head>",
+        "<html><body>",
+        "  <div class=\"header\">",
+        "    <a href=\"https://github.com/MCF/oddjob\">OddJob on github</a>",
+        "  </div>",
+        "  <div style=\"clear:both;\"></div>",
+           content.kind_of?(Array) ? content.join("\n") : content,
+        "</body></html>",
+      ].join("\n")
+    end
+  end
+
+  ##
+  # Webrick servlet for creating the information page.
+
+  class Info < WEBrick::HTTPServlet::AbstractServlet
+    include HtmlRender
+
+    ##
+    # Standard servlet initialization function with an additional
+    # +cmd_usage+ argument for specifying the command line usage
+    # of the OddJob module's calling entity.
+    def initialize(server, cmd_usage, *options)
+      @usage = cmd_usage
+      super(server, options)
+    end
+
+    ##
+    # Respond to get request, returns informational page.
+    def do_GET(request, response)
+      response.status = 200
+      response['Content-Type'] = "text/html"
+      response.body = info_page
+    end
+
+    protected
+
+    ##
+    # Render the HTML for the informational page.
+    def info_page
+      html = [
+        "  <h1>#{File.basename($0)}</h1>",
+        "  <p>Version: <strong>#{VERSION}</strong></p>"
+      ]
+      html << "  <pre>#{@usage}</pre>" unless @usage.nil?
+      page(html, "Info")
+    end
+
+  end
+
+  ##
+  # Webrick servlet for upload pages.
+
+  class FileUpload < WEBrick::HTTPServlet::AbstractServlet
+    include HtmlRender
+
+    ##
+    # Standard servlet initialization function with additional arguments.
+    # 
+    # +delay+ is the seconds of simulated network delay to wait before
+    # responding after an upload request.
+    #
+    # +save_directory+ is the the directory location to save uploaded files.
+    # If +save_directory+ is set to nil uploaded files are not save, instead
+    # the entire http request is printed on STDOUT, followed by the name and
+    # contents of each file.  Generally only useful for small and non-binary
+    # files.
+    def initialize(server, delay, save_directory, *options)
+      @simulated_delay = delay
+      @save_directory = save_directory
+      super(server, options)
+    end
+
+    ##
+    # Handles webrick post request when uploading one or more files via a
+    # standard HTML form submission.  The form should include an input of type
+    # 'file'. See the page produced by the do_GET method for an example form.
+    def do_POST(request, response)
+
+      if @save_directory.nil?   # Request to server STDOUT.
+        puts "-- BEGIN File Upload POST Request --"
+        puts request
+        puts "-- END File Upload POST Request --"
+      end
+
+      all_files = Array.new
+      ['file', 'file[]'].each do |name|
+        if request.query[name]
+          request.query[name].each_data do |data|
+
+            all_files.push(data.filename)
+
+            if @save_directory.nil? # File contents to server STDOUT.
+              puts "== BEGIN #{data.filename} Contents =="
+              puts data.to_s
+              puts "== END #{data.filename} Contents =="
+            else
+              output_name = unique_name(data.filename, @save_directory)
+              File.open(output_name, "w"){|f| f.print(data.to_s)}
+              puts "#{data.filename} uploaded, saved to #{output_name}"
+            end
+          end
+        end
+      end
+
+      response.status = 200
+      response['Content-type'] = 'text/html'
+      response.body = uploaded_page(all_files)
+
+      sleep(@simulated_delay)
+    end
+
+    ##
+    # Serves a simple file upload form.  Uploads submitted are handled by this
+    # class' +do_Post+ method.
+    def do_GET(request, response)
+      response.status = 200
+      response['Content-type'] = 'text/html'
+      response.body = uploader_page
+    end
+
+    protected
+
+    ##
+    # Finds a unique name in the same directory for the given file.
+    #
+    # The uploaded file will be renamed if a file by that name already exists.
+    # An index number is added to the file's base name to make it unique.  For
+    # example if test.txt already existed then test_1.txt would be checked,
+    # followed by test_2.txt, and so on.
+    def unique_name(desired_name, save_directory)
+      ext = File.extname(desired_name)
+      base = File.basename(desired_name, ext)
+
+      final_base = full_base = File.join(save_directory, base)
+      i = 1
+      while(File.exist?(final_base + ext))
+        final_base = "#{full_base}_#{i}"
+        i += 1
+      end
+
+      final_base + ext
+    end
+
+    ##
+    # Returns a string holding the full HTML page with the file upload form.
+    def uploader_page
+      html = [
+        "<h1>Uploader</h1>",
+        "<form action='' method='POST' enctype='multipart/form-data'>",
+        "  <p>",
+        "    Select file(s) to upload:",
+        "    <br><br>",
+        "    <input type='file' name='file' multiple='true'>",
+        "    <br><br>",
+        "    <input type='submit'>",
+        "  </p>",
+        "</form>",
+      ]
+
+      page(html, "Uploader")
+    end
+
+    ##
+    # Returns a string holding the result of the upload page submission.
+    #
+    # +names+ is an array of the uploaded file names.  These are names
+    # as submitted.  Saved names may be different to avoid overwritting.
+    def uploaded_page(names)
+      html = [
+        "<h1>Results</h1>",
+        "<p>Uploaded:",
+        "  <strong>#{names.join("</strong>, <strong>")}</strong>",
+        "</p>",
+        "<p><a href=''>Return to upload page</a></p>",
+      ]
+
+      page(html, "Upload Results")
+    end
+  end
+
+end

data/oddjob.gemspec

@@ -0,0 +1,40 @@
+# coding: utf-8
+
+lib = File.expand_path('./lib', File.dirname( __FILE__))
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'oddjob/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'oddjob'
+  spec.version       = OddJob::VERSION
+  spec.authors       = ['Mike Fellows']
+  spec.email         = ['Mike.Fellows@shaw.ca']
+
+  spec.summary       = 'OddJob is simple command line driven web server'
+  spec.description   = <<TXT
+Oddjob is a simple command line driver web server, written in ruby and
+utilizing ruby's built in web server webrick.  It is meant to be a test and
+development tool, suitable for static content from a local directory.
+
+Oddjob also provides basic file upload capabilities (single or multi-file
+upload).  This includes the ability to save uploaded files locally.
+
+As a stand alone application the server is quick and convenient application
+for web developers working with static files.  Or get a copy of the source and
+add in new endpoints for simple tests as needed.
+TXT
+
+  spec.homepage      = 'https://github.com/MCF/oddjob'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'bin'
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+  spec.extra_rdoc_files = ['README.md', 'MIT-LICENSE']
+  spec.rdoc_options  = ['--main', 'README.md']
+
+  spec.add_development_dependency('bundler', '~> 1.10')
+  spec.add_development_dependency('rake', '~> 10.0')
+  spec.add_development_dependency('rspec')
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: oddjob
+version: !ruby/object:Gem::Version
+  version: 1.6.0
+platform: ruby
+authors:
+- Mike Fellows
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-02-13 00:00:00.000000000 Z
+dependencies:
+- !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: rspec
+  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: |
+  Oddjob is a simple command line driver web server, written in ruby and
+  utilizing ruby's built in web server webrick.  It is meant to be a test and
+  development tool, suitable for static content from a local directory.
+
+  Oddjob also provides basic file upload capabilities (single or multi-file
+  upload).  This includes the ability to save uploaded files locally.
+
+  As a stand alone application the server is quick and convenient application
+  for web developers working with static files.  Or get a copy of the source and
+  add in new endpoints for simple tests as needed.
+email:
+- Mike.Fellows@shaw.ca
+executables:
+- oddjob
+extensions: []
+extra_rdoc_files:
+- README.md
+- MIT-LICENSE
+files:
+- ".gitignore"
+- Gemfile
+- MIT-LICENSE
+- README.md
+- Rakefile
+- bin/oddjob
+- lib/oddjob.rb
+- lib/oddjob/version.rb
+- oddjob.gemspec
+homepage: https://github.com/MCF/oddjob
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+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.4.5
+signing_key: 
+specification_version: 4
+summary: OddJob is simple command line driven web server
+test_files: []