mh_extensions 0.1.0

data/CHANGELOG.rdoc

@@ -0,0 +1,2 @@
+= Version 0.1.0
+* Gem existence started

data/Gemfile

@@ -0,0 +1,2 @@
+source "http://rubygems.org"
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Maciej Mensfeld
+
+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.

data/Manifest

@@ -0,0 +1,19 @@
+CHANGELOG.rdoc
+Gemfile
+MIT-LICENSE
+Manifest
+README.md
+Rakefile
+init.rb
+lib/acts_as_tree.rb
+lib/array.rb
+lib/browser_detector.rb
+lib/date.rb
+lib/hash.rb
+lib/mh_extensions.rb
+lib/rand.rb
+lib/range.rb
+lib/string.rb
+lib/string_ext.rb
+lib/txt_file_handler.rb
+mh_extensions.gemspec

data/README.md

@@ -0,0 +1,26 @@
+# MH Extensions (Must Have Extensions)
+
+## Install
+
+    gem install mh_extensions
+
+and in your Gemfile:
+    
+    gem 'mh_extensions'
+
+## About
+
+Package of usefull ruby basic classes extensions and some other usefull libs. For more details view any of files located in `lib/`
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with Rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2011 Maciej Mensfeld. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,12 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('mh_extensions', '0.1.0') do |p|
+  p.description    = "Package of usefull ruby basic classes (and not only) extensions"
+  p.url            = "https://github.com/mensfeld/mh_extensions"
+  p.author         = "Maciej Mensfeld"
+  p.email          = "maciej@mensfeld.pl"
+  p.ignore_pattern = ["tmp/*", "script/*"]
+end
+

data/init.rb

@@ -0,0 +1,2 @@
+require 'mh_extensions'
+

data/lib/acts_as_tree.rb

@@ -0,0 +1,72 @@
+# Rozszerzenie do activerecord::base i do acts_as_tree ktore umozliwia
+# korzystnaie z paru dodatkowych metod
+
+# Wymaga do działania bibliotekli rand.rb
+# http://raa.ruby-lang.org/project/rand/
+
+class ActiveRecord::Base
+  def has_children?
+    !self.children.size.zero?
+  end
+
+  def has_siblings?
+    !self.siblings.size.zero?
+  end
+
+  # Return the tree depth
+  def depth
+    return 0 unless has_children?
+    children.inject(0) {|dep,c| dep > c.depth ? dep : c.depth} + 1
+  end
+
+  # Return the tree width
+  def width
+    return 1 unless has_children?
+    children.inject(0) {|sum,c| sum + c.width}
+  end
+
+  # Ile węzłów mamy do roota z miejsca gdzie jesteśmy
+  def nodes_to_root
+    stop = false
+    levels = 0
+    parent = self.parent_id
+    while !stop
+      el =  parent ? self.class.find(parent) : nil
+      if el
+        parent = el.parent_id
+        levels += 1
+      else
+        stop = true
+      end
+    end
+    levels
+  end
+
+  # Sprawdza czy nasz rodzic w ogole istnieje
+  def valid_parent?
+    self.class.exists?(self.parent_id.to_i)
+  end
+
+  # Znajduje korzeń i zwraca go
+  def root
+    el = self
+    nodes_to_root.times {
+        el = self.parent
+    }
+    el
+  end
+
+  def leaf(random = false)
+    unless self.has_children?
+      return self
+    end
+
+    children = random ? self.children.shuffle : self.children
+
+    children.each { |child|
+      return child.leaf(random)
+    }
+    nil
+  end
+
+end

data/lib/array.rb

@@ -0,0 +1,23 @@
+# Rozszerzenie klasy Array umożliwiające korzystanie z paginacji za pomocą
+# pluginu Kaminaro
+class Array
+  def paginable(page, per_page, total_elements_amount)
+    @paginate_page = page
+    @paginate_per_page = per_page
+    @paginate_total_elements_amount = total_elements_amount
+    self.instance_eval <<-EVAL
+      def current_page
+        @paginate_page.to_i
+      end
+
+      def num_pages
+        (@paginate_total_elements_amount/@paginate_per_page).floor.to_i
+      end
+
+      def limit_value
+        @paginate_per_page.to_i
+      end
+
+    EVAL
+  end
+end

data/lib/browser_detector.rb

