# CubeJsClient
[Cube.js](https://github.com/cube-js/cube.js) client for python! It assists in token management and abstracts the HTTP requests with retries. You still need to run an instance of the Cube.js Server to run requests against. This client does not provide any graphing functionality.
## Docs
### CubeJsClient
#### init
```python
from cube_js_client import CubeJsClient,
client = CubeJsClient(
server, # required - the running cube.js server
secret, # required - the api token or secret needed for requests
base_path='cubejs-api', # optional - the basePath, needed of not using the default
load_request_timeout=60, # optional - timeout for a single request to cube.js server
load_waiting_max_requests=50, # optional - number of requests to make while waiting for a response
load_waiting_interval=1, # optional - time to wait between requests
token_ttl={'days': 1}, # optional - timedelta kwargs for how long the token is valid
add_headers=None, # optional - any additional headers to add to the request
)
```
#### load
[load operation](https://cube.dev/docs/@cubejs-client-core#cubejs-api-load)
```python
client.load(
request_body # required - json request to send to cube.js
)
```
_Note_: Might raise a `cube_js_client.CubeError` if the Cube rejects the request
_Note_: Might raise a `cube_js_client.CubeTimeoutError` if the load exhausts the `load_waiting_max_requests`
#### sql
[sql operation](https://cube.dev/docs/@cubejs-client-core#cubejs-api-sql)
```python
client.sql(
request_body # required - json request to send to cube.js
)
```
#### logging
To get visibility into logged events, override the log method and log however your app needs to log:
```python
class MyClientClass(CubeJsClient):
def log(self, level, msg, **log_variables):
print(f"[{level}] {msg}", log_variables)
client = MyClientClass(server, api_token)
```
## Example
```python
from cube_js_client import CubeJsClient, CubeError, CubeTimeoutError
my_client = CubeJsClient("http://my_cubejs_server.com/", "theApiToken", add_headers={'user_id': 1})
try:
results = my_client.load({"measures": ["Cube.count"],"dimensions": ["Cube.dimension"]})
print(results)
except CubeError:
print("Cube rejected")
except CubeTimeoutError:
print("Request to Cube timed out")
```
## Future Work
- Requests for `meta`
- Comprehensive Documentation
- Tests
- Auto-formatting
- Buffering response handling
## Common Commands:
Black Formatting
```bash
$ black cube_js_client --config cube_js_client.toml
```
##
## License
Cube.js Client is [MIT licensed](./LICENSE).
