homedir 3.0.alpha1

data/.gitignore

@@ -0,0 +1,13 @@
+*.gem
+*.rbc
+*.swp
+*~
+/.bundle
+/.config
+/.yardoc
+/.rvmrc
+/Gemfile.lock
+/doc/
+/pkg/
+/spec/reports
+/tmp/

data/.travis.yml

@@ -0,0 +1,7 @@
+rvm:
+  - jruby
+  - 1.8.7
+  - 1.9.2
+script: "bundle exec rake travis"
+notifications:
+  irc: "irc.freenode.org#homedir"

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/Guardfile

@@ -0,0 +1,17 @@
+# Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'bundler' do
+  watch('Gemfile')
+  # Uncomment next line if Gemfile contain `gemspec' command
+  # watch(/^.+\.gemspec/)
+end
+
+guard 'rspec', :version => 2, :cli => "--color --format doc" do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+  watch('spec/factories.rb')  { "spec" }
+end
+
+

data/README.mkd

@@ -0,0 +1,100 @@
+# HomeDir
+
+*Manage your home directory!*
+
+[![Build Status](https://secure.travis-ci.org/docwhat/homedir.png)](http://travis-ci.org/docwhat/homedir)
+
+## What is homedir?
+
+HomeDir is a package manager for your home directory.
+
+You can use other peoples HomeDir repositories or create your own!
+
+## Requirements
+
+ * Ruby (1.8.7 or newer) or JRuby (1.6.0)
+
+## Quick Start
+
+    gem install homedir
+
+That's it!
+
+## Support
+
+You can find me on freenode's IRC servers as the user 'docwhat'.  I'm usually on the #homedir channel.
+
+## The Story So Far…
+
+Since about 1999 I've been keeping my home directory config files in
+[CVS](http://www.nongnu.org/cvs/). As the number of config files I've
+been storing has grown and as the number of different systems I use it
+on (my work desktop, my home desktop, my laptop, Gerf, my pda)
+increases. As the complexity has grown it has become harder to
+maintain.
+
+So, I started looking around for a better solution. I noticed that
+[SVN](http://subversion.tigris.org/) is a much better version control
+system. I was already familiar with
+[stow](http://www.gnu.org/software/stow/stow.html) as well. So I
+tinkered around with combining them.
+
+And thus homedir was born!
+
+Since then, I rewrote HomeDir completely in python. This gives me more
+control over the help and error messages. I can do better when
+conflicts arrive. As well as I can add an elementry package format,
+which allows me to solve the problem that uninstalling a stow package
+can take forever if you have a lot of directories in your home.
+
+A [friend](http://willnorris.com/) pointed out that the most important
+part was the package manager.  The various .dotfiles are interesting
+to look at, but most people have their own.  So I moved just the
+package manager portion to [github](http://github.com/)
+
+## Migrating from older versions of homedir
+
+### 2.x
+
+I'm working on the migration stuff.
+
+### 1.x
+
+If you've using the pre-2.0 version of HomeDir (hosted on trac.gerf.org) then you should back up your .homedir directory before running the above `setup.py` script.
+
+The main change is that everything in `~/.homedir/files` has been moved to `~/.homedir/packages` and the packages will no longer be automatically updated.
+
+## Change Log
+
+## 3.x
+
+  * Rewrite in Ruby
+  * Tons of unit tests
+
+## 2.x
+
+  * Broke out the code to be easier to debug and work with.
+  * Started adding tests.
+  * Suggestions on package management from Will Norris.
+
+## 1.x
+
+The original HomeDir, which was hosted on trac.gerf.org, is going to be considered version 1.
+
+Version 1 had a configuration file that kept track of where your packages were located.
+
+In this new version packages can be placed anyplace under the directory
+`~/.homedir/packages` (except inside another package, of course).
+
+This allows for more flexability for managing packages.
+
+This also means that sync/synccmd is no longer supported.
+
+## Similar Ideas
+
+* I have also noticed that [Joey Hess](http://www.kitenet.net/~joey) has
+also done something similar and written two articles about it:
+  * [CVS homedir, or keeping your life in CVS](http://kitenet.net/~joey/cvshome.html)
+  * [Subversion Users: home directory in svn?](http://www.kitenet.net/~joey/svnhome.html)
+* [Homebrew](http://mxcl.github.com/homebrew/) does a lot of similar things, but for the system.
+* The software package 'stow' also does similar symlinking for package installation. The original algorithm for directories was taken from there.

data/Rakefile

@@ -0,0 +1,14 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+desc "Run all specs"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = "spec/**/*_spec.rb"
+end
+task :default => :spec
+
+desc "Travis-CI Tests"
+task :travis do
+  Rake::Task["spec"].invoke
+end

data/homedir.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/homedir/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Christian Holtje"]
+  gem.email         = ["docwhat@gerf.org"]
+  gem.description   = %q{Your home directory package management system}
+  gem.summary       = %q{Manage your home manager}
+  gem.homepage      = "http://home-dir.org/"
+
+  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 -- {test,spec,features}/*`.split("\n")
+  gem.name          = "homedir"
+  gem.require_paths = ["lib"]
+  gem.version       = Homedir::VERSION
+
+  gem.add_development_dependency('rake')
+  gem.add_development_dependency('rspec', ["~> 2.8"])
+  gem.add_development_dependency('fakefs', ["~> 0.4.0"])
+  gem.add_development_dependency('factory_girl', ["~> 2.5.2"])
+
+  gem.add_development_dependency('guard')
+  gem.add_development_dependency('guard-rspec')
+  gem.add_development_dependency('guard-bundler')
+  gem.add_development_dependency('rb-fsevent')
+  gem.add_development_dependency('growl')
+end

data/lib/homedir/package.rb

@@ -0,0 +1,67 @@
+require 'homedir'
+require 'pathname'
+require 'fileutils'
+require 'yaml'
+
+module Homedir
+  class Package
+    REQUIRED_OPTIONS = [
+      :name,
+      :description,
+      :directory,
+    ].freeze
+    DEFAULT_OPTIONS = {
+      :name         => nil,
+      :description  => nil,
+      :dependencies => [],
+      :post_install => nil,
+      :pre_install  => nil,
+      :directory    => nil,
+    }.freeze
+    attr_accessor *DEFAULT_OPTIONS.keys
+
+
+    def initialize(options = {})
+      options = DEFAULT_OPTIONS.merge(options)
+
+      # Set the options
+      options.each do |k,v|
+        send("#{k}=", v)
+      end
+    end
+
+    def dependencies= value
+      @dependencies = value.map { |p| p.to_s }
+    end
+
+    def directory= value
+      @directory = value.nil? ? nil : Pathname.new(value)
+    end
+
+    def name= value
+      raise "Invalid name: #{value.inspect}" unless value.nil? || value =~ /^[0-9a-zA-Z_-]+$/
+      @name = value
+    end
+
+    def save!
+      raise "The package is not valid: #{self}" unless valid?
+
+      control_dir = directory + '.homedir'
+      FileUtils.mkdir_p(control_dir.to_s) unless control_dir.directory?
+
+      (control_dir + "control").open('w') do |f|
+        f.write self.to_yaml
+      end
+    end
+
+    def valid?
+      REQUIRED_OPTIONS.reduce(true) do |is_valid, opt|
+        is_valid && !instance_variable_get("@#{opt}").nil?
+      end
+    end
+
+    def to_s
+      @name
+    end
+  end
+end

data/lib/homedir/repository.rb

@@ -0,0 +1,27 @@
+require 'pathname'
+require 'homedir/package'
+
+class Homedir::Repository
+  attr_reader :directory, :package_loader, :packages, :name
+
+  def initialize(directory, options={})
+    options = {
+      :package_loader => Homedir::Package,
+    }.merge(options)
+    @directory = Pathname.new(directory)
+    @name = @directory.basename.to_s
+    @package_loader = options[:package_loader]
+  end
+
+  def scan
+    packages = []
+    directory.each_entry do |entry|
+      next if entry.to_s.start_with? '.'
+      path = directory + entry
+      packages << package_loader.load_directory(path)
+    end
+    @packages = packages.freeze
+    return @packages
+  end
+
+end

data/lib/homedir/version.rb

@@ -0,0 +1,4 @@
+
+module Homedir
+  VERSION = '3.0.alpha1'
+end

data/lib/homedir.rb

@@ -0,0 +1,6 @@
+require 'homedir/package'
+
+module Homedir
+  class Error < StandardError
+  end
+end

data/spec/factories.rb

@@ -0,0 +1,9 @@
+require 'homedir'
+
+FactoryGirl.define do
+  factory :package, :class => Homedir::Package do
+    sequence(:name) { |n| "package-name-#{n}"}
+    sequence(:description) { |n| "package description #{n}" }
+    directory { File.join("test-directory", "#{name}") }
+  end
+end

data/spec/lib/homedir/package_spec.rb

@@ -0,0 +1,83 @@
+require 'spec_helper'
+require 'homedir/package'
+require 'pathname'
+
+describe Homedir::Package do
+
+  context "loading a v3 package from disk" do
+    describe "#read_from_directory"
+  end
+
+  describe "#new" do
+    context "creating a package from scratch" do
+      describe "dependencies" do
+        it "should accept all strings" do
+          package = build(:package, :dependencies => ['another_package'])
+          package.dependencies.size.should == 1
+          package.dependencies[0].should == 'another_package'
+        end
+        it "should accept packages" do
+          another_package = build(:package)
+          package = build(:package, :dependencies => [another_package])
+          package.dependencies.size.should == 1
+          package.dependencies[0].should == another_package.name
+        end
+      end
+
+      it "should set .name" do
+        name = "a-name"
+        build(:package, :name => name).name.should == name
+      end
+
+      it "should set .description" do
+        desc = "some words"
+        build(:package, :description => desc).description.should == desc
+      end
+    end
+  end
+
+  describe "#from_directory" do
+    it "should read its configuration from a directory"
+  end
+
+  describe ".name" do
+    it "should not accept an invalid name" do
+      pkg = build(:package)
+      expect { pkg.name = "a name" }.to raise_error
+    end
+  end
+
+  describe ".valid?" do
+    it "should require a name" do
+      build(:package, :name => nil).should_not be_valid
+    end
+
+    it "should require a description" do
+      build(:package, :description => nil).should_not be_valid
+    end
+  end
+
+  describe ".directory" do
+    it "should be a Pathname object" do
+      build(:package).directory.should be_an_instance_of(Pathname)
+    end
+  end
+
+  describe ".save!" do
+    it "should refuse to save if invalid" do
+      pkg = build(:package, :name => nil)
+      expect { pkg.save! }.to raise_error
+    end
+
+    it "should refuse to save if directory isn't set" do
+      pkg = build(:package, :directory => nil)
+      expect { pkg.save! }.to raise_error
+    end
+
+    it "should save files to '.homedir'" do
+      pkg = create(:package)
+      dot_homedir = Pathname.new(pkg.directory) + '.homedir'
+      dot_homedir.should be_a_directory
+    end
+  end
+end

data/spec/lib/homedir/repository_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+require 'homedir/repository'
+require 'pathname'
+
+describe Homedir::Repository do
+  subject { Homedir::Repository.new directory, :package_loader => package_loader }
+  let(:package_loader) do
+    double().tap do |pl|
+      # :package is a placeholder for a Package instance
+      pl.stub(:load_directory) { :package }
+    end
+  end
+  let(:directory) { Pathname.new('/') } # an absolute directory
+  let(:package_dirs) { (1..10).map { |n| directory + "package-#{n}" } }
+
+  before(:each) do
+    # We need to make the directories exist so it can be scaned
+    package_dirs.each { |p| p.mkdir }
+  end
+
+  describe "#new" do
+    subject { Homedir::Repository }
+
+    it "should take a directory name" do
+      subject.new directory.to_s
+    end
+
+    it "should accept a pathname object" do
+      subject.new directory
+    end
+
+    it "should accept a Package class" do
+      subject.new directory, :package_loader => double()
+    end
+  end
+
+  describe ".scan" do
+    it "should load each package" do
+      package_dirs.each do |p|
+        package_loader.should_receive(:load_directory).with(p)
+      end
+      subject.scan.size.should == package_dirs.size
+    end
+  end
+
+  describe ".packages" do
+    it "should contain package objects" do
+      subject.scan
+      subject.packages.each do |p|
+        p.should == :package
+      end
+    end
+  end
+
+  describe ".name" do
+    it "should return the basename of the directory" do
+      repo = Homedir::Repository.new Pathname.new('/a/b/my-name')
+      repo.name.should == 'my-name'
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+require 'fakefs'
+require 'fakefs/spec_helpers'
+require 'factory_girl'
+require 'factories'
+
+RSpec.configure do |config|
+  # Allows using build(), create(), etc. without the "FactoryGirl." part.
+  config.include FactoryGirl::Syntax::Methods
+
+  # resets the fake filesystem after each example
+  config.include FakeFS::SpecHelpers
+end

metadata

@@ -0,0 +1,166 @@
+--- !ruby/object:Gem::Specification
+name: homedir
+version: !ruby/object:Gem::Version
+  version: 3.0.alpha1
+  prerelease: 4
+platform: ruby
+authors:
+- Christian Holtje
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-16 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70278115028520 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70278115028520
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70278115027880 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :development
+  prerelease: false
+  version_requirements: *70278115027880
+- !ruby/object:Gem::Dependency
+  name: fakefs
+  requirement: &70278115024500 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :development
+  prerelease: false
+  version_requirements: *70278115024500
+- !ruby/object:Gem::Dependency
+  name: factory_girl
+  requirement: &70278115023820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.5.2
+  type: :development
+  prerelease: false
+  version_requirements: *70278115023820
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: &70278115023440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70278115023440
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: &70278115022940 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70278115022940
+- !ruby/object:Gem::Dependency
+  name: guard-bundler
+  requirement: &70278115022440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70278115022440
+- !ruby/object:Gem::Dependency
+  name: rb-fsevent
+  requirement: &70278115022020 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70278115022020
+- !ruby/object:Gem::Dependency
+  name: growl
+  requirement: &70278115021580 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70278115021580
+description: Your home directory package management system
+email:
+- docwhat@gerf.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- Guardfile
+- README.mkd
+- Rakefile
+- homedir.gemspec
+- lib/homedir.rb
+- lib/homedir/package.rb
+- lib/homedir/repository.rb
+- lib/homedir/version.rb
+- spec/factories.rb
+- spec/lib/homedir/package_spec.rb
+- spec/lib/homedir/repository_spec.rb
+- spec/spec_helper.rb
+homepage: http://home-dir.org/
+licenses: []
+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: -3141288371879137994
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>'
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.16
+signing_key: 
+specification_version: 3
+summary: Manage your home manager
+test_files:
+- spec/factories.rb
+- spec/lib/homedir/package_spec.rb
+- spec/lib/homedir/repository_spec.rb
+- spec/spec_helper.rb