flash 0.0.3 → 0.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZTEyMWQwMmZmMzU5ZTVmODE0MzJlYjIxNjI1ZmU4NzgwYTNiNGFiNw==
+  data.tar.gz: !binary |-
+    MDVjYTBkN2Q2ZGM4M2M5ZWU2YmNiMjg5NTAyZDczNDY1MzgxMzdiYQ==
+SHA512:
+  metadata.gz: !binary |-
+    OTk4ZjJkZDExZjYxYjI5Y2MzMmFhMDJkODRlMTYxYjkxMDY1NTQzZjUxYTgz
+    ODJmNjM1MmZhMGFiMzI3YWQ2MzkzM2MyM2QxZWMwZjBjNjFiNzA0MjY3YjZh
+    N2M2YjkyMDA1NzEyZWNlMDY4N2Q0YzUwMjQ4ZTYyY2FlMGQzMTY=
+  data.tar.gz: !binary |-
+    NzhkZWE3Y2NkYjE5OWZmMTkzODhmNjVmMzI5MDYwNzczZTQzMjQwZGQ2Yjgz
+    YmRiZWM4N2ZiMTg3ZWU4Y2M2NzI0ZDAyYzI2NTYyODlkYmQ1MGNiYzM3YmRm
+    ZDFlNTVjMTcxZDQwMGQ2MWI1NzBiNzJiOTZlY2ZkYjkzNDE0NDc=

data/README.md

@@ -1,40 +1,195 @@
-# Flash
+Flash
+=====
 
