browserify-rails 4.2.0 → 4.3.0.pre

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 07cd114f351548db3e2885f6c99e879aa66ea0c1
-  data.tar.gz: 9a2718ea91ac7dc5e031570bc6da6ae190875cc1
+SHA256:
+  metadata.gz: e6d886271d9cfbb4d0293353f90df8efc7949115392ec093b2b96bd4b0ba68a6
+  data.tar.gz: 05c2bc76779bf591569d6d4bde8859bb0e5e991fbf08e24a3d58cb2781446638
 SHA512:
-  metadata.gz: e2604d3a6029a830190bd0806c7b3cd926766508d4729553d9a6a054b1c98b66332a4ff3d03b9527281d5c6f13f09ee2c11d699c6245b0e6d742682e3051b402
-  data.tar.gz: 8659b908bfb1a4b72c57c89680c43587e94fe043be1ca36edc9d8725140e43fd71ff8ceba600ddfd346cc542391d5be8db91d11147b7b9ca6be414f56b08fdd0
+  metadata.gz: 883bd9fb5edc85e1ee24a76c1f51071a3037d4d91f16f249b014289c3ecabec31260a76d419f1768f1692c9b7951f108b6c78e7c780fbe260f018246f9679aff
+  data.tar.gz: 5aa6d88fe1b52843f75f5c059cd2820616fb7820fdc00676ef809b2f7c97561f7231f09c74f5a3c49ded540d85273fc56d6c822155d48af0ae42b307dfd34e81

data/README.md

@@ -16,6 +16,34 @@ It lets you mix and match  `//= require` directives and `require()` calls for in
 6. Require modules relative to asset paths (ie app/assets/javascript) with non-relative syntax (see below before using)
 7. Configure browserify options for each JavaScript file so you can mark modules with `--require`, `--external`, etc
 
+## Should you use this gem?
+
+As the primary developer, I'm going to offer some opiniated advice. The sweet spot for this
+gem is for Rails projects with legacy JavaScript (not using CommonJS/modules). This gem is
+a great way to make it possible to rewrite that legacy JavaScript to CommonJS on a timeline
+that you dictate. Then consider stepping off the Rails asset pipeline or using another gem.
+
+If you're starting a new Rails project today, I highly recommend looking at alternatives to
+this gem. The primary reason is that this gem, while it works well, is not as efficient as
+most would like for local development. Also a lot has changed over the last couple of years.
+
+An example of that change is this project from Rails:
+
+[rails/webpacker](https://github.com/rails/webpacker)
+
+This is a huge step in the right direction for the Rails community. In the past, it has been
+extremely frustrating working with JavaScript on the asset pipeline. The good news is you have a lot
+of great choices. If I were starting a new Rails project today, I think the safest choice is
+one in which you have a [Procfile](https://mattstauffer.co/blog/using-a-procfile-to-streamline-your-local-development) that kicks off a separate Webpack build and you use zero
+Rails magic. A slightly less safe but maybe more convenient choice would be trying rails/webpacker
+or another gem. The choice is yours.
+
+
+For more discussion on this topic, see issues
+[203](https://github.com/browserify-rails/browserify-rails/issues/203),
+[161](https://github.com/browserify-rails/browserify-rails/issues/161),
+[43](https://github.com/browserify-rails/browserify-rails/issues/43), etc.
+
 ## Getting Started
 
 Add this line to your application's Gemfile:
@@ -235,13 +263,29 @@ buildpacks that run `bundle` and `npm install` on the target machine.
 
 ## Using Browserify Transforms
 
-You can easily use a browserify transform by adding it to your `package.json`, then adding the transform flag to your `application.rb`, using `config.browserify_rails.commandline_options`. For example, here is how you can add ES6 support in your app:
+You can easily use a browserify transform by making some additions to your `package.json` and creating a .babelrc. For example, here is how you can add ES6 support in your app:
 
-1. Add `babelify` and `babel-preset-es2015` to your `package.json` in your app's root directory, then run `npm install`
-2. Add this line to your config/application.rb:
-   `config.browserify_rails.commandline_options = "-t [ babelify --presets [ es2015 ] --extensions .es6 ]"`
-3. Create some `.es6` files and require them with `var m = require('./m.es6')` or `import m from './m.es6'`
-4. Restart your server, and you now have ES6 support!
+1. Add `babelify` and `babel-preset-es2015` to your `package.json` in your app's root directory either by editing the file directly and running `npm install` or using `npm install babelify --save` and `npm install babel-preset-es2015 --save`
+2. Update your `package.json` to contain the babelify transform by adding the following lines
+```
+   "browserify": {
+    "transform": [
+      [
+        "babelify"
+      ]
+    ]
+  }
+```
+3. Create a `.babelrc` file in the project root with the following contents
+```
+{
+  "plugins": [],
+  "presets": ["es2015"]
+}
+```
+   
+4. Create some `.es6` files and require them with `var m = require('./m.es6')` or `import m from './m.es6'`
+5. Restart your server, and you now have ES6 support!
 
 
 ## Troubleshooting

data/browserify-rails.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
 
-  spec.add_runtime_dependency "railties", ">= 4.0.0", "< 5.2"
+  spec.add_runtime_dependency "railties", ">= 4.0.0"
   spec.add_runtime_dependency "sprockets", ">= 3.6.0"
   spec.add_runtime_dependency "addressable", ">= 2.4.0"
 

data/lib/browserify-rails/version.rb

@@ -1,3 +1,3 @@
 module BrowserifyRails
-  VERSION = "4.2.0"
+  VERSION = "4.3.0.pre"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: browserify-rails
 version: !ruby/object:Gem::Version
-  version: 4.2.0
+  version: 4.3.0.pre
 platform: ruby
 authors:
 - Henry Hsu, Cymen Vig
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-04-28 00:00:00.000000000 Z
+date: 2018-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -17,9 +17,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 4.0.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '5.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -27,9 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 4.0.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '5.2'
 - !ruby/object:Gem::Dependency
   name: sprockets
   requirement: !ruby/object:Gem::Requirement
@@ -264,12 +258,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.4
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: 'Get the best of both worlds: Browserify + Rails = CommonJS Heaven'