perpetual 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a2f7ca74a3592b3a0df4261b330d7b54d59ee814
+  data.tar.gz: d1e6f860d063a36060dfba2beb3444c361acaf8f
+SHA512:
+  metadata.gz: 091a99556c60540f72f1525a67ce7f7f29ced230a853786a6e3431982963db6cf42015ca45ee821b9934cf273aa2f133283b2bb2411505c064966d3bce21cd83
+  data.tar.gz: 47ae6ceee0b51628ac76e0786476d77b8c9a14483f9f661b86539210b94aadd333e9da09eaa470e0e70df38084f9ef1b6b29c8581eb5cc19155ca59b43302eea

data/lib/perpetual.rb

@@ -0,0 +1,19 @@
+#--
+# This file is part of Perpetual.
+#
+# Copyright(C) 2012 Giovanni Capuano <webmaster@giovannicapuano.net>
+#
+# Perpetual is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Perpetual is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with Perpetual.  If not, see <http://www.gnu.org/licenses/>.
+#++
+require 'perpetual/version'

data/lib/perpetual/enumerable.rb

@@ -0,0 +1,55 @@
+#--
+# This file is part of Perpetual.
+#
+# Copyright(C) 2012 Giovanni Capuano <webmaster@giovannicapuano.net>
+#
+# Perpetual is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Perpetual is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with Perpetual.  If not, see <http://www.gnu.org/licenses/>.
+#++
+module Enumerable
+  
+  # Returns the division of the elements of the enumerable.
+  def divide
+    inject(:/)
+  end
+  
+  # Returns true if the enumerable has more than 1 element.
+  # Can be called with a block too, much like any?, so <tt>people.many? { |p| p.age > 26 }</tt> returns true if more than one person is over 26.
+  def many?
+    cnt = 0
+    if block_given?
+      any? do |element|
+        cnt += 1 if yield element
+        cnt > 1
+      end
+    else
+      any?{ (cnt += 1) > 1 }
+    end
+  end
+  
+  # Returns the multiplication of the elements of the enumerable.
+  def multiply
+    inject(:*)
+  end
+  
+  # Returns the subtraction of the elements of the enumerable.
+  def subtract
+    inject(:-)
+  end
+  
+  # Returns the sum of the elements of the enumerable.
+  def sum
+    inject(:+)
+  end
+
+end

data/lib/perpetual/fixnum.rb

