mvcli 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2af39b708e5b71d002d6734923412e067411c115
+  data.tar.gz: dcdf57432aeb3712a27878088ae4a527728b9ac2
+SHA512:
+  metadata.gz: dceaaf28dae8821938e47b2c528330e6cacf7abe51bfddadf0ef94c0b4d201659e55bcf52188280d88fe3f92d01728adb1e2014bc048e78aae49d795f61e3e83
+  data.tar.gz: 4b6586b4eb3b18213257b23122114d66800419d1a1940b79c4c39512ffa33e87800a04feb7610315815f7d6e1187c591e1dc3f54ada6d70c80ac0aa3fecd1a86

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in mvcli.gemspec
+gemspec
+
+gem "rake"
+gem "rspec"
+gem "rspec-given"
+gem "rspec-spies"

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Charles Lowell
+
+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 @@
+## Mvcli
+
+It's terribly frustrating when repos don't have a good README. But a
+bad readme is worse than no README at all.

data/Rakefile

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

data/example/controllers/loadbalancers_controller.rb

@@ -0,0 +1,10 @@
+class LoadbalancersController < ApplicationController
+  include MVCLI::RemoteRestController
+
+  respond_to :txt, :json, :xml
+  performs :create, :show, :update, :destroy
+
+  param :name, :type => :string
+
+
+end

data/example/routes.rb

@@ -0,0 +1,31 @@
+collection :loadbalancers do
+  # match "create loadbalancer"
+  # match "show loadbalancers"
+  # match "loadbalancers"
+  # match "show loadbalancer :id" #=> 'loadbalancers#show'
+  # match "update loadbalancer :id #=> loadbalancers#update"
+  # match "destroy loadbalancer :id"
+  collection :nodes do
+    # match "create node on loadbalancer :loadbalancer_id"
+    # match "create loadbalancer :loadbalancer_id node"
+    # match "show nodes on loadbalancer :loadbalancer_id"
+    # match "loadbalancer nodes"
+    # match "show loadbalancer :loadbalancer_id  nodes"
+    # match "show loadbalancer :loadbalancer_id node :id"
+    # match "show node :id on loadbalancer :loadbalancer_id"
+    # match "update loadbalancer:node"
+    # match "destroy loadbalancer:node:$id"
+    # match "destroy loadbalancer node $id"
+    # match "destroy loadbalancer:node $id"
+    # match "help "
+  end
+
+  collection :virtual_ips, :only => :index
+  # match "show virtual_ips on loadbalancer :loadbalancer_id"
+  # match "show loadbalancer :loadbalancer_id virtual_ips"
+  # match "loadbalancers"
+end
+
+collection :servers do
+
+end

data/lib/mvcli/actions.rb

@@ -0,0 +1,30 @@
+module MVCLI
+  class Actions
+    def initialize(loader, renderer)
+      @loader = loader
+      @renderer = renderer
+    end
+
+    def [](key)
+      controller, method = key.split('#')
+      Action.new @loader, @renderer, controller, method
+    end
+
+    class Action
+      def initialize(loader, renderer, controller, method)
+        @loader = loader
+        @renderer = renderer
+        @controller = controller
+        @method = method
+      end
+
+      def call(command)
+        controller = @loader.load :controller, @controller
+        fail LoadError, "no such controller: #{@controller}" unless controller
+        context = controller.send @method
+        path = [@controller, @method].join('/')
+        @renderer.render command.output, path, context
+      end
+    end
+  end
+end

data/lib/mvcli/app.rb

@@ -0,0 +1,33 @@
+require_relative "middleware"
+require_relative "command"
+require_relative "router"
+
+module MVCLI
+  class App
+
+    def initialize
+      @middleware = Middleware.new
+      @middleware << Router.new
+    end
+
+    def call(command)
+      @middleware.call command
+    end
+
+    def root
+      self.class.root or fail "Invalid App: undefined application root directory"
+    end
+
+    class << self
+      attr_accessor :root
+    end
+
+    def main(argv = ARGV.dup, input = $stdin, output = $stdout, log = $stderr, env = ENV.dup)
+      call Command.new(argv, input, output, log, env)
+    end
+
+    def self.main(*args)
+      new.main *args
+    end
+  end
+end

