styoe 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    N2MwNWU2NDFiOTg0ZjZiZDQyMmMyZGQ1YjA0MmIyODFmNDc0YmZmNg==
+  data.tar.gz: !binary |-
+    NzIwZWY4ZTNhMzMwMWM0ZGQ5OTlhZGVlYWJjZjQ4ZTgwODExODc4ZA==
+SHA512:
+  metadata.gz: !binary |-
+    YWY0MDE5OTdjZWYwNGU0OTM5ZWI0NGU1OWFiMThlMjI1YjUzYjMxMDc4NWFi
+    NGUwNzk4YzhkMzExZTQzYzJiODU0ZDdhNmYxODk4YjQ5MGEzMGEyYzc0N2Nj
+    MDIzMWMyZWIxYWIyNzBjOWQzNzY3Yjk1YzhlMWQ4ODVkZmVmMGY=
+  data.tar.gz: !binary |-
+    ODdmNDIzNjk5NmFiNTI2OWNhNzZkYTNmYTRhOWI2MGZlYjlhMzRmZGFmYzNj
+    ZDgyZDU0YjRlM2RkYTE0YzQwNmY3ZTgxNTJhMGVhOTk4MTMyYzQyZTIwYzYx
+    Mjk4OTEwOTYwZWYxMDg0N2JmMTE2NmUzODgwYTI1YmIxMTkwYjA=

data/.gitignore

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

data/.ruby-version

@@ -0,0 +1 @@
+2.1

data/.travis.yml

@@ -0,0 +1,17 @@
+language: ruby
+rvm:
+- 2.1
+env:
+- TEST_SUITE=features
+- TEST_SUITE=spec
+script: bundle exec rake $TEST_SUITE
+notifications:
+  email: false
+deploy:
+  provider: rubygems
+  api_key:
+    secure: U+yl3U672sFSWS8TrF6u3Neewojr1ExV9KXVJSeZrnIyh16Dx0dYrPzxYG5rePKyAuJ5gq61zK2uYFH80Sr9tlj4qRiKDLoRC6mHLvcx+KVnTcknfM476UYMUOgtaUT9sbEoCx1ERKswZA6PsoCJrN8os4Qu8+eTZ7OmYnSS0Ng=
+  gem: styoe
+  on:
+    tags: true
+    repo: as-cii/styoe

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Antonio Scandurra
+
+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,44 @@
+# styoe (Start Your Engines!)
+
+Start Your Engines™.
+
+## Installation
+
+```bash
+$ gem install styoe
+```
+
+## Usage
+
+Create a `.engines` file on your home directory, and write a yaml-formatted file
+with the applications you would like to start:
+
+```yaml
+skype:        "/Applications/Skype.app/Contents/MacOS/Skype"
+sublime-text: "/Applications/Sublime Text.app/Contents/MacOS/Sublime Text"
+flint:        "/Applications/Flint.app/Contents/MacOS/Flint"
+```
+
+And then execute:
+
+```bash
+styoe
+```
+
+Your applications will be up and running in seconds. When you are done with them
+just execute:
+
+```bash
+styoe --stop
+```
+
+And they will disappear. For other great functionalities, please check
+[features](features).
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,13 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'cucumber'
+require 'cucumber/rake/task'
+
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format pretty"
+end
+
+RSpec::Core::RakeTask.new(:spec)
+
+desc "Test"
+task default: :spec

data/bin/styoe

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+require 'styoe'
+
+launcher = Styoe::Launcher.new
+
+case ARGV[0]
+when '--stop'
+  launcher.stop
+else
+  launcher.start
+end

data/features/applications_closing.feature

@@ -0,0 +1,19 @@
+Feature: Applications closing
+
+  Scenario: User closes open applications
+    Given a file named ".engines" with:
+    """
+    test: 'ruby process.rb'
+    """
+      And a file named "process.rb" with:
+    """
+    trap("INT") do
+      File.write("closed", "")
+      exit
+    end
+
+    gets
+    """
+     When I successfully run `styoe`
+      And I successfully run `styoe --stop`
+     Then a file named "closed" should exist

data/features/applications_launch.feature

@@ -0,0 +1,33 @@
+Feature: Application launching
+
+  Scenario: User writes configuration on current directory
+    Given a file named ".engines" with:
+    """
+    app1: 'touch x'
+    app2: 'touch y'
+    """
+     When I run `styoe`
+     Then the exit status should be 0
+      And a file named "x" should exist
+      And a file named "y" should exist
+
+  Scenario: User writes configuration on parent directory
+    Given a file named ".engines" with:
+    """
+    app1: 'touch x'
+    app2: 'touch y'
+    """
+     And a directory named "sub/directory"
+    When I cd to "sub/directory"
+     And I run `styoe`
+    Then the exit status should be 0
+     And a file named "x" should exist
+     And a file named "y" should exist
+
+  Scenario: User has no configuration
+    When I run `styoe`
+    Then the exit status should be 1
+     And the output should contain:
+     """
+     No configuration found. Are you sure you have created a .engines file?
+     """

