rubyredrick-ri_cal 0.0.2

data/tasks/ri_cal.rake

@@ -0,0 +1,403 @@
+#require 'active_support'
+require 'yaml'
+#- ©2009 Rick DeNatale
+#- All rights reserved. Refer to the file README.txt for the license
+#
+# code stolen from ActiveSupport Gem
+unless  String.instance_methods.include?("camelize")
+    def camelize
+      self.gsub(/\/(.?)/) { "::#{$1.upcase}" }.gsub(/(?:^|_)(.)/) { $1.upcase }
+    end
+end
+
+class VEntityUpdater
+  Pluralization = {
+    "attach" => "attachments",
+    "categories" => "multiple_categories",
+    "free_busy" => "free_busies",
+    "security_class" => "security_classes",
+    "request_status" => "request_statuses",
+    "related_to" => "multiple_related_to",
+    "resources"  => "multiple_resources"
+  }
+  def initialize(target, defs_file)
+    @target = target
+    @name=File.basename(target).sub(".rb","")
+    @indent = ""
+    @property_map = {}
+    @property_defs = YAML.load_file(defs_file)
+    @all_props = {}
+    @date_time_props = []
+  end
+
+  def property(prop_name_or_hash)
+    if Hash === prop_name_or_hash
+      name = prop_name_or_hash.keys[0]
+      override_options = prop_name_or_hash[name] || {}
+    else
+      name = prop_name_or_hash
+      override_options = {}
+    end
+    standard_options = @property_defs[name]
+    unless standard_options
+      puts "**** WARNING, no definition found for property #{name}"
+      standard_options = {}
+    end
+    options = {'type' => 'Text', 'ruby_name' => name}.merge(standard_options).merge(override_options)
+    named_property(name, options)
+  end
+
+  def indent(string)
+    @outfile.puts("#{@indent}#{string}")
+  end
+
+  def comment(*strings)
+    strings.each do |string|
+      indent("\# #{string}")
+    end
+  end
+
+  def no_doc(string)
+    indent("#{string} \# :nodoc:")
+  end
+
+  def blank_line
+    @outfile.puts
+  end
+
+  def describe_type(type)
+    case type
+    when 'date_time_or_date'
+      "either DateTime or Date"
+    when 'Text'
+      'String'
+    else
+      type
+    end
+  end
+
+  def describe_property(type)
+    case type
+    when 'date_time_or_date'
+      "either RiCal::PropertyValue::DateTime or RiCal::PropertyValue::Date"
+    else
+      "RiCal::PropertyValue#{type}"
+    end
+  end
+
+  def type_class(type)
+    if type == 'date_time_or_date'
+       "RiCal::PropertyValue::DateTime"
+     else
+       "RiCal::PropertyValue::#{type}"
+     end
+   end
+
+  def cast_value(ruby_val, type)
+    "#{type_class(type)}.convert(self, #{ruby_val.inspect})"
+  end
+
+  def lazy_init_var(var, options)
+    const_val = options["constant_value"]
+    default_val = options["default_value"]
+    if options["multi"]
+      puts("*** Warning default_value of #{default_val} for multi-value property #{name} ignored") if default_val
+      puts("*** Warning const_value of #{const_val} for multi-value property #{name} ignored") if const_val
+      if var
+        "@#{var} ||= []"
+      else
+        "[]"
+      end
+    else
+      puts("*** Warning default_value of #{default_val} for property #{name} with constant_value of #{const_val}") if const_val && default_val
+      init_val =  const_val || default_val
+      if init_val
+        if var
+          "@#{var} ||= #{cast_value(init_val, options["type"])}"
+        else
+          init_val.inspect
+        end
+      else
+        "@#{var}"
+      end
+    end
+  end
+
+  def pluralize(name)
+    Pluralization[name] || "#{name}s"
+  end
+
+  def named_property(name, options)
+    ruby_name = options['ruby_name']
+    multi = options['multi']
+    type = options['type']
+    rfc_ref = options['rfc_ref']
+    conflicts = options['conflicts_with']
+    type_constraint = options['type_constraint']
+    options.keys.each do |opt_key|
+      unless %w{
+        ruby_name
+        type
+        multi
+        rfc_ref
+        conflicts_with
+        purpose
+        constant_value
+        default_value
+        }.include?(opt_key)
+        puts "**** WARNING: unprocessed option key #{opt_key} for property #{name}"
+      end
+    end
+    if conflicts
+      mutually_exclusive(name, *conflicts)
+    end
+    needs_tz_access =  %w{OccurrenceList date_time_or_date DateTime Date}.include?(type)
+    ruby_name = ruby_name.tr("-", "_")
+    ruby_method = ruby_name.downcase
+    property = "#{name.tr("-", "_").downcase}_property"
+    if type_constraint != 'must_be_utc' && %w[date_time_or_date DateTime Period OccurrenceList].include?(type)
+      @date_time_props << property
+    end
+    @all_props[property] = name.upcase
+    @property_map[name.upcase] = :"#{property}_from_string"
+    parent_set = needs_tz_access ? ".for_parent(self)" : ""
+    if type == 'date_time_or_date'
+      line_evaluator = "RiCal::PropertyValue::DateTime.or_date(self, line)"
+    else
+      line_evaluator = "#{type_class(type)}.new(self, line)"
+    end
+    blank_line
+    if multi
+      comment(
+        "return the the #{name.upcase} property",
+        "which will be an array of instances of #{describe_property(type)}"
+      )
+      comment("", "[purpose (from RFC 2445)]", options["purpose"]) if options["purpose"]
+      comment("", "see RFC 2445 #{rfc_ref}") if rfc_ref
+      indent("def #{property}")
+      indent("  #{lazy_init_var(property,options)}")
+      indent("end")
+      unless (options["constant_value"])
+        plural_ruby_method = pluralize(ruby_method)
+        blank_line
+        comment("set the the #{name.upcase} property")
+        comment("one or more instances of #{describe_property(type)} may be passed to this method")
+        indent("def #{property}=(*property_values)")
+        if needs_tz_access
+          indent("  @#{property}= property_values.map{|prop| prop.for_parent(self)}")
+        else
+          indent("  @#{property}= property_values")
+        end
+        indent("end")
+        blank_line
+        comment("set the value of the #{name.upcase} property to multiple values")
+        comment("one or more instances of #{describe_type(type)} may be passed to this method")
+        indent("def #{plural_ruby_method}=(*ruby_values)")
+        indent("  @#{property} = ruby_values.map {|val| #{type_class(type)}.convert(self, val)}")
+        indent("end")
+        blank_line
+        comment("set the value of the #{name.upcase} property to a single value")
+        comment("one instance of #{describe_type(type)} may be passed to this method")
+        indent("def #{ruby_method}=(ruby_value)")
+        indent("  @#{property} = [#{type_class(type)}.convert(self, ruby_value)]")
+        indent("end")
+        blank_line
+        comment("add one or more values to the #{name.upcase} property")
+        comment("one or more instances of #{describe_type(type)} may be passed to this method")
+        indent("def  add_#{plural_ruby_method}(*ruby_values)")
+        indent(" ruby_values.do {|val|  self.#{property} << #{type_class(type)}.convert(self, val)}")
+        indent("end")
+        blank_line
+        comment("add one value to the #{name.upcase} property")
+        comment("one instances of #{describe_type(type)} may be passed to this method")
+        indent("def  add_#{ruby_method}(ruby_value)")
+        indent(" self.#{property} << #{type_class(type)}.convert(self, ruby_value)")
+        indent("end")
+        blank_line
+        comment("remove one or more values from the #{name.upcase} property")
+        comment("one or more instances of #{describe_type(type)} may be passed to this method")
+        indent("def  remove_#{plural_ruby_method}(*ruby_values)")
+        indent(" ruby_values.do {|val|  self.#{property}.delete(#{type_class(type)}.convert(self, val))}")
+        indent("end")
+        blank_line
+        comment("remove one value from the #{name.upcase} property")
+        comment("one instances of #{describe_type(type)} may be passed to this method")
+        indent("def  remove_#{ruby_method}(ruby_value)")
+        indent(" self.#{property}.delete(#{type_class(type)}.convert(self, ruby_value))")
+        indent("end")
+      end
+      blank_line
+      comment("return the value of the #{name.upcase} property")
+      comment("which will be an array of instances of #{describe_type(type)}")
+      indent("def #{ruby_method}")
+      indent("  #{property}.map {|prop| prop ? prop.value : prop}")
+      indent("end")
+      blank_line
+    no_doc("def #{property}_from_string(line)")
+      indent("  #{property} << #{line_evaluator}")
+      indent("end")
+    else
+      comment(
+        "return the the #{name.upcase} property",
+        "which will be an instances of #{describe_property(type)}"
+      )
+      comment("", "[purpose (from RFC 2445)]", options["purpose"]) if options["purpose"]
+      comment("", "see RFC 2445 #{rfc_ref}") if rfc_ref
+      indent("def #{property}")
+      indent("  #{lazy_init_var(property,options)}")
+      indent("end")
+      unless (options["constant_value"])
+        blank_line
+        comment("set the #{name.upcase} property")
+        comment("property value should be an instance of #{describe_property(type)}")
+        indent("def #{property}=(property_value)")
+        indent("  @#{property} = property_value#{parent_set}")
+        if conflicts
+          conflicts.each do |conflict|
+            indent("  @#{conflict}_property = nil")
+          end
+        end
+        indent("end")
+        blank_line
+        comment("set the value of the #{name.upcase} property")
+        indent("def #{ruby_method}=(ruby_value)")
+        indent("  self.#{property}= #{type_class(type)}.convert(self, ruby_value)")
+        indent("end")
+      end
+      blank_line
+      comment("return the value of the #{name.upcase} property")
+      comment("which will be an instance of #{describe_type(type)}")
+      indent("def #{ruby_method}")
+      indent("  #{property} ? #{property}.ruby_value : nil")
+      indent("end")
+      blank_line
+      no_doc("def #{property}_from_string(line)")
+      indent("  @#{property} = #{line_evaluator}")
+      indent("end")
+      @outfile.puts
+    end
+  end
+
+  def mutually_exclusive *prop_names
+    exclusives = prop_names.map {|str| :"#{str}_property"}.sort {|a, b| a.to_s <=> b.to_s}
+    unless mutually_exclusive_properties.include?(exclusives)
+      mutually_exclusive_properties << prop_names.map {|str| :"#{str}_property"}
+    end
+  end
+
+  def mutually_exclusive_properties
+    @mutually_exclusive_properties ||= []
+  end
+
+  def generate_support_methods
+    blank_line
+    indent("def export_properties_to(export_stream) #:nodoc:")
+    @all_props.each do |prop_attr, prop_name|
+      indent("  export_prop_to(export_stream, #{prop_name.inspect}, @#{prop_attr})")
+    end
+    indent("end")
+    blank_line
+    indent("def ==(o) #:nodoc:")
+    indent("  if o.class == self.class")
+    @all_props.keys.each_with_index do |prop_name, i|
+      and_str = i < @all_props.length - 1 ? " &&" : ""
+      indent("  (#{prop_name} == o.#{prop_name})#{and_str}")
+    end
+    indent("  else")
+    indent("     super")
+    indent("  end")
+    indent("end")
+    blank_line
+    indent("def initialize_copy(o) #:nodoc:")
+    indent("  super")
+    @all_props.each_key do |prop_name|
+      indent("  #{prop_name} = #{prop_name} && #{prop_name}.dup")
+    end
+    indent("end")
+    blank_line
+    indent("def add_date_times_to(required_timezones) #:nodoc:")
+    @date_time_props.each do | prop_name|
+      indent("  add_property_date_times_to(required_timezones, #{prop_name})")
+    end
+    indent("end")
+    blank_line
+    indent("module ClassMethods #:nodoc:")
+    indent("  def property_parser #:nodoc:")
+    indent("    #{@property_map.inspect}")
+    indent("  end")
+    indent("end")
+    blank_line
+    indent("def self.included(mod) #:nodoc:")
+    indent("  mod.extend ClassMethods")
+    indent("end")
+    blank_line
+    indent("def mutual_exclusion_violation #:nodoc:")
+    if mutually_exclusive_properties.empty?
+      indent("  false")
+    else
+      mutually_exclusive_properties.each do |mutex_set|
+        indent("  return true if #{mutex_set.inspect}.inject(0) {|sum, prop| send(prop) ? sum + 1 : sum} > 1")
+      end
+      indent("  false")
+    end
+    indent "end"
+  end
+
+  def update
+    File.open(File.join(File.dirname(__FILE__), '..', 'lib', 'ri_cal',  'properties' , "#{@name}.rb"), 'w') do |ruby_out_file|
+      @outfile = ruby_out_file
+      module_name = @name.camelize
+      class_name = module_name.sub(/Properties$/, "")
+      ruby_out_file.puts("module RiCal")
+      ruby_out_file.puts("  module Properties #:nodoc:")
+      @indent = "    "
+      ruby_out_file.puts("    #- ©2009 Rick DeNatale")
+      ruby_out_file.puts("    #- All rights reserved. Refer to the file README.txt for the license")
+      ruby_out_file.puts("    #")
+      ruby_out_file.puts("    # Properties::#{module_name} provides property accessing methods for the #{class_name} class")
+      ruby_out_file.puts("    # This source file is generated by the  rical:gen_propmodules rake tasks, DO NOT EDIT")
+      ruby_out_file.puts("    module #{module_name}")
+      @indent = "      "
+      YAML.load_file(File.join(File.dirname(__FILE__), '..', 'component_attributes', "#{@name}.yml")).each do |att_def|
+        property(att_def)
+      end
+      generate_support_methods
+      ruby_out_file.puts("    end")
+      ruby_out_file.puts("  end")
+      ruby_out_file.puts("end")
+    end
+    @outfile = nil
+  end
+end
+
+def updateTask srcGlob, taskSymbol
+  targetDir = File.join(File.dirname(__FILE__), '..', 'lib', 'ri_cal', 'properties')
+  defsFile = File.join(File.dirname(__FILE__), '..', 'component_attributes', 'component_property_defs.yml')
+  FileList[srcGlob].each do |f|
+    unless f == defsFile
+      target = File.join targetDir, File.basename(f).gsub(".yml", ".rb")
+      file target => [f, defsFile, __FILE__] do |t|
+        VEntityUpdater.new(target, defsFile).update
+      end
+      task taskSymbol => target
+    end
+  end
+end
+
+
+namespace :rical do
+
+  desc '(RE)Generate VEntity attributes'
+  task :gen_propmodules do |t|
+  end
+
+  updateTask File.join(File.dirname(__FILE__), '..', '/component_attributes', '*.yml'), :gen_propmodules
+
+end  # namespace :rical
+
+desc 'add or update copyright in code and specs'
+task :copyrights do
+    require 'mmcopyrights'
+    MM::Copyrights.process('lib', "rb", "#-", IO.read('copyrights.txt'))
+    MM::Copyrights.process('spec', "rb", "#-", IO.read('copyrights.txt'))
+end

