LogQS Client
Project description
LogQS Client
A Python library for interacting with a LogQS DataStore API. More information and examples can be found at https://docs.logqs.com.
Installation
Requires Python >= 3.6
Instally from PyPI, using pip:
$ pip install logqs-client
Quickstart
Create a client instance:
from lqs_client import LogQS
lqs = LogQS(
api_url="<LQS API URL>",
api_key_id="<LQS API KEY ID>",
api_key_secret="<LQS API KEY SECRET>"
)
Interact with the LogQS API:
response = lqs.list.log()
data = response["data"]
print(data)
Alternatively, you can use the LogQS Client from the command line. If you have the configuration set as environment variables or in a .env file:
$ python -m lqs_client list log
Configuration
Required Parameters
The LogQS Client requires three parameters to be configured:
LQS_API_URL
The URL of the endpoint for the LogQS API. This should be the base URL for all REST operations, i.e., if the DataStore's API includes a /api
subpath, this should be included.
This parameter can be supplied/overridden with the api_url
parameter.
LQS_API_KEY_ID
The ID of the API Key for which the client will operate as.
This parameter can be supplied/overridden with the api_key_id
parameter.
LQS_API_KEY_SECRET
The secret of the API Key for which the client will operate as.
This parameter can be supplied/overridden with the api_key_secret
parameter.
Optional Parameters
Optional parameters include:
LQS_PRETTY
A boolean parameter indicating whether or not to "prettify" the output results. Useful when using the client in the command line. Default is false
.
This parameter can be supplied/overrident with the pretty
parameter.
LQS_VERBOSE
A boolean parameter indicating whether to log debug information. Default is false
.
This parameter can be supplied/overrident with the verbose
parameter.
Development
The LogQS Client module source is located in lqs-client
and it's Python requirements are listed in the requirements.txt
file. You can install it locally with pip install .
.
The project uses Python 3.9, which may require some dependencies to be required. In one go,
sudo apt install python3.9 python3.9-dev python3.9-distutils python3.9-venv
To run the application from this directory (i.e., for development):
-
Create a virtual environment:
python3.9 -m venv venv
-
Source the environment:
source venv/bin/activate
-
Install the requirements:
pip install -r requirements.txt
-
Install LogQS Client in develop mode:
pip install -e .
-
Run the module:
python -m lqs-client
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for lqs_client-0.0.17-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 79694aba0998ed50331109653b2ee7252fb269db8b5aba608e06618bf1c2a9de |
|
MD5 | b8750d2705ae38dc6ade798a5c3fb071 |
|
BLAKE2b-256 | f632276bc62160b4cca67d3083ec37d8d52eba764ca9a4e81db64dea7e040547 |