Skip to main content

Cumin

Cumin contains a Python library and CLI scripts for accessing a remote salt-api instance.

cumin abstracts the HTTP calls to salt-api so existing Python projects can easily integrate with a remote Salt installation just by instantiating a class.

The cumin CLI script allows users to execute Salt commands from computers that are external to computers running the salt-master or salt-minion daemons as though they were running Salt locally. The long-term goal is to add additional CLI scripts maintain the same interface as Salt’s own CLI scripts (salt, salt-run, salt-key, etc).

Installation

pip install salt-cumin

Usage

export SALTAPI_USER=saltdev SALTAPI_PASS=saltdev SALTAPI_EAUTH=pam
cumin '*' test.ping
cumin '*' test.kwarg hello=dolly

Examples leveraging the runner client.

cumin-run reactor.list
cumin-run reactor.add event='test/provision/*' reactors='/srv/salt/state/reactor/test-provision.sls'

Configuration

You can configure cumin through the command line, using environment variables or in a configuration file $HOME/.pepperrc with the following syntax :

[main]
SALTAPI_URL=https://localhost:8000/
SALTAPI_USER=saltdev
SALTAPI_PASS=saltdev
SALTAPI_EAUTH=pam

Release files for salt-cumin 0.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for salt-cumin 0.7
File Size Uploaded
salt-cumin-0.7.tar.gz 14.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for salt-cumin 0.7
File Interpreter ABI Platform
salt_cumin-0.7-py3-none-any.whl Python 3 none any Details

Total release size: 30.2 kB

Release files / salt-cumin-0.7.tar.gz

Download URL salt-cumin-0.7.tar.gz
Size 14.7 kB
Tags Source
SHA-256 checksum
How to use checksums
60a9fd26f083e3cba97e35544f9683fd5b7f73544f3257f5fb862409f3cbd54b
BLAKE2b-256 checksum
How to use checksums
e8befed3e10ffee7059390256468c4040aa4c149dc8f3c4308ae4ac630c6c7f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.7.0 requests/2.25.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

Release files / salt_cumin-0.7-py3-none-any.whl

Download URL salt_cumin-0.7-py3-none-any.whl
Size 15.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
771ef8d379877cf5f1c60af94d5a565f52d2c5ae4b11489f232d4c6eac8e222f
BLAKE2b-256 checksum
How to use checksums
244913f58744952609886678785cfbc157c950450fb9074c9d6f22e25eaa933d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.7.0 requests/2.25.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

Release history Release notifications | RSS feed

This release

0.7 This release

2 release files

0.6.1

2 release files

0.6.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page