atom-tools 0.9.0 → 2.0.5

data/bin/atom-client.rb

@@ -1,246 +0,0 @@
-#!/usr/bin/ruby
-
-# syntax: ./atom-client.rb <introspection-url> [username] [password]
-#   a 
-
-require "tempfile"
-
-require "atom/yaml"
-require "atom/app"
-require "atom/http"
-
-require "rubygems"
-require "bluecloth"
-
-require "time"
-
-require 'yaml'
-
-class Tempfile
-  def edit_externally
-    self.close
-
-    system("#{EDITOR} #{self.path}")
-
-    self.open
-  end
-end
-
-class String
-  def edit_externally
-    tempfile = Tempfile.new("entry")
-    tempfile.puts self
-
-    tempfile.edit_externally
-
-    ret = tempfile.read
-    tempfile.delete
-
-    ret
-  end
-end
-
-class Atom::Entry
-  def prepare_for_output
-    filter_hook
-
-    update!
-  end
-
-  def filter_hook
-    # so much for actual text content...
-    if @content and @content["type"] == "text"
-      self.content = BlueCloth.new( @content.to_s ).to_html
-      @content["type"] = "xhtml"
-    end
-  end
-
-  def edit
-    yaml = YAML.load(self.to_yaml)
-    
-    # humans don't care about these things
-    yaml.delete "id"
-
-    if yaml["links"]
-      yaml["links"].delete(yaml["links"].find { |l| l["rel"] == "edit" })
-      yaml["links"].delete(yaml["links"].find { |l| l["rel"] == "alternate" })
-      yaml.delete("links") if yaml["links"].empty?
-    end
-
-    entry = write_entry(yaml.to_yaml)
-    # the id doesn't appear in YAML, it should remain the same
-    entry.id = self.id
-
-    entry
-  end
-end
-
-# maybe this should handle displaying the list too.
-def choose_from list
-  item = nil
-  itemno = nil
-
-  # oh wow this is pathetic
-  until item
-    if itemno
-      puts "try picking a number on the list."
-    end
-
-    print "? "
-    itemno = $stdin.gets.chomp
-
-    item = list[itemno.to_i]
-  end
-
-  item
-end
-
-def choose_collection server
-  puts "which collection?"
-
-  collections = []
-
-  # still lame
-  server.collections.each_with_index do |coll, index|
-    collections << coll
-
-    puts "#{index}: #{coll.title}"
-  end
-
-  choose_from collections
-end
-
-def choose_entry_url coll
-  puts "which entry?"
-
-  coll.entries.each_with_index do |entry, index|
-    puts "#{index}: #{entry.title}"
-  end
-
-  entry = choose_from coll.entries
-
-  edit_link = entry.links.find do |link|
-    link["rel"] = "edit"
-  end
-
-  edit_link["href"]
-end
-
-def write_entry(editstring = "")
-  begin
-    edited = editstring.edit_externally
-
-    if edited == editstring
-      puts "unchanged content, aborted"
-      exit
-    end
-
-    entry = Atom::Entry.from_yaml edited
-
-    entry.prepare_for_output
-
-    # XXX disabled until the APP WG can decide what a valid entry is
-=begin
-    valid, message = entry.valid?
-    unless valid
-      print "entry is invalid (#{message}). post anyway? (y/n)? "
-      (gets.chomp == "y") || (raise Atom::InvalidEntry.new)
-    end
-=end
-
-    # this has to be here ATM to we can detect malformed atom:content
-    puts entry.to_s
-  rescue ArgumentError,REXML::ParseException => e
-    puts e
-    
-    puts "press enter to edit again..."
-    $stdin.gets
-
-    editstring = edited
-
-    retry
-  rescue Atom::InvalidEntry
-    editstring = edited
-    retry
-  end
-
-  entry
-end
-
-module Atom
-  class InvalidEntry < RuntimeError
-  end
-end
-
-EDITOR = ENV["EDITOR"] || "env vim"
-
-# now that i'm supporting -07 the interface has been shittified. apologies.
-introspection_url = ARGV[0]
-
-http = Atom::HTTP.new
-http.user = ARGV[1]
-http.pass = ARGV[2]
-
-server = Atom::App.new(introspection_url, http)
-
-coll = choose_collection server
-
-# XXX the server should *probably* replace this, but who knows yet?
-CLIENT_ID = "http://necronomicorp.com/dev/null"
-
-new = lambda do
-  entry = Atom::Entry.new
-  
-  entry.title = ""
-  entry.content = ""
-
-  entry = entry.edit
-
-  entry.id = CLIENT_ID
-  entry.published = Time.now.iso8601
-
-  res = coll.post! entry
-
-  # XXX error recovery here, lost updates suck
-  puts res.body
-end
-
-edit = lambda do
-  coll.update!
-
-  coll.entries.each_with_index do |entry,idx|
-    puts "#{idx}: #{entry.title}"
-  end
-
-  entry = choose_from(coll.entries) { |entry| entry.title }
-
-  url = entry.edit_url
-
-  entry = http.get_atom_entry url
-
-  res = coll.put! entry.edit, url
-
-  # XXX error recovery here, lost updates suck
-  puts res.body
-end
-
-delete = lambda do
-  coll.update!
-  
-  coll.entries.each_with_index do |entry,idx|
-    puts "#{idx} #{entry.title}"
-  end
-
-  entry = choose_from(coll.entries)
-  res = coll.delete! entry
-
-  puts res.body
-end
-
-actions = [ new, edit, delete ]
-
-puts "0: new entry"
-puts "1: edit entry"
-puts "2: delete entry"
-
-choose_from(actions).call

