critical-path-css-rails 0.2.4 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 95bdd37882da54487a75f7757f4df5f45a0daa45
-  data.tar.gz: 468b72efbff091a327d69a7fe1876f4698d0d363
+  metadata.gz: ae358ce3a4aeb862c846a0bf3ece801de83d7ab2
+  data.tar.gz: 477c25419bc4500075240103fd268245b7366dfb
 SHA512:
-  metadata.gz: a6868c40d8d58f03a185cdf5b002ca010e27e7fcd22368a2ad498314362a1069b5166303f1d469f7808df7c4307730d6e47014fea433d4271d2580343b2687a5
-  data.tar.gz: 36c659a731465c67db6a2b695bea134a321a333a95b9d715525049bf0c197932231508d258315bb5681019688edbbba683a3778a48cb1229ad1244278ea4576a
+  metadata.gz: 02041fc89747c725ae5e975793b4202b29bd202ab786c38e089994d02288fd11384a1434871d6896c7007cfbe83a1f9bff7a9677b03a38f5834c6fd17ee5f7ba
+  data.tar.gz: c783c2979070b990f35ffb04ac69f5f963b8856abde488fb4584729fd37fd410f1744e4cf10f810884a2d8ae33d4a08b0cc33a08881a40623c688670c4c8aba3

data/README.md

