Package Search Help

You can use boolean logic (e.g. AND/OR/NOT) for complex search queries. For more help and examples, see the search documentation.

Search by package name:
my-package _(implicit)
name:my-package _(explicit)

Search by package filename:
my-package.ext _(implicit)
filename:my-package.ext _(explicit)

Search by package tag:
latest _(implicit)
tag:latest _(explicit)

Search by package version:
1.0.0 _(implicit)
version:1.0.0 _(explicit)
prerelease:true _{(prereleases)}
prerelease:false _{(no prereleases)}

Search by package architecture:
architecture:x86_64

Search by package distribution:
distribution:el

Search by package license:
license:MIT

Search by package format:
format:deb

Search by package status:
status:in_progress

Search by package file checksum:
checksum:5afba

Search by package security status:
severity:critical

Search by package vulnerabilities:
vulnerabilities:>1
vulnerabilities:<1000

Search by # of package downloads:
downloads:>8
downloads:<100

Search by package type:
type:binary
type:source

Search by package size (bytes):
size:>50000
size:<10000

Search by dependency name/version:
dependency:log4j
dependency:log4j=1.0.0
dependency:log4j>1.0.0

Search by uploaded date:
uploaded:>"1 day ago"
uploaded:<"August 14, 2022 EST"

Search by entitlement token (identifier):
entitlement:3lKPVJPosCsY

Search by policy violation:
policy_violated:true
deny_policy_violated:true
license_policy_violated:true
vulnerability_policy_violated:true

Search by repository:
repository:repo-name

Search queries for all Debian-specific (and related) package types

Search by component:
deb_component:unstable

Search queries for all Maven-specific (and related) package types

Search by group ID:
maven_group_id:org.apache

Search queries for all Docker-specific (and related) package types

Search by image digest:
docker_image_digest:sha256:7c5..6d4
(full hashref only)

Search by layer digest:
docker_layer_digest:sha256:4c4..ae4
(full hashref only)

Field type modifiers (depending on the type, you can influence behaviour)

For all queries, you can use:
~foo for negation

For string queries, you can use:
^foo to anchor to start of term
foo$ to anchor to end of term
foo*bar for fuzzy matching

For number/date or version queries, you can use:
>foo for values greater than
>=foo for values greater / equal
<foo for values less than
<=foo for values less / equal

Need a secure and centralised artifact repository to deliver Alpine, Cargo, CocoaPods, Composer, Conan, Conda, CRAN, Dart, Debian, Docker, Go, Helm, Hex, LuaRocks, Maven, npm, NuGet, P2, Python, RedHat, Ruby, Swift, Terraform, Vagrant, Raw & More packages?

Cloudsmith is the new standard in Package / Artifact Management and Software Distribution.

With support for all major package formats, you can trust us to manage your software supply chain.

Start My Free Trial

Set Me Up

Open-Source — cloudsmith (Cloudsmith) / cli — GitHub Project

Official repository for the Cloudsmith CLI application.
These tend to be pre-releases, for stable releases download from PyPi: https://pypi.python.org/pypi/cloudsmith-cli

Note: Packages in this repository are licensed as Apache License 2.0 (dependencies may be licensed differently).

cloudsmith-cli 0.3.1

Download

One-liner (summary)

Cloudsmith Command-Line Interface (CLI)

Description

Cloudsmith Command Line Interface (CLI)

The Cloudsmith Command Line Interface (CLI) is a Py2/Py3 text-based interface to the API. This allows users, machines and other services to access and integrate smoothly with Cloudsmith without requiring explicit plugins or tools. Be awesome. Automate Everything.

The following (slightly out of date) GIF demonstrates a small slice of the CLI - View the full video on YouTube:

|CLI Demonstration|

You can also read our blog article that introduced the first version of the CLI and the Cloudsmith RESTful API.

Changelog

Please see the changelog for the list of changes by version. The currently version is displayed in the PyPi badge at the top.

