confgit 0.0.3

data/.gitignore

@@ -0,0 +1,28 @@
+/VERSION
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# editor noise
+*~
+
+# old skool
+.svn
+
+# osx noise
+.DS_Store
+Icon

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 gnue
+
+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,192 @@
+# Confgit
+
+分散している設定ファイルを git を使ってバージョン管理するためのツール
+
+## Features
+
+* 分散している設定ファイルを一括管理
+* バージョン管理できる
+* 一度ファイルを登録すると以後は backup/restore サブコマンドで簡単管理
+* 慣れ親しんだ（？）git のサブコマンドがそのまま使える
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'confgit'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install confgit
+
+## 必要なソフトウェア
+
+* 必須
+  * ruby 1.9以上（1.9.3 でのみ動作確認）
+  * git
+* オプション
+  * tree
+  * tig
+
+## Usage
+
+固有のサブコマンドとgitのサブコマンドが使用できます
+
+### 固有のサブコマンド一覧
+
+	$ confgit repo						# リポジトリ一覧の表示
+	$ confgit repo リポジトリ名			# カレントリポジトリの変更
+	$ confgit root						# ルートの表示
+	$ confgit root ディレクトリ名			# ルートの変更
+	$ confgit root -d					# ルートの設定を削除する（デフォルト値 / になる）
+	$ confgit add ファイル名				# ファイルを追加
+	$ confgit rm ファイル名				# ファイルを削除
+	$ confgit rm -rf ディレクトリ名		# ディレクトリを削除
+	$ confgit backup					# バックアップ（更新されたもののみ）
+	$ confgit backup -f					# 強制バックアップ
+	$ confgit restore					# リストア（更新されたもののみ）
+	$ confgit restore -f				# 強制リストア
+	$ confgit tree						# ツリー表示（要treeコマンド）
+	$ confgit tig						# tigで表示（要tigコマンド）
+	$ confgit path						# リポジトリのパスを表示
+	$ confgit list						# 一覧表示
+
+### gitのサブコマンド
+
+	$ confgit commit -m 'ログ'
+	$ confgit status
+	$ confgit log
+	$ confgit reset --hard
+	$ confgit branch ブランチ名
+	$ confgit tag タグ名
+
+* その他 git のサブコマンドがそのまま使えます
+
+### 使用例
+
+#### システム環境の管理
+
+管理するファイルを追加してコミット
+
+	$ confgit add /etc/apache2/httpd.conf
+	$ confgit add /etc/postfix/aliases
+	$ confgit commit -m '設定を追加'
+
+変更されたファイルをバックアップする
+
+	$ confgit backup
+	--> etc/apache2/httpd.conf [yN]: y
+	$ confgit commit -m '設定を変更'
+
+変更されたファイルを復元する
+
+	$ sudo confgit restore
+	<-- etc/apache2/httpd.conf [yN]: y
+
+* そのたままだと書込み権限がないので sudo で実行する
+
+#### ユーザ環境の管理
+
+リポジトリを変更してルートをホームディレクトリにする
+
+	$ confgit repo myconfig
+	$ confgit root ~
+
+* ルートの変更は初回のみ行うようにする（ファイルを追加したあとに変更すると整合性がとれなくなってしまうので注意）
+* ルートを変更することによりホームディレクトリからのパスで記録される（treeサブコマンドで確認すると違いが一目瞭然）
+* リポジトリはいくつでも作成できるので、管理対象に合わせてルートを変更して使い分けてもよい
+
+管理するファイルを追加してコミット
+
+	$ confgit add ~/.bash_profile
+	$ confgit add ~/.bashrc
+	$ confgit commit -m '設定を追加'
+
+変更されたファイルをバックアップする
+
+	$ emacs ~/.bash_profile
+	$ confgit backup
+	--> .bash_profile [yN]: y
+	$ confgit commit -m '設定を変更'
+
+変更されたファイルを復元する
+
+	$ confgit restore
+	<-- .bash_profile [yN]: y
+
+#### Tips
+
+俯瞰する
+
+	$ confgit tree -a
+	.
+	├── Users
+	|   └── foo
+	|       ├── .bash_profile
+	|       └── .bashrc
+	└── etc
+	    ├── apache2
+	    │   └── httpd.conf
+	    └── postfix
+	        └── aliases
+
+* ドットファイルは -a を付けて表示する
+
+リポジトリに cd して直接ファイルを編集や git の操作をしたいとき
+
+	$ pushd `confgit path`
+	（作業）
+	$ popd
+
+bash で補完機能を使う
+
+	$ curl -O https://raw.github.com/gnue/confgit/master/etc/bash_completion.d/confgit
+	$ cp confgit $BASH_COMPLETION_DIR
+	（再ログイン）
+
+* bash-completion がインストールされて使用可能な状態になっている必要がある
+* 使える補完
+  * 固有サブコマンド
+  * `confgit repo` でリポジトリを補完
+
+## Directory
+
+	~/.etc/confgit
+	├── confgit.conf		-- 設定ファイル
+	└── repos
+	    ├── current			-- カレントリポジトリへのシンボリックリンク
+	    └── `hostname`		-- リポジトリ（デフォルト）
+
+## FAQ
+
+* [Q] ~/.etc って何？
+
+  [A] ホームディレクトリにドットファイルが叛乱しているUNIX文化の悪しき伝統への提案。
+      いいかげん、ホームディレクトリ直下にドットファイルをつくるのを減らしましょう。
+      各ソフトの設定ファイルがひとつに場所（~/.etc）にまとまってるほうがわかりやすいし管理しやすいでしょ。
+
+* [Q] confgit.conf って特に使われてないみたいなんですけど？
+
+  [A] 最初の頃にカレントリポジトリを覚えておくのとかに使ってましたが、カレントリポジトリはシンボリックリンク
+      に変更したりとかしてしまって現在は空の状態になってしまいました。
+      将来的には表示色の変更とかカスタマイズに使えるようになるかもしれません。
+
+## TODO
+
+* README の英語化
+* `confgit サブコマンド -h` のローカライズ
+* リストアで書込み権限がない場合は sudo でファイルコピーを行えるようにする
+* user/group の情報を保存
+* user/group の情報を復元
+
+## 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,13 @@
+require File.expand_path('../etc/tools/update_version', __FILE__)
+require "bundler/gem_tasks"
+
+# Spec
+require 'rake/testtask'
+Rake::TestTask.new(:spec) do |spec|
+	spec.libs << "spec"
+	spec.test_files = Dir['spec/**/*_spec.rb']
+	spec.verbose = true
+end
+
+
+task :default => :spec

