marskal-core-extensions 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a34bbfa1eb84d2ef1435c9ac3c3386188fe82a7d
+  data.tar.gz: 6703c331f1c2936398950fa8f3159c48b85c2480
+SHA512:
+  metadata.gz: 65069ab7c457c71a8d88c017e18bc6d908141cd6f5b6143fed640734aee675ebc41d7aebb78332ea9b778e40c95f8f260f0775e431b262889054a50841ae61d4
+  data.tar.gz: ed66b0013e2585035c0697b98e925839a5c83535a1e94855fd97027bc26bc8e01caeb5e629b1ef50f87dd271e729781cca6ef5853399f2dd66b791271e56b8a3

data/.gitignore

@@ -0,0 +1,24 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.idea
+.idea/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in marskal-core-extensions.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Mike Urban
+
+MIT License
+
+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/README.md

@@ -0,0 +1,35 @@
+# Marskal::Core::Extensions
+
+This gems contains several extensions to the Core Functions of Ruby and Ruby On rails.
+This was developed using Ruby 2.0 and Ruby2.1 but many of the extension will likely work with older versions
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'marskal-core-extensions'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install marskal-core-extensions
+
+## Usage
+
+	array.rb     =>  Extensions for data type **Array**
+	numeric.rb   =>  Extensions for data type **Numeric**
+	date.rb      =>  Extensions for data type **Date**
+	i18n.rb      =>  Extensions for the Internationalization module **I18n**
+	string.rb    =>  Extensions for data type **String**
+	
+Contact
+-------
+Comments and feedback are welcome. Send an email to Mike Urban via mike@marskalgroup.com
+	
+
+## Contributing
+
+Copyright Marskal Group LLC, 2012-2015

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/lib/marskal/core/extensions.rb

@@ -0,0 +1,16 @@
+require "marskal/core/extensions/version"
+
+#utilities
+require "marskal/core/extensions/array"
+require "marskal/core/extensions/date"
+require "marskal/core/extensions/i18n"
+require "marskal/core/extensions/numeric"
+require "marskal/core/extensions/string"
+
+module Marskal
+  module Core
+    module Extensions
+      # Your code goes here...
+    end
+  end
+end

data/lib/marskal/core/extensions/array.rb

