fairtilizer-vpim 0.695

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. data/CHANGES +510 -0
  2. data/COPYING +58 -0
  3. data/README +182 -0
  4. data/lib/vpim.rb +13 -0
  5. data/lib/vpim/address.rb +219 -0
  6. data/lib/vpim/agent/atomize.rb +104 -0
  7. data/lib/vpim/agent/base.rb +73 -0
  8. data/lib/vpim/agent/calendars.rb +173 -0
  9. data/lib/vpim/agent/handler.rb +26 -0
  10. data/lib/vpim/agent/ics.rb +161 -0
  11. data/lib/vpim/attachment.rb +102 -0
  12. data/lib/vpim/date.rb +222 -0
  13. data/lib/vpim/dirinfo.rb +277 -0
  14. data/lib/vpim/duration.rb +119 -0
  15. data/lib/vpim/enumerator.rb +32 -0
  16. data/lib/vpim/field.rb +614 -0
  17. data/lib/vpim/icalendar.rb +384 -0
  18. data/lib/vpim/maker/vcard.rb +16 -0
  19. data/lib/vpim/property/base.rb +193 -0
  20. data/lib/vpim/property/common.rb +315 -0
  21. data/lib/vpim/property/location.rb +38 -0
  22. data/lib/vpim/property/priority.rb +43 -0
  23. data/lib/vpim/property/recurrence.rb +69 -0
  24. data/lib/vpim/property/resources.rb +24 -0
  25. data/lib/vpim/repo.rb +261 -0
  26. data/lib/vpim/rfc2425.rb +367 -0
  27. data/lib/vpim/rrule.rb +591 -0
  28. data/lib/vpim/time.rb +40 -0
  29. data/lib/vpim/vcard.rb +1426 -0
  30. data/lib/vpim/version.rb +18 -0
  31. data/lib/vpim/vevent.rb +187 -0
  32. data/lib/vpim/view.rb +90 -0
  33. data/lib/vpim/vjournal.rb +58 -0
  34. data/lib/vpim/vpim.rb +65 -0
  35. data/lib/vpim/vtodo.rb +103 -0
  36. data/samples/README.mutt +93 -0
  37. data/samples/ab-query.rb +57 -0
  38. data/samples/agent.ru +10 -0
  39. data/samples/cmd-itip.rb +156 -0
  40. data/samples/ex_cpvcard.rb +55 -0
  41. data/samples/ex_get_vcard_photo.rb +22 -0
  42. data/samples/ex_mkv21vcard.rb +34 -0
  43. data/samples/ex_mkvcard.rb +64 -0
  44. data/samples/ex_mkyourown.rb +29 -0
  45. data/samples/ics-dump.rb +210 -0
  46. data/samples/ics-to-rss.rb +84 -0
  47. data/samples/mutt-aliases-to-vcf.rb +45 -0
  48. data/samples/osx-wrappers.rb +86 -0
  49. data/samples/reminder.rb +209 -0
  50. data/samples/rrule.rb +71 -0
  51. data/samples/tabbed-file-to-vcf.rb +390 -0
  52. data/samples/vcf-dump.rb +86 -0
  53. data/samples/vcf-lines.rb +61 -0
  54. data/samples/vcf-to-ics.rb +22 -0
  55. data/samples/vcf-to-mutt.rb +121 -0
  56. data/test/test_agent_atomize.rb +84 -0
  57. data/test/test_agent_calendars.rb +128 -0
  58. data/test/test_agent_ics.rb +96 -0
  59. data/test/test_all.rb +17 -0
  60. data/test/test_date.rb +120 -0
  61. data/test/test_dur.rb +41 -0
  62. data/test/test_field.rb +156 -0
  63. data/test/test_ical.rb +437 -0
  64. data/test/test_misc.rb +13 -0
  65. data/test/test_repo.rb +129 -0
  66. data/test/test_rrule.rb +1030 -0
  67. data/test/test_vcard.rb +973 -0
  68. data/test/test_view.rb +79 -0
  69. metadata +140 -0
