webget_spreadsheet_import_export_helpers 1.0.3

data/lib/webget_spreadsheet_import_export_helpers/webget_spreadsheet_import_export_helpers.rb

@@ -0,0 +1,132 @@
+# = SpreadsheetImportExportHelpers
+#
+# Author:: Joel Parker Henderson, joelparkerhenderson@gmail.com
+# Copyright:: Copyright (c) 2006-2009 Joel Parker Henderson
+# License:: CreativeCommons License, Non-commercial Share Alike
+# License:: LGPL, GNU Lesser General Public License
+#
+#
+##
+
+module SpreadsheetImportExportHelpers
+
+ # Parse a string to a date, with some cleanup
+ def import_date(s)
+  return nil if s==nil or s.strip==''
+  return Date.parse(s)
+ end
+
+
+ # There's a typical import use case where a column is
+ # a boolean, in a variety of formats like "X" for on,
+ # "Y" for yes, "T" for true, etc.
+ #
+ # @return a boolean
+ #
+ # We use these rules:
+ # - x y yes t true on +  => true
+ # - blank n no f false off -  => false
+ # - anything else => nil
+ #
+ # ==Examples
+ #   import_flag('Yes') => true
+ #   import_flag('No') => false
+ #   import_flag('X') => true
+ #   import_flag('') => false
+ #   import_flag('Hello') => nil
+
+ def import_flag(s)
+  case s.strip.downcase
+  when 'x','y','yes','t','true','on','+'
+   return true,''
+  when '','n','no','f','false','off','-'
+   return false
+  else 
+   return nil
+  end
+ end
+
+
+ # There's a typical import use case where a column
+ # can contain two different data types:
+ # - a boolean, in a variety of formats (see _import_flag_)
+ # - a note, in plain text
+ #
+ # We need to separate these two.
+ #
+ # This method returns two items: a boolean and a note.
+ #
+ # We use these rules:
+ # - x y yes t true on +  => [true, '']
+ # - blank n no f false off -  => [false, '']
+ # - anything else => nil, note
+ #
+ # ==Example
+ #   import_flag_or_note('Yes') => [true,'']
+ #   import_flag_or_note('No') => [false,'']
+ #   import_flag_or_note('X') => [true,'']
+ #   import_flag_or_note('') => [false,'']
+ #   import_flag_or_note('Hello') => [nil,'Hello']
+
+ def import_flag_or_note(s)
+  flag = import_flag(s)
+  return flag ? [flag, ''] : [nil, s]
+ end
+
+
+ # There's a common import use case where a column can be of two types:
+ # - a date, in a variety of format like "Jan 1, 2008", "1/1/2008", etc.
+ # - a note, in plain text
+ #
+ # This method returns two items: a date (Date class) and a note (String class).
+ #
+ # ==Example
+ #   import_date_or_note('1/1/2007') => [Date(2007,01,01),'']
+ #   import_date_or_note('hello') => [nil,'hello']
+ 
+ def import_date_or_note(s)
+  begin
+   d=import_date(s)
+  rescue
+   d=nil
+  end
+  return d ? [d,''] : [nil,s]
+ end
+
+
+ # Corresponds to import_flag_or_note
+ #
+ # ==Return
+ # - flag==true => 'X'
+ # - flag==false => ''
+ # - otherwise return note
+ #
+ # ==Example
+ #   t=true
+ #   f=false
+ #   export_flag_or_note(t,'hello') => 'X'
+ #   export_flag_or_note(f,'hello') => ''
+ #   export_flag_or_note(nil,'hello') => 'hello'
+
+ def export_flag_or_note(flag,note=nil)
+  return flag==true ? 'X' : flag==false ? '' : note
+ end
+
+
+ # Corresponds to import_date_or_note
+ #
+ # ==Return
+ # - date exists => date to yyyy-mm-dd format
+ # - otherwise return note
+ #
+ # ==Example
+ #   d=Date.parse('1/1/2007')
+ #   export_date_or_note(d,'hello') => '2007-01-01'
+ #   export_date_or_note(nil,'hello') => 'hello'
+
+ def export_date_or_note(date,note=nil)
+  return date ?  date.strftime("%Y-%m-%d") : note
+ end
+
+
+end

data/test/webget_spreadsheet_import_export_helpers/unit/webget_spreadsheet_import_export_helpers_test.rb

