rubycut-babushka 0.10.6

data/Gemfile

@@ -0,0 +1,8 @@
+source "http://rubygems.org"
+
+group :test do
+  gem 'rake'
+  gem 'rspec'
+  gem 'fuubar'
+  gem 'cloudservers'
+end

data/Gemfile.lock

@@ -0,0 +1,31 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    cloudservers (0.4.1)
+      json
+    diff-lcs (1.1.2)
+    fuubar (0.0.6)
+      rspec (~> 2.0)
+      rspec-instafail (~> 0.1.8)
+      ruby-progressbar (~> 0.0.10)
+    json (1.5.3)
+    rake (0.9.2)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-instafail (0.1.8)
+    rspec-mocks (2.6.0)
+    ruby-progressbar (0.0.10)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  cloudservers
+  fuubar
+  rake
+  rspec

data/README.markdown

@@ -0,0 +1,246 @@
+# About this repo
+
+While using this gem, keep in mind:
+
+* This software is packaged as rubycut-babushka, since author asked us not to use babushka as gem name since he wants to keep only one way of installing babushka (see https://github.com/benhoskings/babushka/issues/173 for details)
+* by using this babushka as gem, it is not possible for babushka to configure ruby and rubygems 
+* switching the active rvm/rbenv ruby, or installing a new ruby that shadows the existing one, changes the set of gems that are in the path, which would make it look like babushka had disappeared.
+* lot of tools are confined to a single set of gems, or a single bundle. But babushka should exist outside of those things so it can configure them.
+* This is unstandard way to install babushka, standard way is explained at: http://babushka.me/installing
+* This gem is built using https://github.com/rubycut/babushka, we try to follow main repo but can not guearantee that we will produce gem same day official babushka version comes out
+* we will not be adding any new code to babhushka source code for now, but we will add more source documentation
+
+
+## Development status
+
+This gem is not fully tested in realistic environment, although all the spec work.
+
+# babushka: test-driven sysadmin.
+
+When you spend time researching something new, it's pretty easy to forget what you found, and have to re-research it again next time.
+
+A lot of the tech jobs we do manually aren't challenging or fun, but they're finicky and have to be done just right. They're chores. Things that are important to do, but that are better automated than done manually by us people, right? After all, that's what is supposed to happen in the future. And the future is good, because in the future, we'll all have jetpants. So, onward.
+
+The idea is this: you take a job that you'd rather not do manually, and describe it to babushka using its DSL. The way it works, babushka not only knows how to accomplish each part of the job, it also knows how to check if each part is already done. You're teaching babushka to achieve an end goal with whatever runtime conditions you throw at it, not just to perform the task that would get you there from the very start.
+
+
+# installing
+
+Installing is really easy on supported systems (currently, OS X and Ubuntu). All it takes is one command, and it can be the first command you run on the machine. (Babushka will happily install on any machine though, not just new ones.)
+
+If you have curl (OS X):
+
+    bash -c "`curl babushka.me/up`"
+
+If you have wget (Ubuntu):
+
+    bash -c "`wget -O - babushka.me/up`"
+
+
+# kicking the tyres
+
+Once the install process has finished, you're ready to rock. If you have a Mac, maybe a good example is to install homebrew. To do that, we run the dependency (in babushka parlance, 'dep') called `homebrew`:
+
+    babushka homebrew
+
+Or check that your rubygems install is looking good - latest version + gem sources. This demonstrates how babushka works: it's the goal (rubygems set up well) that's important. You can safely run this whether rubygems is outdated, up to date, or missing, and babushka will work out what tasks need to be done in order to achieve the end goal. The `rubygems` dep handles that for us:
+
+    babushka rubygems
+
+Things like rubygems and homebrew aren't hard to install on their own, but with babushka it's _really_ easy, and _fast_. But more importantly, you know the job is being done just right, every time.
+
+OK, something more complex now---a full nginx/passenger stack.
+
+    babushka benhoskings:'webserver configured'
+
+Then you can set up each virtualhost with
+
+    babushka benhoskings:'vhost configured'
+
+That's how I set up all my production machines. If something isn't working, you have a list of things that aren't the culprit: everything in the output with a green √ beside it. Conversely, if babushka can detect the problem, the failing dep will have a red × beside it instead, which leads you straight to the cause of the problem. Test-driven sysadmin!
+
+
+# nothing up my sleeve…
+
+Creating and sharing this knowledge is central to babushka. It's all very well to run `babushka rubygems` and have it do a job for you, but the real power is in babushka's ability to automate whatever chore you want, not just ones that others have thought of already.
+
+To that end, I've tried really hard to make the process quick and satisfying. If you spend a little bit of time getting the feel for how to efficiently use babushka's DSL, you'll be cranking out deps just like the `rubygems` and `homebrew` ones above.
+
+
+## yeah, but how?
+
+A dep is one single piece of a larger task. A little nugget of code that does just one thing, and does it right. Here's a babushka dep, at its most generic.
+
+    dep 'name' do
+      requires 'other deps', 'whatever they might be'
+      met? {
+        # is this dependency already met?
+      }
+      meet {
+        # this code gets run if it isn't.
+      }
+    end
+
+The important bit here is that when you're writing a dep, you don't have to think about context at all, just the one little task it's doing in isolation. As long as your `requires` are correct, you can leave the overall structure to babushka and just write each little dep separately. When you run `babushka name`, babushka uses the `requires` in each dep to assemble a tree of deps and achieve the end goal you're after.
+
+The idea is to keep a clean separation between `met?` and `meet`: the code in `met?` should do nothing except just check whether the dep is met and return a boolean, and `meet` should unconditionally satisfy the dep without doing any checks.
+
+Right, here's one I prepared earlier. Given you're on a Mac with Xcode installed, this dep knows how to achieve the goal of having llvm available in the PATH.
+
+    dep 'llvm in path', :for => :snow_leopard do
+      requires 'xcode tools'
+      met? { which 'llvm-gcc-4.2' }
+      meet {
+        cd('/usr/local/bin') {|path|
+          shell "ln -s /Developer/usr/llvm-gcc-4.2/bin/llvm* .", :sudo => !path.writable?
+        }
+      }
+    end
+
+All the common logic is handled by babushka, which means that all the code in the dep is specific to the job at hand. The idea is maximising that signal-to-noise ratio: as much of the code in the dep above should be talking about llvm, not about other things that can be inferred elsewhere.
+
+Notice that there's no conditional or nested logic within the dep. That's by design: the more declarative things are, the more composable and re-interpretable they are later.
+
+If you find you're checking for the presence of some condition in your `meet` block, it probably means you're trying to do too much in a single dep, and you should be splitting it up into smaller ones. Remember, deps are small, self-contained and context-free - the more focused, the better.
+
+
+## let's get declarative
+
+The basic dep, with just `requires`, `met?` and `meet`, is all you need to describe an end goal. But this generic nature of `met?` and `meet` means just as they're general purpose, they can lack focus. For example, installing an app using the system's package manager has a predictable `met?` block---check whether the package is present and its binaries are in the path.
+
+A lot of chores are variations on a theme like this, or just too cumbersome to do repeatedly at a low level. So babushka provides a way to write dep templates, or _meta deps_, that can be reused later. These meta deps allow you to focus the DSL, and make it even more concise.
+
+For example, Babushka ships with a meta dep that knows how to install TextMate bundles, given just the URL. All the actual logic, including the code for `met?` and `meet`, is wrapped up in the meta dep.
+
+    meta :tmbundle, :for => :osx do
+      accepts_list_for :source
+
+      template {
+        requires 'TextMate.app'
+        def path
+          '~/Library/Application Support/TextMate/Bundles' / name
+        end
+        met? { path.dir? }
+        before { shell "mkdir -p #{path.parent}" }
+        meet {
+          source.each {|uri|
+            git uri, :to => path
+          }
+        }
+        after { shell %Q{osascript -e 'tell app "TextMate" to reload bundles'} }
+      }
+    end
+
+Notice how the contents of the `template` block looks like a normal dep. That's cause it is---the meta dep is a factory, that takes values defined by `accepts_list_for` (in this case, `source`) and produces regular deps at runtime under the covers.
+
+Given the `tmbundle` meta dep, this dep handles the cucumber bundle:
+
+    dep 'Cucumber.tmbundle' do
+      source 'git://github.com/bmabey/cucumber-tmbundle.git'
+    end
+
+Notice there's no imperative code there at all---just declarations. That's what the DSL aims for. Instead of saying "do this, then do this, then do this", the code should say "here's a description of the problem, now you work it out." Also notice that there's no TextMate-specific logic. Adding this extra level of abstraction means all that's left are the specifics for _this_ TextMate bundle.
+
+
+# a runtime example
+
+All that means that babushka isn't just blindly running a bunch of code to make things happen. Each step of the way, it's checking what should be done, and only doing the bits that aren't done already. (In babushka parlance, it's only meeting dependencies that aren't already met.)
+
+If you already have TextMate installed, babushka notices and just installs the bundle.
+
+    Cucumber.tmbundle {
+      TextMate.app {
+        Found at /Applications/TextMate.app.
+      } √ TextMate.app
+      not already met.
+      Cloning from git://github.com/bmabey/cucumber-tmbundle.git... done.
+      Cucumber.tmbundle met.
+    } √ Cucumber.tmbundle
+
+But if you don't have TextMate, that's an unmet dependency, so it gets pulled in too.
+
+    Cucumber.tmbundle {
+      TextMate.app {
+        not already met.
+        Downloading http://download-b.macromates.com/TextMate_1.5.9.dmg... done.
+        Attaching TextMate_1.5.9.dmg... done.
+        Found TextMate.app in the DMG, copying to /Applications... done.
+        Detaching TextMate_1.5.9.dmg... done.
+        Found at /Applications/TextMate.app.
+        TextMate.app met.
+      } √ TextMate.app
+      not already met.
+      Cloning from git://github.com/bmabey/cucumber-tmbundle.git... done.
+      Cucumber.tmbundle met.
+    } √ Cucumber.tmbundle
+
+
+## dep sources
+
+Babushka only contains the deps that it needs to know how to install itself, and set up a bare minimum of software like package managers, `ruby` and `git`. Everything else is stored separately, in _dep sources_. A dep source is a babushka-managed git repo that contains a bunch of ruby files.
+
+The organisation and naming of the files within the source is completely up to you - babushka will recursively load all the .rb files it can find in the source, in alphabetical order.
+
+You can define deps and templates in the same source, arranged however you like. You don't have to worry about having templates loaded before deps that are defined against them, because the load is a two-stage process that first reads every file and sets up the templates, and then defines all the deps that were found.
+
+The best way manage your own source is to make <tt>~/.babushka/deps</tt> a git repo, and push it to <tt>git://github.com/username/babushka-deps.git</tt>.
+
+To run deps from others' sources, you don't need to add the source explicitly. Just prefix the dep name with the correct username:
+
+    babushka freelancing-god:rvm
+
+The dep source will be cloned into <tt>~/.babushka/sources/freelancing-god</tt>, or updated if it's already there, and then babushka will search for a dep called "rvm" within that source. Because of this partitioning, you don't have to worry about naming conflicts with other people; everything is per-source.
+
+If you want to rename a source, or add one with a custom URL, you can add sources manually like this:
+
+    babushka sources -a custom-name git://example.com/custom/url.git
+
+That will make the source available in <tt>~/.babushka/sources/custom-name</tt>.
+
+There's no configuration file for dep sources; the only state is stored in the contents of <tt>~/.babushka/sources</tt>. Specifically, the source names are the directory names, and the URLs are the locations of the corresponding 'origin' git remotes.
+
+Because of this, you can safely add, remove, rename and edit the directories and repositories in there as much as you like---but importantly, *babushka assumes it has free run of <tt>~/.babushka/sources</tt>, and won't hesitate to `git reset --hard`. If you leave uncommitted or unpushed changes in a source, they'll be lost when that source is updated.*
+
+If you want to write deps just for yourself that you don't plan to push online, just drop them in <tt>~/.babushka/deps</tt>. If you'd rather keep them elsewhere, like in <tt>~/src</tt> or similar, you can symlink the directory into <tt>~/.babushka/deps</tt>.
+
+Finally, babushka also loads deps from `./babushka-deps` in the directory from which it was run. This is a good place for project-specific deps, because you can keep them within the project's source control.
+
+
+## n.b.
+
+A dep can run any code. Run deps of unknown origin at your own risk, and when choosing deps and dep sources, use the only real security there is: a network of trust.
+
+Many deps will change your system irreversibly, which is kind of the whole point, but it has to be said anyway. Use caution and always have a backup.
+
+
+## acknowledgements
+
+[Fancypath](http://github.com/tred/fancypath/), by [Myles Byrne](http://www.myles.id.au/) & [Chris Lloyd](http://thelincolnshirepoacher.com/). It's how I made the paths so fancy.
+
+[Levenshtein](http://raa.ruby-lang.org/project/levenshtein/), for typo correction. Thanks to [Paul Battley](http://twitter.com/threedaymonk) for letting me dual-license it under BSD.
+
+Thanks to my rubyist friends who've helped with brainstorming and testing---the likes of
+[@glenmaddern](http://twitter.com/glenmaddern),
+[@nathan_scott](http://twitter.com/nathan_scott),
+[@notahat](http://twitter.com/notahat),
+[@quamen](http://twitter.com/quamen),
+[@dgoodlad](http://twitter.com/dgoodlad),
+[@chrisberkhout](http://twitter.com/chrisberkhout),
+[@pat](http://twitter.com/pat),
+[@brentsnook](http://twitter.com/brentsnook),
+[@odaeus](http://twitter.com/odaeus),
+[@lachlanhardy](http://twitter.com/lachlanhardy),
+[@aussiegeek](http://twitter.com/aussiegeek),
+[@bjeanes](http://twitter.com/bjeanes),
+[@chendo](http://twitter.com/chendo),
+[@ryanbigg](http://twitter.com/ryanbigg) &
+[@drnic](http://twitter.com/drnic).
+
+
+## license
+
+Babushka is licensed under the BSD license, except for the following exception:
+
+lib/support/levenshtein.rb, which is licensed under the MIT license.
+
+The BSD license can be found in full in the LICENSE file, and the MIT license at the top of lib/support/levenshtein.rb.

data/Rakefile

@@ -0,0 +1,26 @@
+require 'rake'
+require 'rspec/core/rake_task'
+
+desc 'Run the spec suite'
+RSpec::Core::RakeTask.new('spec') {|t|
+  t.rspec_opts = ['--colour', '--format Fuubar']
+}
+
+desc 'Run the acceptance suite'
+RSpec::Core::RakeTask.new('acceptance') {|t|
+  t.pattern = "./spec/acceptance/*.rb"
+  t.rspec_opts = ['--colour']
+}
+
+desc 'Profile the spec suite'
+RSpec::Core::RakeTask.new('profile') {|t|
+  t.rspec_opts = %w[--colour --profile]
+}
+
+desc 'Run code coverage'
+RSpec::Core::RakeTask.new('rcov') {|t|
+  t.rcov = true
+  t.rcov_opts = %w[--exclude spec]
+}
+
+task :default => :spec

data/bin/babushka

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+require 'babushka'
+
+Object.send :include, Babushka::DSL
+
+# Handle ctrl-c gracefully during babushka runs.
+Babushka::Base.exit_on_interrupt!
+
+# Invoke babushka, returning the correct exit status to the shell.
+exit !!Babushka::Base.run

data/deps/babushka.rb

@@ -0,0 +1,101 @@
+meta :babushka do
+  def repo
+    Babushka::GitRepo.new(path)
+  end
+end
+
+dep 'babushka', :from, :path, :branch do
+  requires 'up to date.babushka'.with(from, path, branch)
+  requires 'in path.babushka'.with(from, path)
+  path.ask("Where would you like babushka installed").default('/usr/local/babushka')
+  path.default!(Babushka::Path.path) if Babushka::Path.run_from_path?
+  branch.default!('master')
+end
+
+dep 'up to date.babushka', :from, :path, :branch do
+  requires 'repo clean.babushka'.with(from, path)
+  requires 'update would fast forward.babushka'.with(from, path, branch)
+  met? {
+    (!repo.behind?).tap {|result|
+      if result
+        log_ok "babushka is up to date at revision #{repo.current_head}."
+      else
+        log "babushka can be updated: #{repo.current_head}..#{repo.repo_shell("git rev-parse --short origin/#{branch}")}"
+      end
+    }
+  }
+  meet {
+    log "#{repo.repo_shell("git diff --stat #{repo.current_head}..origin/#{branch}")}"
+    repo.reset_hard! "origin/#{branch}"
+  }
+end
+
+dep 'update would fast forward.babushka', :from, :path, :branch do
+  requires 'on correct branch.babushka'.with(from, path, branch)
+  met? {
+    if !repo.repo_shell('git fetch origin')
+      unmeetable "Couldn't pull the latest code - check your internet connection."
+    else
+      if !repo.remote_branch_exists?
+        unmeetable "The current branch, #{repo.current_branch}, isn't pushed to origin/#{repo.current_branch}."
+      elsif repo.ahead?
+        unmeetable "There are unpushed commits in #{repo.current_branch}."
+      else
+        true
+      end
+    end
+  }
+end
+
+dep 'on correct branch.babushka', :from, :path, :branch do
+  requires 'branch exists.babushka'.with(from, path, branch)
+  requires_when_unmet 'repo clean.babushka'.with(from, path)
+  met? { repo.current_branch == branch.to_s }
+  meet { repo.checkout! branch }
+end
+
+dep 'branch exists.babushka', :from, :path, :branch do
+  requires 'installed.babushka'.with(from, path)
+  met? { repo.branches.include? branch.to_s }
+  meet { repo.track! "origin/#{branch}" }
+end
+
+dep 'repo clean.babushka', :from, :path do
+  requires 'installed.babushka'.with(from, path)
+  met? {
+    repo.clean? or unmeetable("There are local changes in #{repo.path}.")
+  }
+end
+
+dep 'in path.babushka', :from, :path do
+  requires 'installed.babushka'.with(from, path)
+  def bin_path
+    repo.path / '../bin'
+  end
+  setup {
+    unmeetable "The binary path alongside babushka, #{bin_path}, isn't in your $PATH." unless ENV['PATH'].split(':').include?(bin_path)
+  }
+  met? { which 'babushka' }
+  prepare {
+    unmeetable "The current user, #{shell('whoami')}, can't write to #{bin_path} (to symlink babushka into the path)." unless bin_path.hypothetically_writable?
+  }
+  meet {
+    bin_path.mkdir
+    log_shell "Linking babushka into #{bin_path}", %Q{ln -sf "#{repo.path / 'bin/babushka.rb'}" "#{bin_path / 'babushka'}"}
+  }
+end
+
+dep 'installed.babushka', :from, :path do
+  from.default!("git://github.com/benhoskings/babushka.git")
+
+  requires 'ruby', 'git'
+  setup {
+    unmeetable "The current user, #{shell('whoami')}, can't write to #{repo.path}." unless repo.path.hypothetically_writable?
+  }
+  met? { repo.exists? }
+  meet {
+    log_block "Cloning #{from} into #{repo.path}" do
+      repo.clone! from
+    end
+  }
+end

data/deps/dev.rb

@@ -0,0 +1,12 @@
+dep 'build tools' do
+  requires {
+    on :osx, 'xcode commandline tools'
+    on :snow_leopard, 'llvm in path'
+    on :yum, dep('gcc'), dep('gcc-c++'), dep('autoconf.managed'), dep('automake.managed'), dep('libtool.managed')
+    on :linux, 'build-essential', dep('autoconf.managed'), dep('automake.managed'), dep('libtool.managed')
+  }
+end
+
+dep 'build-essential', :template => 'managed' do
+  provides 'gcc', 'g++', 'make', 'ld'
+end

data/deps/fhs.rb

@@ -0,0 +1,31 @@
+meta :fhs do
+  def subpaths
+    %w[. bin etc include lib sbin share share/doc var].concat(
+      (1..9).map {|i| "share/man/man#{i}" }
+    )
+  end
+end
+
+dep 'writable.fhs', :path do
+  requires 'layout.fhs'.with(path)
+  requires_when_unmet 'admins can sudo'
+  met? {
+    _, nonwritable = subpaths.partition {|subpath| File.writable_real?(path / subpath) }
+    nonwritable.empty?.tap {|result|
+      log "Some directories within #{path} aren't writable by #{shell 'whoami'}." unless result
+    }
+  }
+  meet {
+    confirm "About to enable write access to #{path} for admin users - is that OK?" do
+      subpaths.each {|subpath|
+        sudo %Q{chgrp admin '#{path / subpath}'}
+        sudo %Q{chmod g+w '#{path / subpath}'}
+      }
+    end
+  }
+end
+
+dep 'layout.fhs', :path do
+  met? { subpaths.all? {|subpath| File.directory?(path / subpath) } }
+  meet { sudo "mkdir -p #{subpaths.map {|subpath| "'#{path / subpath}'" }.join(' ')}" }
+end