Features

The CLI currently supports the following commands (and sub-commands):

check: Check the status/version of the service.
delete: Delete a package from a repository.
docs: Launch the help website in your browser.
help: Display the help message and exit.
list: List distributions, packages and repos.
distros: List available distributions.
packages: List packages for a repository.
repos: List repositories for a namespace (owner).
push: Push/upload a new package to a repository.
deb: Push/upload a new Deb package upstream.
maven: Push/upload a new Maven package upstream.
python: Push/upload a new Python package upstream.
raw: Push/upload a new Raw package upstream.
rpm: Push/upload a new Rpm package upstream.
ruby: Push/upload a new Ruby package upstream.
vagrant: Push/upload a new Vagrant package upstream.
status: Get the synchronisation status for a package.
token: Retrieve your API authentication token/key.
whoami: Retrieve your current authentication status.

Installation

You can install the latest CLI application from:

The simplest way is to use pip, such as:

pip install --upgrade cloudsmith-cli

Or you can get the latest pre-release version from Cloudsmith:

pip install --upgrade cloudsmith-cli --extra-index-url=https://dl.cloudsmith.io/public/cloudsmith/cli/python/index/

Configuration

There are two configuration files used by the CLI:

config.ini: For non-credentials configuration.
credentials.ini: For credentials (authentication) configuration.

By default, the CLI will look for these in the following locations:

The current working directory.
A directory called cloudsmith in the OS-defined application directory. For example:
Linux: $HOME/.config/cloudsmith
- Windows: C:\Users\YourName\AppData\cloudsmith

Both configuration files use the simple INI format, such as:

[default]
api_key=1234567890abcdef1234567890abcdef

Non-Credentials (config.ini)

See the default config in GitHub:

You can specify the following configuration options:

api_host: The API host to connect to.
api_proxy: The API proxy to connect through.
api_user_agent: The user agent to use for requests.

Credentials (credentials.ini)

See the default config in GitHub:

You can specify the following configuration options:

api_key:

License

Apache License 2.0

Size

41.6 KB

Downloads

293

Tags

bdist/wheel whl noarch py2/py3

Status	Completed
Checksum (MD5)	5be81071f4c7982e61a0d82b35e0df79
Checksum (SHA-1)	357f8f2441e1c20e51370d55beb796ef4fc2f507
Checksum (SHA-256)	9dd17139a2b7c3183c30c8ee2d9d55afe187fd89a4156ae078f7ed9cb47acf83
Checksum (SHA-512)	e6bbdd7fb438bf6f136bf73ac5f0a1ebc34f43e4c58bbffe56162be7e8776060a1…
GPG Signature	Download
Storage Region	Dublin, Ireland
Type	Binary (contains binaries and binary artifacts)
Uploaded At	6 years, 10 months ago
Uploaded By
Slug Id	cloudsmith_cli-031-py2py3-none-anywhl
Unique Id	DiG7pwWIcWx1
Version (Raw)	0.3.1
Version (Parsed)	Major: 0 Minor: 3 Patch: 1 Type: SemVer (Strict)
	extended metadata
Author	Cloudsmith Ltd <support@cloudsmith.io>
Classifiers	Development Status :: 3 - Alpha \| Environment :: Console \| Intended Audience :: Developers \| Intended Audience :: System Administrators \| License :: OSI Approved :: Apache Software License \| Operating System :: POSIX :: Linux \| Programming Language :: Python \| Programming Language :: Python :: 2 \| Programming Language :: Python :: 3 \| Topic :: Internet \| Topic :: System :: Systems Administration \| Topic :: Utilities
Homepage URL	https://github.com/cloudsmith-io/cloudsmith-cli
Keywords	cloudsmith,cli,devops
Metadata Version	2.0
Platforms	any
Py Filetype	bdist_wheel
Py Version	py2.py3

pkg

cloudsmith_cli-0.3.1-py2.py3-no…

