gcalapi 0.0.3

data/README

@@ -0,0 +1,13 @@
+= GoogleCalendar -- Google Calendar API
+
+== Installation
+
+ # gem install gcalapi
+
+== License
+
+This library is public domain software.
+
+== Author
+
+zoriorz@gmail.com

data/Rakefile

@@ -0,0 +1,82 @@
+require 'rake/gempackagetask'
+require "rake/contrib/rubyforgepublisher"
+
+require 'rbconfig'
+include Config
+
+PKG_NAME = 'gcalapi'
+PKG_VERSION = File.read('VERSION').chomp
+PKG_FILES = FileList["**/*"].exclude(".svn").exclude("pkg").exclude("test/temp_*.rb").exclude("test/parameters.rb")
+
+desc "Installing library"
+task :install  do
+  ruby 'install.rb'
+end
+
+desc "Testing library"
+task :test do
+  sh '(cd test; sh all.sh)'
+end
+
+desc "Removing generated files"
+task :clean do
+  rm_rf 'html'
+end
+
+# Create RDOC documentation.
+task :rdoc do
+  sh "rdoc -S -o html README lib/googlecalendar/*.rb"
+end
+
+spec = Gem::Specification.new do |s|
+  #### Basic information.
+
+  s.name = PKG_NAME
+  s.version = PKG_VERSION
+  s.summary = "Google Calendar API"
+  s.description = ""
+
+  #### Dependencies and requirements.
+
+  s.files = PKG_FILES
+
+  #### C code extensions.
+
+  #s.extensions << "ext/extconf.rb"
+
+  #### Load-time details: library and application (you will need one or both).
+
+  s.require_path = 'lib'                         # Use these for libraries.
+  s.autorequire = "googlecalendar/calendar"
+
+  #### Documentation and testing.
+
+  s.has_rdoc = true
+  #s.extra_rdoc_files = rd.rdoc_files.reject { |fn| fn =~ /\.rb$/ }.to_a
+  s.extra_rdoc_files = 'README'
+  s.rdoc_options << '--line-numbers' << '--inline-source'
+  #s.rdoc_options <<
+  #  '--title' <<  'Rake -- Ruby Make' <<
+  #  '--main' << 'README' <<
+  #  '--line-numbers'
+  s.test_files = Dir.glob('test/*_test.rb')
+
+  #### Author and project details.
+
+  s.author = "zorio"
+  s.email = "zoriorz@gmail.com"
+  s.homepage = "http://gcalapi.rubyforge.net"
+  s.rubyforge_project = "gcalapi"
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_tar = true
+  pkg.package_files += PKG_FILES
+end
+
+task :release => [ :clean, :package ]
+
+desc "Publish to RubyForge"
+task :rubyforge => [:rdoc, :package] do
+  Rake::RubyForgePublisher.new(PKG_NAME, "zorio").upload
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.3

data/example/mail2gcal.rb

@@ -0,0 +1,101 @@
+require "kconv"
+require "yaml"
+require "net/pop"
+require "googlecalendar/calendar"
+
+#
+# This example shows how to create an event for Google Calendar from an e-mail.
+#
+# 1. the subject of the email must be 'gcal'.
+#
+# 2. write the mail body in yaml format. here is an example.
+#      st: 2006-09-26 09:30:00
+#      en: 2006-09-26 11:00:00
+#      title: title of an event
+#      desc: description of an event
+#      where: location of an event
+#
+# 3. send the mail to your mail account.
+#
+# 4. execute this sample script.
+#
+
+POP_SERVER = "your pop server"
+POP_PORT = 110
+POP_ACCOUNT = "your account"
+POP_PASSWORD = "your password"
+
+GCAL_ACCOUNT = "your gmail account"
+GCAL_PASSWORD = "your gmail password"
+GCAL_FEED = "http://www.google.com/calendar/feeds/XXXXXXXXXXX@group.calendar.google.com/private/full"
+
+TARGET_SUBJECT = "gcal"
+
+# very simple e-mail parser.
+class Mail
+  attr_accessor :subject, :body
+  def initialize(cont)
+    self.subject = nil
+    self.body = nil
+    parse(cont)
+  end
+
+  SUBJECT = /^Subject: (.*)$/
+
+  def parse(cont)
+    head = true
+    bd = []
+    cont.each_line do |line|
+      if head
+        line.chomp!
+        if line =~ SUBJECT
+          self.subject = $1
+        elsif line == ""
+          head = false
+        end
+      else
+        bd << line
+      end
+    end
+    self.body = bd.join("")
+  end
+end
+
+server = GoogleCalendar::Service.new(GCAL_ACCOUNT, GCAL_PASSWORD)
+calendar = GoogleCalendar::Calendar.new(server, GCAL_FEED)
+
+#
+# * make an event of the calendar
+# * set attributes of the event from email content.
+# * update the event to the calendar.
+#
+def calendar.from_mail(mail)
+  event = self.create_event
+  yaml = YAML::load(mail.body)
+  event.st = Time.parse(yaml["st"].to_s) if yaml.has_key?("st")
+  event.en = Time.parse(yaml["en"].to_s) if yaml.has_key?("en")
+  event.title = yaml["title"].toutf8 if yaml.has_key?("title")
+  event.desc = yaml["desc"].toutf8 if yaml.has_key?("desc")
+  event.where = yaml["where"].toutf8 if yaml.has_key?("where")
+  event.allday = yaml["allday"] if yaml.has_key?("allday")
+  event.save!
+end
+
+pop = Net::POP3.APOP(true).new(POP_SERVER, POP_PORT)
+pop.start(POP_ACCOUNT, POP_PASSWORD)
+
+if pop.mails.empty? then
+  puts 'no mail.'
+else
+  i = 0
+  pop.each_mail do |m|
+    mail = Mail.new(m.pop)
+    if mail.subject == TARGET_SUBJECT
+      calendar.from_mail(mail)
+      m.delete
+      i += 1
+    end
+  end
+  puts "#{i} mail(s) processed."
+end
+pop.finish