@@ -0,0 +1,39 @@
+#--
+# This file is part of Perpetual.
+#
+# Copyright(C) 2012 Giovanni Capuano <webmaster@giovannicapuano.net>
+#
+# Perpetual is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Perpetual is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with Perpetual.  If not, see <http://www.gnu.org/licenses/>.
+#++
+class Fixnum
+  
+  # Defines the methods +n?+ where n is each number from 0-10. Returns true if the number is itself in English.
+  (1..10).each { |n|
+   define_method "#{(n).in_word}?" do
+      self == n
+   end
+  }
+
+  # Calculates the factorial of the number.
+  def factorial
+    self.one? ? 1 : self * (self - 1).factorial
+  end
+  
+  # Returns the English word for the number or a empty string if the number is not known. Supports number from 0-10.
+  def in_word
+    [ 'zero', 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten' ][self] || ''
+  end
+  alias_method :in_words, :in_word
+  
+end

data/lib/perpetual/string.rb

@@ -0,0 +1,96 @@
+#--
+# This file is part of Perpetual.
+#
+# Copyright(C) 2012 Giovanni Capuano <webmaster@giovannicapuano.net>
+#
+# Perpetual is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Perpetual is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with Perpetual.  If not, see <http://www.gnu.org/licenses/>.
+#++
+class String
+  
+  # Returns the character at the +position+.
+  def at(position)
+    self[position, 1].to_s
+  end
+
+  # Returns true if the string contains only whitespaces or is empty.
+  def blank?
+    self !~ %r![^\s#{[0x3000].pack("U")}]!
+  end
+  
+  # Truncates the string after a given length if text is longer than length.
+  def cut(limit)
+    self.match(%r{^(.{0,#{limit}})})[1]
+  end
+  alias_method :truncate, :cut
+  
+  # Returns the first character of the string or the first +limit+ characters.
+  def first(limit = 1)
+    if limit == 0
+      ''
+    elsif limit >= self.length
+      self
+    else
+      self[0...limit]
+    end
+  end
+  
+  # Returns the remaining of the string from the +position+.
+  def from(position)
+    self[position, -1].to_s
+  end
+  
+  # Returns the last character of the string or the last +limit+ characters.
+  def last(limit = 1)
+    if limit == 0
+      ''
+    elsif limit >= self.length
+      self
+    else
+      self[(-limit)..-1]
+    end
+  end
+  
+  # Returns true if the string is a valid integer.
+  def numeric?
+    self.to_i.to_s == self || self.to_f.to_s == self
+  end
+  
+  # Removes from the string all the HTML(-like) tags.
+  def strip_html_tags
+    self.gsub(/<("[^"]*"|'[^']*'|[^'">])*>/, '')
+  end
+  alias_method :strip_tags, :strip_html_tags
+  
+  def strip_html_tags!
+    self.gsub!(/<("[^"]*"|'[^']*'|[^'">])*>/, '')
+  end
+  alias_method :strip_tags!, :strip_html_tags!
+  
+  # Capitalizes all the single words in the string.
+  def titlecase
+    self.gsub(/\b('?[a-z])/) { $1.capitalize }
+  end
+  alias_method :titleize, :titlecase
+  
+  def titlecase!
+    self.gsub!(/\b('?[a-z])/) { $1.capitalize }
+  end
+  alias_method :titleize!, :titlecase!
+  
+  # Returns the beginning of the string up to the +position+
+  def to(position)
+    self[0..position].to_s
+  end
+  
+end

data/lib/perpetual/string/crypt.rb

@@ -0,0 +1,79 @@
+#--
+# This file is part of Perpetual.
+#
+# Copyright(C) 2012 Giovanni Capuano <webmaster@giovannicapuano.net>
+#
+# Perpetual is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Perpetual is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with Perpetual.  If not, see <http://www.gnu.org/licenses/>.
+#++
+module Crypt
+
+  # Returns the base64 encoded hash of one or more strings that will be joined.
+  def self.base64_encode(*s)
+    require 'base64'
+    Base64.encode64 s.join
+  end
+
+  # Returns the base64 decoded string of one or more hashes that will be joined.
+  def self.base64_decode(*h)
+    require 'base64'
+    Base64.decode64 h.join
+  end
+
+  # Returns the MD5 hash of one or more strings that will be joined.
+  def self.md5(*s)
+    require 'digest/md5'
+    Digest::MD5.hexdigest s.join
+  end
+
+  # Returns the SHA1 hash of one or more strings that will be joined.
+  def self.sha1(*s)
+    require 'digest/sha1'
+    Digest::SHA1.hexdigest s.join
+  end
+  
+  class << self
+    alias_method :to_sha1, :sha1
+    alias_method :to_md5, :md5
+    alias_method :to_base64, :base64_encode
+  end
+  
+end
+
+class String
+  
+  # Returns the base64 encoded hash of the string.
+  def base64_encode
+    Crypt::base64_encode self
+  end
+  alias_method :to_base64, :base64_encode
+  alias_method :base64, :base64_encode
+  
+  # Returns the base64 decoded string of the hash.
+  def base64_decode
+    Crypt::base64_decode self
+  end
+  
+  # Returns the MD5 hash of the string.
+  def md5
+    Crypt::md5 self
+  end
+  alias_method :to_md5, :md5
+
+  # Returns the SHA1 hash of the string.
+  def sha1
+    Crypt::sha1 self
+  end
+  alias_method :to_sha1, :sha1
+  
+end

data/lib/perpetual/string/miscs.rb

@@ -0,0 +1,34 @@
+#--
+# This file is part of Perpetual.
+#
+# Copyright(C) 2012 Giovanni Capuano <webmaster@giovannicapuano.net>
+#
+# Perpetual is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Perpetual is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with Perpetual.  If not, see <http://www.gnu.org/licenses/>.
+#++
+module Perpetual; module String
+  module Miscs
+  
+    # Generates an alphanumeric pseudo-random string of length +length+ (default: +10+).
+    def self.random(length = 10)
+      dictionary        = (?a..?z).to_a + (?A..?Z).to_a + (?0..?9).to_a
+      dictionary_length = dictionary.length
+      ''.tap { |v|
+        1.upto(length) {
+          v << dictionary[rand(dictionary_length-1)]
+        }
+      }
+    end
+    
+  end
+end; end

data/lib/perpetual/version.rb

@@ -0,0 +1,23 @@
+#--
+# This file is part of Perpetual.
+#
+# Copyright(C) 2012 Giovanni Capuano <webmaster@giovannicapuano.net>
+#
+# Perpetual is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Perpetual is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with Perpetual.  If not, see <http://www.gnu.org/licenses/>.
+#++
+module Perpetual
+  def self.version
+    '0.1.1'
+  end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: perpetual
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Giovanni Capuano
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-11 00:00:00.000000000 Z
+dependencies: []
+description: Contains the more used methods not contained in Ruby. Just include the
+  classes/modules you need to use them.
+email: webmaster@giovannicapuano.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/perpetual/enumerable.rb
+- lib/perpetual/fixnum.rb
+- lib/perpetual/string/crypt.rb
+- lib/perpetual/string/miscs.rb
+- lib/perpetual/string.rb
+- lib/perpetual/version.rb
+- lib/perpetual.rb
+homepage: http://www.giovannicapuano.net
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Contains some useful methods.
+test_files: []