robin-chit 0.0.1

data/Manifest.txt

@@ -0,0 +1,7 @@
+Manifest.txt
+README.txt
+Rakefile
+bin/chit
+lib/chit.rb
+lib/wrap.rb
+resources/chitrc

data/README.txt

@@ -0,0 +1,92 @@
+= Chit
+
+http://github.com/robin/chit
+
+== DESCRIPTION:
+
+Chit is A command line tool for cheat sheet utility based on git.
+
+== FEATURES:
+
+Chit was inspired by 'cheat' (http://cheat.errtheblog.com/) by Chris Wanstrath. You can use chit to access and manage your cheat sheets easily. 
+
+There are several differences between 'cheat' and 'chit'. By using chit, besides the wonderful features of 'cheat', you get:
+
+1. Git powered cheat sheet repository. You can specify where you get the sheets and where to share them. 
+2. Your own private cheat sheet. Everybody has some project related or smoe cheat sheets which are not mean to public. You can also put them into chit
+3. Directory support. You can group cheat sheets by directory now.
+4. one less letter to type.
+
+== SYNOPSIS:
+
+To get your cheat sheet:
+$ chit [cheatsheet]
+If it does not exist, a new one will be created and waiting for your editing. Leave it blank and quit the editor if you don't want to add a new one.
+
+To edit a cheat sheet, use the --edit switch.
+$ cheat [cheatsheet] --edit
+
+To add a cheat sheet, use the --add switch.
+$ cheat [cheatsheet] --add
+
+During editing a cheat sheet, empty the content will get the cheat sheet removed.
+
+A prefix '@' indicates the cheat sheet is in private mode. A private cheat sheet is kept in another repository.
+
+To get your private cheat sheet:
+$ chit @[cheatsheet]
+
+The prefix '@' works the same for both --edit and --add.
+
+The cheat sheet can be in a path. For example:
+$ chit mysql/select
+will get your the cheat sheet 'select' under mysql.
+
+== INSTALL:
+
+sudo gem install chit
+
+== CONFIGURATION:
+
+Before run 'chit', you may want to config ~/.chitrc which is a YAML file.
+
+* root: local path to store the cheat sheet. By default, it is ~/.chit
+* main: 
+** clone-from: where to get the public cheat sheets. You can use git://github.com/robin/chitsheet.git, which is a snap shoot of http://cheat.errtheblog.com/.
+* private:
+** clone-from: where to get the private cheat sheets. If not specified, a new git repository will be init for private cheat sheets.
+
+== REQUIREMENTS:
+
+* rubygems
+* git
+
+== LICENSE:
+
+This software is shared by MIT License
+
+Copyright (c) 2008 FIX
+
+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.
+
+== BY:
+Robin Lu
+http://www.robinlu.com
+iamawalrus[at]gmail[dot]com

data/Rakefile

@@ -0,0 +1,13 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/chit.rb'
+
+Hoe.new('chit', Chit::VERSION) do |p|
+  p.developer("Robin Lu", "iamawalrus@gmail.com")
+  p.extra_deps = [['schacon-git','>= 1.0']]
+  # p.rubyforge_name = 'chitx' # if different than lowercase project name
+end
+
+# vim: syntax=Ruby

data/bin/chit

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'chit'
+Chit.run(ARGV)

data/lib/chit.rb

@@ -0,0 +1,159 @@
+$:.unshift File.dirname(__FILE__)
+%w(rubygems git tempfile fileutils yaml wrap).each {|f| require f}
+
+module Chit
+  extend self
+  VERSION = '0.0.1'
+  
+  defaults = {
+    'root'  => "#{ENV['HOME']}/.chit"
+  }
+  
+  CONFIG = defaults.merge(YAML.load_file("#{ENV['HOME']}/.chitrc"))
+  
+  def run(args)
+    args = args.dup
+    
+    return unless parse_args(args)
+    
+    unless File.exist?(sheet_file)
+      update
+    end
+    
+    unless File.exist?(sheet_file)
+      add(sheet_file)
+    else
+      show(sheet_file)
+    end
+  end
+  
+  def parse_args(args)
+    init_chit and return if args.delete('--init')
+    update and return if args.delete('--update')
+    
+    @sheet = args.shift || 'chit'
+    is_private = (@sheet =~ /^@(.*)/)
+    @sheet = is_private ? $1 : @sheet
+    working_dir = is_private ? private_path : main_path
+    @fullpath = File.join(working_dir, "#{@sheet}.yml")
+    @git = Git.open(working_dir)
+    
+    add(sheet_file) and return if args.delete('--add')
+    edit(sheet_file) and return if args.delete('--edit')
+    true
+  end
+  
+  def sheet_file
+    @fullpath
+  end
+  
+  def init_chit
+    FileUtils.mkdir_p(CONFIG['root'])
+    if CONFIG['main']['clone-from']
+      if File.exist?(main_path)
+        puts "Main chit has already been initialized."
+      else
+        puts "Initialize main chit from #{CONFIG['main']['clone-from']} to #{CONFIG['root']}/main"
+        Git.clone(CONFIG['main']['clone-from'], 'main', :path => CONFIG['root'])
+        puts "Main chit initialized."        
+      end
+    else
+      puts "ERROR: configuration for main chit repository is missing!"
+      return
+    end
+    
+    unless File.exist?(private_path)
+      if CONFIG['private'] && CONFIG['private']['clone-from']
+        puts "Initialize private chit from #{CONFIG['private']['clone-from']} to #{CONFIG['root']}/private"
+        Git.clone(CONFIG['private']['clone-from'], 'private', :path => CONFIG['root'])
+        puts "Private chit initialized."
+      else
+        puts "Initialize private chit from scratch to #{CONFIG['root']}/private"
+        Git.init(private_path)
+        puts "Private chit initialized."
+      end
+    else
+      puts "Private chit has already been initialized."
+    end
+    puts "Chit init done."
+    true
+  end
+  
+  def update
+    unless File.exist?(main_path)
+      return unless init_chit
+    end
+    if CONFIG['main']['clone-from']
+      g = Git.open(main_path)
+      g.pull
+    end
+  rescue
+    puts "ERROR: can not update main chit."
+    puts $!
+  end
+  
+  def main_path
+    File.join(CONFIG['root'], 'main')
+  end
+  
+  def private_path
+    File.join(CONFIG['root'], 'private')
+  end
+  
+  def show(sheet_file)
+    sheet = YAML.load(IO.read(sheet_file)).to_a.first
+    sheet[-1] = sheet.last.join("\n") if sheet[-1].is_a?(Array)
+    puts sheet.first + ':'
+    puts '  ' + sheet.last.gsub("\r",'').gsub("\n", "\n  ").wrap
+  end
+  
+  def rm(sheet_file)
+    @git.remove(sheet_file)
+    @git.commit_all("-")
+  rescue Git::GitExecuteError
+    FileUtils.rm_rf(sheet_file)
+  end
+  
+  def add(sheet_file)
+    unless File.exist?(sheet_file)
+      breaker = sheet_file.rindex('/')+1
+      path = sheet_file[0,breaker]
+      title = @sheet.gsub(/\//,'::')
+      FileUtils.mkdir_p(path)
+      yml = {"#{title}" => ''}.to_yaml
+      open(sheet_file, 'w') {|f| f << yml}
+    end
+    edit(sheet_file)
+  end
+  
+  def edit(sheet_file)
+    sheet = YAML.load(IO.read(sheet_file)).to_a.first
+    sheet[-1] = sheet.last.gsub("\r", '')
+    body, title = write_to_tempfile(*sheet), sheet.first
+    if body.strip.empty?
+      rm(sheet_file)
+    else
+      open(sheet_file,'w') {|f| f << {title => body}.to_yaml}
+      @git.add
+      @git.commit_all("-")
+    end
+  end
+  
+  def editor
+    ENV['VISUAL'] || ENV['EDITOR'] || "vim"
+  end
+  
+  def write_to_tempfile(title, body = nil)
+    title = title.gsub(/\/|::/, '-')
+    # god dammit i hate tempfile, this is so messy but i think it's
+    # the only way.
+    tempfile = Tempfile.new(title + '.cheat')
+    tempfile.write(body) if body
+    tempfile.close
+    system "#{editor} #{tempfile.path}"
+    tempfile.open
+    body = tempfile.read
+    tempfile.close
+    body
+  end
+end

data/lib/wrap.rb

@@ -0,0 +1,42 @@
+# >> Evan Weaver
+# => http://blog.evanweaver.com/articles/2006/09/03/smart-plaintext-wrapping
+class String
+  def wrap(width = 80, hanging_indent = 0, magic_lists = false)
+    lines = self.split(/\n/)
+
+    lines.collect! do |line|
+
+      if magic_lists 
+        line =~ /^([\s\-\d\.\:]*\s)/
+      else 
+        line =~ /^([\s]*\s)/
+      end
+
+      indent = $1.length + hanging_indent rescue hanging_indent
+
+      buffer = ""
+      first = true
+
+      while line.length > 0
+        first ? (i, first = 0, false) : i = indent              
+        pos = width - i
+
+        if line.length > pos and line[0..pos] =~ /^(.+)\s/
+          subline = $1
+        else 
+          subline = line[0..pos]
+        end
+        buffer += " " * i + subline + "\n"
+        line.tail!(subline.length)
+      end
+      buffer[0..-2]
+    end
+
+    lines.join("\n")
+  end
+
+  def tail!(pos)
+    self[0..pos] = ""
+    strip!
+  end
+end

data/resources/chitrc

@@ -0,0 +1,7 @@
+# root: 
+main:
+  clone-from: git://github.com/robin/chitsheet.git
+#  push-to:
+private:
+#   clone-from:
+#   push-to:

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+name: robin-chit
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Robin Lu
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-06-19 00:00:00 -07:00
+default_executable: chit
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: schacon-git
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.5.3
+    version: 
+description: Chit is A command line tool for cheat sheet utility based on git.
+email: 
+- iamawalrus@gmail.com
+executables: 
+- chit
+extensions: []
+
+extra_rdoc_files: 
+- Manifest.txt
+- README.txt
+files: 
+- Manifest.txt
+- README.txt
+- Rakefile
+- bin/chit
+- lib/chit.rb
+- lib/wrap.rb
+- resources/chitrc
+- test/test_chit.rb
+has_rdoc: true
+homepage: http://github.com/robin/chit
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: chit
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Chit is A command line tool for cheat sheet utility based on git.
+test_files: 
+- test/test_chit.rb