data/VERSION

@@ -0,0 +1 @@
+0.0.3

data/bin/confgit

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+lib = File.expand_path('../../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'confgit'
+
+Confgit.run

data/confgit.gemspec

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'confgit/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "confgit"
+  gem.version       = Confgit::VERSION
+  gem.authors       = ["gnue"]
+  gem.email         = ["gnue@so-kukan.com"]
+  gem.description   = %q{Config files management tool with git}
+  gem.summary       = %q{Config files management tool with git}
+  gem.homepage      = "https://github.com/gnue/confgit"
+
+  gem.files         = `git ls-files`.split($/) + %w(VERSION)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.required_ruby_version = '>= 1.9.0'
+
+  # dependency
+  gem.add_dependency('i18n')
+  gem.add_dependency('json')
+
+  # for development
+  gem.add_development_dependency('minitest')
+  gem.add_development_dependency('turn')
+
+  gem.post_install_message = %Q{
+    ==================
+    This software requires 'git'.
+    Also optional softwares 'tree' and 'tig'.
+
+    If you are using the bash-completion
+
+      $ cp `gem env gemdir`/gems/confgit-#{gem.version}/etc/bash_completion.d/confgit $BASH_COMPLETION_DIR
+
+    ==================
+  }
+end

data/etc/bash_completion.d/confgit

@@ -0,0 +1,39 @@
+# bash completion for confgit
+
+_confgit()
+{
+	local cur
+
+	COMPREPLY=()
+	_get_comp_words_by_ref cur
+
+	if [[ $COMP_CWORD == 1 ]]; then
+		COMPREPLY=(repo root add rm backup restore tree tig path list)
+		COMPREPLY=($(compgen -W "${COMPREPLY[*]}" "$cur"))
+		return 0
+	fi
+
+	case ${COMP_WORDS[1]} in
+	repo)
+		[[ 2 < $COMP_CWORD ]] && return 0
+
+		COMPREPLY=$(ls ~/.etc/confgit/repos/ | fgrep -v current)
+		COMPREPLY=("${COMPREPLY[@]}" `readlink ~/.etc/confgit/repos/current`)
+		COMPREPLY=($(compgen -W "${COMPREPLY[*]}" "$cur"))
+		;;
+	*)
+		_filedir
+		;;
+	esac
+
+	return 0
+} &&
+complete -F _confgit confgit
+
+# Local variables:
+# mode: shell-script
+# sh-basic-offset: 4
+# sh-indent-comment: t
+# indent-tabs-mode: nil
+# End:
+# ex: ts=4 sw=4 et filetype=sh

