diff options
author | CoprDistGit <infra@openeuler.org> | 2023-04-11 12:11:42 +0000 |
---|---|---|
committer | CoprDistGit <infra@openeuler.org> | 2023-04-11 12:11:42 +0000 |
commit | 2b8ac7bfe4d1bcacfab26bbea4f801ebdfcfe6d3 (patch) | |
tree | 63da17d0751d744e2546af3658e2a6249b23493b | |
parent | 35d78a596f31a7bb594b66bc6e6a01dd0298c99b (diff) |
automatic import of python-django-boto
-rw-r--r-- | .gitignore | 1 | ||||
-rw-r--r-- | python-django-boto.spec | 474 | ||||
-rw-r--r-- | sources | 1 |
3 files changed, 476 insertions, 0 deletions
@@ -0,0 +1 @@ +/django-boto-0.3.12.tar.gz diff --git a/python-django-boto.spec b/python-django-boto.spec new file mode 100644 index 0000000..768c8cf --- /dev/null +++ b/python-django-boto.spec @@ -0,0 +1,474 @@ +%global _empty_manifest_terminate_build 0 +Name: python-django-boto +Version: 0.3.12 +Release: 1 +Summary: Wrapper of boto package for django +License: MIT +URL: https://github.com/qnub/django-boto/ +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/95/62/0f4d93c19171e759441bb907e52a462556721b15a628773493014ff6f94f/django-boto-0.3.12.tar.gz +BuildArch: noarch + + +%description +# Django-boto + +[](https://gitter.im/qnub/django-boto?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) + +Is an implementation of `Django` integration with [Amazon AWS](http://aws.amazon.com/) +services through [boto](https://github.com/boto/boto) module. + +# Installation + +To install: + + easy_install django-boto + +or: + + pip install django-boto + +# Configuration + +## DEFAULT_FILE_STORAGE + +Can't be used as default file storage system because of `path` not +implemented but you still can pass `S3Storage` object as storage +option to a `FileField`: + + from django.db import models + from django_boto.s3.storage import S3Storage + + s3 = S3Storage() + + class Car(models.Model): + ... + photo = models.ImageField(storage=s3) + +## Other settings.py options + +`AWS_ACCESS_KEY_ID` + *(required for default file storage use)* **Access Key ID** from + **Security Credentials** settings on AWS service. Required for using + as default storage. + +`AWS_SECRET_ACCESS_KEY` + *(required for default file storage use)* **Secret Access Key** from + **Security Credentials** settings on AWS service. Required for using + as default storage. + +`AWS_ACL_POLICY` + Default canned ACL for objects saved. Defaults to `public-read`. + +`BOTO_S3_BUCKET` + Amazon S3 `bucket` name. Default set to `AWS_ACCESS_KEY_ID`. + +`BOTO_S3_HOST` + Amazon S3 hostname. Default to `s3.amazonaws.com`. + +`BOTO_BUCKET_LOCATION` + Amazon datacenter location. Default to `US Classic Region`. + +`AWS_S3_FORCE_HTTP_URL` + Default to `False`. This settings allow you forcing S3 to return http links to files (if you have problem with SSL). + +# Usage + +## Manual S3Storage usage + +If you need to use it manually - you can pass `bucket_name` +(as `BOTO_S3_BUCKET`), `key` (as `AWS_ACCESS_KEY_ID`), +`secret` (as `AWS_SECRET_ACCESS_KEY`) and `location` +(as `BOTO_BUCKET_LOCATION`) directly to storage constructor: + + from django_boto.s3.storage import S3Storage + + s3 = S3Storage(bucket_name='another-bucket', key='another-key', + secret='another-secret', location='EU') + + +`S3Storage` is a typical [Django storage system](http://readthedocs.org/docs/django/en/1.4/ref/files/storage.html#the-storage-class), only `path` +is not implemented and `created_time` and `accessed_time` return +same value as `modified_time`. + +## Upload shortcut + +You can use a shortcut for simple uploads: + + from django_boto.s3 import upload + + upload(filename, name=None, prefix=False, bucket_name=False, key=None, + secret=None, host=None, expires=0, query_auth=False, force_http=True, + policy=None) + +where: + +`filename`: + `string` filesystem path to file or **django** `File` instance + or **python** `file` object instance; + +`name`: + `string` target Django's name for uploading the file; + +`prefix`: + `string` path prefix to filename in `s3.amazonaws.com` url. Like + filename `/images/image.jpg` with `avatars` prefix convert to + `avatars/image.jpg` in amazon url; + +`bucket_name`: + name of bucket (if not exists - system try to create it) in amazon + S3; + +`key`: + `AWS_ACCESS_KEY_ID` replacement; + +`secret`: + `AWS_SECRET_ACCESS_KEY` replacement. + +`host`: + `BOTO_S3_HOST` replacement. + +`expires`: + `int` How long should private links be valid for. + +`query_auth`: + `bool` Should the url be generated with a valid signature? + Required for private files. + +`force_http`: + `bool` Should the generated url be http? + +`policy`: + `string` Canned acl string for uploaded objects. + +Last nine options are optional. If not set - it's taken from the `settings.py` +or defaults are used. + +`upload()` returns a generated URL for a file download. + + +%package -n python3-django-boto +Summary: Wrapper of boto package for django +Provides: python-django-boto +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-django-boto +# Django-boto + +[](https://gitter.im/qnub/django-boto?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) + +Is an implementation of `Django` integration with [Amazon AWS](http://aws.amazon.com/) +services through [boto](https://github.com/boto/boto) module. + +# Installation + +To install: + + easy_install django-boto + +or: + + pip install django-boto + +# Configuration + +## DEFAULT_FILE_STORAGE + +Can't be used as default file storage system because of `path` not +implemented but you still can pass `S3Storage` object as storage +option to a `FileField`: + + from django.db import models + from django_boto.s3.storage import S3Storage + + s3 = S3Storage() + + class Car(models.Model): + ... + photo = models.ImageField(storage=s3) + +## Other settings.py options + +`AWS_ACCESS_KEY_ID` + *(required for default file storage use)* **Access Key ID** from + **Security Credentials** settings on AWS service. Required for using + as default storage. + +`AWS_SECRET_ACCESS_KEY` + *(required for default file storage use)* **Secret Access Key** from + **Security Credentials** settings on AWS service. Required for using + as default storage. + +`AWS_ACL_POLICY` + Default canned ACL for objects saved. Defaults to `public-read`. + +`BOTO_S3_BUCKET` + Amazon S3 `bucket` name. Default set to `AWS_ACCESS_KEY_ID`. + +`BOTO_S3_HOST` + Amazon S3 hostname. Default to `s3.amazonaws.com`. + +`BOTO_BUCKET_LOCATION` + Amazon datacenter location. Default to `US Classic Region`. + +`AWS_S3_FORCE_HTTP_URL` + Default to `False`. This settings allow you forcing S3 to return http links to files (if you have problem with SSL). + +# Usage + +## Manual S3Storage usage + +If you need to use it manually - you can pass `bucket_name` +(as `BOTO_S3_BUCKET`), `key` (as `AWS_ACCESS_KEY_ID`), +`secret` (as `AWS_SECRET_ACCESS_KEY`) and `location` +(as `BOTO_BUCKET_LOCATION`) directly to storage constructor: + + from django_boto.s3.storage import S3Storage + + s3 = S3Storage(bucket_name='another-bucket', key='another-key', + secret='another-secret', location='EU') + + +`S3Storage` is a typical [Django storage system](http://readthedocs.org/docs/django/en/1.4/ref/files/storage.html#the-storage-class), only `path` +is not implemented and `created_time` and `accessed_time` return +same value as `modified_time`. + +## Upload shortcut + +You can use a shortcut for simple uploads: + + from django_boto.s3 import upload + + upload(filename, name=None, prefix=False, bucket_name=False, key=None, + secret=None, host=None, expires=0, query_auth=False, force_http=True, + policy=None) + +where: + +`filename`: + `string` filesystem path to file or **django** `File` instance + or **python** `file` object instance; + +`name`: + `string` target Django's name for uploading the file; + +`prefix`: + `string` path prefix to filename in `s3.amazonaws.com` url. Like + filename `/images/image.jpg` with `avatars` prefix convert to + `avatars/image.jpg` in amazon url; + +`bucket_name`: + name of bucket (if not exists - system try to create it) in amazon + S3; + +`key`: + `AWS_ACCESS_KEY_ID` replacement; + +`secret`: + `AWS_SECRET_ACCESS_KEY` replacement. + +`host`: + `BOTO_S3_HOST` replacement. + +`expires`: + `int` How long should private links be valid for. + +`query_auth`: + `bool` Should the url be generated with a valid signature? + Required for private files. + +`force_http`: + `bool` Should the generated url be http? + +`policy`: + `string` Canned acl string for uploaded objects. + +Last nine options are optional. If not set - it's taken from the `settings.py` +or defaults are used. + +`upload()` returns a generated URL for a file download. + + +%package help +Summary: Development documents and examples for django-boto +Provides: python3-django-boto-doc +%description help +# Django-boto + +[](https://gitter.im/qnub/django-boto?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) + +Is an implementation of `Django` integration with [Amazon AWS](http://aws.amazon.com/) +services through [boto](https://github.com/boto/boto) module. + +# Installation + +To install: + + easy_install django-boto + +or: + + pip install django-boto + +# Configuration + +## DEFAULT_FILE_STORAGE + +Can't be used as default file storage system because of `path` not +implemented but you still can pass `S3Storage` object as storage +option to a `FileField`: + + from django.db import models + from django_boto.s3.storage import S3Storage + + s3 = S3Storage() + + class Car(models.Model): + ... + photo = models.ImageField(storage=s3) + +## Other settings.py options + +`AWS_ACCESS_KEY_ID` + *(required for default file storage use)* **Access Key ID** from + **Security Credentials** settings on AWS service. Required for using + as default storage. + +`AWS_SECRET_ACCESS_KEY` + *(required for default file storage use)* **Secret Access Key** from + **Security Credentials** settings on AWS service. Required for using + as default storage. + +`AWS_ACL_POLICY` + Default canned ACL for objects saved. Defaults to `public-read`. + +`BOTO_S3_BUCKET` + Amazon S3 `bucket` name. Default set to `AWS_ACCESS_KEY_ID`. + +`BOTO_S3_HOST` + Amazon S3 hostname. Default to `s3.amazonaws.com`. + +`BOTO_BUCKET_LOCATION` + Amazon datacenter location. Default to `US Classic Region`. + +`AWS_S3_FORCE_HTTP_URL` + Default to `False`. This settings allow you forcing S3 to return http links to files (if you have problem with SSL). + +# Usage + +## Manual S3Storage usage + +If you need to use it manually - you can pass `bucket_name` +(as `BOTO_S3_BUCKET`), `key` (as `AWS_ACCESS_KEY_ID`), +`secret` (as `AWS_SECRET_ACCESS_KEY`) and `location` +(as `BOTO_BUCKET_LOCATION`) directly to storage constructor: + + from django_boto.s3.storage import S3Storage + + s3 = S3Storage(bucket_name='another-bucket', key='another-key', + secret='another-secret', location='EU') + + +`S3Storage` is a typical [Django storage system](http://readthedocs.org/docs/django/en/1.4/ref/files/storage.html#the-storage-class), only `path` +is not implemented and `created_time` and `accessed_time` return +same value as `modified_time`. + +## Upload shortcut + +You can use a shortcut for simple uploads: + + from django_boto.s3 import upload + + upload(filename, name=None, prefix=False, bucket_name=False, key=None, + secret=None, host=None, expires=0, query_auth=False, force_http=True, + policy=None) + +where: + +`filename`: + `string` filesystem path to file or **django** `File` instance + or **python** `file` object instance; + +`name`: + `string` target Django's name for uploading the file; + +`prefix`: + `string` path prefix to filename in `s3.amazonaws.com` url. Like + filename `/images/image.jpg` with `avatars` prefix convert to + `avatars/image.jpg` in amazon url; + +`bucket_name`: + name of bucket (if not exists - system try to create it) in amazon + S3; + +`key`: + `AWS_ACCESS_KEY_ID` replacement; + +`secret`: + `AWS_SECRET_ACCESS_KEY` replacement. + +`host`: + `BOTO_S3_HOST` replacement. + +`expires`: + `int` How long should private links be valid for. + +`query_auth`: + `bool` Should the url be generated with a valid signature? + Required for private files. + +`force_http`: + `bool` Should the generated url be http? + +`policy`: + `string` Canned acl string for uploaded objects. + +Last nine options are optional. If not set - it's taken from the `settings.py` +or defaults are used. + +`upload()` returns a generated URL for a file download. + + +%prep +%autosetup -n django-boto-0.3.12 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-django-boto -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Tue Apr 11 2023 Python_Bot <Python_Bot@openeuler.org> - 0.3.12-1 +- Package Spec generated @@ -0,0 +1 @@ +50c9674850b8490926f71d97be8b5b69 django-boto-0.3.12.tar.gz |