writeexcel 0.5.0 → 0.6.0

data/writeexcel.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{writeexcel}
-  s.version = "0.5.0"
+  s.version = "0.6.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Hideo NAKAMURA"]
-  s.date = %q{2010-10-14}
+  s.date = %q{2010-11-03}
   s.description = %q{Multiple worksheets can be added to a workbook and formatting can be applied to cells. Text, numbers, formulas, hyperlinks and images can be written to the cells.}
   s.email = %q{cxn03651@msj.biglobe.ne.jp}
   s.extra_rdoc_files = [
@@ -219,7 +219,6 @@ Gem::Specification.new do |s|
      "test/test_example_match.rb",
      "test/test_format.rb",
      "test/test_formula.rb",
-     "test/test_new_encoding.rb",
      "test/test_ole.rb",
      "test/test_storage_lite.rb",
      "test/test_workbook.rb",
@@ -231,7 +230,7 @@ Gem::Specification.new do |s|
   s.homepage = %q{http://wiki.github.com/cxn03651/writeexcel/}
   s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.6}
+  s.rubygems_version = %q{1.3.7}
   s.summary = %q{Write to a cross-platform Excel binary file.}
   s.test_files = [
     "test/helper.rb",
@@ -272,7 +271,6 @@ Gem::Specification.new do |s|
      "test/test_example_match.rb",
      "test/test_format.rb",
      "test/test_formula.rb",
-     "test/test_new_encoding.rb",
      "test/test_ole.rb",
      "test/test_storage_lite.rb",
      "test/test_workbook.rb",
@@ -331,7 +329,7 @@ Gem::Specification.new do |s|
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     s.specification_version = 3
 
-    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
     else
     end
   else

data/writeexcel.rdoc

@@ -74,7 +74,7 @@ WriteExcelは、エクセルの機能へのできるだけ多くのインター
 
  require 'writeexcel'                                    # Step 0
 
- workbook  = Spreadsheet::WriteExcel.new('ruby.xls')     # Step 1
+ workbook  = WriteExcel.new('ruby.xls')     # Step 1
  worksheet = workbook.add_worksheet                      # Step 2
  worksheet.write('A1', 'Hi Excel!')                      # Step 3
  workbook.close                                          # Step 4
@@ -85,7 +85,7 @@ WriteExcelは、エクセルの機能へのできるだけ多くのインター
 
 = Workbook メソッド
 
-Spreadsheet::WriteExcel ライブラリは新規のワークブックへのオブジェクト指向のインターフェイスを提供します。新たなワークブックに対して次のメソッドを使用することが出来ます。
+WriteExcel ライブラリは新規のワークブックへのオブジェクト指向のインターフェイスを提供します。新たなワークブックに対して次のメソッドを使用することが出来ます。
 
  new
  add_worksheet
@@ -105,24 +105,24 @@ Spreadsheet::WriteExcel ライブラリは新規のワークブックへのオ
 
 new コンストラクタは新しいエクセルワークブックを作成します。パラメータとしてファイル名かファイルハンドルを受け取ります。（※ファイル名しか対応していません）
 
- workbook  = Spreadsheet::WriteExcel.new('filename.xls')
+ workbook  = WriteExcel.new('filename.xls')
  worksheet = workbook.add_worksheet
  worksheet.write(0, 0, 'Hi Excel!')
 
 ※ また、デフォルトのフォーマットを指定することもできます。例えば、ＭＳＰ ゴシックで１１ポイントなど。
 
- workbook  = Spreadsheet::WriteExcel.new('filename.xls', :font => 'ＭＳＰ ゴシック', :size = 11)
+ workbook  = WriteExcel.new('filename.xls', :font => 'ＭＳＰ ゴシック', :size = 11)
 
 ファイル名を使った別の使用例です。
 
- workbook = Spreadsheet::WriteExcel.new(filename)
- workbook = Spreadsheet::WriteExcel.new('/tmp/filename.xls')
- workbook = Spreadsheet::WriteExcel.new("c:\\tmp\\filename.xls")
- workbook = Spreadsheet::WriteExcel.new('c:\tmp\filename.xls')
+ workbook = WriteExcel.new(filename)
+ workbook = WriteExcel.new('/tmp/filename.xls')
+ workbook = WriteExcel.new("c:\\tmp\\filename.xls")
+ workbook = WriteExcel.new('c:\tmp\filename.xls')
 
 最後の２つの例は、DOSやWindowsでディレクトリの区切りの「\」をエスケープするか、シングルクォートで囲んでそのまま指定していするかの例です。
 
-new() コンストラクタは、Spreadsheet::WriteExcelオブジェクト（ワークブックオブジェクト）を返し、これにワークシートを加えデータを書き込みます。
+new() コンストラクタは、WriteExcelオブジェクト（ワークブックオブジェクト）を返し、これにワークシートを加えデータを書き込みます。
 
 == add_worksheet([sheetname])
 
@@ -160,11 +160,54 @@ add_format()メソッドは、セルに書式を設定するのに使用する
 
 == set_properties()
 
-※未対応
+タイトル、作成者など文書のプロパティを設定する。これらプロパティは、エクセルで
+メニューのファイル(F)-プロパティ(I)で見ることができ、他のアプリケーションから
+読んだり索引付けをすることもできる。
+
+プロパティは、次のようにハッシュで渡す。
+
+    workbook.set_properties(
+        :title    => 'This is an example spreadsheet',
+        :author   => 'cxn03651',
+        :comments => 'Created with Ruby and WriteExcel'
+    )
+
+設定できるプロパティは、
+
+   * タイトル
+   * サブタイトル
+   * 作成者
+   * 管理者
+   * 会社名
+   * 分類
+   * キーワード
+   * コメント
+
+ユーザー定義のプロパティはサポートしていません。
+
+UTF-8文字列も渡すことができます。
+
+    workbook.set_properties(
+        :subject => "住所録"
+    )
+
+通常、WriteExcelはUTF-16の文字を使うことが出来るのですが、文書プロパティ
+ではUTF-16文字はサポートされていません。
+
+ルビーとWriteExcelの使い良さを広めるため、文書のプロパティをセットする時には、
+次のようにコメントをセットしましょう。
+
+    workbook.set_properties(
+        ...,
+        :comments => 'Created with Ruby and WriteExcel',
+        ...,
+    )
+
+examples内のproperties.rbプログラムもご覧下さい。
 
 == set_tempdir()
 
-速度と効率のため、ワークブックのデータを最後に組み立てる前に、Spreadsheet::WriteExcelはワークシートのデータをテンポラリファイルに置きます。テンポラリファイルを作ることが出来ない場合はメモリ上で作業します。この場合、大きなファイルになると遅くなることがあります。
+速度と効率のため、ワークブックのデータを最後に組み立てる前に、WriteExcelはワークシートのデータをテンポラリファイルに置きます。テンポラリファイルを作ることが出来ない場合はメモリ上で作業します。この場合、大きなファイルになると遅くなることがあります。
 この問題はWindows上でIISと併せて使っているときに主として発生しますが、UNIXシステムでも起こることがあります。
 この問題は概して、既定の一時ファイルディレクトリがC:\やその他IISが書き込みを提供していないディレクトリに設定されているのが原因で発生します。
 この問題を避けるために、set_tempdir()メソッドを使って一時ファイルを作成できるディレクトリを指定します。
@@ -250,7 +293,7 @@ sheets()メソッドはワークブック内のワークシートの全リスト
 
 エクセルは日付を実数で格納しています。その整数部分は「epoch」からの日数を、小数部分は１日のうちのパーセンテージを格納しています。「epoch」は、Windowsのエクセルでは1900年、マッキントッシュのエクセルでは1904年です。ですが、どちらのプラットフォームでもエクセルは自動的にシステム間の相違をコンバートして扱います。
 
-Spreadsheet::WriteExcelではデフォルトで1900年を用います。もしも変更したいのであれば、workbookに対してset_1904()メソッドを呼んでください。現在の値を問い合わせるにはget_1904()を呼びます。これは、1900ならば0を、1904ならば1を返します。
+WriteExcelではデフォルトで1900年を用います。もしも変更したいのであれば、workbookに対してset_1904()メソッドを呼んでください。現在の値を問い合わせるにはget_1904()を呼びます。これは、1900ならば0を、1904ならば1を返します。
 
 エクセルの日付の取り扱いについては、"DATES AND TIME IN EXCEL"も見てください。
 
@@ -258,9 +301,9 @@ Spreadsheet::WriteExcelではデフォルトで1900年を用います。もし
 
 == set_codepage(codepage)
 
-Spreadsheet::WriteExcelで使われるデフォルトのコードページ、文字セットはANSIです。これはWindowsのエクセルの既定値でもあります。しかしながら、たまにコードページを変更する必要が生じたときは、set_codepage()メソッドを使って変更します。
+WriteExcelで使われるデフォルトのコードページ、文字セットはANSIです。これはWindowsのエクセルの既定値でもあります。しかしながら、たまにコードページを変更する必要が生じたときは、set_codepage()メソッドを使って変更します。
 
-コードページの変更は、マッキントッシュ上でSpreadsheet::WriteExcelを使用していて、ASCII 128以外の文字セットを使いたい場合に必要になることがあります。
+コードページの変更は、マッキントッシュ上でWriteExcelを使用していて、ASCII 128以外の文字セットを使いたい場合に必要になることがあります。
 
  workbook.set_codepage(1)  # ANSI, MS Windows
  workbook.set_codepage(2)  # Apple Macintosh
@@ -617,7 +660,7 @@ URLの形式は４つ(http://, https://, ftp://, mailto:)をサポートして
 
  worksheet.write_url('A15', 'external:c;\temp\foo.xls#my_name')
 
-注：現在のSpreadsheet::WriteExcelでは、名前付け範囲の設定は対応していません。
+注：現在のWriteExcelでは、名前付け範囲の設定は対応していません。
 
 エクセルでは、シート名に空白や非英数字が含まれる場合、'Sales Data'!A1のようにクォートで囲む必要があります。この場合、シート名に含まれる文字は必要であればエスケープしてください。 'c:\temp' はダブルクォートでは"c:\\temp"とします。
 

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: writeexcel
 version: !ruby/object:Gem::Version 
+  hash: 7
   prerelease: false
   segments: 
   - 0
-  - 5
+  - 6
   - 0
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors: 
 - Hideo NAKAMURA
@@ -14,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-10-14 00:00:00 +09:00
+date: 2010-11-03 00:00:00 +09:00
 default_executable: 
 dependencies: []
 
@@ -230,7 +231,6 @@ files:
 - test/test_example_match.rb
 - test/test_format.rb
 - test/test_formula.rb
-- test/test_new_encoding.rb
 - test/test_ole.rb
 - test/test_storage_lite.rb
 - test/test_workbook.rb
@@ -248,23 +248,27 @@ rdoc_options:
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.6
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Write to a cross-platform Excel binary file.
@@ -307,7 +311,6 @@ test_files:
 - test/test_example_match.rb
 - test/test_format.rb
 - test/test_formula.rb
-- test/test_new_encoding.rb
 - test/test_ole.rb
 - test/test_storage_lite.rb
 - test/test_workbook.rb

data/test/test_new_encoding.rb

@@ -1,205 +0,0 @@
-# -*- coding: utf-8 -*-
-require 'helper'
-require 'nkf'
-
-class TC_new_encoding < Test::Unit::TestCase
-  def setup
-    ruby_18 do
-      @kcode = $KCODE
-      $KCODE = 'u'
-    end
-  end
-
-  def teardown
-    ruby_18 { $KCODE = @kcode }
-  end
-
-  def test_finder
-    if RUBY_VERSION < '1.9'
-      %w{ UTF_8 UTF-8 utf-8 utf }.each do |name|
-        e = Encoding.find(name)
-        assert_equal 'UTF_8', e.name
-        assert_equal 2, e.value
-      end
-    end
-  end
-
-  def test_comparison
-    if RUBY_VERSION < '1.9'
-      assert_equal Encoding.find('US-ASCII'), Encoding.find('ASCII')
-      assert_equal Encoding.find('ASCII-8BIT'), Encoding.find('BINARY')
-      assert_not_equal Encoding.find('ASCII'), Encoding.find('UTF-8')
-    end
-  end
-  
-  
-  # TEST WITH ALTERNATE Encoding NAMES
-  def test_ascii_str_ascii_to_ascii
-    str = ascii_str_enc_us_ascii
-    assert_equal(Encoding::ASCII, str.encode('ASCII').encoding)
-  end
-  def test_ascii_str_ascii_to_us_ascii
-    str = ascii_str_enc_us_ascii
-    assert_equal(Encoding::US_ASCII, str.encode('US-ASCII').encoding)
-  end
-
-  def test_ascii_str_ascii_to_binary
-    str = ascii_str_enc_us_ascii
-    assert_equal(Encoding::BINARY, str.encode('BINARY').encoding)
-  end
-  def test_ascii_str_ascii_to_ascii_8bit
-    str = ascii_str_enc_us_ascii
-    assert_equal(Encoding::ASCII_8BIT, str.encode('ASCII-8BIT').encoding)
-  end
-
-  def test_ascii_str_utf8_to_ascii
-    str = ascii_str_enc_utf8
-    assert_equal(Encoding::ASCII, str.encode('US-ASCII').encoding)
-  end
-
-  def test_non_ascii_str_utf8_to_ascii
-    str = non_ascii_str_enc_utf8
-    assert_raise(Encoding::UndefinedConversionError) { str.encode('US-ASCII') }
-  end
-
-  def test_ascii_str_utf8_to_binary
-    str = ascii_str_enc_utf8
-    assert_equal(Encoding::BINARY, str.encode('ASCII-8BIT').encoding)
-  end
-
-  def test_non_ascii_str_utf8_to_binary
-    str = non_ascii_str_enc_utf8
-    assert_raise(Encoding::UndefinedConversionError) { str.encode('ASCII-8BIT') }
-  end
-  
-  
-  
-  def ascii_str_enc_ascii
-    str = ["abc"].pack('a*').encode('ASCII')
-    str.encode('ASCII') if RUBY_VERSION < "1.9"
-    str
-  end
-
-  def test_ascii_str_enc_ascii_is_ascii_encoding
-    assert_equal(Encoding::ASCII, ascii_str_enc_ascii.encoding)
-  end
-
-  def ascii_str_enc_us_ascii
-    str = ["abc"].pack('a*').encode('US-ASCII')
-    str.encode('US-ASCII') if RUBY_VERSION < "1.9"
-    str
-  end
-
-  def test_ascii_str_enc_ascii_is_ascii_encoding
-    assert_equal(Encoding::ASCII, ascii_str_enc_us_ascii.encoding)
-  end
-
-  def ascii_str_enc_binary
-    str = ["abc"].pack('a*').encode('BINARY')
-    str.encode('BINARY') if RUBY_VERSION < "1.9"
-    str
-  end
-
-  def test_ascii_str_enc_binary_is_binary_encoding
-    assert_equal(Encoding::BINARY, ascii_str_enc_binary.encoding)
-  end
-
-  def non_ascii_str_enc_binary
-    str = [0x80].pack('v*')
-    str.force_encoding('BINARY')
-    str
-  end
-
-  def test_non_ascii_str_enc_binary
-    assert_equal(Encoding::BINARY, non_ascii_str_enc_binary.encoding)
-  end
-
-  def ascii_str_enc_utf8
-    "abc"
-  end
-
-  def test_ascii_str_enc_utf8_is_utf8_encoding
-    assert_equal(Encoding::UTF_8, ascii_str_enc_utf8.encoding)
-  end
-
-  def non_ascii_str_enc_utf8
-    'あいう'
-  end
-
-  def test_non_ascii_str_enc_utf8
-    assert_equal(Encoding::UTF_8, non_ascii_str_enc_utf8.encoding)
-  end
-
-  def ascii_str_enc_eucjp
-    str = "abc".encode('EUCJP')
-    str
-  end
-
-  def test_ascii_str_enc_eucjp_is_eucjp_encoding
-    assert_equal(Encoding::EUCJP, ascii_str_enc_eucjp.encoding)
-  end
-
-  def non_ascii_str_enc_eucjp
-    str = 'あいう'.encode('EUCJP')
-    str
-  end
-
-  def test_non_ascii_str_enc_eucjp
-    assert_equal(Encoding::EUCJP, non_ascii_str_enc_eucjp.encoding)
-  end
-
-  def ascii_str_enc_sjis
-    str = "abc".encode('SJIS')
-    str
-  end
-
-  def test_ascii_str_enc_sjis_is_sjis_encoding
-    assert_equal(Encoding::SJIS, ascii_str_enc_sjis.encoding)
-  end
-
-  def non_ascii_str_enc_sjis
-    str = 'あいう'.encode('SJIS')
-    str
-  end
-
-  def test_non_ascii_str_enc_sjis
-    assert_equal(Encoding::SJIS, non_ascii_str_enc_sjis.encoding)
-  end
-
-  def ascii_str_enc_utf16le
-    str = NKF.nkf('-w16L0 -m0 -W', "abc")
-    str.force_encoding('UTF_16LE') if RUBY_VERSION < "1.9"
-    str
-  end
-
-  def test_ascii_str_enc_utf16le_is_utf16le_encoding
-    assert_equal(Encoding::UTF_16LE, ascii_str_enc_utf16le.encoding)
-  end
-
-  def non_ascii_str_enc_utf16le
-    str = NKF.nkf('-w16L0 -m0 -W', 'あいう')
-    str.force_encoding('UTF_16LE') if RUBY_VERSION < "1.9"
-    str
-  end
-
-  def test_non_ascii_str_enc_utf16le
-    assert_equal(Encoding::UTF_16LE, non_ascii_str_enc_utf16le.encoding)
-  end
-
-  def ascii_str_enc_utf16be
-    str = NKF.nkf('-w16B0 -m0 -W', "abc")
-    str.force_encoding('UTF_16BE') if RUBY_VERSION < "1.9"
-    str
-  end
-
-  def test_ascii_str_enc_utf16be_is_utf16be_encoding
-    assert_equal(Encoding::UTF_16BE, ascii_str_enc_utf16be.encoding)
-  end
-
-  def non_ascii_str_enc_utf16be
-    str = NKF.nkf('-w16B0 -m0 -W', 'あいう')
-    str.force_encoding('UTF_16BE') if RUBY_VERSION < "1.9"
-    str
-  end
-  
-end