Allow the installer to add solidus_auth_devise

There's no need to manually add the gem to the Gemfile.

Rails installer has a `gem` method that does exactly that,
making the installation process easier for new users.

During the first installation it will be asked to users if
they want to install the gem, still making this optional.

This commit also updates Readme, Guides and avoid installing the
plugin in sandbox and rails application template (where it's already
done manually), and when building the test_app (where we don't need it).

README.md

@@ -105,7 +105,6 @@ created. Add the following to your Gemfile.
 
 ```ruby
 gem 'solidus'
-gem 'solidus_auth_devise'
 ```
 
 Run the `bundle` command to install.
@@ -115,7 +114,6 @@ configuration files and migrations.
 
 ```bash
 bundle exec rails g solidus:install
-bundle exec rails g solidus:auth:install
 bundle exec rake railties:install:migrations
 ```
 

bin/rails-application-template

@@ -122,6 +122,7 @@ after_bundle do
  "--auto-accept",
  "--user_class=Spree::User",
  "--enforce_available_locales=true",
+ "--with-authentication=false",
  )
 
  generate('solidus_auth:install')

bin/sandbox

@@ -65,6 +65,7 @@ unbundled bin/rails generate solidus:install \
  --auto-accept \
  --user_class=Spree::User \
  --enforce_available_locales=true \
+ --with_authentication=false \
  $@
 
 unbundled bin/rails generate solidus:auth:install

core/lib/generators/solidus/install/install_generator.rb

@@ -17,6 +17,7 @@ class InstallGenerator < Rails::Generators::Base
  class_option :admin_email, type: :string
  class_option :admin_password, type: :string
  class_option :lib_name, type: :string, default: 'spree'
+ class_option :with_authentication, type: :boolean, default: true
  class_option :enforce_available_locales, type: :boolean, default: nil
 
  def self.source_paths
@@ -111,6 +112,17 @@ def configure_application
  end
  end
 
+ def install_default_plugins
+ if options[:with_authentication] && (options[:auto_accept] || yes?("
+ Solidus has a default authentication extension that uses Devise.
+ You can find more info at github.com/solidusio/solidus_auth_devise.
+
+ Would you like to install it? (y/n)"))
+
+ gem 'solidus_auth_devise'
+ end
+ end
+
  def include_seed_data
  append_file "db/seeds.rb", <<-RUBY.strip_heredoc
 

core/lib/spree/testing_support/common_rake.rb

@@ -14,7 +14,7 @@
  ENV["RAILS_ENV"] = 'test'
 
  Spree::DummyGenerator.start ["--lib_name=#{ENV['LIB_NAME']}", "--quiet"]
- Solidus::InstallGenerator.start ["--lib_name=#{ENV['LIB_NAME']}", "--auto-accept", "--migrate=false", "--seed=false", "--sample=false", "--quiet", "--user_class=#{args[:user_class]}"]
+ Solidus::InstallGenerator.start ["--lib_name=#{ENV['LIB_NAME']}", "--auto-accept", "with-authentication=false", "--migrate=false", "--seed=false", "--sample=false", "--quiet", "--user_class=#{args[:user_class]}"]
 
  puts "Setting up dummy database..."
 

guides/source/developers/getting-started/first-time-installation.html.md

@@ -161,7 +161,6 @@ lines:
 
 ```ruby
 gem 'solidus'
-gem 'solidus_auth_devise'
 ```
 
 By requiring [`solidus`][solidus-repo] in your `Gemfile`, you are actually
@@ -225,23 +224,6 @@ The default values are as follows:
 The password must contain a minimum of 6 characters, or the account creation
 will fail without asking the user to try again.
 
-### Prepare Solidus database migrations
-
-Next, you need to run the `solidus:auth:install` generator and install your
-database migrations using the following commands:
-
-```bash
-bundle exec rails generate solidus:auth:install
-bundle exec rake railties:install:migrations
-```
-
-Finally, you need to run the migrations that Railties created. This creates the
-e-commerce–friendly models that Solidus uses for its database:
-
-```bash
-bundle exec rake db:migrate
-```
-
 ### Start the Rails server and use the sample store
 
 Once the database migrations have been created, you should be able to
@@ -260,4 +242,4 @@ Once the server has started, you can access your store from the following URLs:
 - [https://localhost:3000/admin/](https://localhost:3000/admin/) opens the
  [`solidus_backend`][solidus-backend] admin area.
 
-You can browse the sample store's pages and mock products, and so on.
+You can browse the sample store's pages and mock products, and so on.

guides/source/developers/getting-started/installation-options.html.md

@@ -45,15 +45,36 @@ bundle exec rake db:seed # seeds your database
 bundle exec rake spree_sample:load # loads sample data
 ```
 
-If you use `solidus_auth_devise` for user authentication, you can also install
-and run its migrations, then seed the database separately:
+## Authentication via Devise
+
+During the installation, you have been prompted to add the default authentication extension
+to your project. It is called [`solidus-auth-devise`][solidus-auth-devise] and it uses the
+well-known authentication library for Rails called [Devise][devise].
+
+If you answered "yes", there's nothing else left to do. The extension is already
+added and installed in your application.
+
+If you don't want to install the default authentication extension, you can answer "no",
+or run the Solidus installer with the following command:
+
+```bash
+rails generate solidus:install --with-authentication=false
+```
+
+If you prefer to install [`solidus-auth-devise`][solidus-auth-devise] gem manually,
+after adding it in your Gemfile, you can run the following commands to install and
+run its migrations, then seed the database:
 
 ```bash
+bundle install # install gem and dependencies
 bundle exec rake solidus_auth:install:migrations # installs solidus_auth_devise migrations
 bundle exec rake db:migrate # runs solidus_auth_devise migrations
 bundle exec rake db:seed # seeds your database
 ```
 
+[solidus-auth-devise]: https://github.com/solidusio/solidus_auth_devise
+[devise]: https://github.com/heartcombo/devise
+
 ## Development environment performance gains
 
 You may notice that your Solidus store runs slowly in development mode. You can