icu4r_19 1.0

metadata

@@ -0,0 +1,164 @@
+--- !ruby/object:Gem::Specification
+name: icu4r_19
+version: !ruby/object:Gem::Version
+  version: '1.0'
+  prerelease: 
+platform: ruby
+authors:
+- Nikolai Lugovoi
+- Perry Smith
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-10-16 00:00:00.000000000Z
+dependencies: []
+description: ! "== ICU4R - ICU Unicode bindings for Ruby\n\nICU4R is an attempt to
+  provide better Unicode support for Ruby,\nwhere it lacks for a long time.\n\nCurrent
+  code is mostly rewritten  string.c from Ruby 1.8.3.\n\nICU4R is Ruby C-extension
+  binding for ICU library[1] \nand provides following classes and functionality:\n\n*
+  UString:\n    - String-like class with internal UTF16 storage;\n    - UCA rules
+  for UString comparisons (<=>, casecmp);\n    - encoding(codepage) conversion;\n
+  \   - Unicode normalization;\n    - transliteration, also rule-based;\n\n    Bunch
+  of locale-sensitive functions:\n    - upcase/downcase;\n    - string collation;\n
+  \   - string search;\n    - iterators over text line/word/char/sentence breaks;\n
+  \   - message formatting (number/currency/string/time);\n    - date and number parsing.\n\n*
+  URegexp - unicode regular expressions.\n\n* UResourceBundle - access to resource
+  bundles, including ICU locale data.\n\n* UCalendar - date manipulation and timezone
+  info.\n\n* UConverter - codepage conversions API\n\n* UCollator - locale-sensitive
+  string comparison\n\n== Install and usage\n\n   > ruby extconf.rb\n   > make &&
+  make check\n   > make install\n\nNow, in your scripts just require 'icu4r'.\n\nTo
+  create RDoc, run \n   > sh tools/doc.sh\n\n== Requirements\n\nTo build and use ICU4R
+  you will need GCC and ICU v3.4 libraries[2].\n\n== Differences from Ruby String
+  and Regexp classes\n\n=== UString vs String\n\n1. UString substring/index  methods
+  use UTF16 codeunit indexes, not code points.\n\n2. UString supports most methods
+  from String class. Missing methods are:\n        capitalize, capitalize!, swapcase,
+  swapcase!\n        %, center, ljust, rjust\n        chomp, chomp!, chop, chop!\n
+  \       count, delete, delete!, squeeze, squeeze!, tr, tr!, tr_s, tr_s!\n        crypt,
+  intern, sum, unpack\n        dump, each_byte, each_line\n        hex, oct, to_i,
+  to_sym\n        reverse, reverse!\n        succ, succ!, next, next!, upto\n        \n3.
+  Instead of String#% method, UString#format is provided. See FORMATTING for short
+  reference.\n\n4. UStrings can be created via String.to_u(encoding='utf8') or global
+  u(str,[encoding='utf8'])\n   calls. Note that +encoding+ parameter must be value
+  of String class. \n\n5. There's difference between character grapheme, codepoint
+  and codeunit. See UNICODE reports for\n   gory details, but in short: locale dependent
+  notion of character can be presented using \n   more than one codepoint - base letter
+  and combining (accents) (also possible more than one!), and\n   each codepoint can
+  require more than one codeunit to store (for UTF8 codeunit size is 8bit, though\n
+  \  some codepoints require up to 4bytes). So, UString has normalization and locale
+  dependent break\n   iterators.\n\t\n6. Currently UString doesn't include Enumerable
+  module.\n\n7. UString index/[] methods which accept URegexp, throw exception if
+  Regexp passed.\n\n8. UString#<=>, UString#casecmp use UCA rules.\n\n=== URegexp\n\nUString
+  uses ICU regexp library. Pattern syntax is described in [./docs/UNICODE_REGEXPS]
+  and ICU docs.\n\nThere are some differences between processing in Ruby Regexp and
+  URegexp:\n\n1. When UString#sub, UString#gsub are called with block, special vars
+  ($~, $&, $1, ...) aren't\n   set, as their values are processed through deep ruby
+  core code. Instead, block receives UMatch object,\n   which is essentially immutable
+  array of matching groups:\n        \"test\".u.gsub(ure(\"(e)(.)\")) do |match| \n
+  \          puts match[0]  # => 'es' <--> $&\n           puts match[1]  # => 'e'
+  \ <--> $1\n           puts match[2]  # => 's'  <--> $2\n        end\n\n2. In URegexp
+  search pattern backreferences are in form \\n (\\1, \\2, ...), \n   in replacement
+  string - in form $1, $2, ...\n\n   NOTE: URegexp considers char to be a digit NOT
+  ONLY ASCII (0x0030-0x0039), but \n   any Unicode char, which has property Decimal
+  digit number (Nd), e.g.:\n        a = [?$, 0x1D7D9].pack(\"U*\").u * 2\n        puts
+  a.inspect_names\n        <U000024>DOLLAR SIGN\n        <U01D7D9>MATHEMATICAL DOUBLE-STRUCK
+  DIGIT ONE\n        <U000024>DOLLAR SIGN\n        <U01D7D9>MATHEMATICAL DOUBLE-STRUCK
+  DIGIT ONE\n        puts \"abracadabra\".u.gsub(/(b)/.U, a)\n        abbracadabbra\n
+  \   \n\n3. One can create URegexp using global Kernel#ure function, Regexp#U, Regexp#to_u,
+  or\n   from UString using URegexp.new, e.g:\n      /pattern/.U =~ \"string\".u\n\n4.
+  There are differences about Regexp and URegexp multiline matching options:\n      t
+  = \"text\\ntest\"\n      # ^,$ handling : URegexp multiline <-> Ruby default\n      t.u
+  =~ ure('^\\w+$', URegexp::MULTILINE)\n      => #<UMatch:0xf6f7de04 @ranges=[0..3],
+  @cg=[\\u0074\\u0065\\u0078\\u0074]>\n      t =~ /^\\w+$/\n      => 0\n      # .
+  matches \\n : URegexp DOTALL <-> /m\n      t.u =~ ure('.+test', URegexp::DOTALL)\n
+  \     => #<UMatch:0xf6fa4d88 ...\n      t.u =~ /.+test/m\n\n5. UMatch.range(idx)
+  returns range for capturing group idx. This range is in codeunits.\n\n=== References\n\n1.
+  ICU Official Homepage http://ibm.com/software/globalization/icu/ \n2. ICU downloads
+  \ http://ibm.com/software/globalization/icu/downloads.jsp\n3. ICU Home Page http://icu.sf.net
+  \n4. Unicode Home Page http://www.unicode.org\n\n==== BUGS, DOCS, TO DO\n\nThe code
+  is slow and inefficient yet, is still highly experimental, \nso can have many security
+  and memory leaks, bugs, inconsistent \ndocumentation, incomplete test suite. Use
+  it at your own risk.\n\nBug reports and feature requests are welcome :)\n\n===  Copying\n\nThis
+  extension module is copyrighted free software by Nikolai Lugovoi.\n\nYou can redistribute
+  it and/or modify it under the terms of MIT License.\n\nNikolai Lugovoi <meadow.nnick@gmail.com>\n\n"
+email: pedz@easesoftware.com
+executables: []
+extensions:
+- extconf.rb
+extra_rdoc_files:
+- README
+- docs/FORMATTING
+- docs/UNICODE_REGEXPS
+- MIT-LICENSE
+- calendar.c
+- collator.c
+- converter.c
+- icu4r.c
+- ubundle.c
+- ucore_ext.c
+- uregex.c
+- ustring.c
+files:
+- calendar.c
+- ChangeLog
+- collator.c
+- converter.c
+- docs/FORMATTING
+- docs/UNICODE_REGEXPS
+- extconf.rb
+- fmt.cpp
+- icu4r.c
+- icu_common.h
+- lib/dummy
+- MIT-LICENSE
+- Rakefile
+- README
+- samples/demo_each.rb
+- samples/demo_locales.rb
+- samples/demo_regexp.rb
+- samples/resbundle/appmsg/root.res
+- samples/resbundle/appmsg/ru.res
+- samples/resbundle/demo_bundle.rb
+- samples/resbundle/mkres.sh
+- samples/resbundle/root.txt
+- samples/resbundle/ru.txt
+- test/test_calendar.rb
+- test/test_collator.rb
+- test/test_converter.rb
+- test/test_ustring.rb
+- tools/doc.sh
+- tools/km.rb
+- ubundle.c
+- ucore_ext.c
+- uregex.c
+- uregex.h
+- ustring.c
+homepage: https://github.com/pedz/icu4r_19
+licenses: []
+post_install_message: 
+rdoc_options:
+- -c
+- utf-8
+- -x
+- dummy
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '1.9'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- ICU libraries v 4.6.1
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Ruby extension for Unicode support using ICU - 1.9.2 compatible
+test_files: []