293
_41.6 KB

md5

sha1

sha256

sha512

Package Contents (cloudsmith_cli-0.3.1-py2.py3-none-any.whl)

This package has 54 files/directories.

Newer	cloudsmith-cli 1.2.2	bdist/wheel whl noarch py2/py3 104.8 KB — 6 months, 4 weeks ago	23
Newer	cloudsmith-cli 1.2.0	bdist/wheel whl noarch py2/py3 104.8 KB — 7 months, 2 weeks ago	29
Newer	cloudsmith-cli 1.1.1	bdist/wheel whl noarch py2/py3 104.8 KB — 1 year, 1 month ago	304
Newer	cloudsmith-cli 1.1.0	bdist/wheel whl noarch py2/py3 104.8 KB — 1 year, 1 month ago	25
Newer	cloudsmith-cli 1.0.0	bdist/wheel whl noarch py2/py3 100.6 KB — 1 year, 2 months ago	34
Newer	cloudsmith-cli 0.44.0	bdist/wheel whl noarch py2/py3 105.2 KB — 1 year, 2 months ago	25
Newer	cloudsmith-cli 0.43.0	bdist/wheel whl noarch py2/py3 99.8 KB — 1 year, 4 months ago	40
Newer	cloudsmith-cli 0.42.0	bdist/wheel whl noarch py2/py3 99.8 KB — 1 year, 5 months ago	28
Newer	cloudsmith-cli 0.41.1	bdist/wheel whl noarch py2/py3 99.8 KB — 1 year, 5 months ago	24
Newer	cloudsmith-cli 0.41.0	bdist/wheel whl noarch py2/py3 99.8 KB — 1 year, 5 months ago	35
Newer	cloudsmith-cli 0.40.1	bdist/wheel whl noarch py2/py3 98.8 KB — 1 year, 5 months ago	27
Newer	cloudsmith-cli 0.40.0	bdist/wheel whl noarch py2/py3 98.8 KB — 1 year, 5 months ago	25
Newer	cloudsmith-cli 0.39.0	bdist/wheel whl noarch py2/py3 94.4 KB — 1 year, 5 months ago	24
Newer	cloudsmith-cli 0.38.1	bdist/wheel whl noarch py2/py3 88.1 KB — 1 year, 5 months ago	26
Newer	cloudsmith-cli 0.38.0	bdist/wheel whl noarch py2/py3 87.9 KB — 1 year, 5 months ago	26
	cloudsmith-cli 0.3.1	bdist/wheel whl noarch py2/py3 41.6 KB — 6 years, 10 months ago	293
Newer	cloudsmith-cli 1.3.1	bdist/wheel whl noarch py2/py3 latest 112.2 KB — 3 weeks, 5 days ago	35
Older	cloudsmith-cli 0.3.0	bdist/wheel whl noarch py2/py3 42.1 KB — 6 years, 10 months ago	283
Older	cloudsmith-cli 0.2.2	bdist/wheel whl noarch py2/py3 39.0 KB — 6 years, 10 months ago	292
Older	cloudsmith-cli 0.1.0	bdist/wheel whl noarch py2/py3 27.3 KB — 6 years, 11 months ago	288

Only packages within the same repository are displayed. The current package you're viewing is highlighted.

Last scanned

4 days, 16 hours ago

Scan result

Clean

Vulnerability count

Max. severity

Unknown

You can embed a badge in another website that shows this or the latest version of this package.

To embed the badge for this specific package version, use the following:

