livejournal 0.0.1

data/LICENSE

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1,50 @@
+=ljrb: LiveJournal Ruby module
+
+Copyright:: Copyright (C) 2005 Evan Martin <martine@danga.com>
+Website:: http://neugierig.org/software/livejournal/ruby
+
+Example usage:
+  require 'livejournal/login'
+
+  puts "Logging in..."
+  user = LiveJournal::User.new('test', 'test')
+  login = LiveJournal::Request::Login.new(user)
+  login.run
+
+  puts "Login response:"
+  login.dumpresponse
+
+  puts "User's full name: #{user.fullname}"
+
+==LiveJournal Datatypes
+* LiveJournal::Server
+* LiveJournal::User
+* LiveJournal::Entry
+* LiveJournal::Comment
+* LiveJournal::Friend
+
+==Implemented Requests
+===Login Requests
+* LiveJournal::Request::Login
+* LiveJournal::Request::SessionGenerate (only useful for syncing)
+===Friend Requests
+* LiveJournal::Request::Friends
+* LiveJournal::Request::FriendOfs
+* LiveJournal::Request::CheckFriends
+===Entry Requests
+* LiveJournal::Request::GetEvents
+* LiveJournal::Request::EditEvent
+
+==Journal Offline Synchronization
+* LiveJournal::Sync::Entries
+* LiveJournal::Sync::Comments
+See samples/export for an example of how to use these.
+
+==SQLite3 Support
+* LiveJournal::Database -- storing/loading entries+comments with SQLite3
+Integrates well with syncing.  See samples/export.
+
+==Other Features
+* LiveJournal::LogJam -- interface with LogJam (http://logjam.danga.com) 's
+  journal exports
+

data/Rakefile

@@ -0,0 +1,60 @@
+require 'rake'
+require 'rake/gempackagetask'
+require 'rake/packagetask'
+require 'rake/rdoctask'
+require 'rake/testtask'
+
+PKG_NAME = 'livejournal'
+PKG_VERSION = '0.0.1'
+
+FILES = FileList[
+  'Rakefile', 'README', 'LICENSE', 'setup.rb',
+  'lib/**/*', 'sample/*', 'test/*'
+]
+
+spec = Gem::Specification.new do |s|
+  s.name = PKG_NAME
+  s.version = PKG_VERSION
+  s.summary = 'module for interacting with livejournal'
+  s.description = %q{LiveJournal module.  Post to livejournal, retrieve friends
+lists, edit entries, sync journal to an offline database.}
+  s.author = 'Evan Martin'
+  s.email = 'martine@danga.com'
+  s.homepage = 'http://neugierig.org/software/livejournal/ruby/'
+
+  s.has_rdoc = true
+  s.files = FILES.to_a
+end
+
+desc 'Build Package'
+Rake::GemPackageTask.new(spec) do |p|
+  p.need_tar = true
+  p.need_zip = true
+end
+
+
+desc 'Generate RDoc'
+Rake::RDocTask.new :rdoc do |rd|
+  rd.title = "ljrb (LiveJournal Ruby module) Documentation"
+  rd.rdoc_dir = 'doc'
+  rd.rdoc_files.add 'lib', 'README', 'LICENSE'
+  rd.main = 'README'
+end
+
+desc 'Run Tests'
+Rake::TestTask.new :test do |t|
+  t.test_files = FileList['test/*.rb']
+end
+
+desc 'Push data to my webspace'
+task :pushweb => [:rdoc, :package] do
+  pkg = "pkg/#{PKG_NAME}-#{PKG_VERSION}"
+  target = 'neugierig.org:/home/martine/www/neugierig/htdocs/software/livejournal/ruby'
+  sh %{rsync -av --delete doc/* #{target}/doc/}
+  sh %{rsync -av #{pkg}.* #{target}/download/}
+end
+
+desc 'Push everything'
+task :push => [:pushweb]  # XXX push to rubyforge
+
+# vim: set ts=2 sw=2 et :

data/lib/livejournal/basic.rb

@@ -0,0 +1,59 @@
+#!/usr/bin/ruby
+#--
+# ljrb -- LiveJournal Ruby module
+# Copyright (c) 2005 Evan Martin <martine@danga.com>
+#
+# 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.
+#++
+
+module LiveJournal
+  # A LiveJournal server.  name is currently unused.
+  class Server
+    attr_accessor :name, :url
+
+    def initialize(name, url)
+      @name = name
+      @url = url
+    end
+  end
+  DEFAULT_SERVER = Server.new("LiveJournal.com", "http://www.livejournal.com")
+
+  # A LiveJournal user.  Given a username, password, and server, running a
+  # LiveJournal::Request::Login will fill in the other fields.
+  class User
+    # parameter when creating a User
+    attr_accessor :username, :password, :server
+    # Set usejournal to log in as user username but act as user usejournal.
+    # For example, to work with a community you own.
+    attr_accessor :usejournal
+    # User's self-reported name, as retrieved by LiveJournal::Request::Login
+    attr_accessor :fullname
+    def initialize(username=nil, password=nil, server=nil)
+      @username = username
+      @password = password
+      @usejournal = nil
+      @server = server || LiveJournal::DEFAULT_SERVER
+    end
+    def to_s
+      "#{@username}: '#{@fullname}'"
+    end
+  end
+end
+
+# vim: ts=2 sw=2 et :

data/lib/livejournal/comment.rb

@@ -0,0 +1,82 @@
+#!/usr/bin/ruby
+#--
+# ljrb -- LiveJournal Ruby module
+# Copyright (c) 2005 Evan Martin <martine@danga.com>
+#
+# 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.
+#++
+#
+# LiveJournal comments.
+
+# http://www.livejournal.com/developer/exporting.bml
+
+module LiveJournal
+  class Comment
+    attr_accessor :commentid, :posterid, :itemid, :parentid
+    # State of the comment.  Possible values: {+:active+, +:screened+, +:deleted+}
+    attr_accessor :state 
+    attr_accessor :subject, :body
+    # a Ruby Time object
+    attr_reader   :time
+
+    def initialize
+      @commentid = @posterid = @itemid = @parentid = nil
+      @subject = @body = nil
+      @time = nil
+      @state = :active
+    end
+
+    # Convert a state to the string representation used by LiveJournal.
+    def self.state_from_string(str)
+      case str
+      when nil; :active
+      when 'A'; :active
+      when 'D'; :deleted
+      when 'S'; :screened
+      else raise ArgumentError, "Invalid comment state: #{str.inspect}"
+      end
+    end
+
+    # Convert a state from the string representation used by LiveJournal.
+    def self.state_to_string state
+      case state
+      when nil;       nil
+      when :active;   nil
+      when :deleted;  'D'
+      when :screened; 'S'
+      else raise ArgumentError, "Invalid comment state: #{state.inspect}"
+      end
+    end
+
+    def time=(time)
+      raise RuntimeError, "Must use GMT times everywhere to reduce confusion.  See LiveJournal::coerce_gmt for details." unless time.gmt?
+      @time = time
+    end
+
+    def ==(other)
+      [:commentid, :posterid, :state, :itemid, :parentid,
+       :subject, :body, :time].each do |attr|
+        return false if send(attr) != other.send(attr)
+      end
+      return true
+    end
+  end
+end
+
+# vim: ts=2 sw=2 et :

data/lib/livejournal/comments-xml.rb

@@ -0,0 +1,158 @@
+#!/usr/bin/ruby
+#--
+# ljrb -- LiveJournal Ruby module
+# Copyright (c) 2005 Evan Martin <martine@danga.com>
+#
+# 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.
+#++
+#
+# REXML is pleasant to use but hella slow, so we allow using the expat-based
+# parser as well.
+
+require 'livejournal/comment'
+require 'time'  # parsing xmlschema times
+
+module LiveJournal
+  HAVE_XML_PARSER = true
+
+  require 'rexml/document'
+  require 'xml/parser' if HAVE_XML_PARSER
+
+  module Sync
+    module CommentsXML
+      def self.optional_int_string(x)
+        return nil unless x
+        x.to_i
+      end
+
+      def self.load_comment_from_attrs(comment, attrs)
+        comment.commentid = attrs['id'].to_i
+        comment.posterid = CommentsXML::optional_int_string attrs['posterid']
+        comment.itemid   = CommentsXML::optional_int_string attrs['jitemid']
+        comment.parentid = CommentsXML::optional_int_string attrs['parentid']
+        statestr = attrs['state']
+        comment.state    = LiveJournal::Comment::state_from_string(statestr) if statestr
+      end
+
+      class Base
+        attr_reader :maxid, :comments, :usermap
+        def initialize(data=nil)
+          @maxid = nil
+          @comments = {}
+          @usermap = {}
+          parse data if data
+        end
+      end
+
+      class WithREXML < Base
+        def parse(data)
+          doc = REXML::Document.new(data)
+          root = doc.root
+          
+          root.elements.each('maxid') { |e| @maxid = e.text.to_i }
+
+          root.elements.each('comments/comment') do |e|
+            id = e.attributes['id'].to_i
+            comment = @comments[id] || Comment.new
+            CommentsXML::load_comment_from_attrs(comment, e.attributes)
+            e.elements.each('subject') { |s| comment.subject = s.text }
+            e.elements.each('body') { |s| comment.body = s.text }
+            e.elements.each('date') { |s| comment.time = Time::xmlschema s.text }
+            @comments[id] = comment
+          end
+
+          root.elements.each('usermaps/usermap') do |e|
+            id = e.attributes['id'].to_i
+            user = e.attributes['user']
+            @usermap[id] = user
+          end
+        end
+      end
+
+      if HAVE_XML_PARSER
+        class WithExpat < Base
+          class Parser < XMLParser
+            attr_reader :maxid, :comments, :usermap
+            def initialize
+              super
+              @maxid = nil
+              @cur_comment = nil
+              @comments = {}
+              @usermap = {}
+              @content = nil
+            end
+            def startElement(name, attrs)
+              case name
+              when 'maxid'
+                @content = ''
+              when 'comment'
+                id = attrs['id'].to_i
+                @cur_comment = @comments[id] || Comment.new
+                @comments[id] = @cur_comment
+                CommentsXML::load_comment_from_attrs(@cur_comment, attrs)
+              when 'usermap'
+                id = attrs['id'].to_i
+                user = attrs['user']
+                @usermap[id] = user
+              when 'date'
+                @content = ''
+              when 'subject'
+                @content = ''
+              when 'body'
+                @content = ''
+              end
+            end
+            def character(data)
+              @content << data if @content
+            end
+            def endElement(name)
+              return unless @content
+              case name
+              when 'maxid'
+                @maxid = @content.to_i
+              when 'date'
+                @cur_comment.time = Time::xmlschema(@content)
+              when 'subject'
+                @cur_comment.subject = @content
+              when 'body'
+                @cur_comment.body = @content
+              end
+              @content = nil
+            end
+          end
+          def parse(data)
+            parser = Parser.new
+            parser.parse(data)
+            @maxid = parser.maxid
+            @comments = parser.comments
+            @usermap = parser.usermap
+          end
+        end  # class WithExpat
+      end  # if HAVE_XML_PARSER
+
+      if HAVE_XML_PARSER
+        Parser = WithExpat
+      else
+        Parser = WithREXML
+      end
+    end  # module CommentsXML
+  end  # module Sync
+end  # module LiveJournal
+
+# vim: ts=2 sw=2 et :

data/lib/livejournal/database.rb

@@ -0,0 +1,292 @@
+#!/usr/bin/ruby
+#--
+# ljrb -- LiveJournal Ruby module
+# Copyright (c) 2005 Evan Martin <martine@danga.com>
+#
+# 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.
+#++
+#
+# This module interacts with the sqlite export from LogJam.
+
+require 'sqlite3'
+
+module LiveJournal
+  # A SQLite database dump.
+  class DatabaseError < RuntimeError; end
+  class Database
+    EXPECTED_DATABASE_VERSION = "1"
+    SCHEMA = %q{
+      CREATE TABLE meta (
+        key STRING PRIMARY KEY,
+        value STRING 
+      );
+      CREATE TABLE entry (
+        itemid INTEGER PRIMARY KEY,
+        anum INTEGER,
+        subject STRING,
+        event STRING,
+        moodid INTEGER, mood STRING, music STRING, taglist STRING, 
+        pickeyword STRING, preformatted INTEGER, backdated INTEGER, 
+        comments INTEGER, year INTEGER, month INTEGER, day INTEGER, 
+        timestamp INTEGER, security INTEGER
+      );
+      CREATE INDEX dateindex ON entry (year, month, day);
+      CREATE INDEX timeindex ON entry (timestamp);
+      CREATE TABLE comment (
+        commentid INTEGER PRIMARY KEY,
+        posterid INTEGER,
+        itemid INTEGER,
+        parentid INTEGER,
+        state STRING,  -- screened/deleted/active
+        subject STRING,
+        body STRING,
+        timestamp INTEGER  -- unix timestamp
+      );
+      CREATE INDEX commententry ON comment (itemid);
+      CREATE TABLE users (
+        userid INTEGER PRIMARY KEY,
+        username STRING
+      );
+      CREATE TABLE commentprop (
+        commentid INTEGER,  -- not primary key 'cause non-unique
+        key STRING,
+        value STRING
+      );
+      }.gsub(/^      /, '')
+
+    def self.optional_to_i(x)
+      return nil if x.nil?
+      return x.to_i
+    end
+
+    attr_reader :db
+    def initialize(filename, create=false)
+      exists = FileTest::exists? filename if create
+      @db = SQLite3::Database.new(filename)
+
+      # We'd like to use type translation, but it unfortunately fails on MAX()
+      # queries.
+      # @db.type_translation = true
+
+      if exists
+        version = self.version
+        unless version == EXPECTED_DATABASE_VERSION
+          raise DatabaseError, "Database version mismatch -- db has #{version.inspect}, expected #{EXPECTED_DATABASE_VERSION.inspect}"
+        end
+      end
+
+      #trace!
+      if create and not exists
+        run_schema!
+        self.version = EXPECTED_DATABASE_VERSION
+      end
+    end
+
+    def transaction
+      @db.transaction { yield }
+    end
+
+    def close
+      @db.close
+    end
+
+    def self.db_value(name, sym)
+      class_eval %{def #{sym}; get_meta(#{name.inspect}); end}
+      class_eval %{def #{sym}=(v); set_meta(#{name.inspect}, v); end}
+    end
+
+    db_value 'username', :username
+    db_value 'lastsync', :lastsync
+    db_value 'version', :version
+
+    def run_schema!
+      transaction do
+        @db.execute_batch(SCHEMA)
+      end
+    end
+    
+    # Turn tracing on.
+    def trace!
+      @db.trace() do |data, sql|
+        puts "SQL> #{sql.inspect}"
+      end
+    end
+
+    # Fetch a specific itemid.
+    def get_entry(itemid)
+      query_entry("select * from entry where itemid=?", itemid)
+    end
+
+    # Given SQL that selects an entry, return that entry.
+    def query_entry(sql, *sqlargs)
+      row = @db.get_first_row(sql, *sqlargs)
+      return Entry.new.load_from_database_row(row)
+    end
+
+    # Given SQL that selects some entries, yield each entry.
+    def query_entries(sql, *sqlargs)
+      @db.execute(sql, *sqlargs) do |row|
+        yield Entry.new.load_from_database_row(row)
+      end
+    end
+
+    # Yield most recent limit entries.
+    def each_entry(limit=nil, &block)
+      sql = 'SELECT * FROM entry ORDER BY itemid DESC'
+      sql += " LIMIT #{limit}" if limit
+      query_entries sql, &block
+    end
+
+    # Return the total number of entries.
+    def total_entry_count
+      @db.get_first_value('SELECT COUNT(*) FROM entry').to_i
+    end
+
+    def store_entry entry
+      sql = 'INSERT OR REPLACE INTO entry VALUES (' + ("?, " * 16) + '?)'
+      @db.execute(sql, *entry.to_database_row)
+    end
+
+    def last_comment_meta
+      Database::optional_to_i(
+          @db.get_first_value('SELECT MAX(commentid) FROM comment'))
+    end
+    def last_comment_full
+      Database::optional_to_i(
+          @db.get_first_value('SELECT MAX(commentid) FROM comment ' +
+                              'WHERE body IS NOT NULL'))
+    end
+
+    def _store_comments(comments, meta_only=true)
+      transaction do
+        sql = "INSERT OR REPLACE INTO comment "
+        if meta_only
+          sql += "(commentid, posterid, state) VALUES (?, ?, ?)"
+        else
+          sql += "VALUES (?, ?, ?, ?, ?, ?, ?, ?)"
+        end
+        @db.prepare(sql) do |stmt|
+          comments.each do |id, comment|
+            if meta_only
+              stmt.execute(comment.commentid, comment.posterid,
+                           LiveJournal::Comment::state_to_string(comment.state))
+            else
+              stmt.execute(*comment.to_database_row)
+            end
+          end
+        end
+      end
+    end
+
+    def store_comments_meta(comments)
+      _store_comments(comments, true)
+    end
+    def store_comments_full(comments)
+      _store_comments(comments, false)
+    end
+
+    def store_usermap(usermap)
+      transaction do
+        sql = "INSERT OR REPLACE INTO users VALUES (?, ?)"
+        @db.prepare(sql) do |stmt|
+          usermap.each do |id, user|
+            stmt.execute(id, user)
+          end
+        end
+      end
+    end
+
+    def get_meta key
+      return @db.get_first_value('SELECT value FROM meta WHERE key=?', key)
+    end
+    def set_meta key, value
+      db.transaction do
+        @db.execute('INSERT OR REPLACE INTO meta VALUES (?, ?)', key, value)
+      end
+    end
+  end
+
+  class Entry
+    # Parse an entry from a row from the database.
+    def load_from_database_row row
+      @itemid, @anum = row[0].to_i, row[1].to_i
+      @subject, @event = row[2], row[3]
+      @moodid, @mood = row[4].nil? ? nil : row[4].to_i, row[5]
+      @music, @taglist, @pickeyword = row[6], row[7], row[8]
+      @taglist = if @taglist then @taglist.split(/, /) else [] end
+      @preformatted, @backdated = !row[9].nil?, !row[10].nil?
+      @comments = case Database::optional_to_i(row[11])
+        when nil; :normal
+        when 1; :none
+        when 2; :noemail
+        else raise DatabaseError, "Bad comments value: #{row[11].inspect}"
+      end
+
+      @time = Time.at(row[15].to_i).utc
+
+      case Database::optional_to_i(row[16])
+      when nil
+        @security = :public
+      when 0
+        @security = :private
+      when 1
+        @security = :friends
+      else
+        @security = :custom
+        @allowmask = row[16]
+      end
+
+      self
+    end
+    def to_database_row
+      comments = case @comments
+        when :normal; nil
+        when :none; 1
+        when :noemail; 2
+      end
+      security = case @security
+        when :public; nil
+        when :private; 0
+        when :friends; 1
+        when :custom; @allowmask
+      end
+      [@itemid, @anum, @subject, @event,
+       @moodid, @mood, @music, @taglist.join(', '), @pickeyword,
+       @preformatted ? 1 : nil, @backdated ? 1 : nil, comments,
+       @time.year, @time.mon, @time.day, @time.to_i, security]
+    end
+  end
+  class Comment
+    def load_from_database_row row
+      @commentid, @posterid = row[0].to_i, row[1].to_i
+      @itemid, @parentid = row[2].to_i, row[3].to_i
+      @state = Comment::state_from_string row[4]
+      @subject, @body = row[5], row[6]
+      @time = Time.at(row[7]).utc
+      self
+    end
+    def to_database_row
+      state = Comment::state_to_string @state
+      [@commentid, @posterid, @itemid, @parentid,
+       state, @subject, @body, @time.to_i]
+    end
+  end
+end
+
+# vim: ts=2 sw=2 et :