@@ -0,0 +1,89 @@
+# Lib used to determine browser version in Rails app
+
+class BrowserDetector
+  def initialize(request)
+    @browser_data = request
+    @user_agent = @browser_data.env['HTTP_USER_AGENT'] ?
+      @browser_data.env['HTTP_USER_AGENT'].downcase : ''
+  end
+
+  def name
+    agent = @user_agent
+    if agent =~ /msie/i; return :ie
+    elsif agent =~ /konqueror/i; return :konqueror
+    elsif agent =~ /chrome/i; return :chrome
+    elsif agent =~ /gecko/i; return :mozilla
+    elsif agent =~ /opera/i; return :opera
+    elsif agent =~ /applewebkit/i; return :safari
+    else; return :else
+    end
+  end
+
+  def version
+    agent = @user_agent
+    begin
+
+      if agent =~ /msie/i
+        agent.split(';').second.split(' ').second
+      elsif agent =~ /konqueror/i
+        agent.split('konqueror/').second.split(' ').first
+      elsif agent =~ /chrome/i
+        agent.split('chrome/').second.split(' ').first
+      elsif agent =~ /gecko/i
+        agent.split('firefox/').second.split(' ').first
+      elsif agent =~ /opera/i
+        agent.split('opera/').second.split(' ').first
+      elsif agent =~ /applewebkit/i
+        agent.split('safari/').second.split(' ').first
+      else
+        "Unknown"
+      end
+    rescue
+      return "Unknown"
+    end
+  end
+
+  def main_version
+    agent = @user_agent
+
+    begin
+      if agent =~ /msie/i
+        agent.split(';').second.split(' ').second.split('.').first.to_i
+      elsif agent =~ /konqueror/i
+        agent.split('konqueror/').second.split(' ').first.split('.').first.to_i
+      elsif agent =~ /chrome/i
+        agent.split('chrome/').second.split(' ').first.split('.').first.to_i
+      elsif agent =~ /gecko/i
+        agent.split('firefox/').second.split(' ').first.split('.').first.to_i
+      elsif agent =~ /opera/i
+        agent.split('opera/').second.split(' ').first.split('.').first.to_i
+      elsif agent =~ /applewebkit/i
+        agent.split('safari/').second.split(' ').first.split('.').first.to_i
+      else
+        "Unknown"
+      end
+    rescue
+      return "Unknown"
+    end
+  end
+
+  def is_ie6
+    return true if self.name == :ie && self.main_version == 6
+    return false
+  end
+
+  def is_ie7
+    return true if self.name == :ie && self.main_version == 7
+    return false
+  end
+
+  def is_ie8
+      return true if self.name == :ie && self.main_version >= 8
+      return false
+  end
+
+  def is_old_ie
+    true if is_ie6 || is_ie7
+  end
+
+end

data/lib/date.rb

@@ -0,0 +1,10 @@
+# To change this template, choose Tools | Templates
+# and open the template in the editor.
+
+class Date
+  def self.from_scratches(s, name, model = :range)
+    return nil if s.nil?
+    return nil if  s[model].nil?
+    self.civil(s[model][:"#{name}(1i)"].to_i,s[model][:"#{name}(2i)"].to_i,s[model][:"#{name}(3i)"].to_i)
+  end
+end

data/lib/hash.rb

@@ -0,0 +1,20 @@
+class Hash
+  # Zamienia podany hash na zestaw parametrów do linka ?menu=123&cos=12
+  def to_url_params
+    elements = []
+    keys.size.times do |i|
+      elements << "#{CGI::escape(keys[i])}=#{CGI::escape(values[i])}"
+    end
+    elements.join('&')
+  end
+
+  # Zamienia parametry urla na hash ?menu=123&cos=12 => {:menu => 123, :cos => 12}
+  def self.from_url_params(url_params)
+    result = {}.with_indifferent_access
+    url_params.split('&').each do |element|
+      element = element.split('=')
+      result[element[0]] = element[1]
+    end
+    result
+  end
+end

data/lib/mh_extensions.rb

@@ -0,0 +1,11 @@
+require "acts_as_tree"
+require "array"
+require "date"
+require "hash"
+require "rand"
+require "range"
+require "string"
+require "string_ext"
+require "browser_detector"
+require "txt_file_handler"
+

data/lib/rand.rb

