path: root/changelog.adoc

= CLI Changelog

// scriv-insert-here

== 3.2.0 (2022-01-13)

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

== 3.1.4 (2021-11-09)

Bugfixes:

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

== 3.1.3 (2021-11-05)

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}`

== 3.1.2 (2021-10-13)

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`

== 3.1.1 (2021-10-12)

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`

== 3.1.0 (2021-10-08)

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`

== 3.0.2 (2021-10-06)

Bugfixes:

* `globus task cancel --all` no longer throws a TypeError.

== 3.0.1 (2021-09-29)

Bugfixes:

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

== 3.0.0 (2021-09-29)

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.

== 2.1.0 (2021-06-23)

Enhancements:

* `globus transfer` now supports an option, `--exclude`, which can be used to
  skip files matching a pattern or set of patterns when submitting a recursive
  directory transfer

== 2.0.0 (2021-02-02)

* Drop support for python2

== 1.16.0 (2021-01-29)

Enhancements:

* `globus transfer` now supports two new flags, `--skip-source-errors` and
  `--fail-on-quota-errors`, which allow you to better control error behaviors

* `globus task show --skipped-errors` is a new flag which will show skipped
  transfer errors (for transfers which support them)

== 1.15.0 (2021-01-28)

Bugfixes:

* The `disable_verify` option will no longer be set to `False` when left
  unspecified in `globus endpoint update`

Enhancements:

* `globus update` now restricts updates to python2-compatible versions when
  running under python2

== 1.14.0 (2020-10-07)

Bugfixes:

* Fix some help options not being correctly populated

Enhancements:

* Add handling for ConsentRequired errors when interacting with newer versions
  of Globus Connect Server

Other:

* Web documentation is now autogenerated as part of the release process

== 1.13.0 (2020-04-28)

Enhancements:

* Add a new command, `globus endpoint set-subscription-id`, which allows
  Subscription Managers to set the subscription on Endpoints where they may
  not have administrative privileges

== 1.12.0 (2020-03-12)

Bugfixes:

* If a new `refresh_token` is issued when a token refreshes, it will be stored
  correctly.

