4.2.0

Changed

• Remove Python 3.7 support in new releases.
  Under Python 3.7 pip will keep resolving the latest version of the package that supports active interpreter.
  This change comes at benefit of using newer versions of B2 CLI dependencies in b2 standalone binary as well as in the official docker image.
  Python 3.8 is now the minimum supported version, until it reaches EOL in October 2024.
  We encourage use of latest stable Python release.
  If Python interpreter upgrade from 3.7 is not an option, please use provided standalone binaries or official docker image.

Fixed

• Update to b2sdk 2.5.1 to fix b2 sync stopping when encountering inaccessible directory. (#1040)
• Fix b2 file hide b2://bucket/file handling and test coverage.
• Fix getdefaultlocale deprecation warning on Python 3.11+.

Added

• Add b2 file server-side-copy b2id://XXX (also accepts b2://bucket/objectName syntax).
  Add deprecation notice to b2 file copy-by-id - use b2 file server-side-copy instead in new scripts.
• Declare official support for Python 3.13 in b2 CLI.
  Test b2 CLI against Python 3.13 in CI.

Infrastructure

• Integration tests now use reuse test buckets whenever possible to speed up test execution and prevent bucket limit exhaustion.

4.1.0

Fixed

• Update b2sdk to 2.5.0, to fix TruncatedOutput download errors when network is congested (e.g., due use of high downloader thread count). (#554)

Added

• Add b2 file unhide command.
• Support both new b2_uri and deprecated bucket_name file_name arguments in b2 file hide.

4.0.3

Fixed

• Fix sync reuploading files on re-run despite no changes in the source.
  Fixed by updating b2sdk to 2.4.1.

4.0.2

Fixed

• Fix --lifecycle-rule validation on python<3.10.
• Update required b2sdk to 2.4.0 which includes following fixes:
  • Move scan filters before a read on filesystem access attempt.
  • Fix & improve Lifecycle Rule validation.
  • Don't retry on NoPaymentHistory exception.

Doc

• Add --lifecycle-rule example to CLI --help and documentation. (#432)

4.0.1

Fixed

• Fix - handling in file upload commands - even if file with - name exists, the stdin will be chosen over it.
  This change affects b2v4 (which is also aliased as b2), but not b2v3 to keep backwards compatibility.
• Fix b2 ls b2://bucketName/fileName and b2 rm b2://bucketName/fileName to respectively, list and remove file identified by supplied B2 URI.

4.0.0

Changed

• CLI b2 executable now points to the latest stable ApiVer version, b2v4, previously it pointed to b2v3.
  These means following breaking changes:
  • b2 will no longer persists credentials and other secrets on disk if credentials were passed through B2_* environment variables. To explicitly persist them and keep using local cache for better performance, user can simply call b2 account authorize
  • b2 ls and b2 rm no longer accept two positional arguments, instead accepting only B2 URI (e.g. b2://bucketName/path)
• Changed sync command exit status code from 0 to 1 if any warnings or errors were encountered during the operation.

Fixed

• Invalid unicode characters read from filesystem will no longer interrupt b2 sync

Deprecated

• Deprecated authorize-account, get-account-info and clear-account, use account {authorize|get|clear} instead.
• Deprecated delete-file-version, use rm instead. Added --bypass-governance option to rm.
• Deprecated file-info, get-url, cat, upload-file, download-file, copy-file-by-id, hide-file, update-file-legal-hold and update-file-retention, use file {info|url|cat|upload|download|copy-by-id|hide|update} instead.
• Deprecated get-download-url-with-auth, use file url instead. Added --with-auth and --duration options to file url.
• Deprecated list-buckets, get-bucket, create-bucket, update-bucket, delete-bucket, get-download-auth and notification-rules, use bucket {list|get|create|update|delete|get-download-auth|notification-rule} instead.
• Deprecated list-keys, create-key and delete-key, use key {list|create|delete} instead.
• Deprecated list-parts, use file large parts instead.
  Deprecated list-unfinished-large-files, use file large unfinished list instead.
  Deprecated cancel-large-file amd cancel-all-unfinished-large-files, use file large unfinished cancel instead.
• Deprecated replication-{setup|delete|pause|unpause|status}, use replication {setup|delete|pause|unpause|status} instead.

Added

• Add account {authorize|get|clear} commands.
• Add bucket {list|get|create|update|delete|get-download-auth|notification-rule} commands.
• Add file large {parts|unfinished list|unfinished cancel} commands.
• Add file {info|url|cat|upload|download|copy-by-id|hide|update} commands.
• Add key {list|create|delete} commands.
• Add replication {setup|delete|pause|unpause|status} commands.
• Allow b2v3 to be run in official Docker image without the need to change entrypoint.

Doc

• Automate nested subcommand documentation generation.
• Display short descriptions instead of arguments in subcommands help messages.
• Sort subcommands in --help alphabetically for better readability.

3.19.1

Fixed

• Fix create-key --all-capabilities error when using b2sdk>=2.1.

3.19.0

Added

• Add notification-rules commands for manipulating Bucket notification rules as part of Event Notifications feature Private Preview.
  See https://www.backblaze.com/blog/announcing-event-notifications/ for details.

3.18.0

Changed

• Change all _b2v4 --camelCase CLI flags to --kebab-case.
  Add deprecation warning for b2v3 --camelCase CLI flags.

Fixed

• Don't persist credentials provided in the Environment variables in any command other than authorize-account when using b2v4.
• Fix b2 --help showing full binary path instead of just basename.

Added

• Add autocomplete support for zsh and fish shells.
• Add support for calling b2 ls without arguments to list all buckets.

Infrastructure

• Add dockerhub description deployment to CD workflow.
• Add support for pre-releases in CD.
• Fix missing command output when running nox under CI.
• Increase verbosity when running tests under CI.
• Update to GitHub Actions using Node 20.

3.17.0

Fixed

• Control character escaping is now enabled by default if running in a terminal for improved security.

Added

• Added --escape-control-characters and --no-escape-control-characters flags,
  as well as B2_ESCAPE_CONTROL_CHARACTERS env var to explicitly enable or disable control character escaping.