exogenesis 0.0.1 → 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 85feab0e9949fef0074531c9400d1b105f690571
+  data.tar.gz: c3ae68824eeb4007c9548313a3d2ceb81b50256e
+SHA512:
+  metadata.gz: a02b6e88da9d019bc7fbb1cfd9091f3d6cd8d355a66a51a80275f6d639701671662600bb65c750424449225bec5ab0507a3b23c30556ee065b29d4fa4efbca0d
+  data.tar.gz: f02c877d2e01d492e86cf036950770a53ccab2ad7730d18bfcfc6f3bfcdb86df625b2bab99419b48a4299caba82d579774021566e4c624edaf4b419e1a98bb15

data/.hound.yml

@@ -0,0 +1,117 @@
+AllCops:
+  Include:
+    - '../**/*.rake'
+    - 'Gemfile'
+    - 'Guardfile'
+    - 'Rakefile'
+  Exclude:
+    - !ruby/regexp /spec\/setup/
+
+# Avoid parameter lists longer than five parameters.
+ParameterLists:
+  Max: 4
+  CountKeywordArgs: true
+
+# Avoid more than `Max` levels of nesting.
+BlockNesting:
+  Max: 3
+
+# Align with the style guide.
+CollectionMethods:
+  PreferredMethods:
+    collect:  'map'
+    inject:   'reduce'
+    find:     'detect'
+    find_all: 'select'
+
+HashSyntax:
+  Enabled: true
+
+StringLiterals:
+  Enabled: true
+
+Void:
+  Enabled: true
+
+MethodLength:
+  Enabled: false
+
+LineLength:
+  Enabled: false
+
+DotPosition:
+  EnforcedStyle: 'leading'
+
+SpaceInsideHashLiteralBraces:
+  Enabled: true
+
+AlignParameters:
+  Enabled: true
+
+# I don't agree with this
+Blocks:
+  Enabled: false
+
+NumericLiterals:
+  Enabled: true
+
+SpaceInsideBrackets:
+  Enabled: true
+
+WordArray:
+  Enabled: true
+
+Lambda:
+  Enabled: true
+
+RegexpLiteral:
+  Enabled: true
+
+# Don't agree
+ConstantName:
+  Enabled: false
+
+TrivialAccessors:
+  Enabled: true
+  ExactNameMatch: true
+
+Alias:
+  Enabled: true
+
+Loop:
+  Enabled: false
+
+# Do not agree at all
+AndOr:
+  Enabled: false
+
+# This is done by YARD Stick
+Documentation:
+  Enabled: false
+
+# Braces can be really, really useful for clarity
+BracesAroundHashParameters:
+  Enabled: false
+
+# I prefer raise over fail
+SignalException:
+  EnforcedStyle: only_raise
+
+ClassLength:
+  CountComments: false
+  Max: 140
+
+# The suggested style does not match the common ruby way of aligning the content of a hash
+IndentHash:
+  Enabled: false
+
+# This cop seems to not work correctly. Also we don't agree with it.
+FileName:
+  Enabled: false
+
+# Double negations are extremely useful
+DoubleNegation:
+  Enabled: false
+
+Output:
+  Enabled: false

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/.travis.yml