data/features/support/env.rb

@@ -0,0 +1 @@
+require 'aruba/cucumber'

data/lib/styoe/configuration_resolver.rb

@@ -0,0 +1,48 @@
+require 'yaml'
+
+module Styoe
+  DOT_FILE = '.engines'
+  PID_FILE = '.engines.pids'
+
+  class ConfigurationNotFound < StandardError; end
+
+  class ConfigurationResolver
+    def initialize(options = {})
+      @stop_at = options[:stop_at] || '/'
+    end
+
+    def active_processes(path = PID_FILE)
+      raise ConfigurationNotFound if stop?(path)
+      return active_processes("../#{path}") unless File.exist?(path)
+
+      parse_values(path)
+    end
+
+    def processes(path = DOT_FILE)
+      raise ConfigurationNotFound if stop?(path)
+      return processes("../#{path}") unless File.exist?(path)
+
+      parse_values(path)
+    end
+
+    def dump_pids(pids, path = DOT_FILE)
+      raise ConfigurationNotFound if stop?(path)
+      return dump_pids(pids, "../#{path}") unless File.exist?(path)
+
+      file = File.open(path.gsub(DOT_FILE, PID_FILE), "w")
+      file.write(YAML.dump pids)
+      file.close
+    end
+
+    private
+
+    def parse_values(path)
+      contents = File.read(path)
+      YAML.load(contents).values
+    end
+
+    def stop?(path)
+      File.dirname(File.absolute_path path) == @stop_at
+    end
+  end
+end

data/lib/styoe/process_launcher.rb

@@ -0,0 +1,11 @@
+module Styoe
+  class ProcessLauncher
+    def launch(process)
+      Process.spawn(process)
+    end
+
+    def stop(pid)
+      Process.kill("INT", pid)
+    end
+  end
+end

data/lib/styoe/version.rb

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

data/lib/styoe.rb

@@ -0,0 +1,36 @@
+require 'styoe/version'
+require 'styoe/configuration_resolver'
+require 'styoe/process_launcher'
+
+module Styoe
+  class Launcher
+    def initialize(config_resolver = nil, process_launcher = nil)
+      @config_resolver  = config_resolver  || ConfigurationResolver.new
+      @process_launcher = process_launcher || ProcessLauncher.new
+    end
+
+    def start
+      begin
+        processes = Hash[*run_processes]
+        @config_resolver.dump_pids(processes)
+      rescue ConfigurationNotFound
+        $stderr.puts 'No configuration found. Are you sure you have created a .engines file?'
+        exit(1)
+      end
+    end
+
+    def stop
+      @config_resolver.active_processes.each do |pid|
+        @process_launcher.stop(pid)
+      end
+    end
+
+    private
+
+    def run_processes
+      @config_resolver.processes.map do |process|
+        [process, @process_launcher.launch(process)]
+      end.flatten
+    end
+  end
+end

data/script/bootstrap

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+
+echo "Installing required gems..."
+bundle install --path vendor/gems

data/spec/configuration_resolver_spec.rb

