interage-helper 0.1.0

data/lib/interage/application_icon_helper.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Interage
+  module ApplicationIconHelper
+    DEFAULT_FONT_ICON = ENV.fetch('DEFAULT_FONT_ICON', 'fa')
+
+    def app_icon(icon, options = {})
+      case DEFAULT_FONT_ICON
+      when 'fa'
+        fa_icon(icon, options)
+      when 'md'
+        md_icon(icon, options)
+      end
+    end
+
+    def app_icon_text(icon, text, options = {})
+      case DEFAULT_FONT_ICON
+      when 'fa'
+        fa_icon_text(icon, text, options)
+      when 'md'
+        md_icon_text(icon, text, options)
+      end
+    end
+
+    def app_icon_classes(icon, prefix, separator, options = {})
+      icon_classes = icon.to_s.split(' ').uniq.join(" #{separator}-")
+
+      "#{prefix} #{separator}-#{icon_classes} #{options[:class]}".strip
+    end
+  end
+end

data/lib/interage/bootstrap_helper.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Interage
+  module BootstrapHelper
+    def bootstrap_alert(type, message)
+      content_tag(:div, message, class: "no-margin alert alert-#{type}")
+    end
+
+    def bootstrap_alert_default(message)
+      bootstrap_alert(:default, message)
+    end
+
+    def bootstrap_alert_info(message)
+      bootstrap_alert(:info, message)
+    end
+
+    def bootstrap_alert_warning(message)
+      bootstrap_alert(:warning, message)
+    end
+
+    def bootstrap_alert_success(message)
+      bootstrap_alert(:success, message)
+    end
+
+    def bootstrap_alert_danger(message)
+      bootstrap_alert(:danger, message)
+    end
+
+    def bootstrap_alert_not_found(gender, model)
+      bootstrap_alert_info(text_not_found(gender, model))
+    end
+
+    def bootstrap_alert_not_found_male(model)
+      bootstrap_alert_not_found(:male, model)
+    end
+
+    def bootstrap_alert_not_found_female(model)
+      bootstrap_alert_not_found(:female, model)
+    end
+
+    def text_not_found(gender, model)
+      t("index.model.#{gender}.not_found", model: tm(model).downcase)
+    end
+
+    def text_not_found_male(model)
+      text_not_found(:male, model)
+    end
+
+    def text_not_found_female(model)
+      text_not_found(:female, model)
+    end
+  end
+end

data/lib/interage/cep_helper.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Interage
+  module CEPHelper
+    def format_cep(cep)
+      return if cep.blank?
+
+      "#{cep[0, 5]}-#{cep[5, 3]}".strip
+    end
+  end
+end

data/lib/interage/cocoon_helper.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Interage
+  module CocoonHelper
+    DEFAULT_BTN_CLASS = 'btn btn-sm btn-outline-'
+
+    def cocoon_link_to_add_association(form, association, options = {})
+      label = options[:label] || t('buttons.cocoon.add.text')
+      html_class = options[:html_class] || cocoon_default_btn_class('success')
+
+      link_to_add_association(form, association, class: html_class) do
+        app_icon_text(t('buttons.cocoon.add.icon'), label)
+      end
+    end
+
+    def cocoon_link_to_remove_association(form, label = nil)
+      label ||= t('buttons.cocoon.remove.text')
+      html_class = cocoon_default_btn_class('danger')
+
+      content_tag :div, class: 'cocoon-link-to-remove' do
+        link_to_remove_association(form, class: html_class, title: label) do
+          app_icon_text(t('buttons.cocoon.remove.icon'), label)
+        end
+      end
+    end
+
+    def cocoon_default_btn_class(type)
+      "#{DEFAULT_BTN_CLASS}#{type} text-truncate"
+    end
+  end
+end

data/lib/interage/controller_active_helper.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Interage
+  module ControllerActiveHelper
+    HTML_ACTIVE_CLASS = 'active'
+
+    def menu_active(*controllers)
+      HTML_ACTIVE_CLASS if current_controller?(*controllers)
+    end
+
+    def current_controller?(*controllers)
+      controllers = controllers.is_a?(Array) ? controllers : [controllers]
+
+      controllers.include?(params[:controller])
+    end
+  end
+end