data/lib/mvcli/command.rb

@@ -0,0 +1,9 @@
+module MVCLI
+  class Command
+    attr_reader :argv, :input, :output, :log, :env
+
+    def initialize(argv, input, output, log, env)
+      @argv, @input, @output, @log, @env = argv, input, output, log, env
+    end
+  end
+end

data/lib/mvcli/middleware.rb

@@ -0,0 +1,38 @@
+module MVCLI
+  class Middleware
+    def initialize
+      @apps = []
+    end
+
+    def call(command)
+      invoke command, 0
+    end
+
+    def [](idx)
+      @apps[idx]
+    end
+
+    def []=(idx, app)
+      @apps[idx] = app
+    end
+
+    def <<(app)
+      @apps << app
+    end
+
+    private
+
+    def invoke(command, index)
+      if app = @apps[index]
+        app.call(command) do |c|
+          if @apps[index + 1]
+            c ||= command
+            invoke c, index + 1
+          end
+        end
+      else
+        return 0
+      end
+    end
+  end
+end

data/lib/mvcli/router.rb

@@ -0,0 +1,34 @@
+require "map"
+
+module MVCLI
+  class Router
+    RoutingError = Class.new StandardError
+    InvalidRoute = Class.new RoutingError
+
+    def initialize(actions = nil)
+      @actions = actions || Map.new
+      @root = Map.new
+    end
+
+    def root(options = {})
+      action = options[:to] or fail InvalidRoute, "root routes must specify an action with ':to =>' E.g. root :to => 'foo#bar'"
+      verbs = [options[:via] || :help].flatten
+      verbs.each do |verb|
+        @root[verb] = action
+      end
+    end
+
+    def call(command)
+      verb = command.argv.first || 'help'
+      path = command.argv.slice(1..-1) || []
+      if path.empty?
+        if action_name = @root[verb]
+          if action = @actions[action_name]
+            return action.call command
+          end
+        end
+      end
+      fail RoutingError, "#{path.join(':')} does not respond to #{verb}"
+    end
+  end
+end

data/lib/mvcli/version.rb

@@ -0,0 +1,3 @@
+module MVCLI
+  VERSION = "0.0.1"
+end

data/lib/mvcli.rb

@@ -0,0 +1,5 @@
+require "mvcli/version"
+
+module MVCLI
+  # Your code goes here...
+end

