De.linque.nt 0.0.1

data/README

@@ -0,0 +1,148 @@
+= De.linque.nt: An irresponsible metaweb posting tool.  
+=== The Future is Here and it's Right Behind You!(tm)
+
+Here's the premise: Del.icio.us, the social bookmarking site, lets you create posts 
+that assign a set of tags to a URL.  The post also provides a description field as well
+as an area for extended information.
+
+Usually, Del.icio.us posts refer to some other Web resource, but the act of creating a 
+Del.icio.us post also creates a new Web resource: the Del.icio.us URL for the new post.
+
+Since this Del.icio.us post is a Web resource it can itself be the target of a 
+Del.icio.us post.  In fact, one can create posts for Del.icio.us resources that do not 
+exist *until* the post is created, i.e., the post URL you bookmark is the one that will refer
+to the bookmark you are creating.  And that is what De.linque.nt does.
+
+When you install the De.linque.nt gem, it creates a helper app to generate a posting 
+script named 'delinquentry'.  You need to provide a Del.icio.us user name and password,
+and optionally define the base tag for your De.linque.nt posts.  You can then call 
+delinquentry, passing in the text for the post description and extended info fields.
+
+The De.linque.nt class will create an as-yet nonexistent URL based off the main Del.icious URL, 
+your base tag, and a time stamp.  This URL is then becomes a Del.icio.us post, which is 
+tagged with both this unique tag and the plain base tag.
+
+You can read any specific De.linque.nt post by referring to its unique tag, or see all the
+posts by indexing on the base tag.  
+
+Requirements: 
+
+* Rubilicious,  a Ruby library for the Del.icio.us API
+* A Del.icio.us account
+* Too much free time
+
+
+== Some Possible Usage
+
+=== Low-rent Blogging: It's like having a blog without bothering with the blog part. 
+Define some base tag (e.g. MyDelinquentBlog).  Add Del.icio.us posts expressing your
+profound, worldly insights.  Be succinct: The description field and extended text field 
+only allow 256 characters each.
+
+Presto!  Instablog!
+
+Since Del.icio.us offers RSS feeds based on users and tags, you can create a simple 
+message feed using Del.icio.us metaposts.   
+
+Tell all your hip friends to subscribe to the RSS feed for your base tag and
+revel in your Web 2.0 hiptitude.
+
+
+=== Cheesy IM: OMG! This is /so/  1337! 
+Create a Del.icio.us account and share it with your friends.  Have them all install
+De.linque.nt using the same Del.icio.us account and base tag.  Make sure everyone
+subscribes to the RSS feed for the base tag.  Now you and your De.linque.nt pals can
+exchange messages by posting through Del.icio.us!
+
+
+=== Doo Dah Lists 
+Be antisocial and *don't* tell anyone about your sweet De.linque.nt postings.
+Just use it to post random notes from the command line.  All De.linque.nt posts are
+given two tags by default: the base tag (either the default 'De.linque.nt' or the
+tag you've chosen when installing the posting script ), plus a GUID tag formed
+by glomming a time-stamp onto the base tag.  But you can add more tags to your post
+by including text inside of square brackets, like this:
+
+% deliquentry.rb This is my title.  This is the body [each word in here is a tag]
+
+(So be careful when adding text: all words inside of  square brackets are assumed
+to be tags.)
+
+Using your own tags, you can create a set of categorized posts to act as your
+super-bad Doo Dah list!  You'll be Getting Real and Getting Things Done in no time!
+
+Zippity Doo Dah, Zippity F***in' A!
+
+=== Get Creative. Or Something. It's a Greasemonkey World!*
+
+De.linque.nt also includes two Greasemonkey scripts designed to work with Del.icio.us 
+and Bloglines.
+
+Each looks for feeds that contain your base tag in the URL.  So, for example, if
+you have the base tag "SquibbleNod", your De.linque.nt posts will have URLs
+similar to http://del.icio.us/username/SquibbleNod2005661232.
+
+The Greasemonkey scripts find De.linque.nt items and pass the title and content
+through "reform" methods.  By default, these don't do anything, but there is simple
+code in place to do some trivial rot13 decoding to demo the madness.  
+
+The De.linque.nt distro also includes simple Ruby code for rot13 encoding.  
+
+When De.linque.nt makes a post, it first calls deform_title and deform_content 
+before sending the text off to Del.icio.us.  The class has stub methods in place 
+for this.
+
+There are two ways (at least) to make these useful.  One is to create a file named 
+'deform.rb' and place it in the same directory as the auto-generated delinquentry.rb 
+script.  In the file you need to redefine those two Delinquent methods, as in this 
+example:
+
+  class Delinquent
+
+      # rot13 encoding.  Very DMCA!
+    def deform_title( t )
+      t.tr "A-Za-z", "N-ZA-Mn-za-m";
+    end
+
+    def deform_content( c )
+      c.tr "A-Za-z", "N-ZA-Mn-za-m";
+    end
+  end
+
+You can also just add this code directly to delinquentry.rb, after the call
+to "require 'delinquent'"
+
+So, with this example, all posts will have the title (i.e., the description text)
+and content (i.e., extended text) encoded.   To read the posts once it is on
+Delicio.us, then, you'll need to reverse the process (or work it out in your head).
+
+That's where Greasemonkey comes in.  After locating a De.linque.nt post, each
+Greasemonkey script rewrites the title and content by calling reform_title
+and reform_content.  By default these methods do nothing, but if you look
+at the code you'll see some code commented out to do the decryption.
+
+In Real Life(tm), though, you might want to use something a bit more secure.  
+There is a JavaScript block TEA (Tine Encryption Algorithm) library available at
+http://www.movable-type.co.uk/scripts/TEAblock.html
+
+Of course, you'll need to encrypt the source using the same algorithm, and you'll need to 
+use the same password and such at both  ends.  And share this with you bestest friends
+if you want to pass messages around.  Oh, and such encryption methods tend to increase
+the size of the transmitted message; make sure the results still fit into the
+alloted 256 character.  But after that you're golden.
+
+
+Have fun!
+
+James Britt
+jamesgb AT neurogami DOT com
+
+==== Credits:
+
+Thanks to Paul Duncan for Rubilicious[http://www.pablotron.org/software/rubilicious/]
+
+Thanks to joshua and crew for Del.icio.us[http://del.icio.us/]
+
+Special thanks to K. G�del and D. Hofstadter
+
+

data/bin/delinquent

@@ -0,0 +1,90 @@
+#!/usr/bin/env ruby
+$:.unshift( "../lib" )
+
+require 'de.linque.nt'
+require 'ftools'
+
+
+def usage
+  puts <<-USAGE
+
+NAME
+     delinquent - creates a new Delinquent application
+
+SYNOPSIS
+     delinquent user_name password [base_tag]
+
+
+DESCRIPTION
+     This will create a simple script and a configuration file so that you can 
+     make Delinquent posts to Del.icio.us
+
+     
+
+EXAMPLE
+     delinquent gumby seekret doodle.monkey
+
+     This will generate a new De.linque.nt script and config file so that each
+     post will be sent to the 'gumby' Del.icio.us account.  All such posts wil have the 
+     base tag 'doodle.monkey'; each post will also have a unique tag created by combining
+     'doodle.monkey' with a time stamp string.
+
+     You can then make De.linque.nt posts by calling
+
+     $ delinquentry.rb  This is the description.  The rest is the extended text.
+
+USAGE
+  exit 1  
+end
+
+
+
+def run
+  if ARGV[0] 
+    opts = {}
+    opts[ 'user_name' ] = ARGV[0] || usage()
+    opts[ 'password' ] =  ARGV[1]  || usage()    
+    opts[ 'base_tag' ] =  ARGV[2]  || 'De.linque.nt'
+    
+
+    File.open( "#{opts[ 'base_tag' ]}.yml" , "wb"){ |f|
+      %w{ user_name password base_tag }.each{|opt| f.puts( "#{opt}: #{opts[ opt ]}")}
+    }
+
+    
+    File.open( "delinquentry.rb", "wb") { |f|
+      f.puts <<-CODE
+        require 'de.linque.nt' 
+        begin
+          require 'deform'
+        rescue Exception; end 
+        Delinquent.new( :config_file => '#{opts[ 'base_tag' ]}.yml' ).post_from_cli
+      CODE
+    }
+
+    tag_re = Regexp.escape( opts[ 'base_tag' ] )
+    
+
+    js_src = IO.read( "#{File.expand_path( File.dirname( __FILE__ ) )}/../js/delinquent.user.js" )
+
+    js_src.gsub!( 'De\.linque\.nt',  tag_re )
+    File.open( "delinquent.user.js", "wb") { |f|
+      f.puts js_src
+    }
+
+    js_src = IO.read( "#{File.expand_path( File.dirname( __FILE__ ) )}/../js/bloglines.delinquent.user.js" )
+    js_src.gsub!( 'De\.linque\.nt',  tag_re )
+    File.open( "bloglines.delinquent.user.js", "wb") { |f|
+      f.puts js_src
+    }
+
+  else
+    usage()
+  end
+end
+
+run
+
+# This script is based on Michael Neumann's Wee creator script.  
+# Nice work,  Mike!
+

data/doc/classes/Delinquent.html

@@ -0,0 +1,250 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Class: Delinquent</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Class</strong></td>
+          <td class="class-name-in-header">Delinquent</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../files/lib/de_linque_nt_rb.html">
+                lib/de.linque.nt.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        <tr class="top-aligned-row">
+            <td><strong>Parent:</strong></td>
+            <td>
+                Object
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+    <div id="description">
+      <p>
+Allows one to create a post on del.icio.us that is itslef the URL ofr which
+the postnis tagging. Quite meta. The initializer must be gigven either
+:user_name and :password, or :config_file (the name of a YAML file with
+user_name and password hash values). You can also pass in :base_tag, or use
+the default.
+</p>
+
+    </div>
+
+
+   </div>
+
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+
+      <div class="name-list">
+      <a href="#M000005">add</a>&nbsp;&nbsp;
+      <a href="#M000002">deform_content</a>&nbsp;&nbsp;
+      <a href="#M000001">deform_title</a>&nbsp;&nbsp;
+      <a href="#M000003">new</a>&nbsp;&nbsp;
+      <a href="#M000004">post_from_cli</a>&nbsp;&nbsp;
+      <a href="#M000006">recent</a>&nbsp;&nbsp;
+      <a href="#M000007">where_i_live</a>&nbsp;&nbsp;
+      </div>
+    </div>
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+
+
+
+
+      
+
+
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+
+      <div id="method-M000003" class="method-detail">
+        <a name="M000003"></a>
+
+        <div class="method-heading">
+          <a href="Delinquent.src/M000003.html" target="Code" class="method-signature"
+            onclick="popupCode('Delinquent.src/M000003.html');return false;">
+          <span class="method-name">new</span><span class="method-args">( opts = { } )</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000007" class="method-detail">
+        <a name="M000007"></a>
+
+        <div class="method-heading">
+          <a href="Delinquent.src/M000007.html" target="Code" class="method-signature"
+            onclick="popupCode('Delinquent.src/M000007.html');return false;">
+          <span class="method-name">where_i_live</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <h3 class="section-bar">Public Instance methods</h3>
+
+      <div id="method-M000005" class="method-detail">
+        <a name="M000005"></a>
+
+        <div class="method-heading">
+          <a href="Delinquent.src/M000005.html" target="Code" class="method-signature"
+            onclick="popupCode('Delinquent.src/M000005.html');return false;">
+          <span class="method-name">add</span><span class="method-args">( title, content )</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Adds a new post with the given description and extended text. You can add
+your own tags by enclsing thme in [ brackets ]
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000002" class="method-detail">
+        <a name="M000002"></a>
+
+        <div class="method-heading">
+          <a href="Delinquent.src/M000002.html" target="Code" class="method-signature"
+            onclick="popupCode('Delinquent.src/M000002.html');return false;">
+          <span class="method-name">deform_content</span><span class="method-args">( content_str )</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000001" class="method-detail">
+        <a name="M000001"></a>
+
+        <div class="method-heading">
+          <a href="Delinquent.src/M000001.html" target="Code" class="method-signature"
+            onclick="popupCode('Delinquent.src/M000001.html');return false;">
+          <span class="method-name">deform_title</span><span class="method-args">( title_str )</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000004" class="method-detail">
+        <a name="M000004"></a>
+
+        <div class="method-heading">
+          <a href="Delinquent.src/M000004.html" target="Code" class="method-signature"
+            onclick="popupCode('Delinquent.src/M000004.html');return false;">
+          <span class="method-name">post_from_cli</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+If this file is called directly it invokes <tt><a
+href="Delinquent.html#M000004">post_from_cli</a></tt> It expects there to
+be some value in ARGV. All the text up to the first &#8217;.&#8217;
+character is the description; the remaining text is the extended text. The
+content is then posted to Del.icio.us
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000006" class="method-detail">
+        <a name="M000006"></a>
+
+        <div class="method-heading">
+          <a href="Delinquent.src/M000006.html" target="Code" class="method-signature"
+            onclick="popupCode('Delinquent.src/M000006.html');return false;">
+          <span class="method-name">recent</span><span class="method-args">( count = 10 )</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+
+    </div>
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>