data/lib/interage/cpf_cnpj_helper.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Interage
+  module CPFCNPJHelper
+    def format_cnpj(cnpj)
+      return if cnpj.blank?
+
+      cnpj.to_s.gsub!(/[^0-9]/, '')
+
+      formatted_cnpj = ["#{cnpj[0, 2]}.#{cnpj[2, 3]}.#{cnpj[5, 3]}",
+                        "#{cnpj[8, 4]}-#{cnpj[12, 2]}"]
+      formatted_cnpj.join('/').strip
+    end
+
+    def format_cpf(cpf)
+      return if cpf.blank?
+
+      cpf.to_s.gsub!(/[^0-9]/, '')
+
+      "#{cpf[0, 3]}.#{cpf[3, 3]}.#{cpf[6, 3]}-#{cpf[9, 2]}".strip
+    end
+  end
+end

data/lib/interage/date_time_helper.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Interage
+  module DateTimeHelper
+    def business_days_from_now(days = 2)
+      date = days.to_i.business_days.from_now.to_date
+
+      return l(date) if business_day?(date)
+
+      business_days_from_now(days + 1)
+    end
+
+    def business_day?(date)
+      Holidays.on(date, :br).empty? && date.to_date.workday?
+    end
+
+    def format_date(date, date_format = :date_time)
+      l(date, format: date_format)
+    end
+
+    def format_time(time)
+      return if time.blank?
+
+      time.strftime('%H:%M')
+    end
+  end
+end

data/lib/interage/favicon_helper.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Interage
+  module FaviconHelper
+    EXTENTION = 'png'
+    FILE_NAME = 'icons/apple-touch-icon'
+    FAVICON_SIZES = [nil, 57, 72, 76, 114, 120, 144, 152, 180].freeze
+
+    def favicon_link_tags
+      safe_join favicon_size_link_tags.push(favicon_link_tag)
+    end
+
+    def favicon_size_link_tags
+      FAVICON_SIZES.map do |s|
+        favicon_link_tag(handler_name(s), favicon_options(s))
+      end
+    end
+
+    def handler_name(size)
+      "#{FILE_NAME}#{handler_size(size, '-')}.#{EXTENTION}"
+    end
+
+    def favicon_options(size)
+      { type: 'image/png', rel: 'apple-touch-icon', sizes: handler_size(size) }
+    end
+
+    def handler_size(size, prefix = '')
+      "#{prefix}#{size}x#{size}" if size.present?
+    end
+  end
+end

data/lib/interage/flash_message_helper.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Interage
+  module FlashMessageHelper
+    def flash_messages
+      messages ||= flashes.map do |type, message|
+        bootstrap_alert(handle_type(type), message)
+      end
+
+      safe_join(messages || [])
+    end
+
+    def flashes
+      flash.to_h.symbolize_keys
+    end
+
+    def handle_type(type)
+      type == :notice ? :success : type
+    end
+  end
+end

data/lib/interage/font_awesome_helper.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Interage
+  module FontAwesomeHelper
+    def fa_icons
+      t('icons_alias', default: {}).keys
+    end
+
+    def fa_icon(icon, options = {})
+      content_tag :i, nil, options.merge(class: fa_classes(icon, options))
+    end
+
+    def fa_fw_icon(icon, options = {})
+      fa_icon("fw #{icon}", options)
+    end
+
+    def fa_icon_text(icon, text, options = {})
+      content_tag :span do
+        concat fa_fw_icon(icon, options)
+        concat text
+      end
+    end
+
+    def fa_classes(icon, options = {})
+      icon_classes = icon.to_s.split(' ').uniq.join(' fa-')
+
+      "fa fa-#{icon_classes} #{options[:class]}".strip
+    end
+  end
+end

data/lib/interage/gravatar_helper.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Interage
+  module GravatarHelper
+    BASE_URL = 'https://www.gravatar.com/avatar'
+
+    def gravatar_image_tag(email, size = 50, options = {})
+      hexdigest = Digest::MD5.hexdigest(email)
+
+      image_tag("#{BASE_URL}/#{hexdigest}?size=#{size}", options)
+    end
+  end
+end

data/lib/interage/helper/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Interage
+  module Helper
+    VERSION = '0.1.0'
+  end
+end

