Metadata-Version: 2.1
Name: pyocient
Version: 1.0.6
Summary: Ocient Database Python API
Home-page: https://www.ocient.com/
Author: Ocient Inc
Author-email: info@ocient.com
License: UNKNOWN
Keywords: database,sql,development
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Database
Classifier: Topic :: Database :: Front-Ends
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Requires-Python: >=3.5, <4
Description-Content-Type: text/markdown
Requires-Dist: dsnparse
Requires-Dist: prompt-toolkit
Requires-Dist: pygments
Requires-Dist: tabulate
Requires-Dist: cryptography (<3.4)
Requires-Dist: cffi (<=1.14.6)
Requires-Dist: google-auth (<2.0dev)
Requires-Dist: google-api-python-client

# Ocient Database Python API

This python database API conforms to the Python Database API
Specification 2.0 and can be used to access the Ocient database.

This module can also be called as a main function, in which case
it acts as a primitive CLI for the database.

When called as main, it a connection string in DSN (data source name)
format, followed by zero or more query strings that will be executed.
Output is returned in JSON format.

The Ocient DSN is of the format:
   `ocient://user:password@[host][:port][/database][?param1=value1&...]`

`user` and `password` must be supplied.  `host` defaults to localhost,
port defaults to 4050, database defaults to `system` and `tls` defaults
to `off`.

Currently supported parameters are:

- tls: Which can have the values "off", "unverified", or "on"
- force: Which can have the values "true"
- handshake: Which can have the value "cbc", "gcm", or "sso".

For the handshake protocols, "cbc" (Cipher Block Chaining) denotes a previous password encryption protocol which
should be avoided. "gcm" (Galois/Counter Mode), which pyocient will default to,  is recommended. If single sign
on is desired, then "sso" should be used.

