A python library to upload files on cloud. Supported services - AWS S3, DigitalOcean Spaces, LocalStorage.
Project description
# Storedoc 0.1.1
A python module to upload files on cloud. Supported services - [AWS S3](https://aws.amazon.com/s3/), [DigitalOcean Spaces](https://www.digitalocean.com/docs/spaces/), LocalStorage.
# Installation
To install, simply use `pip` or `easy_install`:
```bash
$ pip install --upgrade storedoc
```
or
```bash
$ easy_install --upgrade storedoc
```
------------
# Get Started
#### Upload to AWS S3 Buckets
### Initialize the service
from storedoc import Service
client = Service('aws')
### Get information of the service
client.describe()
### Instantiate AWS S3 Client
client.connect(
region_name='//s3.your-region.amazonaws.com',
endpoint_url='https://s3.amazonaws.com',
aws_access_key_id='your-access-key',
aws_secret_access_key='your-secret'
)
### Upload the file to S3 bucket (Note: File type supported <werkzeug.datastructures.FileStorage>)
client.upload_file(file, bucket='your-bucket-name')
#### Upload to DigitalOcean Spaces Buckets
### Initialize the service
from storedoc import Service
client = Service('do')
### Get information of the service
client.describe()
### Instantiate DO Spaces Client
client.connect(
region_name='your-region',
endpoint_url='https://your-region.digitaloceanspaces.com',
aws_access_key_id='your-access-key',
aws_secret_access_key='your-secret'
)
### Upload the file to S3 bucket (Note: File type supported <werkzeug.datastructures.FileStorage>)
client.upload_file(file, bucket='your-bucket-name')
#### Save File to Local Storage
### Initialize the service
from storedoc import Service
client = LocalStorage()
### Save file to working directory (Note: File type supported <werkzeug.datastructures.FileStorage>)
client.save_file(file)
### Save file to specific directory (Note: File type supported <werkzeug.datastructures.FileStorage>)
client.save_file(file, folder='some-directory-name')
------
## Third Party Libraries and Dependencies
The following libraries will be installed when you install the client library:
* [boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) (Amazon Web Services SDK for Python)
## To-Dos
- Test cases.
## Contribute
1. Look for an open [issue](https://github.com/rakeshgunduka/storedoc/issues) or create new issue to get a dialog going about the new feature or bug that you've discovered.
2. Fork the [repository](https://github.com/rakeshgunduka/storedoc) on Github to start making your changes to the master branch (or branch off of it).
3. Write a test which shows that the bug was fixed or that the feature works as expected.
4. Make a pull request.
A python module to upload files on cloud. Supported services - [AWS S3](https://aws.amazon.com/s3/), [DigitalOcean Spaces](https://www.digitalocean.com/docs/spaces/), LocalStorage.
# Installation
To install, simply use `pip` or `easy_install`:
```bash
$ pip install --upgrade storedoc
```
or
```bash
$ easy_install --upgrade storedoc
```
------------
# Get Started
#### Upload to AWS S3 Buckets
### Initialize the service
from storedoc import Service
client = Service('aws')
### Get information of the service
client.describe()
### Instantiate AWS S3 Client
client.connect(
region_name='//s3.your-region.amazonaws.com',
endpoint_url='https://s3.amazonaws.com',
aws_access_key_id='your-access-key',
aws_secret_access_key='your-secret'
)
### Upload the file to S3 bucket (Note: File type supported <werkzeug.datastructures.FileStorage>)
client.upload_file(file, bucket='your-bucket-name')
#### Upload to DigitalOcean Spaces Buckets
### Initialize the service
from storedoc import Service
client = Service('do')
### Get information of the service
client.describe()
### Instantiate DO Spaces Client
client.connect(
region_name='your-region',
endpoint_url='https://your-region.digitaloceanspaces.com',
aws_access_key_id='your-access-key',
aws_secret_access_key='your-secret'
)
### Upload the file to S3 bucket (Note: File type supported <werkzeug.datastructures.FileStorage>)
client.upload_file(file, bucket='your-bucket-name')
#### Save File to Local Storage
### Initialize the service
from storedoc import Service
client = LocalStorage()
### Save file to working directory (Note: File type supported <werkzeug.datastructures.FileStorage>)
client.save_file(file)
### Save file to specific directory (Note: File type supported <werkzeug.datastructures.FileStorage>)
client.save_file(file, folder='some-directory-name')
------
## Third Party Libraries and Dependencies
The following libraries will be installed when you install the client library:
* [boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) (Amazon Web Services SDK for Python)
## To-Dos
- Test cases.
## Contribute
1. Look for an open [issue](https://github.com/rakeshgunduka/storedoc/issues) or create new issue to get a dialog going about the new feature or bug that you've discovered.
2. Fork the [repository](https://github.com/rakeshgunduka/storedoc) on Github to start making your changes to the master branch (or branch off of it).
3. Write a test which shows that the bug was fixed or that the feature works as expected.
4. Make a pull request.
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
storedoc-0.1.1.tar.gz
(3.5 kB
view hashes)