delish 0.5.2

data/README

@@ -0,0 +1,92 @@
+= Quick Start
+
+The first thing you need to do is to import your del.icio.us bookmarks.  Start by setting environment variables for your del.icio.us username and password:
+
+<tt>export delish_user=<em>user</em></tt>
+
+<tt>export delish_pass=<em>pass</em></tt>
+
+And then import your bookmarks.
+
+<tt>import_delicious</tt>
+
+You can access these bookmarks with the <tt>delish</tt> command.  See more below.
+
+= delish
+
+Conveniently access del.icio.us bookmarks from a local database via commandline
+
+= Usage
+
+<tt>delish <em>basic_search</em>(<em>advanced_search</em>) <em>display_only</em></tt>
+
+== <tt><em>basic_search</em></tt>
+
+A string that should be in the url, the description, or the extended description.  It is case insensitive and unanchored.
+
+== <tt><em>advanced_search</em></tt>
+
+Advanced search allows searching by tags and/or creation date or access date.  Advanced searches must be separated by colons.
+
+=== Tags
+
+Tag searches start with a character and follow with any number of tags separated with commas.
+
+exact tag::
+  <tt>t</tt><em>tags</em>
+
+start of tag::
+  <tt>s</tt><em>tags</em>
+
+inside of tag::
+  <tt>i</tt><em>tags</em>
+
+=== Dates
+
+Dates begin with a character specifying which date to check against.  The character can be either <tt>a</tt> for accessed or <tt>c</tt> for creation date.  Following this is an optional date specification type.  If the type is left off it will be of day type.  The date specification types include <tt>h</tt> for hour and <tt>w</tt> for week.  Support for <tt>M</tt> (month), <tt>m</tt> (minute) and <tt>s</tt> (second) is planned for another release.  After the date specification is the optional date search specification, followed by the amount of time to search.  The date search specification can be a <tt>+</tt>, which means more than so much time, or a <tt>-</tt>, which means less than so much time.
+
+
+<tt>display_only</tt>::
+  This can be any string at all.  It will basically cause the program to output the links that it would have opened if you had not provided the string.  The idea is that you can run delish with some random character at the end, make sure the link is right, and then press up and backspace to get it to open the link(s).
+
+= Examples
+
++HaRoLd+::  bookmarks containing the word <em>harold</em> in the url, description, or extended description.
+
+<tt>(truby,rails)</tt>::
+  bookmarks that contain both <em>ruby</em> and <em>rails</em> tags.
+
+<tt>(sru,ra)</tt>::
+  bookmarks that contain tags that start with <em>ru</em> and <em>ra</em>.
+
+<tt>(iun,si)</tt>::
+  bookmarks that contain tags that contain <em>un</em> and <em>si</em>.
+
+<tt>(aw-6)</tt>::
+  bookmarks that have been accessed within the past 6 weeks.
+
+<tt>(ch+2)</tt>::
+  bookmarks that were created more than two hours ago.
+
+<tt>(cd2)</tt>::
+  bookmarks that were created the day before yesterday.
+
+<tt>ruby(truby,rails:sz:iyes)</tt>::
+  This will return any bookmarks with a description, url, or extended description containing <em>ruby</em>, a <em>ruby</em> tag, a <em>rails</em> tag, a tag starting with <em>z</em> and a tag containing <em>yes</em>.
+
+== TODO
+
+* "search" tags
+* zsh configuration section
+* Month, minute, and second support
+* Tags table in underlying database to improve searching speed
+* Profile the code to increase speed
+* Date Unit Tests
+* "Build Script"
+* Incremental updates instead of always importing all bookmarks
+
+== Links
+
+Project Page:: [http://rubyforge.org/projects/delish/]
+Download:: [http://rubyforge.org/frs/?group_id=3935]
+

data/bin/delish

@@ -0,0 +1,38 @@
+#!/usr/bin/ruby
+
+require 'rubygems'
+require 'sqlite3'
+
+db = SQLite3::Database.new( "#{ENV['HOME']}/.delish" )
+string = ARGV[0]
+
+#{{{ Default command is firefox
+unless ENV['delish_command'].to_s == ""
+  @@DELISH_COMMAND = ENV['delish_command']
+else
+  @@DELISH_COMMAND = 'firefox'
+end
+#}}}
+
+#{{{ Output only and debug
+unless ARGV[1].nil?
+  @@OUTPUT_ONLY = true
+  unless ARGV[2].nil?
+    @@DEBUG = true
+  else
+    @@DEBUG = false
+  end
+else
+  @@OUTPUT_ONLY = false
+end
+#}}}
+
+require 'delish_bookmark_search.rb'
+
+delish_bookmark_search = Delish_Bookmark_Search.new(string, db)
+
+if @@OUTPUT_ONLY
+  delish_bookmark_search.each { |bookmark| puts "#{bookmark[1]}: [#{bookmark[0]}]" }
+else
+  delish_bookmark_search.each { |bookmark| `#{@@DELISH_COMMAND} #{bookmark[0]}` }
+end

data/bin/import_delicious

@@ -0,0 +1,69 @@
+#!/usr/bin/ruby
+
+require 'rubygems'
+require 'rexml/document'
+require 'net/https'
+require 'sqlite3'
+
+
+
+user = ENV['delish_user']
+pass = ENV['delish_pass']
+
+db = SQLite3::Database.new( "#{ENV['HOME']}/.delish" )
+
+# Create the table!!!
+db.execute <<SQL
+CREATE TABLE posts (
+  url VARCHAR(16384),
+  description VARCHAR(255),
+  extended VARCHAR(255),
+  created DATETIME,
+  hash CHAR(32) PRIMARY KEY,
+  accessed DATETIME
+);
+SQL
+
+db.execute <<SQL
+CREATE TABLE post_tags (
+  hash CHAR(32),
+  tag VARCHAR(255)
+);
+SQL
+
+# User-Agent: required for del.icio.us api
+agent = 'delish commandline client 0.4'
+
+http = Net::HTTP.new('api.del.icio.us', 443)
+http.use_ssl = true
+http.start do |http|
+    request = Net::HTTP::Get.new('/v1/posts/all', {'User-Agent' => agent})
+    request.basic_auth user, pass
+    response = http.request(request)
+
+    data = REXML::Document.new(response.body)
+    data.elements.each("/posts/post") do |post|
+      db.execute(
+        "INSERT INTO posts
+          (url, description, extended, created, accessed, hash) VALUES
+          (?, ?, ?, JULIANDAY(?), JULIANDAY(?), ?);",
+          post.attributes['href'],
+          post.attributes['description'],
+          post.attributes['extended'],
+          post.attributes['time'].chop,
+          post.attributes['time'].chop,
+          post.attributes['hash']
+      )
+
+      post.attributes['tag'].split(' ').each do |tag|
+        db.execute(
+          "INSERT INTO post_tags
+          (hash, tag) VALUES
+          (?, ?);",
+          post.attributes['hash'],
+          tag
+        )
+      end
+    end
+end
+

data/lib/delish_bookmark_search.rb

@@ -0,0 +1,286 @@
+
+
+class SuperSQL
+  def initialize(order)
+    @statement = ""
+    @variables = []
+    if order.is_a? Integer
+      @order = order
+    else
+      throw "Not a good order."
+    end
+  end
+  attr_reader :statement
+  attr_reader :variables
+  attr_reader :order
+  attr_writer :statement
+  attr_writer :variables
+end
+
+class Delish_Bookmark_Search
+  #---
+  #{{{ initialize(search, database)
+  #+++
+  def initialize(search, database)
+    @db = database
+
+    @TAG_SPLIT = ','
+    @SPLIT = ':'
+
+    @search_string = search
+    @sss = []
+
+    @date_greater_or_equal = SuperSQL.new(0)
+    @date_greater_or_equal.statement = 'TYPE >= JULIANDAY(CURRENT_THING) - ?'
+
+    @date_less_than        = SuperSQL.new(0)
+    @date_less_than.statement        = 'TYPE < JULIANDAY(CURRENT_THING) - ?'
+
+    @use_tags = false
+    @tag_count = 0
+
+    self.search
+
+  end
+  #---
+  #}}}
+  #+++
+
+  #---
+  #{{{ search
+  #+++
+  def search
+    if @search_string =~ /^(.*?)(\((.*)\))?$/
+      self.main_search($1)
+      unless $2.nil?
+        @submatches = $3.split(@SPLIT)
+        self.sub_search_parse
+      end
+      self.execute(false)
+    end
+  end
+  #---
+  #}}}
+  #+++
+
+  #---
+  #{{{ main_search
+  #+++
+  def main_search(main_search_string)
+    @main_search = main_search_string
+
+    ssql = SuperSQL.new(40)
+    ssql.statement = "(url LIKE ? OR description LIKE ? OR extended LIKE ?)"
+    3.times { ssql.variables << "%#{main_search_string}%" }
+
+    @sss << ssql
+  end
+  #---
+  #}}}
+  #+++
+
+  #---
+  #{{{ sub_search_parse
+  #+++
+  def sub_search_parse
+    @submatches.each do |i|
+      if i =~ /^t(.*)$/
+        self.tag_equality_search($1)
+      elsif i =~ /^s(.*)$/
+        self.tag_begin_search($1)
+      elsif i =~ /^i(.*)$/
+        self.tag_inside_search($1)
+      elsif i =~ /^([ca])([Mwhms]|)([+-]|)(\d+)$/
+        self.date_search($1, $2, $3, $4)
+      end
+    end
+  end
+  #---
+  #}}}
+  #+++
+
+  #---
+  #{{{ tag_equality_search(tag_string
+  #+++
+  def tag_equality_search(tag_string)
+    @use_tags = true
+
+    ssql = SuperSQL.new(5)
+    ssql.variables = tag_string.split(@TAG_SPLIT)
+    ssql.statement = ssql.variables.map { @tag_count += 1; 'PLACEHOLDER = ?' }.join(' AND ')
+    @sss << ssql
+  end
+  #---
+  #}}}
+  #+++
+
+  #---
+  #{{{ tag_begin_search(i)
+  #+++
+  def tag_begin_search(tag_string)
+    @use_tags = true
+
+    ssql = SuperSQL.new(10)
+    ssql.variables = tag_string.split(@TAG_SPLIT).map { |i| "#{i}%" }
+    ssql.statement = ssql.variables.map { @tag_count += 1; 'PLACEHOLDER LIKE ?' }.join(' AND ')
+    @sss << ssql
+  end
+  #---
+  #}}}
+  #+++
+
+  #---
+  #{{{ tag_inside_search(i)
+  #+++
+  def tag_inside_search(tag_string)
+    @use_tags = true
+
+    ssql = SuperSQL.new(20)
+    ssql.variables = tag_string.split(@TAG_SPLIT).map { |i| "%#{i}%" }
+    ssql.statement = ssql.variables.map { @tag_count += 1; 'PLACEHOLDER LIKE ?' }.join(' AND ')
+    @sss << ssql
+  end
+  #---
+  #}}}
+  #+++
+
+  # This needs cleanup
+  #---
+  #{{{ date_search
+  #+++
+  def date_search(search_type, date_type, search_inner_type, amount)
+
+    type = ""
+    how_much = ""
+    date_or_time = ""
+    if search_type == 'c'
+      type = 'created'
+    else
+      type = 'accessed'
+    end
+    if date_type == 'h'
+      how_much = Date.time_to_day_fraction(amount.to_i, 0, 0)
+    elsif date_type == ''
+      how_much = amount
+    elsif date_type == 'w'
+      how_much = amount * 7
+    end
+    if search_inner_type == '-'
+      date_or_time = "CURRENT_TIMESTAMP"
+      @date_greater_or_equal.variables << how_much
+    elsif search_inner_type == '+'
+      date_or_time = "CURRENT_TIMESTAMP"
+      @date_less_than.variables << how_much
+    else
+      date_or_time = "CURRENT_DATE"
+      @date_greater_or_equal.variables << how_much
+      @date_less_than.variables << (how_much.to_i + 1).to_s
+    end
+
+    @date_greater_or_equal.statement["TYPE"] = type
+    @date_less_than.statement["TYPE"] = type
+    @date_greater_or_equal.statement["CURRENT_THING"] = date_or_time
+    @date_less_than.statement["CURRENT_THING"] = date_or_time
+  end
+  #---
+  #}}}
+  #+++
+
+  #---
+  #{{{ execute
+  #+++
+  def execute(access)
+    @sss << @date_greater_or_equal unless @date_greater_or_equal.variables.empty?
+    @sss << @date_less_than unless @date_less_than.variables.empty?
+
+    @sss.sort! { |a, b| a.order <=> b.order }
+
+    statement, variables = self.build_statement(access)
+
+    @results = @db.execute(statement, variables)
+
+    if access
+      hashes = []
+      @results.each { |i| hashes << i[1] }
+      self.mark_accessed(hashes)
+    end
+
+  end
+  #---
+  #}}}
+  #+++
+
+  def [](index)
+    @results[index]
+  end
+
+  #---
+  #{{{ each_with_index
+  #+++
+  def each_with_index
+    @results.each_with_index { |result| yield(result) }
+  end
+  #---
+  #}}}
+  #+++
+
+  #---
+  #{{{ each
+  #+++
+  def each
+    @results.each { |result| yield(result) }
+  end
+  #---
+  #}}}
+  #+++
+
+  #---
+  #{{{ build_statement(access)
+  #+++
+  def build_statement(access)
+    variables = []
+
+    statement = "SELECT url"
+
+    unless access
+      statement += ", description"
+    else
+      statement += ", posts.hash"
+    end
+
+    statement +=  " FROM posts"
+    @tag_count.times { |i| statement += ", post_tags AS pt#{i}" }
+    statement += " WHERE "
+    @tag_count.times { |i| statement += "pt#{i}.hash == posts.hash AND " }
+
+    tag_count = 0
+    @sss.each_with_index do |ssql,i|
+      while ssql.statement.include? "PLACEHOLDER"
+        ssql.statement.sub!("PLACEHOLDER", "pt#{tag_count}.tag")
+        tag_count += 1
+      end
+      statement += ssql.statement
+      statement += ' AND ' unless i + 1 == @sss.length
+
+      variables += ssql.variables
+    end
+
+    statement += ' ORDER BY accessed'
+    return statement, variables
+  end
+  #---
+  #}}}
+  #+++
+
+  #---
+  #{{{ mark_accessed(hashes)
+  #+++
+  def mark_accessed(hashes)
+    statement = "UPDATE posts SET accessed = JULIANDAY(CURRENT_TIMESTAMP) WHERE hash IN (" + hashes.map {"?"}.join(",") + ")"
+    @db.execute(statement, hashes)
+  end
+  #---
+  #}}}
+  #+++
+
+end

data/test/tests

@@ -0,0 +1,35 @@
+#!/usr/bin/ruby -w
+require '../delish_bookmark_search.rb'
+require 'test/unit'
+require 'sqlite3'
+
+@@db = SQLite3::Database.new( "test_db" )
+
+class Delish < Test::Unit::TestCase
+
+  def test_basic_search
+    search = Delish_Bookmark_Search.new('readable2', @@db )
+    search.each {|i| assert_equal('http://frew.livejournal.com/friends/readable2', i[0]); assert_equal('readable2', i[1]) }
+    assert_equal('http://frew.livejournal.com/friends/readable2', search[0][0])
+    assert_equal('readable2', search[0][1])
+  end
+
+  def test_tag_equality_search
+    search = Delish_Bookmark_Search.new('(tzsh,wiki)', @@db )
+    assert_equal('http://zshwiki.org/home/', search[0][0])
+    assert_equal('ZshWiki', search[0][1])
+  end
+
+  def test_tag_starts_with_search
+    search = Delish_Bookmark_Search.new('(svis,fun)', @@db )
+    assert_equal('http://www.drurywriting.com/david/05-SnowmanArt.htm', search[0][0])
+    assert_equal('calvin & hobbes snowman art', search[0][1])
+  end
+
+  def test_tag_inside_search
+    search = Delish_Bookmark_Search.new('(ivi,unn)', @@db )
+    assert_equal('http://www.bemroses.net/images/curves.jpg', search[2][0])
+    assert_equal('Editor Learning Curves', search[2][1])
+  end
+
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: delish
+version: !ruby/object:Gem::Version 
+  version: 0.5.2
+date: 2007-07-03 00:00:00 -06:00
+summary: Allows use of del.icio.us bookmarksfrom the commandline with minimum keystrokes
+require_paths: 
+- lib
+email: frioux@gmail.com
+homepage: http://afoolishmanifesto.com
+rubyforge_project: 
+description: 
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Arthur Axel "fREW" Schmidt
+files: 
+- bin/delish
+- bin/import_delicious
+- lib/delish_bookmark_search.rb
+- test/tests
+- test/test_db
+- README
+test_files: 
+- test/tests
+rdoc_options: 
+- --title
+- Delish -- Ice cream on the console
+- --main
+- README
+- --line-numbers
+extra_rdoc_files: 
+- README
+executables: 
+- delish
+- import_delicious
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: sqlite3-ruby
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+    version: