Minitest & Rails, No Pony Ryan Davis, Seattle.rb Min est ... · Windy City Rails, Chicago, IL...

Windy City Rails, Chicago, IL

Ryan Davis, Seattle.rbMinitest & Rails, No Pony

Min!est& Rails,No Pony

Friday, September 13, 13



Setting Expectations93 Slides in 30 minutes. ~3 spm.

Overview talk.

Not comparison nor comprehensive.

Less Technical than my norm.

http://www.zenspider.com/presentations/

TODO






What I'm not talking about




minitestvs

rspec




tddvs

bdd




state-istvs

mockist




I do all of the former.




As long as you test…




I do not care what you use or how you

use it




Also not about benchmark, pride, or

mock.




I could easily talk for hours on minitest &

testing




I only have 30 minutes.




Grab me [email protected]

@the_zenspider




Min!est




What is Minitest?Replacement for ruby 1.8’s test/unit.

Originally 90 lines of code.

Available as a gem, and in ruby 1.9 & 2.0.

Meant to be small, clean, and very fast.

Provides a lot more than test/unit did.




6 3 Parts of Minitestrunner The heart of the machineminitest/unit TDD APIminitest/spec BDD API minitest/mock Simple mocking/stubbing APIminitest/pride IO pipelining exampleminitest/bench Abstract benchmark API




Min!est Runner




Every method starting with "test" is run in a

new context.




No Magic AllowedEven test discovery avoids ObjectSpace.

Minimal metaprogramming.

Uses plain classes and methods to do all work.




Test randomization prevents order dependencies.




Verbose mode prints test times in a sortable format:

% ruby -Ilib test/test_meta.rb -v | sort -k2 -t= -nr | head -3

MetaMagic#test_generate_meta_method = 0.03 s = . MetaMagic#test_complex_method = 0.02 s = .MetaMagic#test_simple_method = 0.01 s = .




Test summary provides useful statistics:

# Running tests:

........................................................................

........................................................................

........................................................................

........................................................................

........................................................................

........................................................................

........................................................................

........................................................................

........................................................................

....................................

Finished tests in 0.510616s, 1339.5585 tests/s, 7428.2827 assertions/s.

684 tests, 3793 assertions, 0 failures, 0 errors, 0 skips




min!est/un!




Test Example

Magic Free!

Simple Subclass

Simple Method

require "minitest/autorun"

class TestThingy < MiniTest::Unit::TestCase def test_do_the_thing assert_equal 42, Thingy.do_the_thing endend




assertions




Positive Assertionsassertassert_blockassert_emptyassert_equalassert_in_deltaassert_in_epsilonassert_includesassert_instance_ofassert_kind_ofassert_match

assert_nilassert_operatorassert_outputassert_raisesassert_respond_toassert_sameassert_sendassert_silentassert_throws

Bold = new




assert_equal diffs: 1) Failure:test_failing_simple(TestSimple) [example.rb:8]:Expected: 42 Actual: 24

2) Failure:test_failing_complex(TestComplex) [example.rb:23]:--- expected+++ actual@@ -22,7 +22,7 @@ "line 22", "line 23", "line 24",- "line 25",+ "something unexpected", "line 26", "line 27", "line 28",




Negative Assertionsrefuterefute_emptyrefute_equalrefute_in_deltarefute_in_epsilonrefute_includesrefute_instance_of

refute_kind_ofrefute_matchrefute_nilrefute_operatorrefute_respond_torefute_same




Utility Methodspassskipcapture_io

flunkmu_ppmu_pp_for_diff




assert ! obj refute obj

assert collection.include? obj assert_include obj, collection

out, err = capture_io do do_somethingendassert_equal "output", outassert_equal "", err

assert_output "output", "" do do_somethingend

Why all these extra assertions?They're more expressive!




min!est/"ec




Spec Examplerequire "minitest/autorun"

describe Thingy do it "must do the thing" do Thingy.do_the_thing.must_equal 42 endend




Specs Transform:

Magic Free!

Simple Subclass

Simple Method

require "minitest/autorun"

class TestThingy < MiniTest::Unit::TestCase def test_0001_must_do_the_thing Thingy.do_the_thing.must_equal 42 endend




positive expectationsmust_bemust_be_close_tomust_be_emptymust_be_instance_ofmust_be_kind_ofmust_be_nilmust_be_same_asmust_be_silentmust_be_within_delta

