というわけで mhc2gcal.rb はこちら．

前のバージョン（以前のものには番号が振られていなかった・・・）からの変更点について．

まず，ユーザ設定についてはスクリプトファイルに含めずに，外部の yaml ファイルに書き込む形式に変更しました．デフォルトではスクリプトと同じディレクトリの「.gcal」というファイルを参照するようになっていますので，以下の内容で「.gcal」というファイルを作成してください．

# google calendar Feed URL
gcal_feed: http://www.google.com/calendar/feeds/XXXXXXXXXXXXXXXX@group.calendar.google.com/private/full
# email address
gcal_mail: XXXXXXXXXX@gmail.com
# password
gcal_pass: XXXXXXX
# sync mode (delete or keep)
gcal_mode: keep

「gcal_feed」「gcal_mail」「gcal_pass」については，小文字になった以外は前回と同様．

変更点かつ注意点は「gcal_mode」で，これを「delete」とすると Google Calendar のデータを削除する，「keep」とすると削除せずにキープする，という仕組みになっています．どちらでもないと設定エラーになります．このような仕様になっている理由はこちらのエントリをご参照ください．

次に，コマンドラインオプションについて．

  --help               show this message.
--category=CATEGORY  pick only in CATEGORY.
'!' and space separated multiple values are allowed.
--secret=CATEGORY    change the title of the event to 'SECRET'
space separated multiple values are allowed.
--date={string[+n],string-string}
set a period of date.
string is one of these:
today, tomorrow, sun ... sat, yyyymmdd, yyyymm, yyyy
yyyymm lists all days in the month and yyyy lists all
days in the year.
list n+1 days of schedules if +n is given.
default value is 'today+0'
--description        add description.
--verbose            verbose mode.
--proxy-addr=addr    set the address of http proxy.
--proxy-port=port    set the port number of http proxy.
--proxy-user=user    set the username of http proxy.
--proxy-pass=pass    set the password of http proxy.
--version            display the version of mhc2gcal and exit.

まず proxy 対応について．オプションで –proxy-addr=addr と –proxy-port=port が指定されていると，そのIPアドレス（あるいはホスト）とポート番号をプロキシとして使用します．どちらかが欠けてたら使用しません．次に –proxy-user=user と –proxy-pass=pass が指定されていると，それらをユーザ名およびパスワード名としてプロキシの認証に使います．これもどちらかが欠けていると認証は有効になりません．
ちなみに実行時には，プロキシおよびプロキシ認証の有無に応じて以下のような表示があります．ご確認ください．

プロキシ未使用時
Connect to Google Calendar directly
プロキシ使用時（認証なし）
Connect to Google Calendar through proxy(addr:port)
プロキシ使用時（認証あり）
Connect to Google Calendar through proxy(user:pass@addr:port)

次に description について．オプションとして –description を指定すると，イベントに詳細が追加されます．詳細の書式などに関しては，白井さんが追加してくださったものをそのまま採用させていただきました．

そして verbose について．オプションとして –verbose を指定すると，どのイベントを削除したのか，どのイベントを登録したのか，という情報が表示されます．動作の確認などにご活用ください．

最後に個人的な使い方の例．当方は MacOSX (Leopard) 環境下でこのスクリプトを使っているのですが，プロキシの設定が zsh の環境変数には引き継がれません．なんとか反映させたいと思い，以下のようなスクリプトで動作させています．

#!/bin/sh
SCUTIL=/usr/sbin/scutil
GREP=/usr/bin/grep
PERL=/usr/bin/perl
RUBY=/usr/bin/ruby
MHC2GCAL_DIR=/path/to/mhc2gcal/dir
PROXY_ENABLE=`$SCUTIL --proxy | $GREP "HTTPEnable" | $PERL -pe 's/^.*HTTPEnable : (.*)$/$1/'`
if [ $PROXY_ENABLE -eq 1 ]
then
PROXY_ADDR=`$SCUTIL --proxy | $GREP "HTTPProxy" | $PERL -pe 's/^.*HTTPProxy : (.*)$/$1/'`
PROXY_PORT=`$SCUTIL --proxy | $GREP "HTTPPort" | $PERL -pe 's/^.*HTTPPort : (.*)$/$1/'`
fi
cd $MHC2GCAL_DIR
if [ $PROXY_ENABLE -eq 1 ]
then
$RUBY ./mhc2gcal.rb --date=today+60 --category="!todo !done !holiday !birthday" --secret="private" --verbose --proxy-addr="$PROXY_ADDR" --proxy-port="$PROXY_PORT"
else
$RUBY ./mhc2gcal.rb --date=today+60 --category="!todo !done !holiday !birthday" --secret="private" --verbose
fi

