Apache Thrift

https://github.com/apache/thrift
Admin
Thrift is a lightweight, language-independent software stack for point-to-point RPC implementation...
Tokens:128,429
Snippets:2,315
Trust Score:9.4
License:Apache-2.0
Update:4 months ago
Show doc for...
Tokens:
Raw
### Project and Dependency Setup

Source: https://github.com/apache/thrift/blob/master/compiler/cpp/CMakeLists.txt

Initializes the CMake project and finds required packages like Flex and Bison. Ensure these tools are installed and discoverable by CMake.

```cmake
cmake_minimum_required(VERSION 3.16)
project("thrift-compiler" VERSION ${PACKAGE_VERSION})
```

```cmake
find_package(FLEX REQUIRED)
find_package(BISON REQUIRED)
```

--------------------------------

### Run Cross Test Server with Gradle

Source: https://github.com/apache/thrift/blob/master/lib/kotlin/README.md

Execute this Gradle command to start the cross-test server. This is part of the testing setup for Kotlin code generation.

```bash
gradle :cross-test-server:run
```

--------------------------------

### Installing Development Tools and Kernel Headers

Source: https://github.com/apache/thrift/blob/master/contrib/vagrant/centos-6.5/README.md

Commands to install necessary packages for building and VirtualBox guest additions.

```bash
yum -y install perl
yum -y --enablerepo epel install dkms
yum -y groupinstall "Development Tools"
yum -y install kernel-devel
```

--------------------------------

### Install HaxeLibs for C++ Target

Source: https://github.com/apache/thrift/blob/master/lib/haxe/README.md

Install the Haxe C++ target library. This is an example of installing HaxeLibs for a specific target.

```bash
haxelib install hxcpp
```

--------------------------------

### Build and Install Thrift Ruby from Source

Source: https://github.com/apache/thrift/blob/master/lib/rb/README.md

Install the Thrift Ruby library from source. This method involves bundling dependencies, building the gem, and then installing it. The native accelerator is built during installation on supported runtimes.

```bash
bundle install
gem build thrift.gemspec

```

--------------------------------

### Install JavaScript Library and Documentation

Source: https://github.com/apache/thrift/blob/master/lib/js/CMakeLists.txt

Installs the compiled JavaScript library files (matching 'thrift*.js') to the configured JavaScript installation directory and installs the documentation files.

```cmake
install(DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/dist/"
        DESTINATION "${JAVASCRIPT_INSTALL_DIR}"
        FILES_MATCHING PATTERN "thrift*.js")
install(DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/doc/"
        DESTINATION "${JAVASCRIPT_DOC_INSTALL_DIR}")
```

--------------------------------

### Install Distribution for Kotlin Test Library

Source: https://github.com/apache/thrift/blob/master/lib/kotlin/README.md

Run this command to install the distribution for the Kotlin test library. This is useful for deployment or further testing.

```bash
gradle installDist
```

--------------------------------

### Build and Install Thrift

Source: https://github.com/apache/thrift/blob/master/doc/install/windows.md

Execute make and make install from the top Thrift directory to build the compiler and runtime libraries.

```bash
make
make install
```

--------------------------------

### Install Thrift Node.js Library

Source: https://github.com/apache/thrift/blob/master/lib/nodejs/README.md

Use npm to install the Thrift Node.js library. Ensure Node.js 10.18 or later is installed.

```bash
npm install thrift 
```

--------------------------------

### Example: Generate Compact Protocol Corpus

Source: https://github.com/apache/thrift/blob/master/lib/rb/test/fuzz/README.md

Example command to generate 1000 compact protocol corpus files with specified buffer and random sizes.

```bash
cargo run --manifest-path lib/rs/test/fuzz/Cargo.toml --bin corpus_generator -- \
    --output-dir ./lib/rs/test/fuzz/corpus/compact \
    --protocol compact \
    --generate 1000 \
    --buffer-size 16384 \
    --random-size 16384
```

--------------------------------

### Run Tutorial with Make (All-in-One)

Source: https://github.com/apache/thrift/blob/master/tutorial/java/README.md

Start the tutorial server and client simultaneously using 'make tutorial'.

```bash
thrift/tutorial/java$ make tutorial
```

--------------------------------

### Install Thrift

Source: https://github.com/apache/thrift/blob/master/README.md

Install Thrift system-wide after building, typically requiring superuser privileges.

```bash
make install
```

--------------------------------

### Example: Generate Binary Protocol Corpus

Source: https://github.com/apache/thrift/blob/master/lib/rb/test/fuzz/README.md

Example command to generate 1000 binary protocol corpus files with specified buffer and random sizes.

```bash
cargo run --manifest-path lib/rs/test/fuzz/Cargo.toml --bin corpus_generator -- \
    --output-dir ./lib/rs/test/fuzz/corpus/binary \
    --protocol binary \
    --generate 1000 \
    --buffer-size 65536 \
    --random-size 16384
```

--------------------------------

### Node.js Thrift Client for Browsers with WebSocket

Source: https://github.com/apache/thrift/blob/master/lib/nodejs/README.md

This example demonstrates creating a Thrift client for browsers using WebSocket for transport, BufferedTransport, and BinaryProtocol. It includes connection setup and error handling.

```javascript
import thrift from 'thrift';
import { MyServiceClient } from '../gen-nodejs/MyService';

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);

connection.on('error', (err) => {
  console.error(err);
});

thriftClient.myService(param)
  .then((result) => {
    console.log(result);
  })
  .catch((err) => {
    ....
  });

```

--------------------------------

### Updating System and Installing VirtualBox Guest Additions

Source: https://github.com/apache/thrift/blob/master/contrib/vagrant/centos-6.5/README.md

Commands to update all packages, reboot, and install VirtualBox Guest Additions from the mounted CD-ROM.

```bash
yum update
reboot
mount /dev/cdrom /mnt
/mnt/VBoxLinuxAdditions.run
umount /mnt
```

--------------------------------

### Install Thrift Haxe Bindings (Development Version)

Source: https://github.com/apache/thrift/blob/master/lib/haxe/README.md

Install the latest development version of the Thrift Haxe bindings using haxelib from the master branch.

```bash
haxelib git thrift https://github.com/apache/thrift.git master lib/haxe
```

--------------------------------

### Run Tutorial Server and Client Separately with Make

Source: https://github.com/apache/thrift/blob/master/tutorial/java/README.md

Start the tutorial server and client independently using 'make tutorialserver' and 'make tutorialclient'.

```bash
thrift/tutorial/java$ make tutorialserver
thrift/tutorial/java$ make tutorialclient
```

--------------------------------

### Install Build Tools and Libraries on Debian/Ubuntu