data/bin/atom-server.rb~

@@ -1,71 +0,0 @@
-#!/usr/bin/ruby
-
-require "atom/pub-server"
-require "webrick/httpserver"
-require "atom/feed"
-
-# syntax: ./atom-server <port> <path>
-
-module Atom
-  # @docs must implement [], []=, next_id! 
-  # including servlet must implement gen_id, url_to_key, key_to_url, do_GET
-  class MemoryCollection < WEBrick::HTTPServlet::AbstractServlet
-    include Atom::AtomPub
-
-    def initialize server, docs
-      super
-
-      @docs = docs
-    end
-
-    def gen_id key
-      key
-    end
-    
-    def key_to_url req, key
-      req.script_name + "/" + key
-    end
-
-    def url_to_key url
-      url.split("/").last
-    end
-
-    def add_edit entry, key
-      edit = entry.links.new
-      edit["rel"] = "edit"
-      edit
-    end
-
-    def do_GET req, res
-      res.body = if req.path_info.empty? or req.path_info == "/"
-        feed = Atom::Feed.new
-        
-        @docs.each do |key,doc|
-          entry = doc.to_atom_entry
-          add_edit(entry, key)["href"] = key_to_url(req, key)
-          feed << entry
-        end
-
-        feed.entries.first.to_s
-      else
-        key = url_to_key(req.request_uri.to_s)
-        entry = @docs[key].to_atom_entry
-        add_edit(entry, key)["href"] = key_to_url(req, key)
-        entry.to_s
-      end
-    end
-  end
-end
-
-h = WEBrick::HTTPServer.new(:Port => ARGV[0])
-
-docs = {}
-docs.instance_variable_set :@last_key, "0"
-
-def docs.next_key!
-  @last_key.next!
-end
-
-h.mount(ARGV[1], Atom::MemoryCollection, docs)
-
-h.start

data/doc/classes/Atom/App.html

