ud 0.1.0

data/bin/ud

@@ -0,0 +1,12 @@
+#! /usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+
+require 'ud'
+
+if ARGV.size == 1
+    q = UD.query(ARGV[0])
+    UD.format_results(q)
+else
+    puts "Usage:\n\tud <word>"
+end
+

data/lib/ud.rb

@@ -0,0 +1,95 @@
+#! /usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+
+require 'uri'
+require 'json'
+require 'open-uri'
+require 'nokogiri'
+
+module UD
+
+    # Get the search URL to query for a given term
+    def UD.search_url(term)
+        param = URI.encode_www_form('term' => term)
+        "http://www.urbandictionary.com/define.php?#{param}"
+    end
+
+    # Get the thumbs (up/down) for a list of definitions (ids)
+    def UD.thumbs(ids)
+
+        param = URI.encode_www_form('ids' => ids.join(','))
+        json = open "http://api.urbandictionary.com/v0/uncacheable?#{param}"
+
+        response = JSON.parse(json.read)
+        thumbs   = {}
+
+        response['thumbs'].each do |t|
+
+            thumbs[t['defid']] = {
+                :up   => t['thumbs_up'],
+                :down => t['thumbs_down']
+            }
+
+        end
+
+        thumbs
+    end
+
+    # Get the text of an element
+    def UD.text(el)
+        el.text.strip.gsub(/\r/, "\n")
+    rescue
+        ''
+    end
+
+    # Query the website and return a list of definitions for the provided term.
+    # This list may be empty if there's no results. It only scraps the first
+    # page of results, since it's generally sufficient.
+    def UD.query(term)
+        url = search_url(term)
+        doc = Nokogiri::HTML(open(url))
+
+        return [] unless doc.css('#not_defined_yet').empty?
+
+        words = doc.css('.word[data-defid]')
+        ids   = words.map { |w| w.attr('data-defid') }
+
+        thumbs = thumbs(ids)
+
+        ids.map do |id|
+
+            word = text doc.css(".word[data-defid=\"#{id}\"] > span").first
+            body = doc.css("#entry_#{id}")
+            t    = thumbs[id.to_i] || {}
+
+            {
+                :id => id,
+                :word => word,
+                :definition => text(body.css('.definition')),
+                :example => text(body.css('.example')),
+                :upvotes => t[:up],
+                :downvotes => t[:down]
+
+            }
+
+        end
+
+    end
+
+    # Format results for output, and print them
+    def UD.format_results(results)
+
+        results.each do |r|
+
+            puts "* #{r[:word]} (#{r[:upvotes]}/#{r[:downvotes]}):"
+            puts ''
+            puts " \t#{r[:definition].gsub(/\n/, "\n\t")}\n"
+            puts ' Example:'
+            puts " \t#{r[:example].gsub(/\n/, "\n\t")}"
+            puts "\n\n"
+
+        end
+
+    end
+
+end

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: ud
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Baptiste Fontaine
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-03 00:00:00.000000000 Z
+dependencies: []
+description: Get words' definitions from Urban Dictionary on the command-line.
+email: batifon@yahoo.fr
+executables:
+- ud
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ud.rb
+- bin/ud
+homepage: https://github.com/bfontaine/ud
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Urban Dictionary unofficial scrapper
+test_files: []