Source: https://github.com/apache/thrift/blob/master/doc/install/debian.md

Installs essential tools and libraries for building the Apache Thrift compiler and C++ libraries on Debian/Ubuntu. Run this command first.

```bash
sudo apt-get install automake bison flex g++ git libboost-all-dev libevent-dev libssl-dev libtool make pkg-config
```

--------------------------------

### Compile and Install Boost on OS X

Source: https://github.com/apache/thrift/blob/master/doc/install/os_x.md

Steps to compile and install the Boost library on an OS X system. Ensure you download the library from boost.org first.

```bash
./bootstrap.sh
sudo ./b2 threading=multi address-model=64 variant=release stage install
```

--------------------------------

### Run Tutorial Server and Client Separately with Ant

Source: https://github.com/apache/thrift/blob/master/tutorial/java/README.md

Start the tutorial server and client independently using 'ant tutorialserver' and 'ant tutorialclient'.

```bash
thrift/tutorial/java$ ant tutorialserver
thrift/tutorial/java$ ant tutorialclient
```

--------------------------------

### Installing EPEL Repository on Centos 6.5

Source: https://github.com/apache/thrift/blob/master/contrib/vagrant/centos-6.5/README.md

Commands to install the EPEL repository, protecting base repositories.

```bash
yum -y install yum-plugin-protectbase
rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm
```

--------------------------------

### Setup OASIS Build Tool

Source: https://github.com/apache/thrift/blob/master/tutorial/ocaml/README.md

Initializes the build environment using the OASIS build tool. This prepares the project for compilation.

```bash
oasis setup
```

--------------------------------

### Build and Install Apache Thrift

Source: https://github.com/apache/thrift/blob/master/doc/install/centos.md

Clones the Thrift repository, configures the build, and installs the Thrift IDL compiler and libraries.

```bash
git clone https://github.com/apache/thrift.git
cd thrift
./bootstrap.sh
./configure --with-lua=no
make
sudo make install
```

--------------------------------

### Setup Thrift WebSocket Client

Source: https://github.com/apache/thrift/blob/master/lib/js/test/test-es6.html

Establishes a WebSocket connection and initializes a Thrift client for testing. Ensure Thrift library is loaded and the server is accessible.

```javascript
const loc = window.location;
const ws_uri = ((loc.protocol === "https:") ? "wss://" : "ws://") + loc.hostname + ":" + loc.port + loc.pathname;
const transport = new Thrift.TWebSocketTransport(ws_uri);
const protocol = new Thrift.Protocol(transport);
const client = new ThriftTest.ThriftTestClient(protocol);
transport.open();
```

--------------------------------

### Install Java Library and Docs

Source: https://github.com/apache/thrift/blob/master/lib/java/CMakeLists.txt

CMake install commands for the Java library JARs and Javadoc. These commands ensure the built artifacts are placed in the correct installation directories.

```cmake
install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/build/libs/
        DESTINATION ${JAVA_INSTALL_DIR}
        FILES_MATCHING PATTERN "libthrift-${thrift_version}.jar")
install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/build/deps/
        DESTINATION ${JAVA_INSTALL_DIR}
        FILES_MATCHING PATTERN "*.jar")
install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/build/docs/javadoc/
        DESTINATION ${JAVA_DOC_INSTALL_DIR})
```

--------------------------------

### Cassandra Client Example (Node.js)

Source: https://github.com/apache/thrift/blob/master/lib/nodejs/README.md

Example of creating a Thrift connection and a Cassandra client to perform a get_slice operation. Handles connection errors and processes the returned data.

```javascript
var thrift = require('thrift'),
    Cassandra = require('./gen-nodejs/Cassandra')
    ttypes = require('./gen-nodejs/cassandra_types');

var connection = thrift.createConnection("localhost", 9160),
    client = thrift.createClient(Cassandra, connection);

connection.on('error', function(err) {
  console.error(err);
});

client.get_slice("Keyspace", "key", new ttypes.ColumnParent({column_family: "ExampleCF"}), new ttypes.SlicePredicate({slice_range: new ttypes.SliceRange({start: '', finish: ''})}), ttypes.ConsistencyLevel.ONE, function(err, data) {
  if (err) {
    // handle err
  } else {
    // data == [ttypes.ColumnOrSuperColumn, ...]
  }
  connection.end();
});
```

--------------------------------

### Thrift StringCache Service Example

Source: https://github.com/apache/thrift/blob/master/doc/specs/thrift.tex

An example of a Thrift service definition for a StringCache, demonstrating set, get, and delete operations.

```thrift
service StringCache {
  void set(1:i32 key, 2:string value),
  string get(1:i32 key) throws (1:KeyNotFound knf),
  void delete(1:i32 key)
}
```

--------------------------------

### Install Jazzer.js

Source: https://github.com/apache/thrift/blob/master/lib/nodejs/test/fuzz/README.md

Install Jazzer.js as a development dependency using npm.

```bash
npm install --save-dev @jazzer.js/core
```

--------------------------------

### Install Clang and Ruzzy for Fuzzing

Source: https://github.com/apache/thrift/blob/master/lib/rb/test/fuzz/README.md

Installs the required clang compiler and the Ruzzy fuzzing tool. Ensure you are in the repository root when running these commands.

```bash
apt install -y clang-19

# from https://github.com/trailofbits/ruzzy?tab=readme-ov-file#installing
MAKE="make --environment-overrides V=1" \
     CC="/usr/bin/clang-19" \
     CXX="/usr/bin/clang++-19" \
     LDSHARED="/usr/bin/clang-19 -shared" \
     LDSHAREDXX="/usr/bin/clang++-19 -shared" \
     gem install ruzzy
```

--------------------------------

### Install Development Tools on CentOS

Source: https://github.com/apache/thrift/blob/master/doc/install/centos.md

Installs the necessary group of packages for software development on CentOS.

```bash
sudo yum -y groupinstall "Development Tools"
```

--------------------------------

### Run Thrift Node.js Server

Source: https://github.com/apache/thrift/blob/master/lib/nodejs/examples/README.md

Start the Node.js Thrift server. Ensure the NODE_PATH is set correctly to include the Thrift library.

```bash
NODE_PATH=../lib:../lib/thrift node server.js
```

--------------------------------

### Install Grunt Build Dependencies

Source: https://github.com/apache/thrift/blob/master/lib/js/README.md

Installs the necessary support files for the Grunt build tool by reading the package.json file.

```bash
npm install
```

--------------------------------

### Install D Language Compiler and Tools

Source: https://github.com/apache/thrift/blob/master/doc/install/debian.md

Installs the D language compiler (DMD) and associated tools using a script from the official D website.

