waitress-core 0.0.1

data/lib/waitress/handlers/libhandler.rb

@@ -0,0 +1,58 @@
+module Waitress
+
+  # The LibraryHandler is used to handle requests to the VHost regarding the
+  # libraries to be loaded by other Handlers and .wrb files. This will take any
+  # requests to /libraries (or whatever the user has set it to) to load libraries
+  class LibraryHandler < Handler
+
+    attr_accessor :priority
+
+    def initialize libraries, libdir, liburi, vhost
+      @priority = 150
+      @vhost = vhost
+      @libraries, @libdir, @liburi = libraries, File.expand_path(libdir), liburi
+      FileUtils.mkdir_p(@libdir) unless File.exist?(@libdir)
+
+      @libraries.each do |name, lib|
+        l = {}
+        d = dirType(lib[:bindtype])
+        matches = Dir["#{d}/**/*.#{lib[:bindtype].to_s}"].select { |x| (x =~ lib[:pattern]) != nil }
+        if matches.length > 0
+          l[:file] = matches[0]
+          l[:type] = lib[:bindtype]
+        else
+          l = nil
+        end
+        @libraries[name] = l
+      end
+
+      [:css, :js].each do |k|
+        d = dirType k
+        FileUtils.mkdir_p(d) unless File.exist?(d)
+
+        Dir["#{d}/**/*.#{k.to_s}"].each do |fl|
+          @libraries[File.basename(fl).to_sym] = { :file => fl, :type => k }
+        end
+      end
+    end
+
+    def dirType k
+      File.join(@libdir, k.to_s)
+    end
+
+    def respond? request, vhost
+      path = request.path
+      return false unless path.start_with?("/#{@liburi}/")
+      name = path.sub("/#{@liburi}/", "").to_sym
+      @libraries.include?(name)
+    end
+
+    def serve request, response, client, vhost
+      path = request.path
+      name = path.sub("/#{@liburi}/", "").to_sym
+      lib = @libraries[name]
+      Waitress::Chef.serve_file request, response, client, vhost, lib[:file]
+    end
+
+  end
+end

data/lib/waitress/kernel.rb

