v3.3.0

Enhancements:

• Add Globus Search commands for managing index roles. These are globus search index role list, globus search index role create, and globus search index role delete

• Added new commands for manipulating groups
  ** globus group create creates a new group
  ** globus group show shows group information
  ** globus group update updates group name or description
  ** globus group delete deletes a group

Bugfixes:

• Update the version of globus-sdk used, fixing an issue which caused globus task show --skipped-errors and globus task show --successful-transfers to only show partial output

v3.2.0

Enhancements:

• Add a globus group member add command to add users to a group
• Add a globus group member remove command to remove a user from a group
• Add a new globus search index show command which displays an index by ID
• Add a new globus search index list command which lists indices for which the current user has permissions
• Add a new globus search index create command which creates a new Globus Search index. Note that because the index creation API is in public beta, the command is also labeled as "beta"
• Add docs on GLOBUS_PROFILE setting to help for login and logout commands
• Add support for client credentials for authentication in the Globus CLI by setting GLOBUS_CLI_CLIENT_ID and GLOBUS_CLI_CLIENT_SECRET environment variables
  • Both variables must be set to enable this behavior
  • Tokens generated with client credentials are cached in the current user's home directory, but isolated from any user credentials
  • With client credentials, globus login is invalid, but globus logout can be used to revoke any cached tokens
  • Attempting to run globus login while using client credentials will show an appropriate error message
• A new command, globus cli-profile-list can be used to list values for GLOBUS_PROFILE and GLOBUS_CLI_CLIENT_ID ("client profiles") which have been used. By default, the listing is restricted to the current environment. A hidden option (--all) can be used to list all environments

v3.1.4

Bugfixes:

• globus session consent was reducing the scopes of the Auth token provided by login, resulting in errors on logout and whoami

v3.1.3

Enhancements:

• The --help text for globus endpoint create now clarifies the meaning of --personal.
• Errors for use of mutually exclusive options to globus endpoint create have been improved.

Bugfixes:

• Fix an error when globus ls --recursive is used on an empty directory, or filtered such that a recursive listing has no results
• The help text printed by --batch when stdin is a tty has been removed. This text explained CLI v2.x behavior, and is not accurate for CLI v3.x
• Fix a bug in globus session consent in which an id_token was expected as part of the token data, but the openid scope was not provided to the login flow
• Fix a crash that occurs when running globus task event-list {task-id}

v3.1.2

Bugfixes:

• Fix a typo in the word "latitude" for --location arguments.
• Fix the handling of the legacy-line of virtualenv, versions below 20.0.0. When the globus-cli was installed under these versions of virtualenv, all commands would fail at import-time due to an API difference between stdlib site module and the virtualenv-generated site

v3.1.1

Bugfixes:

• The behavior of globus update when operating under a pipx install has been fixed, so that --user will not be passed to the pip invocation
• Fix TypeError in globus endpoint activate resulting from the v3 upgrade

Other:

• Cleanup internal and undocumented behaviors of globus update

v3.1.0

Enhancements:

• Add the new globus search command group for interacting with the Globus Search service. globus search commands may prompt users to login again if they have not previously used a globus search command.
• Add the globus search query command for executing searches on Globus Search indices.
• Add the globus search ingest command for ingesting data into a Globus Search index. You must have writer permissions on the index in order to use this operation.
• Add the globus search task show and globus search task list commands. To use these commands, you must have writer permissions on the index whose tasks are being displayed.

Bugfixes:

• Fix TypeError when running globus endpoint set-subscription-id

v3.0.2

Bugfixes:

• globus task cancel --all no longer throws a TypeError.

v3.0.1

Bugfixes:

• Update dependency specification to avoid an issue in which old versions of cryptography were not updated when an existing installation was updated

v3.0.0

This is a major release of the CLI and has several backwards incompatible changes. See the Backwards Incompatible Changes list below.

Bugfixes:

• Fix a bug in which some error outputs could be sent to stdout

Enhancements:

• globus endpoint show now includes the description field. Formatting of the description may wrap
• globus session update now supports domains for session_required_single_domain requirements
• globus-cli now uses more advanced token storage, and does not use ~/.globus.cfg. A globus login with this version will invalidate any CLI tokens found in ~/.globus.cfg
  • Note: this version of the CLI will not modify the ~/.globus.cfg file, only invalidate CLI version 2 tokens. After the upgrade, you may remove this file if you are not using it for other purposes.
• globus-cli now supports use of the GLOBUS_PROFILE environment variable, which lets users name sets of credentials and switch between accounts
• globus-cli commands can now direct the user to login to a specific Globus Connect Server v5 Endpoint. When the requirements for running a command are not met, a message with the correct login command will be shown.
• A new environment variable, GLOBUS_CLI_INTERACTIVE can be used to instruct the CLI to behave as though it is or is not in an interactive shell. Set GLOBUS_CLI_INTERACTIVE=0 to force non-interactive behavior, and GLOBUS_CLI_INTERACTIVE=1 to force interactive behavior
• Add new collection-related commands for Mapped and Guest Collections
  • globus collection list
  • globus collection show
  • globus collection update
  • globus collection delete
• globus endpoint ... and globus collection ... commands may exit with an error instructing the user to use a corresponding command when globus endpoint commands are used on collections or globus collection commands are used on non-collection endpoint types
• Add new globus group list command for listing your group memberships

Backwards Incompatible Changes:

• Remove the --version flag. Use globus version instead
• globus endpoint server add now takes the server as a positional argument, not a required option
• globus rename has changed to take the endpoint ID once and two separate paths, instead of two endpoint:path arguments which require the endpoint ID to match
• Remove the globus config commands
• globus transfer --batch and globus delete --batch now accept filenames to specify batches. To use stdin (as in v2), pass a single dash for the filename, as in --batch -
• Two new exit statuses, in addition to 0, 1, and 2, are now used by the CLI to indicate specific error conditions
  • An exit(3) is used whenever the type of an object does not match the expectations of a command. For example, globus collection list on a Collection is incorrect -- that command should be used on Endpoints
  • An exit(4) is used whenever the authentication or authorization requirements of a command are not met. For example, if your session does not satisfy the authentication_timeout for an HA endpoint.