data/etc/tools/update_version.rb

@@ -0,0 +1,14 @@
+def update_version(path)
+	version = `git describe --tags --dirty`.chomp
+	version.gsub!(/-([a-z0-9]+(-dirty)?)$/) { |m| "(#{$1})" }
+
+	begin
+		return if version == open(path).read.chomp
+		return if version.empty?
+	rescue
+	end
+
+	open(path, 'w') { |f| f.puts version }
+end
+
+update_version 'VERSION'

data/lib/confgit/cli.rb

@@ -0,0 +1,143 @@
+# coding: UTF-8
+
+
+require 'optparse'
+require 'rubygems'
+require 'i18n'
+
+
+module Confgit
+
+class CLI
+
+	def self.run(argv = ARGV, options = {})
+		CLI.new.run(argv, options)
+	end
+
+	def run(argv = ARGV, options = {})
+		i18n_init
+
+		trap ('SIGINT') { abort '' }
+
+		# コマンド引数の解析
+		command = nil
+
+		OptionParser.new { |opts|
+			begin
+				opts.version = LONG_VERSION || VERSION
+				opts.banner = "Usage: #{opts.program_name} <command> [<args>]"
+
+				opts.on('-h', '--help', t(:help))	{ abort opts.help }
+				opts.separator ''
+				opts.separator t(:commands)
+
+				opts.order!(argv)
+				command = argv.shift
+				abort opts.help unless command
+			rescue => e
+				abort e.to_s
+			end
+		}
+
+		action(command, argv, options)
+	end
+
+	# I18n を初期化する
+	def i18n_init
+		I18n.load_path = Dir[File.expand_path('../locales/*.yml', __FILE__)]
+		I18n.backend.load_translations
+
+		locale = ENV['LANG'][0, 2].to_sym if ENV['LANG']
+		I18n.locale = locale if I18n.available_locales.include?(locale)
+	end
+
+	# I18n で翻訳する
+	def t(code, options = {})
+		options[:scope] ||= [:usage]
+		I18n.t(code, options)
+	end
+
+	# アクションの実行
+	def action(command, argv, options = {})
+		command = command.gsub(/-/, '_')
+
+		# オプション解析
+		options_method = "options_#{command}"
+		options.merge!(send(options_method, argv)) if respond_to?(options_method)
+
+		confgit = Repo.new
+		confgit.send("confgit_#{command}", options, *argv)
+	end
+
+	# サブコマンド・オプションのバナー作成
+	def banner(opts, method, *args)
+		subcmd = method.to_s.gsub(/^.+_/, '')
+		["Usage: #{opts.program_name} #{subcmd}", *args].join(' ')
+	end
+
+	# オプション解析を定義する
+	def self.define_options(command, *banner, &block)
+		define_method "options_#{command}" do |argv|
+			options = {}
+
+			OptionParser.new { |opts|
+				begin
+					opts.banner = banner(opts, command, *banner)
+					block.call(opts, argv, options)
+				rescue => e
+					abort e.to_s
+				end
+			}
+
+			options
+		end
+	end
+
+	# オプション解析
+
+	# カレントリポジトリの表示・変更
+	define_options(:repo, '[options] [<repo>]') { |opts, argv, options|
+		opts.on('-d', 'remove repo') { options[:remove] = true }
+		opts.on('-D', 'remove repo (even if current repository)') {
+				options[:remove] = true
+				options[:force] = true
+			}
+		opts.parse!(argv)
+	}
+
+	# ルートの表示・変更
+	define_options(:root, '[PATH]') { |opts, argv, options|
+		opts.on('-d', 'default root') { options[:remove] = true }
+		opts.parse!(argv)
+	}
+
+	# ファイルを管理対象に追加
+	define_options(:add, '<file>…') { |opts, argv, options|
+		opts.parse!(argv)
+		abort opts.help if argv.empty?
+	}
+
+	# バックアップする
+	define_options(:backup, '[options] [<file>…]') { |opts, argv, options|
+		opts.on('-n', '--dry-run', 'dry run')	{ options[:yes] = false }
+		opts.on('-y', '--yes', 'yes')			{ options[:yes] = true }
+		opts.on('-f', 'force')					{ options[:force] = true }
+		opts.parse!(argv)
+	}
+
+	# リストアする
+	define_options(:restore, '[options] [<file>…]') { |opts, argv, options|
+		opts.on('-n', '--dry-run', 'dry run')	{ options[:yes] = false }
+		opts.on('-y', '--yes', 'yes')			{ options[:yes] = true }
+		opts.on('-f', 'force')					{ options[:force] = true }
+		opts.parse!(argv)
+	}
+
+	# 一覧表示する
+	define_options(:list, '[options] [<file>…]') { |opts, argv, options|
+		opts.on('-8', 'mode display octal')	{ options[:octal] = true }
+		opts.parse!(argv)
+	}
+end
+
+end

