We follow this rubric for writing our RSpec test files.
For more information, check out the techniques described on BetterSpecs!
Use "describe" to denote which feature you are testing. When referring to a class method, use the "." or the "::" notation. When referring to an instance method, use the "#" notation.
Ex) describe "Array.first"
Ex) describe "user#say_hello"
Descriptions should be short (ideally < 40 characters).
When talking about how a feature should behave for a particular state (i.e. the user has no username), use "context". Context descriptions should begin with "when" or "with".
Ex) context "when the user has no username"
General RSpec & Testing rules:
- Keep your tests as isolated as possible
- Use the "expect" keyword instead of "should" as Rspec aims to deprecate "should".
- Use let() and let!() instead of creating instance variables. Let() and let!() lazy load data (i.e. they don't create the variable until it is needed). Learn more about let here.