gitdb 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 16dbf12f4855f55ed5e8f9209eb83f4653887555
+  data.tar.gz: bb5615996d5d27ac557de62703f282a6bc3db22f
+SHA512:
+  metadata.gz: d58004d7860d29bf559062a1cd58df5c4192d6ba6dcc573ab4d64dec2a1b3b539521f3f21c295d93e902976832d532e5aade51a6bf54bbec026b903b43066b31
+  data.tar.gz: bb9840bc0e5271fe8c3fdb70ea958720090f55952f7bb0e6d207d4891d61cf63f8ccca1ddc417c293403390607b65e1f5296744573f11eda40743fc1799cc3a2

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Ran
+
+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,31 @@
+# Gitdb
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'gitdb'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install gitdb
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/gitdb/fork )
+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 a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/gitdb.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gitdb/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "gitdb"
+  spec.version       = Gitdb::VERSION
+  spec.authors       = ["Ran"]
+  spec.email         = ["abbshr@outlook.com"]
+  spec.summary       = %q{"Git-Contacts backend data engine"}
+  spec.description   = %q{"a simple data storage based on git, designed for Git-Contacts"}
+  spec.homepage      = "https://github.com/AustinChou/Git-Contacts"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/gitdb/Card.rb

@@ -0,0 +1,120 @@
+
+module Gitdb
+  class Card
+
+    def initialize repo
+      @repo = repo
+    end
+
+    def self::exist? repo, id
+      repo.head.target.tree.find { |o| o[:name] == id } unless repo.branches.count == 0
+    end
+
+    def exist? id
+      Card::exist? @repo, id
+    end
+
+    # 设置名片默认格式
+    # Notice: 每个hash的key为Symbol类型
+    def format_card id, uid
+      {
+        meta: {
+          id: id,
+          owner: uid
+        },
+        firstname: '',
+        lastname: '',
+        mobile: [],
+        phone: [],
+        email: [],
+        address: [],
+        im: [],
+        birthday: '',
+        note: ''
+      }
+    end
+    
+    def create uid
+      # 生成唯一的名片id
+      while exist?(@id = Gitil::generate_code(4)) 
+      end
+      # 记录名片创建者id
+      @uid = uid
+      # 用默认格式初始化名片可读内容
+      @content = format_card @id, @uid
+      # 返回Card实例
+      self
+    end
+
+    def access id
+      @id = id
+      o = @repo.head.target.tree.find do |o|
+        o if o[:name] == id
+      end
+      # 找到名片后加载名片数据, 并返回Card实例, 否则返回nil
+      if o != nil
+        @content = JSON.parse @repo.lookup(o[:oid]).content, { symbolize_names: true }
+        @uid = @content[:owner]
+        self
+      else
+        nil
+      end
+    end
+    
+    def self::getdata repo, id
+      Card.new(repo).access(id).getdata
+    end
+
+    def self::setdata repo, id, hash
+      Card.new(repo).access(id).setdata hash
+    end
+
+    def self::getmeta repo, id
+      Card.new(repo).access(id).getmeta
+    end
+
+    def self::setmeta repo, id, hash
+      Card.new(repo).access(id).setmeta hash
+    end
+
+    def self::delete repo, id
+      Card.new(repo).access(id).delete
+    end
+
+    def getdata
+      data = @content.clone
+      data.delete :meta
+      data
+    end
+
+    def setdata hash
+      h = Gitil::data_keys_of_card.map { |key| key.to_sym } & hash.keys
+      h.each do |sym_key|
+        @content[sym_key] = hash[sym_key]
+      end
+      # 每次对数据的修改会触发一次"写入暂存区"
+      write_to_stage @id, JSON.pretty_generate(@content)
+    end
+
+    def getmeta
+      @content.clone[:meta]
+    end
+
+    def setmeta hash
+      @content[:meta] = hash
+    end
+    
+    # Notice: 调用delete之后需要先commit, 然后才能继续调用write_to_stage
+    def delete
+      @repo.index.read_tree @repo.head.target.tree unless @repo.branches.count == 0
+      @repo.index.find { |blob| @repo.index.remove blob[:path] if blob[:path] == @id }
+    end
+
+    def write_to_stage id, content
+      oid = @repo.write content, :blob
+      @repo.index.read_tree @repo.head.target.tree unless @repo.branches.count == 0
+      @repo.index.add :path => id, :oid => oid, :mode => 0100644
+    end
+  end
+  
+end

data/lib/gitdb/Contacts.rb