* Paths being joined for `--batch` mode for `globus transfer` and
  `globus delete` on Windows were joined incorrectly with the platform path
  separator (`\`). They are now joined correctly with `/`

Enhancements:

* Error and hint outputs are styled using colors when the output is being
  written to a terminal.

  ** Supports macOS and Linux by default using ANSI colors.

  ** You can install colorama (`pip install colorama`) in the same
     environment as the CLI to get color support on Windows.

* Endpoints whose activation requirements do not include any myproxy
  requirements now give an informative error message if myproxy activation is
  attempted

* Add support for `--external-checksum` and `--checksum-algorithm` in
  `globus transfer` commands

Other:

* Internally, use the `globus_sdk.IdentityMap` construct, not a custom mapping type.

* Remove official support for python3.4, add support for python3.8

* Improvements to help text

== 1.11.0 (2019-08-13)

Enhancements:

* Add `--limit <count>` option to `globus endpoint search` command.

Other:

* Upgrade to click version 7.

== 1.10.1 (2019-03-19)

* Rename `globus session boost` command to `globus session update`.

== 1.10.0 (2019-03-11)

Enhancements:

* Add `--timeout-exit-code` option to override the default exit
code (1) for commands that wait on tasks. For example, `globus task wait <task_id> --timeout 60 --timeout-exit-code 0`.

== 1.9.1 (2019-02-26)

* Minor internal improvements

== 1.9.0 (2018-11-07)

Enhancements:

* GCP connection/paused status via the endpoint resource
(https://github.com/globus/globus-cli/pull/440[440])
* Update WebApp links
(https://github.com/globus/globus-cli/pull/438[438])
* Minor internal improvements

== 1.8.0 (2018-08-29)

Enhancements:

* Add support for using high assurance collections (https://github.com/globus/globus-cli/pull/434[434])

== 1.7.0 (2018-07-24)

Enhancements:

* Add the `--no-default-directory` flag to `globus endpoint create` and
`globus endpoint update` which unsets the default directory setting
(https://github.com/globus/globus-cli/pull/428[428])

== 1.6.3 (2018-07-16)

Enhancements:

* Verbose output option for `version` command (https://github.com/globus/globus-cli/pull/420[420])
* Lists of roles and permissions are now faster (https://github.com/globus/globus-cli/pull/424[424])

== 1.6.2 (2018-06-06)

Bugfixes:

* Fix handling of Groups in `globus endpoint role list`
(https://github.com/globus/globus-cli/pull/417[417])

== 1.6.1 (2018-05-29)

Enhancements:

* Minor internal improvements

== 1.6.0 (2018-05-24)

Enhancements:

* Add the `globus whoami --linked-identities` flag to get all of your linked identities
(https://github.com/globus/globus-cli/pull/295[295])
* Add the `--format UNIX` flag to produce output suitable for line-oriented
processing with typical unix tools
(https://github.com/globus/globus-cli/pull/404[404])
* Documentation and minor internal improvements

Bugfixes:

* Fix `globus bookmark list` rendering of deleted endpoints
(https://github.com/globus/globus-cli/pull/406[406])

== 1.5.0 (2018-04-04)

Enhancements:

* Support endpoint server deletion by hostname or URL (https://github.com/globus/globus-cli/pull/389[389])
* Support `--myproxy-lifetime` for endpoint activation (https://github.com/globus/globus-cli/pull/393[393])
* The `globus update` command now handles `pip install --user` installations of the CLI (https://github.com/globus/globus-cli/pull/392[392])
* Add `globus rm` command (https://github.com/globus/globus-cli/pull/399[399])

== 1.4.0 (2018-02-27)

Enhancements:

* Add `--notify` option to `globus transfer` and `globus delete` to turn notifications on or off (https://github.com/globus/globus-cli/pull/383[383])
* Add `--filter` option to `globus ls` (https://github.com/globus/globus-cli/pull/384[384])
* Add `globus endpoint local-id` command to get the endpoint ID of a local Globus Connect Personal installation (https://github.com/globus/globus-cli/pull/382[382])
* Add `--notify-email` and `--notify-message` options to `globus endpoint permission create` (https://github.com/globus/globus-cli/pull/381[381])
* `globus delete` will now prompt when the last character is a wildcard `*` (interactive only) (https://github.com/globus/globus-cli/pull/380[380])
** `globus delete --star-silent` or `globus delete --unsafe` can be used to skip the prompt
* Minor documentation improvements

Bugfixes:

* Fix error rendering with `--format json` (https://github.com/globus/globus-cli/pull/377[377])

== 1.3.0 (2018-02-15)

Enhancements:

* Add `--skip-activation-check` option for submitting tasks regardless of the activation status of an endpoint (https://github.com/globus/globus-cli/pull/367[367])
* Improve `task event-details` output formatting (https://github.com/globus/globus-cli/pull/373[373])

Other:

* Update Globus SDK to v1.5.0

== 1.2.3 (2017-12-01)

Enhancements:

* Add support for `GLOBUS_SDK_ENVIRONMENT="preview"`

== 1.2.2 (2017-11-20)

Enhancements:

* Better errors when installation onto python2.6 is attempted (https://github.com/globus/globus-cli/pull/362[362])
* Improve validation of Endpoint `--network-use` (https://github.com/globus/globus-cli/pull/361[361])

Bugfixes:

* Generate delegate proxy certs using UTC, not local time (https://github.com/globus/globus-cli/pull/360[360])

== 1.2.1 (2017-11-01)

Bugfixes:

* Improve handling of non-ascii user names (https://github.com/globus/globus-cli/pull/354[354])

== 1.2.0 (2017-07-17)

Enhancements:

* Allow enabling or disabling the "managed" state of an endpoint via the `--managed`, `--no-managed`, and
`--subscription-id` options to the `globus endpoint update` command.


== 1.1.2 (2017-06-15)

Enhancements:

* Improved autoactivation error messages. (https://github.com/globus/globus-cli/pull/296[296])

Bugfixes:

* Handle "control-c" interrupts while doing the browser based login flow. (https://github.com/globus/globus-cli/pull/320[320])


== 1.1.1 (2017-06-13)

Enhancements:

* Use the `cryptography` package instead of `M2Crypto` for the
`delegate-proxy` feature.
** Note: If you are using the `delegate-proxy` feature and
previously installed the CLI along with `M2Crypto`, you
will need to activate the CLI's virtualenv and install
the `cryptography` dependency:
```
source $HOME/.globus-cli-virtualenv/bin/activate
pip install globus-cli[delegate-proxy] --upgrade
deactivate
```


== 1.1.0 (2017-05-16)

Enhancements:

* Add Delegate Proxy Activation to 'globus endpoint activate'
(requires M2Crypto for options to be displayed)
(https://github.com/globus/globus-cli/pull/306[306])
* Allow 'globus bookmark rename' and 'globus bookmark delete'
to accept either a bookmark name or id.
(https://github.com/globus/globus-cli/pull/292[292])
* Validate tokens upon login.
(https://github.com/globus/globus-cli/pull/286[286])
* Raise more helpful error messages on missing / invalid tokens.
(https://github.com/globus/globus-cli/pull/299[299])
* Display additional helptext with 'globus login'.
(https://github.com/globus/globus-cli/pull/289[289])
* Display additional fields with 'globus task show'.
(https://github.com/globus/globus-cli/pull/301[301])
* Make conflicting filters mutually exclusive in 'globus task event-list'
(https://github.com/globus/globus-cli/pull/294[294])

Bugfixes:

* Fix broken links in the docs.
(https://github.com/globus/globus-cli/pull/305[305])
* Update Six dependency to >=1.10.0 to meet SDK requirements.
(https://github.com/globus/globus-cli/pull/285[285])


== 1.0.0.0 (2017-04-10)

* Initial release.