duffy 0.2.4 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d01359db9f3ec823f91ff534d3870712e0bcc599
-  data.tar.gz: c7b30c4d7e0ae05db21a0eaa335e3765c3d349f7
+  metadata.gz: 304f86f07f2a4318944a13f241921faba0d8f969
+  data.tar.gz: d90859be246a584b6cd460c8a8d942a1de39c07d
 SHA512:
-  metadata.gz: 51b4dee46a3905df6e1681a6724141842f258a14bbd3fe9e303d69f743c55680a9f855bfca5f12869bb81d9fdd75b16826a04b3a1cabf008118924cfc19e5375
-  data.tar.gz: 954f4d3b21b9b4a73e7c73b02c5cbde845988046486aaa21a5b721e552ff754f0ca3a89adc33f3c25aa50858c114e1df45487717f128f12cdbf03e6a8da1cea4
+  metadata.gz: 6ff94dbc71c7d44f306a1698173ac7a05763a16b3c44d0090b182561d57eb565edd935431b36a70deec574743a7c1fa92054ac1cd59208607f4f37819366c565
+  data.tar.gz: 66637e5c757d8e36a12911abb8395215d3d7119118fb6e703a6871c7c7bc1bc36761c088218813a831988bc2b629023d73c20fd36e58c112825009a264e6355e

data/README.md

@@ -8,7 +8,6 @@ This is a collection of reusable things I don't want to keep duplicating in tons
 ## Installation
 
 Add this line to your application's Gemfile:
-* This is a work in progress.  If someone decides to use this, you may want to lock your version number in your gemfile.
 
 ```ruby
 gem 'duffy'
@@ -39,21 +38,21 @@ gender_human      | "F"             | "Female"
 smart_titlecase   | "this and that" | "This and That" (Note: Has config options. See lib/duffy.rb)
 
 
-Date Patches:
+## Date Patches:
 
 Method            | Example         | Output
 ------------------|-----------------|-------
 fiscal_year       | Date.today      | 2015 (See config to set your organization's fiscal year start.)
 
 
-NilClass Patches:
+## NilClass Patches:
 
 Method            | Example         | Output
 ------------------|-----------------|-------
 to_date           | nil             | self (Exists so you can call .to_date on Date, String or nil
 
 
-Active Record Aliases:
+## Active Record Aliases:
 
 Alias             | Standard
 ------------------|---------
@@ -61,35 +60,41 @@ accepts           | accepts_nested_attributes_for
 habtm             | has_and_belongs_to_many
 
 
-Git Access:
+## Git Access:
 This one is namespaced in case you use the 'git' gem.  I found it to be overkill for what I wanted.
-```ruby
-Duffy::Git.log      # => Produce tab separated listing of current git log.
-Duffy::Git.count    # => Count of git commits in current branch
-Duffy::Git.email    # => Local repo's git user.email or global if none.
-Duffy::Git.branch   # => Current git branch.
-```
 
-CPU Detection:
+Method    |   Result
+----------|---------
+Duffy::Git.log      | Produce tab separated listing of current git log.
+Duffy::Git.count    | Count of git commits in current branch
+Duffy::Git.email    | Local repo's git user.email or global if none.
+Duffy::Git.branch   | Current git branch.
+
+
+## CPU Detection:
 Linux and Mac only for now, each method returns 1 on unsupported hosts.
 Example results for my dual core i5 with hyperthreading.
-```ruby
-Duffy::System.cpus       # => 1
-Duffy::System.cores      # => 2
-Duffy::System.threads    # => 4
-Duffy::System.sane_load  # => 3
-```
 
+Method    |   Result
+----------|---------
+Duffy::System.cpus       | 1
+Duffy::System.cores      | 2
+Duffy::System.threads    | 4
+Duffy::System.sane_load  | 3
+
+
+
+## View Helpers:
+
+Method      | Example                             | Result
+------------|-------------------------------------|-------
+beast_mode  | beast_mode tags               | renders tag partial in parallel. Only available if you have the Parallel gem in your Gemfile.  You must also wrap your partial in a cache block.
+excel_icon  | excel_icon                    | generates hyperlinked excel.png in an li block to .xlsx version of current page or passed link.  Maintains current GET params.
+icon        | icon("tags", tags_path)       | generates link of class "icon" with the title and link provided. also sets id based on controller and action  |
+menu_tag    | menu_tag("Login", login_path) | generated hyperlinked li block used in common ul based navigation toolbars.
 
-View Helpers:
-This is a work in progress.  I'm going to try to put all my generic helpers here.
-```ruby
-menu_tag
-excel_icon
-icon
-```
 
-CSS Reset & Print Styles: Very barebones CSS Reset / Sensible defaults and Print stylesheets.
+## CSS Reset & Print Styles: Very barebones CSS Reset / Sensible defaults and Print stylesheets.
 ```ruby
 require duffy/reset
 require duffy/print

