brightbox-rujitsu 0.1.8

data/CHANGELOG

@@ -0,0 +1,36 @@
+= Version 0.1.8 (2009-01-24)
+
+Added String#truncate + matching specs
+
+= Version 0.1.7 (2008-12-08)
+
+Added the limiter to Range#random_numbers
+
+= Version 0.1.6 (2008-12-08)
+
+Added a limiter to Fixnum#random_numbers
+
+= Version 0.1.5 (2008-12-03)
+
+Added random_vowels and random_consonants
+
+= Version 0.1.4 (2008-11-27)
+
+Added the grammar section
+
+= Version 0.1.3 (2008-11-24)
+
+Cleaned up invalid characters
+Refactored generate_random_string_using method (thanks to zachinglis)
+
+= Version 0.1.2 (2008-11-24)
+
+Added full test suite
+
+= Version 0.1.1 (2008-11-22)
+
+Added range based random character generation
+
+= Version 0.1.0 (2008-11-22)
+
+Initial Release; random character generation, URL-friendly strings.  

data/README.rdoc

@@ -0,0 +1,65 @@
+= rujitsu
+
+A ruby gem with various helper methods to smooth out your Ruby development.  
+
+== Install
+
+  gem install brightbox-rujitsu --source http://gems.github.com
+  
+== Including
+
+  require "rujitsu"
+  require "rujitsu/grammar"
+
+=== Rails
+
+To require in rails 2.2, add the following to your +environment.rb+ file.
+
+  config.gem "brightbox-rujitsu", :lib => "rujitsu", :source => "http://gems.github.com"
+  config.gem "brightbox-rujitsu", :lib => "rujitsu/grammar", :source => "http://gems.github.com"
+
+
+== Usage
+
+=== Generating random strings
+
+The Fixnum class has a couple of extensions allowing you to generate random strings.  
+
+  5.random_letters
+  5.random_numbers
+  5.random_characters
+  
+You can also generate a variable length string.  
+
+  (3..5).random_letters 
+  
+This generates a string of random letters whose length is 3, 4 or 5 characters.  
+  
+=== URL-friendly strings
+
+The String class has an extension that strips out URL-unfriendly characters.  
+
+  ""$%hello!@ 123 there'".to_url # => "hello-123-there" 
+
+=== Truncating strings
+
+The String class has an extension that truncates it to a customisable length with a customisable suffix.
+
+  "this is a string".truncate(:length => 15) # => "this is a st..."
+
+=== Grammar
+
+So far the grammar library just adds the method +should_recieve+ for rspec assertions. Use it to find out what it does!
+
+
+== Released under the MIT Licence
+
+Copyright (c) 2008 Brightbox Systems Ltd 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+* The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+See http://www.brightbox.co.uk/ for contact details.  

data/Rakefile

@@ -0,0 +1,16 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('rujitsu', '0.1.8') do | config | 
+  config.description = 'Various helper methods to smooth over Ruby development'
+  config.url = 'http://github.com/rahoub/rujitsu'
+  config.author = 'Brightbox Systems Ltd'
+  config.email = 'hello@brightbox.co.uk'
+  config.ignore_pattern = ['tmp/*', 'script/*']
+  config.development_dependencies = []
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each do | rake_file | 
+  load rake_file
+end

data/lib/rujitsu/fixnum.rb

@@ -0,0 +1,53 @@
+class Fixnum
+  # produce a string of N random vowels
+  def random_vowels
+    generate_random_string_using VOWELS
+  end
+  # produce a string of N random consonants
+  def random_consonants
+    generate_random_string_using CONSONANTS
+  end
+  # produce a string of N random letters
+  #   5.random_letters
+  def random_letters
+    generate_random_string_using LETTERS
+  end
+  # produce a string of N random numbers
+  #   5.random_numbers
+  # optionally specific limits on the numbers
+  #   5.random_numbers(:from => 1, :to => 5)
+  def random_numbers( opts = {} )
+    # Then set some defaults, just in case
+    upper = opts[:to] || 9
+    lower = opts[:from] || 0
+            
+    # And finally calculate the number
+    n = []    
+    self.times do
+      i = (lower..upper).to_a.sort_by { rand }.first
+      n << i.to_s
+    end
+    n.join("")
+  end
+  # produce a string of N random characters
+  #   5.random_characters
+  def random_characters
+    generate_random_string_using CHARACTERS
+  end
+  
+  private
+
+  VOWELS = ['a', 'e', 'i', 'o', 'u']  
+  LETTERS = ('a'..'z').to_a
+  CONSONANTS = LETTERS - VOWELS
+  NUMBERS = ('0'..'9').to_a
+  CHARACTERS = LETTERS + NUMBERS
+
+  def generate_random_string_using(legal_characters)
+    upper_limit = legal_characters.size - 1
+    (1..self).collect do |num|
+      legal_characters[rand(upper_limit)]
+    end.join
+  end
+end
+

