sdl4r 0.9.9 → 0.9.11

data/Rakefile

@@ -5,6 +5,9 @@ require 'rake/gempackagetask'
 require 'rake/packagetask'
 require 'rubygems'
 
+lib_dir = File.expand_path('lib')
+test_dir = File.expand_path('test')
+
 # Use Hanna as the documentation template if installated,
 # otherwise generate with the default RDoc generator.
 if USING_HANNA = Gem.required_location("hanna", "hanna/rdoctask.rb")
@@ -17,7 +20,10 @@ spec = Gem::Specification.new do |s|
   s.platform = Gem::Platform::RUBY
   s.summary = "Simple Declarative Language for Ruby library"
   s.name = 'sdl4r'
-  s.version = '0.9.9'
+
+  require File.dirname(__FILE__) + "/lib/sdl4r/sdl4r_version.rb"
+  s.version = SDL4R::VERSION
+
   s.requirements << 'none'
   s.require_path = 'lib'
   s.authors = ['Philippe Vosges', 'Daniel Leuck']
@@ -26,13 +32,13 @@ spec = Gem::Specification.new do |s|
   s.homepage = 'http://sdl4r.rubyforge.org/'
   s.files = FileList['lib/sdl4r.rb', 'lib/sdl4r/**/*.rb', 'bin/*', '[A-Z]*', 'test/**/*', 'doc/**/*'].to_a
   s.test_files = FileList[ 'test/**/*test.rb' ].to_a
-  s.description = <<EOF
-  The Simple Declarative Language provides an easy way to describe lists, maps,
-  and trees of typed data in a compact, easy to read representation.
-  For property files, configuration files, logs, and simple serialization
-  requirements, SDL provides a compelling alternative to XML and Properties
-  files.
-EOF
+  s.description = <<-EOF
+    The Simple Declarative Language provides an easy way to describe lists, maps,
+    and trees of typed data in a compact, easy to read representation.
+    For property files, configuration files, logs, and simple serialization
+    requirements, SDL provides a compelling alternative to XML and Properties
+    files.
+  EOF
 end
 
 Rake::GemPackageTask.new(spec) do |pkg|
@@ -40,26 +46,8 @@ Rake::GemPackageTask.new(spec) do |pkg|
   pkg.need_tar = true
 end
 
-# FIXME The package task tries to package twice and it shouldn't:
-#   - once with the provided command (i.e. 7zip if zip is not available)
-#   - once with "zip" disregarding the configuration (that attempt fails if you do not have the
-#     "zip" command)
-#Rake::PackageTask.new(spec.name, spec.version) do |p|
-#  p.need_zip = true
-#  p.need_tar = false
-#  p.need_tar_gz = false
-#  p.need_tar_bz2 = false
-#
-#  # If "zip" is not available, we try 7-zip.
-#puts "========================================================"
-#  system("zip")
-#  p.zip_command = "7z a -tzip" if $?.exitstatus == 127
-#  system("tar")
-#  p.tar_command = "7z a -ttar" if $?.exitstatus == 127
-#end
-
 Rake::RDocTask.new do |rd|
-  files = ['README', 'LICENSE', 'CHANGELOG', 'lib/**/*.rb', 'doc/**/*.rdoc', 'test/**/*.rb']
+  files = ['README', 'LICENSE', 'CHANGELOG', 'lib/**/*.rb', 'doc/**/*.rdoc']
   rd.main = 'README'
   rd.rdoc_files.include(files)
   rd.rdoc_files.exclude("lib/scratchpad.rb")
@@ -70,9 +58,20 @@ Rake::RDocTask.new do |rd|
   rd.options << '--inline-source'
 end
 
+if Gem.required_location("yard", "yard.rb")
+  require 'yard'
+  YARD::Rake::YardocTask.new do |t|
+    files = FileList.new('README', 'LICENSE', 'CHANGELOG', 'lib/**/*.rb', 'doc/**/*.rdoc')
+    files.exclude("lib/scratchpad.rb")
+    t.files = files.to_ary
+  end
+end
+
 Rake::TestTask.new do |t|
   t.test_files = FileList['test/**/*test.rb']
   t.verbose = true
