Skip to main content

Sifflet CLI

Project description

Sifflet CLI

This package provides a command line interface (CLI) to Sifflet application.

Getting Started

Installation

Sifflet CLI is compatible with Python version 3.7 or greater

pip install sifflet

sifflet --version

Configuration

Before using the Sifflet CLI, you need to set your tenant and credentials. You can do it in several ways:

  • Sifflet command line sifflet configure (which will persists configuration in a file)
  • Or with environment variables

You will need in both cases the following information:

  • <access_token>: you can find more information on how to generate it here
  • For SaaS version: <tenant_name>: Name of your tenant. Sifflet UI URL is https://<tenant_name>.siffletdata.com. Sifflet Backend URL is https://<tenant_name>api.siffletdata.com. For instance, if you access to Sifflet UI with https://mycompany.siffletdata.com, then your tenant would be mycompany.
  • For self-hosted deployment: <backend_url>: Full URL to the Sifflet backend on your deployment including for instance: https://sifflet-backend.mycompany.com

Sifflet configure

You can input the tenant and credentials directly with the sifflet configure command.

For SaaS version:

> sifflet configure --tenant <tenant_name>
Your API access token [None]: <access_token>

or, for self-hosted deployment:

> sifflet configure --backend-url <backend_url>
Your API access token [None]: <access_token>

The use of sifflet configure will persist the configuration in a file located at ~/.sifflet/config.ini (or in %UserProfile%\.sifflet/config.ini on Windows).

Environment variables

To use environment variables, you can do the following:

For SaaS version:

> export SIFFLET_TENANT=<tenant_name>
> export SIFFLET_TOKEN=<access_token>

or, for self-hosted deployment:

> export SIFFLET_BACKEND_URL=<backend_url>
> export SIFFLET_TOKEN=<access_token>

You can check that setup is done correctly with sifflet status.

> sifflet status

Sifflet version = x.x.x
Tenant = my_tenant
Tenant is up and reachable
Token expiration date = 2024-01-01 00:00:00
Token is valid with scope API
Status = OK

If you encounter any error at this step, please check your tenant and token configurations.

Documentation

The documentation with the available commands can be found here.

Help

The --help option is available for any command, for instance sifflet --help or sifflet rules list --help.

Examples

Trigger a specific rule

  • First, find your rule id with sifflet rules list. You can filter with --name to narrow your search.
# Display rules
sifflet rules list
sifflet rules list --name <search_criteria>
  • Then you can trigger one of several rules with sifflet rules run
# Run one or many rules
sifflet rules run --id <rule_id>
sifflet rules run --id <rule_id_1> --id <rule_id_2> --id <rule_id_3>
  • Finally, retrieve the run status of a rule with sifflet rules run_history
# Display rule runs history for a given rule id
sifflet rules run_history --id <rule_id>

Send dbt artifacts

If you have already added the datasource to Sifflet, you can then send the dbt artifacts for syncing the data.

# send the dbt artifacts
sifflet ingest dbt --project-name <project_name> --target <target> --input-folder <dbt_artifacts_directory>

Contact

For any queries, you can reach us at contact@siffletdata.com

Project details


Download files

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

Source Distribution

sifflet-0.3.15.tar.gz (9.8 kB view details)

Uploaded Source

Built Distribution

sifflet-0.3.15-py3-none-any.whl (13.0 kB view details)

Uploaded Python 3

File details

Details for the file sifflet-0.3.15.tar.gz.

File metadata

  • Download URL: sifflet-0.3.15.tar.gz
  • Upload date:
  • Size: 9.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for sifflet-0.3.15.tar.gz
Algorithm Hash digest
SHA256 50c43ce251c77a4dc6e5bf261bc5b3e8b6bc907c84e533a1291dbfda9ca2ba16
MD5 aea4d4b823a92f6631595629b33187b5
BLAKE2b-256 45c1f7ac7e1c7e26d3ce83809acff996237bf9b4538a71274acb1e70488123c9

See more details on using hashes here.

File details

Details for the file sifflet-0.3.15-py3-none-any.whl.

File metadata

  • Download URL: sifflet-0.3.15-py3-none-any.whl
  • Upload date:
  • Size: 13.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for sifflet-0.3.15-py3-none-any.whl
Algorithm Hash digest
SHA256 2c86deae6b6149d89b082954f22d9a07fa1f9e2ff195fd295b99cafd1171f905
MD5 e898643527b860e81b8d136b86bee1b4
BLAKE2b-256 9a824be26f76b4e9dddcd9423bd4d4b56ee06c4975ff659fc498f371eaeae38c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page