Skip to main content

Command Line Tool for Backblaze B2

Project description

# B2 Command Line Tool

| Status |
| :------------ |
| [![Travis CI](https://img.shields.io/travis/Backblaze/B2_Command_Line_Tool/master.svg?label=Travis%20CI)](https://travis-ci.org/Backblaze/B2_Command_Line_Tool) |
| [![License](https://img.shields.io/pypi/l/b2.svg?label=License)](https://pypi.python.org/pypi/b2) |
| [![python versions](https://img.shields.io/pypi/pyversions/b2.svg?label=python versions)](https://pypi.python.org/pypi/b2) |
| [![PyPI version](https://img.shields.io/pypi/v/b2.svg?label=PyPI version)](https://pypi.python.org/pypi/b2) |

The command-line tool that gives easy access to all of the capabilities of B2 Cloud Storage.

This program provides command-line access to the B2 service.

Version 0.5.6

# Installation

This tool can be installed with:

pip install b2

If you see a message saying that the `six` library cannot be installed, which
happens if you're installing with the system python on OS X El Capitan, try
this:

pip install --ignore-installed b2

# Usage

b2 authorize_account [<accountId>] [<applicationKey>]
b2 cancel_all_unfinished_large_files <bucketName>
b2 cancel_large_file <fileId>
b2 clear_account
b2 create_bucket <bucketName> [allPublic | allPrivate]
b2 delete_bucket <bucketName>
b2 delete_file_version <fileName> <fileId>
b2 download_file_by_id [--noProgress] <fileId> <localFileName>
b2 download_file_by_name [--noProgress] <bucketName> <fileName> <localFileName>
b2 get_file_info <fileId>
b2 help [commandName]
b2 hide_file <bucketName> <fileName>
b2 list_buckets
b2 list_file_names <bucketName> [<startFileName>] [<maxToShow>]
b2 list_file_versions <bucketName> [<startFileName>] [<startFileId>] [<maxToShow>]
b2 list_parts <largeFileId>
b2 list_unfinished_large_files <bucketName>
b2 ls [--long] [--versions] <bucketName> [<folderName>]
b2 make_url <fileId>
b2 sync [--delete] [--keepDays N] [--skipNewer] [--replaceNewer] \
[--compareVersions <option>] [--threads N] [--noProgress] \
[--excludeRegex <regex>] <source> <destination>
b2 update_bucket <bucketName> [allPublic | allPrivate]
b2 upload_file [--sha1 <sha1sum>] [--contentType <contentType>] [--info <key>=<value>]* \
[--noProgress] [--threads N] <bucketName> <localFilePath> <b2FileName>
b2 version

For more details on one command: b2 help <command>

# Contrib

## bash completion

You can find a [bash completion](https://www.gnu.org/software/bash/manual/html_node/Programmable-Completion.html#Programmable-Completion)
script in the `contrib` directory. See [this](doc/bash_completion.md) for installation instructions.

# Developer Info

You'll need to have these packages installed:

* nose
* pyflakes
* six
* yapf

There is a Makefile with a rule to run the unit tests using the currently active Python:

make test

To test in multiple python virtual environments, set the enviroment variable PYTHON_VIRTUAL_ENVS
to be a space-separated list of their root directories. When set, the makefile will run the
unit tests in each of the environments.

Before checking in, use the pre-commit.sh script to check code formatting, run
unit tests, and run integration tests.

The integration tests need a file in your home directory called `.b2_auth`
that contains two lines with nothing on them but your account ID and application key:

accountId
applicationKey

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

b2-0.5.6.tar.gz (61.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page