andy_rails_toolbox 0.0.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 120a92a50a191621331449e7f779afcb0bc67d38
-  data.tar.gz: dac79330b4875b74e501f6ebee1a258758cc1709
+  metadata.gz: 1f80bf87e2fb9ba3f445312d86e45efe5c892a68
+  data.tar.gz: 116cd8015e92c1cddb2cae0492c5ea1ad22d694e
 SHA512:
-  metadata.gz: a15d10ef381fb4d59768cefb34282dc0c59c981f643aca2e357597e565623dd2e09d47a0156a60ff76f6a5e8bb6dfa4348626a9af9f80590c2a2b04c28b229c4
-  data.tar.gz: 3d23113ba6aa8cd6b8cc7bb69cab91d327fe8e44c6b197ae414c54410c830e73350403a6c1fc7e396c0164bbd34c96a7d43a1b8882718c170f99404faa84f59c
+  metadata.gz: 55612b107b794647de97be8b31cdd648ab96c360a1d150d390f2f208c021fa765d4e40a7dfa3b8874d167b3a6b96dfb4281fa203da168fc10b55cf842b449cd0
+  data.tar.gz: d3ac2b27b5f8d49df9497957fc0c782c74904c75f6df0ee641d21bf1e49e207a6f2e787072172285984f0c4ca7555ab4c7a37c27f0a65e21b28870ffc5564aa2

data/{LICENSE.txt → MIT-LICENSE}

@@ -1,6 +1,4 @@
-Copyright (c) 2015 ChouAndy
-
-MIT License
+Copyright 2015 ChouAndy
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -20,7 +20,184 @@ Or install it yourself as:
 
 ## Usage
 