must_be_within_epsilonmust_equalmust_includemust_matchmust_outputmust_raisemust_respond_tomust_sendmust_throw




negative expectationswont_bewont_be_close_towont_be_emptywont_be_instance_ofwont_be_kind_ofwont_be_nilwont_be_same_as

wont_be_within_deltawont_be_within_epsilonwont_equalwont_includewont_matchwont_respond_to




All for Freemust_equal is assert_equalwont_equal is refute_equal

etc.




Extending




minitest/unitdef assert_palindrome obj assert_equal obj, obj.reverseend

assert_palindrome @ary




minitest/specdef must_be_palindrome self.must_equal self.reverseend

# or:

infect_an_assertion(:assert_palindrome, :must_be_palindrome)

@ary.must_be_palindrome




Other Examplesassert_path_exists pathrefute_path_exists path

path.must_exist_as_path

assert_satisfied_by version, specifier

assert_dependencies expected, *specs

assert_reachable node, graph




minitest pluginscapybara_minitest_specminispec-metadataminitest-ansiminitest-aroundminitest-capistranominitest-capybaraminitest-chef-handlerminitest-ciminitest-colorizeminitest-contextminitest-debuggerminitest-displayminitest-emojiminitest-englishminitest-excludesminitest-filesystemminitest-firemock

minitest-great_expectationsminitest-growlminitest-implicit-subjectminitest-instrumentminitest-instrument-dbminitest-libnotifyminitest-lineminitest-macrubyminitest-matchersminitest-metadataminitest-mongoidminitest-must_notminitest-ncminitest-predicatesminitest-railsminitest-rails-capybaraminitest-reporters

minitest-should_syntaxminitest-shouldifyminitest-spec-contextminitest-spec-expectminitest-spec-magicminitest-spec-railsminitest-stub-constminitest-tagsminitest-wscolorminitest_owrapperminitest_shouldminitest_tu_shimmongoid-minitestpry-rescue




Min!est Design Ra#onale




Less is More




Indirection is the Enemy




minitest/unit:assert_in_delta

Only 2 other methods need to be understood:assert (9) & message (6)

simple assertion is all that is needed

message takes a block to defer

calculation until an assertion fails

def assert_in_delta exp, act, delta = 0.001, msg = nil n = (exp - act).abs msg = message(msg) { "Expected #{exp} - #{act} (#{n}) to be < #{delta}" } assert delta >= n, msgend




minitest/spec:n.must_be_close_to m

(This page intentionally left blank)




Turn up the test levels

Randomize Test Order

Require Proof of Success?

Fast

Test

Runn

er

Forced Parallelization

01

2

3

45

6 78

9

1011

Disallow meaningless assertions

???

test + spec

Benchmark TestsUse gem, not stdlib

Writ

e cu

stom

ass

ertio

ns

Refac

tor to

reus

able

testca

ses




min!est 4vs

min!est 5Friday, September 13, 13



Architecture MT4

MiniTest::Unit::Guard

MiniTest::Assertions

MiniTest::Expectations

MiniTest::Unit::TestCase

MiniTest::Spec::DSL

MiniTest::Unit::LifecycleHooks

MiniTest::Unit

MiniTest::Spec

MiniTest

MiniTest::Assertion MiniTest::PrideIO

MiniTest::PrideLOLMiniTest::Skip

Minitest::BacktraceFilter Minitest::ParallelEach Minitest::Mock




Minitest

Architecture MT5

Minitest::Reporter Minitest::Assertion

Minitest::BacktraceFilter Minitest::ParallelEach

Minitest::PrideIO

Minitest::PrideLOLMinitest::Skip Minitest::UnexpectedErrorMinitest::CompositeReporter

Minitest::Mock

Minitest::Runnable

Minitest::Guard

Minitest::Assertions

Minitest::Expectations

Minitest::Test

Minitest::Benchmark Minitest::Spec::DSL

Minitest::Test::LifecycleHooks

Minitest::BenchSpec

Minitest::Spec




MiniTest

Minitest

MiniTest::Unit

Minitest::Runnable

Minitest::Guard

Minitest::Assertions

Minitest::Expectations

Minitest::Test

Minitest::Benchmark Minitest::Spec::DSL

Minitest::Test::LifecycleHooks

Minitest::BenchSpec

Minitest::Spec

Minitest::Reporter Minitest::Assertion

Minitest::BacktraceFilter Minitest::ParallelEach

Minitest::PrideIO