結構満足．

というわけで mhc2gcal.rb はこちら．

まずは設定．上記スクリプト内の該当部分を，各自の環境に合わせて変更．

# google calendar Feed URL
GCAL_FEED = "http://www.google.com/calendar/feeds/XXXXXXXXXXXXXXXX@group.calendar.google.com/private/full"
# email address
GCAL_MAIL = "XXXXXXXXXX@gmail.com"
# password
GCAL_PASS = "XXXXXXX"
# delete events in the period of date from google calendar
GCAL_DEL  = false

GCAL_FEED は Google Calendar のカレンダーの個人用 URL というもの．カレンダーの詳細から見ることができる．ただし private の部分と full の部分は，違う書式になっていると思うので，こちらを参考にして，書き込みのできる URL に修正．
GCAL_MAIL は Google Calendar にアクセスするためのメールアカウント．おそらく Gmail のアカウントだったりするのではなかろうか．
GCAL_PASS は Google Calendar にアクセスするためのパスワード．これも同上．

GCAL_DEL は注意が必要．この値を true にすると，後述のコマンドラインオプションなどで指定された期間のイベントを Google Calendar から削除します．デフォルトでは GCAL_DEL の値は false にしてあります．よく理解した上でご利用下さい．

mhc2gcal が MHC から Google Calendar への一方的な登録のみを実現したくて作成したものです．Google Calendar に登録されているイベントを考慮しないため，何度も実行するとイベントが重複して登録されてしまいます．これを防ぐため，当方は以下のような利用方法を想定しています．

1. MHC のスケジュールを登録するだけのカレンダーを Google Calendar に追加する．
2. このカレンダーは，Google Calendar のインタフェースなどからは閲覧するだけでイベント登録はしないようにします．
3. その上で，そのカレンダーの個人用 URL を GCAL_FEED に， GCAL_DEL の値を true に設定して使用する．

当方では上記のような利用方法で，特に問題なく動作しています．

次に，コマンドラインオプションの一覧．

  --help               show this message.
--category=CATEGORY  pick only in CATEGORY.
'!' and space separated multiple values are allowed.
--secret=CATEGORY    change the title of the event to 'SECRET'
space separated multiple values are allowed.
--date={string[+n],string-string}
set a period of date.
string is one of these:
today, tomorrow, sun ... sat, yyyymmdd, yyyymm, yyyy
yyyymm lists all days in the month and yyyy lists all
days in the year.
list n+1 days of schedules if +n is given.
default value is 'today+0'

ベースとなった mhc2ical と同じ部分が多い．新たに追加した機能として，スケジュールを他人と共有することを目的として作成したので，あるイベントの詳細は隠したいけど，時間が埋まっていますよ，という部分を示すために，特定のカテゴリのイベントを SECRET というタイトルのイベントで登録するようにした．コマンドラインオプションでは –secret オプションで指定する．

最後に，使い方の例．

ruby mhc2gcal.rb --date=today+90 --category="!todo !done !holiday" --secret="private"

上記のようなオプション指定で，以下のように動作する．
　・実行当日から90日分のスケジュールを登録する．
　・カテゴリが todo done holiday のイベントは含めない．
　・カテゴリが private のイベントを secret に指定してタイトルを隠す．

とまぁ，こんな感じ．本来であれば，両方向の同期を実現したいところだが，自分の利用方法としては今の仕様で十分だったので，とりあえず開発終了．

なお，このスクリプトを使用する際は，使用方法などをよく把握し，またスクリプト内で何が行われるのかを理解した上で，ご利用いただけますよう，お願い申し上げます．このスクリプトを使用して何らかの問題が生じた場合，当方は責任を負いませんので，ご了承下さい．自己責任でお願いします．