livejournal2 0.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 70cf259619d7fdcfaa042318210d463f4dfdbaca194a3634bd24d8182a6df1a3
+  data.tar.gz: c8bdc3f44a4f54f47aed9fe1281654195e739e0da8756e283ad7bb651446b96f
+SHA512:
+  metadata.gz: d6676ce797ec2e5b7e32624a303e7176a8ba3c819c3571eafb2c34e9aaa4b71335b2b01523d1d996964c44e9881ee5bea9689724eca5bd67d0d0abb67ef8345c
+  data.tar.gz: 0ae722f3c4af8c3548a4b02e35d475246191000e61ac3aa2663eed93169aa3b662b56e161ec485df9e4b0ff5ce11d8813d778289060b285b38a30da801642783

data/Changes

@@ -0,0 +1,24 @@
+0.4.0: Sat, Mar 27 2021
+- forked version
+- added HTTPS support
+- added support for alternative servers
+
+0.3.7: Fri, Feb 10 2012
+- give_features support (Alexander Logunov)
+
+0.3.6: Fri, Jan 20 2012
+- Ruby 1.9.3 compatibility (Aleksandr Zykov)
+
+0.3.5: Thu, Jan 19 2012
+- Send User-Agent header (Aleksandr Zykov)
+
+0.3.3: Sat, Apr 23 2011
+- Populate the list of journals the user has posting access to.
+
+0.3.2: Mon, Nov 22 2010
+- Support for the new LiveJournal entry properties
+
+0.3.1:  Sat, 06 Jan 2007 10:21:05 -0800
+- Don't die on the "useragent" prop.
+- Add a :strict => false option to GetEvents so we won't die on any new prop.
+  see the GetEvents documentation for details.

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.md

@@ -0,0 +1,92 @@
+# LiveJournal API client
+
+This is a clone of the original [livejournal](https://github.com/romanbsd/livejournal) gem. A few minor fixes 
+and refactorings made. New functionality includes support for alternative 
+servers compatible with LiveJournal API (e.g. Dreamwidth.org).
+
+## How to use
+
+Add to your `Gemfile`:
+
+    gem "livejournal2"
+
+(Please note the name of the directory to require is still 
+`livejournal`, not `livejournal2`)
+
+## Example
+
+    require 'livejournal'
+
+    dreamwidth = LiveJournal::Server.new("Dreamwidth", "https://www.dreamwidth.org")
+    user = LiveJournal::User.new('test', 'testkey', dreamwidth)
+    login = LiveJournal::Request::Login.new(user)
+    login.run
+
+NOTE: For LiveJournal you use your actual password, but for Dreamwidth instead of 
+password you need to provide an API key that can be generated here: https://www.dreamwidth.org/manage/emailpost
+
+---
+
+Original README below:
+
+---
+
+# ljrb: LiveJournal Ruby module
+
+Copyright: Copyright (C) 2005 Evan Martin <martine@danga.com>
+
+Website: http://neugierig.org/software/livejournal/ruby
+
+Documentation: http://rubydoc.info/gems/livejournal/
+
+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
+
+### Friend Requests
+* LiveJournal::Request::Friends
+* LiveJournal::Request::FriendOfs
+* LiveJournal::Request::CheckFriends
+
+### Entry Requests
+* LiveJournal::Request::PostEvent
+* LiveJournal::Request::GetEvents
+* LiveJournal::Request::EditEvent
+
+### Comments Requests
+* Livejournal::Request::GetComments
+* Livejournal::Request::GetRecentComments
+
+## 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.  (XXX currently broken)

data/Rakefile

@@ -0,0 +1,39 @@
+require 'rdoc/task'
+require 'rake/testtask'
+
+FILES = FileList[
+  'Rakefile', 'README.md', 'Changes', 'LICENSE', 'setup.rb', 'VERSION',
+  'lib/**/*', 'sample/*', 'test/*'
+]
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+    gem.name = 'livejournal'
+    gem.summary = 'Module for interacting with livejournal'
+    gem.description = %q{LiveJournal module.  Post to livejournal, retrieve friends lists, edit entries, sync journal to an offline database.}
+    gem.email = 'romanbsd@yahoo.com'
+    gem.homepage = 'http://neugierig.org/software/livejournal/ruby/'
+    gem.authors = ['Evan Martin', 'Roman Shterenzon']
+    gem.files = FILES.to_a
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+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/livejournal/*.rb', 'README.md', 'LICENSE'
+  rd.main = 'README.md'
+end
+
+desc 'Run Tests'
+Rake::TestTask.new :test do |t|
+  t.test_files = FileList['test/*.rb']
+end
+
+# vim: set ts=2 sw=2 et :

data/VERSION

@@ -0,0 +1 @@
+0.4.0

data/lib/livejournal.rb

@@ -0,0 +1,6 @@
+require 'livejournal/entry'
+require 'livejournal/login'
+
+module LiveJournal
+  VERSION = File.read(File.expand_path('../../VERSION',__FILE__)).chomp.freeze
+end

data/lib/livejournal/basic.rb

@@ -0,0 +1,98 @@
+#!/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
+
+    def host
+      uri.host
+    end
+
+    def port
+      uri.port
+    end
+
+    def use_ssl
+      uri.scheme == "https"
+    end
+
+    def ==(server)
+      host == server.host
+    end
+
+    private
+    def uri
+      URI.parse(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
+    # Journals the user has posting access to
+    attr_accessor :journals
+
+    def initialize(username=nil, password=nil, server=nil)
+      @username = username
+      @password = password
+      @usejournal = nil
+      @server = server || LiveJournal::DEFAULT_SERVER
+    end
+    def journal
+      @usejournal || @username
+    end
+    def to_s
+      "#{@username}: '#{@fullname}'"
+    end
+    def canonical_journal_name
+      journal.tr("_", "-")
+    end
+    def journal_url
+      klass = server.use_ssl ? URI::HTTPS : URI::HTTP
+      host = server.host.gsub(/^www\./, "")
+      if journal[0] == "_"
+        klass.build(host: "users.#{host}", port: server.port, path: "/" + canonical_journal_name).to_s
+      else
+        klass.build(host: "#{canonical_journal_name}.#{host}", port: server.port).to_s
+      end
+    end
+  end
+end
+
+# vim: ts=2 sw=2 et :

data/lib/livejournal/comment.rb

@@ -0,0 +1,84 @@
+#!/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
+      when 'F'; :frozen
+      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'
+      when :frozen;   'F'
+      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,161 @@
+#!/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
+  begin
+    require 'xml/parser'
+    HAVE_XML_PARSER = true
+  rescue Exception
+    require 'rexml/document'
+    HAVE_XML_PARSER = false
+  end
+
+  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 :