Skip to content

kolena.initialize

initialize(*args, api_token=None, verbose=False, proxies=None, **kwargs) #

Initialize a client session.

A session has a global scope and remains active until interpreter shutdown.

Retrieve an API token from the Developer page and make it available through one of the following options before initializing:

  1. Directly through the api_token keyword argument
    import kolena
    
    kolena.initialize(api_token=your_token, verbose=True)
    
  2. Populate the KOLENA_TOKEN environment variable
    export KOLENA_TOKEN="********"
    
  3. Store in .netrc file
    ~/.netrc
    machine api.kolena.io password ********
    
flowchart TD
    Start[Get API token]
    Step1{{api_token argument provided?}}
    Step2{{KOLENA_TOKEN environment variable set?}}
    Step3{{Token in .netrc file?}}
    End[Use as API token]
    Exception[MissingTokenError]
    Start --> Step1
    Step1 -->|No| Step2
    Step2 -->|No| Step3
    Step3 -->|No| Exception
    Step1 -->|Yes| End
    Step2 -->|Yes| End
    Step3 -->|Yes| End

Note

As of version 0.29.0: the entity argument is no longer needed; the signature initialize(entity, api_token) has been deprecated and replaced by initialize(api_token).

Parameters:

Name Type Description Default
api_token Optional[str]

Optionally provide an API token, otherwise attempts to find a token in $KOLENA_TOKEN or .netrc file. This token is a secret and should be treated with caution.

None
verbose bool

Optionally configure client to run in verbose mode, providing more information about execution. All logging events are emitted as Python standard library logging events from the "kolena" logger as well as to stdout/stderr directly.

False
proxies Optional[Dict[str, str]]

Optionally configure client to run with http or https proxies. The proxies parameter is passed through to the requests package and can be configured accordingly.

None

Raises:

Type Description
InvalidTokenError

The provided api_token is not valid.

InputValidationError

The provided combination or number of args is not valid.

MissingTokenError

An API token could not be found.