data/lib/rujitsu/grammar.rb

@@ -0,0 +1,12 @@
+module Spec
+  module Mocks
+    module Methods
+      class GrammarException < Exception; end
+      
+      def should_recieve(sym, opts={}, &block)
+        raise GrammarException, "Oi! i before except after c."
+      end
+    end
+  end
+end
+ 

data/lib/rujitsu/numeric.rb

@@ -0,0 +1,8 @@
+class Numeric
+  # convert float values to "cents"
+  #   my_value = 2.5
+  #   my_value.to_cents # => 250
+  def to_cents
+    (self * 100.0).to_i
+  end
+end

data/lib/rujitsu/range.rb

@@ -0,0 +1,26 @@
+class Range
+  # pull a random element out of this range
+	def to_random_i
+		self.to_a.sort_by { rand }.first
+	end
+	
+	# create a string of random letters whose length is one of the values in your range
+	# (3..4).random_letters # => returns a string or 3 or 4 random letters
+	def random_letters
+		self.to_random_i.random_letters
+	end
+	
+	# create a string of random numbers whose length is one of the values in your range
+	# (3..4).random_numbers # => returns a string or 3 or 4 random numbers
+	def random_numbers opts = {}
+		self.to_random_i.random_numbers opts
+	end
+	
+	# create a string of random characters whose length is one of the values in your range
+	# (3..4).random_characters # => returns a string or 3 or 4 random characters
+	def random_characters
+		self.to_random_i.random_characters
+	end
+	
+end
+

data/lib/rujitsu/string.rb

@@ -0,0 +1,26 @@
+class String
+	# Return a string that can be used as part of a url
+	# replaces basic "bad" characters with "-"
+	def to_url
+		self.downcase.gsub(/[^\-0-9a-z ]/, '').split.join('-')
+	end
+	
+	# Truncates a string to the specified length,
+	# and appends suffix if required
+	# 
+	# Options:
+	# * +length+ length to truncate string to. Includes the suffix in the length. Default is 50.
+	# * +suffix+ suffix to append to truncated string. Pass "" or false for no suffix. Default is "...".
+	# 
+	def truncate opts = {}
+	  opts[:length] ||= 50
+	  opts[:suffix] = opts.has_key?(:suffix) ? opts[:suffix] : "..."
+	  opts[:suffix] ||= ""
+    opts[:length] -= (opts[:suffix].length+1)
+    if opts[:length] > 0
+      self.length > opts[:length] ? self[0..opts[:length]] + opts[:suffix] : self
+    else
+      opts[:suffix][0..(opts[:length] += opts[:suffix].length)]
+    end
+  end
+end

data/lib/rujitsu.rb

@@ -0,0 +1,5 @@
+base_dir = File.expand_path(File.dirname(__FILE__))
+require base_dir + '/rujitsu/fixnum'
+require base_dir + '/rujitsu/numeric'
+require base_dir + '/rujitsu/range'
+require base_dir + '/rujitsu/string'

data/rujitsu.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rujitsu}
+  s.version = "0.1.8"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Brightbox Systems Ltd"]
+  s.date = %q{2009-01-24}
+  s.description = %q{Various helper methods to smooth over Ruby development}
+  s.email = %q{hello@brightbox.co.uk}
+  s.extra_rdoc_files = ["CHANGELOG", "lib/rujitsu/fixnum.rb", "lib/rujitsu/grammar.rb", "lib/rujitsu/numeric.rb", "lib/rujitsu/range.rb", "lib/rujitsu/string.rb", "lib/rujitsu.rb", "README.rdoc", "tasks/rspec.rake"]
+  s.files = ["CHANGELOG", "lib/rujitsu/fixnum.rb", "lib/rujitsu/grammar.rb", "lib/rujitsu/numeric.rb", "lib/rujitsu/range.rb", "lib/rujitsu/string.rb", "lib/rujitsu.rb", "Manifest", "Rakefile", "README.rdoc", "rujitsu.gemspec", "spec/fixnum_spec.rb", "spec/numeric_spec.rb", "spec/range_spec.rb", "spec/spec.opts", "spec/spec_helper.rb", "spec/string_spec.rb", "tasks/rspec.rake"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/brightbox/rujitsu}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Rujitsu", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{rujitsu}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Various helper methods to smooth over Ruby development}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/spec/fixnum_spec.rb

