zoo-generators

= Zoo Generators

A collection of useful Rails generator scripts for scaffolding, layout files, authentication, and more.

== Setup

=== Rails 3

Add the gem to your Gemfile.

gem "zoo-generators", group : :development

Then you can run any of the included generators.

rails g zoo:scaffold Recipe name:string index new

== Included Generators

• zoo:layout: generates generic layout, stylesheet, and helper files.
• zoo:scaffold: generates a controller and optional model/migration.
• zoo:config: generates a config YAML file and loader.
• zoo:authentication: generates user model with sign up and log in.

To view the README for each generator, run it with the +help+ option.

rails g zoo:layout --help

== Troubleshooting and FAQs

What is the difference between zoo:scaffold and built-in scaffold?

One of the primary differences is that zoo:scaffold allows you to choose which controller actions to generate.

rails g zoo:scaffold post name:string index new edit

There are a few changes to the generated code as well, such as no XML format by default.

It also offers support for HAML, Shoulda, and RSpec.

I get "undefined method 'title'" error.

Try running zoo:layout, that will generate this helper method. Or you can just change the templates to whatever approach you prefer for setting the title.

I can't set new attributes in my model.

Add the attribute to the attr_accessible line in the model.

I get "undefined method 'root_url'" error.

Some generators default redirecting to the root_url. Set this in your routes.rb file like this (substituting your controller name).

root to: "home#index"

I get a missing database error.

Run rake db:migrate.

I get a routing error when I try to submit a form.

Try restarting your development server. Sometimes it doesn't detect the change in the routing.

The tests/specs don't work.

Make sure you have mocha installed and require it in your spec/test helper.

gem install mocha

in spec_helper.rb

config.mock_with :mocha

in test_helper.rb

require 'mocha'

Also, make sure you're using Rails 2.1 or greater.

== Found a bug?

If you are having a problem with Zoo Generators, first look at the FAQs above. If you still cannot resolve it, please submit an issue here.

http://github.com/ryanb/haml-generators/issues

== Development

If you want to contribute to this project, you can download the Git repository and get the Cucumber features running by calling +bundle+ then +rake+. I normally develop this using Ruby 1.9.2 however it should work with 1.8.7 as well.

The Rails 3 generators are located under lib/generators and are tested with Cucumber. The older Rails 2 generators are under rails_generators and are tested with Shoulda under the test directory.