[![This version of 'cloudsmith-cli' @ Cloudsmith](https://api-prd.cloudsmith.io/v1/badges/version/cloudsmith/cli/python/cloudsmith-cli/0.3.1/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/?render=true)](https://cloudsmith.io/~cloudsmith/repos/cli/packages/detail/python/cloudsmith-cli/0.3.1/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/)

|This version of 'cloudsmith-cli' @ Cloudsmith|
.. |This version of 'cloudsmith-cli' @ Cloudsmith| image:: https://api-prd.cloudsmith.io/v1/badges/version/cloudsmith/cli/python/cloudsmith-cli/0.3.1/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/?render=true
   :target: https://cloudsmith.io/~cloudsmith/repos/cli/packages/detail/python/cloudsmith-cli/0.3.1/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/

image::https://api-prd.cloudsmith.io/v1/badges/version/cloudsmith/cli/python/cloudsmith-cli/0.3.1/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/?render=true[link="https://cloudsmith.io/~cloudsmith/repos/cli/packages/detail/python/cloudsmith-cli/0.3.1/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/",title="This version of 'cloudsmith-cli' @ Cloudsmith"]

<a href="https://cloudsmith.io/~cloudsmith/repos/cli/packages/detail/python/cloudsmith-cli/0.3.1/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/"><img src="https://api-prd.cloudsmith.io/v1/badges/version/cloudsmith/cli/python/cloudsmith-cli/0.3.1/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/?render=true" alt="This version of 'cloudsmith-cli' @ Cloudsmith" /></a>

rendered as:

To embed the badge for the latest package version, use the following:

[![Latest version of 'cloudsmith-cli' @ Cloudsmith](https://api-prd.cloudsmith.io/v1/badges/version/cloudsmith/cli/python/cloudsmith-cli/latest/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/?render=true&show_latest=true)](https://cloudsmith.io/~cloudsmith/repos/cli/packages/detail/python/cloudsmith-cli/latest/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/)

|Latest version of 'cloudsmith-cli' @ Cloudsmith|
.. |Latest version of 'cloudsmith-cli' @ Cloudsmith| image:: https://api-prd.cloudsmith.io/v1/badges/version/cloudsmith/cli/python/cloudsmith-cli/latest/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/?render=true&show_latest=true
   :target: https://cloudsmith.io/~cloudsmith/repos/cli/packages/detail/python/cloudsmith-cli/latest/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/

image::https://api-prd.cloudsmith.io/v1/badges/version/cloudsmith/cli/python/cloudsmith-cli/latest/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/?render=true&show_latest=true[link="https://cloudsmith.io/~cloudsmith/repos/cli/packages/detail/python/cloudsmith-cli/latest/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/",title="Latest version of 'cloudsmith-cli' @ Cloudsmith"]

<a href="https://cloudsmith.io/~cloudsmith/repos/cli/packages/detail/python/cloudsmith-cli/latest/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/"><img src="https://api-prd.cloudsmith.io/v1/badges/version/cloudsmith/cli/python/cloudsmith-cli/latest/a=noarch;xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/?render=true&show_latest=true" alt="Latest version of 'cloudsmith-cli' @ Cloudsmith" /></a>

rendered as:

These instructions assume you have setup the repository first (or read it).

To install/use cloudsmith-cli @ version 0.3.1 ...

pip install 'cloudsmith-cli==0.3.1'

You can also install the latest version of this package:

pip install --upgrade 'cloudsmith-cli'

If necessary, you can specify the repository directly:

pip install \
  --index-url=https://dl.cloudsmith.io/public/cloudsmith/cli/python/simple/ \
  cloudsmith-cli==0.3.1

If you've got a project requirements.txt file, you can specify this as a dependency:

--index-url=https://dl.cloudsmith.io/public/cloudsmith/cli/python/simple/
cloudsmith-cli==0.3.1

In addition, you can use this repository as an extra index url. However, please read our documentation on this parameter before using it. For example in a requirements.txt file:

--extra-index-url=https://dl.cloudsmith.io/public/cloudsmith/cli/python/simple/
cloudsmith-cli==0.3.1

Warning: We highly recommend using pip (or similar) rather than installing directly.

Still stuck? Need help? Don't panic. Just contact us for help (even if you're not a customer).

Previous Version: 1.3.1

Next Version: 0.38.0