+  t.libs = [lib_dir, test_dir]
+  t.warning = true
 end
 
 # Generates the SDL4R site with Nanoc.
@@ -82,4 +81,15 @@ nanoc_compile = task :nanoc_compile do
     system("nanoc", "compile")
   }
 end
-nanoc_compile.comment = "Builds the site with Nanoc"
+nanoc_compile.comment = "Builds the site with Nanoc"
+
+if Gem.required_location("ruby-prof", "ruby-prof/task.rb")
+  require 'ruby-prof/task'
+
+  RubyProf::ProfileTask.new do |t|
+    t.test_files = FileList['test/**/*_prof.rb']
+    t.output_dir = "."
+    t.printer = :graph_html
+    t.min_percent = 1
+  end
+end

data/TODO

@@ -9,13 +9,10 @@
     [x] "null" value test
     [x] Comment tests
     [x] Bad syntax tests
-[ ] Test write (unit tests)
-    [x] Dates
-    [ ] Numbers
 [A] Use YARD in order to generate documentation ?
     ==> alternatively, I tried to generate some RDoc templates but none worked in Rake...
-[ ] BUG: the line number is too high by 1 (the column is correct).
-[/] Fix the differences between test_basic_types.sdl and what is generated from the parsed structure
+[x] BUG: the line number is too high by 1 (the column is correct).
+[x] Fix the differences between test_basic_types.sdl and what is generated from the parsed structure
     [x] chars
     [x] longs
     [x] doubles
@@ -26,30 +23,28 @@
     [x] times
         [x] negative times
     [x] datetimes
-        [/] zone codes
+        [x] zone codes
         ==> Time only works in UTC, which means that the original zone code is lost.
         ==> DateTime doesn't give the zone code but only the offset.
-        [ ] Use TzTime? Use a custom object that knows whether a time zone was specified?
+        [A] Use TzTime? Use a custom object that knows whether a time zone was specified?
             ==> http://tztime.rubyforge.org/
             ==> along with TzInfo: http://tzinfo.rubyforge.org/
-[ ] See how Ruby floats relate to Java floats and doubles.
-[ ] Add tests for the SDL class
-[ ] Allow unicode characters in identifiers.
-[ ] FUTURE: It might be useful to allow people to replace the standard types by their own. This
+            ==> We could provide a sdl4r/tztime.rb, which would change the behavior of SDL4R so that
+                it uses TzTimes and TzInfos.
+[x] Add tests for the SDL class
+[x] Allow unicode characters in identifiers.
+[x] FUTURE: It might be useful to allow people to replace the standard types by their own. This
     could be useful for dates or numbers, for instance.
-[ ] FUTURE: Consider being able to read text files that are not UTF-8(?)
-[ ] BUG: the report on the line no in errors is off by 1 (at least in some cases)
-[ ] Tag.hash: the implementation is not very efficient.
+    ==> possible for times, not for dates or numbers
+[A] FUTURE: Consider being able to read text files that are not UTF-8(?)
+    ==> The burden is on the IO object, the regexp take care of the rest (a priori).
+[x] BUG: the report on the line no in errors is off by 1 (at least in some cases)
+[A] Tag.hash: the implementation is not very efficient.
     ==> Difficult to make better and still simple
     ==> Maybe possible when it's frozen.
-[ ] FUTURE: xpath, ypath ==> sdlpath(?)
-[ ] FUTURE: evenemential parsing(?)
-[ ] FUTURE: add a way to insert a tag after or before another or at some index(?)
-[ ] FUTURE: allow some way of generating YAML(?)
-[ ] FUTURE: allow to turn a YAML structure into a SDL one(?)
-[ ] BUG: "rake package" tries to archive the contents twice: once with the command that I configure
-    in Rakefile, once with a zip command that can't work on my machine (zip is not installed). Why?
-    At least, the first archive is created and seems correct.
+[x] FUTURE: evenemential parsing(?)
+    ==> via the pull parser
+[x] FUTURE: pull parser(?)
 [A] FUTURE: Would we need a "write" method in SDL4R?
     ==> Na, there's already Tag.write(), I guess.
 [N] Never call a class "Test" => it can easily conflict with the "Test" module of Test::Unit and