data/example/ol2gcal.rb

@@ -0,0 +1,55 @@
+require "googlecalendar/calendar"
+require "win32ole"
+require "nkf"
+
+
+# google calendar Feed URL
+FEED_URL = "http://www.google.com/calendar/feeds/XXXXXXXXXXXXXXXX@group.calendar.google.com/private/full"
+# email address
+EMAIL = "XXXXXXXXXX@gmail.com"
+# password
+PASS = "XXXXXXX"
+
+def each_event
+  created = false
+  ol = nil
+  begin 
+    ol = WIN32OLE.connect("Outlook.Application") 
+  rescue 
+    created = true
+    ol = WIN32OLE.new("Outlook.Application") 
+  end
+  ns = ol.GetNameSpace("MAPI")
+  folder = ns.GetDefaultFolder(9) #olFolderCalendar
+  folder.Items.each do |event|
+    GC.start
+    yield event
+  end
+  ol.Quit if created
+end
+
+#proxy setting
+GoogleCalendar::Service.proxy_addr="192.168.0.1"
+GoogleCalendar::Service.proxy_port="8080"
+
+@srv = GoogleCalendar::Service.new(EMAIL, PASS)
+@cal = GoogleCalendar::Calendar.new(@srv, FEED_URL)
+
+# Delete All Future Data Of Google Calendar
+now = Time.now
+@cal.events(now, nil).each do |ev| ev.destroy! end
+
+# Insert All Future Data Of Outlook
+@nstr = now.strftime("%Y/%m/%d %H:%M:%S")
+each_event do |oev|
+  if oev.Start > @nstr
+    gev = @cal.create_event
+    #NKF is used for japanese charcter code conversion
+    gev.title = NKF.nkf("-w", oev.Subject)
+    gev.where = NKF.nkf("-w", oev.Location)
+    gev.st = Time.parse(oev.Start)
+    gev.en = Time.parse(oev.End)
+    gev.allday = oev.AllDayEvent
+    gev.save!
+  end 
+end

data/html/classes/GoogleCalendar.html