Minitest::PrideLOLMinitest::Skip Minitest::UnexpectedErrorMinitest::CompositeReporter

Minitest::Mock

Differences




Reporter Enhancements

hasmany

AbstractReporter

Reporter CompositeReporter

ProgressReporter StatisticsReporter

SummaryReporter




Cal

l Flo

w M

T4




Cal

l Flo

w M

T5N

o Managers!




User-Level Changess/MiniTest/Minitest/gs/Unit::TestCase/Test/g

Assertions?No changes!




Rails




A$%eSupport::TestCase




Minitest::Test

ActiveSupport::TestCase

MyThingyTest

Basic Architecture




Per-test database transactions




Fixtures




Assertionsassert_notassert_blank → assert_predicate/must_beassert_presentassert_differenceassert_no_differenceassert_deprecatedassert_not_deprecated




Declarative Formssetup do # ...end

teardown do # ...end

test “test name” do # ...end




test/horse_test.rbrequire 'test_helper'

class HorseTest < ActiveSupport::TestCase def trigger @trigger ||= Horse.new name: "Trigger Rogers" end

def test_name assert_equal "Trigger Rogers", trigger.name end

def test_friendship assert_equal "magic", trigger.friendship endend




A$ionController::TestCase




Basic ArchitectureMinitest::Test


MyControllerTest

ActionController::TestCase




Actionsget

post

delete

etc




Staterequest

response

session

flash




Assertionsassert_response

assert_redirected_to

assert_template




Examplerequire "test_helper"

class CupcakesControllerTest < ActionController::TestCase def test_index get :index assert_response :success assert_match(/horses/i, response.body) end

def test_show get :show, id: cupcakes(:sprinkle) assert_response :success endend




A$ionView::TestCase




Minitest::Test


MyHelperTest

ActionView::TestCase lots of modules

Architecture




module CupcakesHelper def cupcake_image_tag cupcake image_tag cupcake.image_url, alt: cupcake.name endend

app/helpers/cupcakes_helper.rb




require 'test_helper'

class CupcakesHelperTest < ActionView::TestCase def setup @cupcake = Cupcake.new name: "Icy McIcerson", image_url: "http://i.imgur.com/mbWH1gM.png" end

def test_cupcake_image_tag image_tag_html = cupcake_image_tag @cupcake assert_match "alt=\"#{@cupcake.name}\"", image_tag_html assert_match "src=\"#{@cupcake.image_url}\"", image_tag_html endend

test/helpers/cupcakes_helper_test.rb


http://i.imgur.com/mbWH1gM.png

http://i.imgur.com/mbWH1gM.png



A$%eDi"at&::Integra#onTest




Minitest::Test


MyIntegrationTest

ActionDispatch::IntegrationTest

Architecture




Assertions

TonsFriday, September 13, 13



Exampleclass SmokedMeatheadTest < ActionDispatch::IntegrationTest def test_login get "/sign_in" assert_response :success

post_via_redirect("/sign_in", "athlete" => {"email" => "email", "password" => "password", "remember_me" => "0"}) assert_response :success assert_equal "/", path

get "/visualize/graph" assert_response :success assert assigns(:exercise_data) endend




Rails 4.0uses

Minitest 4




Rails 4.1uses

Minitest 5




Rails & Specs




min!est-rails




rails 4 originally used minitest/spec




DHH didn't like it




require "minitest/rails"




Eat your heart out DHHdescribe CupcakesController do it 'shows a list of cupcakes' do get :index assert_response :success end

it 'shows a cupcake' do get :show, id: cupcakes(:sprinkle) assert_response :success endend




min!est-rails-capybara




No Problem…feature "Login Feature" do given(:trigger_password) { "triggerrogers" } given(:trigger) { p = horses :trigger ... }

scenario "logging in as Trigger Rogers" do visit root_path

refute_nav_links_logged_in

click_link "login"

fill_in "Email", with: trigger.email fill_in "Password", with: trigger_password click_button "Sign in"

assert_nav_links_logged_in trigger endend




However you test…




Minitest has you covered




and then some…




'ank You



Ryan Davis, Seattle.rbMinitest & Rails, No PonyI lied!


Minitest & Rails, No Pony Ryan Davis, Seattle.rb Min est ... · Windy City Rails, Chicago, IL...

Documents

Transcript of Minitest & Rails, No Pony Ryan Davis, Seattle.rb Min est ... · Windy City Rails, Chicago, IL...