@@ -0,0 +1,182 @@
+# The Kernel Module provides global methods that will provide the 'builtins' for .wrb files
+# and handlers. This is used to prevent verbose access of a namespace like Waitress::Global,
+# and instead provide them here. Because requests are handled in new Processes, these values
+# will change in each request and will not interfere.
+module ::Kernel
+
+  # The +Waitress::Response+ object being used
+  def response_object
+    $RESPONSE
+  end
+
+  # The +Waitress::Request+ object being used
+  def request_object
+    $REQUEST
+  end
+
+  # Prepare the Kernel, by linking global variables
+  def kernel_prepare
+    $METHOD = get_method
+    $HEADERS = get_headers
+    $PATH = get_path
+    $URI = get_uri
+    $BODY = get_body
+  end
+
+  # Automatically load a library header into this file in the form of HTML.
+  # This will load a library in the VHost's libs/ folder, or any lib defined in the
+  # VHost's config.rb file with the name given. JS libraries will be linked with the
+  # <script> tag, whilst css files will be linked with the <link rel="stylesheet">
+  # tag. This is the recommended way of handling library loading.
+  # Params:
+  # +name+:: The name of the lib (the filename), or the name of the library as bound
+  # in the config.rb file.
+  def lib name
+    name = name.to_sym
+    type = $VHOST.libraries[name][:type]
+    libhome = $VHOST.liburi
+    if type == :js
+      echo "<script type='text/javascript' src='/#{libhome}/#{name}'></script>"
+    elsif type == :css
+      echo "<link rel='stylesheet' href='/#{libhome}/#{name}'></link>"
+    end
+  end
+
+  # Automatically load a Library Combo into this file. This will consecutively load
+  # all the libraries bound to the combination with the given name as defined in the
+  # VHost's config.rb file. This will call lib() for each of these libraries.
+  # Params:
+  # +name+:: The name of the combo to load
+  def combo name
+    name = name.to_sym
+    combo_arr = $VHOST.combos[name]
+    combo_arr.each { |n| lib(n) }
+  end
+
+  # Include another .wrb, .rb or any other file in the load path of the VHost into this
+  # file. If this file is .wrb or .rb, it will be evaluated. If it is another type of file
+  # (e.g. html), it will be directly echoed to the output buffer
+  # Params:
+  # +filename+:: The name of the file, relative to the loadpath
+  def includes filename
+    Waitress::Chef.include_file filename
+  end
+
+  # Include another .wrb, .rb or any other file in this file. If this file is
+  # .wrb or .rb, it will be evaluated. If it is another type of file
+  # (e.g. html), it will be directly echoed to the output buffer
+  # Params:
+  # +filename+:: The absolute filename of the file to load, anywhere in the filesystem
+  def includes_file filename
+    Waitress::Chef.include_absfile filename
+  end
+
+  # Returns a Hash of the GET query of the request. This may be an empty array
+  # if querystring was present
+  def get
+    request_object.get_query
+  end
+
+  # Returns a Hash of the POST query of the request. This may be an empty array
+  # if the body is not a valid querystring, or an exception raised if there was
+  # an error in parsing.
+  def post
+    request_object.post_query
+  end
+
+  # Get a header from the HTTP Request. This will fetch the header by the given
+  # name from the request object. Keep in mind that in requests, Headers are fully
+  # capitalized and any hyphens replaced with underscores (e.g. Content-Type becomes
+  # CONTENT_TYPE)
+  def get_header name
+    request_object.headers[name]
+  end
+
+  # Return the full list of headers available in the request object.
+  def get_headers
+    request_object.headers
+  end
+
+  # Returns the HTTP method that was used to retrieve this page (GET, POST, UPDATE,
+  # DELETE, PUT, etc)
+  def get_method
+    request_object.method
+  end
+
+  # Get the path of this request. This is after a URL rewrite, and does not contain
+  # a querystring. Be careful with these, as they start with a "/" and if not joined
+  # correctly can cause issues in the root of your filesystem (use File.join) if you
+  # plan to use this
+  def get_path
+    request_object.path
+  end
+
+  # Get the URI of this request. Unlike the path, the URI is not modified after a rewrite,
+  # and does contain a querystring. Use this if you want the *original* path and query
+  # of the request before it was rewritten
+  def get_uri
+    request_object.uri
+  end
+
+  # Get the request body. In most cases, this will be blank, but for POST requests it may
+  # contain a querystring, and for PUT and UPDATE methods it may contain other data
+  def get_body
+    request_object.body
+  end
+
+  # Get the querystring object as a string before it is parsed
+  def get_querystring
+    request_object.querystring
+  end
+
+  # Set a response header. This will be joined when writing the response with the delimiter ": "
+  # as in regular HTTP Protocol fashion.
+  # Params:
+  # +name+:: The name of the header, e.g. "Content-Type"
+  # +value+:: The value of the header, e.g. "text/html"
+  def set_header name, value
+    response_object.header name, value
+  end
+
+  # Set the content-type of the response. This is a shortcut to the Content-Type
+  # header and takes the full content-type (not fileextension) as an argument
+  # Params:
+  # +raw_type+:: The mime type of the content, e.g. "text/html"
+  def content_type raw_type
+    response_object.mime_raw raw_type
+  end
+
+  # Set the content-type of the response. This is a shortcut to the Content-Type
+  # header, and will also lookup the fileextension in the +Waitress::Util+ mime-type
+  # lookup.
+  # Params:
+  # +extension+:: The file extension to map to a mimetype, e.g. ".html"
+  def file_ext extension
+    response_object.mime extension
+  end
+
+  # Write a string to the output buffer. This will write directly to the body of the
+  # response, similar to what 'print()' does for STDOUT. Use this to write data to the
+  # output stream
+  def echo obj
+    str = obj.to_s
+    write str
+  end
+
+  # Write a string to the output buffer, followed by a newline. Similar to echo(),
+  # this will write to the output buffer, but also adds a "\n". This does to the
+  # client output as 'puts()' does to STDOUT. Use this to write data to the output
+  # stream
+  def println obj
+    echo(obj.to_s + "\n")
+  end
+
+  # Write a set of bytes directly to the output stream. Use this if you don't want
+  # to cast to a string as echo() and println() do. 
+  def write bytes
+    r = response_object
+    r.body "" if r.body_io.nil?
+    r.body_io.write bytes
+  end
+
+end

data/lib/waitress/parse/query.rb

@@ -0,0 +1,60 @@
+module Waitress
+  # A lot of this class uses methods from Rack::QueryParser in order to Parse
+  # a given QueryString into a Hash of key/value pairs
+  class QueryParser
+    require 'uri'
+
+    DEFAULT_SEP = /[&;] */n
+
+    # Unescape a HTTP URL to regular text. e.g. %20 becomes a space (" ")
+    def self.unescape str, enc=Encoding::UTF_8
+      URI.decode_www_form_component(str, enc)
+    end
+
+    # Parse the given QueryString into a hash of key/value pairs
+    def self.parse qs
+      return {} if qs.nil? || qs.empty?
+      results = {}
+      (qs || '').split(DEFAULT_SEP).each do |p|
+        k, v = p.split('='.freeze, 2).map! { |s| unescape(s) }
+
+        normalize results, k, v
+      end
+      results
+    end
+
+    def self.normalize hash, name, v
+      name =~ %r(\A[\[\]]*([^\[\]]+)\]*)
+      k = $1 || ''
+      after = $' || ''
+
+      return if k.empty?
+
+      if after == ""
+        hash[k] = v
+      elsif after == "["
+        hash[name] = v
+      elsif after == "[]"
+        hash[k] ||= []
+        raise TypeError, "expected Array (got #{hash[k].class.name}) for param `#{k}'" unless hash[k].is_a?(Array)
+        hash[k] << v
+      elsif after =~ %r(^\[\]\[([^\[\]]+)\]$) || after =~ %r(^\[\](.+)$)
+        child_key = $1
+        hash[k] ||= []
+        raise TypeError, "expected Array (got #{hash[k].class.name}) for param `#{k}'" unless hash[k].is_a?(Array)
+        if hash[k].last.is_a?(Hash) && !hash[k].last.key?(child_key)
+          normalize(hash[k].last, child_key, v)
+        else
+          hash[k] << normalize({}, child_key, v)
+        end
+      else
+        hash[k] ||= {}
+        raise TypeError, "expected Hash (got #{hash[k].class.name}) for param `#{k}'" unless hash[k].is_a?(Hash)
+        hash[k] = normalize_params(hash[k], after, v)
+      end
+
+      hash
+    end
+
+  end
+end

data/lib/waitress/request.rb

@@ -0,0 +1,45 @@
+module Waitress
+  # The request class is used to represent a HTTP request by a client. This includes
+  # all the headers sent to the server by the client, request URI and those properties
+  # parsed by Mongrel, including the Path and QueryString. GET and POST queries are to
+  # be parsed on-request by the handler or .wrb file as to not waste CPU resources.
+  class Request
+
+    attr_accessor :method
+    attr_accessor :path
+    attr_accessor :uri
+    attr_accessor :querystring
+    attr_accessor :http_version
+    attr_accessor :body
+    attr_accessor :headers
+
+    def initialize method, path, uri, query, http_version, body, headers
+      @method = method
+      @path = Waitress::QueryParser.unescape(path)
+      @uri = Waitress::QueryParser.unescape(uri)
+      @querystring = query
+      @http_version = http_version
+      @body = body
+      @headers = headers
+      @marks = {}
+    end
+
+    # The GET query for the request in the form of a hash. This is parsed on-request
+    def get_query
+      @get ||= Waitress::QueryParser.parse(@querystring)
+      @get
+    end
+
+    # The POST query for the request in the form of a hash. This is parsed on-request
+    def post_query
+      @post ||= Waitress::QueryParser.parse(@body)
+      @post
+    end
+
+    def to_s
+      m = lambda { |a,x| x.nil? ? "" : "#{a}=#{x.inspect}" }
+      "#<#{self.class} method=#{@method} path=#{@path} #{m.call("query", @query)}>"
+    end
+
+  end
+end

data/lib/waitress/resources/default_config.rb

@@ -0,0 +1,52 @@
+# This is the configuration for your waitress server, accepting connections on port '2910'
+Waitress.configure!(2910) do |w|
+
+  # You can run regular Ruby Code in here, too!
+  @home = "~/.waitress/www/"
+  def fl file
+    File.join(@home, file)
+  end
+
+  # This is your main Virtual Host, accepting connections to 'example.mysite.com'
+  w.host(/example.mysite.com/) do |host|
+    # This is where your public documents and pages are stored
+    host.root fl("example/http")
+
+    # This is where your non-public includes are stored
+    host.includes fl("example/rb")
+
+    # This will show up when a 404 error occurs
+    # host.set_404 fl("example/http/404.html")
+
+    # Want to rewrite a URL? No problem.
+    host.rewrite /some_url/, "some_other_url"
+    host.rewrite /capture_group_(\d)/, "capture/group\\1"
+
+    # Bind_Lib will allow you to automatically import lib tags into .wrb files
+    # Before they are sent to the client.
+    host.bind_lib /jquery.*/, :js, "jquery"
+    host.bind_lib /boostrap.*/, :css, "boots"
+
+    # Use combos to chain together libraries into a collection
+    host.combo "all-lib", "jquery", "boots"
+
+    # Change this to change where you store your libraries
+    host.libdir fl("libs")
+
+    # Change this to choose what URI the libraries are linked
+    # to (yoursite.com/libraries/library_name)
+    host.liburi "libraries"
+  end
+
+  # This is your other Virtual Host, accepting connections to any domain.
+  # The '0' represents the priority, with the default being 50. Higher priority
+  # Hosts will be chosen if the request matches multiple Hosts.
+  w.host(/.*/, 0) do |host|
+    # This is where your public documents and pages are stored
+    host.root fl("main/http")
+
+    # This is where your non-public includes are stored
+    host.includes fl("main/rb")
+  end
+
+end