data/lib/interage/helper.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'interage/helper/version'
+require 'active_support/core_ext/module'
+
+module Interage
+  module Helper
+    class Error < StandardError
+    end
+  end
+
+  autoload :ApplicationHelper, 'interage/application_helper'
+  autoload :ApplicationIconHelper, 'interage/application_icon_helper'
+  autoload :BootstrapHelper, 'interage/bootstrap_helper'
+  autoload :CEPHelper, 'interage/cep_helper'
+  autoload :CocoonHelper, 'interage/cocoon_helper'
+  autoload :ControllerActiveHelper, 'interage/controller_active_helper'
+  autoload :CPFCNPJHelper, 'interage/cpf_cnpj_helper'
+  autoload :DateTimeHelper, 'interage/date_time_helper'
+  autoload :FaviconHelper, 'interage/favicon_helper'
+  autoload :FlashMessageHelper, 'interage/flash_message_helper'
+  autoload :FontAwesomeHelper, 'interage/font_awesome_helper'
+  autoload :GravatarHelper, 'interage/gravatar_helper'
+  autoload :LinkToHelper, 'interage/link_to_helper'
+  autoload :MaterialDesignIconsHelper, 'interage/material_design_icons_helper'
+  autoload :NumberHelper, 'interage/number_helper'
+  autoload :PaginationHelper, 'interage/pagination_helper'
+  autoload :PhoneHelper, 'interage/phone_helper'
+  autoload :TextHelper, 'interage/text_helper'
+  autoload :TranslationHelper, 'interage/translation_helper'
+  autoload :VersionHelper, 'interage/version_helper'
+end

data/lib/interage/link_to_helper.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Interage
+  module LinkToHelper
+    ASIDE_DEFAULT_CLASS = 'list-group-item'
+    DESTROY_CONFIRM_MESSAGE = 'Tem certeza que deseja apagar?'
+    PREFIX_BUTTON_CLASS = 'btn btn-sm btn-outline-'
+
+    def aside_link_to(text, url = '#', html_options = {})
+      html_options[:class] = "#{ASIDE_DEFAULT_CLASS} #{html_options[:class]}"
+      html_options[:title] = strip_tags(text)
+
+      link_to text, url, html_options
+    end
+
+    def link_to_modal(text, url = '#', html_options = {})
+      link_to text, url, html_options.merge('data-toggle': 'modal')
+    end
+
+    def link_to_new(resource, url)
+      text = t('menu.links.new', model: tm(resource).downcase)
+
+      link_to url, title: strip_tags(text), class: 'btn btn-outline-primary' do
+        app_icon_text(t('menu.icons.new'), text)
+      end
+    end
+
+    def link_to_edit(url)
+      link_to_default(:edit, url, class: button_class('info'))
+    end
+
+    def link_to_back(url)
+      link_to_default(:back, url, class: button_class('secondary'))
+    end
+
+    def link_to_show(url)
+      link_to_default(:show, url, class: button_class('dark'))
+    end
+
+    def link_to_destroy(url, html_options = {})
+      html_options.merge!(method: :delete,
+                          'data-confirm' => DESTROY_CONFIRM_MESSAGE,
+                          class: button_class('danger', html_options[:class]))
+
+      link_to_default(:destroy, url, html_options)
+    end
+
+    def link_to_default(type, url, html_options = {})
+      text = t("menu.links.#{type}")
+      html_options = html_options.merge(title: strip_tags(text),
+                                        data: { tooltip: 'top' })
+
+      link_to(app_icon_text(t("menu.icons.#{type}"), text), url, html_options)
+    end
+
+    def button_class(type, addicional_class = nil)
+      "#{PREFIX_BUTTON_CLASS}#{type} #{addicional_class}"
+    end
+  end
+end

data/lib/interage/material_design_icons_helper.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Interage
+  module MaterialDesignIconsHelper
+    def md_icon(icon, options = {})
+      icon_classes = icon.to_s.split(' ')
+      icon = icon_classes.shift
+
+      content_tag :i, class: md_classes(icon, options) do
+        t("icons_alias.#{icon}", default: icon)
+      end
+    end
+
+    def md_icon_text(icon, text, options = {})
+      content_tag :span do
+        concat md_icon(icon, options)
+        concat " #{text}"
+      end
+    end
+
+    def md_classes(icon, options = {})
+      app_icon_classes(icon, 'material-icons', 'md', options)
+    end
+  end
+end

data/lib/interage/number_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Interage
+  module NumberHelper
+    def default_currency_format(number, precision = 2, unit = 'R$')
+      number_to_currency(number, precision: precision, unit: unit)
+    end
+  end
+end

data/lib/interage/pagination_helper.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Interage
+  module PaginationHelper
+    def pagination_links(collection)
+      return if collection.empty?
+
+      render 'kaminari/pagination', collection: collection
+    end
+  end
+end