-Building...
+#### BootstrapHelper
+
+Bootstrap Homepage: <a href="http://getbootstrap.com/" target="_blank">http://getbootstrap.com/</a>
+
+
+Add below codes to layout `app/views/layout/application.html.erb`
+
+``` erb
+...
+<%= stylesheet_link_tag '//maxcdn.bootstrapcdn.com/bootstrap/3.3.1/css/bootstrap.min.css' %>
+...
+<%= javascript_include_tag '//maxcdn.bootstrapcdn.com/bootstrap/3.3.1/js/bootstrap.min.js' %>
+...
+```
+
+Examples
+
+ICONS
+
+``` rb
+bs_icon 'user'
+# => <span class="glyphicon glyphicon-user"></span>
+```
+
+BUTTONS
+
+``` rb
+html_button 'button'
+# => <button name="button" type="button" class="btn btn-default">button</button>
+html_button 'button', color: 'primary'
+# => <button name="button" type="button" class="btn btn-primary">button</button>
+html_button 'button', size: 'sm'
+# => <button name="button" type="button" class="btn btn-default btn-sm">button</button>
+html_button 'button', block: true
+# => <button name="button" type="button" class="btn btn-default btn-block">button</button>
+html_button 'button', icon: 'user'
+# => <button name="button" type="button" class="btn btn-default"><i class="fa fa-user"></i> button</button>
+html_button 'button', active: true
+# => <button name="button" type="button" class="btn btn-default active">button</button>
+submit_button 'submit'
+# => <button type="submit" class="btn btn-default">submit</button>
+reset_button 'reset'
+# => <button type="reset" class="btn btn-default">reset</button>
+link_button 'link', url: root_path
+# => <a class="btn btn-default" role="button" href="/">link</a>
+input_button 'input button'
+# => <input class="btn btn-default" value="input button" type="button" />
+input_submit 'input button'
+# => <input type="submit" name="commit" value="input button" class="btn btn-default" />
+```
+
+IMAGES
+
+``` rb
+image_responsive 'pic.png'
+# => <img class="img-responsive" src="/images/pic.png" alt="Pic" />
+image_rounded 'pic.png'
+# => <img class="img-rounded" src="/images/pic.png" alt="Pic" />
+image_circle 'pic.png'
+# => <img class="img-circle" src="/images/pic.png" alt="Pic" />
+image_thumbnail 'pic.png'
+# => <img class="img-thumbnail" src="/images/pic.png" alt="Pic" />
+```
+
+#### MarkdownHelper
+
+New a css erb file `app/assets/stylesheets/pygments.css.erb` for pygments color style
+
+``` erb
+<%= Pygments.css(style: "igor") %>
+```
+
+All styles:
+
+``` sh
+$ rails c
+# => Loading development environment (Rails 4.2.0)
+irb(main):001:0> require 'pygments.rb'
+# => true
+irb(main):002:0> Pygments.styles
+# => ["manni", "igor", "xcode", "vim", "autumn", "vs", "rrt", "native", "perldoc", "borland", "tango", "emacs", "friendly", "monokai", "paraiso-dark", "colorful", "murphy", "bw", "pastie", "paraiso-light", "trac", "default", "fruity"]
+```
+
+Examples
+
+``` rb
+markdown '# h1'
+# => <h1>h1</h1>
+markdown '## h2'
+# => <h2>h2</h2>
+markdown '[an example](http://example.com/)'
+# => <p><a href="http://example.com/">an example</a></p>
+markdown @post.content
+# => transform markdown code to html codes and payments highlighter
+```
+
+#### QrcodeHelper Examples
+
+``` rb
+qrcode 'Hello world!'
+```
+
+<img alt="Hello world!" src="https://chart.googleapis.com/chart?cht=qr&amp;chl=Hello world!&amp;chs=200x200" />
+
+QRCode options parameters: <a href="https://google-developers.appspot.com/chart/infographics/docs/qr_codes#overview" target="_blank">Here</a>
+
+``` rb
+qrcode 'Hello world!', width: '300', output_encoding: 'Shift_JIS', error_correction_level: 'H', margin: '10'
+```
+
+#### FontAwesomeHelper
+
+Font Awesome icons Homepage: <a href="http://fortawesome.github.io/Font-Awesome/" target="_blank">http://fortawesome.github.io/Font-Awesome/</a>
+
+Add below codes to layout `app/views/layout/application.html.erb`
+
+``` erb
+...
+<%= stylesheet_link_tag '//maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css' %>
+...
+```
+
+Examples
+
+``` rb
+fa_icon "user"
+# => <i class="fa fa-user"></i>
+
+fa_icon "user", text: "Login"
+# => <i class="fa fa-user"></i> Login
+
+fa_icon "user", text: "Login", right: true
+# => Login <i class="fa fa-user"></i>
+
+fa_icon "user 4x"
+# => <i class="fa fa-user fa-4x"></i>
+```
+
+#### HashHelper Examples
+
+``` rb
+options = { a: '1', b: '2', c: '3' }
+
+get_value :a, options
+# => '1'
+get_value :d, options
+# => nil
+get_value :d, options, '4'
+# => '4'
+
+pop_value :a, options
+# => '1'
+# options = { b: '2', c: '3' }
+pop_value :d, options
+# => nil
+pop_value :d, options, '4'
+# => '4'
+# options = { a: '1', b: '2', c: '3' }
+```
+
+#### TimeagoHelper
+
+Add below codes to file `app/assets/javascripts/application.js`
+
+``` js
+...
+//= require jquery.timeago
+//= require jquery.timeago.zh-TW
+//= require jquery.timeago.load
+...
+```
+
+Use in View
+
+``` rb
+timeago '2014-11-21 09:38:27.256503'
+# => '2個月之前'
+```
 
 ## Contributing
 

data/Rakefile

@@ -1,2 +1,23 @@
-require "bundler/gem_tasks"
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'AndyRailsToolbox'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+
+
+
+
+
+Bundler::GemHelper.install_tasks
 

data/app/assets/javascripts/jquery.timeago.js

