Minio Python Library for Amazon S3 Compatible Cloud Storage for Python
Project description
# Minio Python Library for Amazon S3 Compatible Cloud Storage [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/minio/minio?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
## Install [![Build Status](https://travis-ci.org/minio/minio-py.svg)](https://travis-ci.org/minio/minio-py)
The recommended technique for installing this package is through pip.
```sh
$ pip install minio
```
## Example
```python
#!/usr/bin/env python
from minio import Minio
# Instantiate a client
client = Minio('s3.amazonaws.com',
access_key='access_key',
secret_key='secret_key')
# List buckets
buckets = client.list_buckets()
for bucket in buckets:
print('bucket:', bucket.name, bucket.creation_date)
```
## Examples:
### Bucket Operations.
[make_bucket(bucket, location, acl)](examples/make_bucket.py)
[list_buckets()](examples/list_buckets.py)
[bucket_exists(bucket)](examples/bucket_exists.py)
[remove_bucket(bucket)](examples/remove_bucket.py)
[get_bucket_acl(bucket)](examples/bucket_acl.py)
[set_bucket_acl(bucket_name, acl=Acl.private())](examples/bucket_acl.py)
[list_incomplete_uploads(bucket_name, prefix=None, recursive=False)](examples/list_incomplete_uploads.py)
### Object Operations.
[get_object(bucket_name, object_name)](examples/get_object.py)
[get_partial_object(bucket_name, object_name, offset, length)](examples/get_partial_object.py)
[put_object(bucket_name, object_name, length, data, content_type='application/octet_stream')](examples/put_object.py)
[list_objects(bucket_name, prefix=None, recursive=False)](examples/list_objects.py)
[stat_object(bucket_name, object_name)](examples/stat_object.py)
[remove_object(bucket_name, object_name)](examples/remove_object.py)
[remove_incomplete_upload(bucket_name, object_name)](examples/remove_incomplete_upload.py)
### Presigned Operations.
[presigned_get_object(bucket_name, object_name, expires=604800)](examples/presigned_get_object.py)
[presigned_put_object(bucket_name, object_name, expires=604800)](examples/presigned_put_object.py)
[presigned_post_policy(policy=PostPolicy())](examples/presigned_post_policy.py)
## Contribute
[Contributors Guide](./CONTRIBUTING.md)
[![PYPI](https://img.shields.io/pypi/v/minio.svg)](https://pypi.python.org/pypi/minio)
[![PYPI](https://img.shields.io/pypi/l/minio.svg)](https://pypi.python.org/pypi/minio)
[![PYPI](https://img.shields.io/pypi/pyversions/minio.svg)](https://pypi.python.org/pypi/minio)
[![PYPI](https://img.shields.io/pypi/dm/minio.svg)](https://pypi.python.org/pypi/minio)
## Install [![Build Status](https://travis-ci.org/minio/minio-py.svg)](https://travis-ci.org/minio/minio-py)
The recommended technique for installing this package is through pip.
```sh
$ pip install minio
```
## Example
```python
#!/usr/bin/env python
from minio import Minio
# Instantiate a client
client = Minio('s3.amazonaws.com',
access_key='access_key',
secret_key='secret_key')
# List buckets
buckets = client.list_buckets()
for bucket in buckets:
print('bucket:', bucket.name, bucket.creation_date)
```
## Examples:
### Bucket Operations.
[make_bucket(bucket, location, acl)](examples/make_bucket.py)
[list_buckets()](examples/list_buckets.py)
[bucket_exists(bucket)](examples/bucket_exists.py)
[remove_bucket(bucket)](examples/remove_bucket.py)
[get_bucket_acl(bucket)](examples/bucket_acl.py)
[set_bucket_acl(bucket_name, acl=Acl.private())](examples/bucket_acl.py)
[list_incomplete_uploads(bucket_name, prefix=None, recursive=False)](examples/list_incomplete_uploads.py)
### Object Operations.
[get_object(bucket_name, object_name)](examples/get_object.py)
[get_partial_object(bucket_name, object_name, offset, length)](examples/get_partial_object.py)
[put_object(bucket_name, object_name, length, data, content_type='application/octet_stream')](examples/put_object.py)
[list_objects(bucket_name, prefix=None, recursive=False)](examples/list_objects.py)
[stat_object(bucket_name, object_name)](examples/stat_object.py)
[remove_object(bucket_name, object_name)](examples/remove_object.py)
[remove_incomplete_upload(bucket_name, object_name)](examples/remove_incomplete_upload.py)
### Presigned Operations.
[presigned_get_object(bucket_name, object_name, expires=604800)](examples/presigned_get_object.py)
[presigned_put_object(bucket_name, object_name, expires=604800)](examples/presigned_put_object.py)
[presigned_post_policy(policy=PostPolicy())](examples/presigned_post_policy.py)
## Contribute
[Contributors Guide](./CONTRIBUTING.md)
[![PYPI](https://img.shields.io/pypi/v/minio.svg)](https://pypi.python.org/pypi/minio)
[![PYPI](https://img.shields.io/pypi/l/minio.svg)](https://pypi.python.org/pypi/minio)
[![PYPI](https://img.shields.io/pypi/pyversions/minio.svg)](https://pypi.python.org/pypi/minio)
[![PYPI](https://img.shields.io/pypi/dm/minio.svg)](https://pypi.python.org/pypi/minio)
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
minio-1.0.0.tar.gz
(27.9 kB
view hashes)
Built Distributions
minio-1.0.0-py2.py3-none-any.whl
(54.2 kB
view hashes)
Close
Hashes for minio-1.0.0.macosx-10.10-x86_64.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2df6d6715c467b86fbcbba315e0ed334a0593e742324b4f800448da9a9b7afe0 |
|
MD5 | 0c455e0b551bf310c5ed53dcaa208349 |
|
BLAKE2b-256 | 798cbc0b97d74dbd9c4c6b9a9091a6287dc42fe8f0d2bf967e287537697a09b0 |
Close
Hashes for minio-1.0.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | eb74101536afbb91b7ca737d7ce161702e7359018d6d91ea0656bb2abe650b3d |
|
MD5 | 826105ecee121bfe81fe383a80222f6e |
|
BLAKE2b-256 | 19a04409cbe8b739ab04e28c4f27e973624da65b505d9517392c04e6cf737398 |