<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Testing on 100 Exercises to Learn Go</title><link>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/</link><description>Recent content in Testing on 100 Exercises to Learn Go</description><generator>Hugo</generator><language>en</language><atom:link href="https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/index.xml" rel="self" type="application/rss+xml"/><item><title>Table-Driven Tests</title><link>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/table/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/table/</guid><description>&lt;h1 id="table-driven-tests"&gt;Table-Driven Tests&lt;a class="anchor" href="#table-driven-tests"&gt;&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;You&amp;rsquo;ve &lt;em&gt;run&lt;/em&gt; dozens of table tests by now. This is the exercise where you
learn to &lt;em&gt;read&lt;/em&gt; one as a design — because from here on, every test you
write yourself will wear this shape.&lt;/p&gt;
&lt;h2 id="the-pattern-named"&gt;The pattern, named&lt;a class="anchor" href="#the-pattern-named"&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-go" data-lang="go"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;TestGrade&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;testing&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;T&lt;/span&gt;) {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;tests&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; []&lt;span style="color:#66d9ef"&gt;struct&lt;/span&gt; {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;score&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;int&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;want&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;string&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }{
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&lt;span style="color:#ae81ff"&gt;95&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;A&amp;#34;&lt;/span&gt;},
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&lt;span style="color:#ae81ff"&gt;85&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;B&amp;#34;&lt;/span&gt;},
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&lt;span style="color:#ae81ff"&gt;75&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;C&amp;#34;&lt;/span&gt;},
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&lt;span style="color:#ae81ff"&gt;59&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;F&amp;#34;&lt;/span&gt;},
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;for&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;_&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;tt&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;range&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;tests&lt;/span&gt; {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;if&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Grade&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;tt&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;score&lt;/span&gt;); &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt; &lt;span style="color:#f92672"&gt;!=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;tt&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;want&lt;/span&gt; {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Errorf&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;Grade(%d) = %q, want %q&amp;#34;&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;tt&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;score&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;tt&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;want&lt;/span&gt;)
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Table, loop, verdict. The table lists input/output pairs as data — adding
a case means adding a line, never a function. The loop runs every row. The
verdict compares and reports. Three moving parts, endless reuse: this one
shape covers the overwhelming majority of Go unit tests in the wild.&lt;/p&gt;</description></item><item><title>Subtests</title><link>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/subtests/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/subtests/</guid><description>&lt;h1 id="subtests"&gt;Subtests&lt;a class="anchor" href="#subtests"&gt;&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;Tables collect rows; subtests give them &lt;em&gt;names&lt;/em&gt;. When &lt;code&gt;TestGrade&lt;/code&gt; fails you
learn a score mismatched — but which scenario? Above? Below? The boundary
itself? &lt;code&gt;t.Run&lt;/code&gt; splits one test into labeled children, and each child
reports, passes, and filters independently.&lt;/p&gt;
&lt;h2 id="naming-the-cases"&gt;Naming the cases&lt;a class="anchor" href="#naming-the-cases"&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-go" data-lang="go"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;TestClamp&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;testing&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;T&lt;/span&gt;) {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Run&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;above&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;func&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;testing&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;T&lt;/span&gt;) {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;if&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;want&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Clamp&lt;/span&gt;(&lt;span style="color:#ae81ff"&gt;99&lt;/span&gt;, &lt;span style="color:#ae81ff"&gt;0&lt;/span&gt;, &lt;span style="color:#ae81ff"&gt;10&lt;/span&gt;), &lt;span style="color:#ae81ff"&gt;10&lt;/span&gt;; &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt; &lt;span style="color:#f92672"&gt;!=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;want&lt;/span&gt; {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Fatalf&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;Clamp(99, 0, 10) = %d, want %d&amp;#34;&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;want&lt;/span&gt;)
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; })
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Run&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;below&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;func&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;testing&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;T&lt;/span&gt;) {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#75715e"&gt;// ...&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; })
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Run&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;inside&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;func&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;testing&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;T&lt;/span&gt;) {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#75715e"&gt;// ...&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; })
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;t.Run(&amp;quot;above&amp;quot;, func(t *testing.T) {...})&lt;/code&gt; registers a child test carrying
its own &lt;code&gt;*testing.T&lt;/code&gt;. Failures name the child — &lt;code&gt;TestClamp/below&lt;/code&gt; — so the
output points at the broken &lt;em&gt;scenario&lt;/em&gt;, not just the broken function. With
&lt;code&gt;-v&lt;/code&gt;, every subtest gets its own line, PASS or FAIL; a table&amp;rsquo;s rows, by
contrast, all hide inside one verdict.&lt;/p&gt;</description></item><item><title>Test Helpers</title><link>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/helpers/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/helpers/</guid><description>&lt;h1 id="test-helpers"&gt;Test Helpers&lt;a class="anchor" href="#test-helpers"&gt;&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;The third time you type the same assertion, stop. Extract it — into a
helper function that takes &lt;code&gt;t&lt;/code&gt; and does the checking. But helpers create a
new problem: when one fails, &lt;em&gt;whose line&lt;/em&gt; does the failure point at? This
exercise&amp;rsquo;s test calls the answer before you write a line of your own.&lt;/p&gt;
&lt;h2 id="infrastructure-wears-a-mark"&gt;Infrastructure wears a mark&lt;a class="anchor" href="#infrastructure-wears-a-mark"&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-go" data-lang="go"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;mustMean&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;testing&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;T&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;xs&lt;/span&gt; []&lt;span style="color:#66d9ef"&gt;float64&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;want&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;float64&lt;/span&gt;) {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Helper&lt;/span&gt;()
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;if&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Mean&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;xs&lt;/span&gt;); &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt; &lt;span style="color:#f92672"&gt;!=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;want&lt;/span&gt; {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Fatalf&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;Mean(%v) = %v, want %v&amp;#34;&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;xs&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;want&lt;/span&gt;)
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;t.Helper()&lt;/code&gt; as the first line marks the function as scaffolding. When the
&lt;code&gt;Fatalf&lt;/code&gt; inside fires, Go skips helper frames and reports the &lt;em&gt;caller&amp;rsquo;s&lt;/em&gt;
line — the &lt;code&gt;mustMean(t, ...)&lt;/code&gt; invocation in the test, with its specific
input. Without that call, every failure would point inside the helper at
the same &lt;code&gt;t.Fatalf&lt;/code&gt; line, and you&amp;rsquo;d guess which input broke. One line of
marking, failures that locate themselves.&lt;/p&gt;</description></item><item><title>Testdata Fixtures</title><link>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/testdata/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/testdata/</guid><description>&lt;h1 id="testdata-fixtures"&gt;Testdata Fixtures&lt;a class="anchor" href="#testdata-fixtures"&gt;&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;Tests that read files need files to read — checked in, versioned, and
sitting where the test expects them. Go&amp;rsquo;s answer is a directory named
&lt;code&gt;testdata/&lt;/code&gt;, and the name is a contract with the toolchain, not a
suggestion.&lt;/p&gt;
&lt;h2 id="the-directory-the-build-ignores"&gt;The directory the build ignores&lt;a class="anchor" href="#the-directory-the-build-ignores"&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;Any directory called &lt;code&gt;testdata&lt;/code&gt; is skipped by the Go tool: &lt;code&gt;go build&lt;/code&gt;
won&amp;rsquo;t compile packages inside it, &lt;code&gt;go vet&lt;/code&gt; looks past it. That makes it
the standard home for everything tests consume but programs never import —
sample inputs, golden outputs, and in this exercise, a small poem:&lt;/p&gt;</description></item><item><title>Example Tests</title><link>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/examples/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/examples/</guid><description>&lt;h1 id="example-tests"&gt;Example Tests&lt;a class="anchor" href="#example-tests"&gt;&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;Documentation rots. Every prose claim about what code does — &amp;ldquo;returns twice
its input&amp;rdquo; — decays the moment the code changes and nobody updates the
sentence. Unless the sentence &lt;em&gt;runs&lt;/em&gt;. This exercise&amp;rsquo;s test file contains no
&lt;code&gt;Test&lt;/code&gt; function at all, yet &lt;code&gt;go test&lt;/code&gt; verifies it. Here&amp;rsquo;s how.&lt;/p&gt;
&lt;h2 id="documentation-that-executes"&gt;Documentation that executes&lt;a class="anchor" href="#documentation-that-executes"&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-go" data-lang="go"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;ExampleDouble&lt;/span&gt;() {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;fmt&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Println&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;Double&lt;/span&gt;(&lt;span style="color:#ae81ff"&gt;2&lt;/span&gt;))
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#75715e"&gt;// Output: 4&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;A function named &lt;code&gt;ExampleDouble&lt;/code&gt; is two things at once. To &lt;code&gt;godoc&lt;/code&gt; it&amp;rsquo;s
documentation, rendered beside the package&amp;rsquo;s reference page as a runnable
illustration. To &lt;code&gt;go test&lt;/code&gt; it&amp;rsquo;s a test: the body executes, stdout is
captured, and the capture is compared against the &lt;code&gt;// Output:&lt;/code&gt; comment
&lt;em&gt;line by line, byte for byte&lt;/em&gt;.&lt;/p&gt;</description></item><item><title>Benchmarks</title><link>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/benchmarks/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/benchmarks/</guid><description>&lt;h1 id="benchmarks"&gt;Benchmarks&lt;a class="anchor" href="#benchmarks"&gt;&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;Tests answer &amp;ldquo;does it work?&amp;rdquo; Benchmarks answer &amp;ldquo;how fast?&amp;rdquo; — and Go keeps
the two side by side in the same file, sharing helpers and fixtures. This
exercise&amp;rsquo;s package holds both: &lt;code&gt;TestFib&lt;/code&gt; guards correctness while
&lt;code&gt;BenchmarkFib&lt;/code&gt; times it, and a third test guards the benchmark itself.&lt;/p&gt;
&lt;h2 id="measuring-not-asserting"&gt;Measuring, not asserting&lt;a class="anchor" href="#measuring-not-asserting"&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-go" data-lang="go"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;BenchmarkFib&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;b&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;testing&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;B&lt;/span&gt;) {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;for&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;i&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#ae81ff"&gt;0&lt;/span&gt;; &lt;span style="color:#a6e22e"&gt;i&lt;/span&gt; &amp;lt; &lt;span style="color:#a6e22e"&gt;b&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;N&lt;/span&gt;; &lt;span style="color:#a6e22e"&gt;i&lt;/span&gt;&lt;span style="color:#f92672"&gt;++&lt;/span&gt; {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;Fib&lt;/span&gt;(&lt;span style="color:#ae81ff"&gt;20&lt;/span&gt;)
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;BenchmarkXxx&lt;/code&gt; takes &lt;code&gt;*testing.B&lt;/code&gt;, and &lt;code&gt;b.N&lt;/code&gt; is the runner&amp;rsquo;s dial: it calls
your function with growing &lt;code&gt;N&lt;/code&gt; until timings stabilize, then reports
nanoseconds per operation. You don&amp;rsquo;t choose the iteration count — the
harness calibrates it. Your only job is putting the operation inside the
loop, exactly once per iteration, with setup hoisted outside.&lt;/p&gt;</description></item><item><title>Asserting Errors</title><link>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/errassert/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/errassert/</guid><description>&lt;h1 id="asserting-errors"&gt;Asserting Errors&lt;a class="anchor" href="#asserting-errors"&gt;&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;The calculator section divided two ways: &lt;code&gt;Divide&lt;/code&gt; that &lt;em&gt;panics&lt;/em&gt; on zero,
and — implicitly — the question of what the alternative looks like. Here
it is. Same function name, same arithmetic, opposite philosophy: failure
as a return value the caller must confront, not an explosion it might
survive.&lt;/p&gt;
&lt;h2 id="both-branches-or-it-isnt-tested"&gt;Both branches, or it isn&amp;rsquo;t tested&lt;a class="anchor" href="#both-branches-or-it-isnt-tested"&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-go" data-lang="go"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;TestDivide&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;testing&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;T&lt;/span&gt;) {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;if&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;err&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Divide&lt;/span&gt;(&lt;span style="color:#ae81ff"&gt;6&lt;/span&gt;, &lt;span style="color:#ae81ff"&gt;3&lt;/span&gt;); &lt;span style="color:#a6e22e"&gt;err&lt;/span&gt; &lt;span style="color:#f92672"&gt;!=&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;nil&lt;/span&gt; &lt;span style="color:#f92672"&gt;||&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt; &lt;span style="color:#f92672"&gt;!=&lt;/span&gt; &lt;span style="color:#ae81ff"&gt;2&lt;/span&gt; {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Fatalf&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;Divide(6, 3) = (%d, %v), want (2, nil)&amp;#34;&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;got&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;err&lt;/span&gt;)
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;if&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;_&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;err&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Divide&lt;/span&gt;(&lt;span style="color:#ae81ff"&gt;1&lt;/span&gt;, &lt;span style="color:#ae81ff"&gt;0&lt;/span&gt;); !&lt;span style="color:#a6e22e"&gt;errors&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Is&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;err&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;ErrZeroDivisor&lt;/span&gt;) {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Fatalf&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;Divide(1, 0) err = %v, want ErrZeroDivisor&amp;#34;&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;err&lt;/span&gt;)
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Error-returning functions have two contracts, and the test pins both. The
happy path asserts &lt;em&gt;two facts&lt;/em&gt;: the value is right &lt;strong&gt;and&lt;/strong&gt; the error is
&lt;code&gt;nil&lt;/code&gt; — checking only the quotient would pass a function that divides
correctly while crying wolf. The failure path asserts identity via
&lt;code&gt;errors.Is&lt;/code&gt;, never &lt;code&gt;==&lt;/code&gt;: a wrapped &lt;code&gt;ErrZeroDivisor&lt;/code&gt; with context attached
represents the same problem, and &lt;code&gt;==&lt;/code&gt; would blind the test to it. The
sentinel lesson&amp;rsquo;s rule, enforced at the assertion site.&lt;/p&gt;</description></item><item><title>Benchmark Allocations</title><link>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/benchmark_allocs/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://hamzahraihan.github.io/100-exercises-to-learn-go/08_testing/benchmark_allocs/</guid><description>&lt;h1 id="benchmark-allocations"&gt;Benchmark Allocations&lt;a class="anchor" href="#benchmark-allocations"&gt;&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;&lt;code&gt;ns/op&lt;/code&gt; tells you how long. &lt;code&gt;allocs/op&lt;/code&gt; tells you &lt;em&gt;why&lt;/em&gt;.&lt;/p&gt;
&lt;p&gt;A function can be slow for two unrelated reasons: too much work, or too many heap allocations. The allocator has a hidden cost — each heap object means a GC scan later. &lt;code&gt;b.ReportAllocs()&lt;/code&gt; exposes what the profiler would eventually tell you, without needing &lt;code&gt;pprof&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id="reportallocs-and-resettimer"&gt;ReportAllocs and ResetTimer&lt;a class="anchor" href="#reportallocs-and-resettimer"&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-go" data-lang="go"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;BenchmarkJoin&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;b&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;testing&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;B&lt;/span&gt;) {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;b&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;ReportAllocs&lt;/span&gt;() &lt;span style="color:#75715e"&gt;// print allocs/op and B/op columns&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;words&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; []&lt;span style="color:#66d9ef"&gt;string&lt;/span&gt;{&lt;span style="color:#e6db74"&gt;&amp;#34;the&amp;#34;&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;quick&amp;#34;&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;brown&amp;#34;&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;fox&amp;#34;&lt;/span&gt;}
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;b&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;ResetTimer&lt;/span&gt;() &lt;span style="color:#75715e"&gt;// exclude setup from measurement&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;for&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;b&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Loop&lt;/span&gt;() {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#a6e22e"&gt;_&lt;/span&gt; = &lt;span style="color:#a6e22e"&gt;strings&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Join&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;words&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34; &amp;#34;&lt;/span&gt;)
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;b.ReportAllocs()&lt;/code&gt; adds two columns to the output: &lt;code&gt;allocs/op&lt;/code&gt; (heap objects created per call) and &lt;code&gt;B/op&lt;/code&gt; (bytes allocated per call). Call it at the top of the benchmark before the loop.&lt;/p&gt;</description></item></channel></rss>