epitron-delicious-cli 0.1.4

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Chris Gahan
+
+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.rdoc

@@ -0,0 +1,66 @@
+= Delicious.com Command-line Interface
+
+Locally mirror your delicious links, and search them. Usage:
+
+    dels <search query>
+
+== Installation
+
+    gem sources --add http://gemcutter.org
+    gem install delicious-cli
+
+== Example:
+
+=== Set your delicious login information:
+
+(If you have never configured delicious-cli before, this will automatically
+happen the first time you run it.)
+
+    epi@fizz$ dels -c
+    
+    Delicious login info
+    ---------------------------
+    
+    Username: mydeliciouslogin
+    Password: mypassword
+    
+    User: "mydeliciouslogin" | Pass: "mypassword"
+    Is this correct? [y/N] y
+    
+    * Checking that login/password works...
+      |_ Login successful! Saving config...
+
+
+=== Download all your delicious links:
+
+    epi@fizz$ dels -r
+
+    * Redownloading database...
+    * Retrieving all links... (3465 links found)
+    * Inserting links into database...done!
+
+=== Download new links (since last sync):
+
+    epi@fizz$ dels -s
+    
+    * Synchronizing database...
+    * Retrieving new links... (5 links found)
+    * Inserting links into database...done!
+
+== Commandline options:
+
+Usage: dels [options] <search query>
+
+Specific options:
+    -d, --debug                      Debug info
+    -s, --sync                       Synchronize links
+    -r, --redownload                 Erase database and redownload all links
+    -c, --config                     Configure app (set delicious username/password)
+    -t, --test-auth                  Test that authentication info works
+
+Common options:
+    -h, --help                       Show this message
+
+== Copyright
+
+Copyright (c) 2009 Chris Gahan. See LICENSE for details.

data/bin/dels

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.expand_path(File.dirname(__FILE__))
+
+require 'delicious-cli'
+main

data/lib/delicious-cli/api.rb

@@ -0,0 +1,36 @@
+require 'httparty'
+require 'delicious-cli/settings'
+
+# Documentation:
+#   http://delicious.com/help/api
+
+class Delicious
+  include HTTParty
+  base_uri 'api.del.icio.us:443/v1'
+  format :xml
+
+  def self.posts_update
+    result = get('/posts/update')
+    if result["update"]
+      result["update"]["time"]
+    else
+      nil
+    end
+  end
+
+  def self.posts_all(options={})
+    result = get('/posts/all', :query=>options)
+    [result["posts"]["post"]].flatten  # ensure it's an array
+  end
+  
+  def self.posts_since(time)
+    $log.debug "Retrieving links newer than #{time}"
+    results = posts_all(:fromdt=>time)
+    results.select { |r| r["time"] != time }
+  end
+
+  def self.valid_auth?
+    not posts_update.nil?
+  end
+
+end

data/lib/delicious-cli/db.rb

@@ -0,0 +1,117 @@
+require 'sequel'
+require 'sequel/extensions/blank'
+
+require 'delicious-cli/settings'
+require 'delicious-cli/api'
+
+#################################################################
+
+$log.debug "Loading database..."
+DB = Sequel.sqlite(configfile('delicious.db'))
+$log.debug "done."
+
+#################################################################
+
+=begin
+Sample record:
+
+{
+  "href"=>"http://guru.com/",
+  "time"=>"2009-04-24T06:06:37Z",
+  "hash"=>"80e9a5f0bccb7f9e9dfd2e309eabd7de",
+  "tag"=>"jobs business freelance employment outsourcing exchanges networking",
+  "meta"=>"485e955fe2937fbef85390623ad0984c",
+  "description"=>"Guru.com",
+  "extended"=>"Worldwide freelancer marketplace."
+}
+=end
+
+#################################################################
+
+class Database
+  @@posts = DB[:posts]
+
+  def self.init!
+    create_posts! unless DB.table_exists?(:posts)
+  end  
+
+  def self.clear!
+    DB.drop_table(:posts)
+    create_posts!
+  end
+
+  def self.create_posts!
+    DB.create_table :posts do
+      primary_key :id
+      
+      string :href
+      string :time
+      string :tag
+      string :description
+      text :extended
+      string :hash
+      string :meta
+      
+      index :hash, {:unique=>true}
+      index [:description, :extended, :tag]
+    end
+  end
+  
+  def self.sync(all=false)
+    all = true if @@posts.empty?
+    
+    if all
+      print "* Retrieving all links..."
+      STDOUT.flush
+      posts = Delicious.posts_all
+    else
+      print "* Retrieving new links..."
+      STDOUT.flush
+      posts = Delicious.posts_since(most_recent_time)
+    end      
+    
+    $log.debug "sync: got #{posts.size} posts"
+    
+    puts " (#{posts.size} links found)"
+    
+    return if posts.empty?
+    
+    print "* Inserting links into database..."
+    
+    counter = 0
+    for post in posts
+      counter += 1
+      begin
+        add post
+      rescue Sequel::DatabaseError => e
+        $log.debug "error: #{e} adding #{post.inspect}"
+      end
+      
+      if counter % 37 == 0
+        print "."
+        STDOUT.flush
+      end
+    end
+    
+    puts "done!"
+  end
+  
+  def self.most_recent_time
+    @@posts.order(:time.desc).limit(1).first[:time]
+  end
+  
+  def self.add(params)
+    @@posts << params
+  end
+  
+  def self.find(words)
+    sequel_query = @@posts
+    for word in words
+      pattern = "%#{word}%" 
+      sequel_query = sequel_query.filter(:extended.like(pattern) | :description.like(pattern) | :tag.like(pattern))
+    end
+    sequel_query.order(:time)
+  end
+  
+  
+end

