dotmation 0.0.1

data/Gemfile

@@ -0,0 +1,14 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec", "~> 2.13.0"
+  gem "rdoc", "~> 4.0.0"
+  gem "bundler", "~> 1.3.5"
+  gem "jeweler", "~> 1.8.4"
+  gem "simplecov", "~> 0.7.1"
+end

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2013 Brigham Young University
+Authored by John T. Prince
+
+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,107 @@
+## dotmation
+
+Github aware manager for environment files (e.g. dotfiles) inspired by fresh.
+It has far fewer features than fresh and is written in ruby (taken together it
+means it *may* be easier to extend).
+
+This is *alpha* software -- use at your own risk!
+
+Features
+* depends on ruby
+* ruby dsl config file
+* not yet as full featured as fresh but easy to customize if you write ruby
+
+## Installation
+
+    gem install dotmation
+
+### Usage
+
+Assuming your dotmation file resides or is linked where expected
+(~/.config/dotmation/config), then usage is trivial:
+
+    dotmation update
+
+The first time you run dotmation, you will need to give it the filename or URI
+to your dotmation file, or a github username (assuming it is in
+<user>/dotfiles/master/config/dotmation/config)
+
+    dotmation update --config your_github_username
+    # --OR--
+    dotmation update --config path/to/your/dotmation/config
+    # --OR--
+    dotmation update --config https://url/to/your/dotmation/config
+
+### Configuration
+
+A dotmation config file is pure ruby code, so anything you can do in ruby you
+can do in your config file.  
+```ruby
+
+repo_cache "~/dotrepos"            # where to stash github repos
+
+github "jtprince/dotfiles/config" do  
+  cfg 'dotmation'                  # symlink ~/.config/dotmation directory
+
+  dot 'Xresources'                 # symlink ~/.Xresources
+  dot 'Xresources', '.Xdefaults'   # symlink ~/.Xdefaults -> Xresources
+
+  dot 'zsh/zshenv', '.zshenv'      # symlink ~/.zshenv
+  cfg 'zsh'                        # symlink ~/.config/zsh directory
+
+  cfg 'dunstrc'                    # symlink ~/.config/dunstrc
+  cfg 'i3/config', 'i3/'           # symlink ~/.config/i3/config inside i3 dir
+
+  # Trailing slash -> the file is to go under the given directory.
+end
+
+github "jtprince/dotfiles/bin" do
+  ln '.'
+end
+
+github "robbyrussell/oh-my-zsh" do
+  cfg '.'                          # symlink ~/.config/oh-my-zsh
+end
+
+```
+
+See a [real world example](https://github.com/jtprince/dotfiles/blob/master/config/dotmation/config).
+
+The config file will be read in context of Dotmation::ConfigReader which is
+responsible for creating repo objects and populating them with link objects.
+All objects are created before being used to make links, so they can be easily
+inspected.
+
+## Bootstrap an Installation
+
+There are several chicken and egg problems with setting up an evironment
+without an environment.  This shell script initializes an environment to work
+with dotmation(for debian systems).
+
+    bash -c `curl -sL https://raw.github.com/jtprince/dotmation/master/script/bootstrap-ruby-env.sh`
+
+This will install:
+
+* rbenv
+* ruby-build
+* critical deb packages for building:
+    * git curl zlib1g-dev build-essential libssl-dev libreadline-dev
+* the latest stable ruby
+* dotmation
+
+Beware, it will write to (or create) ~/.profile, remove .bash_profile, and
+write to ~/.bashrc.  Of course, all of these changes will be clobbered with
+your own fresh symlinks (assuming you use these files) once you run dotmation
+update.  The bootstrap supports the bash shell only (but you're smart enough
+to drop down to bash to run the initial update if you're using a different
+shell)
+
+## todo
+
+* Add bitbucket support.
+* work out kinks with more complicated destinations
+* use git@github instead of https:// for read/write access
+
+## Copying
+
+MIT license

data/Rakefile

@@ -0,0 +1,44 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "dotmation"
+  gem.homepage = "http://github.com/jtprince/dotmation"
+  gem.license = "MIT"
+  gem.summary = %Q{ruby dsl/config to softlink dotfiles}
+  gem.description = %Q{ruby dsl/config to softlink dotfiles that is somewhat github aware}
+  gem.email = "jtprince@gmail.com"
+  gem.authors = ["John T. Prince"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "dotmation #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/dotmation

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+
+require 'dotmation'
+require 'optparse'
+require 'open-uri'
+
+progname = File.basename(__FILE__)
+
+opt = {}
+opts = OptionParser.new do |op|
+  op.banner = "usage: #{progname} <cmd>"
+  op.separator ""
+  op.separator "commands:"
+  op.separator "    update"
+  op.separator ""
+  op.separator "options:"
+  op.on("--config <arg>", "arg may be a url or file", "may also be a github user name", "expects: #{Dotmation::DEFAULT_CONFIG_GITHUB_PATH}") do |v|
+    opt[:config] = v
+  end
+end
+opts.parse!
+
+if ARGV.size == 0
+  puts opts
+  exit
+end
+
+(methd, *args) = ARGV
+
+methd=methd.to_sym
+
+args = [opt[:config]].compact
+Dotmation.new(*args).send(methd)

data/dotmation.gemspec

@@ -0,0 +1,67 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "dotmation"
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["John T. Prince"]
+  s.date = "2013-05-09"
+  s.description = "ruby dsl/config to softlink dotfiles that is somewhat github aware"
+  s.email = "jtprince@gmail.com"
+  s.executables = ["dotmation"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.md"
+  ]
+  s.files = [
+    "Gemfile",
+    "LICENSE",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "bin/dotmation",
+    "dotmation.gemspec",
+    "lib/dotmation.rb",
+    "lib/dotmation/config_reader.rb",
+    "lib/dotmation/repo.rb",
+    "script/bootstrap-ruby-env.sh",
+    "spec/dotmation/repo_spec.rb",
+    "spec/dotmation_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/testfiles/config"
+  ]
+  s.homepage = "http://github.com/jtprince/dotmation"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.23"
+  s.summary = "ruby dsl/config to softlink dotfiles"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, ["~> 2.13.0"])
+      s.add_development_dependency(%q<rdoc>, ["~> 4.0.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.3.5"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_development_dependency(%q<simplecov>, ["~> 0.7.1"])
+    else
+      s.add_dependency(%q<rspec>, ["~> 2.13.0"])
+      s.add_dependency(%q<rdoc>, ["~> 4.0.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.3.5"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_dependency(%q<simplecov>, ["~> 0.7.1"])
+    end
+  else
+    s.add_dependency(%q<rspec>, ["~> 2.13.0"])
+    s.add_dependency(%q<rdoc>, ["~> 4.0.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.3.5"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+    s.add_dependency(%q<simplecov>, ["~> 0.7.1"])
+  end
+end
+

data/lib/dotmation.rb

@@ -0,0 +1,96 @@
+require 'open-uri'
+require 'fileutils'
+require 'dotmation/config_reader'
+require 'dotmation/repo'
+
+class Dotmation
+
+  CONFIG_HOME = ENV['XDG_CONFIG_HOME'] || "#{ENV['HOME']}/.config"
+  DEFAULT_CONFIG_PATH = CONFIG_HOME + '/dotmation/config'
+  DEFAULT_CONFIG_GITHUB_REPO = "dotfiles"
+  DEFAULT_CONFIG_GITHUB_PATH = "config/dotmation/config"
+  GITHUB_REPO_BASE = "https://github.com"
+  DEFAULT_REPO_CACHE_DIR = "~/dotfile_repo"
+
+  attr_accessor :config_data
+
+  attr_accessor :data
+  attr_accessor :repos
+
+  # quick check to see if this looks like a dotmation config file
+  def is_config?
+    @config_data.match(/dot|xdg/)
+  end
+
+  # arg is the path to the config file (checks for existence first), a url or
+  # a github name.  If given a file then it can give line number error
+  # messages.
+  def initialize(arg=DEFAULT_CONFIG_PATH)
+    @config_data = 
+      if File.exist?(arg)
+        @config_filename = arg
+        IO.read(arg)
+      else # url or github name
+        uri = 
+          if arg.include?("://")
+            arg
+          else
+            "https://raw.github.com/#{arg}/#{DEFAULT_CONFIG_GITHUB_REPO}/master/#{DEFAULT_CONFIG_GITHUB_PATH}"
+          end
+        open(uri) {|io| io.read }
+      end
+    warn "couldn't find config file locally or on github" unless is_config?
+    read_config!
+  end
+
+  def repo_cache
+    if @repo_cache
+      @repo_cache
+    else
+      @repo_cache =
+        if @data[:repo_cache]
+          File.expand_path(@data[:repo_cache]) 
+        else
+          File.expand_path(DEFAULT_REPO_CACHE_DIR)
+        end
+    end
+  end
+
+  def update(opts={})
+    unless opts[:no_update_github]
+      update_github_repos!
+    end
+    link!
+  end
+
+  def link!
+    repos.each(&:link!)
+  end
+
+  def update_github_repos!
+    FileUtils.mkpath(repo_cache) unless File.directory?(repo_cache)
+    Dir.chdir(repo_cache) do
+      repos_grouped_by_name(:github).each do |user_repo, repos|
+        repos.each {|r| r.cache_dir = repo_cache }
+        (user, repo) = user_repo.split('/')
+        FileUtils.mkdir(user) unless File.directory?(user)
+        Dir.chdir(user) do
+          if File.directory?(repo)
+            Dir.chdir(repo) { print `git pull` }
+          else
+            print `git clone #{GITHUB_REPO_BASE}/#{user}/#{repo}.git`
+          end
+        end
+      end
+    end
+  end
+
+  def repos_grouped_by_name(type=:github)
+    repos.select {|r| r.type == type }.group_by {|r| r.repo_name }
+  end
+
+  def read_config!
+    (@data, @repos) = ConfigReader.new.read(@config_data, @config_filename)
+  end
+
+end

data/lib/dotmation/config_reader.rb

@@ -0,0 +1,30 @@
+require 'dotmation/repo'
+
+class Dotmation
+
+  class ConfigReader
+    # returns a list of links and a hash of any other values given outside
+    # standard blocks
+    def read(config_data, config_filename=nil)
+      @available_repos = Repo.classes_as_lc_symbols
+      @data = {}
+      @repos = []
+      args = [config_filename].compact
+      eval( config_data, binding, *args )
+      [@data, @repos]
+    end
+
+    def method_missing(methd, *argv, &block)
+      if Dotmation::Repo::Link::METHODS.include?(methd)
+        @repos.last.links << Dotmation::Repo::Link.new(methd, *argv)
+      elsif @available_repos.include?(methd) && block
+        @repos << Repo.const_get(methd.to_s.capitalize).new( *argv )
+        instance_eval(&block)
+      else
+        arg = (argv.size==1 ? argv.first : argv)
+        @data[methd] = arg
+      end
+    end
+  end
+
+end

data/lib/dotmation/repo.rb

@@ -0,0 +1,134 @@
+require 'fileutils'
+
+class Dotmation
+  module Repo
+    Sys = FileUtils
+
+    Link = Struct.new(:methd, :file, :linkname)
+    class Link
+      METHODS = [:dot, :cfg, :ln]
+    end
+
+    def self.classes_as_lc_symbols
+      self.constants.map {|v| v.to_s.downcase.to_sym }
+    end
+
+    attr_accessor :path
+    attr_accessor :links
+
+    def initialize(path)
+      @path = path
+      @links = []
+    end
+
+    def type
+      self.class.to_s.downcase.split('::').last.to_sym
+    end
+
+    class Local
+      include Repo
+    end
+
+    class Github
+      include Repo
+      attr_accessor :cache_dir
+
+      def path_parts
+        @path_parts ||= path.split('/')
+      end
+
+      def repo_name
+        path_parts[0,2].join('/')
+      end
+
+      def user
+        path_parts.first
+      end
+
+      def project
+        path_parts[1]
+      end
+
+      def extra_path
+        path_parts[2..-1].join('/')
+      end
+
+      # makes sure the directory exists.  If it is a file, deletes the file
+      # and makes a directory
+      def ensure_dir(dir)
+        if File.exist?(dir)
+          unless File.directory?(dir)
+            File.rm_f(dir)
+            ensure_dir(dir)
+          end
+        else
+          Sys.mkpath(dir)
+        end
+        true
+      end
+
+      def no_trailing_slash(dir)
+        (dir[-1] == '/') ? dir[0...-1] : dir
+      end
+
+      # returns true if defined and there is a trailing slash
+      def target_is_dir?(dir)
+        dir && (dir[-1] == '/')
+      end
+
+      def ensure_underdir( link )
+        dir = File.dirname(link)
+        Sys.mkpath(dir)
+      end
+
+      def link!(opts={})
+        opts[:home] ||= ENV['HOME']
+        opts[:config_home] ||= Dotmation::CONFIG_HOME
+        [:home, :config_home].each {|sym| opts[sym] = no_trailing_slash(opts[sym]) }
+
+        ensure_dir( opts[:config_home] )
+        ensure_dir( opts[:home] )
+
+        Dir.chdir(cache_dir) do
+          Dir.chdir(self.path) do 
+            @links.each do |link|
+              target_is_dir = target_is_dir?(link.linkname)
+              symlink = 
+                case link.methd
+                when :cfg
+                  File.join( opts[:config_home], link.linkname || '' )
+                when :dot
+                  if link.linkname
+                    File.join( opts[:home], link.linkname )
+                  else
+                    File.join( opts[:home], (link.file[0]=='.') ? link.file : ".#{link.file}" )
+                  end
+                when :ln
+                  if link.linkname
+                    File.join( opts[:home], link.linkname )
+                  else
+                    File.join( opts[:home], link.file )
+                  end
+                end
+              
+              if link.linkname && link.linkname.include?('/')
+                ensure_underdir( symlink )
+              end
+              ensure_dir( symlink ) if target_is_dir
+              if File.exist?(symlink) && !File.directory?(symlink)
+                File.unlink(symlink)
+              end
+              file_to_link = File.expand_path(link.file)
+              #puts "TO LINK AN D SYMLINK:"
+              #p File.exist?(file_to_link)
+              #p file_to_link
+              #p symlink
+              Sys.ln_sf(file_to_link, symlink)
+            end
+          end
+        end
+      end
+
+    end
+  end
+end

data/script/bootstrap-ruby-env.sh

@@ -0,0 +1,79 @@
+#!/bin/bash
+
+# ensures that we have a recent version of ruby installed
+# and kicks things over to initialize.rb
+
+set -o pipefail
+
+pushd $HOME
+
+if [ -f /etc/debian_version ]; then
+    RBENV_PREREQS="git curl zlib1g-dev build-essential libssl-dev libreadline-dev"
+    echo "debian based system"
+    echo "going to install prereqs: $RBENV_PREREQS"
+    sudo apt-get install $RBENV_PREREQS
+fi
+
+# rbenv
+if [ ! -d ~/.rbenv ]; then
+    git clone git://github.com/sstephenson/rbenv.git .rbenv
+    export PATH="$HOME/.rbenv/bin:$PATH"
+    echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.profile
+    if [ -f  ~/.bash_profile ]; then
+        mv -f ~/.bash_profile ~/dot-bash_profile.orig
+    fi
+    eval "$(rbenv init -)"
+fi
+
+# ruby-build
+if [ ! -d ~/.rbenv/plugins/ruby-build ]; then
+    git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build
+fi
+export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"
+
+# what is the latest stable ruby build?
+latest_ruby=`rbenv install --list | grep 'p[0-9]\+' | tail -1`
+
+# install it if we don't have it
+our_ruby=`rbenv versions | grep -o '[0-9\.]\+-p[0-9]\+' | tail -1`
+
+if [ "$our_ruby" == "$latest_ruby" ]; then
+    rbenv install "$latest_ruby"
+    rbenv rehash
+fi
+
+gem install dotmation
+
+cat <<-MESSAGE
+    ___       ___       ___   
+   /\  \     /\  \     /\  \  
+  /::\  \   /::\  \    \:\  \ 
+ /:/\:\__\ /:/\:\__\   /::\__\
+ \:\/:/  / \:\/:/  /  /:/\/__/
+  \::/  /   \::/  /   \/__/   
+   \/__/     \/__/            
+                     ___       ___       ___       ___       ___       ___   
+                    /\__\     /\  \     /\  \     /\  \     /\  \     /\__\  
+                   /::L_L_   /::\  \    \:\  \   _\:\  \   /::\  \   /:| _|_ 
+                  /:/L:\__\ /::\:\__\   /::\__\ /\/::\__\ /:/\:\__\ /::|/\__\
+                  \/_/:/  / \/\::/  /  /:/\/__/ \::/\/__/ \:\/:/  / \/|::/  /
+                    /:/  /    /:/  /   \/__/     \:\__\    \::/  /    |:/  / 
+                    \/__/     \/__/               \/__/     \/__/     \/__/  
+
+If you already have a dotmation config file in the expected location
+(~/.config/dotmation/config) then just:
+
+    dotmation update
+
+If you don't have thinks linked up yet, you need to initialize:
+
+    dotmation init <path/to/dotmation/config>
+
+    # or, if you have the file on github: (dotfiles/config/dotmation/config)
+    dotmation init <github-user-name> 
+
+[Many thanks to the excellent programmers of 'fresh' for inspiration]
+MESSAGE
+
+popd
+

data/spec/dotmation/repo_spec.rb

@@ -0,0 +1,87 @@
+require 'spec_helper'
+
+require 'fileutils'
+require 'dotmation'
+
+describe Dotmation::Repo do
+
+  describe 'making cfg links' do
+
+    before do
+      @preval = ENV['XDG_CONFIG_HOME']
+      @cache_dir = File.expand_path(TESTFILES + '/tmp_github')
+      @internal_git_dir = @cache_dir + '/user/project'
+      FileUtils.mkpath @internal_git_dir
+      @file = @internal_git_dir + "/myfile"
+      File.write(@file, 'hiya')
+    end
+
+    specify 'cfg makes proper links to xdg spec' do
+      cfg_dir =  File.expand_path(TESTFILES + '/tmp_cfg')
+
+      repo = Dotmation::Repo::Github.new('user/project')
+      repo.cache_dir = @cache_dir
+
+      repo.links << Dotmation::Repo::Link.new(:cfg, "myfile")
+      repo.links << Dotmation::Repo::Link.new(:cfg, "myfile", "diff-name")
+      repo.links << Dotmation::Repo::Link.new(:cfg, "myfile", "indir/")
+
+      repo.link!(config_home: cfg_dir)
+
+      %w(myfile diff-name indir/myfile).each do |linkname|
+        link = cfg_dir + '/' + linkname
+        File.symlink?(link).should be_true
+        IO.read(link).should == 'hiya'
+      end
+      FileUtils.rm_rf cfg_dir
+    end
+
+    specify 'dot makes proper links to home dir' do
+      home_dir =  File.expand_path(TESTFILES + '/tmp_home')
+      repo = Dotmation::Repo::Github.new('user/project')
+      repo.cache_dir = @cache_dir
+
+      repo.links << Dotmation::Repo::Link.new(:dot, "myfile")
+      repo.links << Dotmation::Repo::Link.new(:dot, "myfile", ".AnotherName")
+      repo.links << Dotmation::Repo::Link.new(:dot, "myfile", "subdir/AnotherNameLower")
+      repo.links << Dotmation::Repo::Link.new(:dot, "myfile", "NoLeadingDot")
+      repo.links << Dotmation::Repo::Link.new(:dot, "myfile", "subdir2/")
+
+      repo.link!(home: home_dir)
+
+      %w(.myfile .AnotherName subdir/AnotherNameLower NoLeadingDot subdir2/myfile).each do |linkname|
+        link = home_dir + '/' + linkname
+        File.symlink?(link).should be_true
+        IO.read(link).should == 'hiya'
+      end
+      FileUtils.rm_rf home_dir
+    end
+
+    specify 'ln just makes the link to home dir' do
+      home_dir =  File.expand_path(TESTFILES + '/tmp_home')
+      repo = Dotmation::Repo::Github.new('user/project')
+      repo.cache_dir = @cache_dir
+
+      repo.links << Dotmation::Repo::Link.new(:ln, "myfile")
+      repo.links << Dotmation::Repo::Link.new(:ln, "myfile", ".AnotherName")
+      repo.links << Dotmation::Repo::Link.new(:ln, "myfile", "subdir/AnotherNameLower")
+      repo.links << Dotmation::Repo::Link.new(:ln, "myfile", "NoLeadingDot")
+      repo.links << Dotmation::Repo::Link.new(:ln, "myfile", "subdir2/")
+
+      repo.link!(home: home_dir)
+
+      %w(myfile .AnotherName subdir/AnotherNameLower NoLeadingDot subdir2/myfile).each do |linkname|
+        link = home_dir + '/' + linkname
+        File.symlink?(link).should be_true
+        IO.read(link).should == 'hiya'
+      end
+      FileUtils.rm_rf home_dir
+    end
+
+    after do
+      ENV['XDG_CONFIG_HOME'] = @preval
+      FileUtils.rm_rf @cache_dir
+    end
+
+  end
+end

data/spec/dotmation_spec.rb

@@ -0,0 +1,65 @@
+require 'spec_helper'
+
+require 'dotmation'
+
+describe Dotmation do
+  describe 'reading a config file' do
+    before do
+      @config = TESTFILES + "/config"
+    end
+
+    it 'can read it' do
+      dotmation = Dotmation.new(@config)
+    end
+
+    describe 'the data' do
+
+      let(:dotmation) { Dotmation.new(@config) }
+
+      it 'knows data' do
+        data = dotmation.data
+        data.should be_an(Hash)
+        data[:repo_cache].should == "spec/testfiles/tmprepos"
+      end
+
+      it 'has repos with links' do
+        repos = dotmation.repos
+        repos.size.should == 4
+        repos.map(&:type).partition.to_a.should == [:github, :github, :local, :github]
+      end
+
+      it 'knows which git repos it needs to get' do
+        dotmation.repos_grouped_by_name.keys.should == ["jtprince/dotfiles", "robbyrussell/oh-my-zsh"]
+      end
+
+    end
+
+    describe 'an update' do
+    #describe 'an update', :pending => 'only run occasionally -- requires internet' do
+      let(:dotmation) { Dotmation.new(@config) }
+
+      before(:all) do 
+        @tmprepos_dir = TESTFILES + "/tmprepos"
+      end
+
+      # turn on when you want to test github download
+      it 'downloads github repos' do
+        dotmation.update
+        ["jtprince/dotfiles", "robbyrussell/oh-my-zsh"].each do |path|
+          base = @tmprepos_dir + "/" + path
+          git_file = base + "/.git"
+          File.exist?( git_file ).should be_true
+        end
+      end
+
+      it 'updates existing repos' do
+        dotmation.update
+      end
+
+      after(:all) do
+        FileUtils.rm_rf(@tmprepos_dir) if File.directory?(@tmprepos_dir)
+      end
+    end
+
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require 'simplecov'
+SimpleCov.start
+
+require 'rspec'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+#Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+end
+
+TESTFILES = File.expand_path(File.dirname(__FILE__) + "/testfiles")

data/spec/testfiles/config

@@ -0,0 +1,29 @@
+
+repo_cache "spec/testfiles/tmprepos"                  # where to put all the github repos
+
+github "jtprince/dotfiles/config" do     # stored in ~/dotrepos/jtprince/dotfiles
+  cfg 'dotmation'                # symlink ~/.config/dotmation
+  cfg 'dunstrc'                  # symlink ~/.config/dunstrc
+  cfg 'zsh'                      # symlink ~/.config/zsh
+  cfg 'i3/config', 'i3/'         # symlink ~/.config/i3/config
+
+  dot 'Xresources'               # symlink ~/.Xresources
+  dot 'Xresources', '.Xdefaults' # symlink ~/.Xdefaults -> Xresources
+  dot 'zsh/zshenv'               # symlink ~/.zshenv
+end
+
+github "jtprince/dotfiles" do
+  ln 'bin'
+  ln 'bin', '~/local/'
+  ln 'bin', '~/local/bin'        # same as directly above
+  ln 'bin', '~/local'            # would link to local if not exist or local/bin if local existed
+end
+
+# always interpreted from $HOME
+local "Dropbox/special_stash" do
+  dot "dot-fonts", ".fonts"
+end
+
+github "robbyrussell/oh-my-zsh" do
+  cfg '.'                        # symlink ~/.config/oh-my-zsh
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: dotmation
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- John T. Prince
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+description: ruby dsl/config to softlink dotfiles that is somewhat github aware
+email: jtprince@gmail.com
+executables:
+- dotmation
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.md
+files:
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- VERSION
+- bin/dotmation
+- dotmation.gemspec
+- lib/dotmation.rb
+- lib/dotmation/config_reader.rb
+- lib/dotmation/repo.rb
+- script/bootstrap-ruby-env.sh
+- spec/dotmation/repo_spec.rb
+- spec/dotmation_spec.rb
+- spec/spec_helper.rb
+- spec/testfiles/config
+homepage: http://github.com/jtprince/dotmation
+licenses:
+- MIT
+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: 2585038009321147917
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: ruby dsl/config to softlink dotfiles
+test_files: []