thirdparty/soci/README.md

0001 # SOCI - The C++ Database Access Library
0002
0003 [![GitHub release](https://img.shields.io/github/tag/SOCI/soci.svg)](https://github.com/SOCI/soci/releases/tag/v4.0.3)
0004 [![GitHub commits](https://img.shields.io/github/commits-since/SOCI/soci/v4.0.3.svg)](https://github.com/SOCI/soci/tree/release/4.0)
0005
0006 [![Website](https://img.shields.io/website-up-down-green-red/http/shields.io.svg?label=soci.sourceforge.net)](http://soci.sourceforge.net)
0007 [![SourceForge](https://img.shields.io/sourceforge/dm/soci.svg)](https://sourceforge.net/projects/soci/files/)
0008
0009 [![Gitter](https://img.shields.io/gitter/room/SOCI/soci.svg)](https://gitter.im/SOCI/soci)
0010 [![Mailing Lists](https://img.shields.io/badge/mailing--lists-ok-yellowgreen.svg)](https://sourceforge.net/p/soci/mailman/)
0011 [![StackExchange](https://img.shields.io/stackexchange/stackoverflow/t/soci.svg)](https://stackoverflow.com/questions/tagged/soci)
0012
0013 ## Build Status
0014
0015 | Branches    | GitHub Actions | AppVeyor-CI | Documentation | Coverity Scan  |
0016 |-------------|----------------|-------------|---------------|----------------|
0017 | master      | [![Build Status](https://github.com/SOCI/soci/actions/workflows/ci.yml/badge.svg)](https://github.com/SOCI/soci/actions) | [![Build status](https://ci.appveyor.com/api/projects/status/dtp5mvbeyu9aqupr/branch/master?svg=true)](https://ci.appveyor.com/project/SOCI/soci/branch/master) | [![Docs Status](https://circleci.com/gh/SOCI/soci/tree/master.svg?style=svg&circle-token=5d31c692ed5fcffa5c5fc6b7fe2257b34d78f3c9)](https://circleci.com/gh/SOCI/soci/tree/master) | [![Coverage](https://scan.coverity.com/projects/6581/badge.svg)](https://scan.coverity.com/projects/soci-soci) |
0018 | release/4.0 | [![Build Status](https://github.com/SOCI/soci/actions/workflows/ci.yml/badge.svg?branch=release/4.0)](https://github.com/SOCI/soci/actions) | [![Build status](https://ci.appveyor.com/api/projects/status/dtp5mvbeyu9aqupr/branch/release/4.0?svg=true)](https://ci.appveyor.com/project/SOCI/soci/branch/release/4.0) | [![Docs Status](https://circleci.com/gh/SOCI/soci/tree/release%2F4.0.svg?style=svg&circle-token=5d31c692ed5fcffa5c5fc6b7fe2257b34d78f3c9)](https://circleci.com/gh/SOCI/soci/tree/release%2F4.0) | |
0019
0020 ## History
0021
0022 Originally, SOCI was developed by [Maciej Sobczak](http://www.msobczak.com/)
0023 at [CERN](http://www.cern.ch/) as abstraction layer for Oracle,
0024 a **Simple Oracle Call Interface**.
0025 Later, several database backends have been developed for SOCI,
0026 thus the long name has lost its practicality.
0027 Currently, if you like, SOCI may stand for **Simple Open (Database) Call Interface**
0028 or something similar.
0029
0030 > "CERN is also a user of the SOCI library, which serves as a database access
0031 > layer in some of the control system components."
0032
0033 -- Maciej Sobczak at [Inspirel](http://www.inspirel.com/users.html)
0034
0035 ## License
0036
0037 SOCI library is distributed under the terms of the [Boost Software License](http://www.boost.org/LICENSE_1_0.txt).
0038
0039 ## Requirements
0040
0041 Core:
0042
0043 * Compile with C++14 support (please use 4.0 series for C++98 support) or MSVS 2015 or later.
0044 * Optionally: Boost C++ Libraries (header-only and Boost.DateTime).
0045
0046 Backend specific client libraries for:
0047
0048 * DB2
0049 * Firebird
0050 * MySQL
0051 * ODBC with specific database driver
0052 * Oracle
0053 * PostgreSQL
0054 * SQLite 3
0055
0056 See documentation at [soci.sourceforge.net](http://soci.sourceforge.net) for details
0057
0058 [BSL](http://www.boost.org/LICENSE_1_0.txt) &copy;
0059 [Maciej Sobczak](http://github.com/msobczak) and [contributors](https://github.com/SOCI/soci/graphs/contributors).