data/tasks/spec.rake

@@ -0,0 +1,35 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  require 'spec'
+end
+begin
+  require 'spec/rake/spectask'
+rescue LoadError
+  puts <<-EOS
+To use rspec for testing you must install rspec gem:
+    gem install rspec
+EOS
+  exit(0)
+end
+
+desc "Run the specs under spec/models"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ['--options', "spec/spec.opts"]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+
+
+if RUBY_VERSION.match(/^1\.8\./)
+  desc 'Run all specs with RCov'
+  Spec::Rake::SpecTask.new(:rcov) do |t|
+    t.spec_opts = ['--options', "spec/spec.opts"]
+    t.spec_files = FileList['spec/**/*_spec.rb']
+    t.rcov = true
+    t.rcov_dir = "coverage"
+    t.rcov_opts = ['--exclude', 'spec']
+  end
+end
+  

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification 
+name: rubyredrick-ri_cal
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- author=Rick DeNatale
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-06 00:00:00 -07:00
+default_executable: ri_cal
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: newgem
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.3.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.0
+    version: 
+description: This is an UNOFFICIAL version.  The public official version will be released on RubyForge.  Github will be used for interim versions.  USE THIS VERSION AT YOUR OWN RISK.  A new Ruby implementation of RFC2445 iCalendar.  The existing Ruby iCalendar libraries (e.g. icalendar, vpim) provide for parsing and generating icalendar files, but do not support important things like enumerating occurrences of repeating events.  This is a clean-slate implementation of RFC2445.
+email: 
+- rick.denatale@gmail.com
+executables: 
+- ri_cal
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- copyrights.txt
+- docs/draft-ietf-calsify-2446bis-08.txt
+- docs/draft-ietf-calsify-rfc2445bis-09.txt
+- docs/incrementers.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- bin/ri_cal
+- component_attributes/alarm.yml
+- component_attributes/calendar.yml
+- component_attributes/component_property_defs.yml
+- component_attributes/event.yml
+- component_attributes/freebusy.yml
+- component_attributes/journal.yml
+- component_attributes/timezone.yml
+- component_attributes/timezone_period.yml
+- component_attributes/todo.yml
+- copyrights.txt
+- docs/draft-ietf-calsify-2446bis-08.txt
+- docs/draft-ietf-calsify-rfc2445bis-09.txt
+- docs/incrementers.txt
+- docs/rfc2445.pdf
+- lib/ri_cal.rb
+- lib/ri_cal/component.rb
+- lib/ri_cal/component/alarm.rb
+- lib/ri_cal/component/calendar.rb
+- lib/ri_cal/component/event.rb
+- lib/ri_cal/component/freebusy.rb
+- lib/ri_cal/component/journal.rb
+- lib/ri_cal/component/t_z_info_timezone.rb
+- lib/ri_cal/component/timezone.rb
+- lib/ri_cal/component/timezone/daylight_period.rb
+- lib/ri_cal/component/timezone/standard_period.rb
+- lib/ri_cal/component/timezone/timezone_period.rb
+- lib/ri_cal/component/todo.rb
+- lib/ri_cal/core_extensions.rb
+- lib/ri_cal/core_extensions/array.rb
+- lib/ri_cal/core_extensions/array/conversions.rb
+- lib/ri_cal/core_extensions/date.rb
+- lib/ri_cal/core_extensions/date/conversions.rb
+- lib/ri_cal/core_extensions/date_time.rb
+- lib/ri_cal/core_extensions/date_time/conversions.rb
+- lib/ri_cal/core_extensions/object.rb
+- lib/ri_cal/core_extensions/object/conversions.rb
+- lib/ri_cal/core_extensions/string.rb
+- lib/ri_cal/core_extensions/string/conversions.rb
+- lib/ri_cal/core_extensions/time.rb
+- lib/ri_cal/core_extensions/time/calculations.rb
+- lib/ri_cal/core_extensions/time/conversions.rb
+- lib/ri_cal/core_extensions/time/week_day_predicates.rb
+- lib/ri_cal/invalid_timezone_identifer.rb
+- lib/ri_cal/occurrence_enumerator.rb
+- lib/ri_cal/parser.rb
+- lib/ri_cal/properties/alarm.rb
+- lib/ri_cal/properties/calendar.rb
+- lib/ri_cal/properties/event.rb
+- lib/ri_cal/properties/freebusy.rb
+- lib/ri_cal/properties/journal.rb
+- lib/ri_cal/properties/timezone.rb
+- lib/ri_cal/properties/timezone_period.rb
+- lib/ri_cal/properties/todo.rb
+- lib/ri_cal/property_value.rb
+- lib/ri_cal/property_value/array.rb
+- lib/ri_cal/property_value/cal_address.rb
+- lib/ri_cal/property_value/date.rb
+- lib/ri_cal/property_value/date_time.rb
+- lib/ri_cal/property_value/date_time/additive_methods.rb
+- lib/ri_cal/property_value/date_time/time_machine.rb
+- lib/ri_cal/property_value/date_time/timezone_support.rb
+- lib/ri_cal/property_value/duration.rb
+- lib/ri_cal/property_value/geo.rb
+- lib/ri_cal/property_value/integer.rb
+- lib/ri_cal/property_value/occurrence_list.rb
+- lib/ri_cal/property_value/period.rb
+- lib/ri_cal/property_value/recurrence_rule.rb
+- lib/ri_cal/property_value/recurrence_rule/enumeration_support_methods.rb
+- lib/ri_cal/property_value/recurrence_rule/enumerator.rb
+- lib/ri_cal/property_value/recurrence_rule/initialization_methods.rb
+- lib/ri_cal/property_value/recurrence_rule/negative_setpos_enumerator.rb
+- lib/ri_cal/property_value/recurrence_rule/numbered_span.rb
+- lib/ri_cal/property_value/recurrence_rule/occurence_incrementer.rb
+- lib/ri_cal/property_value/recurrence_rule/recurring_day.rb
+- lib/ri_cal/property_value/recurrence_rule/recurring_month_day.rb
+- lib/ri_cal/property_value/recurrence_rule/recurring_numbered_week.rb
+- lib/ri_cal/property_value/recurrence_rule/recurring_year_day.rb
+- lib/ri_cal/property_value/recurrence_rule/validations.rb
+- lib/ri_cal/property_value/text.rb
+- lib/ri_cal/property_value/uri.rb
+- lib/ri_cal/property_value/utc_offset.rb
+- lib/ri_cal/required_timezones.rb
+- lib/ri_cal/time_with_floating_timezone.rb
+- ri_cal.gemspec
+- sample_ical_files/from_ical_dot_app/test1.ics
+- script/console
+- script/destroy
+- script/generate
+- script/txt2html
+- spec/ri_cal/component/alarm_spec.rb
+- spec/ri_cal/component/calendar_spec.rb
+- spec/ri_cal/component/event_spec.rb
+- spec/ri_cal/component/freebusy_spec.rb
+- spec/ri_cal/component/journal_spec.rb
+- spec/ri_cal/component/t_z_info_timezone_spec.rb
+- spec/ri_cal/component/timezone_spec.rb
+- spec/ri_cal/component/todo_spec.rb
+- spec/ri_cal/component_spec.rb
+- spec/ri_cal/core_extensions/time/calculations_spec.rb
+- spec/ri_cal/core_extensions/time/week_day_predicates_spec.rb
+- spec/ri_cal/occurrence_enumerator_spec.rb
+- spec/ri_cal/parser_spec.rb
+- spec/ri_cal/property_value/date_spec.rb
+- spec/ri_cal/property_value/date_time_spec.rb
+- spec/ri_cal/property_value/duration_spec.rb
+- spec/ri_cal/property_value/period_spec.rb
+- spec/ri_cal/property_value/recurrence_rule/recurring_year_day_spec.rb
+- spec/ri_cal/property_value/recurrence_rule_spec.rb
+- spec/ri_cal/property_value/text_spec.rb
+- spec/ri_cal/property_value/utc_offset_spec.rb
+- spec/ri_cal/property_value_spec.rb
+- spec/ri_cal/required_timezones_spec.rb
+- spec/ri_cal_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/ri_cal.rake
+- tasks/spec.rake
+has_rdoc: true
+homepage: http://rical.rubyforge.org/
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+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: rical
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 3
+summary: This is an UNOFFICIAL version
+test_files: []
+