@@ -0,0 +1,119 @@
+
+module Gitdb
+  class Contacts
+
+    attr_accessor 'repo'
+    
+    def initialize uid
+      @uid = uid
+    end
+
+    def self::exist? gid
+      Dir::exist? "#{STORAGE_PATH}/#{gid}"
+    end
+
+    def exist? gid
+      Contacts::exist? gid
+    end
+
+    def create name
+      # 生成联系人的唯一编码
+      while exist?(@gid = Gitil::generate_code(4)) 
+      end
+      # 创建并打开git仓库
+      @repo = Rugged::Repository.init_at "#{STORAGE_PATH}/#{@gid}"
+      # 设置元信息
+      setmeta :name => name, :gid => @gid, :uid => @uid
+      # 返回Contacts实例
+      self
+    end
+
+    def access gid
+      if exist?(@gid = gid)
+        @repo = Rugged::Repository.new "#{STORAGE_PATH}/#{gid}"
+        self
+      else
+        nil
+      end
+    end
+    
+    # 返回Card实例集合
+    def get_all_cards
+      if @repo.branches.count == 0
+        []
+      else
+        @repo.head.target.tree.collect.each { |o| Card.new(@repo).access o[:name] }
+      end
+    end
+    
+    # 返回Card实例
+    def get_card_by_id id
+      if @repo.branches.count == 0
+        nil
+      else
+        Card.new(@repo).access id
+      end
+    end
+
+    def getmeta
+      @meta = {
+        :name => @repo.config['repo.name'],
+        :uid => @repo.config['repo.owner'],
+        :gid => @repo.config['repo.gid']
+      }
+    end
+    
+    def setmeta hash
+      @repo.config['repo.name'] = hash[:name] if hash.member? :name
+      @repo.config['repo.owner'] = hash[:owner] if hash.member? :owner
+      @repo.config['repo.gid'] = hash[:gid] if hash.member? :gid
+    end
+
+    # 返回commit对象指向的tree-oid集合
+    def read_change_history
+      if @repo.branches.count == 0
+        []
+      else
+        walker = Rugged::Walker.new repo
+        walker.push repo.last_commit
+        walker.collect.each { |commit| commit.tree.oid }
+      end
+    end
+
+    # 等同于git工具的 "Revert"操作
+    # @sha: tree oid, NOT a commit oid
+    # 因为回滚需要的是tree而不是commit
+    #  => commit.tree.oid
+    def revert_to sha, author, message
+      if @repo.branches.count == 0
+        return nil
+      end
+
+      tree = @repo.lookup sha
+      tree.each do |e|
+        # 遍历sha tree, 重新构造tree并写入暂存区
+        write_to_stage e[:name], @repo.lookup(e[:oid]).content
+      end
+      # get committer info
+      # committer = get_card_by_id(@uid).getdata.sub_hash(:name, :email).merge :time => Time.now
+      # 提交暂存区的tree
+      make_a_commit :author => author, :message => message, :committer => author
+    end
+
+    private
+    def write_to_stage card_id, content
+      oid = @repo.write content, :blob
+      @repo.index.add :path => card_id, :oid => oid, :mode => 0100644
+    end
+    
+    # 生成一个commit对象
+    # 每次修改最终要调用
+    def make_a_commit options
+      options[:tree] = @repo.index.write_tree @repo
+      options[:parents] = @repo.empty? ? [] : [@repo.head.target].compact
+      options[:update_ref] = 'HEAD'
+      Rugged::Commit.create @repo, options
+    end
+  end
+  
+end

data/lib/gitdb/util.rb

@@ -0,0 +1,24 @@
+module Gitil
+
+  def self::generate_code n
+    [*'a'..'z', *0..9, *'A'..'Z'].sample(n).join
+  end
+
+  def self::data_keys_of_card
+    ["firstname", "lastname", "mobile", "phone", "email", "birthday", "address", "im"]
+  end
+
+  def self::meta_keys_of_card
+  	["id", "owner"]
+  end
+
+  class Hash
+    def sub_hash *args
+      tmp = {}
+      args.each do |k|
+        tmp[k] = self[k] if self.has_key? k
+      end
+      tmp
+    end
+  end
+end

data/lib/gitdb/version.rb

@@ -0,0 +1,3 @@
+module Gitdb
+  VERSION = "0.0.1"
+end

data/lib/gitdb.rb

@@ -0,0 +1,19 @@
+require "json"
+require "rugged"
+require_relative "gitdb/util"
+require_relative "gitdb/version"
+
+require_relative 'gitdb/Card'
+require_relative 'gitdb/Contacts'
+
+module Gitdb
+  
+  # 主存储目录
+  STORAGE_PATH = File::expand_path '../../../storage', __FILE__
+
+  # 检查并创建主存储目录
+  def self::setup_storage
+    Dir::mkdir STORAGE_PATH unless Dir::exist? STORAGE_PATH
+  end
+
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: gitdb
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Ran
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-01-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: '"a simple data storage based on git, designed for Git-Contacts"'
+email:
+- abbshr@outlook.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- gitdb.gemspec
+- lib/gitdb.rb
+- lib/gitdb/Card.rb
+- lib/gitdb/Contacts.rb
+- lib/gitdb/util.rb
+- lib/gitdb/version.rb
+homepage: https://github.com/AustinChou/Git-Contacts
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: '"Git-Contacts backend data engine"'
+test_files: []