low 0.0.2

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in brack.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,36 @@
+PATH
+  remote: .
+  specs:
+    low (0.0.2)
+      rack
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    bson (1.6.4)
+    bson_ext (1.6.4)
+      bson (~> 1.6.4)
+    diff-lcs (1.1.3)
+    mongo (1.6.4)
+      bson (~> 1.6.4)
+    rack (1.4.1)
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    rspec (2.10.0)
+      rspec-core (~> 2.10.0)
+      rspec-expectations (~> 2.10.0)
+      rspec-mocks (~> 2.10.0)
+    rspec-core (2.10.1)
+    rspec-expectations (2.10.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.10.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bson_ext
+  low!
+  mongo
+  rack-test
+  rspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Kevin Hyland
+
+MIT License
+
+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,4 @@
+low
+=====
+
+A utility library that never strays too far from the metal.

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'

data/lib/low/mongo.rb

@@ -0,0 +1,79 @@
+require 'mongo'
+
+module Low
+  # The `Mongo` module defines an interface for a Mongo helper
+  # class. It also includes two basic classes, `Local` and `Remote`.
+  module Mongo
+    # Simple access to a Mongo::Collection instance.
+    def [](collection)
+      db[collection]
+    end
+
+    # The environment's Mongo::DB instance.
+    def db
+      @db ||= connection.db(database)
+    end
+
+    # The environment's Mongo::Grid instance - a file store.
+    def grid
+      @grid ||= ::Mongo::Grid.new(db)
+    end
+
+    # The environment's Mongo::Connection instance.
+    def connection
+      @connection ||= ::Mongo::Connection.new(host)
+    end
+
+    # The host that `#connection` will use - either this or
+    # `#connection` should be overriden.
+    def host
+    end
+
+    # The database `#db` will use - must be overriden.
+    def database
+    end
+
+    # Force a new connection the next time one is needed
+    def reset_connection!
+      @grid = nil
+      @db = nil
+      @connection = nil
+    end
+
+    # For connecting to Mongo on localhost.
+    class Local
+      include Mongo
+
+      attr_reader :host, :database
+
+      # Specify the database upon initialization and
+      # assume that the host is localhost (unless told otherwise).
+      def initialize(database, host = nil)
+        @database = database
+        @host = host || 'localhost'
+      end
+    end
+
+    # For connecting to Mongo via a URI.
+    class Remote
+      include Mongo
+
+      attr_reader :uri
+
+      # Specify the remote URI upon initialization
+      def initialize(uri)
+        @uri = uri
+      end
+
+      # and use it to connect.
+      def connection
+        @connection ||= ::Mongo::Connection.from_uri(uri)
+      end
+
+      # The database can be extracted from the URI.
+      def database
+        uri.match(/.*\/(.*)$/)[1]
+      end
+    end
+  end
+end

data/lib/low/subdomain_map.rb

@@ -0,0 +1,37 @@
+module Low
+  # `SubdomainMap` is Rack middleware that delegates to other Rack apps based
+  # upon subdomain. It takes two arguments upon initialization:
+  #
+  # * `base`, the app to be called if there is no subdomain.
+  # * `map`, a hash that maps subdomain strings to apps.
+  class SubdomainMap
+    def initialize(base, map = {})
+      @base = base
+      @map = map
+    end
+
+    def call(env)
+      # If the `SERVER_NAME` environment variable has a subdomain
+      if env['SERVER_NAME'] =~ /(.*?)\.(?:.*)\..*/
+        subdomain = $1
+      end
+
+      if subdomain
+        # and we can find a corresponding app,
+        if app = @map[subdomain]
+          # call it and return the result.
+          app.call(env)
+
+        # Otherwise, return 403 Forbidden.
+        else
+          [403, {"Content-Type" => "text/plain"}, []]
+        end
+
+      # If there is no subdomain,
+      else
+        # call the base app and return the result.
+        @base.call(env)
+      end
+    end
+  end
+end

data/lib/low/version.rb

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

data/lib/low.rb

@@ -0,0 +1,6 @@
+require 'low/version'
+
+module Low
+  autoload :Mongo,        'low/mongo'
+  autoload :SubdomainMap, 'low/subdomain_map'
+end

data/low.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/low/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ['Kevin Hyland']
+  gem.email         = ['khy@me.com']
+  gem.description   = 'A low-level utility library.'
+  gem.summary       = 'A low-level utility library.'
+  gem.homepage      = ''
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = 'low'
+  gem.require_paths = ['lib']
+  gem.version       = Low::VERSION
+
+  gem.add_runtime_dependency 'rack'
+
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'rack-test'
+  gem.add_development_dependency 'mongo'
+  gem.add_development_dependency 'bson_ext'
+end

data/spec/low/mongo_spec.rb

@@ -0,0 +1,92 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Low::Mongo do
+  class MongoTest
+    include Low::Mongo
+
+    def host
+      'localhost'
+    end
+
+    def database
+      'low_test'
+    end
+  end
+
+  describe '#[]' do
+    it 'should be a convenience method for access a db collection' do
+      mongo = MongoTest.new
+      db = double('mongo database')
+      collection = double('mongo collection')
+      db.should_receive('[]').with('low_collection').and_return(collection)
+      mongo.stub db: db
+      mongo['low_collection'].should == collection
+    end
+  end
+
+  describe '#db' do
+    it 'should retrieve the specified #database from the connection' do
+      mongo = MongoTest.new
+      connection = double('mongo connection')
+      db = double('mongo database')
+      connection.should_receive(:db).with('low_test').and_return(db)
+      mongo.stub connection: connection
+      mongo.db.should == db
+    end
+  end
+
+  describe '#connection' do
+    it 'should get a new ::Mongo::Connection instance for the specified #host' do
+      mongo = MongoTest.new
+      connection = double('mongo connection')
+      ::Mongo::Connection.should_receive(:new).with('localhost').and_return(connection)
+      mongo.connection.should == connection
+    end
+  end
+end
+
+describe Low::Mongo::Local do
+  describe '#database' do
+    it 'should return the value specified at initialization' do
+      mongo = Low::Mongo::Local.new('low_test')
+      mongo.database.should == 'low_test'
+    end
+  end
+
+  describe '#host' do
+    it 'should return \'localhost\' if none was specified at initialization' do
+      mongo = Low::Mongo::Local.new('low_test')
+      mongo.host.should == 'localhost'
+    end
+
+    it 'should return the value specified at initialization' do
+      mongo = Low::Mongo::Local.new('low_test', '0.0.0.0')
+      mongo.host.should == '0.0.0.0'
+    end
+  end
+end
+
+describe Low::Mongo::Remote do
+  describe '#uri' do
+    it 'should return the value specified at initialization' do
+      mongo = Low::Mongo::Remote.new('mongodb://mongo.com')
+      mongo.uri.should == 'mongodb://mongo.com'
+    end
+  end
+
+  describe '#database' do
+    it 'should return a value extracted from the URI' do
+      mongo = Low::Mongo::Remote.new('mongodb://khy:secret@mongo.com/low_remote')
+      mongo.database.should == 'low_remote'
+    end
+  end
+
+  describe '#connection' do
+    it 'should pass uri to the ::Mongo::Connection.from_uri method' do
+      connection = double('mongo connection')
+      ::Mongo::Connection.should_receive(:from_uri).with('mongodb://mongo.com').and_return(connection)
+      mongo = Low::Mongo::Remote.new('mongodb://mongo.com')
+      mongo.connection.should == connection
+    end
+  end
+end

data/spec/low/subdomain_map_spec.rb

@@ -0,0 +1,32 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Low::SubdomainMap do
+  def map
+    default_app = lambda do |env|
+      [200, {'Content-Type' => 'text/plain'}, ['Default App']]
+    end
+
+    api_app = lambda do |env|
+      [200, {'Content-Type' => 'text/plain'}, ['API App']]
+    end
+
+    Low::SubdomainMap.new default_app, 'subdomain' => api_app
+  end
+
+  it 'should call the default app if no subdomain is specified' do
+    res = Rack::MockRequest.new(map).get('http://useless.info')
+    res.should be_ok
+    res.body.should == 'Default App'
+  end
+
+  it 'should call the appropriate API app if a subdomain is specified' do
+    res = Rack::MockRequest.new(map).get('http://subdomain.useless.info')
+    res.should be_ok
+    res.body.should == 'API App'
+  end
+
+  it 'should return a 403 Forbidden if the specified subdomain is not mapped' do
+    res = Rack::MockRequest.new(map).get('http://nonexistant.useless.info')
+    res.should be_forbidden
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+ENV['RACK_ENV'] = 'test'
+require File.dirname(__FILE__) + '/../lib/low'
+
+require 'rack/mock'
+require 'rack/test'
+
+RSpec.configure do |config|
+  config.order = :rand
+end

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification 
+name: low
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Kevin Hyland
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-08-28 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rack
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rack-test
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: mongo
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: bson_ext
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id005
+description: A low-level utility library.
+email: 
+- khy@me.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- lib/low.rb
+- lib/low/mongo.rb
+- lib/low/subdomain_map.rb
+- lib/low/version.rb
+- low.gemspec
+- spec/low/mongo_spec.rb
+- spec/low/subdomain_map_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A low-level utility library.
+test_files: 
+- spec/low/mongo_spec.rb
+- spec/low/subdomain_map_spec.rb
+- spec/spec_helper.rb