serveable 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 72c6629c8e364e6deab42b42b386c032f056645c
+  data.tar.gz: 89707e239b053f6707dbb446c0176472afab1d20
+SHA512:
+  metadata.gz: 46a28d12b8db9a58e16f8c232af102d08d47fdff96eed75545707a5d5ec38df26e90f64b1fc31b086cff24427924f656d0f123124dfd8487b7d48050a72f902f
+  data.tar.gz: 50311a4f39704a60f6710b274557b4e566a12755d140f376df8297a1bf924082f638b34d751f786736cc3dd3236de7e42e45b302708f5a95909ccbb92bd58f30

data/README.md

@@ -0,0 +1,22 @@
+# Serveable
+
+Serveable simplifies creating a [Rack][rack] mountable site. It contains a
+`Site` module and an `Item` module. These can be mixed into classes that expose
+the correct interface to turn them into easy Rack-fodder.
+
+See [`example/simple.rb`](examples/simple.rb) for a basic implementation.
+
+
+## That interface you speak of...
+
+A `Site` must implement the following:
+
+- `#each(&block)`, which enumerates `Item` type objects.
+
+An `Item` must implement the following:
+
+- `#contents`, that returns the contents;
+- `#url`, that returns the full url to serve at.
+
+
+[rack]: http://rack.github.com

data/Rakefile

@@ -0,0 +1,9 @@
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib' << 'spec'
+  t.pattern = 'spec/**/*_spec.rb'
+  t.verbose = true
+end
+
+task :default => :test

data/lib/serveable.rb

@@ -0,0 +1,51 @@
+module Serveable
+
+  # Include {Serveable::Site} into an object that responds to #each, which
+  # returns items that expose the same interface (or include) {Item}, to allow
+  # it to be run with Rack.
+  module Site
+
+    # @return [Array] Returns the payload for the given environment passed.
+    def call(env)
+      paths_equal = lambda do |a,b|
+        short = a.sub(/index\.html\Z/, '')
+        return a == b || short == b || short[0..-2] == b
+      end
+
+      found = Missing
+      each do |item|
+        if paths_equal.call(item.url, env['REQUEST_PATH'])
+          found = item
+        end
+      end
+
+      found.serve
+    end
+  end
+
+  # The Item module expects the object extending/class including it to respond
+  # to the #url and #content methods, it then defines the #serve method which is
+  # used by {Site}.
+  module Item
+
+    # @return [String] The contents of the Item to be served.
+    def contents; end
+
+    # @return [String] Full url (including /index.html) to the item.
+    def url; end
+
+    # @return [Array] Payload for rack. Contains, in order, the status, the
+    #   headers and the body.
+    def serve
+      mime = Rack::Mime.mime_type ::File.extname(url)
+      [200, {"Content-Type" => mime}, [contents]]
+    end
+  end
+
+  # The sole missing file is served when no matching item is found.
+  Missing = Object.new
+  def Missing.serve
+    [404, {}, ["404 not found"]]
+  end
+
+end

data/lib/serveable/version.rb

@@ -0,0 +1,3 @@
+module Serveable
+  VERSION = '0.0.2'
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: serveable
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Joshua Hawxwell
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-31 00:00:00.000000000 Z
+dependencies: []
+description: |2
+      Provides a module that allow you to easily incorporate a simple
+      'server -> site -> page' model on top of rack.
+email: m@hawx.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- LICENSE
+- lib/serveable.rb
+- lib/serveable/version.rb
+homepage: http://github.com/hawx/serveable
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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.0.14
+signing_key: 
+specification_version: 4
+summary: Minimal fuss rack server hooks.
+test_files: []
+has_rdoc: