معرفی شرکت ها
django-direct-cloud-upload-0.2.6
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Widget for uploading files from the client directly to a cloud storage bucket.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-direct-cloud-upload-0.2.6 |
| نام | django-direct-cloud-upload |
| نسخه کتابخانه | 0.2.6 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Koen De Wit |
| ایمیل نویسنده | koendewit@gmail.com |
| آدرس صفحه اصلی | https://github.com/koendewit/django-direct-cloud-upload |
| آدرس اینترنتی | https://pypi.org/project/django-direct-cloud-upload/ |
| مجوز | BSD-3-Clause |
# django-direct-cloud-upload (DDCU)
Widget for uploading files from the client directly to a cloud storage bucket. Currently only supports [Google Cloud Storage](https://cloud.google.com/storage/).
Works with Internet Explorer 11, Google Chrome, Mozilla Firefox and Apple Safari.
After submitting a form containing this widget, the value of the widget will be the path of the file in the cloud bucket, not the file itself. Therefore, you cannot use this widget for a `FileField`. Use a `django.db.models.TextField` (for models) or `django.forms.CharField` (for forms) instead.
## Installation and setup
Install DDCU using pip :
pip install django-direct-cloud-upload
Make sure that `'django.contrib.staticfiles'` is [set up properly](https://docs.djangoproject.com/en/stable/howto/static-files/) and add `'direct_cloud_upload'` to your `INSTALLED_APPS` setting :
INSTALLED_APPS = [
# ...
'django.contrib.staticfiles',
# ...
'direct_cloud_upload',
]
STATIC_URL = '/static/'
DDCU provides a view that will generate a 'signed URL' for uploading a file. To enable this view, include DDCU's `urlpatterns` to your project's URLconf :
import direct_cloud_upload
urlpatterns = [
# ...
path('direct_cloud_upload/', include(direct_cloud_upload.urlpatterns)),
]
_Note_: It is not mandatory to choose `direct_cloud_upload/` as the path, you are free to set any path.
## Configuring the GCS bucket
If you don't have a GCS bucket yet, [create one](https://cloud.google.com/storage/docs/creating-buckets) first.
[Configure CORS](https://cloud.google.com/storage/docs/configuring-cors) on your bucket to allow uploads from your website. Configuring CORS for GCS buckets is done by creating a JSON-file describing the CORS policy and uploading the JSON file with `gsutil`.
Example JSON file containing a CORS policy:
[
{
"origin": [
"https://example-app.com",
"https://www.example-app.com",
"http://localhost:8000"
],
"responseHeader": ["Content-Type"],
"method": ["GET", "HEAD", "PUT"],
"maxAgeSeconds": 3600
}
]
Upload the JSON file with the `gsutil cors set` command:
gsutil cors set cors-json-file.json gs://example-bucket
## Usage
Create a `Bucket` instance and register it with DDCU :
import google.cloud.storage
import direct_cloud_upload
client = google.cloud.storage.Client()
gcs_bucket = client.get_bucket('bucket-id-here')
ddcu_bucket_identifier = direct_cloud_upload.register_gcs_bucket(gcs_bucket)
Creating the `Client` can be a bit more complicated if you need to authenticate, see the [GCS Python client documentation](https://googleapis.dev/python/storage/latest/client.html).
Now you can use the `CloudFileWidget` for any `django.forms.CharField` in a Form :
from direct_cloud_upload import CloudFileWidget
class EbookForm(forms.ModelForm):
class Meta:
model = Ebook
fields = ['title', 'pdf_file']
widgets = {
'pdf_file': CloudFileWidget(
bucket_identifier = ddcu_bucket_identifier,
path_prefix = "ebook_pdf/",
)
}
`CloudFileWidget` has one required parameter:
* `bucket_identifier` (string): identifier retrieved when registering the bucket with DDCU.
`CloudFileWidget` has some optional parameters:
* `path_prefix` (string): Will be prepended automatically to the path of each file. This is useful for collecting all files uploaded via this widget into one directory.
* `include_timestamp` (bool) : Determines if a timestamp will be added to the path. Defaults to `True`.
* `submit_timeout` (int) : Timeout (in seconds) for uploading the form. Defaults to 129600 (36 hours).
* `clearable` (bool) : Add a "Delete file" button to the widget. Defaults to `True`.
* `immediate_submit` (bool) : Immediately submit the form once the user selected a file. Defaults to `False`. _Warning:_ This is probably only useful if the file input is the only field in a form, because the user will not be able to input data in the other fields after selecting a file.
* `show_replace_button` (bool) : Add a "Choose other file" button to the widget if the field contains a file. Defaults to `True`. _Warning:_ `clearable` and `show_replace_button` should not both be set to False, otherwise the user has no way to change the file.
When the form is being submitted, the field will contain the path in the bucket where the file has been uploaded to.
## Including static JS and CSS files
DDCU needs a Javascript and CSS file to function. If you use the widget in a django-admin site, you can use the first method to include these files. For all other sites, you should read the "For generic forms" section below.
### For admin sites
Let your Admin classes inherit from `DdcuAdminMixin`, which will instruct the admin interface to include the necessary files:
from direct_cloud_upload import DdcuAdminMixin
class EbookAdmin(DdcuAdminMixin):
form = EbookForm
### For generic forms
Every page containing a `CloudFileWidget` should include jQuery 1.9 (or newer) and the JS and CSS file in the `head` section:
{% load static %}
<head>
<link rel="stylesheet" href="{% static "direct_cloud_upload/cloud_file_widget.css" %}">
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="{% static "direct_cloud_upload/ddcu_upload.js" %}"></script>
</head>
## Troubleshooting
### Error "No file was submitted. Check the encoding type on the form."
If you get this error when submitting a form containing a `CloudFileWidget`, the widget is probably attached to a `FileField`. Use a `django.db.models.TextField` (for models) or `django.forms.CharField` (for forms) instead.
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.5 | Python |
نحوه نصب
نصب پکیج whl django-direct-cloud-upload-0.2.6:
pip install django-direct-cloud-upload-0.2.6.whl
نصب پکیج tar.gz django-direct-cloud-upload-0.2.6:
pip install django-direct-cloud-upload-0.2.6.tar.gz