@@ -0,0 +1,84 @@
+require 'styoe/configuration_resolver'
+
+describe Styoe::ConfigurationResolver do
+
+  let(:pids)     { { application1: 1, application2: 2 } }
+  let(:pid_file) { instance_double(File) }
+
+  it 'resolves and parses a configuration file' do
+    allow_file_to_exist_and_return("#{Styoe::DOT_FILE}", sample_configuration)
+
+    expect(subject.processes).to eq(['hello', 'world'])
+  end
+
+  it 'searches configuration recursively in parent directories' do
+    allow_file_to_exist_and_return("../../#{Styoe::DOT_FILE}", sample_configuration)
+
+    expect(subject.processes).to eq(['hello', 'world'])
+  end
+
+  it 'stops searching configuration when root is reached' do
+    subject = described_class.new(stop_at: '/')
+    allow(File).to receive(:dirname).and_return('/')
+
+    expect { subject.processes }.to raise_error(Styoe::ConfigurationNotFound)
+  end
+
+  it 'searches active processes' do
+    allow_file_to_exist_and_return("#{Styoe::PID_FILE}", sample_pids)
+
+    expect(subject.active_processes).to eq([ 1, 2 ])
+  end
+
+  it 'searches active processes recursively' do
+    allow_file_to_exist_and_return("../../#{Styoe::PID_FILE}", sample_pids)
+
+    expect(subject.active_processes).to eq([ 1, 2 ])
+  end
+
+  it 'stops searching active processes when root is reached' do
+    subject = described_class.new(stop_at: '/')
+    allow(File).to receive(:dirname).and_return('/')
+
+    expect { subject.active_processes }.to raise_error(Styoe::ConfigurationNotFound)
+  end
+
+  it "dumps active processes on the same path of #{Styoe::DOT_FILE}" do
+    pid_file = double
+    pids = { application1: 1, application2: 2 }
+    allow(File).to receive(:exist?).and_return(false, false, true)
+    allow(File).to receive(:open).with("../../#{Styoe::PID_FILE}", "w").and_return(pid_file)
+    allow(YAML).to receive(:dump).with(pids).and_return(sample_pids)
+    allow(pid_file).to receive(:write)
+    allow(pid_file).to receive(:close)
+
+    subject.dump_pids(pids)
+
+    expect(pid_file).to have_received(:write).with(sample_pids)
+    expect(pid_file).to have_received(:close)
+  end
+
+  def allow_file_to_exist_and_return(path, read_file)
+    allow_file_to_exist(path)
+    allow(File).to receive(:read).with(path).and_return(read_file)
+  end
+
+  def allow_file_to_exist(path)
+    allow(File).to receive(:exist?).and_return(false)
+    allow(File).to receive(:exist?).with(path).and_return(true)
+  end
+
+  def sample_configuration
+    <<-config
+    application1: hello
+    application2: world
+    config
+  end
+
+  def sample_pids
+    <<-pids
+    application1: 1
+    application2: 2
+    pids
+  end
+end

data/spec/fire_spec.rb

@@ -0,0 +1,44 @@
+require 'styoe'
+
+describe Styoe::Launcher do
+  let(:configuration_resolver) { instance_double(Styoe::ConfigurationResolver) }
+  let(:process_launcher)       { instance_double(Styoe::ProcessLauncher) }
+  let(:processes)              { [ "app1", "app2", "app3" ] }
+  let(:pids)                   { [ 1, 2, 3 ] }
+  let(:running_processes)      { Hash[*processes.zip(pids).flatten] }
+
+  subject { Styoe::Launcher.new(configuration_resolver, process_launcher) }
+
+  it "launches configuration processes and remembers open pids" do
+    allow(configuration_resolver).to receive(:processes).and_return(processes)
+    allow(configuration_resolver).to receive(:dump_pids)
+    stub_processes_launch
+
+    subject.start
+
+    expect(configuration_resolver).to have_received(:dump_pids).with(running_processes)
+  end
+
+  it 'stops active processes' do
+    allow(configuration_resolver).to receive(:active_processes).and_return(pids)
+    allow(process_launcher).to receive(:stop)
+
+    subject.stop
+
+    expect_processes_stopped
+  end
+
+  private
+
+  def stub_processes_launch
+    processes.zip(pids).each do |process, pid|
+      allow(process_launcher).to receive(:launch).with(process).and_return(pid)
+    end
+  end
+
+  def expect_processes_stopped
+    pids.each do |pid|
+      expect(process_launcher).to have_received(:stop).with(pid)
+    end
+  end
+end

data/styoe.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'styoe/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "styoe"
+  spec.version       = Styoe::VERSION
+  spec.authors       = ["Antonio Scandurra"]
+  spec.email         = ["as-cii@outlook.com"]
+  spec.description   = %q{Start your engines.}
+  spec.summary       = spec.description
+  spec.homepage      = "https://github.com/as-cii/styoe"
+  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_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec", "~> 3.0.0.beta2"
+  spec.add_development_dependency "cucumber"
+  spec.add_development_dependency "aruba"
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: styoe
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Antonio Scandurra
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.0.beta2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.0.beta2
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Start your engines.
+email:
+- as-cii@outlook.com
+executables:
+- styoe
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .ruby-version
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/styoe
+- features/applications_closing.feature
+- features/applications_launch.feature
+- features/support/env.rb
+- lib/styoe.rb
+- lib/styoe/configuration_resolver.rb
+- lib/styoe/process_launcher.rb
+- lib/styoe/version.rb
+- script/bootstrap
+- spec/.gitkeep
+- spec/configuration_resolver_spec.rb
+- spec/fire_spec.rb
+- styoe.gemspec
+homepage: https://github.com/as-cii/styoe
+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.2.2
+signing_key: 
+specification_version: 4
+summary: Start your engines.
+test_files:
+- features/applications_closing.feature
+- features/applications_launch.feature
+- features/support/env.rb
+- spec/.gitkeep
+- spec/configuration_resolver_spec.rb
+- spec/fire_spec.rb