vpim 0.695 → 13.11.11

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 097fd14cb6df0e01acccdc8b8724ce42b3b0a6ff
+  data.tar.gz: d6f031737c9c3c5fb4ba0676644f01c8db8966cb
+SHA512:
+  metadata.gz: cfb7b213e0094b6e9a3e2819b777325ff4e8454bebc8c981b8747e56119e311d58b10573b8bf4054c02a62982344eaa08b9b635d56833948e809fd776adc52b3
+  data.tar.gz: 1ebc4da3ad5a487425ed74c76437371537d5df8e264953f3de0c4ae11cc8d344f5f881872f61c77770a0e3b469860660d77d34818a02aa2979c0afdca853ddc6

data/{README → README.rdoc}

@@ -2,8 +2,7 @@ Author::     Sam Roberts <vieuxtech@gmail.com>
 Copyright::  Copyright (C) 2008 Sam Roberts
 License::    May be distributed under the same terms as Ruby
 Homepage::   http://vpim.rubyforge.org
-Download::   http://rubyforge.org/projects/vpim
-Install::    sudo gem install vpim
+Install::    gem install vpim
 
 vPim provides calendaring, scheduling, and contact support for Ruby through the
 standard iCalendar and vCard data formats for "personal information" exchange.
@@ -18,17 +17,7 @@ standard iCalendar and vCard data formats for "personal information" exchange.
 
 There is a vPim package installable using ruby-gems:
 
-  # sudo gem install vpim (may require root privilege)
-
-It is also installable in the standard way. Untar the package, and do:
-
-  $ ruby setup.rb --help
-
-or do:
-
-  $ ruby setup.rb config
-  $ ruby setup.rb setup
-  # ruby setup.rb install (may require root privilege)
+  # gem install vpim (may require root privilege)
 
 = Overview
 

data/lib/vpim.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/lib/vpim/address.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -139,7 +140,7 @@ module Vpim
         if partstat
           adr.partstat = partstat.first.strip.upcase
         end
-        
+
         rsvp = field.param('RSVP')
 
         if rsvp
@@ -163,7 +164,7 @@ module Vpim
         value = uri.to_str.strip
 
         if value.empty?
-          raise Uencodeable, "Address#uri is zero-length"
+          raise Unencodeable, "Address#uri is zero-length"
         end
 
         params = {}

data/lib/vpim/agent/atomize.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2009 Sam Roberts
 
@@ -52,6 +53,9 @@ module Vpim
         if caluri
           # This is maybe better described as :via, but with :alternate being
           # an html view of this feed.
+          #
+          # TODO should I change the scheme to be webcal?
+          # TODO should I extend URI to support webcal?
           f.links << Atom::Link.new do |l|
             l.href = caluri
             l.type = "text/calendar"

data/lib/vpim/agent/base.rb