```bash
curl -fsS https://dlang.org/install.sh | bash -s dmd
```

--------------------------------

### Install C++ Thrift Dependencies

Source: https://github.com/apache/thrift/blob/master/doc/install/centos.md

Installs development libraries required for building the C++ shared library for Apache Thrift.

```bash
sudo yum -y install libevent-devel zlib-devel openssl-devel
```

--------------------------------

### Install Thrift Go Package

Source: https://github.com/apache/thrift/blob/master/lib/go/README.md

Add the most recent version of the Thrift Go package to your project after initializing Go modules.

```bash
$ go get github.com/apache/thrift
```

--------------------------------

### Install Thrift Haxe Bindings (Stable Version)

Source: https://github.com/apache/thrift/blob/master/lib/haxe/README.md

Install a specific stable version of the Thrift Haxe bindings using haxelib. Replace '0.14.1' with the desired version.

```bash
haxelib git thrift https://github.com/apache/thrift.git 0.14.1 lib/haxe
```

--------------------------------

### Build Apache Thrift Compiler on OS X

Source: https://github.com/apache/thrift/blob/master/doc/install/os_x.md

Instructions to compile and install the Apache Thrift compiler after downloading the source. Ensure Boost and libevent are installed.

```bash
./configure --prefix=/usr/local/ --with-boost=/usr/local --with-libevent=/usr/local
```

--------------------------------

### Install Thrift Ruby Gem

Source: https://github.com/apache/thrift/blob/master/lib/rb/README.md

Install the Thrift Ruby library using RubyGems. This is the recommended method for most users.

```bash
gem install thrift
```

--------------------------------

### Install Gradle for Thrift Java Build

Source: https://github.com/apache/thrift/blob/master/lib/java/README.md

Installs a specific version of Gradle and its dependencies, essential for building the Thrift Java source when not using the wrapper.

```bash
export GRADLE_VERSION="8.4"
# install dependencies
apt-get install -y --no-install-recommends openjdk-17-jdk-headless wget unzip
# download gradle distribution
wget https://services.gradle.org/distributions/gradle-$GRADLE_VERSION-bin.zip -q -O /tmp/gradle-$GRADLE_VERSION-bin.zip
# check binary integrity
echo "3e1af3ae886920c3ac87f7a91f816c0c7c436f276a6eefdb3da152100fef72ae  /tmp/gradle-$GRADLE_VERSION-bin.zip" | sha256sum -c -
# unzip and install
unzip -d /tmp /tmp/gradle-$GRADLE_VERSION-bin.zip
mv /tmp/gradle-$GRADLE_VERSION /usr/local/gradle
ln -s /usr/local/gradle/bin/gradle /usr/local/bin
```

--------------------------------

### Compile and Install libevent on OS X

Source: https://github.com/apache/thrift/blob/master/doc/install/os_x.md

Steps to compile and install the libevent library on an OS X system. Download the library from the official libevent website.

```bash
./configure --prefix=/usr/local 
make
sudo make install
```

--------------------------------

### Accessing and Verifying Thrift Installation in Vagrant VM

Source: https://github.com/apache/thrift/blob/master/contrib/vagrant/centos-6.5/README.md

How to SSH into the Vagrant VM and check the installed Thrift version.

```bash
vagrant ssh
[vagrant@thrift ~]$ cd /thrift
[vagrant@thrift thrift]$ compiler/cpp/thrift --version
```

--------------------------------

### Run SSL Server

Source: https://github.com/apache/thrift/blob/master/test/keys/README.md

Starts an SSL server on port 9090 that serves web content using 'openssl s_server'.

```bash
openssl s_server -accept 9090 -www
```

--------------------------------

### Example AI-Assisted Commit Message

Source: https://github.com/apache/thrift/blob/master/AGENTS.md

An example demonstrating how to format a commit message when using AI assistance, including the JIRA ticket, description, affected client, and AI co-author information.

```text
THRIFT-9999: Fix connection timeout handling in Go client
Client: go

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
```

--------------------------------

### Configure Qt5 and Build Executable

Source: https://github.com/apache/thrift/blob/master/lib/cpp/test/qt/CMakeLists.txt

Finds the required Qt5 components and defines the executable for the TCP server test. Ensure Qt5 is installed and discoverable by CMake.

```cmake
set(CMAKE_AUTOMOC ON)
find_package(Qt5 REQUIRED COMPONENTS Test Network)
set(TQTcpServerTest_Qt5_SOURCES
    TQTcpServerTest.cpp
)
add_executable(TQTcpServerTest_Qt5 ${TQTcpServerTest_Qt5_SOURCES})
```

--------------------------------

### Install SharpFuzz IL-rewriter CLI

Source: https://github.com/apache/thrift/blob/master/lib/netstd/README.md

Installs the SharpFuzz IL-rewriter as a global .NET tool. Ensure the PATH environment variable is updated to include the tools directory for persistent access.

```bash
dotnet tool install --global SharpFuzz.CommandLine
export PATH="$PATH:$HOME/.dotnet/tools"
```

--------------------------------

### Install JavaScript Dependencies

Source: https://github.com/apache/thrift/blob/master/lib/js/CMakeLists.txt

Adds a custom target to install JavaScript dependencies using npm. This command runs 'npm install' in the current source directory.

```cmake
add_custom_target(ThriftJavascriptPreDeps ALL
    COMMENT "Installing Javascript dependencies using npm"
    DEPENDS copy-thrift-compiler
    COMMAND npm install
    WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}"
)
```

--------------------------------

### Cloning Apache Thrift and Starting Vagrant VM

Source: https://github.com/apache/thrift/blob/master/contrib/vagrant/centos-6.5/README.md

Steps to clone the Apache Thrift repository and initiate the Vagrant environment for Centos 6.5.

```bash
git clone https://github.com/apache/thrift
cd thrift/contrib/vagrant/centos-6.5
vagrant up
```

--------------------------------

### Basic Ruby Thrift Client

Source: https://github.com/apache/thrift/blob/master/lib/rb/README.md

Example of setting up and using a basic Thrift client in Ruby. Ensure the generated 'gen-rb' directory is in the load path and Thrift is required.

```ruby
$:.push File.expand_path('gen-rb', __dir__)
require 'thrift'
require 'calculator'

socket     = Thrift::Socket.new('localhost', 9090)
transport  = Thrift::BufferedTransport.new(socket)
protocol   = Thrift::BinaryProtocol.new(transport)
client     = Calculator::Client.new(protocol)

transport.open
puts client.add(1, 1)
transport.close
```

--------------------------------

### Download and Install Autoconf 2.69