data/lib/interage/phone_helper.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Interage
+  module PhoneHelper
+    def format_phone(phone)
+      return if phone.blank?
+
+      phone.to_s.gsub!(/[^0-9]/, '')
+
+      "(#{phone[0, 2]}) #{phone[3, 5]}-#{phone[8, 4]}".strip
+    end
+  end
+end

data/lib/interage/text_helper.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Interage
+  module TextHelper
+    def nl2br(string, options = {})
+      out = string.split("\n").map do |str|
+        content_tag :div, str, options
+      end
+
+      safe_join out
+    end
+  end
+end

data/lib/interage/translation_helper.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+module Interage
+  module TranslationHelper
+    ##
+    # Public: Translate a model name.
+    #
+    # model: Model class.
+    # count: Count.
+    #
+    # Examples:
+    #
+    #   <%= tm Post %>
+    #   # => 'Artigo'
+    #
+    #   <%= tm Post, 2 %>
+    #   # => 'Artigos'
+    #
+    # Returns translated model.
+    def translate_model_name(model, count = 1)
+      model.model_name.human(count: count)
+    end
+    alias tm translate_model_name
+
+    ##
+    # Public: Translate a model name pluralized.
+    #
+    # model: Model class.
+    #
+    # Examples:
+    #
+    #   <%= tm Post %>
+    #   # => 'Artigos'
+    #
+    # Returns translated model pluralized.
+    def translate_model_name_pluralized(model)
+      translate_model_name(model, 2)
+    end
+    alias tmp translate_model_name_pluralized
+
+    ##
+    # Public: Translate a model attribute.
+    #
+    # model: Model class.
+    # attribute: Attribute name.
+    # count: Count.
+    #
+    # Examples
+    #
+    #   <%= ta Post, :title %>
+    #   # => 'Titulo'
+    #
+    #   <%= ta Post, :title, 2 %>
+    #   # => 'Titulos'
+    #
+    # Returns translated model's attribute.
+    def translate_model_attribute(model, attribute, count = 1)
+      model.human_attribute_name(attribute, count: count)
+    end
+    alias ta translate_model_attribute
+
+    ##
+    # Public: Translate a boolean attribute.
+    #
+    # value: TrueClass or FalseClass.
+    #
+    # Examples
+    #
+    #   <%= tb true %>
+    #   # => 'Sim'
+    #
+    #   <%= tb false %>
+    #   # => 'Nao'
+    #
+    # Returns translated boolean's attribute.
+    def translate_boolean(value)
+      value ? t('boolean.truly') : t('boolean.falsely')
+    end
+    alias tb translate_boolean
+
+    ##
+    # Public: Translate a boolean attribute in an icon.
+    #
+    # value: TrueClass or FalseClass.
+    #
+    # Examples
+    #
+    #   <%= tbi true %>
+    #   # => '<i class="fa fa-check text-success"></i>'
+    #
+    #   <%= tbi false %>
+    #   # => '<i class="fa fa-times text-danger"></i>'
+    #
+    # Returns translated boolean's attribute in an icon.
+    def translate_boolean_in_icon(value)
+      if value
+        content_tag(:span, '✓', class: 'text-success')
+      else
+        content_tag(:span, '×', class: 'text-danger')
+      end
+    end
+    alias tbi translate_boolean_in_icon
+
+    ##
+    # Public: Translate a boolean attribute in an icon.
+    #
+    # value: TrueClass or FalseClass.
+    #
+    # Examples
+    #
+    #   <%= tbci true %>
+    #   # => '<i class="fa fa-check-square-o text-default"></i>'
+    #
+    #   <%= tbci false %>
+    #   # => '<i class="fa fa-square-o text-default"></i>'
+    #
+    # Returns translated boolean's attribute in an icon.
+    def translate_boolean_in_check_box_icon(value)
+      if value
+        app_icon('check', class: 'text-success')
+      else
+        app_icon('times', class: 'text-danger')
+      end
+    end
+    alias tbci translate_boolean_in_check_box_icon
+  end
+end

data/lib/interage/version_helper.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Interage
+  module VersionHelper
+    def app_version
+      return if app_text_version.blank?
+
+      content_tag :div, app_text_version, id: 'app-version'
+    end
+
+    def app_text_version
+      return unless file_version_exist?
+
+      "#{app_name} - v#{File.read('VERSION').strip}"
+    end
+
+    def file_version_exist?
+      File.exist?('VERSION')
+    end
+  end
+end