===============================
credmark-client
===============================
Credmark Client is a client library and cli for the Credmark API.
For information visit `https://credmark.com <https://credmark.com>`_
Install
-------
.. code-block:: bash
$ pip install credmark-client
Configuration
-------------
An API key can be set in the environment variable ``CREDMARK_API_KEY``.
For example:
.. code-block:: bash
export CREDMARK_API_KEY=cmk-api-key-v1.YXVkOmZwaS5JcmVkbWFyay5jb20Kc2NvcGU6YWNjZXNzCm5mdDoxCmV4cDoxNjM2OTQ1ODI5MTY2.0xFCAd0B19bB29D4674531d6f115237E16AfCE377c.0x42971132bd11b2d8c4ca47e831e4e8f46d2b4eca1e1b6a6e5356293e3f8a7de759d8fb3ab4d2f51455942f796ac79bf7240d54bf2df3c4453e4d9432aaee519abc
CLI Usage
---------
This package includes a command-line tool ``credmark``.
.. code-block:: bash
credmark --help
.. code-block::
usage: credmark [-h] [--log_level LOG_LEVEL] [--api_url API_URL]
{version,models,deployed-models,describe,describe-models,man,run,run-model} ...
Credmark developer tool
optional arguments:
-h, --help show this help message and exit
--log_level LOG_LEVEL
Log level: DEBUG, INFO, WARNING, ERROR, CRITICAL
--api_url API_URL Credmark API url. Defaults to the standard API gateway. You do not normally
need to set this.
Commands:
Supported commands
{version,models,deployed-models,describe,describe-models,man,run,run-model}
additional help
version Show version of the package
models (deployed-models)
List models deployed on server
describe (describe-models, man)
Show documentation for models
run (run-model) Run a model
Run a Model
~~~~~~~~~~~
.. code-block:: bash
credmark run example.echo
.. code-block::
{"slug": "example.echo", "version": "1.0", "output": {"message": "Hello"}, "dependencies": {"example.echo": {"1.0": 1}}, "runtime": 3418}
SDK Usage
---------
Create a client and call methods for API calls.
To run a model:
.. code-block:: python
try:
client = CredmarkClient()
result = client.run_model('example.echo')
if 'output' in result:
print(result['output'])
else:
# Model error
print('Error', result['error'])
except Exception as err:
# requests/urllib exception
print('Exception', str(err))
You can automatically raise model errors as exceptions:
.. code-block:: python
try:
client = CredmarkClient()
result = client.run_model('example.echo', raise_error_results=True)
print(result['output'])
except ModelBaseError as err:
# model error
print('Model Error:', str(err), err.data)
except Exception as err:
# requests/urllib exception
print('Exception', str(err))
History
-------
0.0.1 [2022-04-25]
* First public release