Amazon S3 filesystem for PyFilesystem2
Project description
S3FS is a PyFilesystem interface to Amazon S3 cloud storage.
As a PyFilesystem concrete class, S3FS allows you to work with S3 in the same way as any other supported filesystem.
Installing
You can install S3FS from pip as follows:
pip install fs-s3fs
Opening a S3FS
Open an S3FS by explicitly using the constructor:
from fs_s3fs import S3FS
s3fs = S3FS('mybucket')
Or with a FS URL:
from fs import open_fs
s3fs = open_fs('s3://mybucket')
Downloading Files
To download files from an S3 bucket, open a file on the S3 filesystem for reading, then write the data to a file on the local filesystem. Here’s an example that copies a file example.mov from S3 to your HD:
from fs.tools import copy_file_data
with s3fs.open('example.mov', 'rb') as remote_file:
with open('example.mov', 'wb') as local_file:
copy_file_data(remote_file, local_file)
Although it is preferable to use the higher-level functionality in the fs.copy module. Here’s an example:
from fs.copy import copy_file
copy_file(s3fs, 'example.mov', './', 'example.mov')
Uploading Files
You can upload files in the same way. Simply copy a file from a source filesystem to the S3 filesystem. See Moving and Copying for more information.
S3 URLs
You can get a public URL to a file on a S3 bucket as follows:
movie_url = s3fs.geturl('example.mov')
Documentation
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for fs_s3fs-0.1.8-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2c9d1fd6bbe4fa3032d431f78c5436e3dee9fe9d0c237fccfb3e38aac06cf1e4 |
|
MD5 | 37baada5a342b2b8079a21279f00921a |
|
BLAKE2b-256 | e65bf69902d64f8ce42f5d2e3e1e101f1cda727ceb990fd5fb1680565f59a35f |