Source: https://github.com/apache/thrift/blob/master/doc/install/centos.md

Upgrades autoconf to version 2.69, a crucial build utility.

```bash
wget http://ftp.gnu.org/gnu/autoconf/autoconf-2.69.tar.gz
tar xvf autoconf-2.69.tar.gz
cd autoconf-2.69
./configure --prefix=/usr
make
sudo make install
cd ..
```

--------------------------------

### Basic Ruby Thrift Server

Source: https://github.com/apache/thrift/blob/master/lib/rb/README.md

Example of setting up a basic Thrift server in Ruby. This includes defining a handler class and configuring the server transport, factories, and processor.

```ruby
$:.push File.expand_path('gen-rb', __dir__)
require 'thrift'
require 'calculator'

class CalculatorHandler
  def add(a, b)
    a + b
  end
end

handler            = CalculatorHandler.new
processor          = Calculator::Processor.new(handler)
server_transport   = Thrift::ServerSocket.new(9090)
transport_factory  = Thrift::BufferedTransportFactory.new
protocol_factory   = Thrift::BinaryProtocolFactory.new

server = Thrift::ThreadedServer.new(processor, server_transport,
                                    transport_factory, protocol_factory)
server.serve
```

--------------------------------

### Download and Install Automake 1.14

Source: https://github.com/apache/thrift/blob/master/doc/install/centos.md

Upgrades automake to version 1.14, another essential build utility.

```bash
wget http://ftp.gnu.org/gnu/automake/automake-1.14.tar.gz
tar xvf automake-1.14.tar.gz
cd automake-1.14
./configure --prefix=/usr
make
sudo make install
cd ..
```

--------------------------------

### Install Build Tools on MacOS

Source: https://github.com/apache/thrift/blob/master/compiler/cpp/README.md

Installs necessary build tools (flex, bison, cmake) on macOS using Homebrew. This is a prerequisite for building the Thrift compiler on macOS.

```bash
brew install flex
brew install bison
brew install cmake
```

--------------------------------

### Build Thrift Libraries and C++ SDK

Source: https://github.com/apache/thrift/blob/master/build/docker/msvc/README.md

Execute this command within the Docker container to build, test, and install the C++ SDK for Thrift into the C:\Install directory.

```powershell
docker run -v C:\thrift:C:\thrift^ 
           -v C:\install:C:\install^ 
           -m 4096 --rm -t thrift/thrift-build:msvc2017^ 
           C:\thrift\build\docker\msvc2017\build.bat
```

--------------------------------

### Set JavaScript Documentation Installation Directory

Source: https://github.com/apache/thrift/blob/master/lib/js/CMakeLists.txt

Configures the installation directory for JavaScript documentation. It checks if the provided DOC_INSTALL_DIR is absolute and constructs the JAVASCRIPT_DOC_INSTALL_DIR accordingly.

```cmake
if(IS_ABSOLUTE "${DOC_INSTALL_DIR}")
    set(JAVASCRIPT_DOC_INSTALL_DIR "${DOC_INSTALL_DIR}/js")
else()
    set(JAVASCRIPT_DOC_INSTALL_DIR "${CMAKE_INSTALL_PREFIX}/${DOC_INSTALL_DIR}/js")
endif()
```

--------------------------------

### Install Thrift Headers

Source: https://github.com/apache/thrift/blob/master/lib/cpp/CMakeLists.txt

Installs Thrift header files from the 'src/thrift' directory to the specified include destination, matching files with .h or .tcc extensions.

```cmake
install(DIRECTORY "src/thrift" DESTINATION "${INCLUDE_INSTALL_DIR}"
    FILES_MATCHING PATTERN "*.h" PATTERN "*.tcc")
```

--------------------------------

### Start Erlang Thrift Server

Source: https://github.com/apache/thrift/blob/master/tutorial/erl/README.md

Initiates the Thrift server process in Erlang. This is the first step to running a Thrift service.

```erlang
server:start().
```

--------------------------------

### 64-bit Integer Constant Example

Source: https://github.com/apache/thrift/blob/master/lib/js/README.md

Demonstrates the generation of 64-bit integer constants using the 'node-int64' library in newer versions.

```javascript
var x = new Int64("7fffffffffffffff");
```

--------------------------------

### Build Apache Thrift PHP Service

Source: https://github.com/apache/thrift/blob/master/lib/php/README.apache.md

Example of setting up a Thrift server within Apache/PHP. Requires THttpClient transport for requests. Ensure the Thrift root path is correctly set.

```php
<?php

namespace MyNamespace;

/**
 * Include path
 */
$THRIFT_ROOT = '/your/thrift/root/lib';

/**
 * Init Autloader
 */
require_once $THRIFT_ROOT . '/Thrift/ClassLoader/ThriftClassLoader.php';

$loader = new ThriftClassLoader();
$loader->registerNamespace('Thrift', $THRIFT_ROOT);
$loader->registerDefinition('Thrift', $THRIFT_ROOT . '/packages');
$loader->register();

use Thrift\Transport\TPhpStream;
use Thrift\Protocol\TBinaryProtocol;

/**
 * Example of how to build a Thrift server in Apache/PHP
 */

class ServiceHandler implements ServiceIf {
  // Implement your interface and methods here
}

header('Content-Type: application/x-thrift');

$handler = new ServiceHandler();
$processor = new ServiceProcessor($handler);

// Use the TPhpStream transport to read/write directly from HTTP
$transport = new TPhpStream(TPhpStream::MODE_R | TPhpStream::MODE_W);
$protocol = new TBinaryProtocol($transport);

$transport->open();
$processor->process($protocol, $protocol);
$transport->close();

```

--------------------------------

### Manually Install Boost 1.60.0 on Debian 7/Ubuntu 12

Source: https://github.com/apache/thrift/blob/master/doc/install/debian.md

For older Debian/Ubuntu versions, manually install Boost 1.60.0 if needed. This is a prerequisite for C++ library and test support.

```bash
wget http://sourceforge.net/projects/boost/files/boost/1.60.0/boost_1_60_0.tar.gz
tar xvf boost_1_60_0.tar.gz
cd boost_1_60_0
./bootstrap.sh
sudo ./b2 install
```

--------------------------------

### Manually Install Automake 1.15 on Debian 7/Ubuntu 12

Source: https://github.com/apache/thrift/blob/master/doc/install/debian.md

For older Debian/Ubuntu versions, manually install a more recent version of automake if needed. This is a prerequisite for C++ library and test support.

```bash
wget http://ftp.debian.org/debian/pool/main/a/automake-1.15/automake_1.15-3_all.deb
sudo dpkg -i automake_1.15-3_all.deb
```

--------------------------------