@@ -0,0 +1,86 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ $-w = true
4
+ $:.unshift File.dirname($0) + '/../lib'
5
+
6
+ require 'pp'
7
+ require 'getoptlong'
8
+ require 'vpim/vcard'
9
+
10
+ HELP =<<EOF
11
+ Usage: #{$0} <vcard>...
12
+
13
+ Options
14
+ -h,--help Print this helpful message.
15
+ -n,--name Print the vCard name.
16
+ -d,--debug Print debug information.
17
+
18
+ Examples:
19
+ EOF
20
+
21
+ opt_name = nil
22
+ opt_debug = nil
23
+
24
+ opts = GetoptLong.new(
25
+ [ "--help", "-h", GetoptLong::NO_ARGUMENT ],
26
+ [ "--name", "-n", GetoptLong::NO_ARGUMENT ],
27
+ [ "--debug", "-d", GetoptLong::NO_ARGUMENT ]
28
+ )
29
+
30
+ opts.each do |opt, arg|
31
+ case opt
32
+ when "--help" then
33
+ puts HELP
34
+ exit 0
35
+
36
+ when "--name" then
37
+ opt_name = true
38
+
39
+ when "--debug" then
40
+ opt_debug = true
41
+ end
42
+ end
43
+
44
+ if ARGV.length < 1
45
+ puts "no vcard files specified, try -h!"
46
+ exit 1
47
+ end
48
+
49
+ ARGV.each do |file|
50
+
51
+ cards = Vpim::Vcard.decode(open(file))
52
+
53
+ cards.each do |card|
54
+ card.each do |field|
55
+ puts "..#{field.name.capitalize}=#{field.value.inspect}"
56
+
57
+ if field.group
58
+ puts " group=#{field.group}"
59
+ end
60
+
61
+ field.each_param do |param, values|
62
+ puts " #{param}=[#{values.join(", ")}]"
63
+ end
64
+ end
65
+
66
+ if opt_name
67
+ begin
68
+ puts "#name=#{card.name.formatted}"
69
+ rescue
70
+ puts "! failed to decode name!"
71
+ end
72
+ end
73
+
74
+
75
+ if opt_debug
76
+ card.groups.sort.each do |group|
77
+ card.enum_by_group(group).each do |field|
78
+ puts "#{group} -> #{field.inspect}"
79
+ end
80
+ end
81
+ end
82
+
83
+ puts ""
84
+ end
85
+ end
86
+
@@ -0,0 +1,61 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ $-w = true
4
+ $:.unshift File.dirname($0) + '/../lib'
5
+
6
+ require 'pp'
7
+ require 'getoptlong'
8
+ require 'vpim/vcard'
9
+
10
+ HELP =<<EOF
11
+ Usage: #{$0} <vcard>...
12
+
13
+ Options
14
+ -h,--help Print this helpful message.
15
+
16
+ Examples:
17
+ EOF
18
+
19
+ opt_name = nil
20
+ opt_debug = nil
21
+
22
+ opts = GetoptLong.new(
23
+ [ "--help", "-h", GetoptLong::NO_ARGUMENT ],
24
+ [ "--name", "-n", GetoptLong::NO_ARGUMENT ],
25
+ [ "--debug", "-d", GetoptLong::NO_ARGUMENT ]
26
+ )
27
+
28
+ opts.each do |opt, arg|
29
+ case opt
30
+ when "--help" then
31
+ puts HELP
32
+ exit 0
33
+
34
+ when "--name" then
35
+ opt_name = true
36
+
37
+ when "--debug" then
38
+ opt_debug = true
39
+ end
40
+ end
41
+
42
+ if ARGV.length < 1
43
+ puts "no vcard files specified, try -h!"
44
+ exit 1
45
+ end
46
+
47
+ ARGV.each do |file|
48
+
49
+ cards = Vpim::Vcard.decode(open(file))
50
+
51
+ cards.each do |card|
52
+ card.lines.each_with_index do |line, i|
53
+ print line.name
54
+ if line.group.length > 0
55
+ print " (", line.group, ")"
56
+ end
57
+ print ": ", line.value.inspect, "\n"
58
+ end
59
+ end
60
+ end
61
+
@@ -0,0 +1,22 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ require 'vpim/vcard'
4
+ require 'vpim/icalendar'
5
+
6
+ $in = ARGV.first ? File.open(ARGV.shift) : $stdin
7
+ $out = ARGV.first ? File.open(ARGV.shift, 'w') : $stdout
8
+
9
+ cal = Vpim::Icalendar.create
10
+
11
+ Vpim::Vcard.decode($in).each do |card|
12
+ if card.birthday
13
+ cal.push Vpim::Icalendar::Vevent.create_yearly(
14
+ card.birthday,
15
+ "Birthday for #{card['fn'].strip}"
16
+ )
17
+ $stderr.puts "#{card['fn']} -> bday #{cal.events.last.dtstart}"
18
+ end
19
+ end
20
+
21
+ puts cal.encode
22
+
@@ -0,0 +1,121 @@
1
+ #!/usr/bin/env ruby
2
+ #
3
+ # For a query command, mutt expects output of the form:
4
+ #
5
+ # informational line
6
+ # <email>TAB<name>[TAB<other info>]
7
+ # ...
8
+ #
9
+ # For an alias command, mutt expects output of the form:
10
+ # alias NICKNAME EMAIL
11
+ #
12
+ # NICKNAME shouldn't have spaces, and EMAIL can be either "user@example.com",
13
+ # "<user@example.com>", or "User <user@example.com>".
14
+
15
+ $-w = true
16
+ $:.unshift File.dirname($0) + '/../lib'
17
+
18
+
19
+ require 'getoptlong'
20
+ require 'vpim/vcard'
21
+
22
+ HELP =<<EOF
23
+ Usage: vcf-to-mutt.rb [--aliases] [query]
24
+
25
+ Queries a vCard file and prints the results in Mutt's query result format, or
26
+ as a Mutt alias file. No query matches all vCards.
27
+
28
+ The query is matched against all fields, so you can use 'climbers' to match all
29
+ vCards that has that string in the Notes field if you want to email all the
30
+ rock climbers you know. Or you can query all vCards with addresses in a
31
+ particular city, you get the idea.
32
+
33
+ Options
34
+ -h,--help Print this helpful message.
35
+ -a,--aliases Output an alias file, otherwise output a query response.
36
+
37
+ Examples:
38
+
39
+ Put in your muttrc file (either ~/.muttrc or ~/.mutt/muttrc) a line such as:
40
+
41
+ set query_command = "vcf-to-mutt.rb '%s' < ~/mycards.vcf"
42
+
43
+ Bugs:
44
+
45
+ The aliases output file bases the alias name on the nickname, or the full
46
+ name, but either way, they aren't guaranteed to be unique if you have more than
47
+ email address in a vCard, or more than one vCard for the same nickname or full
48
+ name.
49
+ EOF
50
+
51
+ opt_query = ''
52
+ opt_aliases = false
53
+
54
+ opts = GetoptLong.new(
55
+ [ "--help", "-h", GetoptLong::NO_ARGUMENT ],
56
+ [ "--aliases", "-a", GetoptLong::NO_ARGUMENT ]
57
+ )
58
+
59
+ opts.each do |opt, arg|
60
+ case opt
61
+ when "--help" then
62
+ puts HELP
63
+ exit 0
64
+
65
+ when "--aliases" then
66
+ opt_aliases = true
67
+ end
68
+ end
69
+
70
+ opt_query = ARGV.first
71
+
72
+ module Mutt
73
+ def Mutt.vcard_query(cards, query)
74
+ query = query.downcase if query
75
+ cards.find_all do |card|
76
+ card.detect do |f|
77
+ !query || f.value.downcase.include?(query)
78
+ end
79
+ end
80
+ end
81
+
82
+ def Mutt.query_print(cards, caption)
83
+ puts caption
84
+
85
+ cards.each do
86
+ |vcard|
87
+ # find the email addresses
88
+ vcard.enum_by_name("email").each do |f|
89
+ nn = vcard.nickname
90
+ nn = nn ? "\t#{nn}" : ""
91
+ puts "#{f.value}\t#{vcard['fn']}#{nn}"
92
+ end
93
+ end
94
+ end
95
+
96
+ def Mutt.alias_print(cards)
97
+ cards.each do
98
+ |vcard|
99
+ # find the email addresses
100
+ vcard.enum_by_name("email").each do |f|
101
+ em = f.value
102
+ fn = vcard['fn']
103
+ nn = vcard.nickname || fn.gsub(/\s+/,'')
104
+ puts "alias #{nn} #{fn} <#{em}>"
105
+ end
106
+ end
107
+ end
108
+
109
+ end
110
+
111
+ cards = Vpim::Vcard.decode($stdin)
112
+
113
+ matches = Mutt::vcard_query(cards, opt_query)
114
+
115
+ if opt_aliases
116
+ Mutt::alias_print(matches)
117
+ else
118
+ qstr = opt_query == '' ? '<all records>' : opt_query;
119
+ Mutt::query_print(matches, "Query #{qstr} against #{cards.size} vCards:")
120
+ end
121
+
@@ -0,0 +1,84 @@
1
+ require 'test/common'
2
+
3
+ require 'vpim/agent/atomize'
4
+ require 'vpim/icalendar'
5
+ require 'vpim/view'
6
+
7
+ class TextAgentAtomize < Test::Unit::TestCase
8
+
9
+ def atomize(cal, feeduri, caluri, filter=nil)
10
+ ical = Vpim::Icalendar.decode(cal).first
11
+ if filter
12
+ ical = filter.call(ical)
13
+ end
14
+ feed = Vpim::Agent::Atomize.calendar(ical, feeduri, caluri)
15
+ return ical, feed
16
+ end
17
+
18
+ def test_minimal
19
+ ical, feed = atomize(<<'__', "http://example.com/feed", "http://example.com/calendar")
20
+ BEGIN:VCALENDAR
21
+ BEGIN:VEVENT
22
+ DTSTART:20090214T144503
23
+ END:VEVENT
24
+ END:VCALENDAR
25
+ __
26
+
27
+ assert_equal(feed.entries.size, 1)
28
+ assert_equal("http://example.com/feed", feed.id)
29
+ assert_equal("http://example.com/calendar", feed.title)
30
+ assert(feed.to_xml.to_str)
31
+ assert_equal(nil, feed.entries.first.title)
32
+ assert_equal(nil, feed.entries.first.content)
33
+ #puts feed.to_xml
34
+ end
35
+
36
+ def test_small
37
+ ical, feed = atomize(<<'__', "http://example.com/feed", "http://example.com/calendar")
38
+ BEGIN:VCALENDAR
39
+ BEGIN:VEVENT
40
+ DTSTART:20090214T144503
41
+ SUMMARY:I am summarized
42
+ DESCRIPTION:And I am described
43
+ UID:very, very, unique
44
+ END:VEVENT
45
+ END:VCALENDAR
46
+ __
47
+
48
+ assert_equal(feed.entries.size, 1)
49
+ assert_equal("http://example.com/feed", feed.id)
50
+ assert_equal("http://example.com/calendar", feed.title)
51
+ assert_equal("I am summarized", feed.entries.first.title)
52
+ assert_equal("And I am described", feed.entries.first.content)
53
+ assert(feed.to_xml.to_str)
54
+ #puts feed.to_xml
55
+ end
56
+
57
+ def test_recurring
58
+ filter = proc do |cal|
59
+ Vpim::View.week(cal)
60
+ end
61
+ ical, feed = atomize(<<'__', "http://example.com/feed", "http://example.com/calendar", filter)
62
+ BEGIN:VCALENDAR
63
+ BEGIN:VEVENT
64
+ DTSTART:20090214T144503
65
+ RRULE:FREQ=weekly
66
+ SUMMARY:I am summarized
67
+ DESCRIPTION:And I am described
68
+ UID:very, very, unique
69
+ END:VEVENT
70
+ END:VCALENDAR
71
+ __
72
+
73
+ #puts feed.to_xml
74
+ assert_equal(1, feed.entries.size)
75
+ assert_equal("http://example.com/feed", feed.id)
76
+ assert_equal("http://example.com/calendar", feed.title)
77
+ assert_equal("I am summarized", feed.entries.first.title)
78
+ assert_equal("And I am described", feed.entries.first.content)
79
+ assert(feed.to_xml.to_str)
80
+ end
81
+
82
+ end
83
+
84
+
@@ -0,0 +1,128 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ require 'vpim/repo'
4
+ require 'vpim/agent/calendars'
5
+ require 'test/common'
6
+
7
+ class TestAgentCalendars < Test::Unit::TestCase
8
+ Apple3 = Vpim::Repo::Apple3
9
+ Directory = Vpim::Repo::Directory
10
+ Uri = Vpim::Repo::Uri
11
+ Agent = Vpim::Agent
12
+ Path = Agent::Path
13
+ NotFound = Agent::NotFound
14
+
15
+ def setup
16
+ @testdir = Dir.getwd + "/test" #File.dirname($0) doesn't work with rcov :-(
17
+ @caldir = @testdir + "/calendars"
18
+ @eventsz = Dir[@caldir + "/**/*.ics"].size
19
+ assert(@testdir)
20
+ assert(test(?d, @caldir), "no caldir "+@caldir)
21
+ end
22
+
23
+ def assert_is_text_calendar(text)
24
+ lines = text.split("\n")
25
+ lines = lines.first, lines.last
26
+ assert_equal("BEGIN:VCALENDAR", lines.first.upcase, lines)
27
+ assert_equal("END:VCALENDAR", lines.last.upcase, lines)
28
+ end
29
+
30
+ def test_agent_calendars
31
+ repo = Apple3.new(@caldir)
32
+ rest = Agent::Calendars.new(repo)
33
+
34
+ out1, form = rest.get(Path.new("http://host/here", "/here"))
35
+ assert_equal("text/html", form)
36
+ #puts(out1)
37
+
38
+ out1, form = rest.get(Path.new("http://host/here/weather%2fLeavenworth", "/here"))
39
+ assert_equal("text/html", form)
40
+ #puts(out1)
41
+
42
+ out2, form = rest.get(Path.new("http://host/here/weather%2fLeavenworth/calendar", "/here"))
43
+ assert_equal("text/calendar", form)
44
+ assert_is_text_calendar(out2)
45
+
46
+ #assert_equal(out1, out2)
47
+
48
+ assert_raise(Vpim::Agent::NotFound) do
49
+ rest.get(Path.new("http://host/here/weather%2fLeavenworth/an_unknown_protocol", "/here"))
50
+ end
51
+ assert_raise(Vpim::Agent::NotFound) do
52
+ rest.get(Path.new("http://host/here/no_such_calendar", "/here"))
53
+ end
54
+
55
+ assert_equal(["","/","/"], Vpim::Agent::Path.split_path("/%2F/%2F"))
56
+ assert_equal(["/","/"], Vpim::Agent::Path.split_path("%2F/%2F"))
57
+ assert_equal(["calendars", "weather/Leavenworth"],
58
+ Vpim::Agent::Path.split_path("calendars/weather%2FLeavenworth"))
59
+ end
60
+
61
+ def test_agent_calendar_atom
62
+ repo = Apple3.new(@caldir)
63
+ rest = Agent::Calendars.new(repo)
64
+
65
+ out, form = rest.get(Path.new("http://host/here/weather%2fLeavenworth/atom", "/here"))
66
+ assert_equal("application/atom+xml", form)
67
+ #pp out
68
+ #assert_is_atom(out)
69
+ end
70
+
71
+ def _test_path_shift(url, shifts)
72
+ # last shift should be a nil
73
+ shifts << nil
74
+
75
+ # presence or absence of a trailing / should not affect shifting
76
+ ["", "/"].each do |trailer|
77
+ path = Path.new(url + trailer)
78
+ shifts.each do |_|
79
+ assert_equal(_, path.shift)
80
+ end
81
+ end
82
+ end
83
+
84
+ def test_path_shift
85
+ _test_path_shift("http://host.ex", [])
86
+ _test_path_shift("http://host.ex/a", ["a"])
87
+ _test_path_shift("http://host.ex/a/b", ["a", "b"])
88
+ _test_path_shift("http://host.ex/a/b/c", ["a", "b", "c"])
89
+ end
90
+
91
+ def _test_path_prefix(base, parts, shifts, prefix)
92
+ path = Path.new(base+parts.join("/"))
93
+ shifts.times{ path.shift }
94
+ assert_equal(prefix, path.prefix)
95
+ end
96
+
97
+ def test_path_prefix
98
+ _test_path_prefix("http://host.ex/", [], 0, "/")
99
+ _test_path_prefix("http://host.ex/", ["a"], 0, "/")
100
+ _test_path_prefix("http://host.ex/", ["a"], 1, "/")
101
+ _test_path_prefix("http://host.ex/", ["a"], 2, "/a/")
102
+ _test_path_prefix("http://host.ex/", ["a"], 3, "/a/")
103
+ _test_path_prefix("http://host.ex/", ["a", "b"], 0, "/")
104
+ _test_path_prefix("http://host.ex/", ["a", "b"], 1, "/")
105
+ _test_path_prefix("http://host.ex/", ["a", "b"], 2, "/a/")
106
+ _test_path_prefix("http://host.ex/", ["a", "b"], 3, "/a/b/")
107
+ end
108
+
109
+ =begin
110
+ def test_atomize
111
+ repo = Apple3.new(@caldir)
112
+ cal = repo.find{true}
113
+ a = Vpim::Agent::Atomize.new(cal)
114
+ assert( a.get(Path.new("http://example.com/path")))
115
+ end
116
+
117
+ def x_test_uri_query
118
+ uri = "http://example.com/ics/atom?http://localhost:9876"
119
+
120
+ repo = Uri.new("http://localhost:9876")
121
+ rest = Agent::Calendars.new(repo)
122
+ out1, form = rest.get(Path.new("http://example.com/ics", "/ics/atom"))
123
+ p [out1, form]
124
+ end
125
+ =end
126
+
127
+ end
128
+