Metadata-Version: 2.0
Name: minio
Version: 2.0.0
Summary: Minio Python Library for Amazon S3 Compatible Cloud Storage for Python
Home-page: https://github.com/minio/minio-py
Author: Minio, Inc.
Author-email: dev@minio.io
License: Apache License 2.0
Download-URL: https://github.com/minio/minio-py
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: certifi (<=2015.4.28)
Requires-Dist: pytz
Requires-Dist: urllib3

# 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 
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)](examples/make_bucket.py)

[list_buckets()](examples/list_buckets.py)

[bucket_exists(bucket)](examples/bucket_exists.py)

[remove_bucket(bucket)](examples/remove_bucket.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)
[![Build Status](https://travis-ci.org/minio/minio-py.svg)](https://travis-ci.org/minio/minio-py)
[![Build status](https://ci.appveyor.com/api/projects/status/1d05e6nvxcelmrak?svg=true)](https://ci.appveyor.com/project/harshavardhana/minio-py)