@@ -0,0 +1,16 @@
+before_install: gem install bundler -v 1.6
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - jruby-19mode
+  - jruby-head
+  - rbx-2.2.3
+  - ruby-head
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: jruby-19mode
+    - rvm: jruby-head
+    - rvm: rbx-2.2.3
+script: "bundle exec rake"

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Exogenesis – Changelog
+
+## 0.1
+
+* Original Extraction from [moonglum's dotfiles](https://github.com/moonglum/dotfiles)
+* First Cleanups

data/README.md

@@ -1,23 +1,85 @@
 # Exogenesis
 
-A collection of classes that help you install, update and teardown package managers and other things useful for your dotfiles. It's something like a meta package manager (package manager is the wrong word... still searching for a better one). You can use it to install/update/teardown your dotfiles or to create a single `update` command to update everything on your computer.
+| Project         | Exogenesis
+|:----------------|:--------------------------------------------------
+| Homepage        | https://github.com/moonglum/exogenesis
+| CI              | [![Build Status](http://img.shields.io/travis/moonglum/exogenesis.svg)](http://travis-ci.org/moonglum/exogenesis)
+| Code Metrics    | [![Code Climate](http://img.shields.io/codeclimate/github/moonglum/exogenesis.svg)](https://codeclimate.com/github/moonglum/exogenesis) [![Code Climate Coverage](http://img.shields.io/codeclimate/coverage/github/moonglum/exogenesis.svg)](https://codeclimate.com/github/moonglum/exogenesis)
+| Gem Version     | [![Gem Version](http://img.shields.io/gem/v/exogenesis.svg)](http://rubygems.org/gems/exogenesis)
+| Dependencies    | [![Dependency Status](http://img.shields.io/gemnasium/moonglum/exogenesis.svg)](https://gemnasium.com/moonglum/exogenesis)
+
+
+A collection of classes that help you install, update and teardown package managers and other things useful for your dotfiles. It's something like a meta package manager (package manager is the wrong word... still searching for a better one). After setting it up you can do the following:
+
+* `rake up`: Setup, install and update your software
+* `rake down`: Remove everything installed by Exogenesis
+* `rake clean`: Run cleanup tasks
+
+It creates a beautiful output if you want it to (see Configuration). For a little [demonstration](http://ascii.io/a/2491) (a little updated) see this asciicast of my `rake install` running on my (already installed :wink:) system.
 
 **Please read the source code of this gem before you use it. I give no guarantee that this will not destroy your computer entirely.**
 
+## How to use it
+
+The current best practice is to create a Rakefile in your dotfile repo that looks something like this:
+
+```ruby
+#!/usr/bin/env rake
+require "yaml"
+require "exogenesis"
+
+Output.fancy
+packages_file = YAML.load_file("packages.yml")
+ship = Ship.new(packages_file)
+
+[:up, :down, :clean].each do |task_name|
+  desc "#{task_name.capitalize} the Dotfiles"
+  task task_name do
+    ship.public_send task_name
+  end
+end
+```
+
+You can find a list of real-world usage of this gem [here](https://github.com/moonglum/exogenesis/wiki/List-of-Users). There are links to the actual install files there, so you can see how they did it.
+
+## If you use it...
+
+...and you really like it, you can add the exogenesis badge to the title of your dotfile's README and link to this project:
+
+![badge](http://img.shields.io/badge/%F0%9F%9A%80-Created_with_Exogenesis-be1d77.svg)
+
+```markdown
+[![badge](http://img.shields.io/badge/%F0%9F%9A%80-Created_with_Exogenesis-be1d77.svg)](https://github.com/moonglum/exogenesis)
+```
+
 ## The Interface of the classes
 
 Every class has the following methods (with the exception of `initialize` they all take no arguments):
 
 * `initialize`: The arguments are arbitrary, please see the individual files for it
-* `setup`: Installs the package manager itself
-* `install`: Installs all packages (the list has to be provided in the initialize method)
-* `update`: Updates the package manager itself and all packages
-* `cleanup`: Starts a clean-up process
-* `teardown`: Uninstalls all packages and the package manager itself
+* `up`: Installs the package manager itself, all packages and updates the package manager itself and all packages
+* `clean`: Starts a clean-up process
+* `down`: Uninstalls all packages and the package manager itself
 
 Not all package managers will need all of the methods. Just do not implement them.
 
+## Supported Managers
+
+* **Dotfile:** Link/Unlink your dotfiles
+* **Fonts:** Manage your fonts
+* **Homebrew:** Install/Uninstall/Update Homebrew and its packages
+* **HomebrewCask:** Install/Tap [Homebrew Cask](http://caskroom.io) and its packages
+* **RVM:** Install/Uninstall/Update RVM and Rubies
+* **Rbenv:** Install/Uninstall/Update Rbenv+Ruby-Build and Rubies
+* **Vundle:** Install/Uninstall/Update Vundle and its packages
+* **GitRepo:** Clone/Pull Git Repos to certain paths
+* **NPM**: Install/Uninstall NPM and its packages
+
 ## Contributing
 
-Additions of new classes are more than welcome, even if they are complimentary to the ones already provided. If you want to contribute a new class, please see the interface section and inherit from `AbstractPackageManager`.
-Your code has to work on Ruby 1.8.7, because the dotfile installers should work on Mac OS without installing a new Ruby version (and Mac OS still ships with 1.8.7)
+Additions of new classes are more than welcome, even if they are complimentary to the ones already provided. If you want to contribute a new class, please see the interface section and inherit from `Passenger`. Please use the Executor singleton for communicating the status with the user and for executing shell scripts.
+
+So far, the following people have contributed to the project:
+
+* Bodo Tasche aka @bitboxer
+* Felix Schäfer aka @thegcat

data/Rakefile

@@ -1 +1,6 @@
-require "bundler/gem_tasks"
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/exogenesis.gemspec

@@ -4,20 +4,22 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'exogenesis/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "exogenesis"
+  spec.name          = 'exogenesis'
   spec.version       = Exogenesis::VERSION
-  spec.authors       = ["moonglum"]
-  spec.email         = ["moonglum@moonbeamlabs.com"]
+  spec.authors       = ['moonglum']
+  spec.email         = ['moonglum@moonbeamlabs.com']
   spec.description   = %q{Build your dotfile installer, updater and teardown}
   spec.summary       = %q{A collection of classes that help you install, update and teardown package managers and other things useful for your dotfiles.}
-  spec.homepage      = "https://github.com/moonglum/exogenesis"
-  spec.license       = "MIT"
+  spec.homepage      = 'https://github.com/moonglum/exogenesis'
+  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.require_paths = ['lib']
 
-  spec.add_development_dependency "bundler", "~> 1.3"
-  spec.add_development_dependency "rake"
+  spec.add_dependency 'megingiard', '~> 0.1.0'
+  spec.add_development_dependency 'bundler', '~> 1.6.0'
+  spec.add_development_dependency 'rake', '~> 10.3.2'
+  spec.add_development_dependency 'rspec', '~> 3.0.0'
 end

data/lib/exogenesis.rb

@@ -1,9 +1,17 @@
-require "exogenesis/version"
-require "exogenesis/dotfile"
-require "exogenesis/homebrew"
-require "exogenesis/oh-my-zsh"
-require "exogenesis/rvm"
-require "exogenesis/vundle"
+require 'exogenesis/version'
+require 'exogenesis/passengers/dotfile'
+require 'exogenesis/passengers/homebrew'
+require 'exogenesis/passengers/homebrew_cask'
+require 'exogenesis/passengers/rvm'
+require 'exogenesis/passengers/rbenv'
+require 'exogenesis/passengers/vundle'
+require 'exogenesis/passengers/fonts'
+require 'exogenesis/passengers/python'
+require 'exogenesis/passengers/git_repo'
+require 'exogenesis/passengers/npm'
+require 'exogenesis/support/output'
+require 'exogenesis/support/executor'
+require 'exogenesis/support/ship'
 
 module Exogenesis
 end

data/lib/exogenesis/passengers/dotfile.rb

@@ -0,0 +1,28 @@
+require 'exogenesis/support/passenger'
+
+# Links all files in the given directory to your home directory
+class Dotfile < Passenger
+  register_as :dotfile
+  needs :directory_name
+  with_emoji :house
+
+  def up
+    each_dotfile do |source, destination|
+      ln_s source, destination
+    end
+  end
+
+  def down
+    each_dotfile do |_source, destination|
+      rm_rf destination
+    end
+  end
+
+  private
+
+  def each_dotfile
+    get_path_in_working_directory(directory_name).each_child do |source|
+      yield source, get_path_in_home(".#{source.basename}")
+    end
+  end
+end

data/lib/exogenesis/passengers/fonts.rb

@@ -0,0 +1,44 @@
+require 'exogenesis/support/passenger'
+
+# Installs and Removes Fonts
+class Fonts < Passenger
+  register_as :fonts
+  needs :fonts_path
+  with_emoji :book
+
+  def up
+    install_all_fonts
+  end
+
+  def down
+    collect_fonts do |file|
+      rm_rf target_font_path(file)
+    end
+  end
+
+  private
+
+  def install_all_fonts
+    collect_fonts do |file|
+      install_font(file)
+    end
+  end
+
+  def collect_fonts
+    Dir.glob(File.join(fonts_path, '**/*.{ttf,otf}')).each do |file|
+      yield file
+    end
+  end
+
+  def install_font(file)
+    if File.exist? target_font_path(file)
+      skip_task "Copying #{File.basename file}", 'Already copied'
+    else
+      execute "Copying #{File.basename file}", "cp #{file} #{target_font_path(file)}"
+    end
+  end
+
+  def target_font_path(file)
+    File.join(ENV['HOME'], 'Library/Fonts', File.basename(file))
+  end
+end

data/lib/exogenesis/passengers/git_repo.rb

@@ -0,0 +1,36 @@
+require 'exogenesis/support/passenger'
+
+# Clone, Update and Delete Git Repos
+# REQUIRES: git
+class GitRepo < Passenger
+  register_as :git_repo
+  needs :repos
+  with_emoji :arrow_down
+
+  # Clone the Repo if it doesn't exist
+  # Pull the Repo if it does
+  def up
+    each_repo_and_target do |git_repo, target|
+      if target.exist?
+        pull_repo(git_repo, target)
+      else
+        clone_repo(git_repo, target)
+      end
+    end
+  end
+
+  # Delete the Repos
+  def down
+    each_repo_and_target do |_, target|
+      rm_rf(target)
+    end
+  end
+
+  private
+
+  def each_repo_and_target
+    repos.each_pair do |git_repo, raw_target|
+      yield git_repo, get_path_for(raw_target)
+    end
+  end
+end

data/lib/exogenesis/passengers/homebrew.rb

@@ -0,0 +1,78 @@
+require 'exogenesis/support/passenger'
+
+# Manages Homebrew - the premier package manager for Mac OS
+class Homebrew < Passenger
+  INSTALL_SCRIPT = 'https://raw.github.com/mxcl/homebrew/go'
+  TEARDOWN_SCRIPT = 'https://gist.github.com/mxcl/1173223/raw/a833ba44e7be8428d877e58640720ff43c59dbad/uninstall_homebrew.sh'
+
+  register_as :homebrew
+  needs :brews
+  with_emoji :beer
+
+  def up
+    install_homebrew
+    install_missing_brews
+    update_existing_brews
+  end
+
+  def clean
+    execute 'Clean Up', 'brew cleanup'
+  end
+
+  def down
+    execute 'Teardown', "\\curl -L #{TEARDOWN_SCRIPT} | bash -s"
+  end
+
+  private
+
+  def install_homebrew
+    if command_exists? 'brew'
+      skip_task 'Install Homebrew'
+    else
+      execute_interactive 'Install Homebrew', "ruby -e \"$(curl -fsSL #{INSTALL_SCRIPT})\""
+    end
+  end
+
+  def install_missing_brews
+    each_brew_to_install do |brew, options|
+      install_package brew, options
+    end
+  end
+
+  def update_existing_brews
+    execute 'Updating Homebrew', 'brew update'
+
+    if outdated_brews.length == 0
+      skip_task 'Upgrade Brews'
+    else
+      info 'Outdated Brews', outdated_brews.join(', ')
+      execute 'Upgrade Brews', 'brew upgrade'
+    end
+  end
+
+  def each_brew_to_install
+    brews.each do |brew|
+      if brew.class == String
+        name = brew
+        options = []
+      else
+        name = brew.keys.first
+        options = brew[name]
+      end
+
+      yield name, options unless installed_brews.include? name
+    end
+  end
+
+  def installed_brews
+    @installed_brews ||= silent_execute('brew ls').split(/\s/)
+  end
+
+  def outdated_brews
+    @outdated_brews ||= silent_execute('brew outdated').split(/\s/)
+  end
+
+  def install_package(name, options)
+    execute "Installing #{name}", "brew install #{name} #{options.join}"
+  end
+end