### Build Thrift Compiler on Unix-like System

Source: https://github.com/apache/thrift/blob/master/compiler/cpp/README.md

Standard build process for Unix-like systems using CMake and make. Ensure CMake, flex, and bison are installed.

```bash
mkdir cmake-build && cd cmake-build
cmake ..
make
```

--------------------------------

### Erlang Thrift Client Example Session

Source: https://github.com/apache/thrift/blob/master/lib/erl/README.md

Demonstrates a typical session using the thrift_client to connect to a Thrift server, make various calls, and handle responses and exceptions.

```erlang
1> {ok, C0} = thrift_client_util:new("localhost", 9090, thrift_test_thrift, []), ok.
ok
2> {C1, R1} = thrift_client:call(C0, testVoid, []), R1.
{ok,ok}
3> {C2, R2} = thrift_client:call(C1, testVoid, [asdf]), R2.
{error,{bad_args,testVoid,[asdf]}}
4> {C3, R3} = thrift_client:call(C2, testI32, [123]), R3.
{ok,123}
5> {C4, R4} = thrift_client:call(C3, testOneway, [1]), R4.
{ok,ok}
6> {C5, R5} = thrift_client:call(C4, testXception, ["foo"]), R5.
{error,{no_function,testXception}}
7> {C6, R6} = thrift_client:call(C5, testException, ["foo"]), R6.
{ok,ok}
8> {C7, R7} = (catch thrift_client:call(C6, testException, ["Xception"])), R7.
{exception,{xception,1001,<<"Xception">>}}
```

--------------------------------

### Build TutorialServer Executable

Source: https://github.com/apache/thrift/blob/master/tutorial/cpp/CMakeLists.txt

Defines the TutorialServer executable, linking it with the generated C++ library and the core Thrift library. Optionally links zlib if found.

```cmake
add_executable(TutorialServer CppServer.cpp)
target_link_libraries(TutorialServer tutorialgencpp)
target_link_libraries(TutorialServer thrift)
if (ZLIB_FOUND)
  target_link_libraries(TutorialServer ${ZLIB_LIBRARIES})
endif ()
```

--------------------------------

### Build TutorialClient Executable

Source: https://github.com/apache/thrift/blob/master/tutorial/cpp/CMakeLists.txt

Defines the TutorialClient executable, linking it with the generated C++ library and the core Thrift library. Optionally links zlib if found.

```cmake
add_executable(TutorialClient CppClient.cpp)
target_link_libraries(TutorialClient tutorialgencpp)
target_link_libraries(TutorialClient thrift)
if (ZLIB_FOUND)
  target_link_libraries(TutorialClient ${ZLIB_LIBRARIES})
endif ()
```

--------------------------------

### Configure Thrift with Boost Path

Source: https://github.com/apache/thrift/blob/master/README.md

Specify the location of Boost files if installed in a non-default path, such as /usr/local.

```bash
./configure --with-boost=/usr/local
```

--------------------------------

### Create Gradle Wrapper

Source: https://github.com/apache/thrift/blob/master/lib/java/README.md

Generates the Gradle wrapper scripts for the project, allowing builds to be executed without a system-wide Gradle installation.

```bash
gradle wrapper --gradle-version $GRADLE_VERSION
```

--------------------------------

### Copy Config Header

Source: https://github.com/apache/thrift/blob/master/lib/cpp/CMakeLists.txt

Copies the config.h file from the build directory to the include installation directory.

```cmake
install(DIRECTORY "${CMAKE_BINARY_DIR}/thrift" DESTINATION "${INCLUDE_INSTALL_DIR}"
    FILES_MATCHING PATTERN "*.h")
```

--------------------------------

### Run a Thrift Server in Common Lisp

Source: https://github.com/apache/thrift/blob/master/lib/cl/README.md

Starts a Thrift server instance for the 'calculator' service. It specifies the network address and port for the server to listen on.

```common-lisp
(in-package :tutorial)
(serve #u"thrift://127.0.0.1:9091" calculator)
```

--------------------------------

### Thrift Client Implementation in Rust

Source: https://github.com/apache/thrift/blob/master/tutorial/rs/README.md

Example of a Rust client that connects to a Thrift server, makes various calls (ping, calculate, zip), and handles potential errors. Requires generated Rust modules from Thrift IDL.

```rust
// generated Rust module from Thrift IDL
mod tutorial;

use thrift::protocol::{TCompactInputProtocol, TCompactOutputProtocol};
use thrift::protocol::{TInputProtocol, TOutputProtocol};
use thrift::transport::{TFramedReadTransport, TFramedWriteTransport};
use thrift::transport::{TIoChannel, TTcpChannel};

use tutorial::{CalculatorSyncClient, TCalculatorSyncClient};
use tutorial::{Operation, Work};

fn main() {
    match run() {
        Ok(()) => println!("client ran successfully"),
        Err(e) => {
            println!("client failed with {:?}", e);
            std::process::exit(1);
        }
    }
}

fn run() -> thrift::Result<()> {
    //
    // build client
    //

    println!("connect to server on 127.0.0.1:9090");
    let mut c = TTcpChannel::new();
    c.open("127.0.0.1:9090")?;

    let (i_chan, o_chan) = c.split()?;
    
    let i_prot = TCompactInputProtocol::new(
        TFramedReadTransport::new(i_chan)
    );
    let o_prot = TCompactOutputProtocol::new(
        TFramedWriteTransport::new(o_chan)
    );

    let mut client = CalculatorSyncClient::new(i_prot, o_prot);

    //
    // alright! - let's make some calls
    //

    // two-way, void return
    client.ping()?;

    // two-way with some return
    let res = client.calculate(
        72,
        Work::new(7, 8, Operation::Multiply, None)
    )?;
    println!("multiplied 7 and 8, got {}", res);

    // two-way and returns a Thrift-defined exception
    let res = client.calculate(
        77,
        Work::new(2, 0, Operation::Divide, None)
    );
    match res {
        Ok(v) => panic!("shouldn't have succeeded with result {}", v),
        Err(e) => println!("divide by zero failed with {:?}", e),
    }

    // one-way
    client.zip()?;

    // done!
    Ok(())
}

```

--------------------------------

### Use a Thrift Client to Access Service Remotely

Source: https://github.com/apache/thrift/blob/master/lib/cl/README.md

Demonstrates how to use a Thrift client in Common Lisp to connect to a remote service and invoke its operations. Includes examples for ping, add, calculate, and get_struct.