data/lib/duffy/beast_mode_helper.rb

@@ -0,0 +1,49 @@
+module BeastModeHelper
+
+  # Cache each partial in a collection, then display from cache.
+  #
+  # IMPORTANT: This only works if you've wrapped your partial in a cache block.
+  #            If you don't it will take longer than just calling render()
+  #            You also need the Parallel gem installed: https://github.com/grosser/parallel
+  #
+  # Examples:
+  #   beast_mode(@jobs)
+  #   beast_mode(partial: 'jobs/job', collection: @jobs)
+  #
+  def beast_mode(options = {})
+
+    if defined? Parallel
+
+      if options.is_a?(Hash)
+        # eg: beast_mode(partial: 'jobs/job', collection: @jobs)
+
+        # Issue ArgumentError if anything is missing
+        raise ArgumentError.new("partial: option is required") unless options.has_key?(:partial)
+        raise ArgumentError.new("collection: option is required") unless options.has_key?(:collection)
+
+        collection = options[:collection]
+        partial = options[:partial]
+
+        # Issue ArgumentError if collection isn't a collection
+        raise ArgumentError.new("collection doesn't look like something I can render") unless collection.respond_to?(:each)
+
+
+        # silently render each partial as quickly as possible.  It's up to you to include a cache block!
+        Parallel.each(collection, in_processes: MAX_PROCESSES) do |object|
+          render(partial: partial, object: object)
+        end
+      else
+        # eg: beast_mode(@jobs)
+        # Generate the Cache fragments for each object in parallel as fast as possible, but don't show them yet
+        Parallel.each(options, in_processes: MAX_PROCESSES) do |object|
+          render(object)
+        end
+      end
+    else
+      warn "  [WARNING] beast_mode is not executing in parallel.  Please add https://github.com/grosser/parallel"
+    end
+
+    # Display the cached fragments.
+    render(options)
+  end
+end

data/lib/duffy/railtie.rb

@@ -1,10 +1,16 @@
 # http://stackoverflow.com/questions/5791211/how-do-i-extract-rails-view-helpers-into-a-gem
 
 require File.dirname(__FILE__) + "/duffy_helper"
+require File.dirname(__FILE__) + "/beast_mode_helper"
+
 module Duffy
   class Railtie < Rails::Railtie
     initializer "duffy_helper" do
       ActiveSupport.on_load( :action_view ){ include DuffyHelper }
     end
+
+    initializer "beast_mode_helper" do
+      ActiveSupport.on_load( :action_view ){ include BeastModeHelper }
+    end
   end
 end

data/lib/duffy/version.rb

@@ -1,6 +1,7 @@
 module Duffy
-  VERSION = "0.2.4"
+  VERSION = "0.2.5"
 end
 
 # History
+# 0.2.5 - Added beast_mode helper to render partials in parallel
 # 0.2.4 - Added NilClass.to_date => nil

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: duffy
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.5
 platform: ruby
 authors:
 - Jacob Duffy
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-21 00:00:00.000000000 Z
+date: 2016-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -96,6 +96,7 @@ files:
 - duffy.gemspec
 - lib/duffy.rb
 - lib/duffy/active_record.rb
+- lib/duffy/beast_mode_helper.rb
 - lib/duffy/date.rb
 - lib/duffy/duffy_helper.rb
 - lib/duffy/engine.rb