using bundler with Wagn
- Install bundler
gem install bundler - Use bundler to install / update your other gems.
bundle install #WAIT! This is the basic command, but read the following before running it.
If you just run that command, bundler will install all the gems Wagn ever uses, including many that you probably don't need, upping the odds that you'll encounter problems.
So it's best to specify which groups of gems you DON'T need:
# sample install command for wagns using mysql bundle install --without test hosting sqlite postgres # sample install command for wagns using postgres bundle install --without test hosting sqlite mysql
Bundler sometimes stumbles on the mysql gem because it doesn't know where the database is stored. You may find this bundler configuration document helpful in resolving that issue, especially this command:
bundle config build.mysql --with-mysql-config=XXXXX
FAQ - Foolhardily Anticipated Questions
Why is this necessary? Wagn is a Ruby-on-Rails application, and it needs gems to run. Gems are specially-packaged independent ruby programs/libraries. Bundler is the gem management system used in Rails 3 (on which Wagn will soon run), and it dramatically improves gem maintenance.
Why is this worth it? Installing gems with bundler can sometimes take a little extra time upfront, but saves a ton of time in the long term. Bundler stores your configuration preferences in a .bundler file and uses that file to keep your gems up to date with Wagn. It may be hard to notice the headaches you're not having, but this is an investment in many non-headaches in the future.
Do I want those extra "gem groups"? Not unless you're feeling hard core. The "test" group is recommended for programmers interested in modifying or extending Wagn. They are needed to run Wagn tests (rspec, cucumber, etc). The "hosting" group is not needed to host a wagn site; it includes gems that we use on our hosted wagns and are not needed in most hosting scenarios. The database groups are only needed if you're using that database.