Skip to main content

Cube.js Client for Python

Project description


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.




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 operation

    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 operation

    request_body # required - json request to send to cube.js


To get visibility into logged events, override the log method and log however your app needs to log:

class MyClientClass(CubeJsClient):
    def log(self, level, msg, **log_variables):
        print(f"[{level}] {msg}", log_variables)

client = MyClientClass(server, api_token)


from cube_js_client import CubeJsClient, CubeError, CubeTimeoutError

my_client = CubeJsClient("", "theApiToken", add_headers={'user_id': 1})
    results = my_client.load({"measures": ["Cube.count"],"dimensions": ["Cube.dimension"]})
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

$ black cube_js_client --config cube_js_client.toml


Cube.js Client is MIT licensed.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for CubeJsClient, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size CubeJsClient-0.1.1.tar.gz (3.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page