syllabus 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a4012747bcc3f4369b0a20f30051bbc5bf226346
+  data.tar.gz: 755672d82968498ce8d5d4fefd0b5b3b84d8db4e
+SHA512:
+  metadata.gz: adab2311b152819ccfb88ac76cbe4521a484b5276f1e5260ec0016ab0dcd5e135945002e59e694e10913a7b05f3ff072c8f1521a5962f67fdd2555d0df717e94
+  data.tar.gz: 84bb6879c1f1c27e33033bb9ac344eb54ff354b310afa354bbcd541c98b7de217762dcb06f61f9bb70606d34a848c30a7c91b015967faf9553e5c506b17db0ea

data/.gitignore

@@ -0,0 +1,19 @@
+*.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
+/.bundle

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+
+rvm:
+  - 1.9.2
+  - 1.9.3
+  - ruby-head

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Kentaro Kuribayashi
+
+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,74 @@
+# Syllabus [![BuildStatus](https://travis-ci.org/kentaro/syllabus.png)](http://travis-ci.org/kentaro/syllabus)
+
+Syllabus is a configuration management tool for the era of "immutable infrastructure." which just provides a thin abstraction layer onto plain shell script.
+
+## Commands
+
+### `init`
+
+`init` sets up files to start configuration management with Syllabus.
+
+```
+$ syllabus init
+```
+
+This creates `syllabus.rb` into the current working directory.
+
+### `exec`
+
+`exec` reads the configuration from the file specified by `--file` option and executes commands along with the type specified `--type` option.
+
+```
+$ syllabus exec --file examples/mac.rb --type Exec
+```
+
+`--type` can be either one of the type which are provided by [SpecInfra](https://github.com/mizzy/).
+
+## Configuration
+
+Syllabus provides a simple DSL to configure servers like below:
+
+```
+os_type 'Darwin'
+hosts   %[app1.example.com app2.example.com]
+path    '/path/to/bin'
+
+install 'httpd'
+install 'git'
+# ...
+```
+
+### Configuration for Syllabus
+
+There are serveral methods to configure Syllabus itself.
+
+  * `os_type`: The type of OS of the servers to be configured
+  * `hosts`: Servers to be configured by Syllabus
+  * `path`: `PATH` environment variable to be set on the servers
+
+### Configuration for Servers
+
+  * `install`: Specifies a package to be installed
+  * (TODO)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'syllabus'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install syllabus
+
+## 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,11 @@
+require 'bundler/gem_tasks'
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+  spec.ruby_opts = %w[-w]
+end
+
+task :default => :spec

data/bin/syllabus

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'syllabus'
+Syllabus::CLI.start(ARGV)
+

data/examples/mac.rb

@@ -0,0 +1,4 @@
+os_type 'Darwin'
+hosts   %w[localhost]
+path    ENV['PATH']
+install 'git'

data/lib/syllabus/backend.rb

@@ -0,0 +1,25 @@
+require 'delegate'
+require 'specinfra/backend'
+
+class Syllabus::Backend < Delegator
+  attr_reader :backend_type
+
+  class NotImplementedError < StandardError; end
+
+  def initialize(args)
+    @backend_type = args[:type]
+    @backend      = backend_class.instance
+  end
+
+  def backend_class
+    if SpecInfra::Backend.const_defined?(backend_type.to_sym)
+      SpecInfra::Backend.const_get(backend_type.to_sym)
+    else
+      raise NotImplementedError.new("Backend for #{backend_type} has not been implemented yet")
+    end
+  end
+
+  def __getobj__
+    @backend
+  end
+end

data/lib/syllabus/cli.rb

@@ -0,0 +1,27 @@
+require 'thor'
+require 'syllabus/core'
+
+class Syllabus::CLI < Thor
+  desc 'init', 'Sets up files to start configuration management with Syllabus.'
+  def init
+    configuration = <<'EOS'
+# This is a configuration file for syllabus.
+
+# Packages
+# package 'httpd'
+EOS
+    File.write('syllabus.rb', configuration)
+  end
+
+  desc 'exec [--file FILE], [--type TYPE]', 'Execute commands against backend(s) according to a backend type'
+  option :type,  default: 'exec'
+  option :file,  default: 'syllabus.rb'
+  option :level, default: 'info'
+  def exec
+    Syllabus::Core.run(
+      type:  options[:type],
+      file:  options[:file],
+      level: options[:level],
+    )
+  end
+end

data/lib/syllabus/command/base.rb

@@ -0,0 +1,2 @@
+class Syllabus::Command::Base < Configspec::Commands::Base
+end

data/lib/syllabus/command/darwin.rb

@@ -0,0 +1,5 @@
+class Syllabus::Command::Darwin < Configspec::Commands::Base
+  def install(package)
+    cmd = "brew install '#{package}'"
+  end
+end

data/lib/syllabus/command/linux.rb

@@ -0,0 +1,2 @@
+class Syllabus::Command::Linux < Configspec::Commands::Linux
+end

data/lib/syllabus/command/redhat.rb

@@ -0,0 +1,2 @@
+class Syllabus::Command::RedHat < Configspec::Commands::RedHat
+end

data/lib/syllabus/command.rb

@@ -0,0 +1,28 @@
+require 'configspec/commands/base'
+require 'configspec/commands/linux'
+require 'configspec/commands/redhat'
+
+class Syllabus::Command
+  attr_reader :os_type, :name, :args
+
+  class NotImplementedError < StandardError; end
+
+  def initialize(args)
+    @os_type = args[:os_type]
+    @name    = args[:name]
+    @args    = args[:args]
+  end
+
+  def command_class
+    if Syllabus::Command.const_defined?(os_type.to_sym)
+      Syllabus::Command.const_get(os_type.to_sym)
+    else
+      raise NotImplementedError.new("Command for #{os_type} has not been implemented yet")
+    end
+  end
+
+  def to_s
+    command = command_class.new
+    command.send(name.to_sym, args.first)
+  end
+end

data/lib/syllabus/config.rb

@@ -0,0 +1,49 @@
+class Syllabus::Config
+  attr_reader :commands
+
+  def self.new_from_file(file)
+    configuration = File.read(file)
+    new(configuration, file)
+  end
+
+  def initialize(configuration, file = '')
+    @hosts    = nil
+    @os_type  = nil
+    @commands = []
+    instance_eval(configuration, file)
+  end
+
+  def hosts(arg = nil)
+    if arg
+      @hosts = arg.kind_of?(Proc) ? arg.call : arg
+    end
+
+    @hosts
+  end
+
+  def os_type(arg = nil)
+    if arg
+      @os_type = arg.kind_of?(Proc) ? arg.call : arg
+    end
+
+    @os_type
+  end
+
+  def path(arg = nil)
+    if arg
+      @path = arg.kind_of?(Proc) ? arg.call : arg
+      SpecInfra::Configuration.path = @path
+    end
+
+    @path
+  end
+
+  def method_missing(name, *args)
+    command = Syllabus::Command.new(
+      os_type: os_type,
+      name:    name,
+      args:    args,
+    )
+    @commands.push(command)
+  end
+end

data/lib/syllabus/core.rb

@@ -0,0 +1,12 @@
+class Syllabus::Core
+  def self.run(args)
+    config  = Syllabus::Config.new_from_file(args[:file])
+    backend = Syllabus::Backend.new(type: args[:type])
+    logger  = Syllabus::Logger.new(level: args[:level])
+
+    config.commands.each do |command|
+      result = backend.run_command(command.to_s)
+      logger.log(command, result)
+    end
+  end
+end

data/lib/syllabus/logger.rb

@@ -0,0 +1,30 @@
+require 'logger'
+require 'term/ansicolor'
+
+class Syllabus::Logger
+  include Term::ANSIColor
+
+  def initialize(args)
+    @level        = args[:level] || 'info'
+    @logger       = ::Logger.new(args[:io] || STDOUT)
+    @logger.level = log_level_for(@level)
+  end
+
+  def log_level_for(level)
+    Logger.const_get(level.upcase.to_sym)
+  end
+
+  def log(command, result)
+    message = ''
+
+    if result[:exit_status] == 0
+      message << green(command.to_s)
+    else
+      message << "\n#{red(command.to_s)}"
+      message << "\n  stdout: #{result[:stdout]}" if result[:stdout]
+      message << "\n  stderr: #{result[:stderr]}" if result[:stderr]
+    end
+
+    @logger.send(@level.to_sym, message)
+  end
+end

data/lib/syllabus/version.rb

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

data/lib/syllabus.rb

@@ -0,0 +1,16 @@
+module Syllabus
+  require 'syllabus/version'
+  require 'syllabus/cli'
+  require 'syllabus/core'
+  require 'syllabus/logger'
+  require 'syllabus/config'
+  require 'syllabus/backend'
+  require 'syllabus/command'
+  require 'syllabus/command/base'
+  require 'syllabus/command/darwin'
+  require 'syllabus/command/linux'
+  require 'syllabus/command/redhat'
+end
+
+require 'specinfra'
+

data/spec/lib/syllabus/backend_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+describe Syllabus::Backend do
+  describe '#backend_class' do
+    context 'when a backend class found' do
+      subject {
+        Syllabus::Backend.new(type: 'Exec')
+      }
+
+      it { expect(subject.backend_class).to be == SpecInfra::Backend::Exec }
+    end
+
+    context 'when no command class found' do
+      subject {
+        Syllabus::Backend.new(type: 'NoSuchType')
+      }
+
+      it {
+        expect { subject.backend_class }.to raise_error Syllabus::Backend::NotImplementedError
+      }
+    end
+  end
+end

data/spec/lib/syllabus/command_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+describe Syllabus::Command do
+  describe '#command_class' do
+    context 'when a command class found' do
+      subject {
+        Syllabus::Command.new(
+          os_type: 'RedHat',
+          name:    :install,
+          args:    %w['httpd'],
+        )
+      }
+
+      it { expect(subject.command_class).to be == Syllabus::Command::RedHat }
+    end
+
+    context 'when no command class found' do
+      subject {
+        Syllabus::Command.new(
+          os_type: 'NoSuchType',
+          name:    :install,
+          args:    %w['httpd'],
+        )
+      }
+
+      it {
+        expect { subject.command_class }.to raise_error Syllabus::Command::NotImplementedError
+      }
+    end
+  end
+
+  describe '#to_s' do
+    context 'when a command class found' do
+      subject {
+        Syllabus::Command.new(
+          os_type: 'RedHat',
+          name:    :install,
+          args:    %w['httpd'],
+        )
+      }
+
+      it { expect(subject.to_s).to be == "yum -y install 'httpd'" }
+    end
+
+    context 'when no command class found' do
+      subject {
+        Syllabus::Command.new(
+          os_type: 'NoSuchType',
+          name:    :install,
+          args:    %w['httpd'],
+        )
+      }
+
+      it {
+        expect { subject.to_s }.to raise_error Syllabus::Command::NotImplementedError
+      }
+    end
+  end
+end

data/spec/lib/syllabus/config_spec.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+
+describe Syllabus::Config do
+  describe '#hosts' do
+    context 'Hosts are passed as an Array' do
+      let(:config) {
+        <<EOS
+hosts %w[foo bar baz]
+EOS
+      }
+      subject {
+        described_class.new(config)
+      }
+
+      it { expect(subject.hosts).to be == %w[foo bar baz] }
+    end
+
+    context 'Hosts are passed as a Proc' do
+      let(:config) {
+        <<EOS
+hosts -> { %w[foo bar baz] }
+EOS
+      }
+      subject {
+        described_class.new(config)
+      }
+
+      it { expect(subject.hosts).to be == %w[foo bar baz] }
+    end
+  end
+
+  describe '#os_type' do
+    context 'os_type are passed as a String' do
+      let(:config) {
+        <<EOS
+os_type 'RedHat'
+EOS
+      }
+      subject {
+        described_class.new(config)
+      }
+
+      it { expect(subject.os_type).to be == 'RedHat' }
+    end
+
+    context 'os_type are passed as a Proc' do
+      let(:config) {
+        <<EOS
+os_type -> { 'RedHat' }
+EOS
+      }
+      subject {
+        described_class.new(config)
+      }
+
+      it { expect(subject.os_type).to be == 'RedHat' }
+    end
+  end
+
+  describe '#method_missing' do
+    let(:config) {
+      <<EOS
+install 'httpd'
+EOS
+    }
+    subject {
+      described_class.new(config)
+    }
+
+    it {
+      expect(subject.commands.length).to be == 1
+      expect(subject.commands.first).to  be_an_instance_of Syllabus::Command
+    }
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require_relative '../lib/syllabus'
+

data/syllabus.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'syllabus/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'syllabus'
+  spec.version       = Syllabus::VERSION
+  spec.authors       = ['Kentaro Kuribayashi']
+  spec.email         = ['kentarok@gmail.com']
+  spec.description   = %q{Yet Another Configuration Management Tool in the Era of Immutable Infrastructure}
+  spec.summary       = %q{Yet Another Configuration Management Tool in the Era of Immutable Infrastructure}
+  spec.homepage      = ''
+  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 'specinfra'
+  spec.add_dependency 'configspec'
+  spec.add_dependency 'thor'
+  spec.add_dependency 'term-ansicolor'
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+end

metadata

@@ -0,0 +1,158 @@
+--- !ruby/object:Gem::Specification
+name: syllabus
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Kentaro Kuribayashi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: specinfra
+  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'
+- !ruby/object:Gem::Dependency
+  name: configspec
+  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'
+- !ruby/object:Gem::Dependency
+  name: thor
+  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'
+- !ruby/object:Gem::Dependency
+  name: term-ansicolor
+  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'
+- !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'
+description: Yet Another Configuration Management Tool in the Era of Immutable Infrastructure
+email:
+- kentarok@gmail.com
+executables:
+- syllabus
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/syllabus
+- examples/mac.rb
+- lib/syllabus.rb
+- lib/syllabus/backend.rb
+- lib/syllabus/cli.rb
+- lib/syllabus/command.rb
+- lib/syllabus/command/base.rb
+- lib/syllabus/command/darwin.rb
+- lib/syllabus/command/linux.rb
+- lib/syllabus/command/redhat.rb
+- lib/syllabus/config.rb
+- lib/syllabus/core.rb
+- lib/syllabus/logger.rb
+- lib/syllabus/version.rb
+- spec/lib/syllabus/backend_spec.rb
+- spec/lib/syllabus/command_spec.rb
+- spec/lib/syllabus/config_spec.rb
+- spec/spec_helper.rb
+- syllabus.gemspec
+homepage: ''
+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.3
+signing_key: 
+specification_version: 4
+summary: Yet Another Configuration Management Tool in the Era of Immutable Infrastructure
+test_files:
+- spec/lib/syllabus/backend_spec.rb
+- spec/lib/syllabus/command_spec.rb
+- spec/lib/syllabus/config_spec.rb
+- spec/spec_helper.rb