@@ -8,13 +8,16 @@ This gem assumes that you'll load the rest of the CSS asyncronously. At the mome
 
 This gem uses [PhantomJS](https://github.com/colszowka/phantomjs-gem) and [Penthouse](https://github.com/pocketjoso/penthouse) to generate the critical CSS.
 
+## Update
+
+Version 0.3.0 is not compatible with previous versions.  Please read the Upgrading from Previous Versions section below for more information.
 
 ## Installation
 
 Add `critical-path-css-rails` to your Gemfile:
 
 ```
-gem 'critical-path-css-rails', '~> 0.2.0'
+gem 'critical-path-css-rails', '~> 0.3.0'
 ```
 
 Download and install by running:
@@ -61,15 +64,15 @@ To load the generated critical CSS into your layout, in the head tag, insert:
 
 ```HTML+ERB
 <style>
-  <%= CriticalPathCss.fetch(request.path) %>
+    <%= CriticalPathCss.fetch(request.path) %>
 </style>
 ```
 
-A simple example using loadcss-rails looks like:
+A simple example using [loadcss-rails](https://github.com/michael-misshore/loadcss-rails) looks like:
 
 ```HTML+ERB
 <style>
-    <%= CriticalPathCss.fetch(request.path) %>
+  <%= CriticalPathCss.fetch(request.path) %>
 </style>
 <script>
     loadCSS("<%= stylesheet_path('application') %>");
@@ -80,6 +83,45 @@ A simple example using loadcss-rails looks like:
 </noscript>
 ```
 
+### Route-level Control of CSS Generation and Removal
+
+CriticalPathCss exposes some methods to give the user more control over the generation of Critical CSS and managment of the CSS cache:
+
+``` ruby
+CriticalPathCss.generate route         # Generates the critical path CSS for the given route (relative path)
+
+CriticalPathCss.generate_all           # Generates critical CSS for all routes in critical_path_css.yml
+
+CriticalPathCss.clear route            # Removes the CSS for the given route from the cache
+
+CriticalPathCss.clear_matched routes   # Removes the CSS for the matched routes from the cache
+```
+
+NOTE: The `clear_matched` method will not work with Memcached due to the latter's incompatibility with Rails' `delete_matched` method.  We recommend using an alternative cache such as [Redis](https://github.com/redis-store/redis-rails).
+
+In addition to the `critical_path_css:generate` rake task described above, you also have access to task which clears the CSS cache:
+
+```
+rake critical_path_css:clear_all
+```
+NOTE: The `critical_path_css:clear_all` rake task may need to be customized to suit your particular cache implementation.
+
+Careful use of these methods allows the developer to generate critical path CSS dynamically within the app.  The user should strongly consider using a [background job](http://edgeguides.rubyonrails.org/active_job_basics.html) when generating CSS in order to avoid tying up a rails thread.  The `generate` method will send a GET request to your server which could cause infinite recursion if the developer is not careful.
+
+A user can use these methods to [dynamically generate critical path CSS](https://gist.github.com/taranda/1597e97ccf24c978b59aef9249666c77) without using the `rake critical_path_css:generate` rake task and without hardcoding the application's routes into `config/critical_path_css.yml`.  See [this Gist](https://gist.github.com/taranda/1597e97ccf24c978b59aef9249666c77) for an example of such an implementation.
+
+## Upgrading from Previous Versions
+
+The latest version of Critcal Path CSS Rails changes the functionality of the `generate` method.  In past versions,
+`generate` would produce CSS for all of the routes listed in `config/critical_path_css.yml`.  This functionality has been replaced by the `generate_all` method, and `generate` will only produce CSS for one route.
+
+Developers upgrading from versions prior to 0.3.0 will need to replace `CriticalPathCss:generate` with `CriticalPathCss:generate_all` throughout their codebase.  One file that will need updating is `lib/tasks/critical_path_css.rake`.  Users can upgrade this file automatically by running:
+
+``` prompt
+rails generate critical_path_css:install
+```
+
+Answer 'Y' when prompted to overwrite `critical_path_css.rake`.  However, overwriting `critical_path_css.yml` is not necessary and not recommended.
 
 ## Versions
 

data/lib/critical-path-css-rails.rb

@@ -3,12 +3,25 @@ module CriticalPathCss
 
   CACHE_NAMESPACE = 'critical-path-css'
 
-  def self.generate
+  def self.generate(route)
+      Rails.cache.write(route, CssFetcher.new.fetch_route(route),
+                        namespace: CACHE_NAMESPACE, expires_in: nil)
+  end
+
+  def self.generate_all
     CssFetcher.new.fetch.each do |route, css|
       Rails.cache.write(route, css, namespace: CACHE_NAMESPACE, expires_in: nil)
     end
   end
 
+  def self.clear(route)
+    Rails.cache.delete(route, namespace: CACHE_NAMESPACE)
+  end
+
+  def self.clear_matched(routes)
+    Rails.cache.delete_matched(routes,namespace: CACHE_NAMESPACE)
+  end
+
   def self.fetch(route)
     Rails.cache.read(route, namespace: CACHE_NAMESPACE) || ''
   end

data/lib/critical_path_css/css_fetcher.rb

@@ -13,7 +13,11 @@ module CriticalPathCss
       @config.routes.map { |route| [route, css_for_route(route)] }.to_h
     end
 
-    private
+    def fetch_route(route)
+      css_for_route route
+    end
+
+  protected
 
     def css_for_route(route)
       Phantomjs.run(PENTHOUSE_PATH, @config.base_url + route, @config.css_path)

data/lib/critical_path_css/rails/version.rb

@@ -1,6 +1,6 @@
 module CriticalPathCSS
   module Rails
-    VERSION = '0.2.4'
+    VERSION = '0.3.0'
     PENTHOUSE_VERSION = '0.3.4'
   end
 end

data/lib/tasks/critical_path_css.rake

@@ -3,7 +3,14 @@ require 'critical-path-css-rails'
 namespace :critical_path_css do
   desc 'Generate critical CSS for the routes defined'
   task generate: :environment do
-    CriticalPathCss.generate
+    CriticalPathCss.generate_all
+  end
+  desc 'Clear all critical CSS from the cache'
+  task clear_all: :environment do
+  	# Use the following for Redis cache implmentations
+  	CriticalPathCss.clear_matched('*')
+  	# Some other cache implementations may require the following syntax instead
+  	# CriticalPathCss.clear_matched(/.*/)
   end
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: critical-path-css-rails
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.3.0
 platform: ruby
 authors:
 - Michael Misshore
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-04 00:00:00.000000000 Z
+date: 2017-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: phantomjs