@@ -0,0 +1,214 @@
+/**
+ * Timeago is a jQuery plugin that makes it easy to support automatically
+ * updating fuzzy timestamps (e.g. "4 minutes ago" or "about 1 day ago").
+ *
+ * @name timeago
+ * @version 1.4.1
+ * @requires jQuery v1.2.3+
+ * @author Ryan McGeary
+ * @license MIT License - http://www.opensource.org/licenses/mit-license.php
+ *
+ * For usage and examples, visit:
+ * http://timeago.yarp.com/
+ *
+ * Copyright (c) 2008-2013, Ryan McGeary (ryan -[at]- mcgeary [*dot*] org)
+ */
+
+(function (factory) {
+  if (typeof define === 'function' && define.amd) {
+    // AMD. Register as an anonymous module.
+    define(['jquery'], factory);
+  } else {
+    // Browser globals
+    factory(jQuery);
+  }
+}(function ($) {
+  $.timeago = function(timestamp) {
+    if (timestamp instanceof Date) {
+      return inWords(timestamp);
+    } else if (typeof timestamp === "string") {
+      return inWords($.timeago.parse(timestamp));
+    } else if (typeof timestamp === "number") {
+      return inWords(new Date(timestamp));
+    } else {
+      return inWords($.timeago.datetime(timestamp));
+    }
+  };
+  var $t = $.timeago;
+
+  $.extend($.timeago, {
+    settings: {
+      refreshMillis: 60000,
+      allowPast: true,
+      allowFuture: false,
+      localeTitle: false,
+      cutoff: 0,
+      strings: {
+        prefixAgo: null,
+        prefixFromNow: null,
+        suffixAgo: "ago",
+        suffixFromNow: "from now",
+        inPast: 'any moment now',
+        seconds: "less than a minute",
+        minute: "about a minute",
+        minutes: "%d minutes",
+        hour: "about an hour",
+        hours: "about %d hours",
+        day: "a day",
+        days: "%d days",
+        month: "about a month",
+        months: "%d months",
+        year: "about a year",
+        years: "%d years",
+        wordSeparator: " ",
+        numbers: []
+      }
+    },
+
+    inWords: function(distanceMillis) {
+      if(!this.settings.allowPast && ! this.settings.allowFuture) {
+          throw 'timeago allowPast and allowFuture settings can not both be set to false.';
+      }
+
+      var $l = this.settings.strings;
+      var prefix = $l.prefixAgo;
+      var suffix = $l.suffixAgo;
+      if (this.settings.allowFuture) {
+        if (distanceMillis < 0) {
+          prefix = $l.prefixFromNow;
+          suffix = $l.suffixFromNow;
+        }
+      }
+
+      if(!this.settings.allowPast && distanceMillis >= 0) {
+        return this.settings.strings.inPast;
+      }
+
+      var seconds = Math.abs(distanceMillis) / 1000;
+      var minutes = seconds / 60;
+      var hours = minutes / 60;
+      var days = hours / 24;
+      var years = days / 365;
+
+      function substitute(stringOrFunction, number) {
+        var string = $.isFunction(stringOrFunction) ? stringOrFunction(number, distanceMillis) : stringOrFunction;
+        var value = ($l.numbers && $l.numbers[number]) || number;
+        return string.replace(/%d/i, value);
+      }
+
+      var words = seconds < 45 && substitute($l.seconds, Math.round(seconds)) ||
+        seconds < 90 && substitute($l.minute, 1) ||
+        minutes < 45 && substitute($l.minutes, Math.round(minutes)) ||
+        minutes < 90 && substitute($l.hour, 1) ||
+        hours < 24 && substitute($l.hours, Math.round(hours)) ||
+        hours < 42 && substitute($l.day, 1) ||
+        days < 30 && substitute($l.days, Math.round(days)) ||
+        days < 45 && substitute($l.month, 1) ||
+        days < 365 && substitute($l.months, Math.round(days / 30)) ||
+        years < 1.5 && substitute($l.year, 1) ||
+        substitute($l.years, Math.round(years));
+
+      var separator = $l.wordSeparator || "";
+      if ($l.wordSeparator === undefined) { separator = " "; }
+      return $.trim([prefix, words, suffix].join(separator));
+    },
+
+    parse: function(iso8601) {
+      var s = $.trim(iso8601);
+      s = s.replace(/\.\d+/,""); // remove milliseconds
+      s = s.replace(/-/,"/").replace(/-/,"/");
+      s = s.replace(/T/," ").replace(/Z/," UTC");
+      s = s.replace(/([\+\-]\d\d)\:?(\d\d)/," $1$2"); // -04:00 -> -0400
+      s = s.replace(/([\+\-]\d\d)$/," $100"); // +09 -> +0900
+      return new Date(s);
+    },
+    datetime: function(elem) {
+      var iso8601 = $t.isTime(elem) ? $(elem).attr("datetime") : $(elem).attr("title");
+      return $t.parse(iso8601);
+    },
+    isTime: function(elem) {
+      // jQuery's `is()` doesn't play well with HTML5 in IE
+      return $(elem).get(0).tagName.toLowerCase() === "time"; // $(elem).is("time");
+    }
+  });
+
+  // functions that can be called via $(el).timeago('action')
+  // init is default when no action is given
+  // functions are called with context of a single element
+  var functions = {
+    init: function(){
+      var refresh_el = $.proxy(refresh, this);
+      refresh_el();
+      var $s = $t.settings;
+      if ($s.refreshMillis > 0) {
+        this._timeagoInterval = setInterval(refresh_el, $s.refreshMillis);
+      }
+    },
+    update: function(time){
+      var parsedTime = $t.parse(time);
+      $(this).data('timeago', { datetime: parsedTime });
+      if($t.settings.localeTitle) $(this).attr("title", parsedTime.toLocaleString());
+      refresh.apply(this);
+    },
+    updateFromDOM: function(){
+      $(this).data('timeago', { datetime: $t.parse( $t.isTime(this) ? $(this).attr("datetime") : $(this).attr("title") ) });
+      refresh.apply(this);
+    },
+    dispose: function () {
+      if (this._timeagoInterval) {
+        window.clearInterval(this._timeagoInterval);
+        this._timeagoInterval = null;
+      }
+    }
+  };
+
+  $.fn.timeago = function(action, options) {
+    var fn = action ? functions[action] : functions.init;
+    if(!fn){
+      throw new Error("Unknown function name '"+ action +"' for timeago");
+    }
+    // each over objects here and call the requested function
+    this.each(function(){
+      fn.call(this, options);
+    });
+    return this;
+  };
+
+  function refresh() {
+    var data = prepareData(this);
+    var $s = $t.settings;
+
+    if (!isNaN(data.datetime)) {
+      if ( $s.cutoff == 0 || Math.abs(distance(data.datetime)) < $s.cutoff) {
+        $(this).text(inWords(data.datetime));
+      }
+    }
+    return this;
+  }
+
+  function prepareData(element) {
+    element = $(element);
+    if (!element.data("timeago")) {
+      element.data("timeago", { datetime: $t.datetime(element) });
+      var text = $.trim(element.text());
+      if ($t.settings.localeTitle) {
+        element.attr("title", element.data('timeago').datetime.toLocaleString());
+      } else if (text.length > 0 && !($t.isTime(element) && element.attr("title"))) {
+        element.attr("title", text);
+      }
+    }
+    return element.data("timeago");
+  }
+
+  function inWords(date) {
+    return $t.inWords(distance(date));
+  }
+
+  function distance(date) {
+    return (new Date().getTime() - date.getTime());
+  }
+
+  // fix for IE6 suckage
+  document.createElement("abbr");
+  document.createElement("time");
+}));

