webcmd 0.0.1

data/.gitignore

@@ -0,0 +1,2 @@
+/.bundle
+/pkg

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/Gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: .
+  specs:
+    webcmd (0.0.1)
+      puma (~> 1.6.3)
+      rack (~> 1.4.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    puma (1.6.3)
+      rack (~> 1.2)
+    rack (1.4.1)
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    rake (0.9.2.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rack-test
+  rake
+  webcmd!

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Sergey Nartimov
+
+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,34 @@
+# Webcmd
+
+Run shell command through HTTP.
+
+## Installation
+
+    $ gem install webcmd
+
+## Usage
+
+Use `COMMAND` environment variable to specify the command to be runned and `TOKEN` to protect the HTTP endpoint, e.g.:
+
+    $ COMMAND="echo it\'s working" TOKEN="1234" webcmd
+    Puma 1.6.3 starting...
+    * Min threads: 0, max threads: 1
+    * Environment: production
+    * Listening on tcp://0.0.0.0:9292
+
+You could run `curl` in other terminal to check whether it's working:
+
+    $ curl http://localhost:9292/\?token=1234
+    it's working
+
+To list available command-line options run:
+
+    $ webcmd -h
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.pattern = 'test/*_test.rb'
+  t.verbose = true
+end
+
+task :default => :test

data/bin/webcmd

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'webcmd'
+Webcmd.run!

data/lib/webcmd.rb

@@ -0,0 +1,7 @@
+require 'webcmd/server'
+
+module Webcmd
+  def self.run!
+    Server.new.start
+  end
+end

data/lib/webcmd/app.rb

@@ -0,0 +1,25 @@
+require 'webcmd/command_runner'
+
+module Webcmd
+  class App
+    def initialize(options={})
+      @command = options[:command]
+      @token   = options[:token]
+    end
+
+    def call(env)
+      if token_valid?(env)
+        [200, {'Content-Type' => 'text/plain'}, CommandRunner.new(@command)]
+      else
+        [403, {'Content-Type' => 'text/plain'}, ['Token invalid']]
+      end
+    end
+
+    private
+
+    def token_valid?(env)
+      req = Rack::Request.new(env)
+      req.params['token'] == @token
+    end
+  end
+end

data/lib/webcmd/command_runner.rb

@@ -0,0 +1,21 @@
+module Webcmd
+  class CommandRunner
+    def initialize(command)
+      @command = command
+    end
+
+    def each(&block)
+      IO.popen([shell_env, 'bash', '-l', err: [:child, :out]], 'w+') do |shell|
+        shell.write @command
+        shell.close_write
+        shell.each_line(&block)
+      end
+    end
+
+    private
+
+    def shell_env
+      Hash[ENV.keys.grep(/^BUNDLE_/).map { |k| [k, nil] }]
+    end
+  end
+end

data/lib/webcmd/options.rb

@@ -0,0 +1,49 @@
+require 'optparse'
+require 'forwardable'
+
+module Webcmd
+  class Options
+    extend Forwardable
+
+    def initialize(argv)
+      @parser = OptionParser.new(argv) do |opts|
+        opts.banner = "Usage: webcmd [options]"
+
+        opts.on '-o', '--host HOST', 'listen on HOST (default: 0.0.0.0)' do |host|
+          options[:Host] = host
+        end
+
+        opts.on '-p', '--port PORT', 'use PORT (default: 9292)' do |port|
+          @options[:Port] = port
+        end
+
+        opts.on '-t', '--threads INT', 'min:max threads to use (default 0:1)' do |threads|
+          @options[:Threads] = threads
+        end
+
+        opts.on '-D', '--daemonize', 'run daemonized in the background' do |d|
+          @options[:daemonize] = !!d
+        end
+
+        opts.on_tail '-h', '--help', 'show this message' do
+          puts opts
+          exit
+        end
+
+        opts.on_tail '--version', 'show version' do
+          puts "webcmd #{Webcmd::VERSION}"
+          exit
+        end
+      end
+    end
+
+    def parse!
+      @options = { app: {} }
+      @parser.parse!
+      @options[:app][:command] = ENV['COMMAND']
+      @options[:app][:token]   = ENV['TOKEN']
+
+      @options
+    end
+  end
+end

data/lib/webcmd/server.rb

@@ -0,0 +1,41 @@
+require 'rack'
+require 'webcmd/app'
+require 'webcmd/options'
+
+module Webcmd
+  class Server
+    def wrapped_app
+      @wrapped_app ||= begin
+        app = App.new(options[:app])
+
+        Rack::Builder.new do
+          use Rack::Logger
+          use Rack::CommonLogger
+          use Rack::Chunked
+          run app
+        end
+      end
+    end
+
+    def default_options
+      {
+        Host: '0.0.0.0',
+        Port: 9292,
+        environment: 'production',
+        server: :puma,
+        Threads: '0:1'
+      }
+    end
+
+    def options
+      @options ||= begin
+        options = Options.new(ARGV).parse!
+        default_options.merge(options)
+      end
+    end
+
+    def start
+      Rack::Server.start options.merge(app: wrapped_app)
+    end
+  end
+end

data/lib/webcmd/version.rb

@@ -0,0 +1,3 @@
+module Webcmd
+  VERSION = '0.0.1'
+end

data/test/app_test.rb

@@ -0,0 +1,53 @@
+require 'minitest/autorun'
+require 'rack/test'
+require 'webcmd'
+
+module Webcmd
+  class AppTest < MiniTest::Unit::TestCase
+    include Rack::Test::Methods
+
+    def options
+      @options ||= {}
+    end
+
+    def app
+      App.new(options)
+    end
+
+    def test_success_response
+      get '/'
+      assert_equal 200, last_response.status
+    end
+
+    def test_returns_text_content_type
+      get '/'
+      assert_equal 'text/plain', last_response.content_type
+    end
+
+    def test_returns_command_output
+      options[:command] = 'echo "foobar"'
+      get '/'
+      assert_equal 200, last_response.status
+      assert_equal 'foobar', last_response.body.strip
+    end
+
+    def test_executes_command_in_bundler_free_env
+      options[:command] = 'export | grep BUNDLE_ | grep -v grep'
+      get '/'
+      assert_empty last_response.body.strip
+    end
+
+    def test_returns_command_stderr
+      options[:command] = 'echo "foobar" >&2'
+      get '/'
+      assert_equal 200, last_response.status
+      assert_equal 'foobar', last_response.body.strip
+    end
+
+    def test_invalid_token
+      options[:token] = 'asdf'
+      get '/', token: '1234'
+      assert_equal 403, last_response.status
+    end
+  end
+end

data/test/integration_test.rb

@@ -0,0 +1,27 @@
+require 'minitest/autorun'
+require 'open-uri'
+
+module Webcmd
+  class IntegrationTest < MiniTest::Unit::TestCase
+    def test_run_bin_file
+      bin = File.expand_path('../../bin/webcmd', __FILE__)
+      env = {'COMMAND' => 'echo "foobar"', 'TOKEN' => '1234'}
+      pipe = IO.popen([env, bin, err: [:child, :out]])
+
+      assert_equal 'foobar', response.strip
+    ensure
+      Process.kill('KILL', pipe.pid)
+    end
+
+    private
+
+    def response
+      retries ||= 3
+      sleep 0.5
+      response = open("http://127.0.0.1:9292/?token=1234").read
+    rescue Errno::ECONNREFUSED => e
+      retries -= 1
+      retries > 0 ? retry : raise(e)
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+$: << File.expand_path('../../lib', __FILE__)
+require 'webcmd'
+require 'rack/test'

data/webcmd.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'webcmd/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = 'webcmd'
+  gem.version       = Webcmd::VERSION
+  gem.authors       = ['Sergey Nartimov']
+  gem.email         = ['just.lest@gmail.com']
+  gem.description   = %q{Run shell command through HTTP}
+  gem.summary       = %q{Run shell command through HTTP}
+  gem.homepage      = 'https://github.com/brainspec/webcmd'
+
+  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.require_paths = ['lib']
+
+  gem.add_dependency('rack', '~> 1.4.1')
+  gem.add_dependency('puma', '~> 1.6.3')
+
+  gem.add_development_dependency('rake')
+  gem.add_development_dependency('rack-test')
+end

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification
+name: webcmd
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Sergey Nartimov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.4.1
+  prerelease: false
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.4.1
+- !ruby/object:Gem::Dependency
+  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.3
+  prerelease: false
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.3
+- !ruby/object:Gem::Dependency
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  prerelease: false
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  prerelease: false
+  name: rack-test
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Run shell command through HTTP
+email:
+- just.lest@gmail.com
+executables:
+- webcmd
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- MIT-LICENSE
+- README.md
+- Rakefile
+- bin/webcmd
+- lib/webcmd.rb
+- lib/webcmd/app.rb
+- lib/webcmd/command_runner.rb
+- lib/webcmd/options.rb
+- lib/webcmd/server.rb
+- lib/webcmd/version.rb
+- test/app_test.rb
+- test/integration_test.rb
+- test/test_helper.rb
+- webcmd.gemspec
+homepage: https://github.com/brainspec/webcmd
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      segments:
+      - 0
+      hash: 2381652511498473721
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      segments:
+      - 0
+      hash: 2381652511498473721
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Run shell command through HTTP
+test_files:
+- test/app_test.rb
+- test/integration_test.rb
+- test/test_helper.rb