data/lib/confgit/locales/en.yml

@@ -0,0 +1,18 @@
+en:
+  usage:
+    help: Show this message
+    commands: |
+      commands:
+          repo                             Show repositories
+          repo REPO                        Change repository
+          root                             Show root
+          root PATH                        Change root
+          add FILE…                        Add files
+          rm FILE…                         Remove files
+          rm -rf DIRECTORY                 Remove directories
+          backup                           Backup
+          restore                          Restore
+          tree                             Show tree(require tree)
+          tig                              Show by tig(require tig)
+          path                             Show repository path
+          list                             Show file list

data/lib/confgit/locales/ja.yml

@@ -0,0 +1,18 @@
+ja:
+  usage:
+    help: このメッセージを表示
+    commands: |
+      commands:
+          repo                             リポジトリ一覧の表示
+          repo REPO                        カレントリポジトリの変更
+          root                             ルートの表示
+          root PATH                        ルートの変更
+          add FILE…                        ファイルを追加
+          rm FILE…                         ファイルを削除
+          rm -rf DIRECTORY                 ディレクトリを削除
+          backup                           更新されたファイルをバックアップ
+          restore                          更新されたファイルを復元
+          tree                             ツリー表示（要treeコマンド）
+          tig                              tigで表示（要tigコマンド）
+          path                             リポジトリのパスを表示
+          list                             一覧表示