@@ -63,28 +58,20 @@
     ==> Minor change: we return nil for the methods were nothing was really returned explicitely
         (for the time being).
 [x] If there is any success, maybe create/recreate the Rubyforge site for the support.
-[ ] Should we allow to create a Tag without a name (== "content") for anonymous Tags?
+[x] Should we allow to create a Tag without a name (== "content") for anonymous Tags?
+    ==> It seems natural.
 [x] Add latest doc access to RubyForge:
     ==> Rake task?
 
-[ ] ONWAIT: Implement the [] operator in order to access attributes:
-    ["attr"] <=> attribute("attr")
-    ["ns:attr"] <=> attribute("ns", "attr") (should we allow this?)
-    ["ns", "attr"] <=> attribute("ns", "attr")
-    Should we allow attribute("ns:attr")?
-    ==> Mmmm, but it could also mean "get child with that name". Let's wait.
 [x] IDEA: marshaller? easy object <=> SDL read/write?
     SEE SPECS @ Ikayzo: http://www.ikayzo.org/confluence/display/SDL/Draft+-+Serialization+with+SDL
-[ ] Check the coverage and make the tests better.
-    ==> Might be better to use some other tool than
-[ ] IDEA: add an option to the XML export allowing to write anonymous nodes as XML tag content?
-[ ] IDEA: add an option to the XML export allowing to export without formatting?
+[A] IDEA: add an option to the XML export allowing to write anonymous nodes as XML tag content?
+[A] IDEA: add an option to the XML export allowing to export without formatting?
+    ==> If you want to generate fancy XML, there are libraries to do it and it's not that difficult
+        from SDL.
 [x] BUG: line continuation is not handled properly (skipping chars etc).
-[ ] BUG: the rake task 'gen_rubyforge' doesn't work under 1.9 (only 1.8.7)
+[A] BUG: the rake task 'gen_rubyforge' doesn't work under 1.9 (only 1.8.7)
     ==> when Hanna is not installed the CHANGELOG HTML file must have a different name.
-[ ] Look into performances, compared to YAML or XML parsers
-[ ] Future: SDL + ERB to have dynamic config templates
-    see http://github.com/binarylogic/settingslogic
 [x] Future: object dump/load as YAML does
     SEE SPECS @ Ikayzo: http://www.ikayzo.org/confluence/display/SDL/Draft+-+Serialization+with+SDL
     - add to_sdl(4r) to Object
@@ -110,9 +97,8 @@
             }
         - use Class.allocate() to have a blank object on deserialization.
 
-[ ] Have to_string implement options
+[v] Have to_string implement options ==> builder
 [x] Put the docs online
