cloudsmith-cli 0.28.0__tar.gz → 1.8.2__tar.gz

cloudsmith_cli-1.8.2/MANIFEST.in

@@ -0,0 +1,2 @@
+include cloudsmith_cli/data/*
+include cloudsmith_cli/templates/*

cloudsmith_cli-1.8.2/PKG-INFO

@@ -0,0 +1,311 @@
+Metadata-Version: 2.4
+Name: cloudsmith-cli
+Version: 1.8.2
+Summary: Cloudsmith Command-Line Interface (CLI)
+Home-page: https://github.com/cloudsmith-io/cloudsmith-cli
+Author: Cloudsmith Ltd
+Author-email: support@cloudsmith.io
+License: Apache License 2.0
+Keywords: cloudsmith,cli,devops
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click!=8.0.2,>=7.0
+Requires-Dist: click-configfile>=0.2.3
+Requires-Dist: click-didyoumean>=0.0.3
+Requires-Dist: click-spinner>=0.1.7
+Requires-Dist: cloudsmith-api<3.0,>=2.0.18
+Requires-Dist: keyring>=25.4.1
+Requires-Dist: requests>=2.18.4
+Requires-Dist: requests_toolbelt>=0.8.0
+Requires-Dist: semver>=2.7.9
+Requires-Dist: urllib3<2.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: platform
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Cloudsmith Command Line Interface (CLI)
+
+[![Latest Version @ Cloudsmith](https://api-prd.cloudsmith.io/badges/version/cloudsmith/cli/python/cloudsmith-cli/latest/xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/?render=true)](https://cloudsmith.io/~cloudsmith/repos/cli/packages/detail/python/cloudsmith-cli/latest/xf=bdist_wheel;xn=cloudsmith-cli;xv=py2.py3/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/cloudsmith-cli.svg)](https://pypi.python.org/pypi/cloudsmith-cli)
+[![PyPI Version](https://img.shields.io/pypi/v/cloudsmith-cli.svg)](https://pypi.python.org/pypi/cloudsmith-cli)
+[![CircleCI](https://circleci.com/gh/cloudsmith-io/cloudsmith-cli.svg?style=svg)](https://circleci.com/gh/cloudsmith-io/cloudsmith-cli)
+[![Maintainability](https://api.codeclimate.com/v1/badges/c4ce2988b461d7b31cd5/maintainability)](https://codeclimate.com/github/cloudsmith-io/cloudsmith-cli/maintainability)
+[![Test Coverage](https://api.codeclimate.com/v1/badges/c4ce2988b461d7b31cd5/test_coverage)](https://codeclimate.com/github/cloudsmith-io/cloudsmith-cli/test_coverage)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
+
+
+The [Cloudsmith](https://cloudsmith.io) Command Line Interface (CLI) is a Python 3 text-based interface to the [API](https://api.cloudsmith.io). This allows users, machines and other services to access and integrate smoothly with Cloudsmith without requiring explicit plugins or tools. [Be awesome. Automate Everything](https://cloudsmith.com/company/the-tao-of-cloudsmith/).
+
+The following asciinema video demonstrates some of the CLI commands:
+[![asciicast](https://asciinema.org/a/DkNXQWQGBjWkfGPAkDAPNz7xe.svg)](https://asciinema.org/a/DkNXQWQGBjWkfGPAkDAPNz7xe)
+
+We also have a [demo video on YouTube](https://youtu.be/R-g8ZhDwTKk):
+
+You can also read our [blog article](https://blog.cloudsmith.io/2017/11/25/automation-as-simple-as-a-b-cli/) that introduced the first version of the CLI and the Cloudsmith RESTful API.
+
+
+## Changelog
+
+Please see the [changelog](https://github.com/cloudsmith-io/cloudsmith-cli/blob/master/CHANGELOG.md) for the list of changes by version. The current version is displayed in the PyPi badge at the top.
+
+
+## Features
+
+The CLI currently supports the following commands (and sub-commands):
+
+- `auth`:                 Authenticate the CLI against an organization's SAML configuration.
+- `check`:                Check rate limits and service status.
+- `copy`|`cp`:            Copy a package to another repository.
+- `delete`|`rm`:          Delete a package from a repository.
+- `dependencies`|`deps`:  List direct (non-transitive) dependencies for a package.
+- `docs`:                 Launch the help website in your browser.
+- `entitlements`|`ents`:  Manage the entitlements for a repository.
+  - `create`|`new`:         Create a new entitlement in a repository.
+  - `delete`|`rm`:          Delete an entitlement from a repository.
+  - `list`|`ls`:            List entitlements for a repository.
+  - `refresh`:              Refresh an entitlement in a repository.
+  - `sync`:                 Sync entitlements from another repository.
+  - `update`|`set`:         Update (patch) a entitlement in a repository.
+- `help`:                 Display the delightful help message and exit.
+- `list`|`ls`:            List distros, packages, repos and entitlements.
+  - `dependencies`|`deps`   List direct (non-transitive) dependencies for a package.
+  - `distros`:              List available distributions.
+  - `entitlements`|`ents`:  List entitlements for a repository.
+  - `packages`:             List packages for a repository. (Aliases `repos list`)
+  - `repos`:                List repositories for a namespace (owner).
+- `login`|`token`:        Retrieve your API authentication token/key via login.
+- `metrics`:              Metrics and statistics for a repository.
+  - `tokens`:               Retrieve bandwidth usage for entitlement tokens.
+  - `packages`:             Retrieve package usage for repository.
+- `move`|`mv`:            Move (promote) a package to another repo.
+- `push`|`upload`:        Push (upload) a new package to a repository.
+  - `alpine`:               Push (upload) a new Alpine package upstream.
+  - `cargo`:                Push (upload) a new Cargo package upstream.
+  - `composer`:             Push (upload) a new Composer package upstream.
+  - `cocoapods`:            Push (upload) a new CocoaPods package upstream.
+  - `conan`:                Push (upload) a new Conan (C++) package upstream.
+  - `cran`:                 Push (upload) a new R/CRAN package upstream.
+  - `deb`:                  Push (upload) a new Debian package upstream.
+  - `docker`:               Push (upload) a new Docker image upstream.
+  - `go`:                   Push (upload) a new Go module upstream.
+  - `helm`:                 Push (upload) a new Helm package upstream.
+  - `luarocks`:             Push (upload) a new Lua module upstream.
+  - `maven`:                Push (upload) a new Maven package upstream.
+  - `npm`:                  Push (upload) a new Npm package upstream.
+  - `nuget`:                Push (upload) a new NuGet package upstream.
+  - `python`:               Push (upload) a new Python package upstream.
+  - `raw`:                  Push (upload) a new Raw package upstream.
+  - `rpm`:                  Push (upload) a new RedHat package upstream.
+  - `ruby`:                 Push (upload) a new Ruby package upstream.
+  - `terraform`:            Push (upload) a new Terraform package upstream.
+  - `vagrant`:              Push (upload) a new Vagrant package upstream.
+- `quarantine`|`block`:   Manage quarantined packages in a repository.
+  - `add`:                  Add a package to quarantine.
+  - `remove`|`rm`|`restore`: Add a package to quarantine.
+- `quota`:                Quota limits and history for a organisation.
+  - `limits`:               Display the Quota (bandwidth & storage usage/limits) for a specific organisation.
+  - `history`:              Display the Quota History (upload, download, and storage usage/limits) for a specific organisation.
+- `repositories`|`repos`: Manage repositories.
+  - `create`|`new`:         Create a new repository in a namespace.
+  - `get`|`list`|`ls`:      List repositories for a user, in a namespace or get details for a specific repository.
+  - `update`:               Update a repository in a namespace.
+  - `delete`|`rm`:          Delete a repository from a namespace.
+- `resync`:               Resynchronise a package in a repository.
+- `status`:               Get the synchronisation status for a package.
+- `tags`:                 Manage the tags for a package in a repository.
+  - `add`:                  Add tags to a package in a repository.
+  - `clear`:                Clear all existing (non-immutable) tags from a package in a repository.
+  - `list`|`ls`:            List tags for a package in a repository.
+  - `remove`|`rm`:          Remove tags from a package in a repository.
+  - `replace`:              Replace all existing (non-immutable) tags on a package in a repository.
+- `whoami`:               Retrieve your current authentication status.
+- `tokens`:               Manage API tokens.
+  - `list`|`ls`:            List API tokens.
+  - `refresh`:              Refresh an API token.
+
+## Installation
+
+You can install the latest CLI application from:
+
+- [Official CLI Repository @ PyPi](https://pypi.python.org/pypi/cloudsmith-cli)
+- [Official CLI Repository @ Cloudsmith](https://cloudsmith.io/~cloudsmith/repos/cli/packages/)
+
+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`
+    - `$HOME/.cloudsmith`
+  - Mac OS:
+    - `$HOME/Library/Application Support/cloudsmith`
+    - `$HOME/.cloudsmith`
+  - Windows:
+    - `C:\Users\<user>\AppData\Local\cloudsmith` (Win7+, not roaming)
+    - `C:\Users\<user>\AppData\Roaming\cloudsmith` (Win7+, roaming)
+    - `C:\Documents and Settings\<user>\Application Data\cloudsmith` (WinXP, not roaming)
+    - `C:\Documents and Settings\<user>\Local Settings\Application Data\cloudsmith` (WinXP, roaming)
+    - `C:\Documents and Settings\<user>\.cloudsmith`
+
+Both configuration files use the simple INI format, such as:
+
+```
+[default]
+api_key=1234567890abcdef1234567890abcdef
+```
+
+Additionally, the CLI will store SSO access and refresh tokens in the system keyring
+using the [`keyring`](https://github.com/jaraco/keyring) library.
+
+
+### Non-Credentials (config.ini)
+
+See the [default config](https://raw.githubusercontent.com/cloudsmith-io/cloudsmith-cli/master/cloudsmith_cli/data/config.ini) 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_ssl_verify`: Whether or not to use SSL verification for requests.
+- `api_user_agent`: The user agent to use for requests.
+
+### Credentials (credentials.ini)
+
+See the [default config](https://raw.githubusercontent.com/cloudsmith-io/cloudsmith-cli/master/cloudsmith_cli/data/credentials.ini) in GitHub:
+
+You can specify the following configuration options:
+
+- `api_key`: The API key for authenticating with the API.
+
+
+### Authenticating
+
+You'll need to provide authentication to Cloudsmith for any CLI actions that result in accessing private data or making changes to resources (such as pushing a new package to a repository)..
+
+#### SAML authentication
+
+You can authenticate using your organization's SAML provider, if configured, with the `cloudsmith auth` command:
+```
+cloudsmith auth --owner example
+Beginning authentication for the example org ...
+Opening your organization's SAML IDP URL in your browser: https://example.com/some-saml-idp
+
+Starting webserver to begin authentication ...
+
+Authentication complete
+```
+
+#### Getting Your API Key
+
+You can retrieve your API key using the `cloudsmith login` command:
+
+```
+cloudsmith login
+Login: you@example.com
+Password:
+Repeat for confirmation:
+```
+
+*Note:* Please ensure you use your email for the 'Login' prompt and not your user slug/identifier.
+
+The resulting output looks something like:
+
+```
+Retrieving API token for 'you@example.com' ... OK
+Your API token is: 1234567890abcdef1234567890abcdef
+```
+
+Once you have your API key you can then put this into your `credentials.ini`, use it as an environment variable `export CLOUDSMITH_API_KEY=your_key_here` or pass it to the CLI using the `-k your_key_here` flag.
+
+For convenience the CLI will ask you if you want to install the default configuration files, complete with your API key, if they don't already exist. Say 'y' or 'yes' to create the configuration files.
+
+If the configuration files already exist, you'll have to manually put the API key into the configuration files, but the CLI will print out their locations.
+
+
+## Uploading Packages
+
+Although native uploads, i.e. those supported by the native ecosystem of a package format, are often preferred; it's easy to publish with the Cloudsmith CLI too!
+
+For example, if you wanted to upload a Debian package, you can do it in one-step. Assuming you have a package filename **libxml2-2.9.4-2.x86_64.deb**, representing **libxml 2.9.4**, for the **Ubuntu 16.04** distribution (which has a cloudsmith identifier of **ubuntu/xenial**):
+
+```
+cloudsmith push deb your-account/your-repo/ubuntu/xenial libxml2-2.9.4-2.x86_64.deb
+```
+
+Want to know how to do it with another packaging format? Easy, just ask for help:
+
+```
+cloudsmith push rpm --help
+```
+
+
+## Contributing
+
+Yes! Please do contribute, this is why we love open source.  Please see [CONTRIBUTING](https://github.com/cloudsmith-io/cloudsmith-cli/blob/master/CONTRIBUTING.md) for contribution guidelines when making code changes or raising issues for bug reports, ideas, discussions and/or questions (i.e. help required).
+
+
+## License
+
+Copyright 2018 Cloudsmith Ltd
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+
+## EOF
+
+This quality product was brought to you by [Cloudsmith](https://cloudsmith.io) and the [fine folks who have contributed](https://github.com/cloudsmith-io/cloudsmith-cli/blob/master/CONTRIBUTORS.md).

{cloudsmith-cli-0.28.0 → cloudsmith_cli-1.8.2}/README.md

@@ -9,7 +9,7 @@
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
 
 
-The [Cloudsmith](https://cloudsmith.io) Command Line Interface (CLI) is a Py2/Py3 text-based interface to the [API](https://api.cloudsmith.io). This allows users, machines and other services to access and integrate smoothly with Cloudsmith without requiring explicit plugins or tools. [Be awesome. Automate Everything](https://cloudsmith.com/company/the-tao-of-cloudsmith/).
+The [Cloudsmith](https://cloudsmith.io) Command Line Interface (CLI) is a Python 3 text-based interface to the [API](https://api.cloudsmith.io). This allows users, machines and other services to access and integrate smoothly with Cloudsmith without requiring explicit plugins or tools. [Be awesome. Automate Everything](https://cloudsmith.com/company/the-tao-of-cloudsmith/).
 
 The following asciinema video demonstrates some of the CLI commands:
 [![asciicast](https://asciinema.org/a/DkNXQWQGBjWkfGPAkDAPNz7xe.svg)](https://asciinema.org/a/DkNXQWQGBjWkfGPAkDAPNz7xe)
@@ -28,9 +28,11 @@ Please see the [changelog](https://github.com/cloudsmith-io/cloudsmith-cli/blob/
 
 The CLI currently supports the following commands (and sub-commands):
 
+- `auth`:                 Authenticate the CLI against an organization's SAML configuration.
 - `check`:                Check rate limits and service status.
 - `copy`|`cp`:            Copy a package to another repository.
 - `delete`|`rm`:          Delete a package from a repository.
+- `dependencies`|`deps`:  List direct (non-transitive) dependencies for a package.
 - `docs`:                 Launch the help website in your browser.
 - `entitlements`|`ents`:  Manage the entitlements for a repository.
   - `create`|`new`:         Create a new entitlement in a repository.
@@ -41,8 +43,9 @@ The CLI currently supports the following commands (and sub-commands):
   - `update`|`set`:         Update (patch) a entitlement in a repository.
 - `help`:                 Display the delightful help message and exit.
 - `list`|`ls`:            List distros, packages, repos and entitlements.
+  - `dependencies`|`deps`   List direct (non-transitive) dependencies for a package.
   - `distros`:              List available distributions.
-  - `entitlements`:         List entitlements for a repository.
+  - `entitlements`|`ents`:  List entitlements for a repository.
   - `packages`:             List packages for a repository. (Aliases `repos list`)
   - `repos`:                List repositories for a namespace (owner).
 - `login`|`token`:        Retrieve your API authentication token/key via login.
@@ -71,6 +74,9 @@ The CLI currently supports the following commands (and sub-commands):
   - `ruby`:                 Push (upload) a new Ruby package upstream.
   - `terraform`:            Push (upload) a new Terraform package upstream.
   - `vagrant`:              Push (upload) a new Vagrant package upstream.
+- `quarantine`|`block`:   Manage quarantined packages in a repository.
+  - `add`:                  Add a package to quarantine.
+  - `remove`|`rm`|`restore`: Add a package to quarantine.
 - `quota`:                Quota limits and history for a organisation.
   - `limits`:               Display the Quota (bandwidth & storage usage/limits) for a specific organisation.
   - `history`:              Display the Quota History (upload, download, and storage usage/limits) for a specific organisation.
@@ -88,7 +94,9 @@ The CLI currently supports the following commands (and sub-commands):
   - `remove`|`rm`:          Remove tags from a package in a repository.
   - `replace`:              Replace all existing (non-immutable) tags on a package in a repository.
 - `whoami`:               Retrieve your current authentication status.
-
+- `tokens`:               Manage API tokens.
+  - `list`|`ls`:            List API tokens.
+  - `refresh`:              Refresh an API token.
 
 ## Installation
 
@@ -131,6 +139,7 @@ By default, the CLI will look for these in the following locations:
     - `C:\Users\<user>\AppData\Roaming\cloudsmith` (Win7+, roaming)
     - `C:\Documents and Settings\<user>\Application Data\cloudsmith` (WinXP, not roaming)
     - `C:\Documents and Settings\<user>\Local Settings\Application Data\cloudsmith` (WinXP, roaming)
+    - `C:\Documents and Settings\<user>\.cloudsmith`
 
 Both configuration files use the simple INI format, such as:
 
@@ -139,6 +148,10 @@ Both configuration files use the simple INI format, such as:
 api_key=1234567890abcdef1234567890abcdef
 ```
 
+Additionally, the CLI will store SSO access and refresh tokens in the system keyring
+using the [`keyring`](https://github.com/jaraco/keyring) library.
+
+
 ### Non-Credentials (config.ini)
 
 See the [default config](https://raw.githubusercontent.com/cloudsmith-io/cloudsmith-cli/master/cloudsmith_cli/data/config.ini) in GitHub:
@@ -159,11 +172,26 @@ You can specify the following configuration options:
 - `api_key`: The API key for authenticating with the API.
 
 
-### Getting Your API Key
+### Authenticating
 
 You'll need to provide authentication to Cloudsmith for any CLI actions that result in accessing private data or making changes to resources (such as pushing a new package to a repository)..
 
-With the CLI this is simple to do. You can retrieve your API key using the `cloudsmith login` command:
+#### SAML authentication
+
+You can authenticate using your organization's SAML provider, if configured, with the `cloudsmith auth` command:
+```
+cloudsmith auth --owner example
+Beginning authentication for the example org ...
+Opening your organization's SAML IDP URL in your browser: https://example.com/some-saml-idp
+
+Starting webserver to begin authentication ...
+
+Authentication complete
+```
+
+#### Getting Your API Key
+
+You can retrieve your API key using the `cloudsmith login` command:
 
 ```
 cloudsmith login

{cloudsmith-cli-0.28.0 → cloudsmith_cli-1.8.2}/cloudsmith_cli/__init__.py

@@ -1,7 +1,10 @@
-# -*- coding: utf-8 -*-
 """Cloudsmith CLI."""
+
+import warnings
+
 import click
 import urllib3
 
 click.disable_unicode_literals_warning = True
 urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+warnings.filterwarnings("ignore", category=ResourceWarning)

{cloudsmith-cli-0.28.0 → cloudsmith_cli-1.8.2}/cloudsmith_cli/__main__.py

@@ -1,6 +1,4 @@
-# -*- coding: utf-8 -*-
 """Cloudsmith CLI - Main script."""
-from __future__ import absolute_import, print_function, unicode_literals
 
 from .cli.commands.main import main
 

{cloudsmith-cli-0.28.0 → cloudsmith_cli-1.8.2}/cloudsmith_cli/cli/__init__.py

@@ -1,2 +1 @@
-# -*- coding: utf-8 -*-
 """CLI-specific functionality."""

{cloudsmith-cli-0.28.0 → cloudsmith_cli-1.8.2}/cloudsmith_cli/cli/command.py

@@ -1,12 +1,8 @@
-# -*- coding: utf-8 -*-
 """CLI - Group/Command classes."""
-from __future__ import absolute_import, print_function, unicode_literals
 
-import sys
 from collections import OrderedDict
 
 import click.exceptions
-import six
 from click_didyoumean import DYMGroup
 
 
@@ -14,13 +10,13 @@ class AliasGroup(DYMGroup):
     """A command group with DYM and alias support."""
 
     def __init__(self, *args, **kwargs):
-        super(AliasGroup, self).__init__(*args, **kwargs)
+        super().__init__(*args, **kwargs)
         self.aliases = OrderedDict()
         self.inverse = {}
 
     def resolve_command(self, ctx, args):
         try:
-            return super(AliasGroup, self).resolve_command(ctx, args)
+            return super().resolve_command(ctx, args)
         except click.exceptions.UsageError:
             # Before DYM kicks in, check to see if the command prefix matches
             # exactly one command, then use that instead.
@@ -30,23 +26,23 @@ class AliasGroup(DYMGroup):
                 matched = [cmd for cmd in cmds if cmd.startswith(cmd_name)]
                 if len(matched) == 1 and len(cmd_name) > 1:
                     args[0] = matched[0]
-                    return super(AliasGroup, self).resolve_command(ctx, args)
+                    return super().resolve_command(ctx, args)
 
-            six.reraise(*sys.exc_info())
+            raise
 
     def list_commands(self, ctx):
-        commands = super(AliasGroup, self).list_commands(ctx)
+        commands = super().list_commands(ctx)
 
         if getattr(ctx, "showing_help", False):
             for k, v in enumerate(commands):
                 try:
-                    commands[k] = "%s|%s" % (v, "|".join(self.aliases[v]))
+                    commands[k] = f"{v}|{'|'.join(self.aliases[v])}"
                 except KeyError:
                     pass
 
             return commands
 
-        for k in six.iterkeys(self.inverse):
+        for k in self.inverse:
             commands.append(k)
 
         return commands
@@ -61,7 +57,7 @@ class AliasGroup(DYMGroup):
         except KeyError:
             pass
 
-        return super(AliasGroup, self).get_command(ctx, cmd_name)
+        return super().get_command(ctx, cmd_name)
 
     def command(self, *args, **kwargs):
         def decorator(f):
@@ -95,4 +91,4 @@ class AliasGroup(DYMGroup):
 
     def format_commands(self, ctx, formatter):
         ctx.showing_help = True
-        return super(AliasGroup, self).format_commands(ctx, formatter)
+        return super().format_commands(ctx, formatter)

cloudsmith_cli-1.8.2/cloudsmith_cli/cli/commands/__init__.py

@@ -0,0 +1,27 @@
+"""CLI/Commands - Import all commands."""
+
+from . import (
+    auth,
+    check,
+    copy,
+    delete,
+    dependencies,
+    docs,
+    entitlements,
+    help_,
+    list_,
+    login,
+    metrics,
+    move,
+    policy,
+    push,
+    quarantine,
+    quota,
+    repos,
+    resync,
+    status,
+    tags,
+    tokens,
+    upstream,
+    whoami,
+)

cloudsmith_cli-1.8.2/cloudsmith_cli/cli/commands/auth.py

@@ -0,0 +1,112 @@
+"""CLI/Commands - Authenticate the user."""
+
+import webbrowser
+
+import click
+
+from ...core.api import exceptions, user
+from ...core.config import create_config_files, new_config_messaging
+from .. import decorators, validators
+from ..exceptions import handle_api_exceptions
+from ..saml import create_configured_session, get_idp_url
+from ..utils import maybe_spinner
+from ..webserver import AuthenticationWebRequestHandler, AuthenticationWebServer
+from .main import main
+
+
+@main.command(aliases=["auth"])
+@click.option(
+    "-o",
+    "--owner",
+    metavar="OWNER",
+    required=True,
+    callback=validators.validate_owner,
+    prompt=True,
+    help="The name of the Cloudsmith organization to authenticate with.",
+)
+@click.option(
+    "-t",
+    "--token",
+    default=False,
+    is_flag=True,
+    help="Retrieve a user API token after successful authentication.",
+)
+@decorators.common_cli_config_options
+@decorators.common_cli_output_options
+@decorators.initialise_api
+@click.pass_context
+def authenticate(ctx, opts, owner, token):
+    """Authenticate to Cloudsmith using the org's SAML setup."""
+    owner = owner[0].strip("'[]'")
+    api_host = opts.api_config.host
+
+    click.echo(
+        "Beginning authentication for the {owner} org ... ".format(
+            owner=click.style(owner, bold=True)
+        )
+    )
+
+    session = create_configured_session(opts)
+
+    context_message = "Failed to authenticate via SSO!"
+    with handle_api_exceptions(ctx, opts=opts, context_msg=context_message):
+        idp_url = get_idp_url(api_host, owner, session=session)
+        click.echo(
+            "Opening your organization's SAML IDP URL in your browser: %(idp_url)s"
+            % {"idp_url": click.style(idp_url, bold=True)}
+        )
+        click.echo()
+        webbrowser.open(idp_url)
+        click.echo("Starting webserver to begin authentication ... ")
+
+        auth_server = AuthenticationWebServer(
+            ("127.0.0.1", 12400),
+            AuthenticationWebRequestHandler,
+            api_host=api_host,
+            owner=owner,
+            session=session,
+            debug=opts.debug,
+        )
+        auth_server.handle_request()
+
+        if not token:
+            return
+
+        try:
+            api_token = user.create_user_token_saml()
+            click.echo(f"New token value: {click.style(api_token.key, fg='magenta')}")
+            create, has_errors = create_config_files(ctx, opts, api_key=api_token.key)
+            new_config_messaging(has_errors, opts, create, api_key=api_token.key)
+            return
+        except exceptions.ApiException as exc:
+            if exc.status == 400:
+                if "User has already created an API key" in exc.detail:
+                    click.confirm(
+                        "User already has a token. Would you like to recreate it?",
+                        abort=True,
+                    )
+                else:
+                    raise
+
+        context_msg = "Failed to refresh the token!"
+        with handle_api_exceptions(ctx, opts=opts, context_msg=context_msg):
+            api_tokens = user.list_user_tokens()
+        for t in api_tokens:
+            click.echo("Current tokens:")
+            click.echo(
+                f"Token: {click.style(t.key, fg='magenta')}, "
+                f"Created: {click.style(t.created, fg='green')}, "
+                f"slug_perm: {click.style(t.slug_perm, fg='cyan')}"
+            )
+        token_slug = click.prompt(
+            "Please enter the slug_perm of the token you would like to refresh"
+        )
+
+        click.echo(f"Refreshing token {token_slug}... ", nl=False)
+        with handle_api_exceptions(ctx, opts=opts, context_msg=context_msg):
+            with maybe_spinner(opts):
+                new_token = user.refresh_user_token(token_slug)
+        click.secho("OK", fg="green")
+        click.echo(f"New token value: {click.style(new_token.key, fg='magenta')}")
+        create, has_errors = create_config_files(ctx, opts, api_key=new_token.key)
+        new_config_messaging(has_errors, opts, create, api_key=new_token.key)