@@ -0,0 +1,74 @@
+# -*- encoding : utf-8 -*-
+=begin
+  Copyright (C) 2009 Sam Roberts
+
+  This library is free software; you can redistribute it and/or modify it
+  under the same terms as the ruby language itself, see the file COPYING for
+  details.
+=end
+
+require 'cgi'
+
+require 'sinatra/base'
+
+# TODO Pasting of webcal links, conversion to webcal links?
+
+module Vpim
+  module Agent
+
+    class Base < Sinatra::Base
+      # Ensure that this happens...
+      set :haml, :format=>:html4 # Appears to do nothing, but maybe it will some day...
+
+      def css(template)
+        render :css, template, {}
+      end
+
+      def render_css(template, data, options) # :nodoc:
+        data
+      end
+
+      # Complete path, as requested by the client. Take care about CGI path rewriting.
+      def request_path
+        # Using .to_s because rack/request.rb does, though I think the Rack
+        # spec requires these to be strings already.
+        begin
+          URI.parse(env["SCRIPT_URI"].to_s).path
+        rescue
+          env["SCRIPT_NAME"].to_s + env["PATH_INFO"].to_s
+        end
+      end
+
+      # Complete path, as requested by the client, without the env's PATH_INFO.
+      # This is the path to whatever is "handling" the request.
+      #
+      # Recent discussions on how PATH_INFO must be decoded leads me to think
+      # this might not work if the path had any URL encoded characters in it.
+      def script_path
+        request_path.sub(/#{env["PATH_INFO"]}$/, "")
+      end
+
+      # URL-ready form of the host and port, where the port isn't specified if
+      # it is the default for the URL scheme.
+      def host_port
+        r = request
+        host_port = r.host
+
+        if r.scheme == "https" && r.port != 443 ||
+          r.scheme == "http" && r.port != 80
+          host_port << ":#{r.port}"
+        end
+
+        host_port
+      end
+
+      # URL to the script
+      def script_url
+        request.scheme + "://" + host_port + script_path
+      end
+
+    end # Base
+
+  end # Agent
+end # Vpim
+

data/lib/vpim/agent/calendars.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/lib/vpim/agent/handler.rb

@@ -0,0 +1,27 @@
+# -*- encoding : utf-8 -*-
+=begin
+  Copyright (C) 2009 Sam Roberts
+
+  This library is free software; you can redistribute it and/or modify it
+  under the same terms as the ruby language itself, see the file COPYING for
+  details.
+=end
+
+require 'sinatra/base'
+
+# Auto-choose our handler based on the environment.
+# TODO Code should be in Sinatra, and should handle Thin, Mongrel, etc.
+Sinatra::Base.configure do
+  server = Sinatra::Base.server
+  Sinatra::Base.set :server, Proc.new {
+      if ENV.include?("PHP_FCGI_CHILDREN")
+        break "fastcgi" # Must NOT be the correct class name!
+      elsif ENV.include?("REQUEST_METHOD")
+        break "cgi" # Must NOT be the correct class name!
+      else
+        # Fall back on whatever it was going to be.
+        server
+      end
+  }
+end
+

data/lib/vpim/agent/ics.rb

@@ -0,0 +1,162 @@
+# -*- encoding : utf-8 -*-
+=begin
+  Copyright (C) 2009 Sam Roberts
+
+  This library is free software; you can redistribute it and/or modify it
+  under the same terms as the ruby language itself, see the file COPYING for
+  details.
+=end
+
+require 'cgi'
+
+require 'vpim/agent/base'
+require 'vpim/agent/atomize'
+require 'vpim/repo'
+require 'vpim/view'
+
+require 'sinatra/base'
+
+module Vpim
+  module Agent
+
+    class Ics < Base
+      use_in_file_templates!
+
+      def atomize(caluri, feeduri)
+        repo = Vpim::Repo::Uri.new(caluri)
+        cal = repo.find{true}
+        cal = View.week(cal)
+        feed = Agent::Atomize.calendar(cal, feeduri, caluri, cal.name)
+        return feed.to_xml,  Agent::Atomize::MIME
+      end
+
+      ## Route handlers:
+      def get_base(from)
+        @url_base = script_url   # agent mount point
+        @url_ics  = from         # ics from here
+        @url_atom = nil          # atom feed from here, if ics is accessible
+        @url_error= nil          # error message, if is is not accessible
+
+        if not from.empty?
+          begin
+            atomize(from, "http://example.com")
+            @url_atom = @url_base + "/atom" + "?" + from
+          rescue
+            @url_error = CGI.escapeHTML($!.to_s)
+          end
+        end
+
+        haml :"vpim/agent/ics/view"
+      end
+
+      # When we support other forms..
+      #get '/ics/:form' do
+      #  form = params[:form]
+      def get_atom(caluri)
+        if caluri.empty?
+          redirect script_url
+        end
+
+        feeduri = script_url + "/atom?" + caluri
+
+        begin
+          xml, xmltype = atomize(caluri, feeduri)
+          content_type xmltype
+          body xml
+        rescue
+          redirect script_url + "?" + caluri
+        end
+      end
+
+      def get_style
+        content_type 'text/css'
+        css :"vpim/agent/ics/style"
+      end
+
+      ## Sinatra routing:
+      get '/?' do
+        get_base(env['QUERY_STRING'])
+      end
+
+      post "/?" do
+        redirect script_url + "?" + (params[:url] || "")
+      end
+
+      get "/atom" do
+        get_atom(env['QUERY_STRING'])
+      end
+
+      get '/style.css' do
+        get_style
+      end
+
+    end # Ics
+
+  end # Agent
+end # Vpim
+
+__END__
+@@vpim/agent/ics/style
+body {
+  background-color: gray;
+}
+h1 {
+  border-bottom: 3px solid #8B0000;
+  font-size: large;
+}
+form {
+  margin-left: 10%;
+}
+input.text {
+  width: 80%;
+}
+a {
+  color: black;
+}
+a:hover {
+  color: #8B0000;
+}
+tt {
+  margin-left: 10%;
+}
+.footer {
+  border-top: 3px solid #8B0000;
+}
+@@vpim/agent/ics/view
+!!! strict
+%html
+  %head
+    %title Subscribe to calendar feeds as atom feeds
+    %link{:href => script_url + "/style.css", :media => "screen", :type => "text/css"}
+    %meta{:"http-equiv" => "Content-Type", :content => "text/html;charset=utf-8"}
+  %body
+    %h1 Subscribe to calendar feeds as atom feeds
+    %p
+      Calendar feeds are great, but when you want a reminder of what's coming up
+      in the next week, you might want those events as an atom feed.
+    %p
+      Paste the URL of the calendar below, submit it, and subscribe.
+    %form{:method => 'POST', :action => script_url}
+      %p
+        %input.text{:type => 'text', :name => 'url', :value => @url_ics}
+        %input{:type => 'submit', :value => 'Submit'}
+    - if @url_atom
+      %p
+        Subscribe to
+        %a{:href => @url_ics}= @url_ics
+        as:
+      %ul.feed
+        %li
+          %a{:href => @url_atom}= @url_atom
+          (atom feed)
+    - if @url_error
+      %p
+        Sorry, trying to access
+        %tt=@url_ics
+        resulted in:
+      %p
+        %tt= @url_error
+    .footer
+      :textile
+        Brought from the "Octet Cloud":http://octetcloud.com/ using "vPim":http://vpim.rubyforge.org/, by cloud monkey "Sam Roberts":mailto:vieuxtech@gmail.com.
+

data/lib/vpim/attachment.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/lib/vpim/date.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -40,7 +41,7 @@ class Date
   #    February
   #  Date.bywday(2004, 2, Date.str2wday(2)) => the same day, but notice
   #    that a valid wday integer can be passed right through.
-  #   
+  #
   def Date.str2wday(wdaystr)
     return wdaystr unless wdaystr.respond_to? :to_str
 
@@ -56,7 +57,7 @@ class Date
     raise ArgumentError, 'wday #{wdaystr} was not a recognizable weekday name'
   end
 
-  
+
   # Create a new Date object for the date specified by year +year+, month
   # +mon+, and day-of-the-week +wday+.
   #

data/lib/vpim/dirinfo.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -94,7 +95,7 @@ module Vpim
         f.push Field.create('END', p)
         fields = f
       end
-      
+
       new(fields, profile)
     end
 
@@ -157,7 +158,7 @@ module Vpim
     # Examples:
     #
     # Print all the nicknames in a card:
-    #  
+    #
     #   card.enum_by_name('NICKNAME') { |f| puts f.value }
     #
     # Print an Array of the preferred email addresses in the card:
@@ -178,7 +179,7 @@ module Vpim
     #   end
     #
     # or to get an array of all the fields in group 'AGROUP', you could do:
-    # 
+    #
     #   card.enum_by_group('AGROUP').to_a
     def enum_by_group(group)
       Enumerator.new(self, Proc.new { |field| field.group?(group) })
@@ -250,7 +251,7 @@ module Vpim
     alias to_s encode
 
     # Check that the DirectoryInfo object is correctly delimited by a BEGIN
-    # and END, that their profile values match, and if +profile+ is specified, that 
+    # and END, that their profile values match, and if +profile+ is specified, that
     # they are the specified profile.
     def check_begin_end(profile=nil) #:nodoc:
       unless @fields.first

data/lib/vpim/duration.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/lib/vpim/enumerator.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/lib/vpim/field.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -50,7 +51,7 @@ module Vpim
         if group
           line << group << '.'
         end
-        
+
         line << name
 
         params.each do |pname, pvalues|
@@ -141,7 +142,7 @@ module Vpim
             # v2.1 params have no '=' sign, figure out what kind of param it
             # is (either its a known encoding, or we treat it as a 'TYPE'
             # param).
-           
+
             if $2 == ""
               params = $1
               case $1