data/lib/waitress/resources/http/404.html

@@ -0,0 +1,18 @@
+<html>
+  <head>
+    <title> 404 - Page Not Found </title>
+    <link rel="stylesheet" href="/css/hack.css">
+    <link rel="stylesheet" href="/css/waitress.css">
+  </head>
+  <body>
+    <div id="maincontainer">
+      <div class="textcontainer">
+        <h1> 404 </h1>
+        <h2> You ordered something that wasn't on the menu </h2>
+      </div>
+      <div class="imgcontainer">
+        <img src="/img/404.png">
+      </div>
+    </div>
+  </body>
+</html>

data/lib/waitress/resources/http/css/hack.css

@@ -0,0 +1,37 @@
+/*!
+ *  Hack v2.013 - https://sourcefoundry.org/hack/
+ *  Licenses - Fonts: Hack Open Font License + Bitstream Vera license, CSS: MIT License
+ */
+/* FONT PATHS
+ * -------------------------- */
+@font-face {
+  font-family: 'Hack';
+  src: url('../fonts/eot/latin/hack-regular-latin-webfont.eot?v=2.013');
+  src: url('../fonts/eot/latin/hack-regular-latin-webfont.eot?#iefix&v=2.013') format('embedded-opentype'), url('../fonts/woff2/latin/hack-regular-latin-webfont.woff2?v=2.013') format('woff2'), url('../fonts/woff/latin/hack-regular-latin-webfont.woff?v=2.013') format('woff'), url('../fonts/web-ttf/latin/hack-regular-latin-webfont.ttf?v=2.013') format('truetype'), url('../fonts/svg/latin/hack-regular-latin-webfont.svg?v=2.013#hackregular') format('svg');
+  font-weight: 400;
+  font-style: normal;
+}
+
+@font-face {
+  font-family: 'Hack';
+  src: url('../fonts/eot/latin/hack-bold-latin-webfont.eot?v=2.013');
+  src: url('../fonts/eot/latin/hack-bold-latin-webfont.eot?#iefix&v=2.013') format('embedded-opentype'), url('../fonts/woff2/latin/hack-bold-latin-webfont.woff2?v=2.013') format('woff2'), url('../fonts/woff/latin/hack-bold-latin-webfont.woff?v=2.013') format('woff'), url('../fonts/web-ttf/latin/hack-bold-latin-webfont.ttf?v=2.013') format('truetype'), url('../fonts/svg/latin/hack-bold-latin-webfont.svg?v=2.013#hackbold') format('svg');
+  font-weight: 700;
+  font-style: normal;
+}
+
+@font-face {
+  font-family: 'Hack';
+  src: url('../fonts/eot/latin/hack-italic-latin-webfont.eot?v=2.013');
+  src: url('../fonts/eot/latin/hack-italic-latin-webfont.eot?#iefix&v=2.013') format('embedded-opentype'), url('../fonts/woff2/latin/hack-italic-latin-webfont.woff2?v=2.013') format('woff2'), url('../fonts/woff/latin/hack-italic-latin-webfont.woff?v=2.013') format('woff'), url('../fonts/web-ttf/latin/hack-italic-latin-webfont.ttf?v=2.013') format('truetype'), url('../fonts/svg/latin/hack-italic-latin-webfont.svg?v=2.013#hackitalic') format('svg');
+  font-weight: 400;
+  font-style: italic;
+}
+
+@font-face {
+  font-family: 'Hack';
+  src: url('../fonts/eot/latin/hack-bolditalic-latin-webfont.eot?v=2.013');
+  src: url('../fonts/eot/latin/hack-bolditalic-latin-webfont.eot?#iefix&v=2.013') format('embedded-opentype'), url('../fonts/woff2/latin/hack-bolditalic-latin-webfont.woff2?v=2.013') format('woff2'), url('../fonts/woff/latin/hack-bolditalic-latin-webfont.woff?v=2.013') format('woff'), url('../fonts/web-ttf/latin/hack-bolditalic-latin-webfont.ttf?v=2.013') format('truetype'), url('../fonts/svg/latin/hack-bolditalic-latin-webfont.svg?v=2.013#hackbolditalic') format('svg');
+  font-weight: 700;
+  font-style: italic;
+}