Hi, you have downloaded the C++ thin client for TGenBase.

So, how to proceed?

### Setup

The project requires ROOT. Configure the ROOT environment before, e.g.:

```
. /path/to/root/bin/thisroot.sh
```

Build the project with following commands

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

To install the project run `make install`.
Pass `-DCMAKE_INSTALL_PREFIX=/your/installation/path` to `cmake` command to change the installation path.

### Configuration

The TGenBase client for C++ needs to know where to fetch the data from.
The client uses the `ServerURI` entry in the `TGenBaseConfig.json` file to point to a correct TGenBase database server installation.

The authentication information will be stored in this file between C++ sessions under the `AccessToken` configuration key.

The data is stored there automatically upon every successful user login.

### Querying data

To query any data you need to configure the client and auth with TGenBase.

The simpliest script in ROOT command line can look like this:

```cpp
TGenBase::Client::Instance()->SetServerURI("https://127.0.0.1:8008")
auto user = TGenBase::User::Login("user@example.com", "very_secure/password")
if (user) {
  user->Print()
}
```

### Exception safety

Note, that code by default is explicitly exception safe. This means you should pay attention to the standard output.
In case of exception, return values for getters with single queries are `nullptr` and for array queries are empty vectors.

If you want to enable the exception handling compile the package with -DTGENBASE_WITH_EXCEPTIONS