data/lib/delicious-cli/display.rb

@@ -0,0 +1,60 @@
+require 'date'
+require 'colorize'
+
+#################################################################
+## Load the colorize gem, and define the "hilite" function
+begin
+  require 'rubygems'
+  require 'colorize'
+  # Colourized hilite...
+  class String
+    def hilite(words, color=:white)
+      escaped_words = words.map { |word| Regexp.escape(word) }
+      matcher = /(#{escaped_words.join('|')})/io
+
+      chunks = self.to_s.split(matcher)
+      chunks.map do |chunk|
+        if chunk =~ matcher
+          chunk.black.on_yellow
+        else
+          chunk.send(color)
+        end
+      end.join('')
+    end
+  end
+rescue LoadError
+  STDERR.puts "Note: You should install the 'colorize' gem for extra prettiness.\n"
+  # Monochrome hilite does nothing...
+  class String
+    def hilite(words); self; end
+  end
+end
+
+#################################################################
+
+def formatdate(date, width=11)
+  dt = DateTime.parse(date)
+  time = "%l:%M%P"
+  date = "%d %b %g"
+  #dt.strftime("#{date} #{time}")
+  result = dt.strftime(date)
+  
+  result.ljust(width).light_yellow
+end
+
+
+def display(post, query, indent_size=11)
+  indent = " " * indent_size
+
+  date   = formatdate(post[:time], indent_size)
+  desc   = post[:description].hilite(query, :light_white)
+  ext    = post[:extended].hilite(query, :white)
+  url    = post[:href].hilite(query, :light_blue)
+  tags   = post[:tag].hilite(query, :light_cyan)
+
+  puts date + desc
+  puts indent + ext if post[:extended].any?
+  puts indent + url
+  puts indent + "(".cyan + tags + ")".cyan
+  puts
+end

data/lib/delicious-cli/log.rb

@@ -0,0 +1,7 @@
+require 'logger'
+
+$log = Logger.new(STDOUT)
+$log.level = Logger::INFO
+#$log.level = Logger::DEBUG
+
+$log.datetime_format = "%d %b %g @ %l:%M:%S. %L %P "

data/lib/delicious-cli/settings.rb

@@ -0,0 +1,60 @@
+require 'fileutils'
+require 'yaml'
+
+require 'delicious-cli/log'
+
+#################################################################
+HOMEDIR    = File.expand_path("~")
+CONFIGDIR  = File.join(HOMEDIR, ".delicious")
+#################################################################
+
+#################################################################
+class FileNotFound < IOError; end
+#################################################################
+
+#################################################################
+def configfile(filename, check=false)
+  path = File.join(CONFIGDIR, filename)
+  
+  if check and not File.exists? path
+    raise FileNotFound, path
+  end
+  
+  path
+end
+#################################################################
+
+
+
+#################################################################
+
+unless File.exists? CONFIGDIR
+  $log.info "* Creating new config directory: #{CONFIGDIR}"
+  FileUtils.mkdir_p CONFIGDIR 
+end
+
+class Settings
+  
+  def self.settings
+    @settings ||= {}
+  end
+  
+  def self.[](key)
+    settings[key]
+  end
+  
+  def self.[]=(key, val)
+    settings[key] = val
+  end  
+  
+  def self.load!
+    @settings = YAML::load_file( configfile('settings.yml') )
+  end
+
+  def self.save!
+    open( configfile('settings.yml'), "w" ) do |f|
+      f.write YAML::dump(settings)
+    end
+  end
+  
+end

data/lib/delicious-cli.rb

@@ -0,0 +1,160 @@
+#!/usr/bin/env ruby
+
+#################################################################
+
+require "delicious-cli/log"
+
+libs = %w[
+  rubygems
+
+  optparse
+  optparse/time
+  ostruct
+
+  delicious-cli/db
+  delicious-cli/display
+  delicious-cli/api
+  delicious-cli/settings
+]
+
+libs.each do |lib|
+  #$log.debug "loading #{lib}"
+  require lib
+end
+
+#################################################################
+
+def search(words)
+  matches = Database.find(words)
+  matches.each { |match| display(match, words) }
+end
+
+def sync
+  puts "* Synchronizing database..."
+  Database.sync
+end
+
+def redownload
+  puts "* Redownloading database..."
+  Database.clear!
+  Database.sync
+end
+
+def config
+  # prompt user and stuff
+  puts "Delicious login info"
+  puts "---------------------------"
+  puts
+  print "Username: "
+  username = gets.strip
+  print "Password: "
+  password = gets.strip
+  
+  puts
+  puts "User: #{username.inspect} | Pass: #{password.inspect}"
+  print "Is this correct? [y/N] "
+  answer = gets.strip
+  if answer =~ /^[Yy]$/
+    puts 
+    
+    puts "* Checking that login/password works..."
+    Delicious.basic_auth(username, password)
+    if Delicious.valid_auth?    
+      puts "  |_ Login successful! Saving config..."
+      Settings["username"] = username
+      Settings["password"] = password
+      Settings.save!
+    else
+      puts "  |_ Login failed! (Please check your credentials or network.)"
+    end
+    puts
+  else
+    puts "Aborting..."
+  end
+end
+
+
+#################################################################
+
+def main
+
+  # In it!
+  
+  Database.init!
+  begin
+    Settings.load!
+  rescue Errno::ENOENT
+    config
+    retry
+  end
+  
+  Delicious.basic_auth(Settings["username"], Settings["password"])
+
+  # Parse de opts
+  
+  ARGV.push("--help") if ARGV.empty?
+  
+  options = OpenStruct.new
+  OptionParser.new do |opts|
+    opts.banner = "Usage: dels [options] <search query>"
+    opts.separator ""
+    opts.separator "Specific options:"
+    
+    opts.on("-d", "--debug", "Debug info") do |opt|
+      options.debug = true
+    end
+  
+    opts.on("-s", "--sync", "Synchronize links") do |opt|
+      options.sync = true
+    end
+  
+    opts.on("-r", "--redownload", "Erase database and redownload all links") do |opt|
+      options.redownload = true
+    end
+  
+    opts.on("-c", "--config", "Configure app (set delicious username/password)") do |opt|
+      options.config = true
+    end
+
+    opts.on("-t", "--test-auth", "Test that authentication info works") do |opt|
+      options.test_auth = true 
+    end
+
+
+    opts.separator ""
+    opts.separator "Common options:"
+
+    # No argument, shows at tail.  This will print an options summary.
+    # Try it and see!
+    opts.on_tail("-h", "--help", "Show this message") do
+      puts opts
+      puts
+      exit
+    end
+    
+  end.parse!
+  
+  
+  # Handle options
+
+  $log.level = Logger::DEBUG if options.debug
+   
+  if options.test_auth
+    puts "Logging in as '#{Settings["username"]}': #{Delicious.valid_auth? ? "success!" : "fail!"}"
+  elsif options.config 
+    config
+  elsif options.redownload
+    redownload
+  elsif options.sync
+    sync
+  else
+    exit 1 unless ARGV.size > 0
+    search(ARGV)
+  end
+  
+end
+
+
+if $0 == __FILE__
+  main
+end

data/test/delicious-cli_test.rb

@@ -0,0 +1,7 @@
+require 'test_helper'
+
+class DeliciousCliTest < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'delicious-cli'
+
+class Test::Unit::TestCase
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification 
+name: epitron-delicious-cli
+version: !ruby/object:Gem::Version 
+  version: 0.1.4
+platform: ruby
+authors: 
+- epitron
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-08-29 00:00:00 -07:00
+default_executable: dels
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: sequel
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: colorize
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: sqlite3-ruby
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: A commandline tool which lets you download all your delicious.com links into a local SQLite database and search them (with pretty color-coded results).
+email: chris@ill-logic.com
+executables: 
+- dels
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- lib/delicious-cli.rb
+- lib/delicious-cli/api.rb
+- lib/delicious-cli/db.rb
+- lib/delicious-cli/display.rb
+- lib/delicious-cli/log.rb
+- lib/delicious-cli/settings.rb
+- LICENSE
+- README.rdoc
+has_rdoc: false
+homepage: http://github.com/epitron/delicious-cli
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 3
+summary: Delicious.com commandline interface
+test_files: 
+- test/delicious-cli_test.rb
+- test/test_helper.rb