data/app/assets/javascripts/jquery.timeago.load.coffee

@@ -0,0 +1,3 @@
+$ ->
+  # timeago
+  $('abbr.timeago').timeago();

data/app/assets/javascripts/jquery.timeago.zh-TW.js

@@ -0,0 +1,20 @@
+// Traditional Chinese, zh-tw
+jQuery.timeago.settings.strings = {
+  prefixAgo: null,
+  prefixFromNow: "從現在開始",
+  suffixAgo: "之前",
+  suffixFromNow: null,
+  seconds: "不到1分鐘",
+  minute: "大約1分鐘",
+  minutes: "%d分鐘",
+  hour: "大約1小時",
+  hours: "%d小時",
+  day: "大約1天",
+  days: "%d天",
+  month: "大約1個月",
+  months: "%d個月",
+  year: "大約1年",
+  years: "%d年",
+  numbers: [],
+  wordSeparator: ""
+};

data/app/helpers/bootstrap_helper.rb

@@ -0,0 +1,211 @@
+module BootstrapHelper
+  #############
+  ### ICONS ###
+  #############
+
+  # Generates an icon.
+  def bs_icon(icon, options = {})
+    icon = %(glyphicon glyphicon-#{icon})
+    add_css_class icon, options
+    tag = pop_value :tag, options, :span
+    content_tag tag, '', options
+  end
+
+  ###############
+  ### BUTTONS ###
+  ###############
+
+  # Generates a button.
+  def button(label = 'Button', options = {})
+    html_button label, options
+  end
+
+  # Generates a html submit button.
+  def html_button(label = 'Button', options = {})
+    btn :html_button, label, options
+  end
+
+  # Generates a submit button.
+  def submit_button(label = 'Submit', options = {})
+    btn :submit_button, label, options
+  end
+
+  # Generates a reset button.
+  def reset_button(label = 'Reset', options = {})
+    btn :reset_button, label, options
+  end
+
+  # Generates a link submit button.
+  def link_button(label = 'Submit', options = {})
+    btn :link_button, label, options
+  end
+
+  # Generates a input button.
+  def input_button(label = 'Button', options = {})
+    btn :input_button, label, options
+  end
+
+  # Generates a input submit button.
+  def input_submit(label = 'Submit', options = {})
+    btn :input_submit, label, options
+  end
+
+  # Generates a button.
+  def btn(type, label, options = {})
+    add_css_class 'btn', options
+
+    color = pop_value :color, options, 'default'
+    add_css_class(%(btn-#{color}), options) if color
+
+    size = pop_value :size, options
+    add_css_class(%(btn-#{size}), options) if size
+
+    block = pop_value :block, options
+    add_css_class('btn-block', options) if block
+
+    add_active_class options
+
+    icon = pop_value :icon, options
+    unless type.to_s.include? 'input'
+      if icon
+        label = fa_icon(icon) + ' ' + label
+      end
+    end
+
+    create_button type, label, options
+  end
+
+  def create_button(type, label, options)
+    url = pop_value :url, options, '#'
+    case type
+    when :html_button
+      options[:type] = :button unless options[:type]
+      button_tag label, options
+    when :submit_button
+      options[:name] = nil
+      options[:type] = :submit
+      button_tag label, options
+    when :reset_button
+      options[:name] = nil
+      options[:type] = :reset
+      button_tag label, options
+    when :link_button
+      options[:role] = :button
+      link_to label, url, options
+    when :input_button
+      options[:value] = label
+      options[:type] = :button
+      tag 'input', options
+    when :input_submit
+      submit_tag label, options
+    else
+      # type code here
+    end
+  end
+
+  ##############
+  ### IMAGES ###
+  ##############
+
+  # Generates a responsive-friendly image tag
+  def image_responsive(source, options = {})
+    add_css_class 'img-responsive', options
+    image_tag source, options
+  end
+
+  # Generates an image tag with rounded corners.
+  def image_rounded(source, options = {})
+    add_css_class 'img-rounded', options
+    image_tag source, options
+  end
+
+  # Generates an image tag with circle.
+  def image_circle(source, options = {})
+    add_css_class 'img-circle', options
+    image_tag source, options
+  end
+
+  # Generates an image tag within thumbnail.
+  def image_thumbnail(source, options = {})
+    add_css_class 'img-thumbnail', options
+    image_tag source, options
+  end
+
+  #################
+  ### UTILITIES ###
+  #################
+
+  # Appends new class names to the given options.
+  def add_css_class(class_names, options)
+    class_names = class_names.to_s if class_names.is_a? Symbol
+    class_names = class_names.split if class_names.is_a? String
+    if symbolize_keys(options).key? :class
+      options_class_names = options[:class].split
+      class_names.each do |value|
+        options_class_names << %(#{value.strip}) unless options_class_names.include? value
+      end
+      class_names = options_class_names
+    end
+    options[:class] = %(#{class_names * ' '})
+  end
+
+  # Adds the pull class to the given options is applicable.
+  def add_pull_class(options)
+    pull = pop_value :pull, options
+    add_css_class(%(pull-#{pull}), options) if pull
+  end
+
+  # Adds the text align class to the given options if applicable.
+  def add_align_class(options)
+    align = pop_value :align, options
+    add_css_class(%(text-#{align}), options) if align
+  end
+
+  # Adds the text transform class to the given options if applicable.
+  def add_transform_class(options)
+    transform = pop_value :transform, options
+    add_css_class(%(text-#{transform}), options) if transform
+  end
+
+  # Adds the color to the given options if applicable.
+  def add_color_class(options)
+    color = pop_value :color, options
+    add_css_class(%(text-#{color}), options) if color
+  end
+
+  # Adds the bgcolor to the given options if applicable.
+  def add_bgcolor_class(options)
+    bgcolor = pop_value :bgcolor, options
+    add_css_class(%(bg-#{bgcolor}), options) if bgcolor
+  end
+
+  # Adds the active to the given options if applicable.
+  def add_active_class(options)
+    active = pop_value :active, options
+    add_css_class('active', options) if active
+  end
+
+  def normalize_typography_options(options)
+    add_pull_class options
+    add_align_class options
+    add_transform_class options
+    add_color_class options
+    add_bgcolor_class options
+  end
+
+  ################
+  ### OVERRIDE ###
+  ################
+
+  # override rails helper: content_tag
+  def content_tag(name, content_or_options_with_block = nil, options = nil, escape = true, &block)
+    if block_given?
+      options = content_or_options_with_block if content_or_options_with_block.is_a? Hash
+      normalize_typography_options(options) unless options.nil?
+      content_tag_string name, capture(&block), options, escape
+    else
+      normalize_typography_options(options) unless options.nil?
+      content_tag_string name, content_or_options_with_block, options, escape
+    end
+  end
+end

data/app/helpers/font_awesome_helper.rb

@@ -0,0 +1,94 @@
+module FontAwesomeHelper
+  # Creates an icon tag given an icon name and possible icon
+  # modifiers.
+  #
+  # Examples
+  #
+  #   fa_icon "camera-retro"
+  #   # => <i class="fa fa-camera-retro"></i>
+  #
+  #   fa_icon "camera-retro", text: "Take a photo"
+  #   # => <i class="fa fa-camera-retro"></i> Take a photo
+  #   fa_icon "chevron-right", text: "Get started", right: true
+  #   # => Get started <i class="fa fa-chevron-right"></i>
+  #
+  #   fa_icon "camera-retro 2x"
+  #   # => <i class="fa fa-camera-retro fa-2x"></i>
+  #   fa_icon ["camera-retro", "4x"]
+  #   # => <i class="fa fa-camera-retro fa-4x"></i>
+  #   fa_icon "spinner spin lg"
+  #   # => <i class="fa fa-spinner fa-spin fa-lg">
+  #
+  #   fa_icon "quote-left 4x", class: "pull-left"
+  #   # => <i class="fa fa-quote-left fa-4x pull-left"></i>
+  #
+  #   fa_icon "user", data: { id: 123 }
+  #   # => <i class="fa fa-user" data-id="123"></i>
+  #
+  #   content_tag(:li, fa_icon("check li", text: "Bulleted list item"))
+  #   # => <li><i class="fa fa-check fa-li"></i> Bulleted list item</li>
+  def fa_icon(names = 'flag', options = {})
+    classes = ['fa']
+    classes.concat Private.icon_names(names)
+    classes.concat Array(options.delete(:class))
+    text = options.delete(:text)
+    right_icon = options.delete(:right)
+    icon = content_tag(:i, nil, options.merge(class: classes))
+    Private.icon_join(icon, text, right_icon)
+  end
+
+  # Creates an stack set of icon tags given a base icon name, a main icon
+  # name, and possible icon modifiers.
+  #
+  # Examples
+  #
+  #   fa_stacked_icon "twitter", base: "square-o"
+  #   # => <span class="fa-stack">
+  #   # =>   <i class="fa fa-square-o fa-stack-2x"></i>
+  #   # =>   <i class="fa fa-twitter fa-stack-1x"></i>
+  #   # => </span>
+  #
+  #   fa_stacked_icon "terminal inverse", base: "square", class: "pull-right", text: "Hi!"
+  #   # => <span class="fa-stack pull-right">
+  #   # =>   <i class="fa fa-square fa-stack-2x"></i>
+  #   # =>   <i class="fa fa-terminal fa-inverse fa-stack-1x"></i>
+  #   # => </span> Hi!
+  #
+  #   fa_stacked_icon "camera", base: "ban-circle", reverse: true
+  #   # => <span class="fa-stack">
+  #   # =>   <i class="fa fa-camera fa-stack-1x"></i>
+  #   # =>   <i class="fa fa-ban-circle fa-stack-2x"></i>
+  #   # => </span>
+  def fa_stacked_icon(names = 'flag', options = {})
+    classes = Private.icon_names('stack').concat(Array(options.delete(:class)))
+    base_names = Private.array_value(options.delete(:base) || 'square-o').push('stack-2x')
+    names = Private.array_value(names).push('stack-1x')
+    base = fa_icon(base_names, options.delete(:base_options) || {})
+    icon = fa_icon(names, options.delete(:icon_options) || {})
+    icons = [base, icon]
+    icons.reverse! if options.delete(:reverse)
+    text = options.delete(:text)
+    right_icon = options.delete(:right)
+    stacked_icon = content_tag(:span, safe_join(icons), options.merge(class: classes))
+    Private.icon_join(stacked_icon, text, right_icon)
+  end
+
+  module Private
+    extend ActionView::Helpers::OutputSafetyHelper
+
+    def self.icon_join(icon, text, reverse_order = false)
+      return icon if text.blank?
+      elements = [icon, ERB::Util.html_escape(text)]
+      elements.reverse! if reverse_order
+      safe_join(elements, ' ')
+    end
+
+    def self.icon_names(names = [])
+      array_value(names).map { |n| "fa-#{n}" }
+    end
+
+    def self.array_value(value = [])
+      value.is_a?(Array) ? value : value.to_s.split(/\s+/)
+    end
+  end
+end

data/app/helpers/hash_helper.rb

@@ -0,0 +1,25 @@
+module HashHelper
+  ############
+  ### Hash ###
+  ############
+
+  # Returns a specific value from the given hash (or the default value if not set).
+  def get_value(key, hash, default_value = nil)
+    value = hash.delete key
+    value = default_value if value.nil? and !default_value.nil?
+    value
+  end
+
+  # Removes and returns a specific value from the given hash (or the default value if not set).
+  def pop_value(key, hash, default_value = nil)
+    symbolize_keys hash unless hash.empty?
+    get_value key.to_sym, hash, default_value
+  end
+
+  # all keys of the given hash symbolize.
+  def symbolize_keys(hash)
+    result = {}
+    hash.each { |key, value| result[key.to_sym] = value }
+    hash.replace result
+  end
+end

data/app/helpers/markdown_helper.rb

@@ -0,0 +1,25 @@
+require 'redcarpet'
+
+module MarkdownHelper
+  class HTMLWithPygments < Redcarpet::Render::HTML
+    def block_code(code, language)
+      sha = Digest::SHA1.hexdigest(code)
+      Rails.cache.fetch ["code", language, sha].join('-') do
+        Pygments.highlight(code, lexer: language)
+      end
+    end
+  end
+
+  def markdown(text)
+    renderer = HTMLWithPygments.new(hard_wrap: true, filter_html: true)
+    options = {
+      autolink: true,
+      no_intra_emphasis: true,
+      fenced_code_blocks: true,
+      lax_html_blocks: true,
+      strikethrough: true,
+      superscript: true
+    }
+    Redcarpet::Markdown.new(renderer, options).render(text).html_safe
+  end
+end

data/app/helpers/qrcode_helper.rb

@@ -0,0 +1,21 @@
+module QrcodeHelper
+  def qrcode(data='', options = {})
+    # Google API: https://google-developers.appspot.com/chart/infographics/docs/qr_codes
+    width = pop_value :width, options, '200'
+    output_encoding = pop_value :output_encoding, options
+    error_correction_level = pop_value :error_correction_level, options
+    margin = pop_value :margin, options
+
+    qrcode_url = 'https://chart.googleapis.com/chart?cht=qr'
+    qrcode_url += "&chl=#{data}"
+    qrcode_url += "&chs=#{width}x#{width}"
+    qrcode_url += "&choe=#{output_encoding}" unless output_encoding.nil?
+    if error_correction_level.nil? or margin.nil?
+      qrcode_url += "&chld=#{error_correction_level}" unless error_correction_level.nil?
+      qrcode_url += "&chld=|#{margin}" unless margin.nil?
+    else
+      qrcode_url += "&chld=#{error_correction_level}|#{margin}"
+    end
+    image_tag qrcode_url, alt: data
+  end
+end

data/app/helpers/timeago_helper.rb

@@ -0,0 +1,7 @@
+module TimeagoHelper
+  def timeago(time, options = {})
+    time = time.to_time if time.is_a? String
+    options[:class] ||= 'timeago'
+    content_tag(:abbr, time.to_s, options.merge(title: time.getutc.iso8601)) if time
+  end
+end

data/lib/andy_rails_toolbox/version.rb

@@ -1,3 +1,3 @@
 module AndyRailsToolbox
-  VERSION = "0.0.1"
+  VERSION = "1.0.0"
 end

data/lib/andy_rails_toolbox.rb

@@ -1,5 +1,8 @@
-require "andy_rails_toolbox/version"
-
 module AndyRailsToolbox
-
+  class Engine < ::Rails::Engine
+    initializer 'andy_rails_toolbox' do
+      # include helpers path
+      paths['app/helpers'] << 'app/helpers'
+    end
+  end
 end

metadata

@@ -1,43 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: andy_rails_toolbox
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 1.0.0
 platform: ruby
 authors:
 - ChouAndy
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-14 00:00:00.000000000 Z
+date: 2015-01-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: redcarpet
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.7'
-  type: :development
+        version: '0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: pygments.rb
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
+        version: '0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
 description: Andy Rails Toolbox includes many useful helpers for rails development.
 email:
 - chouandy625@gmail.com
@@ -45,12 +45,18 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- Gemfile
-- LICENSE.txt
+- MIT-LICENSE
 - README.md
 - Rakefile
-- andy_rails_toolbox.gemspec
+- app/assets/javascripts/jquery.timeago.js
+- app/assets/javascripts/jquery.timeago.load.coffee
+- app/assets/javascripts/jquery.timeago.zh-TW.js
+- app/helpers/bootstrap_helper.rb
+- app/helpers/font_awesome_helper.rb
+- app/helpers/hash_helper.rb
+- app/helpers/markdown_helper.rb
+- app/helpers/qrcode_helper.rb
+- app/helpers/timeago_helper.rb
 - lib/andy_rails_toolbox.rb
 - lib/andy_rails_toolbox/version.rb
 homepage: https://github.com/ChouAndy/andy_rails_toolbox

data/.gitignore

@@ -1,14 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-*.bundle
-*.so
-*.o
-*.a
-mkmf.log

data/Gemfile

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

data/andy_rails_toolbox.gemspec

@@ -1,23 +0,0 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'andy_rails_toolbox/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = "andy_rails_toolbox"
-  spec.version       = AndyRailsToolbox::VERSION
-  spec.authors       = ["ChouAndy"]
-  spec.email         = ["chouandy625@gmail.com"]
-  spec.summary       = %q{Includes many useful helpers for rails development.}
-  spec.description   = %q{Andy Rails Toolbox includes many useful helpers for rails development.}
-  spec.homepage      = "https://github.com/ChouAndy/andy_rails_toolbox"
-  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.7"
-  spec.add_development_dependency "rake", "~> 10.0"
-end