-Flash helps you run arbitrary or predefined commands on multiple projects all defined in the Runfile.
+[![Gem Version](https://badge.fury.io/rb/flash.svg)](http://badge.fury.io/rb/flash)
+[![Build Status](https://travis-ci.org/colmarius/flash.svg?branch=master)](https://travis-ci.org/colmarius/flash?branch=master)
 
-# Installation
+![flash](http://colmarius.net/flash/images/flashtocat.png)
+
+Overview
+--------
+
+Main purpose of Flash is to eliminate repetitive tasks, those of running the
+same commands on multiple directories.
+
+It allows one to define:
+- __aliases__ for sets of commands to be run on multiple directories
+- __groups__ for grouping together multiple directories
+
+Both groups and aliases can be defined in the `.flash.yml` configuration file.
+
+Motivation
+----------
+
+__Simple configuration file__
+
+A place to define both groups and aliases.
+
+__Inspect output__
+
+See the output of flash commands runned on a group of projects. 
+
+Installation
+------------
+
+You can either install the gem manually:
 
 ```bash
-> gem install flash
+gem install flash
 ```
 
-The command available is run:
+or add it to your Gemfile:
 
-```bash
-> run
-Group name is missing.
-Usage: run [options] group
-    -c, --command command            Commands to run (semicolon separated)
-    -d, --debug                      Debug: print each command result
-    -r, --recipe recipe              Run registered recipe if present
-    -l, --list-recipes               List registered recipes
-    -h, --help                       Help documentation
+```ruby
+group :development do
+  gem 'flash'
+end
 ```
 
-# Example
+Usage
+-----
 
-```bash
-> cd example
-> run -c ls projects
-salsa> ls
-cubana
+Flash requires a `.flash.yml` file in order to function. This should be
+defined at the root of your workspace folder.
+
+```
+# .flash.yml
 
-dancing> ls
-bouncing
+frontend:
+  - super-product1
+  - super-product2
+  - super-api
+  - super-sso
 
-school> ls
-fun
+libraries:
+  - super-rest-client
+  - super-core-js
+  - super-core-css
 
+aliases:
+  update-master: git stash; git checkout master; git pull
+  status: git status -s
+
+clone:
+  git: git@github.com:SuperDuper
 ```
 
-TODO: write detailed description
+Here we define two groups _frontend_ and _libraries_. We will be allowed to run commands on each of these groups.
+
+We can also define two special configuration sections:
+
+- __aliases__: allows us two save repetitive and long commands
+- __clone__: allows to define a base __git__ URL from where projects in a group can be cloned
+
+With a valid `.flash.yml` configuration file set in your current workspace you
+are now set to run flash commands.
+
+Commands
+--------
+
+Running `flash` will give you the following output:
+
+    Commands:
+      flash clone GROUP        # Clone all projects found in GROUP config file
+      flash help [COMMAND]     # Describe available commands or one specific command
+      flash info [GROUP]       # Display information from config file
+      flash run COMMAND GROUP  # Run one or more COMMAND(s) on the specified GROUP
+      flash version            # Display Flash gem version
+
+### flash clone
+
+    flash clone GROUP
+
+Allows to clone all projects defined in a GROUP by using the clone git base
+URL.
+
+Getting back to our `.flash.yml` example file...
+
+```
+# .flash.yml
+
+frontend:
+  - super-product1
+  - super-product2
+  - super-api
+  - super-sso
+
+...
+
+clone:
+  git: git@github.com:SuperDuper
+```
+
+Running the following command...
+
+    flash clone frontend
+
+will clone from SuperDuper organization all projects defined in _frontend_
+group.
+
+### flash info
+
+    flash info [GROUP]
+
+This is a helper command for printing `.flash.yml` contents. Prints all file
+contents or just part of it (depending if group or other config section is
+specified).
+
+### flash run
+
+    flash run COMMAND GROUP
+
+The heart of flash is the __run__ command. It requires both a COMMAND and a 
+GROUP. With this command one can run same tasks on all projects of same GROUP.
+
+Note: COMMAND can be a standalone command, or be defined in `aliases` section
+(where it must be a list of commands, semi-column separated).
+
+Getting back to our `.flash.yml` example file...
+
+```
+# .flash.yml
+
+frontend:
+  - super-product1
+  - super-product2
+  - super-api
+  - super-sso
+
+libraries:
+  - super-rest-client
+  - super-core-js
+  - super-core-css
+
+aliases:
+  update-master: git stash; git checkout master; git pull
+  status: git status -s
+```
+
+here are some commands you can run:
+
+    # Update master branch.
+    flash run update-master frontend
+    flash run update-master libraries
+
+    # Display status.
+    flash run status frontend
+
+    # List some files.
+    flash run ls frontend 
+
+    # Lets push master branch to origin/staging (forced) for all frontend projects.
+    flash run "git checkout master ; git checkout -B staging ; git push -f ; git checkout master" frontend
+
+    # This last command could be aliased to `master-to-staging`, which would result in:
+    flash run master-to-staging frontend
+
+Contributing
+------------
+
+Please see [CONTRIBUTING.md](https://github.com/colmarius/flash/blob/master/CONTRIBUTING.md).
+
+Note
+----
+
+This is a project to level up my gem skills.

data/exe/flash

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'flash/cli'
+
+Flash::CLI.start

data/lib/flash/cli.rb

@@ -0,0 +1,50 @@
+require 'flash'
+require 'flash/command/clone'
+require 'flash/command/info'
+require 'flash/command/run'
+require 'thor'
+
+class Flash::CLI < Thor
+  class << self
+    def is_thor_reserved_word?(word, type)
+      return false if word == 'run'
+      super
+    end
+  end
+
+  desc 'clone GROUP', 'Clone all projects found in GROUP config file'
+
+  def clone(group)
+    Flash::Command::Clone.new(group).execute
+  end
+
+  desc 'info [GROUP]', 'Display information from config file'
+
+  def info(group = nil)
+    Flash::Command::Info.new(group).execute
+  end
+
+  desc 'run COMMAND GROUP', 'Run one or more COMMAND(s) on the specified GROUP'
+
+  long_desc <<-LONGDESC
+    Run the COMMAND(s) on the specified GROUP.
+
+    More than one command can be specified if wrapped under quotes
+    and are semi-column separated.
+
+    In alternative aliases can be used, which can be defined under "aliases"
+    in .flash.yml config file.
+  LONGDESC
+
+  def run(command, group)
+    Flash::Command::Run.new(command, group).execute
+  end
+
+  desc 'version', 'Display Flash gem version'
+
+  map ['-v', '--version'] => :version
+
+  def version
+    puts Flash::VERSION
+  end
+end

data/lib/flash/command.rb

@@ -0,0 +1,4 @@
+require 'flash'
+
+module Flash::Command
+end

data/lib/flash/command/base.rb

@@ -0,0 +1,16 @@
+require 'flash'
+require 'flash/command'
+require 'flash/config'
+
+class Flash::Command::Base
+  def initialize
+  end
+
+  def config
+    @config ||= Flash::Config.new
+  end
+
+  def valid_group?(group)
+    (group && config[group]) ? true : false
+  end
+end

data/lib/flash/command/clone.rb

@@ -0,0 +1,57 @@
+require 'flash'
+require 'flash/command/base'
+
+class Flash::Command::Clone < Flash::Command::Base
+  def initialize(group)
+    @group = group
+  end
+
+  def execute
+    raise(ArgumentError, 'Missing required group parameter.') unless @group
+
+    unknown_group_and_exit(@group) unless valid_group?(@group)
+    missing_git_clone_url unless has_clone_git_url?
+    clone_projects(@group)
+  end
+
+  private
+
+  def unknown_group_and_exit(group)
+    puts "Unknown group \"#{group}\" in .flash.yml config."
+    exit 1
+  end
+
+  def missing_git_clone_url
+    puts 'Missing clone git URL defined in .flash.yml config.'
+    exit 1
+  end
+
+  def has_clone_git_url?
+    clone_git_url = (config['clone'] && config['clone']['git'])
+    clone_git_url ? true : false
+  end
+
+  def clone_projects(group)
+    projects(group).each do |project|
+      clone_single(project) unless File.exist?(project)
+      puts "\n[#{project}] Done cloning project.\n\n"
+    end
+  end
+
+  def projects(group)
+    config[group] || []
+  end
+
+  def clone_single(project)
+    system('git', 'clone', clone_path(project))
+  end
+
+  def clone_path(project)
+    "#{ base_clone_path }/#{ project }.git"
+  end
+
+  def base_clone_path
+    base_url = config['clone']['git']
+    base_url.gsub(/\/+$/, '')
+  end
+end

data/lib/flash/command/info.rb

@@ -0,0 +1,25 @@
+require 'flash'
+require 'flash/command/base'
+
+class Flash::Command::Info < Flash::Command::Base
+  def initialize(group = nil)
+    @group = group
+  end
+
+  def execute
+    puts output(@group)
+  end
+
+  private
+
+  def output(group = nil)
+    return unknown_group(group) if group && !valid_group?(group)
+
+    result = valid_group?(group) ? config[group] : config
+    result.to_yaml
+  end
+
+  def unknown_group(group)
+    "Unknown group \"#{group}\" in .flash.yml config."
+  end
+end

data/lib/flash/command/run.rb

@@ -0,0 +1,78 @@
+require 'flash'
+require 'flash/command/base'
+require 'pathname'
+
+class Flash::Command::Run < Flash::Command::Base
+  def initialize(command, group)
+    @command = command
+    @group = group
+  end
+
+  def execute
+    raise(ArgumentError, 'Missing required command and group parameters.') unless @command && @group
+
+    unknown_group_and_exit(@group) unless valid_group?(@group)
+    run_command_in_group(@command, @group)
+  end
+
+  private
+
+  def unknown_group_and_exit(group)
+    puts "Unknown group \"#{group}\" in .flash.yml config."
+    exit 1
+  end
+
+  def run_command_in_group(command, group)
+    projects(group).each do |project|
+      color = new_color
+
+      system("cd #{ project_dir(project) }")
+      commands(command).each { |cmd| run(cmd, color: color, project: project) }
+
+      say('', color)
+    end
+  end
+
+  def projects(group)
+    config[group]
+  end
+
+  def run(command, options = {})
+    verbose = options[:verbose].nil? ? true : options[:verbose]
+    color   = options[:color]
+    project = options[:project]
+
+    prompt(command, color: color, project: project) if verbose
+    system("cd #{ project_dir(project) } ; #{ command }")
+  end
+
+  def commands(alias_or_command)
+    commands = aliases[alias_or_command] || alias_or_command
+    commands.split(';').map(&:strip)
+  end
+
+  def aliases
+    config['aliases'] || {}
+  end
+
+  def prompt(message, options)
+    color   = options[:color]
+    project = options[:project]
+
+    say("#{ project }> #{ message }", color)
+  end
+
+  def say(stuff, color)
+    prefix = "\e[38;5;#{ color }m"
+    suffix = "\e[0m"
+    system "echo '#{ prefix }#{ stuff }#{ suffix }'"
+  end
+
+  def new_color
+    rand((1..22)) * 10 + 2
+  end
+
+  def project_dir(project)
+    "#{ Dir.pwd }/#{ project }"
+  end
+end

data/lib/flash/config.rb

@@ -0,0 +1,26 @@
+require 'flash'
+require 'yaml'
+require 'delegate'
+
+class Flash::Config < SimpleDelegator
+  def initialize
+    check_config_file!
+    data = YAML.load_file(config_file)
+    super(data)
+  end
+
+  private
+
+  def check_config_file!
+    error("#{config_file} does not exist.") unless File.exist?(config_file)
+  end
+
+  def config_file
+    '.flash.yml'
+  end
+
+  def error(message)
+    puts "ERROR: #{message}"
+    exit 1
+  end
+end

data/lib/flash/version.rb

@@ -1,3 +1,3 @@
 module Flash
-  VERSION = '0.0.3'
+  VERSION = '0.1.0'
 end

data/spec/flash/cli_spec.rb

@@ -0,0 +1,88 @@
+require 'spec_helper'
+require 'flash/cli'
+
+describe Flash::CLI, :fakefs do
+  subject { described_class }
+
+  describe '.is_thor_reserved_word?' do
+    it 'should allow "run" to be defined as command' do
+      expect(subject.is_thor_reserved_word?('run', :command)).to be_falsey
+    end
+  end
+
+  describe '#clone' do
+    before { write_config_file_with_clone }
+
+    describe 'flash clone projects' do
+      let(:output) { flash('clone projects') }
+
+      it 'should show done cloning messages' do
+        expect_any_instance_of(Flash::Command::Clone)
+          .to receive(:system).exactly(3).times.and_return(nil)
+
+        expect(output).to match(/\[foo\] Done cloning project\./)
+        expect(output).to match(/\[bar\] Done cloning project\./)
+        expect(output).to match(/\[buz\] Done cloning project\./)
+      end
+    end
+  end
+
+  describe '#info' do
+    before { write_config_file }
+
+    describe 'flash info' do
+      let(:output) { flash('info') }
+
+      it 'should print all info from config file' do
+        expect(output).to match(/projects/)
+        expect(output).to match(/foo/)
+        expect(output).to match(/bar/)
+        expect(output).to match(/buz/)
+        expect(output).to match(/libraries/)
+        expect(output).to match(/cippa/)
+        expect(output).to match(/lippa/)
+      end
+    end
+
+    describe 'flash info projects' do
+      let(:output) { flash('info projects') }
+
+      it 'should print info from config file for "projects" group' do
+        expect(output).to match(/foo/)
+        expect(output).to match(/bar/)
+        expect(output).to match(/buz/)
+      end
+    end
+
+    describe 'flash info blabla' do
+      let(:output) { flash('info blabla') }
+
+      it 'should print unknown group' do
+        expect(output).to match(/Unknown group "blabla" in .flash.yml config.\n/)
+      end
+    end
+  end
+
+  describe '#run' do
+    before { write_config_file }
+
+    describe 'flash run ls projects' do
+      let(:output) { flash('run ls projects') }
+
+      it 'should not raise error' do
+        expect_any_instance_of(Flash::Command::Run)
+          .to receive(:system).exactly(12).times
+
+        output
+      end
+    end
+  end
+
+  describe '#version' do
+    let(:output) { flash('version') }
+
+    it 'should print version number' do
+      expect(output).to match(/#{Flash::VERSION}\n/)
+    end
+  end
+end

data/spec/flash/command/base_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+require 'flash/command/base'
+
+describe Flash::Command::Base, :fakefs do
+  subject { described_class.new }
+
+  before { write_config_file }
+
+  describe '#config' do
+    let(:config) { subject.config }
+
+    it 'should be of correct kind' do
+      expect(config).to be_an_instance_of(Flash::Config)
+    end
+
+    it 'should behave as Hash' do
+      expect(config).to respond_to(:[])
+    end
+  end
+
+  describe '#valid_group?' do
+    it 'responds true for valid groups' do
+      expect(subject.valid_group?('projects')).to be_truthy
+      expect(subject.valid_group?('libraries')).to be_truthy
+    end
+
+    it 'responds false otherwise' do
+      expect(subject.valid_group?('unknkown')).to be_falsey
+    end
+  end
+end

data/spec/flash/command/clone_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+require 'flash/command/clone'
+
+describe Flash::Command::Clone, :fakefs do
+  subject { described_class.new(@group) }
+
+  before { write_config_file }
+
+  describe '#execute' do
+
+    context 'with invalid group' do
+      it 'with nil group' do
+        @group = nil
+        expect { subject.execute }.to raise_error ArgumentError
+      end
+
+      it 'with empty group' do
+        @group = ''
+        output = capture_stdout do
+          expect { subject.execute }.to raise_error SystemExit
+        end
+        expect(output).to match(/Unknown group "" in .flash.yml config./)
+      end
+
+      it 'with unknown group' do
+        @group = 'unknown'
+        output = capture_stdout do
+          expect { subject.execute }.to raise_error SystemExit
+        end
+        expect(output).to match(/Unknown group "unknown" in .flash.yml config./)
+      end
+    end
+
+    context 'with valid group' do
+      before { @group = 'projects' }
+
+      describe 'without clone git endpoint' do
+        it 'should raise error' do
+          output = capture_stdout do
+            expect { subject.execute }.to raise_error SystemExit
+          end
+          expect(output).to match(/Missing clone git URL defined in .flash.yml config./)
+        end
+      end
+
+      describe 'with clone git endpoint' do
+        before { write_config_file_with_clone }
+
+        it 'should clone projects in group' do
+          expect(subject).to receive(:clone_projects).with(@group).once
+          subject.execute
+        end
+      end
+    end
+  end
+end

data/spec/flash/command/info_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+require 'flash/command/info'
+
+describe Flash::Command::Info, :fakefs do
+  subject { described_class.new(group) }
+
+  before { write_config_file }
+
+  describe '#execute' do
+    let(:group) { 'projects' }
+
+    it 'calls output method with group' do
+      expect(subject).to receive(:output).with(group).once
+      subject.execute
+    end
+  end
+end

data/spec/flash/command/run_spec.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+require 'flash/command/run'
+
+describe Flash::Command::Run, :fakefs do
+  subject { described_class.new(@command, @group) }
+
+  before { write_config_file }
+
+  describe '#execute' do
+
+    context 'with invalid args' do
+
+      it 'command and group are nil' do
+        @command, @group = [nil, nil]
+        expect { subject.execute }.to raise_error ArgumentError
+      end
+
+      it 'command and group are empty strings' do
+        @command, @group = ['', '']
+        output = capture_stdout do
+          expect { subject.execute }.to raise_error SystemExit
+        end
+        expect(output).to match(/Unknown group "" in \.flash\.yml config\./)
+      end
+
+      it 'unknown group' do
+        @command = ''
+        @group = 'unknown'
+        output = capture_stdout do
+          expect { subject.execute }.to raise_error SystemExit
+        end
+        expect(output).to match(/Unknown group "unknown" in \.flash\.yml config\./)
+      end
+    end
+
+    context 'with valid args' do
+
+      it 'example run ls command on projects group' do
+        @command = 'ls'
+        @group = 'projects'
+        expect_any_instance_of(described_class)
+          .to receive(:system).exactly(12).times
+        subject.execute
+      end
+
+      it 'calls run command in group once' do
+        @command = 'ls'
+        @group = 'projects'
+        expect_any_instance_of(described_class)
+          .to receive(:run_command_in_group).with(@command, @group).once
+        subject.execute
+      end
+    end
+  end
+end

data/spec/flash/config_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+require 'flash/config'
+
+describe Flash::Config, :fakefs  do
+  subject { described_class.new }
+
+  describe '#initialize' do
+    it 'can load from a file' do
+      write_config_file
+      expect(subject['projects']).to eq %w(foo bar buz)
+    end
+
+    it 'will exit with error message if no config file found' do
+      output = capture_stdout do
+        expect { subject }.to raise_error SystemExit
+      end
+      expect(output).to match(/ERROR: .flash.yml does not exist.\n/)
+    end
+  end
+end

data/spec/flash_spec.rb

@@ -0,0 +1,10 @@
+require 'spec_helper'
+require 'flash'
+
+describe Flash do
+
+  describe '#version' do
+    subject { Flash::VERSION }
+    it { should be_a String }
+  end
+end

data/spec/spec_helper.rb

@@ -1,7 +1,84 @@
-require 'rspec/autorun'
+if ENV['TRAVIS'] || ENV['COVERAGE']
+  require 'simplecov'
+
+  if ENV['TRAVIS']
+    require 'coveralls'
+    SimpleCov.formatter = Coveralls::SimpleCov::Formatter
+  end
+
+  SimpleCov.start do
+    add_filter '/spec'
+    add_filter '/vendor'
+  end
+end
+
+require 'rspec'
+require 'fakefs/safe'
+require 'fakefs/spec_helpers'
+
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
 
 RSpec.configure do |config|
-  config.expect_with :rspec do |c|
-    c.syntax = :expect
+  config.color = true
+  config.order = 'rand'
+  config.raise_errors_for_deprecations!
+  config.include FakeFS::SpecHelpers, :fakefs
+end
+
+def flash(args)
+  capture_stdout do
+    begin
+      Flash::CLI.start(args.split(' '))
+    rescue SystemExit
+      nil
+    end
+  end
+end
+
+def write_config_file_with_clone
+  clone_contents = <<-SECTION
+    clone:
+      git: git@github.com:SuperDuper
+  SECTION
+
+  write_config_file(contents: default_contents + clone_contents)
+end
+
+def write_config_file(options = {})
+  config_file = options[:config_file] || '.flash.yml'
+  contents    = options[:contents] || default_contents
+
+  File.open(config_file, 'w') do |file|
+    contents.split('\n').each do |line|
+      file.puts line
+    end
   end
+  File.expand_path(config_file)
+end
+
+def default_contents
+  <<-CONTENTS
+    projects:
+      - foo
+      - bar
+      - buz
+    libraries:
+      - cippa
+      - lippa
+  CONTENTS
+end
+
+def make_pipe
+  IO.method(:pipe).arity.zero? ? IO.pipe : IO.pipe('BINARY')
+end
+
+def capture_stdout
+  old_stdout = $stdout.dup
+  rd, wr = make_pipe
+  $stdout = wr
+  yield
+  wr.close
+  rd.read
+ensure
+  $stdout = old_stdout
 end

metadata

@@ -1,70 +1,80 @@
 --- !ruby/object:Gem::Specification
 name: flash
 version: !ruby/object:Gem::Version
-  version: 0.0.3
-  prerelease: 
+  version: 0.1.0
 platform: ruby
 authors:
 - Marius Colacioiu
 autorequire: 
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2014-01-03 00:00:00.000000000 Z
-dependencies: []
-description: Flash helps you run commands on multiple projects all defined in the
-  Runfile
+date: 2014-08-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+description: Flash helps you run same commands on multiple projects all defined in
+  the `.flash.yml` config.
 email:
 - marius.colacioiu@gmail.com
 executables:
-- run
+- flash
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- Gemfile
-- Gemfile.lock
 - README.md
-- Rakefile
-- bin/run
-- example/Runfile
-- example/dancing/bouncing
-- example/salsa/cubana
-- example/school/fun
-- flash.gemspec
+- exe/flash
 - lib/flash.rb
-- lib/flash/runfile.rb
-- lib/flash/runner.rb
+- lib/flash/cli.rb
+- lib/flash/command.rb
+- lib/flash/command/base.rb
+- lib/flash/command/clone.rb
+- lib/flash/command/info.rb
+- lib/flash/command/run.rb
+- lib/flash/config.rb
 - lib/flash/version.rb
+- spec/flash/cli_spec.rb
+- spec/flash/command/base_spec.rb
+- spec/flash/command/clone_spec.rb
+- spec/flash/command/info_spec.rb
+- spec/flash/command/run_spec.rb
+- spec/flash/config_spec.rb
+- spec/flash_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/colmarius/flash
 licenses:
-- MIT
+- Apache-2.0
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -4469809819880840159
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -4469809819880840159
 requirements: []
-rubyforge_project: flash
-rubygems_version: 1.8.25
+rubyforge_project: 
+rubygems_version: 2.3.0
 signing_key: 
-specification_version: 3
-summary: Flash helps you run commands on multiple projects all defined in the Runfile
+specification_version: 4
+summary: Flash helps you run same commands on multiple projects all defined in the
+  `.flash.yml` config.
 test_files: []

data/.gitignore

@@ -1 +0,0 @@
-*.gem

data/Gemfile

@@ -1,8 +0,0 @@
-source 'https://rubygems.org'
-
-gemspec
-
-group :development do
-  gem 'rake',  '~> 0.9'
-  gem 'rspec', '~> 2.0'
-end

data/Gemfile.lock

@@ -1,26 +0,0 @@
-PATH
-  remote: .
-  specs:
-    flash (0.0.3)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    diff-lcs (1.2.5)
-    rake (0.9.6)
-    rspec (2.14.1)
-      rspec-core (~> 2.14.0)
-      rspec-expectations (~> 2.14.0)
-      rspec-mocks (~> 2.14.0)
-    rspec-core (2.14.7)
-    rspec-expectations (2.14.4)
-      diff-lcs (>= 1.1.3, < 2.0)
-    rspec-mocks (2.14.4)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  flash!
-  rake (~> 0.9)
-  rspec (~> 2.0)

data/Rakefile

@@ -1,16 +0,0 @@
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new do |task|
-  task.name = 'spec'
-  task.rspec_opts = ['-c',' -f', 'd']
-end
-
-task :build do
-  system "gem build flash.gemspec"
-end
-
-task :release => :build do
-  system "gem push flash-#{Flash::VERSION}.gem"
-end
-
-task :default => :spec

data/bin/run

@@ -1,44 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'optparse'
-require 'pathname'
-require 'flash'
-require 'flash/runner'
-
-options = {}
-optparse = OptionParser.new do |opts|
-  opts.banner = "Usage: run [options] group"
-
-  opts.on("-c", "--command command", String, "Commands to run (semicolon separated)") do |command|
-    options[:commands] = command.split(';').map(&:strip)
-  end
-
-  opts.on("-d", "--debug", "Debug: print each command result") do |d|
-    options[:debug] = d
-  end
-
-  opts.on("-r", "--recipe recipe", "Run registered recipe if present") do |recipe|
-    options[:recipe] = recipe
-  end
-
-  opts.on("-l", "--list-recipes", "List registered recipes") do |l|
-    options[:list_recipes] = l
-  end
-
-  opts.on("-h", "--help", "Help documentation") do
-    puts opts ; exit
-  end
-
-  opts
-end
-
-optparse.parse!
-
-if ARGV.empty?
-  puts "Group name is missing."
-  puts optparse ; exit
-end
-
-group = ARGV[0]
-
-Flash::Runner.new(options, group).start

data/example/Runfile

@@ -1,8 +0,0 @@
-projects:
-  - salsa
-  - dancing
-  - school
-
-some:
-  - salsa
-  - school

data/example/dancing/bouncing

@@ -1 +0,0 @@
-test

data/example/salsa/cubana

@@ -1 +0,0 @@
-test

data/example/school/fun

@@ -1 +0,0 @@
-test

data/flash.gemspec

@@ -1,23 +0,0 @@
-# -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-
-require "flash/version"
-
-Gem::Specification.new do |gem|
-  gem.name    = "flash"
-  gem.license = "MIT"
-  gem.version = Flash::VERSION
-
-  gem.author   = ["Marius Colacioiu"]
-  gem.email    = ["marius.colacioiu@gmail.com"]
-  gem.homepage = "http://github.com/colmarius/flash"
-  gem.summary  = %q{ Flash helps you run commands on multiple projects all defined in the Runfile }
-  
-  gem.description = gem.summary
-
-  gem.rubyforge_project = "flash"
-
-  gem.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  gem.files = `git ls-files`.split("\n")
-  gem.test_files = `git ls-files -- {spec}`.split("\n")
-end

data/lib/flash/runfile.rb

@@ -1,19 +0,0 @@
-require 'flash'
-require 'yaml'
-
-class Flash::Runfile
-
-  attr_reader :groups
-
-  def initialize(filename=nil)
-    load(filename) if filename
-  end
-
-  def [](name=nil)
-    @groups[name] if name
-  end
-
-  def load(filename)
-    @groups = YAML.load_file(filename) if File.exists?(filename)
-  end
-end

data/lib/flash/runner.rb

@@ -1,80 +0,0 @@
-require 'flash'
-require 'flash/runfile'
-
-class Flash::Runner
-  attr_reader :options
-  attr_accessor :debug, :color, :dir_name, :runfile, :group
-
-  def initialize(options = {}, group)
-    raise "Missing required group parameter." unless group
-
-    @options = options
-    @runfile = Flash::Runfile.new('Runfile')
-    @group = group
-  end
-
-  def pwd
-    Dir.pwd
-  end
-
-  def run(command, verbose=true)
-    say "#{ prompt }#{ command }" if verbose
-    system "cd #{ app_dir } && #{ command }"
-    say "[Debug] Result: #{ $?.inspect }" if verbose && debug
-  end
-
-  def recipes
-    @recipes ||= {
-      'update-master' => 'git stash ; git checkout master ; git pull ; git stash pop',
-      'status' => 'git status -s',
-      'branch' => 'git branch'
-    }
-  end
-
-  def list_recipes
-    recipes.each_pair { |recipe, commands| puts %Q(#{ recipe }:\n\t"#{ commands }"\n\n) }
-  end
-
-  def commands(recipe)
-    commands = recipes[recipe] ? recipes[recipe] : 'echo "Unknown recipe!"'
-    commands.split(';').map(&:strip)
-  end
-
-  def say(stuff)
-    prefix = "\e[38;5;#{ color }m"
-    suffix = "\e[0m"
-    system "echo '#{ prefix }#{ stuff }#{ suffix }'"
-  end
-
-  def change_color!
-    self.color = rand((1..22)) * 10 + 2
-  end
-
-  def app_dir
-    "#{ pwd }/#{ dir_name }"
-  end
-
-  def prompt
-    "#{ dir_name }> "
-  end
-
-  def group_dirs
-    runfile[group]
-  end
-
-  def start
-    list_recipes and exit if options[:list_recipes]
-
-    self.debug = options[:debug]
-    group_dirs.each do |dir_name|
-      change_color!
-      self.dir_name = dir_name
-      run "cd #{ pwd }/#{ dir_name }", false
-
-      commands = options[:recipe] ? commands(options[:recipe]) : options[:commands]
-      commands.each { |command| run(command) }\
-
-      say ""
-    end
-  end
-end