Filestack REST API Library
Project description
[![Travis CI][travis_ci_badge]][travis_ci]
[![Coveralls][coveralls_badge]][coveralls]
[![Code Climate][code_climate_badge]][code_climate]
# Filestack Python SDK
<a href="https://www.filestack.com"><img src="https://filestack.com/themes/filestack/assets/images/press-articles/color.svg" align="left" hspace="10" vspace="6"></a>
This is the official Python SDK for Filestack - API and content management system that makes it easy to add powerful file uploading and transformation capabilities to any web or mobile application.
## Resources
* [Filestack](https://www.filestack.com)
* [Documentation](https://www.filestack.com/docs/sdks?python)
* [API Reference](https://filestack.github.io/filestack-python)
## Installing
Install ``filestack`` with pip
$ pip install filestack-python
or directly from GitHub
$ pip install git+https://github.com/filestack/filestack-python.git
## Usage
The Filestack SDK allows you to upload and handle filelinks using two main classes: Client and Filelink.
### Uploading New File with Client
``` python
from filestack import Client
client = Client("<YOUR_API_KEY>")
params = {'mimetype': 'image/png'}
new_filelink = client.upload(filepath="path/to/file", params=params)
print(new_filelink.url)
```
Uploading local files will use Filestack's multipart upload by default. To disable, just set the argument to false.
```python
new_filelink = client.upload(filepath="path/to/file", multipart=False)
```
#### Uploading files using Filestack Intelligent Ingestion
To upload files using Filestack Intelligent Ingestion, simply add `intelligent=True` argument
```python
new_filelink = client.upload(filepath="path/to/file", intelligent=True)
```
FII always uses multipart uploads. In case of network issues, it will dynamically split file parts into smaller chunks (sacrificing upload speed in favour of upload reliability).
### Create Filelink using Existing Handle
```python
from filestack import Filelink
new_filelink = Filelink("<YOUR_HANDLE>")
````
### Basic Filelink Functions
With a Filelink, you can download to a local path or get the content of a file. You can also delete or overwrite files if you have security enabled on your account.
```python
file_content = new_filelink.get_content()
response = new_filelink.download("/path/to/file")
filelink.overwrite(filepath="path/to/new/file")
response = filelink.delete()
```
### Transformations
You can chain transformations on both Filelinks and external URLs. Storing transformations will return a new Filelink object.
```python
transform = client.transform_external('http://<SOME_URL>')
new_filelink = transform.resize(width=500, height=500).flip().enhance().store()
filelink = Filelink("<YOUR_HANDLE">)
new_filelink = filelink.resize(width=500, height=500).flip().enhance().store()
```
You can also retrieve the transformation url at any point.
```python
transform_candidate = client.transform_external('http://<SOME_URL>')
transform = transform_candidate.resize(width=500, height=500).flip().enhance()
print(transform.url)
```
### Audio/Video Convert
Audio and video conversion works just like any transformation, except it returns an instance of class AudioVisual, which allows you to check the status of your video conversion, as well as get its UUID and timestamp.
```python
av_object = filelink.av_convert(width=100, height=100)
while (av_object.status != 'completed'):
print(av_object.status)
print(av_object.uuid)
print(av_object.timestamp)
```
The status property makes a call to the API to check its current status, and you can call to_filelink() once video is complete (this function checks its status first and will fail if not completed yet).
```python
filelink = av_object.to_filelink()
```
### Security Objects
Security is set on Client or Filelink classes upon instantiation.
```python
from filestack import security
json_policy = {"expiry": 253381964415}
security = security(json_policy, '<YOUR_APP_SECRET>')
client = Client("<YOUR_API_KEY", security=security)
# new Filelink object inherits security and will use for all calls
new_filelink = client.upload(filepath="path/to/file")
```
## Versioning
Filestack Python SDK follows the [Semantic Versioning](http://semver.org/).
## Issues
If you have problems, please create a [Github Issue](https://github.com/filepicker/filestack-python/issues).
## Contributing
Please see [CONTRIBUTING.md](https://github.com/filepicker/filestack-python/CONTRIBUTING.md) for details.
## Credits
Thank you to all the [contributors](https://github.com/filepicker/filestack-python/graphs/contributors).
[travis_ci]: http://travis-ci.org/filestack/filestack-python
[travis_ci_badge]: https://travis-ci.org/filestack/filestack-python.svg?branch=master
[code_climate]: https://codeclimate.com/github/filestack/filestack-python
[code_climate_badge]: https://codeclimate.com/github/filestack/filestack-python.png
[coveralls]: https://coveralls.io/github/filestack/filestack-python?branch=master
[coveralls_badge]: https://coveralls.io/repos/github/filestack/filestack-python/badge.svg?branch=master
[![Coveralls][coveralls_badge]][coveralls]
[![Code Climate][code_climate_badge]][code_climate]
# Filestack Python SDK
<a href="https://www.filestack.com"><img src="https://filestack.com/themes/filestack/assets/images/press-articles/color.svg" align="left" hspace="10" vspace="6"></a>
This is the official Python SDK for Filestack - API and content management system that makes it easy to add powerful file uploading and transformation capabilities to any web or mobile application.
## Resources
* [Filestack](https://www.filestack.com)
* [Documentation](https://www.filestack.com/docs/sdks?python)
* [API Reference](https://filestack.github.io/filestack-python)
## Installing
Install ``filestack`` with pip
$ pip install filestack-python
or directly from GitHub
$ pip install git+https://github.com/filestack/filestack-python.git
## Usage
The Filestack SDK allows you to upload and handle filelinks using two main classes: Client and Filelink.
### Uploading New File with Client
``` python
from filestack import Client
client = Client("<YOUR_API_KEY>")
params = {'mimetype': 'image/png'}
new_filelink = client.upload(filepath="path/to/file", params=params)
print(new_filelink.url)
```
Uploading local files will use Filestack's multipart upload by default. To disable, just set the argument to false.
```python
new_filelink = client.upload(filepath="path/to/file", multipart=False)
```
#### Uploading files using Filestack Intelligent Ingestion
To upload files using Filestack Intelligent Ingestion, simply add `intelligent=True` argument
```python
new_filelink = client.upload(filepath="path/to/file", intelligent=True)
```
FII always uses multipart uploads. In case of network issues, it will dynamically split file parts into smaller chunks (sacrificing upload speed in favour of upload reliability).
### Create Filelink using Existing Handle
```python
from filestack import Filelink
new_filelink = Filelink("<YOUR_HANDLE>")
````
### Basic Filelink Functions
With a Filelink, you can download to a local path or get the content of a file. You can also delete or overwrite files if you have security enabled on your account.
```python
file_content = new_filelink.get_content()
response = new_filelink.download("/path/to/file")
filelink.overwrite(filepath="path/to/new/file")
response = filelink.delete()
```
### Transformations
You can chain transformations on both Filelinks and external URLs. Storing transformations will return a new Filelink object.
```python
transform = client.transform_external('http://<SOME_URL>')
new_filelink = transform.resize(width=500, height=500).flip().enhance().store()
filelink = Filelink("<YOUR_HANDLE">)
new_filelink = filelink.resize(width=500, height=500).flip().enhance().store()
```
You can also retrieve the transformation url at any point.
```python
transform_candidate = client.transform_external('http://<SOME_URL>')
transform = transform_candidate.resize(width=500, height=500).flip().enhance()
print(transform.url)
```
### Audio/Video Convert
Audio and video conversion works just like any transformation, except it returns an instance of class AudioVisual, which allows you to check the status of your video conversion, as well as get its UUID and timestamp.
```python
av_object = filelink.av_convert(width=100, height=100)
while (av_object.status != 'completed'):
print(av_object.status)
print(av_object.uuid)
print(av_object.timestamp)
```
The status property makes a call to the API to check its current status, and you can call to_filelink() once video is complete (this function checks its status first and will fail if not completed yet).
```python
filelink = av_object.to_filelink()
```
### Security Objects
Security is set on Client or Filelink classes upon instantiation.
```python
from filestack import security
json_policy = {"expiry": 253381964415}
security = security(json_policy, '<YOUR_APP_SECRET>')
client = Client("<YOUR_API_KEY", security=security)
# new Filelink object inherits security and will use for all calls
new_filelink = client.upload(filepath="path/to/file")
```
## Versioning
Filestack Python SDK follows the [Semantic Versioning](http://semver.org/).
## Issues
If you have problems, please create a [Github Issue](https://github.com/filepicker/filestack-python/issues).
## Contributing
Please see [CONTRIBUTING.md](https://github.com/filepicker/filestack-python/CONTRIBUTING.md) for details.
## Credits
Thank you to all the [contributors](https://github.com/filepicker/filestack-python/graphs/contributors).
[travis_ci]: http://travis-ci.org/filestack/filestack-python
[travis_ci_badge]: https://travis-ci.org/filestack/filestack-python.svg?branch=master
[code_climate]: https://codeclimate.com/github/filestack/filestack-python
[code_climate_badge]: https://codeclimate.com/github/filestack/filestack-python.png
[coveralls]: https://coveralls.io/github/filestack/filestack-python?branch=master
[coveralls_badge]: https://coveralls.io/repos/github/filestack/filestack-python/badge.svg?branch=master
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
filestack-python-2.3.0.tar.gz
(21.5 kB
view hashes)