@@ -0,0 +1,129 @@
+require File.join(File.dirname(__FILE__) + "/spec_helper")
+
+describe Fixnum do
+
+  describe "random_vowels" do
+    it "should be a method" do
+      Fixnum.instance_methods.should include("random_vowels")
+      5.should respond_to(:random_vowels)
+    end
+    
+    it "should produce a string of random vowels" do
+      [ 5, 10, 15, 25, 29 ].each do |i|
+        str = i.random_vowels
+        str.should be_a_kind_of( String )
+        str.length.should == i
+        str.should match( /^[aeiou]+$/ )
+      end
+    end
+  end
+
+  describe "random_consonants" do
+    it "should be a method" do
+      Fixnum.instance_methods.should include("random_consonants")
+      5.should respond_to(:random_consonants)
+    end
+    
+    it "should produce a string of random consonants" do
+      [ 5, 10, 15, 25, 29 ].each do |i|
+        str = i.random_consonants
+        str.should be_a_kind_of( String )
+        str.length.should == i
+        str.should match( /^[bcdfghjklmnpqrstvwxyz]+$/ )
+      end
+    end
+  end
+
+  describe "random_letters" do
+    it "should be a method" do
+      Fixnum.instance_methods.should include("random_letters")
+      5.should respond_to(:random_letters)
+    end
+
+    it "should produce a string of random letters" do
+      [ 5, 10, 15, 25, 29 ].each do |i|
+        str = i.random_letters
+        str.should be_a_kind_of( String )
+        str.length.should == i
+        str.should match( /^[a-z]+$/ )
+      end
+    end
+  end
+
+  describe "random_numbers" do
+    it "should be a method" do
+      Fixnum.instance_methods.should include("random_numbers")
+      5.should respond_to(:random_numbers)
+    end
+
+    it "should produce a string of random numbers" do
+      [ 5, 10, 15, 25, 29 ].each do |i|
+        num = i.random_numbers
+        num.should be_a_kind_of( String )
+        num.length.should == i
+        num.should match( /^[0-9]+$/ )
+      end
+    end
+    
+    it "should contain only the number 5 upwards" do
+      num = 5.random_numbers(:from => 5)
+      
+      num.should be_a_kind_of(String)
+      
+      # Check each digit is greater than or equal to 5
+      string_to_integers(num).each do |i|
+        i.should be_a_kind_of(Integer)
+        i.should >= 5
+      end
+    end
+    
+    it "should contain on the number 5 downwards" do
+      num = 5.random_numbers(:to => 5)
+      
+      num.should be_a_kind_of(String)
+      
+      # Check each digit is lower than or equal to 5
+      string_to_integers(num).each do |i|
+        i.should be_a_kind_of(Integer)
+        i.should <= 5
+      end
+    end
+    
+    it "should contain numbers between 4 and 6" do
+      num = 5.random_numbers(:from => 4, :to => 6)
+      
+      num.should be_a_kind_of(String)
+      
+      # Check each digit is lower than or equal to 4..
+      # ..and greater than or equal to 6
+      string_to_integers(num).each do |i|
+        i.should be_a_kind_of(Integer)
+        i.should >= 4
+        i.should <= 6
+      end
+    end
+    
+    private
+    
+    def string_to_integers(str)
+      str.split("").map {|x| x.to_i }
+    end
+  end
+
+  describe "random_characters" do
+    it "should be a method" do
+      Fixnum.instance_methods.should include("random_characters")
+      5.should respond_to(:random_numbers)
+    end
+
+    it "should produce a string of random letters and numbers" do
+      [ 5, 10, 15, 25, 29 ].each do |i|
+        str = i.random_characters
+        str.should be_a_kind_of( String )
+        str.length.should == i
+        str.should match( /^[a-z0-9]+$/ )
+      end
+    end
+  end
+
+end

