You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@thrift.apache.org by bu...@apache.org on 2020/11/20 17:19:21 UTC
svn commit: r1068261 [1/3] - in /websites/staging/thrift/trunk/content: ./
docs/ docs/committers/ docs/install/ lib/ test/ tutorial/
Author: buildbot
Date: Fri Nov 20 17:19:21 2020
New Revision: 1068261
Log:
Staging update by buildbot for thrift
Modified:
websites/staging/thrift/trunk/content/ (props changed)
websites/staging/thrift/trunk/content/about.html
websites/staging/thrift/trunk/content/docs/Languages.html
websites/staging/thrift/trunk/content/docs/coding_standards.html
websites/staging/thrift/trunk/content/docs/committers/HowToCommit.html
websites/staging/thrift/trunk/content/docs/idl.html
websites/staging/thrift/trunk/content/docs/install/debian.html
websites/staging/thrift/trunk/content/docs/install/windows.html
websites/staging/thrift/trunk/content/index.html
websites/staging/thrift/trunk/content/lib/cpp.html
websites/staging/thrift/trunk/content/lib/csharp.html
websites/staging/thrift/trunk/content/lib/go.html
websites/staging/thrift/trunk/content/lib/netstd.html
websites/staging/thrift/trunk/content/lib/nodejs.html
websites/staging/thrift/trunk/content/lib/perl.html
websites/staging/thrift/trunk/content/lib/php.html
websites/staging/thrift/trunk/content/test/ThriftTest.html
websites/staging/thrift/trunk/content/test/index.html
websites/staging/thrift/trunk/content/tutorial/csharp.html
websites/staging/thrift/trunk/content/tutorial/delphi.html
websites/staging/thrift/trunk/content/tutorial/go.html
websites/staging/thrift/trunk/content/tutorial/hs.html
websites/staging/thrift/trunk/content/tutorial/netstd.html
websites/staging/thrift/trunk/content/tutorial/perl.html
websites/staging/thrift/trunk/content/tutorial/php.html
websites/staging/thrift/trunk/content/tutorial/py.html
Propchange: websites/staging/thrift/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Nov 20 17:19:21 2020
@@ -1 +1 @@
-1875327
+1883670
Modified: websites/staging/thrift/trunk/content/about.html
==============================================================================
--- websites/staging/thrift/trunk/content/about.html (original)
+++ websites/staging/thrift/trunk/content/about.html Fri Nov 20 17:19:21 2020
@@ -264,13 +264,6 @@ h2:hover > .headerlink, h3:hover > .head
<td align="right">9</td>
</tr>
- <tr class="">
- <td class="username">simonsouth</td>
- <td class="fullname">Simon South</td>
- <td>C (GLib)</td>
- <td align="right">-5</td>
- </tr>
-
</tbody>
</table>
</div>
Modified: websites/staging/thrift/trunk/content/docs/Languages.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/Languages.html (original)
+++ websites/staging/thrift/trunk/content/docs/Languages.html Fri Nov 20 17:19:21 2020
@@ -91,7 +91,7 @@ h2:hover > .headerlink, h3:hover > .head
<a href="https://github.com/apache/thrift/blob/0.11.0/LANGUAGES.md">0.11.0</a></p>
<p>Thrift supports many programming languages and has an impressive test suite that
exercises most of the languages, protocols, and transports. Each build exercises
-a matrix of thousands of possible combinations. Each language typically has a
+a matrix of thousands of possible combinations. Each language typically has a
minimum required version as well as support libraries - some mandatory and some
optional. The information provided below will help you assess whether you can
use Apache Thrift with your project. Obviously this is a complex matrix to
@@ -172,17 +172,6 @@ Thrift's core protocol is TBinary, suppo
<td align=left><a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20THRIFT%20AND%20component%20in%20(%22C%2B%2B%20-%20Compiler%22%2C%20%22C%2B%2B%20-%20Library%22)%20and%20status%20not%20in%20(fixed%2C%20resolved%2C%20closed)">C++</a></td>
</tr>
<tr align=center>
-<td align=left><a href="https://github.com/apache/thrift/blob/master/lib/csharp/README.md">C#</a></td>
-<!-- Since -----------------><td>0.2.0<br>Deprecated<br>use netstd</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>.NET 3.5 / mono 3.2.8.0</td><td>.NET 4.6.1 / mono 4.6.2.7</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/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>
-<!-- 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/cred.png" alt=""/></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>
-<!-- Servers ---------------><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/cgrn.png" alt="Yes"/></td><td><img src="doc/images/cgrn.png" alt="Yes"/></td>
-<td align=left><a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20THRIFT%20AND%20component%20in%20(%22C%23%20-%20Compiler%22%2C%20%22C%23%20-%20Library%22)%20and%20status%20not%20in%20(fixed%2C%20resolved%2C%20closed)">C# (.NET)</a></td>
-</tr>
-<tr align=center>
<td align=left><a href="https://github.com/apache/thrift/blob/master/lib/cl/README.md">Common LISP</a></td>
<!-- Since -----------------><td>0.12.0</td>
<!-- Build Systems ---------><td><img src="doc/images/cgrn.png" alt="Yes"/></td><td><img src="doc/images/cred.png" alt=""/></td>
@@ -227,17 +216,6 @@ Thrift's core protocol is TBinary, suppo
<td align=left><a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20THRIFT%20AND%20component%20in%20(%22Delphi%20-%20Compiler%22%2C%20%22Delphi%20-%20Library%22)%20and%20status%20not%20in%20(fixed%2C%20resolved%2C%20closed)">Delphi</a></td>
</tr>
<tr align=center>
-<td align=left><a href="https://github.com/apache/thrift/blob/master/lib/netcore/README.md">.NET Core</a></td>
-<!-- Since -----------------><td>0.11.0<br>Deprecated<br>use netstd</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>2.1.4</td><td>2.2.101</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/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>
-<!-- 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/cred.png" alt=""/></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>
-<!-- Servers ---------------><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/cred.png" alt=""/></td><td><img src="doc/images/cred.png" alt=""/></td>
-<td align=left><a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20THRIFT%20AND%20component%20in%20(%22netcore%20-%20Compiler%22%2C%20%22netcore%20-%20Library%22)%20and%20status%20not%20in%20(fixed%2C%20resolved%2C%20closed)">.NET Core</a></td>
-</tr>
-<tr align=center>
<td align=left><a href="https://github.com/apache/thrift/blob/master/lib/netstd/README.md">.NET Standard</a></td>
<!-- Since -----------------><td>0.13.0</td>
<!-- Build Systems ---------><td><img src="doc/images/cgrn.png" alt="Yes"/></td><td><img src="doc/images/cred.png" alt=""/></td>
@@ -340,7 +318,7 @@ Thrift's core protocol is TBinary, suppo
<td align=left><a href="https://github.com/apache/thrift/blob/master/lib/nodejs/README.md">node.js</a></td>
<!-- Since -----------------><td>0.6.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>6.x</td><td>10.x</td>
+<!-- Language Levels -------><td>10.x</td><td>10.x</td>
<!-- Low-Level Transports --><td><img src="doc/images/cgrn.png" alt="Yes"/></td><td><img src="doc/images/cred.png" alt=""/></td><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/cgrn.png" alt="Yes"/></td>
<!-- Transport Wrappers ----><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/cred.png" alt=""/></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>
@@ -396,7 +374,7 @@ Thrift's core protocol is TBinary, suppo
<!-- Since -----------------><td>0.2.0</td>
<!-- Build Systems ---------><td><img src="doc/images/cgrn.png" alt="Yes"/></td><td><img src="doc/images/cgrn.png" alt="Yes"/></td>
<!-- Language Levels -------><td>2.7.12, 3.5.2</td><td>2.7.15, 3.6.8</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/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/cgrn.png" alt="Yes"/></td>
+<!-- Low-Level Transports --><td><img src="doc/images/cgrn.png" alt="Yes"/></td><td><img src="doc/images/cred.png" alt=""/></td><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/cgrn.png" alt="Yes"/></td>
<!-- Transport Wrappers ----><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><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>
<!-- Servers ---------------><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/cred.png" alt=""/></td><td><img src="doc/images/cred.png" alt=""/></td>
@@ -417,7 +395,7 @@ Thrift's core protocol is TBinary, suppo
<td align=left><a href="https://github.com/apache/thrift/blob/master/lib/rs/README.md">Rust</a></td>
<!-- Since -----------------><td>0.11.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.35.0</td><td>1.35.0</td>
+<!-- Language Levels -------><td>1.40.0</td><td>1.xx.x</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/cred.png" alt=""/></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/cred.png" alt=""/></td><td><img src="doc/images/cred.png" alt=""/></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/cred.png" alt=""/></td><td><img src="doc/images/cgrn.png" alt="Yes"/></td>
Modified: websites/staging/thrift/trunk/content/docs/coding_standards.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/coding_standards.html (original)
+++ websites/staging/thrift/trunk/content/docs/coding_standards.html Fri Nov 20 17:19:21 2020
@@ -89,15 +89,15 @@ h2:hover > .headerlink, h3:hover > .head
Good programmers write code that humans can understand.
-- Martin Fowler, 1999</p>
<p>The purpose of this document is to make everyone's life easier.</p>
-<p>It's easier when you read good, well formatted, with clearly defined purpose, code.
+<p>It's easier when you read good, well-formatted, with a clearly defined purpose, code.
But the only way to read clean code is to write such.</p>
<p>This document can help achieve that, but keep in mind that
those are not silver-bullet, fix-all-at-once rules. Just think about readability while writing code.
-Write code like you would have to read it in ten years from now.</p>
+Write code like you would have to read it ten years from now.</p>
<h2 id="general-coding-standards">General Coding Standards<a class="headerlink" href="#general-coding-standards" title="Permanent link">¶</a></h2>
<p>Thrift has some history. Not all existing code follows those rules.
But we want to improve over time.
-When making small change / bugfix - like single line fix - do <em>not</em> refactor whole function.
+When making a small change / bugfix - like a single line fix - do <em>not</em> refactor the whole function.
That disturbs code repository history.
Whenever adding something new and / or making bigger refactoring
- follow those rules as strictly as you can.</p>
@@ -105,9 +105,9 @@ Whenever adding something new and / or m
Code review is the best way to improve readability.</p>
<h3 id="basics">Basics<a class="headerlink" href="#basics" title="Permanent link">¶</a></h3>
<ul>
-<li>Use spaces not tabs</li>
+<li>Use spaces, not tabs</li>
<li>Use only ASCII characters in file and directory names</li>
-<li>Commit to repository using Unix-style line endings (LF)
+<li>Commit to the repository using Unix-style line endings (LF)
On Windows:
git config core.autocrlf true</li>
<li>Maximum line width - 100 characters</li>
@@ -115,14 +115,14 @@ Code review is the best way to improve r
</ul>
<h3 id="comments">Comments<a class="headerlink" href="#comments" title="Permanent link">¶</a></h3>
<ul>
-<li>Each file has to start with comment containing <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License</a></li>
-<li>Public API of library should be documented, preferably using format native for language specific documentation generation tools (Javadoc, Doxygen etc.)</li>
+<li>Each file has to start with a comment containing <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License</a></li>
+<li>Public API of a library should be documented, preferably using format native for language-specific documentation generation tools (Javadoc, Doxygen etc.)</li>
<li>Other comments are discouraged - comments are lies. When one has to make comment it means one failed to write readable code. Instead of "I should write a comment here" think "I should clean it up"</li>
<li>Do not leave "TODO/FIXME" comments - file <a href="http://issues.apache.org/jira/browse/THRIFT">Jira</a> issue instead</li>
</ul>
<h3 id="naming">Naming<a class="headerlink" href="#naming" title="Permanent link">¶</a></h3>
<p>Finding proper names is the most important and most difficult task in software development.</p>
-<h2 id="language-specific-coding-standards">Language Specific Coding Standards<a class="headerlink" href="#language-specific-coding-standards" title="Permanent link">¶</a></h2>
+<h2 id="language-specific-coding-standards">Language-Specific Coding Standards<a class="headerlink" href="#language-specific-coding-standards" title="Permanent link">¶</a></h2>
<p>For detailed information see <code>lib/LANG/coding_standards.md</code></p>
<p class='snippet_footer'>
This snippet was generated by Apache Thrift's <strong>source tree docs</strong>:
Modified: websites/staging/thrift/trunk/content/docs/committers/HowToCommit.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/committers/HowToCommit.html (original)
+++ websites/staging/thrift/trunk/content/docs/committers/HowToCommit.html Fri Nov 20 17:19:21 2020
@@ -111,7 +111,7 @@ h2:hover > .headerlink, h3:hover > .head
<p>Inspect the applied patch to ensure that all <a href="http://www.apache.org/licenses/LICENSE-2.0.html#contributions">Legal aspects on Submission of Contributions (Patches)</a> are met</p>
</li>
<li>
-<p>Run the necessary unit tests and cross language test cases to verify the patch</p>
+<p>Run the necessary unit tests and cross-language test cases to verify the patch</p>
</li>
<li>
<p>Commit the patch</p>
@@ -129,7 +129,7 @@ h2:hover > .headerlink, h3:hover > .head
Client: <component>
Patch: <Name of person contributing the patch></p>
<p>Description of what was fixed or addressed.</p>
-<p>If this is a github pull request then add below comment to automaticaly close GitHub request,
+<p>If this is a github pull request then add the below comment to automatically close the GitHub request,
where #NNNN is the PR number:</p>
<div class="codehilite"><pre><span class="n">This</span> <span class="n">closes</span> #<span class="n">NNNN</span>
</pre></div>
@@ -143,7 +143,7 @@ h2:hover > .headerlink, h3:hover > .head
git push origin master</p>
</li>
<li>
-<p>Resolve the jira issue and set the following for the changelog</p>
+<p>Resolve the Jira issue and set the following for the changelog</p>
</li>
<li>
<p>Component the patch is for</p>
Modified: websites/staging/thrift/trunk/content/docs/idl.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/idl.html (original)
+++ websites/staging/thrift/trunk/content/docs/idl.html Fri Nov 20 17:19:21 2020
@@ -85,7 +85,7 @@
}
h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
<h2 id="thrift-interface-description-language">Thrift interface description language<a class="headerlink" href="#thrift-interface-description-language" title="Permanent link">¶</a></h2>
-<p>For Thrift version 0.13.0.</p>
+<p>For Thrift version 0.14.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>
<h2 id="description">Description<a class="headerlink" href="#description" title="Permanent link">¶</a></h2>
<p>Here is a description of the Thrift IDL.</p>
@@ -117,7 +117,7 @@ h2:hover > .headerlink, h3:hover > .head
<p>A namespace declares which namespaces/package/module/etc. the type definitions in this file will be declared in for the target languages. The namespace scope indicates which language the namespace applies to; a scope of '*' indicates that the namespace applies to all target languages.</p>
<div class="codehilite"><pre><span class="p">[</span>5<span class="p">]</span> <span class="n">Namespace</span> <span class="p">::=</span> <span class="p">(</span> <span class="s">'namespace'</span> <span class="p">(</span> <span class="n">NamespaceScope</span> <span class="n">Identifier</span> <span class="p">)</span> <span class="p">)</span>
-<span class="p">[</span>6<span class="p">]</span> <span class="n">NamespaceScope</span> <span class="p">::=</span> <span class="s">'*'</span> <span class="o">|</span> <span class="s">'c_glib'</span> <span class="o">|</span> <span class="s">'cpp'</span> <span class="o">|</span> <span class="s">'csharp'</span> <span class="o">|</span> <span class="s">'delphi'</span> <span class="o">|</span> <span class="s">'go'</span> <span class="o">|</span> <span class="s">'java'</span> <span class="o">|</span> <span class="s">'js'</span> <span class="o">|</span> <span class="s">'lua'</span> <span class="o">|</span> <span class="s">'netcore'</span> <span class="o">|</span> <span class="s">'perl'</span> <span class="o">|</span> <span class="s">'php'</span> <span class="o">|</span> <span class="s">'py'</span> <span class="o">|</span> <span class="s">'py.twisted'</span> <span class="o">|</
span> <span class="s">'rb'</span> <span class="o">|</span> <span class="s">'st'</span> <span class="o">|</span> <span class="s">'xsd'</span>
+<span class="p">[</span>6<span class="p">]</span> <span class="n">NamespaceScope</span> <span class="p">::=</span> <span class="s">'*'</span> <span class="o">|</span> <span class="s">'c_glib'</span> <span class="o">|</span> <span class="s">'cpp'</span> <span class="o">|</span> <span class="s">'delphi'</span> <span class="o">|</span> <span class="s">'haxe'</span> <span class="o">|</span> <span class="s">'go'</span> <span class="o">|</span> <span class="s">'java'</span> <span class="o">|</span> <span class="s">'js'</span> <span class="o">|</span> <span class="s">'lua'</span> <span class="o">|</span> <span class="s">'netstd'</span> <span class="o">|</span> <span class="s">'perl'</span> <span class="o">|</span> <span class="s">'php'</span> <span class="o">|</span> <span class="s">'py'</span> <span class="o">|</span> <span class="s">'py.twisted'</span> <span class="o">|</spa
n> <span class="s">'rb'</span> <span class="o">|</span> <span class="s">'st'</span> <span class="o">|</span> <span class="s">'xsd'</span>
</pre></div>
@@ -186,7 +186,7 @@ h2:hover > .headerlink, h3:hover > .head
<h3 id="field-requiredness">Field Requiredness<a class="headerlink" href="#field-requiredness" title="Permanent link">¶</a></h3>
-<p>There are two explicit requiredness values, and a third one that is applied implicity if neither <em>required</em> nor <em>optional</em> are given: <em>default</em> requiredness.</p>
+<p>There are two explicit requiredness values, and a third one that is applied implicitly if neither <em>required</em> nor <em>optional</em> are given: <em>default</em> requiredness.</p>
<div class="codehilite"><pre><span class="p">[</span>18<span class="p">]</span> <span class="n">FieldReq</span> <span class="p">::=</span> <span class="s">'required'</span> <span class="o">|</span> <span class="s">'optional'</span>
</pre></div>
@@ -218,7 +218,7 @@ h2:hover > .headerlink, h3:hover > .head
<p>There are ongoing discussions about that topic, see JIRA for details. Not all implementations treat default values in the very same way, but the current status quo is more or less that default fields are typically set at initialization time. Therefore, a value that equals the default may not be written, because the read end will set the value implicitly. On the other hand, an implementation is free to write the default value anyways, as there is no hard restriction that prevents this. </p>
<p>The major point to keep in mind here is the fact, that any unwritten default value implicitly becomes part of the interface version. If that default is changed, the interface changes. If, in contrast, the default value is written into the output data, the default in the IDL can change at any time without affecting serialized data.</p>
<h3 id="xsd-options">XSD Options<a class="headerlink" href="#xsd-options" title="Permanent link">¶</a></h3>
-<p>N.B.: These have some internal purpose at Facebook but serve no current purpose in Thrift. Use of these options is strongly discouraged.</p>
+<p>N.B.: These have some internal purpose at Facebook but serve no current purpose in Thrift. The use of these options is strongly discouraged.</p>
<div class="codehilite"><pre><span class="p">[</span>19<span class="p">]</span> <span class="n">XsdFieldOptions</span> <span class="p">::=</span> <span class="s">'xsd_optional'</span>? <span class="s">'xsd_nillable'</span>? <span class="n">XsdAttrs</span>?
<span class="p">[</span>20<span class="p">]</span> <span class="n">XsdAttrs</span> <span class="p">::=</span> <span class="s">'xsd_attrs'</span> <span class="s">'{'</span> <span class="n">Field</span><span class="o">*</span> <span class="s">'}'</span>
@@ -297,8 +297,8 @@ h2:hover > .headerlink, h3:hover > .head
<li><a href="https://raw.githubusercontent.com/apache/thrift/master/test/ThriftTest.thrift">ThriftTest.thrift</a> used by the Thrift TestFramework</li>
<li>Thrift <a href="/tutorial/">tutorial</a></li>
<li>Facebook's <a href="https://raw.githubusercontent.com/apache/thrift/master/contrib/fb303/if/fb303.thrift">fb303.thrift</a></li>
-<li><a href="http://cassandra.apache.org/">Apache Cassandra's</a> Thrift IDL: <a href="http://svn.apache.org/viewvc/cassandra/trunk/interface/cassandra.thrift?view=co">cassandra.thrift</a></li>
-<li><a href="http://www.evernote.com/about/developer/api/">Evernote API</a></li>
+<li><a href="http://cassandra.apache.org/">Apache Cassandra's</a> Thrift IDL: <a href="https://gitbox.apache.org/repos/asf?p=cassandra.git;a=blob_plain;f=interface/cassandra.thrift;hb=refs/heads/cassandra-3.0">cassandra.thrift</a></li>
+<li><a href="https://github.com/evernote/evernote-thrift">Evernote API</a></li>
</ul>
<h2 id="to-doquestions">To Do/Questions<a class="headerlink" href="#to-doquestions" title="Permanent link">¶</a></h2>
<p>Initialization of Base Types for all Languages?</p>
@@ -308,7 +308,7 @@ h2:hover > .headerlink, h3:hover > .head
<p>Why does position of <code>CppType</code> vary between <code>SetType</code> and <code>ListType</code>?</p>
<ul>
<li>std::set does sort the elements automatically, that's the design. see <a href="/docs/types">Thrift Types</a> or the <a href="http://www.cplusplus.com/reference/stl/set/">C++ std:set reference</a> for further details</li>
-<li>The question is, how other languages are doing that? What about custom objects, do they have a Compare function the set the order correctly?</li>
+<li>The question is, how other languages are doing that? What about custom objects, do they have a Compare function to set the order correctly?</li>
</ul>
<p>Why can't <code>DefinitionType</code> be the same as <code>FieldType</code> (i.e. include <code>Identifier</code>)?</p>
<p>Examine the <code>smalltalk.prefix</code> and <code>smalltalk.category</code> status (esp <code>smalltalk.category</code>, which takes <code>STIdentifier</code> as its argument)...</p>
Modified: websites/staging/thrift/trunk/content/docs/install/debian.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/install/debian.html (original)
+++ websites/staging/thrift/trunk/content/docs/install/debian.html Fri Nov 20 17:19:21 2020
@@ -133,8 +133,8 @@ h2:hover > .headerlink, h3:hover > .head
<li>erlang-base erlang-eunit erlang-dev rebar</li>
</ul>
</li>
-<li>Csharp<ul>
-<li>mono-gmcs mono-devel libmono-system-web2.0-cil nunit nunit-console</li>
+<li>NetStd<ul>
+<li>apt-transport-https dotnet-sdk-3.1 aspnetcore-runtime-3.1</li>
</ul>
</li>
<li>Haskell<ul>
Modified: websites/staging/thrift/trunk/content/docs/install/windows.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/install/windows.html (original)
+++ websites/staging/thrift/trunk/content/docs/install/windows.html Fri Nov 20 17:19:21 2020
@@ -85,7 +85,7 @@
}
h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
<h2 id="windows-setup">Windows Setup<a class="headerlink" href="#windows-setup" title="Permanent link">¶</a></h2>
-<p>The Thrift environment consists of two main parts: The Thrift compiler EXE and the language-dependent libraries. Most of these libraries will require some kind of build and/or installation. But regarding the Thrift compiler utility there are a number of different alternatives. </p>
+<p>The Thrift environment consists of two main parts: The Thrift compiler EXE and the language-dependent libraries. Most of these libraries will require some kind of build and/or installation. But regarding the Thrift compiler utility, there are a number of different alternatives. </p>
<p>The first one of these alternatives is to download the <strong>pre-built Thrift Compiler EXE</strong> and only build the libraries needed from source, following one of the "Setup from source" methods outlined below.</p>
<p>The other two options are to build the Thrift compiler from source. The most recommended way to achieve this is by means of the <strong>Visual Studio C++ build project</strong>. Alternatively, the Thrift compiler can also be built via <strong>Cygwin</strong> or <strong>MinGW</strong> build environments, however this method is not only less comfortable, but more time-consuming and requires much more manual effort. </p>
<h2 id="prebuilt-thrift-compiler">Prebuilt Thrift compiler<a class="headerlink" href="#prebuilt-thrift-compiler" title="Permanent link">¶</a></h2>
@@ -171,7 +171,7 @@ h2:hover > .headerlink, h3:hover > .head
<p>Then linking using $(LTHRIFT) instead of -lthrift.</p>
-<div class="codehilite"><pre><span class="n">TODO</span> <span class="o">-</span> <span class="n">diagnose</span> <span class="n">issue</span> <span class="n">further</span>
+<div class="codehilite"><pre><span class="n">TODO</span> <span class="o">-</span> <span class="n">diagnose</span> <span class="n">the</span> <span class="n">issue</span> <span class="n">further</span>
</pre></div>
@@ -186,7 +186,7 @@ h2:hover > .headerlink, h3:hover > .head
<li>MinGW </li>
<li><a href="/docs/install">Apache Thrift Requirements</a></li>
</ul>
-<p>In addition you need to add the following entry to your windows PATH variable.</p>
+<p>In addition, you need to add the following entry to your windows PATH variable.</p>
<div class="codehilite"><pre><span class="n">C</span><span class="p">:</span><span class="o">\</span><span class="n">MINGW</span><span class="o">\</span><span class="n">BIN</span>
</pre></div>
Modified: websites/staging/thrift/trunk/content/index.html
==============================================================================
--- websites/staging/thrift/trunk/content/index.html (original)
+++ websites/staging/thrift/trunk/content/index.html Fri Nov 20 17:19:21 2020
@@ -152,8 +152,7 @@
visibility: hidden;
}
h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
-<div class="codehilite"><pre>/**
- * Ahh, now onto the cool part, defining a service. Services just need a name
+<div class="codehilite"><pre> * Ahh, now onto the cool part, defining a service. Services just need a name
* and can optionally inherit from another service using the extends keyword.
*/
service Calculator extends shared.SharedService {
@@ -175,6 +174,7 @@ service Calculator extends shared.Shared
* This method has a oneway modifier. That means the client only makes
* a request and does not listen for any response at all. Oneway methods
* must be void.
+ */
</pre></div>
<p class='snippet_footer'>
This snippet was generated by Apache Thrift's <strong>source tree docs</strong>:
Modified: websites/staging/thrift/trunk/content/lib/cpp.html
==============================================================================
--- websites/staging/thrift/trunk/content/lib/cpp.html (original)
+++ websites/staging/thrift/trunk/content/lib/cpp.html Fri Nov 20 17:19:21 2020
@@ -143,6 +143,22 @@ the config header: "windows/config.h"</p
http://monkey.org/~provos/libevent/</p>
<h2 id="windows-version-compatibility">Windows version compatibility<a class="headerlink" href="#windows-version-compatibility" title="Permanent link">¶</a></h2>
<p>The Thrift library targets Windows 7 or latter versions. The supports for windows XP and Vista are avaiable until 0.12.0.</p>
+<h2 id="thrift-and-the-vcpkg-package-manager">Thrift and the VCPKG Package manager<a class="headerlink" href="#thrift-and-the-vcpkg-package-manager" title="Permanent link">¶</a></h2>
+<p>You can download and install thrift using the
+<a href="https://github.com/Microsoft/vcpkg">vcpkg</a> dependency manager:</p>
+<div class="codehilite"><pre><span class="n">git</span> <span class="n">clone</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">github</span><span class="p">.</span><span class="n">com</span><span class="o">/</span><span class="n">Microsoft</span><span class="o">/</span><span class="n">vcpkg</span><span class="p">.</span><span class="n">git</span>
+<span class="n">cd</span> <span class="n">vcpkg</span>
+<span class="o">./</span><span class="n">bootstrap</span><span class="o">-</span><span class="n">vcpkg</span><span class="p">.</span><span class="n">sh</span>
+<span class="o">./</span><span class="n">vcpkg</span> <span class="n">integrate</span> <span class="n">install</span>
+<span class="o">./</span><span class="n">vcpkg</span> <span class="n">install</span> <span class="n">thrift</span>
+</pre></div>
+
+
+<p>The thrift port in vcpkg is kept up to date by Microsoft team members
+and community contributors. The Apache Thrift project is <em>not</em> responsible
+for the vcpkg port. Therefore, if the version is out of date, please
+<a href="https://github.com/Microsoft/vcpkg">create an issue or pull request</a>
+on the vcpkg repository. </p>
<h2 id="named-pipes">Named Pipes<a class="headerlink" href="#named-pipes" title="Permanent link">¶</a></h2>
<p>Named Pipe transport has been added in the TPipe and TPipeServer classes. This
is currently Windows-only. Named pipe transport for <em>NIX has not been
Modified: websites/staging/thrift/trunk/content/lib/csharp.html
==============================================================================
--- websites/staging/thrift/trunk/content/lib/csharp.html (original)
+++ websites/staging/thrift/trunk/content/lib/csharp.html Fri Nov 20 17:19:21 2020
@@ -84,14 +84,41 @@
visibility: hidden;
}
h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
-<p>Unless required by applicable law or agreed to in writing,
-software distributed under the License is distributed on an
-"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, either express or implied. See the License for the
-specific language governing permissions and limitations
-under the License.</p>
-<h1 id="using-thrift-with-c">Using Thrift with C#<a class="headerlink" href="#using-thrift-with-c" title="Permanent link">¶</a></h1>
-<p>Thrift requires Mono >= 1.2.6 or .NET framework >= 3.5
+<p><select name="st" >
+<option selected="selected" value="commit">commit</option>
+<option value="grep">grep</option>
+<option value="author">author</option>
+<option value="committer">committer</option>
+<option value="pickaxe">pickaxe</option>
+</select> <a href="/repos/asf?p=thrift.git;a=search_help" title="search help">?</a> search:
+<input type="text" name="s" />
+<span title="Extended regular expression"><label><input type="checkbox" name="sr" value="1" />re</label></span></div>
+</form>
+<div class="page_body">
+<br /><br />
+404 - Cannot find file
+<br />
+</div>
+<div class="page_footer">
+<div class="page_footer_text">Apache Thrift</div>
+<a class="rss_logo" href="/repos/asf?p=thrift.git;a=rss;f=lib/csharp/README.md" title="history of lib/csharp/README.md RSS feed">RSS</a>
+<a class="rss_logo" href="/repos/asf?p=thrift.git;a=atom;f=lib/csharp/README.md" title="history of lib/csharp/README.md Atom feed">Atom</a>
+</div>
+<script type="text/javascript" src="/static/gitweb.js"></script>
+<script type="text/javascript">
+window.onload = function () {
+ var tz_cookie = { name: 'gitweb_tz', expires: 14, path: '/' };
+ onloadTZSetup('local', tz_cookie, 'datetime');
+};
+</script>
+</body>
+</html><!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
+<html><head>
+<title>404 Not Found</title>
+</head><body>
+<h1>Not Found</h1>
+<p>The requested URL was not found on this server.</p>
+</body></html>
<p class='snippet_footer'>
This page was generated by Apache Thrift's <strong>source tree docs</strong>:
<a href="https://gitbox.apache.org/repos/asf?p=thrift.git;a=blob;f=lib/csharp/README.md;hb=HEAD"</a>lib/csharp/README.md</a>
Modified: websites/staging/thrift/trunk/content/lib/go.html
==============================================================================
--- websites/staging/thrift/trunk/content/lib/go.html (original)
+++ websites/staging/thrift/trunk/content/lib/go.html Fri Nov 20 17:19:21 2020
@@ -139,7 +139,37 @@ typedefs and enums.</p>
</pre></div>
-<p><p class='snippet_footer'>
+<h1 id="a-note-about-server-handler-implementations">A note about server handler implementations<a class="headerlink" href="#a-note-about-server-handler-implementations" title="Permanent link">¶</a></h1>
+<p>The context object passed into the server handler function will be canceled when
+the client closes the connection (this is a best effort check, not a guarantee
+-- there's no guarantee that the context object is always canceled when client
+closes the connection, but when it's canceled you can always assume the client
+closed the connection). When implementing Go Thrift server, you can take
+advantage of that to abandon requests that's no longer needed:</p>
+<div class="codehilite"><pre><span class="n">func</span> <span class="n">MyEndpoint</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">req</span> <span class="o">*</span><span class="n">thriftRequestType</span><span class="p">)</span> <span class="p">(</span><span class="o">*</span><span class="n">thriftResponseType</span><span class="p">,</span> <span class="n">error</span><span class="p">)</span> <span class="p">{</span>
+ <span class="p">...</span>
+ <span class="k">if</span> <span class="n">ctx</span><span class="p">.</span><span class="n">Err</span><span class="p">()</span> <span class="o">==</span> <span class="n">context</span><span class="p">.</span><span class="n">Canceled</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="n">nil</span><span class="p">,</span> <span class="n">thrift</span><span class="p">.</span><span class="n">ErrAbandonRequest</span>
+ <span class="p">}</span>
+ <span class="p">...</span>
+<span class="p">}</span>
+</pre></div>
+
+
+<p>This feature would add roughly 1 millisecond of latency overhead to the server
+handlers (along with roughly 2 goroutines per request).
+If that is unacceptable, it can be disabled by having this line early in your
+main function:</p>
+<div class="codehilite"><pre><span class="n">thrift</span><span class="p">.</span><span class="n">ServerConnectivityCheckInterval</span> <span class="p">=</span> 0
+</pre></div>
+
+
+<p>Please be advised that due to a
+<a href="https://github.com/golang/go/issues/27707">Go runtime bug</a>, currently
+if this interval is set to a value too low (for example, 1ms), it might cause
+excessive cpu overhead.</p>
+<p>This feature is also only enabled on non-oneway endpoints.
+<p class='snippet_footer'>
This page was generated by Apache Thrift's <strong>source tree docs</strong>:
<a href="https://gitbox.apache.org/repos/asf?p=thrift.git;a=blob;f=lib/go/README.md;hb=HEAD"</a>lib/go/README.md</a>
</p></p>
Modified: websites/staging/thrift/trunk/content/lib/netstd.html
==============================================================================
--- websites/staging/thrift/trunk/content/lib/netstd.html (original)
+++ websites/staging/thrift/trunk/content/lib/netstd.html Fri Nov 20 17:19:21 2020
@@ -96,7 +96,7 @@ or </li>
</ul>
<h2 id="how-to-build-on-unixlinux">How to build on Unix/Linux<a class="headerlink" href="#how-to-build-on-unixlinux" title="Permanent link">¶</a></h2>
<ul>
-<li>Ensure you have .NET SDK >= 2.0 installed, or use the <a href="../../build/docker/README">Ubuntu docker image</a></li>
+<li>Ensure you have .NET Core SDK 3.1 (LTS) installed, or use the <a href="../../build/docker/README">Ubuntu docker image</a></li>
<li>Follow common automake build practice: <code>./ bootstrap && ./ configure && make</code></li>
</ul>
<h2 id="known-issues">Known issues<a class="headerlink" href="#known-issues" title="Permanent link">¶</a></h2>
Modified: websites/staging/thrift/trunk/content/lib/nodejs.html
==============================================================================
--- websites/staging/thrift/trunk/content/lib/nodejs.html (original)
+++ websites/staging/thrift/trunk/content/lib/nodejs.html Fri Nov 20 17:19:21 2020
@@ -125,8 +125,8 @@ var thrift = require('thrift'),
<h2 id="use-on-browsers">Use on browsers<a class="headerlink" href="#use-on-browsers" title="Permanent link">¶</a></h2>
<p>You can use code generated with js:node on browsers with Webpack. Here is an example.</p>
<p>thrift --gen js:node,ts,es6,with_ns</p>
-<p>```
-import * as thrift from 'thrift/browser';
+<p>```javascript
+import * as thrift from 'thrift';
import { MyServiceClient } from '../gen-nodejs/MyService';</p>
<p>let host = window.location.hostname;
let port = 443;
@@ -153,7 +153,32 @@ let thriftClient = thrift.createXHRClien
....
});
```</p>
-<p>Note that thrift/index.js must be renamed or skipped for browsers.
+<p>Bundlers, like webpack, will use thrift/browser.js by default because of the
+<code>"browser": "./lib/nodejs/lib/thrift/browser.js"</code> field in package.json.</p>
+<h3 id="browser-example-with-websocket-bufferedtransport-and-binaryprotocol">Browser example with WebSocket, BufferedTransport and BinaryProtocol<a class="headerlink" href="#browser-example-with-websocket-bufferedtransport-and-binaryprotocol" title="Permanent link">¶</a></h3>
+<p>```javascript
+import thrift from 'thrift';
+import { MyServiceClient } from '../gen-nodejs/MyService';</p>
+<p>const host = window.location.hostname;
+const port = 9090;
+const opts = {
+ transport: thrift.TBufferedTransport,
+ protocol: thrift.TBinaryProtocol
+}
+const connection = thrift.createWSConnection(host, port, opts);
+connection.open();
+const thriftClient = thrift.createWSClient(MyServiceClient, connection);</p>
+<p>connection.on('error', (err) => {
+ console.error(err);
+});</p>
+<p>thriftClient.myService(param)
+ .then((result) => {
+ console.log(result);
+ })
+ .catch((err) => {
+ ....
+ });
+```
<p class='snippet_footer'>
This page was generated by Apache Thrift's <strong>source tree docs</strong>:
<a href="https://gitbox.apache.org/repos/asf?p=thrift.git;a=blob;f=lib/nodejs/README.md;hb=HEAD"</a>lib/nodejs/README.md</a>
Modified: websites/staging/thrift/trunk/content/lib/perl.html
==============================================================================
--- websites/staging/thrift/trunk/content/lib/perl.html (original)
+++ websites/staging/thrift/trunk/content/lib/perl.html Fri Nov 20 17:19:21 2020
@@ -115,6 +115,11 @@ to use Thrift.</p>
<li>Bit::Vector</li>
<li>Class::Accessor</li>
</ul>
+<h2 id="test">Test<a class="headerlink" href="#test" title="Permanent link">¶</a></h2>
+<p>This is only required when running tests:</p>
+<ul>
+<li>Test::Exception</li>
+</ul>
<h3 id="httpclient-transport">HttpClient Transport<a class="headerlink" href="#httpclient-transport" title="Permanent link">¶</a></h3>
<p>These are only required if using Thrift::HttpClient:</p>
<ul>
Modified: websites/staging/thrift/trunk/content/lib/php.html
==============================================================================
--- websites/staging/thrift/trunk/content/lib/php.html (original)
+++ websites/staging/thrift/trunk/content/lib/php.html Fri Nov 20 17:19:21 2020
@@ -87,7 +87,7 @@ h2:hover > .headerlink, h3:hover > .head
<h1 id="using-thrift-with-php">Using Thrift with PHP<a class="headerlink" href="#using-thrift-with-php" title="Permanent link">¶</a></h1>
<p>Thrift requires PHP 5. Thrift makes as few assumptions about your PHP
environment as possible while trying to make some more advanced PHP
-features (i.e. APC cacheing using asbolute path URLs) as simple as possible.</p>
+features (i.e. APCu cacheing using asbolute path URLs) as simple as possible.</p>
<p>To use Thrift in your PHP codebase, take the following steps:</p>
<ol>
<li>Copy all of thrift/lib/php/lib into your PHP codebase</li>
@@ -105,8 +105,8 @@ require_once 'packages/Service/Types.php
</pre></div>
-<p>apc_fetch(), apc_store()</p>
-<div class="codehilite"><pre><span class="n">APC</span> <span class="n">cache</span> <span class="n">is</span> <span class="n">used</span> <span class="n">by</span> <span class="n">the</span> <span class="n">TSocketPool</span> <span class="n">class</span><span class="p">.</span> <span class="n">If</span> <span class="n">you</span> <span class="n">do</span> <span class="n">not</span> <span class="n">have</span> <span class="n">APC</span> <span class="n">installed</span><span class="p">,</span>
+<p>apcu_fetch(), apcu_store()</p>
+<div class="codehilite"><pre><span class="n">APCu</span> <span class="n">cache</span> <span class="n">is</span> <span class="n">used</span> <span class="n">by</span> <span class="n">the</span> <span class="n">TSocketPool</span> <span class="n">class</span><span class="p">.</span> <span class="n">If</span> <span class="n">you</span> <span class="n">do</span> <span class="n">not</span> <span class="n">have</span> <span class="n">APCu</span> <span class="n">installed</span><span class="p">,</span>
<span class="n">Thrift</span> <span class="n">will</span> <span class="n">fill</span> <span class="n">in</span> <span class="n">null</span> <span class="n">stub</span> <span class="k">function</span> <span class="n">definitions</span><span class="p">.</span>
</pre></div>
Modified: websites/staging/thrift/trunk/content/test/ThriftTest.html
==============================================================================
--- websites/staging/thrift/trunk/content/test/ThriftTest.html (original)
+++ websites/staging/thrift/trunk/content/test/ThriftTest.html Fri Nov 20 17:19:21 2020
@@ -508,9 +508,7 @@ h2:hover > .headerlink, h3:hover > .head
410
411
412
-413
-414
-415</pre></div></td><td class="code"><div class="codehilite"><pre>/*
+413</pre></div></td><td class="code"><div class="codehilite"><pre>/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
@@ -535,13 +533,11 @@ h2:hover > .headerlink, h3:hover > .head
namespace c_glib TTest
namespace cpp thrift.test
-namespace csharp Thrift.Test
namespace delphi Thrift.Test
namespace go thrifttest
namespace java thrift.test
namespace js ThriftTest
namespace lua ThriftTest
-namespace netcore ThriftTest
namespace netstd ThriftTest
namespace perl ThriftTest
namespace php ThriftTest
Modified: websites/staging/thrift/trunk/content/test/index.html
==============================================================================
--- websites/staging/thrift/trunk/content/test/index.html (original)
+++ websites/staging/thrift/trunk/content/test/index.html Fri Nov 20 17:19:21 2020
@@ -104,7 +104,7 @@ precross</code> once before executing it
<p>For example, if you changed something in <code>nodejs</code> library and need to verify
the patch, you can skip everything except <code>nodejs</code> itself and some reference
implementation (currently <code>cpp</code> and <code>java</code> are recommended) like this:</p>
-<div class="codehilite"><pre><span class="o">./</span><span class="n">configure</span> <span class="o">--</span><span class="n">without</span><span class="o">-</span><span class="n">c_glib</span> <span class="o">-</span><span class="n">without</span><span class="o">-</span><span class="n">csharp</span> <span class="o">--</span><span class="n">without</span><span class="o">-</span><span class="n">erlang</span> <span class="o">--</span><span class="n">without</span><span class="o">-</span><span class="n">lua</span> <span class="p">...</span>
+<div class="codehilite"><pre><span class="o">./</span><span class="n">configure</span> <span class="o">--</span><span class="n">without</span><span class="o">-</span><span class="n">c_glib</span> <span class="o">--</span><span class="n">without</span><span class="o">-</span><span class="n">erlang</span> <span class="o">--</span><span class="n">without</span><span class="o">-</span><span class="n">lua</span> <span class="p">...</span>
<span class="n">make</span> <span class="n">precross</span> <span class="o">-</span><span class="n">j8</span>
<span class="n">test</span><span class="o">/</span><span class="n">test</span><span class="p">.</span><span class="n">py</span> <span class="o">--</span><span class="n">server</span> <span class="n">cpp</span><span class="p">,</span><span class="n">java</span> <span class="o">--</span><span class="n">client</span> <span class="n">nodejs</span>
<span class="n">test</span><span class="o">/</span><span class="n">test</span><span class="p">.</span><span class="n">py</span> <span class="o">--</span><span class="n">server</span> <span class="n">nodejs</span> <span class="o">--</span><span class="n">client</span> <span class="n">cpp</span><span class="p">,</span><span class="n">java</span>
@@ -195,38 +195,46 @@ cross language tests according to <a hre
provided for every language including executables with the following command
line interface:</p>
<p><strong>Server command line interface:</strong></p>
-<div class="codehilite"><pre>$ <span class="o">./</span><span class="n">cpp</span><span class="o">/</span><span class="n">TestServer</span> <span class="o">-</span><span class="n">h</span>
+<div class="codehilite"><pre>$ <span class="o">./</span><span class="n">TestServer</span> <span class="o">-</span><span class="n">h</span>
<span class="n">Allowed</span> <span class="n">options</span><span class="p">:</span>
- <span class="o">-</span><span class="n">h</span> <span class="p">[</span> <span class="o">--</span><span class="n">help</span> <span class="p">]</span> <span class="n">produce</span> <span class="n">help</span> <span class="n">message</span>
- <span class="o">--</span><span class="n">port</span> <span class="n">arg</span> <span class="p">(=</span>9090<span class="p">)</span> <span class="n">Port</span> <span class="n">number</span> <span class="n">to</span> <span class="n">listen</span>
- <span class="o">--</span><span class="n">domain</span><span class="o">-</span><span class="n">socket</span> <span class="n">arg</span> <span class="n">Unix</span> <span class="n">Domain</span> <span class="n">Socket</span> <span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="n">g</span><span class="p">.</span> <span class="o">/</span><span class="n">tmp</span><span class="o">/</span><span class="n">ThriftTest</span><span class="p">.</span><span class="n">thrift</span><span class="p">)</span>
- <span class="o">--</span><span class="n">named</span><span class="o">-</span><span class="n">pipe</span> <span class="n">arg</span> <span class="n">Windows</span> <span class="n">Named</span> <span class="n">Pipe</span> <span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="n">g</span><span class="p">.</span> <span class="n">MyThriftPipe</span><span class="p">)</span>
- <span class="o">--</span><span class="n">server</span><span class="o">-</span><span class="n">type</span> <span class="n">arg</span> <span class="p">(=</span><span class="n">simple</span><span class="p">)</span> <span class="n">type</span> <span class="n">of</span> <span class="n">server</span><span class="p">,</span> "<span class="n">simple</span>"<span class="p">,</span> "<span class="n">thread</span><span class="o">-</span><span class="n">pool</span>"<span class="p">,</span>
- "<span class="n">threaded</span>"<span class="p">,</span> <span class="n">or</span> "<span class="n">nonblocking</span>"
- <span class="o">--</span><span class="n">transport</span> <span class="n">arg</span> <span class="p">(=</span><span class="n">buffered</span><span class="p">)</span> <span class="n">transport</span><span class="p">:</span> <span class="n">buffered</span><span class="p">,</span> <span class="n">framed</span><span class="p">,</span> <span class="n">http</span><span class="p">,</span> <span class="n">anonpipe</span>
- <span class="o">--</span><span class="n">protocol</span> <span class="n">arg</span> <span class="p">(=</span><span class="n">binary</span><span class="p">)</span> <span class="n">protocol</span><span class="p">:</span> <span class="n">binary</span><span class="p">,</span> <span class="n">compact</span><span class="p">,</span> <span class="n">json</span>
- <span class="o">--</span><span class="n">ssl</span> <span class="n">Encrypted</span> <span class="n">Transport</span> <span class="n">using</span> <span class="n">SSL</span>
- <span class="o">--</span><span class="n">processor</span><span class="o">-</span><span class="k">events</span> <span class="n">processor</span><span class="o">-</span><span class="k">events</span>
- <span class="o">-</span><span class="n">n</span> <span class="p">[</span> <span class="o">--</span><span class="n">workers</span> <span class="p">]</span> <span class="n">arg</span> <span class="p">(=</span>4<span class="p">)</span> <span class="n">Number</span> <span class="n">of</span> <span class="n">thread</span> <span class="n">pools</span> <span class="n">workers</span><span class="p">.</span> <span class="n">Only</span> <span class="n">valid</span> <span class="k">for</span>
- <span class="n">thread</span><span class="o">-</span><span class="n">pool</span> <span class="n">server</span> <span class="n">type</span>
+ <span class="o">-</span><span class="n">h</span> <span class="o">|</span> <span class="o">--</span><span class="n">help</span> <span class="n">produce</span> <span class="n">help</span> <span class="n">message</span>
+ <span class="o">--</span><span class="n">port</span><span class="p">=</span><span class="n">arg</span> <span class="p">(</span>9090<span class="p">)</span> <span class="n">Port</span> <span class="n">number</span> <span class="n">to</span> <span class="n">listen</span>
+ <span class="o">--</span><span class="n">domain</span><span class="o">-</span><span class="n">socket</span><span class="p">=</span><span class="n">arg</span> <span class="n">Unix</span> <span class="n">Domain</span> <span class="n">Socket</span> <span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="n">g</span><span class="p">.</span> <span class="o">/</span><span class="n">tmp</span><span class="o">/</span><span class="n">ThriftTest</span><span class="p">.</span><span class="n">thrift</span><span class="p">)</span>
+ <span class="o">--</span><span class="n">pipe</span><span class="p">=</span><span class="n">arg</span> <span class="n">Windows</span> <span class="n">Named</span> <span class="n">Pipe</span> <span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="n">g</span><span class="p">.</span> <span class="n">MyThriftPipe</span><span class="p">)</span>
+ <span class="o">--</span><span class="n">server</span><span class="o">-</span><span class="n">type</span><span class="p">=</span><span class="n">arg</span> <span class="p">(</span><span class="n">simple</span><span class="p">)</span> <span class="n">type</span> <span class="n">of</span> <span class="n">server</span><span class="p">,</span> "<span class="n">simple</span>"<span class="p">,</span> "<span class="n">thread</span><span class="o">-</span><span class="n">pool</span>"<span class="p">,</span>
+ "<span class="n">threaded</span>"<span class="p">,</span> <span class="n">or</span> "<span class="n">nonblocking</span>"
+ <span class="o">--</span><span class="n">transport</span><span class="p">=</span><span class="n">arg</span> <span class="p">(</span><span class="n">buffered</span><span class="p">)</span> <span class="n">transport</span><span class="p">:</span> <span class="n">buffered</span><span class="p">,</span> <span class="n">framed</span><span class="p">,</span> <span class="n">http</span><span class="p">,</span> <span class="n">anonpipe</span><span class="p">,</span> <span class="n">zlib</span>
+ <span class="o">--</span><span class="n">protocol</span><span class="p">=</span><span class="n">arg</span> <span class="p">(</span><span class="n">binary</span><span class="p">)</span> <span class="n">protocol</span><span class="p">:</span> <span class="n">binary</span><span class="p">,</span> <span class="n">compact</span><span class="p">,</span> <span class="n">header</span><span class="p">,</span> <span class="n">json</span>
+ <span class="o">--</span><span class="n">multiplex</span> <span class="n">Add</span> <span class="n">TMultiplexedProtocol</span> <span class="n">service</span> <span class="n">name</span> "<span class="n">ThriftTest</span>"
+ <span class="o">--</span><span class="n">abstract</span><span class="o">-</span><span class="n">namespace</span> <span class="n">Create</span> <span class="n">the</span> <span class="n">domain</span> <span class="n">socket</span> <span class="n">in</span> <span class="n">the</span> <span class="n">Abstract</span> <span class="n">Namespace</span>
+ <span class="p">(</span><span class="n">no</span> <span class="n">connection</span> <span class="n">with</span> <span class="n">filesystem</span> <span class="n">pathnames</span><span class="p">)</span>
+ <span class="o">--</span><span class="n">ssl</span> <span class="n">Encrypted</span> <span class="n">Transport</span> <span class="n">using</span> <span class="n">SSL</span>
+ <span class="o">--</span><span class="n">zlib</span> <span class="n">Wrapped</span> <span class="n">Transport</span> <span class="n">using</span> <span class="n">Zlib</span>
+ <span class="o">--</span><span class="n">processor</span><span class="o">-</span><span class="k">events</span> <span class="n">processor</span><span class="o">-</span><span class="k">events</span>
+ <span class="o">-</span><span class="n">n</span><span class="p">=</span><span class="n">arg</span> <span class="o">|</span> <span class="o">--</span><span class="n">workers</span><span class="p">=</span><span class="n">arg</span> <span class="p">(=</span>4<span class="p">)</span> <span class="n">Number</span> <span class="n">of</span> <span class="n">thread</span> <span class="n">pools</span> <span class="n">workers</span><span class="p">.</span> <span class="n">Only</span> <span class="n">valid</span> <span class="k">for</span>
+ <span class="n">thread</span><span class="o">-</span><span class="n">pool</span> <span class="n">server</span> <span class="n">type</span>
</pre></div>
<p><strong>Client command line interface:</strong></p>
-<div class="codehilite"><pre>$ <span class="o">./</span><span class="n">cpp</span><span class="o">/</span><span class="n">TestClient</span> <span class="o">-</span><span class="n">h</span>
+<div class="codehilite"><pre>$ <span class="o">./</span><span class="n">TestClient</span> <span class="o">-</span><span class="n">h</span>
<span class="n">Allowed</span> <span class="n">options</span><span class="p">:</span>
- <span class="o">-</span><span class="n">h</span> <span class="p">[</span> <span class="o">--</span><span class="n">help</span> <span class="p">]</span> <span class="n">produce</span> <span class="n">help</span> <span class="n">message</span>
- <span class="o">--</span><span class="n">host</span> <span class="n">arg</span> <span class="p">(=</span><span class="n">localhost</span><span class="p">)</span> <span class="n">Host</span> <span class="n">to</span> <span class="n">connect</span>
- <span class="o">--</span><span class="n">port</span> <span class="n">arg</span> <span class="p">(=</span>9090<span class="p">)</span> <span class="n">Port</span> <span class="n">number</span> <span class="n">to</span> <span class="n">connect</span>
- <span class="o">--</span><span class="n">domain</span><span class="o">-</span><span class="n">socket</span> <span class="n">arg</span> <span class="n">Domain</span> <span class="n">Socket</span> <span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="n">g</span><span class="p">.</span> <span class="o">/</span><span class="n">tmp</span><span class="o">/</span><span class="n">ThriftTest</span><span class="p">.</span><span class="n">thrift</span><span class="p">),</span>
- <span class="n">instead</span> <span class="n">of</span> <span class="n">host</span> <span class="n">and</span> <span class="n">port</span>
- <span class="o">--</span><span class="n">named</span><span class="o">-</span><span class="n">pipe</span> <span class="n">arg</span> <span class="n">Windows</span> <span class="n">Named</span> <span class="n">Pipe</span> <span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="n">g</span><span class="p">.</span> <span class="n">MyThriftPipe</span><span class="p">)</span>
- <span class="o">--</span><span class="n">anon</span><span class="o">-</span><span class="n">pipes</span> <span class="n">hRead</span> <span class="n">hWrite</span> <span class="n">Windows</span> <span class="n">Anonymous</span> <span class="n">Pipes</span> <span class="n">pair</span> <span class="p">(</span><span class="n">handles</span><span class="p">)</span>
- <span class="o">--</span><span class="n">transport</span> <span class="n">arg</span> <span class="p">(=</span><span class="n">buffered</span><span class="p">)</span> <span class="n">Transport</span><span class="p">:</span> <span class="n">buffered</span><span class="p">,</span> <span class="n">framed</span><span class="p">,</span> <span class="n">http</span><span class="p">,</span> <span class="n">evhttp</span>
- <span class="o">--</span><span class="n">protocol</span> <span class="n">arg</span> <span class="p">(=</span><span class="n">binary</span><span class="p">)</span> <span class="n">Protocol</span><span class="p">:</span> <span class="n">binary</span><span class="p">,</span> <span class="n">compact</span><span class="p">,</span> <span class="n">json</span>
- <span class="o">--</span><span class="n">ssl</span> <span class="n">Encrypted</span> <span class="n">Transport</span> <span class="n">using</span> <span class="n">SSL</span>
- <span class="o">-</span><span class="n">n</span> <span class="p">[</span> <span class="o">--</span><span class="n">testloops</span> <span class="p">]</span> <span class="n">arg</span> <span class="p">(=</span>1<span class="p">)</span> <span class="n">Number</span> <span class="n">of</span> <span class="n">Tests</span>
- <span class="o">-</span><span class="n">t</span> <span class="p">[</span> <span class="o">--</span><span class="n">threads</span> <span class="p">]</span> <span class="n">arg</span> <span class="p">(=</span>1<span class="p">)</span> <span class="n">Number</span> <span class="n">of</span> <span class="n">Test</span> <span class="n">threads</span>
+ <span class="o">-</span><span class="n">h</span> <span class="o">|</span> <span class="o">--</span><span class="n">help</span> <span class="n">produce</span> <span class="n">help</span> <span class="n">message</span>
+ <span class="o">--</span><span class="n">host</span><span class="p">=</span><span class="n">arg</span> <span class="p">(</span><span class="n">localhost</span><span class="p">)</span> <span class="n">Host</span> <span class="n">to</span> <span class="n">connect</span>
+ <span class="o">--</span><span class="n">port</span><span class="p">=</span><span class="n">arg</span> <span class="p">(</span>9090<span class="p">)</span> <span class="n">Port</span> <span class="n">number</span> <span class="n">to</span> <span class="n">connect</span>
+ <span class="o">--</span><span class="n">domain</span><span class="o">-</span><span class="n">socket</span><span class="p">=</span><span class="n">arg</span> <span class="n">Domain</span> <span class="n">Socket</span> <span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="n">g</span><span class="p">.</span> <span class="o">/</span><span class="n">tmp</span><span class="o">/</span><span class="n">ThriftTest</span><span class="p">.</span><span class="n">thrift</span><span class="p">),</span>
+ <span class="n">instead</span> <span class="n">of</span> <span class="n">host</span> <span class="n">and</span> <span class="n">port</span>
+ <span class="o">--</span><span class="n">pipe</span><span class="p">=</span><span class="n">arg</span> <span class="n">Windows</span> <span class="n">Named</span> <span class="n">Pipe</span> <span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="n">g</span><span class="p">.</span> <span class="n">MyThriftPipe</span><span class="p">)</span>
+ <span class="o">--</span><span class="n">anon</span><span class="o">-</span><span class="n">pipes</span> <span class="n">hRead</span> <span class="n">hWrite</span> <span class="n">Windows</span> <span class="n">Anonymous</span> <span class="n">Pipes</span> <span class="n">pair</span> <span class="p">(</span><span class="n">handles</span><span class="p">)</span>
+ <span class="o">--</span><span class="n">abstract</span><span class="o">-</span><span class="n">namespace</span> <span class="n">Create</span> <span class="n">the</span> <span class="n">domain</span> <span class="n">socket</span> <span class="n">in</span> <span class="n">the</span> <span class="n">Abstract</span> <span class="n">Namespace</span>
+ <span class="p">(</span><span class="n">no</span> <span class="n">connection</span> <span class="n">with</span> <span class="n">filesystem</span> <span class="n">pathnames</span><span class="p">)</span>
+ <span class="o">--</span><span class="n">transport</span><span class="p">=</span><span class="n">arg</span> <span class="p">(</span><span class="n">buffered</span><span class="p">)</span> <span class="n">Transport</span><span class="p">:</span> <span class="n">buffered</span><span class="p">,</span> <span class="n">framed</span><span class="p">,</span> <span class="n">http</span><span class="p">,</span> <span class="n">evhttp</span><span class="p">,</span> <span class="n">zlib</span>
+ <span class="o">--</span><span class="n">protocol</span><span class="p">=</span><span class="n">arg</span> <span class="p">(</span><span class="n">binary</span><span class="p">)</span> <span class="n">Protocol</span><span class="p">:</span> <span class="n">binary</span><span class="p">,</span> <span class="n">compact</span><span class="p">,</span> <span class="n">header</span><span class="p">,</span> <span class="n">json</span>
+ <span class="o">--</span><span class="n">multiplex</span> <span class="n">Add</span> <span class="n">TMultiplexedProtocol</span> <span class="n">service</span> <span class="n">name</span> "<span class="n">ThriftTest</span>"
+ <span class="o">--</span><span class="n">ssl</span> <span class="n">Encrypted</span> <span class="n">Transport</span> <span class="n">using</span> <span class="n">SSL</span>
+ <span class="o">--</span><span class="n">zlib</span> <span class="n">Wrap</span> <span class="n">Transport</span> <span class="n">with</span> <span class="n">Zlib</span>
+ <span class="o">-</span><span class="n">n</span><span class="p">=</span><span class="n">arg</span> <span class="o">|</span> <span class="o">--</span><span class="n">testloops</span><span class="p">=</span><span class="n">arg</span> <span class="p">(</span>1<span class="p">)</span> <span class="n">Number</span> <span class="n">of</span> <span class="n">Tests</span>
+ <span class="o">-</span><span class="n">t</span><span class="p">=</span><span class="n">arg</span> <span class="o">|</span> <span class="o">--</span><span class="n">threads</span><span class="p">=</span><span class="n">arg</span> <span class="p">(</span>1<span class="p">)</span> <span class="n">Number</span> <span class="n">of</span> <span class="n">Test</span> <span class="n">threads</span>
</pre></div>