@@ -0,0 +1,47 @@
+require 'test/unit'
+require 'date'
+require 'webget_spreadsheet_import_export_helpers'
+
+class SpreadsheetImportExportHelpersTest < Test::Unit::TestCase
+
+ include SpreadsheetImportExportHelpers
+
+ def test_import_flag
+  assert_equal(true,    import_flag('X'))
+  assert_equal(false,   import_flag(''))
+  assert_equal(true,    import_flag('yes'))
+  assert_equal(false,   import_flag('no'))
+  assert_equal(true,    import_flag('+'))
+  assert_equal(false,   import_flag('-'))
+  assert_equal(nil,     import_flag('hello'))
+ end
+
+ def test_import_flag_or_note
+  assert_equal([true,''],    import_flag_or_note('X'))
+  assert_equal([false,''],   import_flag_or_note(''))
+  assert_equal([true,''],    import_flag_or_note('yes'))
+  assert_equal([false,''],   import_flag_or_note('no'))
+  assert_equal([true,''],    import_flag_or_note('+'))
+  assert_equal([false,''],   import_flag_or_note('-'))
+  assert_equal([nil,'hello'], import_flag_or_note('hello'))
+ end
+
+ def test_import_date_or_note
+  d=Date.parse('2007/12/31')
+  assert_equal([d,''],        import_date_or_note('2007/12/31'))
+  assert_equal([nil,'hello'], import_date_or_note('hello'))
+ end
+
+ def test_export_flag_or_note
+  assert_equal('X',     export_flag_or_note(true,'hello'))
+  assert_equal('',      export_flag_or_note(false,'hello'))
+  assert_equal('hello', export_flag_or_note(nil,'hello'))
+ end
+
+ def test_export_date_or_note
+  d=Date.parse('2007/12/31')
+  assert_equal('2007-12-31', export_date_or_note(d,'hello'))
+  assert_equal('hello',      export_date_or_note(nil,'hello'))
+ end
+
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: webget_spreadsheet_import_export_helpers
+version: !ruby/object:Gem::Version 
+  version: 1.0.3
+platform: ruby
+authors: 
+- WebGet
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDvDCCAyWgAwIBAgIJAIlSqEkDQaZIMA0GCSqGSIb3DQEBBQUAMIGbMQswCQYD
+  VQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNU2FuIEZyYW5j
+  aXNjbzETMBEGA1UEChMKV2ViR2V0LmNvbTETMBEGA1UECxMKV2ViR2V0LmNvbTET
+  MBEGA1UEAxMKV2ViR2V0LmNvbTEgMB4GCSqGSIb3DQEJARYRd2ViZ2V0QHdlYmdl
+  dC5jb20wHhcNMDkwMjI2MTk0NDU4WhcNMTExMTIzMTk0NDU4WjCBmzELMAkGA1UE
+  BhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFjAUBgNVBAcTDVNhbiBGcmFuY2lz
+  Y28xEzARBgNVBAoTCldlYkdldC5jb20xEzARBgNVBAsTCldlYkdldC5jb20xEzAR
+  BgNVBAMTCldlYkdldC5jb20xIDAeBgkqhkiG9w0BCQEWEXdlYmdldEB3ZWJnZXQu
+  Y29tMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDXCFYfW6hCQl0ToNjaMIXG
+  ZfPF6OoR20BO/Tg6V37qPi7gDSZ6vIC6Mxcs8LtEcju85cD9lnKKl/lo4S5/w9Ha
+  hGD2ZFFfbF8420X5Za5G2KuriS3GzRz7F5dKCTjb1NH9TPlgOc71bcrDmCwwtFJl
+  T+tdfBju0YxLSBiMXf4y5QIDAQABo4IBBDCCAQAwHQYDVR0OBBYEFHB1kXO/Xd4g
+  G+AJ2/wwh6JOWXzNMIHQBgNVHSMEgcgwgcWAFHB1kXO/Xd4gG+AJ2/wwh6JOWXzN
+  oYGhpIGeMIGbMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQG
+  A1UEBxMNU2FuIEZyYW5jaXNjbzETMBEGA1UEChMKV2ViR2V0LmNvbTETMBEGA1UE
+  CxMKV2ViR2V0LmNvbTETMBEGA1UEAxMKV2ViR2V0LmNvbTEgMB4GCSqGSIb3DQEJ
+  ARYRd2ViZ2V0QHdlYmdldC5jb22CCQCJUqhJA0GmSDAMBgNVHRMEBTADAQH/MA0G
+  CSqGSIb3DQEBBQUAA4GBADzVXlwuff0/w3yK4LflGKKhtC3oChIrwmSyP6tk628N
+  BHokpc4Kz63xSXqzYTnBS7rFBwlYThtNalQeWmoUjGh3Z0ZR0JlhU0ln8899LuJ3
+  DXnLFY0cVuBnNDMOOFl8vk1qIcZjcTovhzgcixpG6Uk5qmUsKHRLQf4oQJx7TfLK
+  -----END CERTIFICATE-----
+
+date: 2010-01-28 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: 
+email: webget@webget.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/webget_spreadsheet_import_export_helpers/webget_spreadsheet_import_export_helpers.rb
+has_rdoc: true
+homepage: http://webget.com/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: "WebGet spreadsheet_import_export_helpers gem: parsers and prettifiers for spreadsheets"
+test_files: 
+- test/webget_spreadsheet_import_export_helpers/unit/webget_spreadsheet_import_export_helpers_test.rb

metadata.gz.sig

@@ -0,0 +1,2 @@
+N�d�F�²sq����Kk�^D禜
+-�h{�`OEL�-��