-[ ] Document Rakefile and dependencies
 [x] BUG: in Ruby 1.9.2
 <internal:lib/rubygems/custom_require>:29:in `require': no such file to load -- test/sdl4r/../../lib
 /sdl4r/tag (LoadError)
@@ -133,17 +119,15 @@
     ==> We link to the RDoc for the time being.
 ====================================================================================================
 [x] Add a line about the support of of 1.9 in README (1.9.1 and 1.9.2)
-[ ] Get the version from some common (Rakefile?) place in Nanoc
-[ ] Add a modification date to site pages?
 [x] Clean up the Rakefile and see whether that Rubyforge upload task is necessary.
     ==> Easier to upload the site manually: I removed the code.
-[ ] Future (not necessarily for Ruby): SDL parser ==> SAX
-[ ] Optimization: cache strings in order not to duplicate them (especially tag names?)
+[A] Optimization: cache strings in order not to duplicate them (especially tag names?)
+    ==> can be done outside of SDL4R if necessary
 [x] Add a constant for "content".
     ==> ANONYMOUS_TAG_NAME
     ==> Also added ROOT_TAG_NAME
 [x] Fixed missing Parser.parse_error() error.
-[ ] BUG: this is parsed
+[x] BUG: this is parsed
         vegetable {
         }
     while this is not
@@ -151,9 +135,174 @@
 
     ==> It seems this is not supported by the Java parser. Is it invalid/valid syntax?
     ==> It will be in the next version of SDL.
+    ==> Supported by the latest pull parser in the Ruby version
 [x] BUG: '$' is a valid identifier character and it is not accepted.
 ====================================================================================================
 [x] Check that if you write 2 values, a date and a timespan, you get both normally when you load.
     ==> Considered as a bug in the language spec by Dan.
 [x] BUG: negative years seem not to be supported in dates (somehow mistaken for integers: -4712/01/01)
-[ ] Allow Symbols as attribute/child names
+[x] Allow Symbols as attribute/child names
+    [x] Tag#new
+    [x] Tag#new_child
+    [x] Tag#set_attribute
+    [x] Tests for Tag#<<
+[A] Allow
+        Tag.new('myTag') << { 'tool' => { 'name' => 'hammer', 'price' => 19.99 } }
+    in order to create hierarchies of Tags easily.
+    ==> It's cool but is it really useful?
+    ==> people could use deserialization to do the same
+[x] Warning: sdl4r/tag.rb:600: warning: shadowing outer local variable - namespace
+    ==> Verify fix
+[x] Warning: sdl4r/parser/tokenizer.rb:489: warning: character class has duplicated range: /[\w_$-\.]/
+    ==> Verify fix
+[x] BUG: Seems that the Java version doesn't support time zones stated as "+01:00" for instance. Only 3 letters codes?
+	==> Should be "-GMT+01:00"
+[x] BUG: timezones should support only:
+        1. -JST (a zone code alone)
+        2. -GMT+02:30 (custom zone offset based on GMT and not any other code - well, maybe UTC -)
+    ==> We also support -JST+00:30 because it is not so complicated.
+[N] NOTE: Date.Format.ZONES seems to be the richest reference of zones in the standard API
+[x] Deserialization: custom object class support
+[x] Deserialization: custom value types (not SDL)
+    ==> Could be done by redefining Serializer#set_serializable_property() for instance.
+    ==> will also be possible in #from_sdl(), I guess
+[x] Deserialization: idiom detection
+    ==> Vectors, matrices
+[x] Deserialization: anonymous tags
+[x] Serialization/Deserialization: attribute/instance variable access priority rules
+    ==> 1. property accessor if both accessors defined
+        2. direct variable access otherwise
+    [x] Test
+[x] Serialization: Hash rather than OpenStruct as default
+[x] Serialization: omit nil attributes option
+[x] Serialization/Deserialization: object references, object cycles
+[x] Spec and Impl of Serialization: handling of arrays, collections, etc
+    [x] Specification
+    [x] Serialization implementation
+    [x] Deserialization implementation
+    [x] Detect when there are several child tags with the same name and create corresponding array
+[x] Test deserialization of root tag as a Hash
+[x] Serialization & Deserialization of Hashes
+    [x] Serialization Implementation
+    [x] Deserialization Implementation
+[x] Deserialization: test values
+[x] Serializer: make a better idiom for new_collection_tag()
+    ==> Replace by get_collection_item_name() ?
+    ==> Fix the method signatures and visibilities
+[x] Deserialization: test object property priorities
+[x] Test that a lonely anonymous tag gives a simple value and not an array in the results
+[x] Test that we generate a child tag with values if property value is an array of SDL values
+[x] Implement from_sdl(), to_sdl()
+    ==> may need new accessors and better interface in Serializer
+    ==> to_sdl(serializer)
+[x] SDL4R dump()/load()
+[x] Serialization: test nil values for properties or inside arrays, matrices, etc
+[A] Memory optimization: use a map of the strings for SDL identifiers in Parser
+    ==> With the new Reader nothing prevents from implementing it outside of SDL4R.
+[A] Memory optimization: the profiling test under JRuby takes a LOT of memory
+    ==> It seems ok now.
+[x] Option for the namespace in the serialization.
+[A] Option to disable Unicode identifiers? ==> not so important
+[x] Use ruby-prof
+    ==> Lot of time spent in the reader
+    ==> Lot of time spent wherever there are lots of tests (IFs or CASEs)
+[x] Use jruby-prof
+    [x] Profile Ruby script (==> read_jprof.rb)
+[N] Test with JRuby in mode -Djruby.compat.version=RUBY1_9
+[N] Be clear about the difference between /.../ and /.../u
+    ==> /.../u regexps will refuse to work with not-UTF8 strings as far as I know.
+    ==> /.../ regexps might or might not be UTF8 compatible depending on the context (Ruby
+        implementation, global options, etc).
+[x] Do not generate the doc for the tests.
+[x] Consider using Yardoc (http://yardoc.org/) in order to generate the documentation.
+[x] BUG: Parser.get_time_zone_offset() should take the year and the month in order to calculate
+    the offset (when there is a zone code) because there can be saving day saving time depending on
+    the year.
+    ==> The code should be correct but I can't find a way to calculate the DST offset for a zone and
+        a date. Providing this date and zone to DateTime.strptime() doesn't work (the DST factor is
+        ignored). TO FIX LATER in Parser.get_time_zone_offset().
+[x] IDEA: pull parser
+    ==> Ruby 1.9: 19% faster
+    ==> JRuby (--1.8): 43% faster
+[x] BUG: SDL4R#format() seems to return a US-ASCII string for DateTimes (because of strftime()?)
+[x] Test SDL4R#format() with Time instances.
+[x] BUG: Under Ruby187, we have the following kind of warnings:
+        E:/dev/sdl/sdl4r/lib/sdl4r/serializer.rb:463: warning: instance variable @food not initialized
+    when calling instance_variable_get() on an object. The warning is completely unnecessary.
+    ==> We now check the variable exists beforehand with instance_variable_defined?()
+[x] Use TZInfo for timezones
+    [A] Wrap TimezonePeriod to avoid accessing unpublished elements of TZInfo.
+        ==> too much work + can be broken easily
+[x] Declare TZInfo in the dependencies of the gem
+[x] Test the TZINfo refactor under JRuby 1.8/1.9 and Ruby 1.9
+[x] BUG: Parser error when running tests under "JRuby --1.9"
+    ==> Look into it even if the support of 1.9 in JRuby is not complete
+    ==> JRuby --1.9 doesn't support encodings specifications right now
+[A] Use TZTime optionaly
+    [A] Use TZTime::LocalTime::Builder.get_time_zone() instead of the basic TZInfo::Timezone.get().
+    ==> Hmmm: it seems TZTime never passed v0.1.0, which doesn't work in 1.9.2.
+[x] A date should be created with seconds and milliseconds separate + the TZInfo
+    (and not the offset)
+[x] Add a method or an option to create Time instead of DateTime so that switching is easy
+    [x] 4 tests: DateTime, Time, DateTime + TZInfo, Time + TZInfo
+[x] BUG in Netbeans: the chosen Ruby runtime of the project doesn't determine what library files
+    are open on navigation (when you change the runtime from 1.8 to 1.9 for instance).
+    ==> Reported
+[x] TZAbbreviationDB doesn't work in 1.8.7 ==> CSV.open/CSV.foreach (not the same arguments in the
+    two versions).
+[x] Make all the test cases include SdlTestCase and put the Netbeans work-around there, uncommented.
+[x] Make tests with Nokogiri in order to understand the order of the events and the availability of
+    the info (e.g. attributes) on different points.
+    ==> It seems Nokogiri doesn't emit all the nodes for which there are constants:
+        TYPE_ELEMENT
+        TYPE_END_ELEMENT
+        TYPE_SIGNIFICANT_WHITESPACE
+        TYPE_TEXT
+        Therefore, no attributes, no document, no simple whitespace, etc. We can these are used
+        only internally.
+[x] Make Reader more like the one in Nokogiri (i.e. interface).
+[x] Fix parse error test for the pull parser
+[x] ditch the old parser.
+[x] Go deep in what forces me to have path algebra in require commands in source files.
+    ==> path start at the dirs of the load path: they are not relative to the current file.
+    ==> Fixed
+===================================================================== 26-dec-2010
+[ ] Use RVM (http://rvm.beginrescueend.com/) in order to handle tests in the different environments.
+    ==> Not unless I'm using Linux.
+[ ] Make a builder => extract features from Tag to a Builder. ?
+    In Nokogiri, a builder is a way to create a DOM structure, it seems.
+    ==> Might rather need an Emitter to convert to text.
+[ ] Get the version from some common (Rakefile?) place in Nanoc
+    ==> Version is now declared in sdl4r.sdl4r_version.
+[ ] Add a modification date to site pages?
+[ ] Base the deserializer on the Reader rather than the DOM structure.
+[ ] If the emitter allows it, base the serializer on it rather than on the DOM structure.
+[ ] Rakefile Tasks for profiling : --debug -I"E:/dev/sdl/sdl4r/lib" -I"E:/dev/sdl/sdl4r/test"
+[ ] Parser unit tests for numbers
+[ ] See how Ruby floats relate to Java floats and doubles.
+[ ] FUTURE: xpath, ypath ==> spath(?)
+[ ] FUTURE: add a way to insert a tag after or before another or at some index(?)
+[ ] FUTURE: allow some way of generating YAML(?)
+[ ] FUTURE: allow to turn a YAML structure into a SDL one(?)
+[ ] BUG: "rake package" tries to archive the contents twice: once with the command that I configure
+    in Rakefile, once with a zip command that can't work on my machine (zip is not installed). Why?
+    At least, the first archive is created and seems correct.
+[ ] ONWAIT: Implement the [] operator in order to access attributes:
+    ["attr"] <=> attribute("attr")
+    ["ns:attr"] <=> attribute("ns", "attr") (should we allow this?)
+    ["ns", "attr"] <=> attribute("ns", "attr")
+    Should we allow attribute("ns:attr")?
+    ==> Mmmm, but it could also mean "get child with that name". Let's wait.
+[ ] Check the coverage and make the tests better.
+[x] Look into performances, compared to YAML or XML parsers
+    ==> All efficient parsers in the Ruby world seem to be implemented in C.
+    ==> Compared to Nokogiri, it is nearly 20 times slower.
+[ ] Future: SDL + ERB to have dynamic config templates
+    see http://github.com/binarylogic/settingslogic
+[ ] Document Rakefile and dependencies
+[ ] Future (not necessarily for Ruby): SDL parser ==> SAX
+[ ] Serialization: option to choose between attribute or child tag generation for instance variables
+[x] reader_test: more tests of the interface
+[x] Move Reader/etc to directory sdl4r?
+[ ] Deliver v0.9.10 or v1.0
+[ ] Update the README to include the use of Reader, TZInfo and Time

data/doc/classes/SDL4R/AbbreviationTimezoneProxy.html

@@ -0,0 +1,151 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang='en'>
+  <head>
+    <title>: SDL4R::AbbreviationTimezoneProxy [RDoc: Simple Declarative Language for Ruby]</title>
+    <meta content='text/html; charset=utf-8' http-equiv='Content-Type'>
+    <link href='../../rdoc-style.css' media='screen' rel='stylesheet' type='text/css'>
+    <script type='text/javascript'>
+      //<![CDATA[
+        function popupCode(url) {
+          window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+        }
+        
+        function toggleCode(id) {
+          var code = document.getElementById(id)
+        
+          code.style.display = code.style.display != 'block' ? 'block' : 'none'
+          return true
+        }
+        
+        // Make codeblocks hidden by default
+        document.writeln('<' + 'style type="text/css">.method .source pre { display: none }<\/style>')
+      //]]>
+    </script>
+  </head>
+  <body class='page'>
+    <div class='class' id='wrapper'>
+      <div class='header'>
+        <h1 class='name'>
+          <span class='type'>Class</span>
+          SDL4R::AbbreviationTimezoneProxy
+        </h1>
+        <ol class='paths'>
+          <li>
+            <a href="../../files/lib/sdl4r/abbreviation_timezone_proxy_rb.html">lib/sdl4r/abbreviation_timezone_proxy.rb</a>
+          </li>
+        </ol>
+        <div class='parent'>
+          Parent:
+          <strong>TZInfo::Timezone</strong>
+        </div>
+      </div>
+      <div id='content'>
+        <div id='text'>
+          <div id='method-list'>
+            <h2>Methods</h2>
+            <h3>public class</h3>
+            <ol>
+              <li><a href="#M000001">new</a></li>
+            </ol>
+            <h3>public instance</h3>
+            <ol>
+              <li><a href="#M000002">_initialize</a></li>
+              <li><a href="#M000003">actual_timezone</a></li>
+              <li><a href="#M000004">identifier</a></li>
+              <li><a href="#M000005">period_for_utc</a></li>
+              <li><a href="#M000006">periods_for_local</a></li>
+            </ol>
+          </div>
+          <div id='section'>
+            <div id='methods'>
+              <h2>Public class methods</h2>
+              <div class='method public-class' id='method-M000001'>
+                <a name='M000001'></a>
+                <div class='synopsis'>
+                  <span class='name'>new</span>
+                  <span class='arguments'>(identifier, consider_modern_abbreviations)</span>
+                </div>
+                <div class='source'>
+                  <a class='source-toggle' href='#' onclick="toggleCode('M000001-source'); return false">
+                    [show source]
+                  </a>
+                  <pre id='M000001-source'>    <span class="ruby-comment cmt"># File lib/sdl4r/abbreviation_timezone_proxy.rb, line 7</span>&#x000A; 7:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">identifier</span>, <span class="ruby-identifier">consider_modern_abbreviations</span>)&#x000A; 8:       <span class="ruby-identifier">o</span> = <span class="ruby-keyword kw">super</span>()&#x000A; 9:       <span class="ruby-identifier">o</span>.<span class="ruby-identifier">_initialize</span>(<span class="ruby-identifier">identifier</span>, <span class="ruby-identifier">consider_modern_abbreviations</span>)&#x000A;10:       <span class="ruby-identifier">o</span>&#x000A;11:     <span class="ruby-keyword kw">end</span></pre>
+                </div>
+              </div>
+              <h2>Public instance methods</h2>
+              <div class='method public-instance' id='method-M000002'>
+                <a name='M000002'></a>
+                <div class='synopsis'>
+                  <span class='name'>_initialize</span>
+                  <span class='arguments'>(identifier, consider_modern_abbreviations)</span>
+                </div>
+                <div class='source'>
+                  <a class='source-toggle' href='#' onclick="toggleCode('M000002-source'); return false">
+                    [show source]
+                  </a>
+                  <pre id='M000002-source'>    <span class="ruby-comment cmt"># File lib/sdl4r/abbreviation_timezone_proxy.rb, line 13</span>&#x000A;13:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">_initialize</span>(<span class="ruby-identifier">identifier</span>, <span class="ruby-identifier">consider_modern_abbreviations</span>)&#x000A;14:       <span class="ruby-ivar">@identifier</span> = <span class="ruby-identifier">identifier</span>&#x000A;15:       <span class="ruby-ivar">@consider_modern_abbreviations</span> = <span class="ruby-identifier">consider_modern_abbreviations</span>&#x000A;16:       <span class="ruby-ivar">@actual_timezone</span> = <span class="ruby-keyword kw">nil</span>&#x000A;17:     <span class="ruby-keyword kw">end</span></pre>
+                </div>
+              </div>
+              <div class='method public-instance' id='method-M000003'>
+                <a name='M000003'></a>
+                <div class='synopsis'>
+                  <span class='name'>actual_timezone</span>
+                  <span class='arguments'>()</span>
+                </div>
+                <div class='source'>
+                  <a class='source-toggle' href='#' onclick="toggleCode('M000003-source'); return false">
+                    [show source]
+                  </a>
+                  <pre id='M000003-source'>    <span class="ruby-comment cmt"># File lib/sdl4r/abbreviation_timezone_proxy.rb, line 19</span>&#x000A;19:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">actual_timezone</span>&#x000A;20:       <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@actual_timezone</span>&#x000A;21:         <span class="ruby-ivar">@actual_timezone</span> = <span class="ruby-identifier">get_timezone</span>(<span class="ruby-identifier">identifier</span>, <span class="ruby-identifier">consider_modern_abbreviations</span>)&#x000A;22:       <span class="ruby-keyword kw">end</span>&#x000A;23:       <span class="ruby-ivar">@actual_timezone</span>&#x000A;24:     <span class="ruby-keyword kw">end</span></pre>
+                </div>
+              </div>
+              <div class='method public-instance' id='method-M000004'>
+                <a name='M000004'></a>
+                <div class='synopsis'>
+                  <span class='name'>identifier</span>
+                  <span class='arguments'>()</span>
+                </div>
+                <div class='source'>
+                  <a class='source-toggle' href='#' onclick="toggleCode('M000004-source'); return false">
+                    [show source]
+                  </a>
+                  <pre id='M000004-source'>    <span class="ruby-comment cmt"># File lib/sdl4r/abbreviation_timezone_proxy.rb, line 26</span>&#x000A;26:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">identifier</span>&#x000A;27:       <span class="ruby-ivar">@identifier</span>&#x000A;28:     <span class="ruby-keyword kw">end</span></pre>
+                </div>
+              </div>
+              <div class='method public-instance' id='method-M000005'>
+                <a name='M000005'></a>
+                <div class='synopsis'>
+                  <span class='name'>period_for_utc</span>
+                  <span class='arguments'>(utc)</span>
+                </div>
+                <div class='source'>
+                  <a class='source-toggle' href='#' onclick="toggleCode('M000005-source'); return false">
+                    [show source]
+                  </a>
+                  <pre id='M000005-source'>    <span class="ruby-comment cmt"># File lib/sdl4r/abbreviation_timezone_proxy.rb, line 30</span>&#x000A;30:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">period_for_utc</span>(<span class="ruby-identifier">utc</span>)&#x000A;31:       <span class="ruby-identifier">actual_timezone</span>.<span class="ruby-identifier">period_for_utc</span>(<span class="ruby-identifier">utc</span>)&#x000A;32:     <span class="ruby-keyword kw">end</span></pre>
+                </div>
+              </div>
+              <div class='method public-instance' id='method-M000006'>
+                <a name='M000006'></a>
+                <div class='synopsis'>
+                  <span class='name'>periods_for_local</span>
+                  <span class='arguments'>(local)</span>
+                </div>
+                <div class='source'>
+                  <a class='source-toggle' href='#' onclick="toggleCode('M000006-source'); return false">
+                    [show source]
+                  </a>
+                  <pre id='M000006-source'>    <span class="ruby-comment cmt"># File lib/sdl4r/abbreviation_timezone_proxy.rb, line 34</span>&#x000A;34:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">periods_for_local</span>(<span class="ruby-identifier">local</span>)&#x000A;35:       <span class="ruby-identifier">actual_timezone</span>.<span class="ruby-identifier">periods_for_local</span>(<span class="ruby-identifier">local</span>)&#x000A;36:     <span class="ruby-keyword kw">end</span></pre>
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+      <div id='footer-push'></div>
+    </div>
+    <div id='footer'>
+      <a href="http://github.com/mislav/hanna/tree/master"><strong>Hanna</strong> RDoc template</a>
+    </div>
+  </body>
+</html>