@@ -1,217 +0,0 @@
-<?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: Atom::App</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">Atom::App</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../files/lib/atom/app_rb.html">
-                lib/atom/app.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>
-<a href="App.html">Atom::App</a> represents an Atom Publishing Protocol
-introspection document.
-</p>
-
-    </div>
-
-
-   </div>
-
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-
-      <div class="name-list">
-      <a href="#M000006">new</a>&nbsp;&nbsp;
-      </div>
-    </div>
-
-  </div>
-
-
-    <!-- if includes -->
-
-    <div id="section">
-
-
-
-
-
-    <div id="attribute-list">
-      <h3 class="section-bar">Attributes</h3>
-
-      <div class="name-list">
-        <table>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">collections</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc">
-collections referred to by the introspection document
-
-</td>
-        </tr>
-        </table>
-      </div>
-    </div>
-      
-
-
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-
-      <div id="method-M000006" class="method-detail">
-        <a name="M000006"></a>
-
-        <div class="method-heading">
-          <a href="#M000006" class="method-signature">
-          <span class="method-name">new</span><span class="method-args">(introspection_url, http = Atom::HTTP.new)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-retrieves and parses an Atom introspection document.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000006-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000006-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/atom/app.rb, line 23</span>
-23:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">introspection_url</span>, <span class="ruby-identifier">http</span> = <span class="ruby-constant">Atom</span><span class="ruby-operator">::</span><span class="ruby-constant">HTTP</span>.<span class="ruby-identifier">new</span>)
-24:       <span class="ruby-identifier">i_url</span> = <span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">introspection_url</span>)
-25: 
-26:       <span class="ruby-identifier">rxml</span> = <span class="ruby-keyword kw">nil</span>
-27: 
-28:       <span class="ruby-identifier">res</span> = <span class="ruby-identifier">http</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">i_url</span>)
-29: 
-30:       <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">res</span>.<span class="ruby-identifier">code</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;200&quot;</span> <span class="ruby-comment cmt"># redirects, &amp;c.</span>
-31:         <span class="ruby-identifier">raise</span> <span class="ruby-constant">WrongResponse</span>, <span class="ruby-node">&quot;introspection document responded with unexpected code #{res.code}&quot;</span>
-32:       <span class="ruby-keyword kw">end</span>
-33: 
-34:       <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">res</span>.<span class="ruby-identifier">content_type</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;application/atomserv+xml&quot;</span>
-35:         <span class="ruby-identifier">raise</span> <span class="ruby-constant">WrongMimetype</span>, <span class="ruby-value str">&quot;this isn't an introspection document!&quot;</span>
-36:       <span class="ruby-keyword kw">end</span>
-37: 
-38:       <span class="ruby-identifier">rxml</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">Document</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">res</span>.<span class="ruby-identifier">body</span>)
-39: 
-40:       <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">rxml</span>.<span class="ruby-identifier">root</span>.<span class="ruby-identifier">namespace</span> <span class="ruby-operator">==</span> <span class="ruby-constant">PP_NS</span>
-41:         <span class="ruby-identifier">raise</span> <span class="ruby-constant">WrongNamespace</span>, <span class="ruby-value str">&quot;this isn't an introspection document!&quot;</span>
-42:       <span class="ruby-keyword kw">end</span>
-43: 
-44:       <span class="ruby-comment cmt"># TODO: expose workspaces</span>
-45:       <span class="ruby-identifier">colls</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">XPath</span>.<span class="ruby-identifier">match</span>( <span class="ruby-identifier">rxml</span>, 
-46:                                   <span class="ruby-value str">&quot;/app:service/app:workspace/app:collection&quot;</span>,
-47:                                   {<span class="ruby-value str">&quot;app&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">Atom</span><span class="ruby-operator">::</span><span class="ruby-constant">PP_NS</span>} )
-48:       
-49:       <span class="ruby-ivar">@collections</span> = []
-50:       
-51:       <span class="ruby-identifier">colls</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">collection</span><span class="ruby-operator">|</span>
-52:         <span class="ruby-comment cmt"># absolutize relative URLs</span>
-53:         <span class="ruby-identifier">url</span> = <span class="ruby-identifier">i_url</span> <span class="ruby-operator">+</span> <span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">collection</span>.<span class="ruby-identifier">attributes</span>[<span class="ruby-value str">&quot;href&quot;</span>])
-54:        
-55:         <span class="ruby-identifier">coll</span> = <span class="ruby-constant">Atom</span><span class="ruby-operator">::</span><span class="ruby-constant">Collection</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">url</span>, <span class="ruby-identifier">http</span>)
-56: 
-57:         <span class="ruby-comment cmt"># XXX this is a Text Construct, and should be parsed as such</span>
-58:         <span class="ruby-identifier">coll</span>.<span class="ruby-identifier">title</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">XPath</span>.<span class="ruby-identifier">first</span>( <span class="ruby-identifier">collection</span>,
-59:                                     <span class="ruby-value str">&quot;./atom:title&quot;</span>,
-60:                                     {<span class="ruby-value str">&quot;app&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">Atom</span><span class="ruby-operator">::</span><span class="ruby-constant">PP_NS</span>,
-61:                                      <span class="ruby-value str">&quot;atom&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">Atom</span><span class="ruby-operator">::</span><span class="ruby-constant">NS</span>   } ).<span class="ruby-identifier">text</span>
-62: 
-63:         <span class="ruby-identifier">accepts</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">XPath</span>.<span class="ruby-identifier">first</span>( <span class="ruby-identifier">collection</span>,
-64:                                       <span class="ruby-value str">&quot;./app:accept&quot;</span>,
-65:                                       {<span class="ruby-value str">&quot;app&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">Atom</span><span class="ruby-operator">::</span><span class="ruby-constant">PP_NS</span>} )
-66:         <span class="ruby-identifier">coll</span>.<span class="ruby-identifier">accepts</span> = (<span class="ruby-identifier">accepts</span> <span class="ruby-value">? </span><span class="ruby-identifier">accepts</span>.<span class="ruby-identifier">text</span> <span class="ruby-operator">:</span> <span class="ruby-value str">&quot;entry&quot;</span>)
-67:         
-68:         <span class="ruby-ivar">@collections</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">coll</span>
-69:       <span class="ruby-keyword kw">end</span>
-70:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </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>