data/spec/numeric_spec.rb

@@ -0,0 +1,14 @@
+require File.join(File.dirname(__FILE__) + "/spec_helper")
+
+describe Numeric, "to_cents" do
+  it "should be a method" do
+    Numeric.instance_methods.should include("to_cents")
+    Numeric.new.should respond_to(:to_cents)
+  end
+
+  it "should convert float values to \"cents\"" do
+    [ 5, 10, 15, 25, 29 ].each do |i|
+      i.to_cents.should == (i*100).to_i
+    end
+  end
+end

data/spec/range_spec.rb

@@ -0,0 +1,117 @@
+require File.join(File.dirname(__FILE__) + "/spec_helper")
+
+describe Range do
+    
+  describe "to_random_i" do
+    it "should be a method" do
+      Range.instance_methods.should include("to_random_i")
+    end
+    
+    it "should return a random number from the range" do
+      setup_range
+      
+      # First check with an absolute
+      result = @range.to_random_i
+      result.should be_a_kind_of(Fixnum)
+      result.should == 4
+      
+      # And then one that is random
+      res = (3..5).to_random_i
+      res.should be_a_kind_of(Fixnum)
+      [3,4,5].should include(res)
+    end    
+  end
+  
+  describe "random_letters" do
+    it "should be a method" do
+      Range.instance_methods.should include("random_letters")
+      (0..1).should respond_to(:random_letters)
+    end
+    
+    it "should generate a string of random letters" do
+      setup_range
+      
+      str = @range.random_letters
+      str.length.should == 4
+      str.should match( /^[a-z]+$/ )
+    end
+  end
+  
+  describe "random_numbers" do
+    it "should be a method" do
+      Range.instance_methods.should include("random_numbers")
+      (0..1).should respond_to(:random_numbers)
+    end
+    
+    it "should generate a string of random numbers" do
+      setup_range
+      
+      str = @range.random_numbers
+      str.length.should == 4
+      str.should match( /^[0-9]+$/ )
+    end
+    
+    it "should contain only the number 5 upwards" do
+      setup_range
+      
+      str = @range.random_numbers :from => 5
+      str.should be_a_kind_of(String)
+      
+      string_to_integers(str).each do |i|
+        i.should be_a_kind_of(Integer)
+        i.should >= 5
+      end
+    end
+    
+    it "should contain only the number 5 downwards" do
+      setup_range
+      
+      str = @range.random_numbers :to => 5
+      str.should be_a_kind_of(String)
+      
+      string_to_integers(str).each do |i|
+        i.should be_a_kind_of(Integer)
+        i.should <= 5
+      end
+    end
+    
+    it "should contain only numbers between 4 and 6" do
+      setup_range
+      
+      str = @range.random_numbers :from => 4, :to => 6
+      str.should be_a_kind_of(String)
+      
+      string_to_integers(str).each do |i|
+        i.should be_a_kind_of(Integer)
+        i.should >= 4
+        i.should <= 6
+      end
+    end
+    
+    private
+    
+    def string_to_integers(str)
+      str.split("").map {|x| x.to_i }
+    end    
+  end
+  
+  describe "random_letters" do
+    it "should be a method" do
+      Range.instance_methods.should include("random_characters")
+      (0..1).should respond_to(:random_characters)
+    end
+    
+    it "should generate a string of random letters" do
+      setup_range
+      
+      str = @range.random_characters
+      str.length.should == 4
+      str.should match( /^[a-z0-9]+$/ )
+    end
+  end
+  
+  def setup_range
+    @range = (3..5)
+    @range.should_receive(:to_random_i).and_return(4)
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,4 @@
+--colour
+--format progress
+--loadby mtime
+--reverse

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__) + "/../lib/rujitsu")

data/spec/string_spec.rb

