diff options
Diffstat (limited to 'vendor/github.com/PuerkitoBio/goquery/testdata/gotesting.html')
| -rw-r--r-- | vendor/github.com/PuerkitoBio/goquery/testdata/gotesting.html | 855 |
1 files changed, 855 insertions, 0 deletions
diff --git a/vendor/github.com/PuerkitoBio/goquery/testdata/gotesting.html b/vendor/github.com/PuerkitoBio/goquery/testdata/gotesting.html new file mode 100644 index 0000000..ba5348f --- /dev/null +++ b/vendor/github.com/PuerkitoBio/goquery/testdata/gotesting.html @@ -0,0 +1,855 @@ +<!DOCTYPE html> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> + + <title>testing - The Go Programming Language</title> + +<link type="text/css" rel="stylesheet" href="/doc/style.css"> +<script type="text/javascript" src="/doc/godocs.js"></script> + +<link rel="search" type="application/opensearchdescription+xml" title="godoc" href="/opensearch.xml" /> + +<script type="text/javascript"> +var _gaq = _gaq || []; +_gaq.push(["_setAccount", "UA-11222381-2"]); +_gaq.push(["_trackPageview"]); +</script> +</head> +<body> + +<div id="topbar"><div class="container wide"> + +<form method="GET" action="/search"> +<div id="menu"> +<a href="/doc/">Documents</a> +<a href="/ref/">References</a> +<a href="/pkg/">Packages</a> +<a href="/project/">The Project</a> +<a href="/help/">Help</a> +<input type="text" id="search" name="q" class="inactive" value="Search"> +</div> +<div id="heading"><a href="/">The Go Programming Language</a></div> +</form> + +</div></div> + +<div id="page" class="wide"> + + + <div id="plusone"><g:plusone size="small" annotation="none"></g:plusone></div> + <h1>Package testing</h1> + + + + +<div id="nav"></div> + + +<!-- + Copyright 2009 The Go Authors. All rights reserved. + Use of this source code is governed by a BSD-style + license that can be found in the LICENSE file. +--> + + + <div id="short-nav"> + <dl> + <dd><code>import "testing"</code></dd> + </dl> + <dl> + <dd><a href="#overview" class="overviewLink">Overview</a></dd> + <dd><a href="#index">Index</a></dd> + + + <dd><a href="#subdirectories">Subdirectories</a></dd> + + </dl> + </div> + <!-- The package's Name is printed as title by the top-level template --> + <div id="overview" class="toggleVisible"> + <div class="collapsed"> + <h2 class="toggleButton" title="Click to show Overview section">Overview ▹</h2> + </div> + <div class="expanded"> + <h2 class="toggleButton" title="Click to hide Overview section">Overview ▾</h2> + <p> +Package testing provides support for automated testing of Go packages. +It is intended to be used in concert with the “go test” command, which automates +execution of any function of the form +</p> +<pre>func TestXxx(*testing.T) +</pre> +<p> +where Xxx can be any alphanumeric string (but the first letter must not be in +[a-z]) and serves to identify the test routine. +These TestXxx routines should be declared within the package they are testing. +</p> +<p> +Functions of the form +</p> +<pre>func BenchmarkXxx(*testing.B) +</pre> +<p> +are considered benchmarks, and are executed by the "go test" command when +the -test.bench flag is provided. +</p> +<p> +A sample benchmark function looks like this: +</p> +<pre>func BenchmarkHello(b *testing.B) { + for i := 0; i < b.N; i++ { + fmt.Sprintf("hello") + } +} +</pre> +<p> +The benchmark package will vary b.N until the benchmark function lasts +long enough to be timed reliably. The output +</p> +<pre>testing.BenchmarkHello 10000000 282 ns/op +</pre> +<p> +means that the loop ran 10000000 times at a speed of 282 ns per loop. +</p> +<p> +If a benchmark needs some expensive setup before running, the timer +may be stopped: +</p> +<pre>func BenchmarkBigLen(b *testing.B) { + b.StopTimer() + big := NewBig() + b.StartTimer() + for i := 0; i < b.N; i++ { + big.Len() + } +} +</pre> +<p> +The package also runs and verifies example code. Example functions may +include a concluding comment that begins with "Output:" and is compared with +the standard output of the function when the tests are run, as in these +examples of an example: +</p> +<pre>func ExampleHello() { + fmt.Println("hello") + // Output: hello +} + +func ExampleSalutations() { + fmt.Println("hello, and") + fmt.Println("goodbye") + // Output: + // hello, and + // goodbye +} +</pre> +<p> +Example functions without output comments are compiled but not executed. +</p> +<p> +The naming convention to declare examples for a function F, a type T and +method M on type T are: +</p> +<pre>func ExampleF() { ... } +func ExampleT() { ... } +func ExampleT_M() { ... } +</pre> +<p> +Multiple example functions for a type/function/method may be provided by +appending a distinct suffix to the name. The suffix must start with a +lower-case letter. +</p> +<pre>func ExampleF_suffix() { ... } +func ExampleT_suffix() { ... } +func ExampleT_M_suffix() { ... } +</pre> +<p> +The entire test file is presented as the example when it contains a single +example function, at least one other function, type, variable, or constant +declaration, and no test or benchmark functions. +</p> + + </div> + </div> + + + <h2 id="index">Index</h2> + <!-- Table of contents for API; must be named manual-nav to turn off auto nav. --> + <div id="manual-nav"> + <dl> + + + + + <dd><a href="#Main">func Main(matchString func(pat, str string) (bool, error), tests []InternalTest, benchmarks []InternalBenchmark, examples []InternalExample)</a></dd> + + + <dd><a href="#RunBenchmarks">func RunBenchmarks(matchString func(pat, str string) (bool, error), benchmarks []InternalBenchmark)</a></dd> + + + <dd><a href="#RunExamples">func RunExamples(matchString func(pat, str string) (bool, error), examples []InternalExample) (ok bool)</a></dd> + + + <dd><a href="#RunTests">func RunTests(matchString func(pat, str string) (bool, error), tests []InternalTest) (ok bool)</a></dd> + + + <dd><a href="#Short">func Short() bool</a></dd> + + + + <dd><a href="#B">type B</a></dd> + + + + <dd> <a href="#B.Error">func (c *B) Error(args ...interface{})</a></dd> + + + <dd> <a href="#B.Errorf">func (c *B) Errorf(format string, args ...interface{})</a></dd> + + + <dd> <a href="#B.Fail">func (c *B) Fail()</a></dd> + + + <dd> <a href="#B.FailNow">func (c *B) FailNow()</a></dd> + + + <dd> <a href="#B.Failed">func (c *B) Failed() bool</a></dd> + + + <dd> <a href="#B.Fatal">func (c *B) Fatal(args ...interface{})</a></dd> + + + <dd> <a href="#B.Fatalf">func (c *B) Fatalf(format string, args ...interface{})</a></dd> + + + <dd> <a href="#B.Log">func (c *B) Log(args ...interface{})</a></dd> + + + <dd> <a href="#B.Logf">func (c *B) Logf(format string, args ...interface{})</a></dd> + + + <dd> <a href="#B.ResetTimer">func (b *B) ResetTimer()</a></dd> + + + <dd> <a href="#B.SetBytes">func (b *B) SetBytes(n int64)</a></dd> + + + <dd> <a href="#B.StartTimer">func (b *B) StartTimer()</a></dd> + + + <dd> <a href="#B.StopTimer">func (b *B) StopTimer()</a></dd> + + + + <dd><a href="#BenchmarkResult">type BenchmarkResult</a></dd> + + + <dd> <a href="#Benchmark">func Benchmark(f func(b *B)) BenchmarkResult</a></dd> + + + + <dd> <a href="#BenchmarkResult.NsPerOp">func (r BenchmarkResult) NsPerOp() int64</a></dd> + + + <dd> <a href="#BenchmarkResult.String">func (r BenchmarkResult) String() string</a></dd> + + + + <dd><a href="#InternalBenchmark">type InternalBenchmark</a></dd> + + + + + <dd><a href="#InternalExample">type InternalExample</a></dd> + + + + + <dd><a href="#InternalTest">type InternalTest</a></dd> + + + + + <dd><a href="#T">type T</a></dd> + + + + <dd> <a href="#T.Error">func (c *T) Error(args ...interface{})</a></dd> + + + <dd> <a href="#T.Errorf">func (c *T) Errorf(format string, args ...interface{})</a></dd> + + + <dd> <a href="#T.Fail">func (c *T) Fail()</a></dd> + + + <dd> <a href="#T.FailNow">func (c *T) FailNow()</a></dd> + + + <dd> <a href="#T.Failed">func (c *T) Failed() bool</a></dd> + + + <dd> <a href="#T.Fatal">func (c *T) Fatal(args ...interface{})</a></dd> + + + <dd> <a href="#T.Fatalf">func (c *T) Fatalf(format string, args ...interface{})</a></dd> + + + <dd> <a href="#T.Log">func (c *T) Log(args ...interface{})</a></dd> + + + <dd> <a href="#T.Logf">func (c *T) Logf(format string, args ...interface{})</a></dd> + + + <dd> <a href="#T.Parallel">func (t *T) Parallel()</a></dd> + + + + </dl> + + + + + <h4>Package files</h4> + <p> + <span style="font-size:90%"> + + <a href="/src/pkg/testing/benchmark.go">benchmark.go</a> + + <a href="/src/pkg/testing/example.go">example.go</a> + + <a href="/src/pkg/testing/testing.go">testing.go</a> + + </span> + </p> + + + + + + + + <h2 id="Main">func <a href="/src/pkg/testing/testing.go?s=9750:9890#L268">Main</a></h2> + <pre>func Main(matchString func(pat, str string) (bool, error), tests []InternalTest, benchmarks []InternalBenchmark, examples []InternalExample)</pre> + <p> +An internal function but exported because it is cross-package; part of the implementation +of the "go test" command. +</p> + + + + + + <h2 id="RunBenchmarks">func <a href="/src/pkg/testing/benchmark.go?s=5365:5464#L207">RunBenchmarks</a></h2> + <pre>func RunBenchmarks(matchString func(pat, str string) (bool, error), benchmarks []InternalBenchmark)</pre> + <p> +An internal function but exported because it is cross-package; part of the implementation +of the "go test" command. +</p> + + + + + + <h2 id="RunExamples">func <a href="/src/pkg/testing/example.go?s=314:417#L12">RunExamples</a></h2> + <pre>func RunExamples(matchString func(pat, str string) (bool, error), examples []InternalExample) (ok bool)</pre> + + + + + + <h2 id="RunTests">func <a href="/src/pkg/testing/testing.go?s=10486:10580#L297">RunTests</a></h2> + <pre>func RunTests(matchString func(pat, str string) (bool, error), tests []InternalTest) (ok bool)</pre> + + + + + + <h2 id="Short">func <a href="/src/pkg/testing/testing.go?s=4859:4876#L117">Short</a></h2> + <pre>func Short() bool</pre> + <p> +Short reports whether the -test.short flag is set. +</p> + + + + + + + <h2 id="B">type <a href="/src/pkg/testing/benchmark.go?s=743:872#L17">B</a></h2> + <pre>type B struct { + N int + <span class="comment">// contains filtered or unexported fields</span> +}</pre> + <p> +B is a type passed to Benchmark functions to manage benchmark +timing and to specify the number of iterations to run. +</p> + + + + + + + + + + + + + <h3 id="B.Error">func (*B) <a href="/src/pkg/testing/testing.go?s=8110:8153#L209">Error</a></h3> + <pre>func (c *B) Error(args ...interface{})</pre> + <p> +Error is equivalent to Log() followed by Fail(). +</p> + + + + + + <h3 id="B.Errorf">func (*B) <a href="/src/pkg/testing/testing.go?s=8253:8312#L215">Errorf</a></h3> + <pre>func (c *B) Errorf(format string, args ...interface{})</pre> + <p> +Errorf is equivalent to Logf() followed by Fail(). +</p> + + + + + + <h3 id="B.Fail">func (*B) <a href="/src/pkg/testing/testing.go?s=6270:6293#L163">Fail</a></h3> + <pre>func (c *B) Fail()</pre> + <p> +Fail marks the function as having failed but continues execution. +</p> + + + + + + <h3 id="B.FailNow">func (*B) <a href="/src/pkg/testing/testing.go?s=6548:6574#L170">FailNow</a></h3> + <pre>func (c *B) FailNow()</pre> + <p> +FailNow marks the function as having failed and stops its execution. +Execution will continue at the next test or benchmark. +</p> + + + + + + <h3 id="B.Failed">func (*B) <a href="/src/pkg/testing/testing.go?s=6366:6396#L166">Failed</a></h3> + <pre>func (c *B) Failed() bool</pre> + <p> +Failed returns whether the function has failed. +</p> + + + + + + <h3 id="B.Fatal">func (*B) <a href="/src/pkg/testing/testing.go?s=8420:8463#L221">Fatal</a></h3> + <pre>func (c *B) Fatal(args ...interface{})</pre> + <p> +Fatal is equivalent to Log() followed by FailNow(). +</p> + + + + + + <h3 id="B.Fatalf">func (*B) <a href="/src/pkg/testing/testing.go?s=8569:8628#L227">Fatalf</a></h3> + <pre>func (c *B) Fatalf(format string, args ...interface{})</pre> + <p> +Fatalf is equivalent to Logf() followed by FailNow(). +</p> + + + + + + <h3 id="B.Log">func (*B) <a href="/src/pkg/testing/testing.go?s=7763:7804#L202">Log</a></h3> + <pre>func (c *B) Log(args ...interface{})</pre> + <p> +Log formats its arguments using default formatting, analogous to Println(), +and records the text in the error log. +</p> + + + + + + <h3 id="B.Logf">func (*B) <a href="/src/pkg/testing/testing.go?s=7959:8016#L206">Logf</a></h3> + <pre>func (c *B) Logf(format string, args ...interface{})</pre> + <p> +Logf formats its arguments according to the format, analogous to Printf(), +and records the text in the error log. +</p> + + + + + + <h3 id="B.ResetTimer">func (*B) <a href="/src/pkg/testing/benchmark.go?s=1503:1527#L48">ResetTimer</a></h3> + <pre>func (b *B) ResetTimer()</pre> + <p> +ResetTimer sets the elapsed benchmark time to zero. +It does not affect whether the timer is running. +</p> + + + + + + <h3 id="B.SetBytes">func (*B) <a href="/src/pkg/testing/benchmark.go?s=1728:1757#L57">SetBytes</a></h3> + <pre>func (b *B) SetBytes(n int64)</pre> + <p> +SetBytes records the number of bytes processed in a single operation. +If this is called, the benchmark will report ns/op and MB/s. +</p> + + + + + + <h3 id="B.StartTimer">func (*B) <a href="/src/pkg/testing/benchmark.go?s=1047:1071#L29">StartTimer</a></h3> + <pre>func (b *B) StartTimer()</pre> + <p> +StartTimer starts timing a test. This function is called automatically +before a benchmark starts, but it can also used to resume timing after +a call to StopTimer. +</p> + + + + + + <h3 id="B.StopTimer">func (*B) <a href="/src/pkg/testing/benchmark.go?s=1288:1311#L39">StopTimer</a></h3> + <pre>func (b *B) StopTimer()</pre> + <p> +StopTimer stops timing a test. This can be used to pause the timer +while performing complex initialization that you don't +want to measure. +</p> + + + + + + + + <h2 id="BenchmarkResult">type <a href="/src/pkg/testing/benchmark.go?s=4206:4391#L165">BenchmarkResult</a></h2> + <pre>type BenchmarkResult struct { + N int <span class="comment">// The number of iterations.</span> + T time.Duration <span class="comment">// The total time taken.</span> + Bytes int64 <span class="comment">// Bytes processed in one iteration.</span> +}</pre> + <p> +The results of a benchmark run. +</p> + + + + + + + + + + + <h3 id="Benchmark">func <a href="/src/pkg/testing/benchmark.go?s=7545:7589#L275">Benchmark</a></h3> + <pre>func Benchmark(f func(b *B)) BenchmarkResult</pre> + <p> +Benchmark benchmarks a single function. Useful for creating +custom benchmarks that do not use the "go test" command. +</p> + + + + + + + <h3 id="BenchmarkResult.NsPerOp">func (BenchmarkResult) <a href="/src/pkg/testing/benchmark.go?s=4393:4433#L171">NsPerOp</a></h3> + <pre>func (r BenchmarkResult) NsPerOp() int64</pre> + + + + + + <h3 id="BenchmarkResult.String">func (BenchmarkResult) <a href="/src/pkg/testing/benchmark.go?s=4677:4717#L185">String</a></h3> + <pre>func (r BenchmarkResult) String() string</pre> + + + + + + + + <h2 id="InternalBenchmark">type <a href="/src/pkg/testing/benchmark.go?s=555:618#L10">InternalBenchmark</a></h2> + <pre>type InternalBenchmark struct { + Name string + F func(b *B) +}</pre> + <p> +An internal type but exported because it is cross-package; part of the implementation +of the "go test" command. +</p> + + + + + + + + + + + + + + + <h2 id="InternalExample">type <a href="/src/pkg/testing/example.go?s=236:312#L6">InternalExample</a></h2> + <pre>type InternalExample struct { + Name string + F func() + Output string +}</pre> + + + + + + + + + + + + + + + <h2 id="InternalTest">type <a href="/src/pkg/testing/testing.go?s=9065:9121#L241">InternalTest</a></h2> + <pre>type InternalTest struct { + Name string + F func(*T) +}</pre> + <p> +An internal type but exported because it is cross-package; part of the implementation +of the "go test" command. +</p> + + + + + + + + + + + + + + + <h2 id="T">type <a href="/src/pkg/testing/testing.go?s=6070:6199#L156">T</a></h2> + <pre>type T struct { + <span class="comment">// contains filtered or unexported fields</span> +}</pre> + <p> +T is a type passed to Test functions to manage test state and support formatted test logs. +Logs are accumulated during execution and dumped to standard error when done. +</p> + + + + + + + + + + + + + <h3 id="T.Error">func (*T) <a href="/src/pkg/testing/testing.go?s=8110:8153#L209">Error</a></h3> + <pre>func (c *T) Error(args ...interface{})</pre> + <p> +Error is equivalent to Log() followed by Fail(). +</p> + + + + + + <h3 id="T.Errorf">func (*T) <a href="/src/pkg/testing/testing.go?s=8253:8312#L215">Errorf</a></h3> + <pre>func (c *T) Errorf(format string, args ...interface{})</pre> + <p> +Errorf is equivalent to Logf() followed by Fail(). +</p> + + + + + + <h3 id="T.Fail">func (*T) <a href="/src/pkg/testing/testing.go?s=6270:6293#L163">Fail</a></h3> + <pre>func (c *T) Fail()</pre> + <p> +Fail marks the function as having failed but continues execution. +</p> + + + + + + <h3 id="T.FailNow">func (*T) <a href="/src/pkg/testing/testing.go?s=6548:6574#L170">FailNow</a></h3> + <pre>func (c *T) FailNow()</pre> + <p> +FailNow marks the function as having failed and stops its execution. +Execution will continue at the next test or benchmark. +</p> + + + + + + <h3 id="T.Failed">func (*T) <a href="/src/pkg/testing/testing.go?s=6366:6396#L166">Failed</a></h3> + <pre>func (c *T) Failed() bool</pre> + <p> +Failed returns whether the function has failed. +</p> + + + + + + <h3 id="T.Fatal">func (*T) <a href="/src/pkg/testing/testing.go?s=8420:8463#L221">Fatal</a></h3> + <pre>func (c *T) Fatal(args ...interface{})</pre> + <p> +Fatal is equivalent to Log() followed by FailNow(). +</p> + + + + + + <h3 id="T.Fatalf">func (*T) <a href="/src/pkg/testing/testing.go?s=8569:8628#L227">Fatalf</a></h3> + <pre>func (c *T) Fatalf(format string, args ...interface{})</pre> + <p> +Fatalf is equivalent to Logf() followed by FailNow(). +</p> + + + + + + <h3 id="T.Log">func (*T) <a href="/src/pkg/testing/testing.go?s=7763:7804#L202">Log</a></h3> + <pre>func (c *T) Log(args ...interface{})</pre> + <p> +Log formats its arguments using default formatting, analogous to Println(), +and records the text in the error log. +</p> + + + + + + <h3 id="T.Logf">func (*T) <a href="/src/pkg/testing/testing.go?s=7959:8016#L206">Logf</a></h3> + <pre>func (c *T) Logf(format string, args ...interface{})</pre> + <p> +Logf formats its arguments according to the format, analogous to Printf(), +and records the text in the error log. +</p> + + + + + + <h3 id="T.Parallel">func (*T) <a href="/src/pkg/testing/testing.go?s=8809:8831#L234">Parallel</a></h3> + <pre>func (t *T) Parallel()</pre> + <p> +Parallel signals that this test is to be run in parallel with (and only with) +other parallel tests in this CPU group. +</p> + + + + + + </div> + + + + + + + + + + + + + <h2 id="subdirectories">Subdirectories</h2> + + <table class="dir"> + <tr> + <th>Name</th> + <th> </th> + <th style="text-align: left; width: auto">Synopsis</th> + </tr> + + <tr> + <td><a href="..">..</a></td> + </tr> + + + + <tr> + <td class="name"><a href="iotest">iotest</a></td> + <td> </td> + <td style="width: auto">Package iotest implements Readers and Writers useful mainly for testing.</td> + </tr> + + + + <tr> + <td class="name"><a href="quick">quick</a></td> + <td> </td> + <td style="width: auto">Package quick implements utility functions to help with black box testing.</td> + </tr> + + + </table> + + + + +</div> + +<div id="footer"> +Build version go1.0.2.<br> +Except as <a href="http://code.google.com/policies.html#restrictions">noted</a>, +the content of this page is licensed under the +Creative Commons Attribution 3.0 License, +and code is licensed under a <a href="/LICENSE">BSD license</a>.<br> +<a href="/doc/tos.html">Terms of Service</a> | +<a href="http://www.google.com/intl/en/privacy/privacy-policy.html">Privacy Policy</a> +</div> + +<script type="text/javascript"> +(function() { + var ga = document.createElement("script"); ga.type = "text/javascript"; ga.async = true; + ga.src = ("https:" == document.location.protocol ? "https://ssl" : "http://www") + ".google-analytics.com/ga.js"; + var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(ga, s); +})(); +</script> +</body> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</html> + |