@@ -0,0 +1,281 @@
+<?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>Module: GoogleCalendar</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>Module</strong></td>
+          <td class="class-name-in-header">GoogleCalendar</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../files/lib/googlecalendar/calendar_rb.html">
+                lib/googlecalendar/calendar.rb
+                </a>
+        <br />
+                <a href="../files/lib/googlecalendar/event_rb.html">
+                lib/googlecalendar/event.rb
+                </a>
+        <br />
+                <a href="../files/lib/googlecalendar/service_rb.html">
+                lib/googlecalendar/service.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+
+
+   </div>
+
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+
+      <div class="name-list">
+      <a href="#M000004">create_event</a>&nbsp;&nbsp;
+      <a href="#M000003">events</a>&nbsp;&nbsp;
+      <a href="#M000001">new</a>&nbsp;&nbsp;
+      <a href="#M000002">source</a>&nbsp;&nbsp;
+      </div>
+    </div>
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+
+      Class <a href="GoogleCalendar/AuthenticationFailed.html" class="link">GoogleCalendar::AuthenticationFailed</a><br />
+Class <a href="GoogleCalendar/Calendar.html" class="link">GoogleCalendar::Calendar</a><br />
+Class <a href="GoogleCalendar/Event.html" class="link">GoogleCalendar::Event</a><br />
+Class <a href="GoogleCalendar/EventDeleteFailed.html" class="link">GoogleCalendar::EventDeleteFailed</a><br />
+Class <a href="GoogleCalendar/EventInsertFailed.html" class="link">GoogleCalendar::EventInsertFailed</a><br />
+Class <a href="GoogleCalendar/EventUpdateFailed.html" class="link">GoogleCalendar::EventUpdateFailed</a><br />
+Class <a href="GoogleCalendar/InvalidCalendarURL.html" class="link">GoogleCalendar::InvalidCalendarURL</a><br />
+Class <a href="GoogleCalendar/Service.html" class="link">GoogleCalendar::Service</a><br />
+
+    </div>
+
+
+
+
+    <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">feed</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        </table>
+      </div>
+    </div>
+      
+
+
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+
+      <div id="method-M000001" class="method-detail">
+        <a name="M000001"></a>
+
+        <div class="method-heading">
+          <a href="#M000001" class="method-signature">
+          <span class="method-name">new</span><span class="method-args">(srv, feed)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+srv: <a href="GoogleCalendar/Service.html">GoogleCalendar::Service</a>
+object feed: <a href="GoogleCalendar/Calendar.html">Calendar</a>&#8217;s
+editable feed url
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000001-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000001-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/googlecalendar/calendar.rb, line 65</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">srv</span>, <span class="ruby-identifier">feed</span>)
+      <span class="ruby-ivar">@srv</span> = <span class="ruby-identifier">srv</span>
+      <span class="ruby-ivar">@feed</span> = <span class="ruby-identifier">feed</span>
+      <span class="ruby-ivar">@source</span> = <span class="ruby-keyword kw">nil</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <h3 class="section-bar">Public Instance methods</h3>
+
+      <div id="method-M000004" class="method-detail">
+        <a name="M000004"></a>
+
+        <div class="method-heading">
+          <a href="#M000004" class="method-signature">
+          <span class="method-name">create_event</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+creates a new <a href="GoogleCalendar/Event.html">Event</a> instance which
+belongs to this clandar instance.
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000004-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000004-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/googlecalendar/calendar.rb, line 100</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">create_event</span>
+      <span class="ruby-identifier">ev</span> = <span class="ruby-constant">Event</span>.<span class="ruby-identifier">new</span>
+      <span class="ruby-identifier">ev</span>.<span class="ruby-identifier">srv</span> = <span class="ruby-ivar">@srv</span>
+      <span class="ruby-identifier">ev</span>.<span class="ruby-identifier">feed</span> = <span class="ruby-ivar">@feed</span>
+      <span class="ruby-identifier">ev</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000003" class="method-detail">
+        <a name="M000003"></a>
+
+        <div class="method-heading">
+          <a href="#M000003" class="method-signature">
+          <span class="method-name">events</span><span class="method-args">(conditions = {})</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+send query to get events and returns an array of <a
+href="GoogleCalendar/Event.html">Event</a> objects. if any conditions are
+given, recent 25 entries are retrieved. For detail, see <a
+href="GoogleCalendar/Service.html#M000020">Service#query</a>
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000003-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000003-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/googlecalendar/calendar.rb, line 84</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">events</span>(<span class="ruby-identifier">conditions</span> = {})
+      <span class="ruby-identifier">ret</span> = <span class="ruby-ivar">@srv</span>.<span class="ruby-identifier">query</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">feed</span>, <span class="ruby-identifier">conditions</span>)
+      <span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidCalendarURL</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">ret</span>.<span class="ruby-identifier">code</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;200&quot;</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">ret</span>.<span class="ruby-identifier">body</span>).<span class="ruby-identifier">root</span>.<span class="ruby-identifier">elements</span>.<span class="ruby-identifier">each</span>(<span class="ruby-value str">&quot;entry&quot;</span>){}.<span class="ruby-identifier">map</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">elem</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">elem</span>.<span class="ruby-identifier">attributes</span>[<span class="ruby-value str">&quot;xmlns:gCal&quot;</span>] = <span class="ruby-value str">&quot;http://schemas.google.com/gCal/2005&quot;</span>
+        <span class="ruby-identifier">elem</span>.<span class="ruby-identifier">attributes</span>[<span class="ruby-value str">&quot;xmlns:gd&quot;</span>] = <span class="ruby-value str">&quot;http://schemas.google.com/g/2005&quot;</span>
+        <span class="ruby-identifier">elem</span>.<span class="ruby-identifier">attributes</span>[<span class="ruby-value str">&quot;xmlns&quot;</span>] = <span class="ruby-value str">&quot;http://www.w3.org/2005/Atom&quot;</span>
+        <span class="ruby-identifier">entry</span> = <span class="ruby-constant">Event</span>.<span class="ruby-identifier">new</span>
+        <span class="ruby-identifier">entry</span>.<span class="ruby-identifier">srv</span> = <span class="ruby-ivar">@srv</span>
+        <span class="ruby-identifier">entry</span>.<span class="ruby-identifier">load_xml</span>(<span class="ruby-node">&quot;&lt;?xml version='1.0' encoding='UTF-8'?&gt;#{elem.to_s}&quot;</span>)
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000002" class="method-detail">
+        <a name="M000002"></a>
+
+        <div class="method-heading">
+          <a href="#M000002" class="method-signature">
+          <span class="method-name">source</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+REXML::Document object which represents calendar object
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000002-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000002-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/googlecalendar/calendar.rb, line 74</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">source</span>
+      <span class="ruby-ivar">@source</span> = <span class="ruby-identifier">get_data</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@source</span>
+      <span class="ruby-ivar">@source</span>
+    <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>