data/mvcli.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mvcli/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "mvcli"
+  spec.version       = MVCLI::VERSION
+  spec.authors       = ["Charles Lowell"]
+  spec.email         = ["cowboyd@thefrontside.net"]
+  spec.description   = %q{MVC Framework for Building Command Line Apps}
+  spec.summary       = %q{Local Apps. Remote Apps. They're all at your fingertips}
+  spec.homepage      = "https://github.com/cowboyd/mvcli"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "map"
+end

data/spec/mvcli/actions_spec.rb

@@ -0,0 +1,30 @@
+require "spec_helper"
+require "mvcli/actions"
+
+describe "MVCLI::Actions" do
+  Given(:loader) {mock(:Loader)}
+  Given(:renderer) {mock(:Renderer, :render => true)}
+  Given(:actions) {MVCLI::Actions.new loader, renderer}
+
+  context "when the loader cannot find an appropriate controller" do
+    Given {loader.stub(:load)}
+
+    When(:action) {actions['foo']}
+    Then {action.should_not be_nil}
+
+    context ".calling it" do
+      When(:result) {action.call(mock(:Command))}
+      Then {result.should have_failed LoadError}
+    end
+  end
+
+  context "when the class exists" do
+    Given(:output) {mock(:Output)}
+    Given(:controller) {mock(:Controller)}
+    Given {loader.stub(:load).with(:controller, 'foo') {controller}}
+    Given {controller.stub(:bar) {"the context"}}
+    When {actions['foo#bar'].call(mock(:Command, :output => output))}
+    Then {controller.should have_received(:bar)}
+    And {renderer.should have_received(:render).with(output, 'foo/bar', 'the context')}
+  end
+end

data/spec/mvcli/middleware_spec.rb

@@ -0,0 +1,74 @@
+require "spec_helper"
+require "mvcli/middleware"
+
+describe "MVCLI::Middleware" do
+  before do
+    @middleware = MVCLI::Middleware.new
+    @command = mock(:Command)
+  end
+
+  it "runs perfectly fine without any apps" do
+    @middleware.call(@command).should eql 0
+  end
+
+  describe "with a single app" do
+    before do
+      @app = proc do |command|
+        @called = command
+      end
+      @middleware << @app
+      @middleware.call @command
+    end
+    it "calls it" do
+      @called.should eql @command
+    end
+  end
+
+  describe "with a couple apps" do
+    before do
+      @sequence = []
+      @commands = []
+      @middleware << proc do |command, &block|
+        @commands << command
+        @sequence << "first.before"
+        block.call
+        @sequence << "first.after"
+      end
+      @middleware << proc do |command, &block|
+        @commands << command
+        @sequence << "second"
+      end
+      @middleware.call @command
+    end
+    it "passes the command to all the apps" do
+      @commands.should eql [@command, @command]
+    end
+    it "calls the first app *around* the second app" do
+      @sequence.should eql ["first.before", "second", "first.after"]
+    end
+
+    describe "if the first app does not yield" do
+      before do
+        @sequence.clear
+        @middleware[0] = Proc.new {}
+        @middleware.call @command
+      end
+      it "never calls the second app" do
+        @sequence.should eql []
+      end
+    end
+  end
+
+  describe "with an app that yields even though there is no next app" do
+    before do
+      app = Object.new
+      def app.call(command)
+        yield
+      end
+      @middleware << @app
+    end
+    it "runs successfully" do
+      @middleware.call(@command).should eql 0
+    end
+  end
+end

data/spec/mvcli/router_spec.rb

@@ -0,0 +1,60 @@
+require "spec_helper"
+require "mvcli/router"
+
+describe "MVCLI::Router" do
+  Given(:Router) {MVCLI::Router}
+  Given(:actions) {mock(:Actions)}
+  Given(:router) {self.Router.new actions}
+
+  context "without any routes" do
+    When(:result) {invoke}
+    Then {result.should have_failed self.Router::RoutingError}
+  end
+
+  context "when an invalid root is mapped" do
+    When(:result) {router.root :wat => :tf?}
+    Then {result.should have_failed}
+  end
+
+  context "with its root mapped to a single verb" do
+    Given do
+      actions.stub(:[]).with('logins#create') do
+        proc do |command|
+          @login = command
+        end
+      end
+    end
+    Given {router.root :to => 'logins#create', :via => :login}
+    When {invoke 'login'}
+    Then {@login.argv.should eql ['login']}
+
+    context "when a command comes in for an unmapped verb" do
+      When(:result) {invoke 'fwiff'}
+      Then {result.should have_failed self.Router::RoutingError}
+    end
+    context "and a second verb is mapped to the the root" do
+      Given do
+        actions.stub(:[]).with('logins#destroy') {proc {|c| @logout = c}}
+      end
+      Given {router.root :to => 'logins#destroy', :via => :logout}
+      context "when I access via the original verb" do
+        Given {invoke 'logout' }
+        Then {@logout.should_not be_nil}
+        And {@logout.argv.should eql ['logout']}
+      end
+    end
+  end
+
+  context "with its root mapped without a specific verb" do
+    Given do
+      actions.stub(:[]).with('something#show') {proc {|c|@something = c}}
+    end
+    Given {router.root :to => 'something#show'}
+    When {invoke 'help'}
+    Then {@something.argv.should eql ['help']}
+  end
+
+  def invoke(*args)
+    router.call mock(:Command, :argv => args)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+require "mvcli"
+require "rspec-given"
+require "rspec-spies"

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification
+name: mvcli
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Charles Lowell
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDPjCCAiagAwIBAgIBADANBgkqhkiG9w0BAQUFADBFMRAwDgYDVQQDDAdjb3di
+  b3lkMRwwGgYKCZImiZPyLGQBGRYMdGhlZnJvbnRzaWRlMRMwEQYKCZImiZPyLGQB
+  GRYDbmV0MB4XDTEzMDEzMDIxMDYwNFoXDTE0MDEzMDIxMDYwNFowRTEQMA4GA1UE
+  AwwHY293Ym95ZDEcMBoGCgmSJomT8ixkARkWDHRoZWZyb250c2lkZTETMBEGCgmS
+  JomT8ixkARkWA25ldDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAO45
+  CUxpETDGYXjCCy2dMg/aIrdrTqBqQW5ZrzhHxF9EkcdmWFr0z/qMz0JSpZ3pF11Z
+  KYaj5PaQQpjZfLPwbuiGGkuSWi+UAac//V18xo6S4lzRBjO+gpzG9f2AOzt9b+SR
+  Uc8UhO7QBZ5edUDxMxw9QstD+U0YBAlzsPJbHuUOqdtxXmNQCds3ZnqTgZaIpdUy
+  CSejtrukSmlthxFzwgMezYQhcYxmkl+Q475JUodnI6Pjc6nja/Or8Y6cEWiLgeUa
+  a+efcPGLDEbwJC7TGRrvk8yassMByBEJ3XueTMzeqWFd+665ptciojYo6BvIAR0N
+  iLwks0x567FZyS8SqTcCAwEAAaM5MDcwCQYDVR0TBAIwADAdBgNVHQ4EFgQUxVgR
+  5TUqf7Hd24ICb3g4FNbM7oYwCwYDVR0PBAQDAgSwMA0GCSqGSIb3DQEBBQUAA4IB
+  AQDdJj+NzZhiYXA56z0wzRUA/Fcf6CYqKB+RFRlPssDEcHTor5SnwdWgQof/gNLi
+  Qel1Om4zO0Shcp89jxaUqtvEdYVhmyfc0vycHmemKttNBT734yMrEJtF8Hhy+Dnz
+  9CzixXLvgGaRH+mf3M0+l+zIDJJr2L+39L8cyTSSRnp/srfI8aSmJKhGshudBKoC
+  Ty6Gi071pwoJXvdMaE/6iPy7bUzlndYdHyYuWSKaO9N47HqQ62oEnBraglw6ghoi
+  UgImJlChAzCoDP9zi9tdm6jAr7ttF25R9PPYr11ILb7dYe3qUzlNlM6zJx/nb31b
+  IhdyRVup4qLcqYSTPsm6u7VA
+  -----END CERTIFICATE-----
+date: 2013-05-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: map
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: MVC Framework for Building Command Line Apps
+email:
+- cowboyd@thefrontside.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- example/controllers/loadbalancers_controller.rb
+- example/routes.rb
+- lib/mvcli.rb
+- lib/mvcli/actions.rb
+- lib/mvcli/app.rb
+- lib/mvcli/command.rb
+- lib/mvcli/middleware.rb
+- lib/mvcli/router.rb
+- lib/mvcli/version.rb
+- mvcli.gemspec
+- spec/mvcli/actions_spec.rb
+- spec/mvcli/middleware_spec.rb
+- spec/mvcli/router_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/cowboyd/mvcli
+licenses:
+- MIT
+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.0
+signing_key: 
+specification_version: 4
+summary: Local Apps. Remote Apps. They're all at your fingertips
+test_files:
+- spec/mvcli/actions_spec.rb
+- spec/mvcli/middleware_spec.rb
+- spec/mvcli/router_spec.rb
+- spec/spec_helper.rb