You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@thrift.apache.org by gi...@apache.org on 2021/09/11 11:57:24 UTC
[thrift-website] branch asf-staging updated: Automatic Site Publish
by Buildbot
This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/thrift-website.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new 93fae6a Automatic Site Publish by Buildbot
93fae6a is described below
commit 93fae6a4f3d6baff39d7d188080881aee9dd6d79
Author: buildbot <us...@infra.apache.org>
AuthorDate: Sat Sep 11 11:57:23 2021 +0000
Automatic Site Publish by Buildbot
---
output/docs/Languages.html | 2 +-
output/docs/committers/HowToThriftWebsite.html | 4 ++--
output/docs/idl.html | 2 +-
output/download.html | 10 ++++-----
output/index.html | 10 ++++-----
output/lib/go.html | 29 ++++++++++++++++++++------
output/test/ThriftTest.thrift | 5 +++++
output/tutorial/go.html | 26 ++++++++++-------------
8 files changed, 53 insertions(+), 35 deletions(-)
diff --git a/output/docs/Languages.html b/output/docs/Languages.html
index e4e07f3..aad5691 100644
--- a/output/docs/Languages.html
+++ b/output/docs/Languages.html
@@ -204,7 +204,7 @@ Thrift’s core protocol is TBinary, supported by all languages except for J
<td align="left"><a href="https://github.com/apache/thrift/blob/master/lib/go/README.md">Go</a></td>
<!-- Since -----------------><td>0.7.0</td>
<!-- Build Systems ---------><td><img src="doc/images/cgrn.png" alt="Yes" /></td><td><img src="doc/images/cred.png" alt="" /></td>
-<!-- Language Levels -------><td>1.14.14</td><td>1.15.7</td>
+<!-- Language Levels -------><td>1.16.7</td><td>1.17</td>
<!-- Low-Level Transports --><td><img src="doc/images/cred.png" alt="" /></td><td><img src="doc/images/cred.png" alt="" /></td><td><img src="doc/images/cgrn.png" alt="Yes" /></td><td><img src="doc/images/cred.png" alt="" /></td><td><img src="doc/images/cgrn.png" alt="Yes" /></td><td><img src="doc/images/cgrn.png" alt="Yes" /></td>
<!-- Transport Wrappers ----><td><img src="doc/images/cgrn.png" alt="Yes" /></td><td><img src="doc/images/cred.png" alt="" /></td><td><img src="doc/images/cgrn.png" alt="Yes" /></td><td><img src="doc/images/cgrn.png" alt="Yes" /></td>
<!-- Protocols -------------><td><img src="doc/images/cgrn.png" alt="Yes" /></td><td><img src="doc/images/cgrn.png" alt="Yes" /></td><td><img src="doc/images/cgrn.png" alt="Yes" /></td><td><img src="doc/images/cgrn.png" alt="Yes" /></td>
diff --git a/output/docs/committers/HowToThriftWebsite.html b/output/docs/committers/HowToThriftWebsite.html
index 4536239..ee8c72d 100644
--- a/output/docs/committers/HowToThriftWebsite.html
+++ b/output/docs/committers/HowToThriftWebsite.html
@@ -101,8 +101,8 @@ consistent experience with the various markdown parsers deployed by the CMS.</p>
file” <a href="https://svn.apache.org/repos/asf/thrift/cms-site/trunk/lib/path.pm">lib/path.pm</a>. Update
the following values and then following <b>Updating the Website</b> section below</p>
-<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>current_release: "0.14.2"
-current_release_date: "2021-JUN-17"
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>current_release: "0.15.0"
+current_release_date: "2021-SEP-11"
</code></pre></div></div>
<h3 id="updating-the-website">Updating the website</h3>
diff --git a/output/docs/idl.html b/output/docs/idl.html
index 1845000..2dbef98 100644
--- a/output/docs/idl.html
+++ b/output/docs/idl.html
@@ -52,7 +52,7 @@
<h2 id="thrift-interface-description-language">Thrift interface description language</h2>
-<p>For Thrift version 0.15.0.</p>
+<p>For Thrift version 0.16.0.</p>
<p>The Thrift interface definition language (IDL) allows for the definition of <a href="/docs/types">Thrift Types</a>. A Thrift IDL file is processed by the Thrift code generator to produce code for the various target languages to support the defined structs and services in the IDL file.</p>
diff --git a/output/download.html b/output/download.html
index 5e510bd..f8c7fdc 100644
--- a/output/download.html
+++ b/output/download.html
@@ -50,19 +50,19 @@
<div class="container">
<h2 id="release">Release</h2>
-<p>The latest stable release of Thrift is 0.14.2 (released on 2021-JUN-17).</p>
+<p>The latest stable release of Thrift is 0.15.0 (released on 2021-SEP-11).</p>
<ul>
- <li><a href="http://www.apache.org/dyn/closer.cgi?path=/thrift/0.14.2/thrift-0.14.2.tar.gz">thrift-0.14.2.tar.gz</a> [<a href="https://www.apache.org/dist/thrift/0.14.2/thrift-0.14.2.tar.gz.asc">PGP</a>]
-[<a href="https://www.apache.org/dist/thrift/0.14.2/thrift-0.14.2.tar.gz.md5">MD5</a>]</li>
- <li><a href="http://www.apache.org/dyn/closer.cgi?path=/thrift/0.14.2/thrift-0.14.2.exe">Thrift compiler for Windows (thrift-0.14.2.exe)</a> [<a href="https://www.apache.org/dist/thrift/0.14.2/thrift-0.14.2.exe.asc">PGP</a>] [<a href="https://www.apache.org/dist/thrift/0.14.2/thrift-0.14.2.exe.md5">MD5</a>]</li>
+ <li><a href="http://www.apache.org/dyn/closer.cgi?path=/thrift/0.15.0/thrift-0.15.0.tar.gz">thrift-0.15.0.tar.gz</a> [<a href="https://www.apache.org/dist/thrift/0.15.0/thrift-0.15.0.tar.gz.asc">PGP</a>]
+[<a href="https://www.apache.org/dist/thrift/0.15.0/thrift-0.15.0.tar.gz.md5">MD5</a>]</li>
+ <li><a href="http://www.apache.org/dyn/closer.cgi?path=/thrift/0.15.0/thrift-0.15.0.exe">Thrift compiler for Windows (thrift-0.15.0.exe)</a> [<a href="https://www.apache.org/dist/thrift/0.15.0/thrift-0.15.0.exe.asc">PGP</a>] [<a href="https://www.apache.org/dist/thrift/0.15.0/thrift-0.15.0.exe.md5">MD5</a>]</li>
</ul>
<h2 id="maven-artifact">Maven artifact</h2>
<pre><code><dependency>
<groupId>org.apache.thrift</groupId>
<artifactId>libthrift</artifactId>
- <version>0.14.2</version>
+ <version>0.15.0</version>
</dependency>
</code></pre>
diff --git a/output/index.html b/output/index.html
index aec8dfd..d9671f6 100644
--- a/output/index.html
+++ b/output/index.html
@@ -80,19 +80,19 @@
</div>
<div class="span3 well center pull-right">
<h2>Download</h2>
- <p>Apache Thrift v0.14.2</p>
+ <p>Apache Thrift v0.15.0</p>
<p>
- <a class="btn btn-large" href="http://www.apache.org/dyn/closer.cgi?path=/thrift/0.14.2/thrift-0.14.2.tar.gz">
- Download <small>v0.14.2</small>
+ <a class="btn btn-large" href="http://www.apache.org/dyn/closer.cgi?path=/thrift/0.15.0/thrift-0.15.0.tar.gz">
+ Download <small>v0.15.0</small>
</a>
</p>
<p>
<small>
- <a href="https://www.apache.org/dist/thrift/0.14.2/thrift-0.14.2.tar.gz.md5">MD5</a>
+ <a href="https://www.apache.org/dist/thrift/0.15.0/thrift-0.15.0.tar.gz.md5">MD5</a>
</small>
|
<small>
- <a href="https://www.apache.org/dist/thrift/0.14.2/thrift-0.14.2.tar.gz.asc">PGP</a>
+ <a href="https://www.apache.org/dist/thrift/0.15.0/thrift-0.15.0.tar.gz.asc">PGP</a>
</small>
</p>
<p>
diff --git a/output/lib/go.html b/output/lib/go.html
index 8efb4a4..45c25cd 100644
--- a/output/lib/go.html
+++ b/output/lib/go.html
@@ -50,18 +50,35 @@
<div class="container">
+<h1 id="suppored-go-releases">Suppored Go releases</h1>
+
+<p>Following the
+<a href="https://golang.org/doc/devel/release#policy">official Go release policy</a>,
+we support the latest two Go releases at the time of the Thrift release.</p>
+
+<p>For example, at the time of Thrift v0.14.0 release,
+the latest two Go releases are go1.15 and go1.14,
+and those are the two Go releases supported by Thrift v0.14.*
+(including v0.14.1 and v0.14.2 patch releases).</p>
+
+<p>Because of Go’s backward compatibility guarantee,
+older Thrift libraries usually works with newer Go releases
+(e.g. Thrift v0.14.* works with go1.16, although it’s not officially supported),
+but newer Thrift releases might use new APIs introduced in Go releases and no
+longer work with older Go releases.
+For example, Thrift v0.14.0 used APIs introduced in go1.13,
+and as a result no longer works on go1.12.</p>
+
<h1 id="using-thrift-with-go">Using Thrift with Go</h1>
-<p>Thrift supports Go 1.7+</p>
+<p>Thrift supports the currently officially supported Go releases (the latest 2).</p>
-<p>In following Go conventions, we recommend you use the ‘go’ tool to install
-Thrift for go.</p>
+<p>After initializing the go modules file in your project, use the following
+command to add the most recent version of the package:</p>
-<pre><code>$ go get github.com/apache/thrift/lib/go/thrift/...
+<pre><code>$ go get github.com/apache/thrift
</code></pre>
-<p>Will retrieve and install the most recent version of the package.</p>
-
<h1 id="a-note-about-optional-fields">A note about optional fields</h1>
<p>The thrift-to-Go compiler tries to represent thrift IDL structs as Go structs.
diff --git a/output/test/ThriftTest.thrift b/output/test/ThriftTest.thrift
index 12afff1..3b1507f 100644
--- a/output/test/ThriftTest.thrift
+++ b/output/test/ThriftTest.thrift
@@ -463,6 +463,11 @@ struct StructB {
struct OptionalSetDefaultTest {
1: optional set<string> with_default = [ "test" ]
}
+
+struct OptionalBinary {
+ 1: optional set<binary> bin_set = {}
+ 2: optional map<binary,i32> bin_map = {}
+}
</code></pre></div>
<p class="snippet_footer">This snippet was generated by Apache Thrift's <strong>source tree docs</strong>:
<a href="https://gitbox.apache.org/repos/asf?p=thrift.git;a=blob;hb=HEAD;f=test/ThriftTest.thrift">test/ThriftTest.thrift</a>
diff --git a/output/tutorial/go.html b/output/tutorial/go.html
index 32d2db8..fe08093 100644
--- a/output/tutorial/go.html
+++ b/output/tutorial/go.html
@@ -77,7 +77,6 @@ To use a specific version of the library, either clone the repository for that v
<div class="highlight"><pre class="codehilite"><code><span class="n">import</span> <span class="p">(</span>
<span class="s">"context"</span>
- <span class="s">"crypto/tls"</span>
<span class="s">"fmt"</span>
<span class="s">"github.com/apache/thrift/lib/go/thrift"</span>
@@ -135,24 +134,25 @@ To use a specific version of the library, either clone the repository for that v
<span class="k">return</span> <span class="n">err</span>
<span class="p">}</span>
-<span class="n">func</span> <span class="n">runClient</span><span class="p">(</span><span class="n">transportFactory</span> <span class="n">thrift</span><span class="p">.</span><span class="n">TTransportFactory</span><span class="p">,</span> <span class="n">protocolFactory</span> <span class="n">thrift</span><span class="p">.</span><span class="n">TProtocolFactory</span><span class="p">,</span> <span class="n">addr</span> <span class="n">string</span><span class="p">,</span> <span class= [...]
+<span class="n">func</span> <span class="nf">runClient</span><span class="p">(</span><span class="n">transportFactory</span> <span class="n">thrift</span><span class="p">.</span><span class="n">TTransportFactory</span><span class="p">,</span> <span class="n">protocolFactory</span> <span class="n">thrift</span><span class="p">.</span><span class="n">TProtocolFactory</span><span class="p">,</span> <span class="n">addr</span> <span class="n">string</span><span class="p">,</span> <span class [...]
<span class="n">var</span> <span class="n">transport</span> <span class="n">thrift</span><span class="p">.</span><span class="n">TTransport</span>
- <span class="n">var</span> <span class="n">err</span> <span class="n">error</span>
<span class="k">if</span> <span class="n">secure</span> <span class="p">{</span>
- <span class="n">cfg</span> <span class="o">:=</span> <span class="k">new</span><span class="p">(</span><span class="n">tls</span><span class="p">.</span><span class="n">Config</span><span class="p">)</span>
- <span class="n">cfg</span><span class="p">.</span><span class="n">InsecureSkipVerify</span> <span class="o">=</span> <span class="nb">true</span>
- <span class="n">transport</span><span class="p">,</span> <span class="n">err</span> <span class="o">=</span> <span class="n">thrift</span><span class="p">.</span><span class="n">NewTSSLSocket</span><span class="p">(</span><span class="n">addr</span><span class="p">,</span> <span class="n">cfg</span><span class="p">)</span>
+ <span class="n">transport</span> <span class="o">=</span> <span class="n">thrift</span><span class="p">.</span><span class="n">NewTSSLSocketConf</span><span class="p">(</span><span class="n">addr</span><span class="p">,</span> <span class="n">cfg</span><span class="p">)</span>
<span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
- <span class="n">transport</span><span class="p">,</span> <span class="n">err</span> <span class="o">=</span> <span class="n">thrift</span><span class="p">.</span><span class="n">NewTSocket</span><span class="p">(</span><span class="n">addr</span><span class="p">)</span>
+ <span class="n">transport</span> <span class="o">=</span> <span class="n">thrift</span><span class="p">.</span><span class="n">NewTSocketConf</span><span class="p">(</span><span class="n">addr</span><span class="p">,</span> <span class="n">cfg</span><span class="p">)</span>
<span class="p">}</span>
+ <span class="n">transport</span><span class="p">,</span> <span class="n">err</span> <span class="o">:=</span> <span class="n">transportFactory</span><span class="p">.</span><span class="n">GetTransport</span><span class="p">(</span><span class="n">transport</span><span class="p">)</span>
<span class="k">if</span> <span class="n">err</span> <span class="o">!=</span> <span class="n">nil</span> <span class="p">{</span>
- <span class="n">fmt</span><span class="p">.</span><span class="n">Println</span><span class="p">(</span><span class="s">"Error opening socket:"</span><span class="p">,</span> <span class="n">err</span><span class="p">)</span>
<span class="k">return</span> <span class="n">err</span>
<span class="p">}</span>
- <span class="n">transport</span><span class="p">,</span> <span class="n">err</span> <span class="o">=</span> <span class="n">transportFactory</span><span class="p">.</span><span class="n">GetTransport</span><span class="p">(</span><span class="n">transport</span><span class="p">)</span>
- <span class="k">if</span> <span class="n">err</span> <span class="o">!=</span> <span class="n">nil</span> <span class="p">{</span>
+ <span class="n">defer</span> <span class="n">transport</span><span class="p">.</span><span class="n">Close</span><span class="p">()</span>
+ <span class="k">if</span> <span class="n">err</span> <span class="o">:=</span> <span class="n">transport</span><span class="p">.</span><span class="n">Open</span><span class="p">();</span> <span class="n">err</span> <span class="o">!=</span> <span class="n">nil</span> <span class="p">{</span>
<span class="k">return</span> <span class="n">err</span>
<span class="p">}</span>
+ <span class="n">iprot</span> <span class="o">:=</span> <span class="n">protocolFactory</span><span class="p">.</span><span class="n">GetProtocol</span><span class="p">(</span><span class="n">transport</span><span class="p">)</span>
+ <span class="n">oprot</span> <span class="o">:=</span> <span class="n">protocolFactory</span><span class="p">.</span><span class="n">GetProtocol</span><span class="p">(</span><span class="n">transport</span><span class="p">)</span>
+ <span class="k">return</span> <span class="n">handleClient</span><span class="p">(</span><span class="n">tutorial</span><span class="p">.</span><span class="n">NewCalculatorClient</span><span class="p">(</span><span class="n">thrift</span><span class="p">.</span><span class="n">NewTStandardClient</span><span class="p">(</span><span class="n">iprot</span><span class="p">,</span> <span class="n">oprot</span><span class="p">)))</span>
+<span class="err">}</span>
</code></pre></div>
<p class="snippet_footer">This snippet was generated by Apache Thrift's <strong>source tree docs</strong>:
<a href="https://gitbox.apache.org/repos/asf?p=thrift.git;a=blob;hb=HEAD;f=tutorial/go/src/client.go">tutorial/go/src/client.go</a>
@@ -232,13 +232,10 @@ To use a specific version of the library, either clone the repository for that v
<span class="k">switch</span> <span class="n">w</span><span class="p">.</span><span class="n">Op</span> <span class="p">{</span>
<span class="k">case</span> <span class="n">tutorial</span><span class="p">.</span><span class="n">Operation_ADD</span><span class="p">:</span>
<span class="n">val</span> <span class="o">=</span> <span class="n">w</span><span class="p">.</span><span class="n">Num1</span> <span class="o">+</span> <span class="n">w</span><span class="p">.</span><span class="n">Num2</span>
- <span class="k">break</span>
<span class="k">case</span> <span class="n">tutorial</span><span class="p">.</span><span class="n">Operation_SUBTRACT</span><span class="p">:</span>
<span class="n">val</span> <span class="o">=</span> <span class="n">w</span><span class="p">.</span><span class="n">Num1</span> <span class="o">-</span> <span class="n">w</span><span class="p">.</span><span class="n">Num2</span>
- <span class="k">break</span>
<span class="k">case</span> <span class="n">tutorial</span><span class="p">.</span><span class="n">Operation_MULTIPLY</span><span class="p">:</span>
<span class="n">val</span> <span class="o">=</span> <span class="n">w</span><span class="p">.</span><span class="n">Num1</span> <span class="o">*</span> <span class="n">w</span><span class="p">.</span><span class="n">Num2</span>
- <span class="k">break</span>
<span class="k">case</span> <span class="n">tutorial</span><span class="p">.</span><span class="n">Operation_DIVIDE</span><span class="p">:</span>
<span class="k">if</span> <span class="n">w</span><span class="p">.</span><span class="n">Num2</span> <span class="o">==</span> <span class="mi">0</span> <span class="p">{</span>
<span class="n">ouch</span> <span class="o">:=</span> <span class="n">tutorial</span><span class="p">.</span><span class="n">NewInvalidOperation</span><span class="p">()</span>
@@ -248,7 +245,6 @@ To use a specific version of the library, either clone the repository for that v
<span class="k">return</span>
<span class="p">}</span>
<span class="n">val</span> <span class="o">=</span> <span class="n">w</span><span class="p">.</span><span class="n">Num1</span> <span class="o">/</span> <span class="n">w</span><span class="p">.</span><span class="n">Num2</span>
- <span class="k">break</span>
<span class="nl">default:</span>
<span class="n">ouch</span> <span class="o">:=</span> <span class="n">tutorial</span><span class="p">.</span><span class="n">NewInvalidOperation</span><span class="p">()</span>
<span class="n">ouch</span><span class="p">.</span><span class="n">WhatOp</span> <span class="o">=</span> <span class="n">int32</span><span class="p">(</span><span class="n">w</span><span class="p">.</span><span class="n">Op</span><span class="p">)</span>
@@ -274,7 +270,7 @@ To use a specific version of the library, either clone the repository for that v
<span class="n">func</span> <span class="p">(</span><span class="n">p</span> <span class="o">*</span><span class="n">CalculatorHandler</span><span class="p">)</span> <span class="n">GetStruct</span><span class="p">(</span><span class="n">ctx</span> <span class="n">context</span><span class="p">.</span><span class="n">Context</span><span class="p">,</span> <span class="n">key</span> <span class="n">int32</span><span class="p">)</span> <span class="p">(</span><span class="o">*</span><span [...]
<span class="n">fmt</span><span class="p">.</span><span class="n">Print</span><span class="p">(</span><span class="s">"getStruct("</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="s">")</span><span class="se">\n</span><span class="s">"</span><span class="p">)</span>
- <span class="n">v</span><span class="p">,</span> <span class="n">_</span> <span class="o">:=</span> <span class="n">p</span><span class="p">.</span><span class="n">log</span><span class="p">[</span><span class="kt">int</span><span class="p">(</span><span class="n">key</span><span class="p">)]</span>
+ <span class="n">v</span> <span class="o">:=</span> <span class="n">p</span><span class="p">.</span><span class="n">log</span><span class="p">[</span><span class="kt">int</span><span class="p">(</span><span class="n">key</span><span class="p">)]</span>
<span class="k">return</span> <span class="n">v</span><span class="p">,</span> <span class="n">nil</span>
<span class="p">}</span>