@@ -0,0 +1,412 @@
+#
+# = rand.rb -- library for picking random elements and shuffling
+#
+# Copyright (C) 2004  Ilmari Heikkinen <mailto:kig@misfiring.net>
+#
+# Documentation:: Christian Neukirchen <mailto:chneukirchen@gmail.com>
+# 
+
+
+module Enumerable
+  # Choose and return a random element of the Enumerable.
+  #   [1, 2, 3, 4].pick  #=> 2 (or 1, 3, 4)
+  def pick
+    entries.pick
+  end
+
+  # Return an array of the elements in random order.
+  #   [1, 2, 3, 4].shuffle  #=> [3, 4, 1, 2]
+  def shuffle
+    entries.shuffle
+  end
+
+  # Calls _block_ once for each element in _self_ in random order,
+  # passing that element as a parameter.
+  def each_random(&block)
+    shuffle.each(&block)
+  end
+
+  # Invokes _block_ once for each element of _self_ in random order.
+  # Creates a new array containing the values returned by the block.
+  def map_random(&block)
+    shuffle.map(&block)
+  end
+end
+
+
+class Array
+  # Choose and return a random element of _self_.
+  #   [1, 2, 3, 4].pick  #=> 2 (or 1, 3, 4)
+  def pick
+    self[pick_index]
+  end
+
+  # Deletes a random element of _self_, returning that element.
+  #   a = [1, 2, 3, 4]
+  #   a.pick  #=> 2
+  #   a       #=> [1, 3, 4]
+  def pick!
+    i = pick_index
+    rv = self[i]
+    delete_at(i)
+    rv
+  end
+
+  # Return the index of an random element of _self_.
+  #   ["foo", "bar", "baz"].pick_index  #=> 1 (or 0, or 2)
+  def pick_index
+    rand(size)
+  end
+
+  # Destructive pick_index.  Delete a random element of _self_ and
+  # return its index.
+  #   a = [11, 22, 33, 44]
+  #   a.pick_index!  #=> 2
+  #   a              #=> [11, 22, 44]
+  def pick_index!
+    i = pick_index
+    delete_at i
+    i
+  end
+
+  # Return an array of the elements in random order.
+  #   [11, 22, 33, 44].shuffle  #=> [33, 11, 44, 22]
+  def shuffle
+    sort_by{rand}
+  end
+
+  # Destructive shuffle.  Arrange the elements of _self_ in new order.
+  #   a = [11, 22, 33, 44]
+  #   a.shuffle!
+  #   a                      #=> [33, 11, 44, 22]
+  def shuffle!
+    sort!{rand <=> 0.5}
+  end
+end
+
+
+class Hash
+  # Choose and return a random key-value pair of _self_.
+  #   {:one => 1, :two => 2, :three => 3}.pick  #=> [:one, 1]
+  def pick
+    k = keys.pick
+    [k, self[k]]
+  end
+
+  # Deletes a random key-value pair of _self_, returning that pair.
+  #   a = {:one => 1, :two => 2, :three => 3}
+  #   a.pick  #=> [:two, 2]
+  #   a       #=> {:one => 1, :three => 3}
+  def pick!
+    rv = pick
+    delete rv.first
+    rv
+  end
+
+  # Return a random key of _self_.
+  #   {:one => 1, :two => 2, :three => 3}.pick_key  #=> :three
+  def pick_key
+    keys.pick
+  end
+
+  # Return a random value of _self_.
+  #   {:one => 1, :two => 2, :three => 3}.pick_value  #=> 3
+  def pick_value
+    values.pick
+  end
+
+  # Delete a random key-value pair of _self_ and return the key.
+  #   a = {:one => 1, :two => 2, :three => 3}
+  #   a.pick_key!  #=> :two
+  #   a       #=> {:one => 1, :three => 3}
+  def pick_key!
+    pick!.first
+  end
+
+  # Delete a random key-value pair of _self_ and return the value.
+  #   a = {:one => 1, :two => 2, :three => 3}
+  #   a.pick_value!  #=> 2
+  #   a       #=> {:one => 1, :three => 3}
+  def pick_value!
+    pick!.last
+  end
+
+  # Return the key-value pairs of _self_ with _keys_ and _values_
+  # shuffled independedly.
+  #   {:one => 1, :two => 2, :three => 3}.shuffle_hash_pairs
+  #      #=> [[:one, 3], [:two, 1], [:three, 2]]
+  def shuffle_hash_pairs
+    keys.shuffle.zip(values.shuffle)
+  end
+
+  # Return a copy of _self_ with _values_ arranged in random order.
+  #   {:one => 1, :two => 2, :three => 3}.shuffle_hash
+  #      #=> {:two=>2, :three=>1, :one=>3}
+  def shuffle_hash
+    shuffled = {}
+    shuffle_hash_pairs.each{|k, v|
+      shuffled[k] = v
+    }
+    shuffled
+  end
+
+  # Destructive shuffle_hash.  Arrange the values of _self_ in
+  # new, random order.
+  #   h = {:one => 1, :two => 2, :three => 3}
+  #   h.shuffle_hash!
+  #   h  #=> {:two=>2, :three=>1, :one=>3}
+  def shuffle_hash!
+    shuffle_hash_pairs.each{|k, v|
+      self[k] = v
+    }
+    self
+  end
+end
+
+
+class String
+  # Return the string with characters arranged in random order.
+  #   "Ruby rules".shuffle_chars  #=> "e lybRsuur"
+  def shuffle_chars
+    split(//).shuffle.join('')
+  end
+
+  # Destructive shuffle_chars.  Arrange the characters of the string
+  # in new, random order.
+  #   s = "Ruby rules".shuffle_chars
+  #   s.shuffle_chars!
+  #   s    #=> "e lybRsuur"
+  def shuffle_chars!
+    self[0,size] = shuffle_chars
+  end
+
+  # Return a random byte of _self_.
+  #   "Ruby rules".pick_byte  #=> 121
+  def pick_byte
+    self[pick_index]
+  end
+
+  # Return a single-character string of a random character in _self_.
+  #   "Ruby rules".pick_char  #=> "y"
+  def pick_char
+    pick_byte.chr
+  end
+
+  # Destructive pick_char.  Delete a random character of the string
+  # and return it as a single-character string.
+  #   s = "Ruby rules"
+  #   s.pick_char!  #=> "y"
+  #   s             #=> "Rub rules"
+  def pick_char!
+    i = pick_index
+    rv = self[i,1]
+    self[i,1] = ""
+    rv
+  end
+
+  # Destructive pick_byte.  Delete a random byte of _self_ and return it.
+  #   s = "Ruby rules"
+  #   s.pick_byte!  #=> 121
+  #   s             #=> "Rub rules"
+  def pick_byte!
+    pick_char![0]
+  end
+
+  # Return a random byte index of _self_.
+  #   "Ruby rules".pick_index  #=> 3
+  def pick_index
+    rand(size)
+  end
+
+  # Destructive pick_index.  Delete a random byte of _self_ and
+  # return it's index.
+  #   s = "Ruby rules"
+  #   s.pick_index  #=> 3
+  #   s             #=> "Rub rules"
+  def pick_index!
+    i = pick_index
+    self[i,1] = ""
+    i
+  end
+end
+
+
+if __FILE__ == $0
+
+require 'test/unit'
+
+module RandTestHelpers          # :nodoc:
+  def picker(enum, enum_check, method, n=50)
+    (1..n).all?{ enum_check.include? enum.send(method) }
+  end
+
+  def try_shuffling(enum, enum_c, method)
+    rv = nil
+    10.times{
+     rv = enum.send method
+     break if rv != enum_c
+    }
+    rv
+  end
+end
+
+
+class RandArrayTest < Test::Unit::TestCase  # :nodoc:
+  include RandTestHelpers
+
+  def ar
+    (0..99).to_a
+  end
+
+  def test_pick
+    a = ar
+    results = (0...a.size).map{ a.pick }
+    assert true, results.all? {|r| a.include? r }
+  end
+
+  def test_pick!
+    a = ar
+    results = (0...a.size).map{ a.pick! }
+    assert true, results.sort == (0..99).to_a and a.empty?
+  end
+
+  def test_pick_index
+    a = ar
+    results = (0...a.size).map{ a.pick_index }
+    assert true, results.all? {|r| r.between?(0, a.size-1) }
+  end
+
+  def test_pick_index!
+    a = ar
+    # side-effect-relying block; a.size = a.size-1 after pick_index!,
+    # so the picked index max value is the new a.size
+    assert true, (0...a.size).all?{ a.pick_index!.between?(0, a.size) } and a.empty?
+  end
+
+  def test_shuffle
+    a = ar
+    shuffled = try_shuffling(a, a, :shuffle)
+    assert true, shuffled.sort == a and shuffled != a
+  end
+
+  def test_shuffle!
+    a = ar
+    try_shuffling(a, ar, :shuffle!)
+    assert true, a != ar and a.sort == ar
+  end
+end
+
+
+class RandHashTest < Test::Unit::TestCase  # :nodoc:
+  include RandTestHelpers
+
+  def ha
+    Hash[*(1..100).to_a]
+  end
+
+  def test_pick
+    assert true, picker(ha, ha.entries, :pick)
+  end
+
+  def test_pick!
+    h = ha
+    assert true, picker(h, ha.entries, :pick!) and h.empty? 
+  end
+
+  def test_pick_key
+    assert true, picker(ha, ha.keys, :pick_key)
+  end
+
+  def test_pick_key!
+    h = ha
+    assert true, picker(h, ha.keys, :pick_key!) and h.empty?
+  end
+
+  def test_pick_value
+    assert true, picker(ha, ha.values, :pick_value)
+  end
+
+  def test_pick_value!
+    h = ha
+    assert true, picker(h, ha.values, :pick_value!) and h.empty?
+  end
+
+  def test_shuffle_hash
+    h = ha
+    hs = try_shuffling(ha, h, :shuffle_hash)
+    assert true, hs != h and (hs.keys + hs.values).sort == (h.keys + h.values).sort
+  end
+
+  def test_shuffle_hash!
+    h = ha
+    hs = ha
+    try_shuffling(hs, h, :shuffle_hash!)
+    assert true, hs != h and (hs.keys + hs.values).sort == (h.keys + h.values).sort
+  end
+
+  def test_shuffle
+    h = ha
+    hs = try_shuffling(ha, h, :shuffle)
+    assert true, hs != h and hs.entries.sort == h.entries.sort
+  end
+end
+
+
+class RandStringTest < Test::Unit::TestCase  # :nodoc:
+  include RandTestHelpers
+
+  def self.pick_tests(endings)
+    endings.each{|ending, compare_str_f|
+      define_method("test_pick#{ending}"){
+        s = str
+        assert true, picker(s, instance_eval(&compare_str_f), "pick#{ending}", s.size)
+      }
+    }
+  end
+
+  def self.pick_tests!(endings)
+    endings.each{|ending, compare_str_f|
+      define_method("test_pick#{ending}!"){
+        s = str
+        assert true, picker(s, instance_eval(&compare_str_f), "pick#{ending}!", s.size) and s.empty?
+      }
+    }
+  end
+
+  def str
+    (("a".."z").to_s + "\n") * 10
+  end
+
+  def test_shuffle
+    s = str
+    ss = try_shuffling(s, s.to_a, :shuffle)
+    assert true, ss != s.to_a and ss.sort == s.to_a.sort
+  end
+
+  def test_shuffle_chars
+    s = str
+    ss = try_shuffling(s, s.split(//), :shuffle_chars)
+    assert true, ss != s and ss.split(//).sort == s.split(//).sort
+  end
+
+  def test_shuffle_chars!
+    s = str
+    ss = str
+    try_shuffling(ss, s.split(//), :shuffle_chars!)
+    assert true, ss != s and ss.split(//).sort == s.split(//).sort
+  end
+
+  pick_tests({ ""      => lambda{str.to_a}, 
+               :_char  => lambda{str.split(//)}, 
+               :_byte  => lambda{str.split(//).map{|c| c[0]}}, 
+               :_index => lambda{(0...str.size).to_a}
+             })
+
+  pick_tests!({ :_char  => lambda{str.split(//)}, 
+                :_byte  => lambda{str.split(//).map{|c| c[0]}}, 
+                :_index => lambda{(0...str.size).to_a}
+              })
+end
+
+
+end #if

data/lib/range.rb

@@ -0,0 +1,8 @@
+# Małe rozszerzenie do klasy przedziałów - sprawdza czy przedział podany
+# zawiera sie w naszym
+
+class Range
+  def overlap?(range)
+    self.include?(range.first) || range.include?(self.first)
+  end
+end

data/lib/string.rb

@@ -0,0 +1,90 @@
+# coding: utf-8
+# Dodatkowe metody klasy string
+
+class String
+
+  # Czy cenzurowano a jesli tak to ile niedobrych słów było
+  @censored_words = false
+
+  # Zwraca strina bez polskich literek, z małej litery, z usuniętymi innymi
+  # znakami oraz z zamienioną spacją na pauze (-)
+  def to_url
+    temp = self.downcase
+    temp
+    temp.gsub!(/[âäàãáäå�?ăąǎǟǡǻ�?ȃȧẵặ]/,'a')
+    temp.gsub!(/[ëêéèẽēĕėẻȅȇẹȩęḙḛ�?ếễểḕḗệ�?]/,'e')
+    temp.gsub!(/[�?iìíîĩīĭïỉ�?ịįȉȋḭɨḯ]/,'i')
+    temp.gsub!(/[òóôõ�?�?ȯö�?őǒ�?�?ơǫ�?ɵøồốỗổȱȫȭ�?�?ṑṓ�?ớỡởợǭộǿ]/,'o')
+    temp.gsub!(/[ùúûũūŭüủůűǔȕȗưụṳųṷṵṹṻǖǜǘǖǚừứữửự]/,'u')
+    temp.gsub!(/[ỳýŷỹȳ�?ÿỷẙƴỵ]/,'y')
+    temp.gsub!(/[ñǹń]/,'n')
+    temp.gsub!(/[çć]/,'c')
+    temp.gsub!(/[ß]/,'ss')
+    temp.gsub!(/[œ]/,'oe')
+    temp.gsub!(/[ij]/,'ij')
+    temp.gsub!(/[�?ł]/,'l')
+    temp.gsub!(/[ś]/,'s')
+    temp.gsub!(/[źż]/,'z')
+    temp.gsub!(/[^a-zA-Z 0-9]/, "")
+    temp.gsub!(/\s/,'-')
+    temp.gsub!(/\-+$/,'')
+    temp.gsub!(/^\-+/,'')
+    temp
+  end
+
+  # to_url tylko wykonane na sobie
+  def to_url!
+    self.replace self.to_url
+  end
+
+  # Zamienia znak nowej linii na <br>'a
+  def nl2br
+    self.gsub("\n\r","<br>").gsub("\r", "").gsub("\n", "<br />")
+  end
+
+  def nl2br!
+    self.replace self.nl2br
+  end
+
+  # Przycina tekst do lenght znakow dodajac end_str na koncu
+  def trim(length = 20, end_str = '...')
+    if self.length > length
+      return "#{self[0, length-end_str.length]}#{end_str}"
+    end
+    self
+  end
+
+  # trim tylko wykonane na sobie
+  def trim!(length = 20, end_str = '...')
+    self.replace self.trim(length, end_str)
+    self
+  end
+
+  # Cenzuruje niechciane słowa na podstawie tego co jest w bazie i zwraca
+  def censor(changer = '*')
+    Censor.run(self, changer)
+  end
+
+  # To samo co wyżej tylko operuje na sobie
+  def censor!(changer = '*')
+    @censored_words =  Censor.amount(self)
+    self.replace Censor.run(self, changer)
+  end
+
+  # Czy dany string został ocenzurowany
+  def censored?
+    @censored_words
+  end
+
+  # Zamiana CamelCase na underline
+  def underlinize
+    self.split(/(?=[A-Z])/).join('_').downcase
+  end
+
+  # Zamiana CamelCase na underline na sobie
+  def underlinize!
+    self.replace self.underlinize
+    self
+  end
+
+end

data/lib/string_ext.rb

@@ -0,0 +1,57 @@
+# coding: utf-8
+
+# Required string extensions
+
+class String
+  # Removes any "not url friendly" stuff and returns "pure" url
+  def to_url
+    temp = self.downcase
+    temp
+    temp.gsub!(/[âäàãáäå�?ăąǎǟǡǻ�?ȃȧẵặ]/,'a')
+    temp.gsub!(/[ëêéèẽēĕėẻȅȇẹȩęḙḛ�?ếễểḕḗệ�?]/,'e')
+    temp.gsub!(/[�?iìíîĩīĭïỉ�?ịįȉȋḭɨḯ]/,'i')
+    temp.gsub!(/[òóôõ�?�?ȯö�?őǒ�?�?ơǫ�?ɵøồốỗổȱȫȭ�?�?ṑṓ�?ớỡởợǭộǿ]/,'o')
+    temp.gsub!(/[ùúûũūŭüủůűǔȕȗưụṳųṷṵṹṻǖǜǘǖǚừứữửự]/,'u')
+    temp.gsub!(/[ỳýŷỹȳ�?ÿỷẙƴỵ]/,'y')
+    temp.gsub!(/[ñǹń]/,'n')
+    temp.gsub!(/[çć]/,'c')
+    temp.gsub!(/[ß]/,'ss')
+    temp.gsub!(/[œ]/,'oe')
+    temp.gsub!(/[ij]/,'ij')
+    temp.gsub!(/[�?ł]/,'l')
+    temp.gsub!(/[ś]/,'s')
+    temp.gsub!(/[źż]/,'z')
+    temp.gsub!(/[^a-zA-Z 0-9]/, "")
+    temp.gsub!(/\s/,'-')
+    temp.gsub!(/\-+$/,'')
+    temp.gsub!(/^\-+/,'')
+    temp
+  end
+
+  def to_url!
+    self.replace self.to_url
+  end
+
+  # Change new line to html <br/>
+  def nl2br
+    self.gsub("\n\r","<br>").gsub("\r", "").gsub("\n", "<br />")
+  end
+
+  def nl2br!
+    self.replace self.nl2br
+  end
+
+  # Trim string to required length
+  def trim(length = 20, end_str = '...')
+    if self.length > length
+      return "#{self[0, length-end_str.length]}#{end_str}"
+    end
+    self
+  end
+
+  def trim!(length = 20, end_str = '...')
+    self.replace self.trim(length, end_str)
+    self
+  end
+
+end

data/lib/txt_file_handler.rb

@@ -0,0 +1,109 @@
+# Lil lib used to read txt files
+class TxtFileHandler
+  def initialize(fileadr, relative = true)
+    if relative
+      @path = File.join(Rails.root, fileadr)
+    else
+      @path = fileadr
+    end
+
+  end
+
+  def line(nr)
+    return unless ropen
+    line = nil
+    i = 0
+    @file.each_line{ |s|      
+      if i == nr
+        line = s
+        close
+        break
+      end
+      i+=1
+    }
+    return line
+  end
+
+  def line_nr
+    return unless ropen
+    i = 0
+    @file.each_line{ |s|
+      i+=1
+    }
+    close
+    i
+  end
+
+  def lines(start, finish)
+    return unless ropen
+    lines = []
+    
+    if start > finish
+      temp = start
+      start = finish
+      finish = temp
+      invert = true
+    end
+    
+    i = 0
+    j = 0
+    @file.each_line{ |s|
+      if (i >= start && i <= finish)
+        lines[j] = s.gsub("", "Ruby")
+        j+=1
+      end
+      i+=1
+    }
+    if invert
+      lines = lines.reverse
+    end
+    close
+    lines
+  end
+
+  def file
+    @file
+  end
+
+  def self.exist?(fileadr, relative = true)
+    if relative
+      path = File.join(Rails.root, fileadr)
+    else
+      path = fileadr
+    end
+    FileTest.exist?(path)
+  end
+
+  def clear!
+    close
+    return unless wopen
+    @file << ""
+    close
+  end
+
+  private
+
+  def ropen
+    if TxtFileHandler::exist?(@path, false)
+      @file = File.open(@path, "r")
+      return true
+    end
+    return false
+  end
+
+  def wopen
+    if TxtFileHandler::exist?(@path, false)
+      @file = File.open(@path, "w")
+      return true
+    end
+    return false
+  end
+
+  def close
+    if @file
+      @file.close
+      @file = nil
+    end
+  end
+
+end

data/mh_extensions.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{mh_extensions}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Maciej Mensfeld"]
+  s.cert_chain = ["/home/mencio/.cert_keys/gem-public_cert.pem"]
+  s.date = %q{2011-04-10}
+  s.description = %q{Package of usefull ruby basic classes (and not only) extensions}
+  s.email = %q{maciej@mensfeld.pl}
+  s.extra_rdoc_files = ["CHANGELOG.rdoc", "README.md", "lib/acts_as_tree.rb", "lib/array.rb", "lib/browser_detector.rb", "lib/date.rb", "lib/hash.rb", "lib/mh_extensions.rb", "lib/rand.rb", "lib/range.rb", "lib/string.rb", "lib/string_ext.rb", "lib/txt_file_handler.rb"]
+  s.files = ["CHANGELOG.rdoc", "Gemfile", "MIT-LICENSE", "Manifest", "README.md", "Rakefile", "init.rb", "lib/acts_as_tree.rb", "lib/array.rb", "lib/browser_detector.rb", "lib/date.rb", "lib/hash.rb", "lib/mh_extensions.rb", "lib/rand.rb", "lib/range.rb", "lib/string.rb", "lib/string_ext.rb", "lib/txt_file_handler.rb", "mh_extensions.gemspec"]
+  s.homepage = %q{https://github.com/mensfeld/mh_extensions}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Mh_extensions", "--main", "README.md"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{mh_extensions}
+  s.rubygems_version = %q{1.5.2}
+  s.signing_key = %q{/home/mencio/.cert_keys/gem-private_key.pem}
+  s.summary = %q{Package of usefull ruby basic classes (and not only) extensions}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification 
+name: mh_extensions
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Maciej Mensfeld
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDMjCCAhqgAwIBAgIBADANBgkqhkiG9w0BAQUFADA/MQ8wDQYDVQQDDAZtYWNp
+  ZWoxGDAWBgoJkiaJk/IsZAEZFghtZW5zZmVsZDESMBAGCgmSJomT8ixkARkWAnBs
+  MB4XDTExMDQwOTA5NDcyMloXDTEyMDQwODA5NDcyMlowPzEPMA0GA1UEAwwGbWFj
+  aWVqMRgwFgYKCZImiZPyLGQBGRYIbWVuc2ZlbGQxEjAQBgoJkiaJk/IsZAEZFgJw
+  bDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL0+nG3V4/exIeiJ0IN+
+  wVfq8Utcu4Qpo+58EIVMIu3FiK+8w6MBvatZnUrRu12pqWLw9xrUkCiYeRErD+jF
+  AmdggIM/tu9CcjvURXH7VeTzOVA+pnV+eJWMD61o8HljFVcb/nyEYYVKErtr9/O4
+  QrIGv5lnszq1PMj2sBMy2gOP1YnzawncMLmkpp/T5SU4JZ5gAktGMRVz8RxmZzF5
+  6NVqFLbuqSRSU5U//WJvZVJt8dycCGgQzBM4Vi3nkOWyjIF0BANf1TqnlU2u6s8d
+  UK1AoDZfg5feef5e8eqoomHebX1opNGM/SOQhu3LRgax4rJfnl6VS3I2wighohsf
+  AgcCAwEAAaM5MDcwCQYDVR0TBAIwADAdBgNVHQ4EFgQUGlrWBqxVieAPk7NEzBDp
+  kM+iAMMwCwYDVR0PBAQDAgSwMA0GCSqGSIb3DQEBBQUAA4IBAQAJMoyBaJs8boiz
+  lFpbw6MWjk+7ZhqoHpFrWEV4nzb5GzyHZ7GU/pa1fSEQR0SCs+LnTLQbAYNQyUTT
+  O+UsTuA7xzI//v6cSodv3Q9NbfoDlou74xv1NXorWoosQFMpVWrXv+c/1RqU3cq4
+  WUr+rRiveEXG4tXOwkrpX8KH8xVp2vQZcGw3AXPqhzfqDGzpHd6ws3lk+8HoSrSo
+  2L68tDoxraF2Z2toAg9vfFw1+mOeDk1xVIPVcBy3tJxstHfHGHlQuMiRiDQX2b2D
+  YYU8UWVt2841IwB5Dgl4O+atXhe9ZTBO0W32pl4Bq5CP9lhQRT1KL7sxfznJlF7Y
+  BH3YFsdk
+  -----END CERTIFICATE-----
+
+date: 2011-04-10 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: Package of usefull ruby basic classes (and not only) extensions
+email: maciej@mensfeld.pl
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG.rdoc
+- README.md
+- lib/acts_as_tree.rb
+- lib/array.rb
+- lib/browser_detector.rb
+- lib/date.rb
+- lib/hash.rb
+- lib/mh_extensions.rb
+- lib/rand.rb
+- lib/range.rb
+- lib/string.rb
+- lib/string_ext.rb
+- lib/txt_file_handler.rb
+files: 
+- CHANGELOG.rdoc
+- Gemfile
+- MIT-LICENSE
+- Manifest
+- README.md
+- Rakefile
+- init.rb
+- lib/acts_as_tree.rb
+- lib/array.rb
+- lib/browser_detector.rb
+- lib/date.rb
+- lib/hash.rb
+- lib/mh_extensions.rb
+- lib/rand.rb
+- lib/range.rb
+- lib/string.rb
+- lib/string_ext.rb
+- lib/txt_file_handler.rb
+- mh_extensions.gemspec
+has_rdoc: true
+homepage: https://github.com/mensfeld/mh_extensions
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Mh_extensions
+- --main
+- README.md
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+requirements: []
+
+rubyforge_project: mh_extensions
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: Package of usefull ruby basic classes (and not only) extensions
+test_files: []
+

metadata.gz.sig

@@ -0,0 +1,2 @@
+L��xô���V�/����6"+ڕ�G��t1=���*��T="ਃW;����q�:~A|j>����jg�t�Yڴ�ȣ��$|��܋�t���ĈR�E<C.p6`�*�l�c���P�4���\ŏT�r�(��S�%�K#6��*Lt���8�n����;�܌�x�1�C3�}���xZ;�l]Z
+߲6��Cw"z��k��oz��GC��d�=�u�ɨ