package_service.html 7.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268
  1. <!--
  2. Copyright 2009 The Go Authors. All rights reserved.
  3. Use of this source code is governed by a BSD-style
  4. license that can be found in the LICENSE file.
  5. -->
  6. <!--
  7. Note: Static (i.e., not template-generated) href and id
  8. attributes start with "pkg-" to make it impossible for
  9. them to conflict with generated attributes (some of which
  10. correspond to Go identifiers).
  11. -->
  12. {{with .PDoc}}
  13. <script type='text/javascript'>
  14. document.ANALYSIS_DATA = {{$.AnalysisData}};
  15. document.CALLGRAPH = {{$.CallGraph}};
  16. </script>
  17. {{if $.IsMain}}
  18. {{/* command documentation */}}
  19. {{comment_html .Doc}}
  20. {{else}}
  21. {{/* package documentation */}}
  22. <div id="short-nav">
  23. <dl>
  24. <dd><code>import "github.com/aws/aws-sdk-go/{{html .ImportPath}}"</code></dd>
  25. </dl>
  26. <dl>
  27. <dd><a href="#pkg-overview" class="overviewLink">Overview</a></dd>
  28. {{if .Consts}}
  29. <dd><a href="#pkg-constants" class="examplesLink">Constants</a></dd>
  30. {{end}}
  31. {{if $.Examples}}
  32. <dd><a href="#pkg-examples" class="examplesLink">Examples</a></dd>
  33. {{end}}
  34. </dl>
  35. </div>
  36. <!-- The package's Name is printed as title by the top-level template -->
  37. <div id="pkg-overview" class="toggleVisible">
  38. <div class="collapsed">
  39. <h2 class="toggleButton" title="Click to show Overview section">Overview ▹</h2>
  40. </div>
  41. <div class="expanded">
  42. <h2 class="toggleButton" title="Click to hide Overview section">Overview ▾</h2>
  43. {{comment_html .Doc}}
  44. <p>
  45. {{if ne $.IfaceLink ""}}
  46. The stub package, <a href={{$.IfaceLink}}>{{$.PDoc.Name}}iface</a>, can be used to provide alternative implementations of service clients,
  47. such as mocking the client for testing.
  48. {{end}}
  49. </p?>
  50. </div>
  51. </div>
  52. {{example_html $ ""}}
  53. <div id="pkg-operations" class="toggle">
  54. <div class="collapsed">
  55. <h2 class="toggleButton" title="Click to show Index section">Operations ▹</h2>
  56. </div>
  57. <div class="expanded">
  58. <h2 class="toggleButton" title="Click to hide Index section">Operations ▾</h2>
  59. <!-- Table of contents for API; must be named manual-nav to turn off auto nav. -->
  60. <div id="manual-nav">
  61. <dl>
  62. {{range .Funcs}}
  63. {{$name_html := html .Name}}
  64. <dd><a href="#{{$name_html}}">{{node_html $ .Decl false | sanitize}}</a></dd>
  65. {{end}}
  66. {{range .Types}}
  67. {{$tname_html := html .Name}}
  68. {{range .Funcs}}
  69. {{$name_html := html .Name}}
  70. <dd><a href="#{{$name_html}}">{{node_html $ .Decl false | sanitize}}</a></dd>
  71. {{end}}
  72. {{range .Methods}}
  73. <!-- Hide stringers -->
  74. {{if (and (ne .Name "String") (ne .Name "GoString")) }}
  75. {{if (ne .Name "Validate") }}
  76. {{$name_html := html .Name}}
  77. <dd><a href="#{{$tname_html}}.{{$name_html}}">{{node_html $ .Decl false | sanitize}}</a></dd>
  78. {{end}}
  79. {{end}}
  80. {{end}}
  81. {{end}}
  82. {{if $.Notes}}
  83. {{range $marker, $item := $.Notes}}
  84. <dd><a href="#pkg-note-{{$marker}}">{{noteTitle $marker | html}}s</a></dd>
  85. {{end}}
  86. {{end}}
  87. </dl>
  88. </div><!-- #manual-nav -->
  89. <!--{{if $.Examples}}
  90. <div id="pkg-examples">
  91. <h4>Examples</h4>
  92. <dl>
  93. {{range $.Examples}}
  94. <dd><a class="exampleLink" href="#example_{{.Name}}">{{example_name .Name}}</a></dd>
  95. {{end}}
  96. </dl>
  97. </div>
  98. {{end}}-->
  99. <!--{{with .Filenames}}
  100. <h4>Package files</h4>
  101. <p>
  102. <span style="font-size:90%">
  103. {{range .}}
  104. <a href="{{.|srcLink|html}}">{{.|filename|html}}</a>
  105. {{end}}
  106. </span>
  107. </p>
  108. {{end}}-->
  109. </div><!-- .expanded -->
  110. </div><!-- #pkg-index -->
  111. <div id="pkg-types" class="toggle">
  112. <div class="collapsed">
  113. <h2 class="toggleButton" title="Click to show Index section">Types ▹</h2>
  114. </div>
  115. <div class="expanded">
  116. <h2 class="toggleButton" title="Click to hide Index section">Types ▾</h2>
  117. {{if .Vars}}
  118. <dd><a href="#pkg-variables">Variables</a></dd>
  119. {{end}}
  120. {{range .Types}}
  121. {{$tname_html := html .Name}}
  122. <dd><a href="#{{$tname_html}}">type {{$tname_html}}</a></dd>
  123. {{end}}
  124. </div>
  125. </div>
  126. {{if $.Examples}}
  127. <div id="pkg-examples" class="toggle">
  128. <div class="collapsed">
  129. <h2 class="toggleButton" title="Click to show Index section">Examples ▹</h2>
  130. </div>
  131. <div class="expanded">
  132. <h2 class="toggleButton" title="Click to hide Index section">Examples ▾</h2>
  133. <div id="pkg-examples">
  134. <dl>
  135. {{range $.Examples}}
  136. <dd><a class="exampleLink" href="#example_{{.Name}}">{{example_name .Name}}</a></dd>
  137. {{end}}
  138. </dl>
  139. </div>
  140. </div>
  141. </div>
  142. {{end}}
  143. <div id="pkg-callgraph" class="toggle" style="display: none">
  144. <div class="collapsed">
  145. <h2 class="toggleButton" title="Click to show Internal Call Graph section">Internal call graph ▹</h2>
  146. </div> <!-- .expanded -->
  147. <div class="expanded">
  148. <h2 class="toggleButton" title="Click to hide Internal Call Graph section">Internal call graph ▾</h2>
  149. <p>
  150. In the call graph viewer below, each node
  151. is a function belonging to this package
  152. and its children are the functions it
  153. calls&mdash;perhaps dynamically.
  154. </p>
  155. <p>
  156. The root nodes are the entry points of the
  157. package: functions that may be called from
  158. outside the package.
  159. There may be non-exported or anonymous
  160. functions among them if they are called
  161. dynamically from another package.
  162. </p>
  163. <p>
  164. Click a node to visit that function's source code.
  165. From there you can visit its callers by
  166. clicking its declaring <code>func</code>
  167. token.
  168. </p>
  169. <p>
  170. Functions may be omitted if they were
  171. determined to be unreachable in the
  172. particular programs or tests that were
  173. analyzed.
  174. </p>
  175. <!-- Zero means show all package entry points. -->
  176. <ul style="margin-left: 0.5in" id="callgraph-0" class="treeview"></ul>
  177. </div>
  178. </div> <!-- #pkg-callgraph -->
  179. {{with .Consts}}
  180. <h2 id="pkg-constants">Constants</h2>
  181. {{range .}}
  182. <pre>{{node_html $ .Decl true}}</pre>
  183. {{comment_html .Doc}}
  184. {{end}}
  185. {{end}}
  186. {{with .Vars}}
  187. <h2 id="pkg-variables">Variables</h2>
  188. {{range .}}
  189. <pre>{{node_html $ .Decl true}}</pre>
  190. {{comment_html .Doc}}
  191. {{end}}
  192. {{end}}
  193. {{range .Funcs}}
  194. {{/* Name is a string - no need for FSet */}}
  195. {{$name_html := html .Name}}
  196. <h2 id="{{$name_html}}">func <a href="{{posLink_url $ .Decl}}">{{$name_html}}</a></h2>
  197. <pre>{{node_html $ .Decl true}}</pre>
  198. {{comment_html .Doc}}
  199. {{example_html $ .Name}}
  200. {{callgraph_html $ "" .Name}}
  201. {{end}}
  202. {{range .Types}}
  203. {{$tname := .Name}}
  204. {{$tname_html := html .Name}}
  205. <h2 id="{{$tname_html}}">type <a href="{{posLink_url $ .Decl}}">{{$tname_html}}</a></h2>
  206. <pre>{{node_html $ .Decl true}}</pre>
  207. {{comment_html .Doc}}
  208. {{range .Consts}}
  209. <pre>{{node_html $ .Decl true}}</pre>
  210. {{comment_html .Doc}}
  211. {{end}}
  212. {{range .Vars}}
  213. <pre>{{node_html $ .Decl true}}</pre>
  214. {{comment_html .Doc}}
  215. {{end}}
  216. {{example_html $ $tname}}
  217. {{implements_html $ $tname}}
  218. {{methodset_html $ $tname}}
  219. {{range .Funcs}}
  220. {{$name_html := html .Name}}
  221. <h3 id="{{$name_html}}">func <a href="{{posLink_url $ .Decl}}">{{$name_html}}</a></h3>
  222. <pre>{{node_html $ .Decl true}}</pre>
  223. {{comment_html .Doc}}
  224. {{example_html $ .Name}}
  225. {{callgraph_html $ "" .Name}}
  226. {{end}}
  227. {{range .Methods}}
  228. {{$name_html := html .Name}}
  229. <h3 id="{{$tname_html}}.{{$name_html}}">func ({{html .Recv}}) <a href="{{posLink_url $ .Decl}}">{{$name_html}}</a></h3>
  230. <pre>{{node_html $ .Decl true}}</pre>
  231. {{comment_html .Doc}}
  232. {{$name := printf "%s_%s" $tname .Name}}
  233. {{example_html $ $name}}
  234. {{callgraph_html $ .Recv .Name}}
  235. {{end}}
  236. {{end}}
  237. {{end}}
  238. {{with $.Notes}}
  239. {{range $marker, $content := .}}
  240. <h2 id="pkg-note-{{$marker}}">{{noteTitle $marker | html}}s</h2>
  241. <ul style="list-style: none; padding: 0;">
  242. {{range .}}
  243. <li><a href="{{posLink_url $ .}}">&#x261e;</a> {{html .Body}}</li>
  244. {{end}}
  245. </ul>
  246. {{end}}
  247. {{end}}
  248. {{end}}
  249. {{with .PAst}}
  250. {{range $filename, $ast := .}}
  251. <a href="{{$filename|srcLink|html}}">{{$filename|filename|html}}</a>:<pre>{{node_html $ $ast false}}</pre>
  252. {{end}}
  253. {{end}}