```common-lisp
(in-package :cl-user)

(macrolet ((show (form)
                 `(format *trace-output* "~%~s =>~{ ~s~}"
                          ',form
                          (multiple-value-list (ignore-errors ,form)))))
      (with-client (protocol #u"thrift://127.0.0.1:9091")
        (show (tutorial.calculator:ping protocol))
        (show (tutorial.calculator:add protocol 1 2))
        (show (tutorial.calculator:add protocol 1 4))

        (let ((task (make-instance 'tutorial:work
                      :op operation.subtract :num1 15 :num2 10)))
          (show (tutorial.calculator:calculate protocol 1 task))
        
          (setf (tutorial:work-op task) operation.divide
                (tutorial:work-num1 task) 1
                (tutorial:work-num2 task) 0)
          (show (tutorial.calculator:calculate protocol 1 task))
        
        (show (shared.shared-service:get-struct protocol 1))
    
        (show (zip protocol))))
```

--------------------------------

### Run Fuzzer with Specific Arguments

Source: https://github.com/apache/thrift/blob/master/lib/netstd/README.md

An example of running the 'binary' fuzzer with the 'libfuzzer' engine and passing the '-runs=10000' argument to the fuzzer engine.

```bash
./runfuzzer.sh binary libfuzzer -runs=10000
```

--------------------------------

### Example Audit Run Output

Source: https://github.com/apache/thrift/blob/master/test/audit/README.md

This output shows a typical execution of the audit tool, highlighting a failure due to a missing function and a warning about a changed constant value.

```bash
> thrift.exe --audit test.thrift break1.thrift
[Thrift Audit Failure:break1.thrift] New Thrift File has missing function base_function3
[Thrift Audit Warning:break1.thrift] Constant const3 has different value
```

--------------------------------

### Configure and Build Thrift Compiler (Windows)

Source: https://github.com/apache/thrift/blob/master/doc/ReleaseManagement.md

Use cmake to generate an out-of-tree build environment for the Thrift compiler on Windows. Ensure BISON_EXECUTABLE and FLEX_EXECUTABLE are correctly pointed to your installed winflexbison tools. Options like WITH_MT and WITH_SHARED_LIB control build characteristics.

```cmd
C:\build> cmake ..\thrift -DBISON_EXECUTABLE=c:\ProgramData\chocolatey\lib\winflexbison\tools\win_bison.exe -DFLEX_EXECUTABLE=c:\ProgramData\chocolatey\lib\winflexbison\tools\win_flex.exe -DWITH_MT=ON -DWITH_SHARED_LIB=OFF -DWITH_CPP=OFF -DWITH_JAVA=OFF -DWITH_HASKELL=OFF -DWITH_PYTHON=OFF -DWITH_C_GLIB=OFF -DBUILD_TESTING=OFF -DBUILD_TUTORIALS=OFF -DBUILD_COMPILER=ON
C:\build> cmake --build . --config Release
```

--------------------------------

### Add Java to PATH on Windows

Source: https://github.com/apache/thrift/blob/master/doc/install/windows.md

Ensures that Java is accessible from the command line by adding its bin directory to the PATH environment variable. Adjust the path to match your Java installation.

```bash
export PATH=$PATH:"/cygdrive/c/program files/java/jre1.8.0_191/bin"
```

--------------------------------

### Python Thrift Client Example

Source: https://github.com/apache/thrift/blob/master/tutorial/netstd/README.md

This Python script acts as a Thrift client, connecting to a server to perform operations like Ping, Add, Calculate, GetStruct, and Zip. Ensure the 'gen-py' folder with generated Thrift code is in the system path.

```python
import sys
import glob
sys.path.append('gen-py')

from tutorial import Calculator
from tutorial.ttypes import InvalidOperation, Operation, Work

from thrift import Thrift
from thrift.transport import TSocket
from thrift.transport import TTransport
from thrift.protocol import TBinaryProtocol


def main():
    # Make socket
    transport = TSocket.TSocket('127.0.0.1', 9090)

    # Buffering is critical. Raw sockets are very slow
    transport = TTransport.TBufferedTransport(transport)

    # Wrap in a protocol
    protocol = TBinaryProtocol.TBinaryProtocol(transport)

    # Create a client to use the protocol encoder
    client = Calculator.Client(protocol)

    # Connect!
    transport.open()

    client.Ping()
    print('ping()')

    sum = client.Add(1, 1)
    print(('1+1=%d' % (sum)))

    work = Work()

    work.Op = Operation.Divide
    work.Num1 = 1
    work.Num2 = 0

    try:
        quotient = client.Calculate(1, work)
        print('Whoa? You know how to divide by zero?')
        print('FYI the answer is %d' % quotient)
    except InvalidOperation as e:
        print(('InvalidOperation: %r' % e))

    work.Op = Operation.Substract
    work.Num1 = 15
    work.Num2 = 10

    diff = client.Calculate(1, work)
    print(('15-10=%d' % (diff)))

    log = client.GetStruct(1)
    print(('Check log: %s' % (log.Value)))

    client.Zip()
    print('zip()')

    # Close!
    transport.close()

if __name__ == '__main__':
  try:
    main()
  except Thrift.TException as tx:
    print('%s' % tx.message)
```

--------------------------------

### Include Directories Setup

Source: https://github.com/apache/thrift/blob/master/compiler/cpp/tests/CMakeLists.txt

Configures include directories for the Thrift compiler build. This ensures that include files are found in the current binary directory, top-level binary directory, source directory, and a specific catch directory.

```cmake
include_directories(${CMAKE_CURRENT_BINARY_DIR} ${CMAKE_BINARY_DIR} ${THRIFT_COMPILER_SOURCE_DIR}/src ${CMAKE_CURRENT_SOURCE_DIR}/catch)
```

--------------------------------

### Set JavaScript Installation Directory

Source: https://github.com/apache/thrift/blob/master/lib/js/CMakeLists.txt

Configures the installation directory for JavaScript files. It checks if the provided LIB_INSTALL_DIR is absolute and constructs the JAVASCRIPT_INSTALL_DIR accordingly.

```cmake
if(NOT JAVASCRIPT_INSTALL_DIR)
    if(IS_ABSOLUTE "${LIB_INSTALL_DIR}")
        set(JAVASCRIPT_INSTALL_DIR "${LIB_INSTALL_DIR}/js")
    else()
        set(JAVASCRIPT_INSTALL_DIR "${CMAKE_INSTALL_PREFIX}/${LIB_INSTALL_DIR}/js")
    endif()
endif()
```

--------------------------------

### Build Thrift Compiler with Xcode IDE on MacOS

Source: https://github.com/apache/thrift/blob/master/compiler/cpp/README.md

Build process for macOS using CMake with Xcode IDE integration. Requires Homebrew to install flex, bison, and cmake.

```bash
mkdir cmake-build && cd cmake-build
cmake -G "Xcode" ..
cmake --build .
```

--------------------------------

### Python Thrift Server Example

Source: https://github.com/apache/thrift/blob/master/tutorial/netstd/README.md

This Python script implements a Thrift server using a CalculatorHandler to process client requests. It listens on 'testserver' port 9090 and supports operations like Ping, Add, Calculate, GetStruct, and Zip. Ensure Thrift libraries and generated code are accessible.

```python
import glob
import sys
sys.path.append('gen-py')

from tutorial import Calculator
from tutorial.ttypes import InvalidOperation, Operation

from shared.ttypes import SharedStruct

from thrift.transport import TSocket
from thrift.transport import TTransport
from thrift.protocol import TBinaryProtocol
from thrift.server import TServer


class CalculatorHandler:
    def __init__(self):
        self.log = {}

    def Ping(self):
        print('ping()')

    def Add(self, n1, n2):
        print('add(%d,%d)' % (n1, n2))
        return n1 + n2

    def Calculate(self, logid, work):
        print('calculate(%d, %r)' % (logid, work))

        if work.Op == Operation.Add:
            val = work.Num1 + work.Num2
        elif work.Op == Operation.Substract:
            val = work.Num1 - work.Num2
        elif work.Op == Operation.Multiply:
            val = work.Num1 * work.Num2
        elif work.Op == Operation.Divide:
            if work.Num2 == 0:
                raise InvalidOperation(work.Op, 'Cannot divide by 0')
            val = work.Num1 / work.Num2
        else:
            raise InvalidOperation(work.Op, 'Invalid operation')

        log = SharedStruct()
        log.Key = logid
        log.Value = '%d' % (val)
        self.log[logid] = log

        return val

    def GetStruct(self, key):
        print('getStruct(%d)' % (key))
        return self.log[key]

    def Zip(self):
        print('zip()')

if __name__ == '__main__':
    handler = CalculatorHandler()
    processor = Calculator.Processor(handler)
    transport = TSocket.TServerSocket(host="testserver", port=9090)
    tfactory = TTransport.TBufferedTransportFactory()
    pfactory = TBinaryProtocol.TBinaryProtocolFactory()

    server = TServer.TSimpleServer(processor, transport, tfactory, pfactory)
    print('Starting the server...')
    server.serve()
    print('done.')

    # You could do one of these for a multithreaded server
    # server = TServer.TThreadedServer(processor, transport, tfactory, pfactory)
    # server = TServer.TThreadPoolServer(processor, transport, tfactory, pfactory)
```

--------------------------------

### Basic CMake Configuration

Source: https://github.com/apache/thrift/blob/master/build/cmake/README.md

Use this command to generate a build framework for Thrift using CMake. Ensure you are in an out-of-tree build directory.

```bash
mkdir /tmp/build
cd /tmp/build
cmake /location/to/thrift
```

--------------------------------

### Run All Client Library Tests

Source: https://github.com/apache/thrift/blob/master/README.md

Execute all unit tests for the client libraries from the top-level directory. The -k flag ensures that the process continues even if some tests fail.

```bash
make -k check
```

--------------------------------

### Run All Platform Matrix Tests for Thrift Docker Image

Source: https://github.com/apache/thrift/blob/master/docker/README.md

Execute tests across the supported platform matrix for the Thrift Docker image. This may utilize Buildx and require QEMU/binfmt support.

```bash
cd docker
./test.sh --all-platforms
```

--------------------------------

### Build Thrift Test Client Executable

Source: https://github.com/apache/thrift/blob/master/lib/c_glib/test/CMakeLists.txt

Configures include directories for C++ generated files and builds the test client executable, linking it with necessary libraries.

```cmake
include_directories("${CMAKE_CURRENT_BINARY_DIR}/gen-cpp" "${CMAKE_CURRENT_BINARY_DIR}/gen-c_glib")

add_executable(testthrifttestclient testthrifttestclient.cpp)
target_link_libraries(testthrifttestclient testgenc testgenc_cpp ${ZLIB_LIBRARIES})
add_test(NAME testthrifttestclient COMMAND testthrifttestclient)
```

--------------------------------

### Checkout and Prepare Release Artifacts

Source: https://github.com/apache/thrift/blob/master/doc/ReleaseManagement.md

Commands to checkout the release repository, copy artifacts, and commit changes for an official release.

```bash
~$ mkdir -p dist/release
~$ cd dist/release
~/dist/release$ svn co "https://dist.apache.org/repos/dist/release/thrift" thrift
~/dist/release$ cd thrift
~/dist/release/thrift$ mkdir 1.0.0
~/dist/release/thrift$ cp -p ../../dev/thrift/1.0.0-rc0/* 1.0.0/
~/dist/release/thrift$ svn status
# verify everything is correct
~/dist/release/thrift$ svn commit -m "Apache Thrift 1.0.0 official release" \
    --username <apache-username> --password <apache-password>

```

--------------------------------

### Install MSYS2 Toolchain for C++

Source: https://github.com/apache/thrift/blob/master/build/cmake/README-MSYS2.md

Installs essential development tools for C++ on MSYS2, including Bison, Flex, Make, OpenSSL, Boost, CMake, and the MinGW-w64 toolchain.

```bash
$ pacman --needed -S bison flex make mingw-w64-x86_64-openssl \
                mingw-w64-x86_64-boost mingw-w64-x86_64-cmake \
                mingw-w64-x86_64-toolchain mingw-w64-x86_64-zlib
```

--------------------------------

### Build Docker Image (Windows/Mac)

Source: https://github.com/apache/thrift/blob/master/build/docker/README.md

Builds the Docker image for Apache Thrift on Windows or Mac. This command is simpler as it does not pass user-specific build arguments.

```bash
thrift$ docker build -t thrift build/docker/ubuntu-jammy
```

--------------------------------

### Example of Thrift Test Failure Return Code

Source: https://github.com/apache/thrift/blob/master/test/README.md

This example illustrates how individual test failure bits are combined to form the final return code, indicating which test categories have failed.

```text
Therefore, the test client returns the code `10 = 2 | 8`, indicating the failure
of both test 2 (TEST_STRUCTS) and test 8 (TEST_EXCEPTIONS).
```

--------------------------------

### Browser Client RPC Call (Get Message)

Source: https://github.com/apache/thrift/blob/master/lib/nodejs/examples/hello.html

This snippet shows how to make an RPC call from a browser client to a Node.js server to get a message. It uses Thrift.TXHRTransport and Thrift.TJSONProtocol for communication.

```javascript
document.getElementById("btn").addEventListener("click", getMessage, false);
function getMessage() {
  var transport = new Thrift.TXHRTransport("http://localhost:8585/hello");
  var protocol = new Thrift.TJSONProtocol(transport);
  var client = new HelloSvcClient(protocol);
  var msg = client.hello_func();
  document.getElementById("output").innerHTML = msg;
}
```

--------------------------------

### Uninstall Thrift

Source: https://github.com/apache/thrift/blob/master/README.md

Remove the installed Thrift components from the system.

```bash
make uninstall
```

--------------------------------

### Update CentOS System

Source: https://github.com/apache/thrift/blob/master/doc/install/centos.md

Ensures the system is up-to-date before proceeding with installations.

```bash
sudo yum -y update
```

--------------------------------

### Upgrade Boost Libraries to 1.56.0

Source: https://github.com/apache/thrift/blob/master/doc/install/centos.md

Installs Boost version 1.56.0, a prerequisite for the C++ Thrift library.

```bash
wget http://sourceforge.net/projects/boost/files/boost/1.56.0/boost_1_56_0.tar.gz
tar xvf boost_1_56_0.tar.gz
cd boost_1_56_0
./bootstrap.sh
sudo ./b2 install
```

--------------------------------

### Copy pkg.m4 for Configure Fix

Source: https://github.com/apache/thrift/blob/master/doc/install/windows.md

Resolve syntax errors during ./configure by copying the pkg.m4 file from your system's acalocal directory to the thrift/aclocal directory.

```bash
cp /usr/share/aclocal/pkg.m4 aclocal
```

--------------------------------

### Manually Publish Maven Artifacts with Gradle

Source: https://github.com/apache/thrift/blob/master/lib/java/README.md

Execute the Gradle 'publish' task with the '-Prelease=true' property to build and publish artifacts. Ensure credentials and signing information are configured.

```bash
gradle -Prelease=true publish
```

--------------------------------

### Compile Java Library with Make

Source: https://github.com/apache/thrift/blob/master/tutorial/java/README.md

Compile the Thrift Java library using the 'make' command.

```bash
thrift/lib/java$ make
```

--------------------------------

### Check Thrift Compiler Version with Docker

Source: https://github.com/apache/thrift/blob/master/docker/README.md

Verify the installed Thrift compiler version within the Docker container.

```bash
docker run --rm thrift --version
```

--------------------------------

### Download and Install Bison 2.5.1

Source: https://github.com/apache/thrift/blob/master/doc/install/centos.md

Upgrades bison to version 2.5.1, a parser generator used in the build process.

```bash
wget http://ftp.gnu.org/gnu/bison/bison-2.5.1.tar.gz
tar xvf bison-2.5.1.tar.gz
cd bison-2.5.1
./configure --prefix=/usr
make
sudo make install
cd ..
```

--------------------------------

### Thrift Struct Definitions

Source: https://github.com/apache/thrift/blob/master/lib/java/src/main/java/org/apache/thrift/partial/README.md

Example Thrift struct definitions used to illustrate field path syntax for partial deserialization.

```thrift
struct SmallStruct {
   1: optional string stringValue;
   2: optional i16 i16Value;
}

struct TestStruct {
   1: optional i16 i16Field;
   2: optional list<SmallStruct> structList;
   3: optional set<SmallStruct> structSet;
   4: optional map<string, SmallStruct> structMap;
   5: optional SmallStruct structField;
}
```

--------------------------------

### C++ TWinsockSingleton Initialization

Source: https://github.com/apache/thrift/blob/master/doc/thrift-threat-model.md

This C++ code demonstrates the initialization of TWinsockSingleton on Windows, which calls WSAStartup via std::call_once when any socket is used. It also shows WSACleanup on destruction.

```cpp
lib/cpp/src/thrift/windows/TWinsockSingleton.cpp:37

Calls WSAStartup(MAKEWORD(2,2), ...) via std::call_once when any socket is used on Windows, and WSACleanup() on destruction. This is a genuine second process-wide library init
 — same category as the OpenSSL one, but Windows-only and gated behind call_once.
```

--------------------------------

### CMake Configuration with Options

Source: https://github.com/apache/thrift/blob/master/build/cmake/README.md

Enable or disable specific Thrift features during CMake configuration. For example, disable the Haskell compiler.

```bash
cmake -DTHRIFT_COMPILER_HS=OFF ..
```

--------------------------------

### Get Current Date for Changelog

Source: https://github.com/apache/thrift/blob/master/debian/README.md

Obtain the current date in RFC 822 format, often used for changelog entries.

```bash
date -R
```

--------------------------------

### Run Thrift Node.js Client

Source: https://github.com/apache/thrift/blob/master/lib/nodejs/examples/README.md

Execute the Node.js Thrift client to connect to a running Thrift server. The NODE_PATH should be configured similarly to the server.

```bash
NODE_PATH=../lib:../lib/thrift node client.js
```

--------------------------------

### Run Cross Test Client with Gradle

Source: https://github.com/apache/thrift/blob/master/lib/kotlin/README.md

Use this Gradle command to run the cross-test client. This is essential for verifying the functionality of the generated Kotlin code against the server.

```bash
gradle :cross-test-client:run
```

--------------------------------

### Update Debian Changelog with dch

Source: https://github.com/apache/thrift/blob/master/debian/README.md

Install the 'devscripts' package to use the 'dch -i' command for interactively managing changelog entries.

```bash
dch -i
```

--------------------------------

### Build Test Server Executable

Source: https://github.com/apache/thrift/blob/master/test/c_glib/CMakeLists.txt

Creates an executable for the test server, linking against the crosstest C GLib library and zlib.

```cmake
add_executable(test_server src/test_server.c src/thrift_test_handler.c src/thrift_second_service_handler.c)
target_link_libraries(test_server crosstestgencglib ${ZLIB_LIBRARIES})
```

--------------------------------

### Connect to SSL Server

Source: https://github.com/apache/thrift/blob/master/test/keys/README.md

Establishes an SSL connection to a server running on localhost:9090 using 'openssl s_client'.

```bash
openssl s_client -connect localhost:9090
```

--------------------------------

### Create and Use Calculator Client in SmallTalk

Source: https://github.com/apache/thrift/blob/master/lib/st/README.md

Instantiates a CalculatorClient and makes a call to the add method. Ensure the Thrift compiler has been run on the .thrift files and the generated code is filed in.

```SmallTalk
calc := CalculatorClient binaryOnHost: 'localhost' port: '9090'
calc addNum1: 10 num2: 15
```

--------------------------------

### Build Thrift

Source: https://github.com/apache/thrift/blob/master/README.md

Compile the Thrift library from the top-level directory.

```bash
make
```
Tokens:
Raw