@@ -0,0 +1,99 @@
+require File.join(File.dirname(__FILE__) + "/spec_helper")
+
+describe String, "to_url" do
+
+  it "should remove non-valid characters" do
+    "a!@£$".to_url.should == "a"
+  end
+
+  it "should convert spaces to hyphens" do
+    "a string".to_url.should == "a-string"
+  end
+
+  it "should downcase entire string" do
+    "THISISASTRING".to_url.should == "thisisastring"
+  end
+
+  it "should not touch [\\-0-9a-z]" do
+    "post-number-12345".to_url.should == "post-number-12345"
+  end
+
+end
+
+describe String, "truncate" do
+  
+  it "should return shorter string unmodified with no params" do
+    str = 30.random_characters
+    # default length is 50
+    str.truncate.should == str
+  end
+  
+  it "should return shorter string unmodified with length param" do
+    str = "0123456789" # length 10
+    trunced = str.truncate(:length => 30)
+    trunced.length.should == 10
+    trunced.should == str
+  end
+  
+  it "should return shorter string unmodified with suffix param" do
+    str = "0123456789" # length 10
+    trunced = str.truncate(:suffix => "abcd")
+    trunced.length.should == 10
+    trunced.should == str
+  end
+  
+  it "should return shorter string unmodified with length and suffix params" do
+    str = "0123456789" # length 10
+    trunced = str.truncate(:length => 30, :suffix => "abcd")
+    trunced.length.should == 10
+    trunced.should == str
+  end
+  
+  it "should truncate longer string with no params" do
+    str = "this is a string with a really long length just to get above 50 characters"
+    # default length is 50
+    # default suffix is "..."
+    trunced = str.truncate
+    trunced.length.should == 50
+    trunced.should == "this is a string with a really long length just..."
+  end
+
+  it "should truncate longer string with length param" do
+    str = "123456789123456789" # length 11
+    trunced = str.truncate(:length => 10)
+    trunced.length.should == 10
+    trunced.should == "1234567..."
+  end
+  
+  it "should truncate longer string with suffix param" do
+    str = "this is a string with a really long length just to get above 50 characters"
+    # default length is 50
+    trunced = str.truncate(:suffix => "..abc")
+    trunced.length.should == 50
+    trunced.should == "this is a string with a really long length ju..abc"
+  end
+  
+  it "should truncate longer string with length and suffix param" do
+    str = "123456789123456789" # length 11
+    trunced = str.truncate(:length => 10, :suffix => "abde")
+    trunced.length.should == 10
+    trunced.should == "123456abde"
+  end
+  
+  it "should return truncated string with no suffix if suffix param is false" do
+    str = "this is a string with a really long length just to get above 50 characters"
+    # default length is 50
+    trunced = str.truncate(:suffix => false)
+    trunced.length.should == 50
+    trunced.should == "this is a string with a really long length just to"
+  end
+  
+  it "should return a string of length specified even when the suffix is longer" do
+    str = "this is a string" # => 16
+    suff = "this is a longer string" # => 23
+    trunced = str.truncate(:suffix => suff, :length => 10)
+    trunced.should == "this is a "
+    trunced.length.should == 10
+  end
+  
+end

data/tasks/rspec.rake

@@ -0,0 +1,24 @@
+# Borrowed from http://github.com/rsim/ruby-plsql/tree/master/tasks/rspec.rake
+# Github++
+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:
+  [sudo] gem install rspec
+EOS
+  exit(0)
+end
+
+desc "Run the specs under spec/*"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ["--options", "spec/spec.opts"]
+  t.spec_files = FileList["spec/*_spec.rb"]
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification 
+name: brightbox-rujitsu
+version: !ruby/object:Gem::Version 
+  version: 0.1.8
+platform: ruby
+authors: 
+- Brightbox Systems Ltd
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-24 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Various helper methods to smooth over Ruby development
+email: hello@brightbox.co.uk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- lib/rujitsu/fixnum.rb
+- lib/rujitsu/grammar.rb
+- lib/rujitsu/numeric.rb
+- lib/rujitsu/range.rb
+- lib/rujitsu/string.rb
+- lib/rujitsu.rb
+- README.rdoc
+- tasks/rspec.rake
+files: 
+- CHANGELOG
+- lib/rujitsu/fixnum.rb
+- lib/rujitsu/grammar.rb
+- lib/rujitsu/numeric.rb
+- lib/rujitsu/range.rb
+- lib/rujitsu/string.rb
+- lib/rujitsu.rb
+- Manifest
+- Rakefile
+- README.rdoc
+- rujitsu.gemspec
+- spec/fixnum_spec.rb
+- spec/numeric_spec.rb
+- spec/range_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/string_spec.rb
+- tasks/rspec.rake
+has_rdoc: true
+homepage: http://github.com/brightbox/rujitsu
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Rujitsu
+- --main
+- README.rdoc
+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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: rujitsu
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Various helper methods to smooth over Ruby development
+test_files: []
+