@@ -0,0 +1,27 @@
+class Array
+
+  #converts an array to a string and strips outer brackets ex:   [1,2,3].to_string_no_brackets  ==> #returns "1,2,3"
+  def to_string_no_brackets
+    self.to_s.gsub(/[\[\]]/,'')
+  end
+
+  def to_string_no_brackets_or_quotes #addded sept 204 when using for datatables jquery plugin, but can be used for anything
+    self.to_s.gsub(/[\"\[\]]/,'')     #convert an array into a string and remove the quotes Originally developed to help 'pluck'
+  end
+
+
+  def prepare_for_sql_in_clause
+    "(#{self.to_string_no_brackets})"
+  end
+
+  def json_data_for_highcharts
+    # self.to_json.gsub(/[\'\"]/,'')   #maybe add this as a parameter to include or exclude single quotes
+    self.to_json.gsub(/[\"]/,'')       # but for now, we will allow single quotes a strings are allowed in json
+  end
+
+  def sql_null_to_blank
+    self.map {|v| "IFNULL(#{v}, '')" }
+  end
+
+
+end

data/lib/marskal/core/extensions/date.rb

@@ -0,0 +1,63 @@
+class Date
+  def start_of_next_month
+    (self + 1.month).start_of_month
+  end
+
+  def for_highcharts
+    # MAU 05/2014 - I left the experiments commented out for reference
+    # I cant say I understand exactly how this works, but using examples I came up with a method that HighCharts seems to work well with
+    # "#{self.to_time.to_i}000".to_i
+    # "#{self.strftime('%Y-%m-%d 14:00').to_time.utc.to_i}000".to_i
+    # "Date.UTC(#{self.strftime('%Y,%m,%d')})"
+    "#{(self-1.day).to_time.strftime("%Y-%m-%d 19:00").to_time.utc.to_i}000".to_i
+  end
+
+  def self.start_of_week
+    Date.today.start_of_week
+  end
+
+  def start_of_week
+    if self.wday == 0  #sundays count as end of week for vehicle app
+      return self - 6
+    else
+      (self - self.wday.days) + 1  #start on monfay
+    end
+  end
+
+
+  def start_of_month
+    self.strftime('%Y-%m-01').to_date
+  end
+
+
+  def self.create_from_string(p_date_str)  #MAUNEWP Added 1/2011..creats a date from a string
+    parts = p_date_str.split("/")
+    return nil if parts.length != 3
+    return Date.new(parts[2].to_i,parts[0].to_i,parts[1].to_i)
+  end
+
+  def formatted
+    self.strftime("%m/%d/%Y")
+  end
+
+  def self.is_today_weekend?
+    (Date.today.wday == 0) or (Date.today.wday == 6)
+  end
+
+  def is_weekend?
+    (self.wday == 0) or (self.wday == 6)
+  end
+
+  def self.next_week(date)
+    date.start_of_week + 7.days
+  end
+
+  def next_week
+    self.start_of_week + 7.days
+  end
+
+  def end_of_week
+    self.start_of_week + 4.days
+  end
+
+end

data/lib/marskal/core/extensions/i18n.rb

@@ -0,0 +1,82 @@
+module I18n
+
+  #translate a single string with no plurals, take :one or only one if only one exist
+  #my understanding of how rails recommends
+  #have separate entries for plurals in the internationalization fies (e.g. en.yml)
+  #for example
+  #    contact:
+  #        one: "Contact"
+  #        many: "Contacts"
+  # this func automatically grabs the item labeled :one
+  # if :one is not available, then the first available translation will be returned
+  # ex from above:
+  # I18n.tnp_single('contact')  ==> returns "Contact"
+  def self.tnp_single(p_token)
+    l_translate =  t(p_token)
+    if l_translate.is_a?(Hash)
+      l_translate = l_translate[:one]||l_translate.first[1]
+    end
+    l_translate
+  end
+
+
+  #take elements from the translation file and make into an array
+  #if :count is passed, it will attempt to find the plural value from the translation file
+  #plural example:
+  #en.yml snippet:
+  # investor_statuses:
+  #   client:
+  #     one: "Client"
+  #     many: "Clients"
+  #   prospect:
+  #     one: "Prospect"
+  #      many: "Prospects"
+  #   cold:
+  #     one: "Cold"
+  #     many: "Cold Names"
+  #  I18n.array_it('investor_statuses', count: :many) ==>
+  #         returns ==> ["Clients", "Prospects", "Cold Names"]
+  #
+  # Example 2: Simple no plural terms
+  #    gender:
+  #      male: "Male"
+  #      female: "Female"
+  #   I18n.array_it('gender') ==>   ["Male", "Female"]
+  #
+  def self.array_it(p_token, options = {})
+    options.assert_valid_keys(:count)
+    l_translate = options[:count] ? plural_hash_it(p_token, options) : t(p_token)
+
+    if l_translate.is_a?(Hash)
+      l_return = []
+      l_translate.each do |p_key, p_val|
+        l_return << p_val
+      end
+    else
+      l_return = Array(l_translate)
+    end
+    l_return
+  end
+
+  #take elements from the translation file and make into an array
+  def self.plural_hash_it(p_token, options = {})
+    options.assert_valid_keys(:count)
+    l_count = options[:count] || :one
+    l_translate = t(p_token)
+    if l_translate.is_a?(Hash)
+      l_return = {}
+      l_translate.each do |l_key, l_val|
+        if l_val.is_a?(Hash)
+          l_return.merge!(l_key => l_val[l_count.to_sym]||"Not Found")
+       else
+         l_return.merge!(l_key => l_val)
+        end
+      end
+    else
+      l_return = l_translate
+    end
+    l_return
+  end
+
+
+end

data/lib/marskal/core/extensions/numeric.rb

@@ -0,0 +1,11 @@
+# include  ActionView::Helpers::NumberHelper
+#
+# class Numeric
+#   def to_currency(options={})
+#     number_to_currency(self, options)
+#   end
+#
+#   def to_pct(options={})
+#     number_to_percentage(self, options)
+#   end
+# end

data/lib/marskal/core/extensions/string.rb

@@ -0,0 +1,108 @@
+class String
+
+  def replace_eol(p_str = ' ')
+    self.gsub(/(\r)?\n/, p_str)
+  end
+
+  def unquote
+    self.gsub("'","").gsub('"', '')
+  end
+
+  def to_object
+    self.singularize.classify.constantize
+  end
+
+  def is_valid_email?
+    ret = self =~ /\A[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4}\z/
+    return ret.nil? ? false : true
+  end
+
+  def escape_single_quotes
+    self.gsub(/'/, "\\\\'")
+    return self
+  end
+  #check if nil or empty
+  def self.nil_or_e?(p_string)
+    (p_string.nil? or p_string == "")
+  end
+
+  #set to nil if empty
+  def self.nil_to_e(p_string)
+    p_string.nil? ? "" : p_string
+  end
+
+  def currency_to_f(options={})
+    self.tr_s('$','').tr_s(',','').to_f
+  end
+
+  def to_currency(options={})
+    l_fnum = self.currency_to_f  #convert back to number and then reformat
+    l_fnum.to_currency(options)
+  end
+
+  def to_valid_date(options={})
+    value = self
+    return if value.blank?
+    return value if value.is_a?(Date)
+    return value.to_date if value.is_a?(Time) || value.is_a?(DateTime)
+
+    us_date_format = options[:european_format] ? false : true
+
+    year, month, day = case value.strip
+                         # 22/1/06, 22\1\06 or 22.1.06
+                         when /\A(\d{1,2})[\\\/\.-](\d{1,2})[\\\/\.-](\d{2}|\d{4})\Z/
+                           us_date_format ? [$3, $1, $2] : [$3, $2, $1]
+                         # 22 Feb 06 or 1 jun 2001
+                         when /\A(\d{1,2}) (\w{3,9}) (\d{2}|\d{4})\Z/
+                           [$3, $2, $1]
+                         # July 1 2005
+                         when /\A(\w{3,9}) (\d{1,2})\,? (\d{2}|\d{4})\Z/
+                           [$3, $1, $2]
+                         # 2006-01-01
+                         when /\A(\d{4})-(\d{2})-(\d{2})\Z/
+                           [$1, $2, $3]
+                         # 2006-01-01T10:10:10+13:00
+                         when /\A(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})\Z/
+                           [$1, $2, $3]
+                         # Not a valid date string
+                         else
+                           return nil
+                       end
+
+    #do best to make year a legit 4 character year
+    year = "#{year.to_i < 20 ? '20' : '19'}#{year.to_i}" if (year.length == 2 or (year.length > 2 && year.slice(0..1) == "00"))
+
+    Date.new(year.to_i, month.to_i, day.to_i) rescue nil
+  end
+
+  def nameize
+    if self.match(/ /)
+      # If the name has a space in it, we gotta run the parts through the nameizer.
+      name = self.split(' ').each { |part| part.nameize! }.join(' ')
+      return name
+      #elsif self.match(/^[A-Z]/)  --removed by Mike Urban 06/09 because we want to process even if name is capitalized
+      # If they took the time to capitalize their name then let's just jump out.
+      #return self
+    else
+      # If there are no spaces and there is no prior capitalization then let's downcase the whole thing.
+      name = self.downcase
+    end
+    # Let's now assume that they were lazy...
+    return case
+             when name.match(/^mac/i)
+               name.gsub(/^mac/i, "").capitalize.insert(0, "Mac")
+             when name.match(/^mc/i)
+               name.gsub(/^mc/i, "").capitalize.insert(0, "Mc")
+             when name.match(/^o\'/i)
+               name.split("'").each{ |piece| piece.capitalize! }.join("'")
+             else
+               name.capitalize # Basically if the name is a first name or it's not Irish then capitalize it.
+           end
+  end
+
+  def nameize!
+    replace nameize # BANG!
+  end
+
+
+end

data/lib/marskal/core/extensions/version.rb

@@ -0,0 +1,7 @@
+module Marskal
+  module Core
+    module Extensions
+      VERSION = "0.0.3"
+    end
+  end
+end

data/marskal-core-extensions.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'marskal/core/extensions/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "marskal-core-extensions"
+  spec.version       = Marskal::Core::Extensions::VERSION
+  spec.authors       = ["Mike Urban"]
+  spec.email         = ["mike@marskalgroup.com"]
+  spec.summary       = %q{Many handy uitilities to extend Ruby on Rails core functionality}
+  spec.description   = %q{Extends modules/classes such as Array, String, Numeric, Date, I18n and more}
+  spec.homepage      = "http://www.marskalgroup.com"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  # spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  # spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", "~> 0"
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: marskal-core-extensions
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- Mike Urban
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Extends modules/classes such as Array, String, Numeric, Date, I18n and
+  more
+email:
+- mike@marskalgroup.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/marskal/core/extensions.rb
+- lib/marskal/core/extensions/array.rb
+- lib/marskal/core/extensions/date.rb
+- lib/marskal/core/extensions/i18n.rb
+- lib/marskal/core/extensions/numeric.rb
+- lib/marskal/core/extensions/string.rb
+- lib/marskal/core/extensions/version.rb
+- marskal-core-extensions.gemspec
+homepage: http://www.marskalgroup.com
+licenses:
+- MIT
+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.2.2
+signing_key: 
+specification_version: 4
+summary: Many handy uitilities to extend Ruby on Rails core functionality
+test_files: []