@@ -5,9 +5,9 @@ with Executable Scenarios and Executable Examples at the code level. RSpec ships with several modules: -Spec::Story provides a framework for expressing User Stories +Spec::Story provides a framework for expressing User Stories and Scenarios -Spec::Example provides a framework for expressing code Examples +Spec::Example provides a framework for expressing Isolated Examples Spec::Matchers provides Expression Matchers for use with Spec::Expectations and Spec::Mocks. @@ -22,50 +22,15 @@ behaviour to your existing objects. == Installation -The simplest approach is to install the gem: +The simplest approach is to install the gem (as root in some environments): - gem install -r rspec #mac users must sudo + gem install -r rspec == Building the RSpec gem -If you prefer to build the gem locally, check out source from svn://rubyforge.org/var/svn/rspec/trunk. Then -do the following: - rake gem - gem install pkg/rspec-0.x.x.gem (you may have to sudo) - -== Running RSpec's specs -In order to run RSpec's full suite of specs (rake pre_commit) you must install the following gems: - -* rake # Runs the build script -* rcov # Verifies that the code is 100% covered by specs -* webby # Generates the static HTML website -* syntax # Required to highlight ruby code -* diff-lcs # Required if you use the --diff switch -* win32console # Required by the --colour switch if you're on Windows -* meta_project # Required in order to make releases at RubyForge -* heckle # Required if you use the --heckle switch -* hpricot # Used for parsing HTML from the HTML output formatter in RSpec's own specs - -Once those are all installed, you should be able to run the suite with the following steps: - -* svn co svn://rubyforge.org/var/svn/rspec/trunk rspec -* cd rspec -* rake install_dependencies -* cd example_rails_app -* export RSPEC_RAILS_VERSION=1.2.3 -* rake rspec:generate_mysql_config -* mysql -u root < db/mysql_setup.sql -* cd .. -* rake pre_commit - -Note that RSpec itself - once built - doesn't have any dependencies outside the Ruby core -and stdlib - with a few exceptions: - -* The spec command line uses diff-lcs when --diff is specified. -* The spec command line uses heckle when --heckle is specified. -* The Spec::Rake::SpecTask needs RCov if RCov is enabled in the task. - -See http://rspec.info for further documentation. - -== Contributing +If you prefer to build the gem locally: + git clone git://github.com/dchelimsky/rspec.git + cd rspec + rake gem + gem install pkg/rspec-0.x.x.gem #as root README @@ -1,2 +1,2 @@ -=== Before releasing 1.1.0: + TODO @@ -1,29 +1,5 @@ -= Upgrading existing code to RSpec-0.9 - -== General (see below for Spec::Rails specifics) - -=== New Syntax for should and should_not - -* Use translator (should get 90% of your code) -* Manually fix "parenthesis" warnings - -=== Change before_context_eval to before_eval - -before_context_eval is an un-published hook used by -Spec::Rails to create specialized behaviour contexts. -Most of you don't need to change this, but for those -who have exploited it, you'll need to change it to -before_eval. - == Spec::Rails -=== spec_helper.rb - -We've added a new way to configure Spec::Runner to do -things like use_transactional_fixtures and use_instantiated_fixtures. -You'll need to update spec/spec_helper.rb accordingly. You can either -just re-generate it: - script/generate rspec Or modify spec_helper.rb based on the template, which can be found at: UPGRADE 9c0f16813c0590a5fe46f87dd2e7e52d29ddbcca David Chelimsky dchelimsky@gmail.com http://github.com/dchelimsky/rspec/commit/256d8ea222a7b86efdaf26b98eafcbea533cb7fd 256d8ea222a7b86efdaf26b98eafcbea533cb7fd 2008-04-07T22:01:38-07:00 2008-04-07T22:01:38-07:00 update info files deb000f574561b7e67ef9f05b5ae8c417f4856e8 David Chelimsky dchelimsky@gmail.com