معرفی شرکت ها
django-chunk-upload-handlers-0.0.9
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Chunking Django file handlers for S3 and ClamAV service uploads
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-chunk-upload-handlers-0.0.9 |
| نام | django-chunk-upload-handlers |
| نسخه کتابخانه | 0.0.9 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Ross Miller |
| ایمیل نویسنده | ross.miller@digital.trade.gov.uk |
| آدرس صفحه اصلی | https://github.com/uktrade/django-chunk-s3-av-upload-handlers |
| آدرس اینترنتی | https://pypi.org/project/django-chunk-upload-handlers/ |
| مجوز | - |
================================
Django chunk S3 AV file uploader
================================
This library provides two Django file upload handlers.
The first of these, ``s3`` provides chunk uploading to an AWS S3 bucket and is heavily based on
`<https://pypi.org/project/s3chunkuploader/>`_
The second provides chunk uploading to a ClamAV rest endpoint provided by - `<https://github.com/uktrade/dit-clamav-rest/>`_ although it could be used with other compatibile projects.
If used together, the results of the anti virus check are written to the object uploaded to S3.
Installation
------------
.. code-block:: python
pip install django-chunk-upload-handlers
Usage
-----
Using in a Django logging configuration:
.. code-block:: python
INSTALLED_APPS = [
...
"django_chunk_upload_handlers",
]
FILE_UPLOAD_HANDLERS = (
"django_chunk_upload_handlers.clam_av.ClamAVFileUploadHandler",
"django_chunk_upload_handlers.s3.S3FileUploadHandler",
) # Order is important
Dependencies
------------
This project is a Django app and depends on the Django package.
The ``s3`` file handler depends on `boto3 <https://github.com/boto/boto3/>`_ and `django-storages <https://github.com/jschneier/django-storages/>`_
``settings.DEFAULT_FILE_STORAGE`` must be set to ``"storages.backends.s3boto3.S3Boto3Storage"`` or a class that derives from it.
Settings
--------
S3
***
:code:`AWS_ACCESS_KEY_ID`
:code:`CHUNK_UPLOADER_AWS_ACCESS_KEY_ID`
Provide either for the AWS access key required. ``CHUNK_UPLOADER_AWS_ACCESS_KEY_ID`` is preferred if both are set.
:code:`AWS_SECRET_ACCESS_KEY`
:code:`CHUNK_UPLOADER_AWS_SECRET_ACCESS_KEY`
Provide either for the AWS access secret key required. ``CHUNK_UPLOADER_AWS_SECRET_ACCESS_KEY`` is preferred if both are set.
:code:`AWS_STORAGE_BUCKET_NAME`
:code:`CHUNK_UPLOADER_AWS_STORAGE_BUCKET_NAME`
The S3 bucket to use for uploads. ``CHUNK_UPLOADER_AWS_STORAGE_BUCKET_NAME`` is preferred if both are set.
:code:`AWS_REGION`
:code:`CHUNK_UPLOADER_AWS_REGION`
The AWS region to use. ``CHUNK_UPLOADER_AWS_REGION`` is preferred if both are set.
:code:`S3_ROOT_DIRECTORY`
:code:`CHUNK_UPLOADER_S3_ROOT_DIRECTORY`
The directory path to use as root for uploads. ``CHUNK_UPLOADER_S3_ROOT_DIRECTORY`` is preferred if both are set.
:code:`CHUNK_UPLOADER_RAISE_EXCEPTION_ON_VIRUS_FOUND`
Defines whether or not to throw an exception if a virus is found. Defaults to ``False``.
ClamAV
******
:code:`CLAM_AV_USERNAME`
The ClamAV service username.
:code:`CLAM_AV_PASSWORD`
The ClamAV service password.
:code:`CLAM_AV_DOMAIN`
The domain to use for the ClamAV service. Note, this is domain only so ``test.com`` rather than ``https://test.com``
:code:`CLAM_PATH`
The path to the ClamAV service (used with the domain defined in the setting above). Defaults to ``/v2/scan-chunked``
:code:`CLAM_AV_IGNORE_EXTENSIONS`
A list of file extensions to not process with ClamAV. Defaults to an empty list.
:code:`CLAM_USE_HTTP`
Use http rather than https. Should not be used in production environments. Defaults to ``False``.
Usage with file fields
----------------------
The package provides a validator for use with form and model fields.
The ``CHUNK_UPLOADER_RAISE_EXCEPTION_ON_VIRUS_FOUND`` should not be set to ``True`` when using this validator.
.. code-block:: python
from django import forms
from django_chunk_upload_handlers.clam_av import validate_virus_check_result
class ExampleForm(forms.Form):
example_form_field = forms.FileField(
validators=[validate_virus_check_result, ]
)
from django.db import models
class ExampleModel(models.Model):
example_model_field = models.FileField(
max_length=10,
validators=[validate_virus_check_result, ],
)
The validation message will display 'A virus was found' if a virus is detected. This message is a translation string.
Tests
-----
.. code-block:: console
$ pip install -r requirements.txt
$ tox
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.6 | Python |
نحوه نصب
نصب پکیج whl django-chunk-upload-handlers-0.0.9:
pip install django-chunk-upload-handlers-0.0.9.whl
نصب پکیج tar.gz django-chunk-upload-handlers-0.0.9:
pip install django-chunk-upload-handlers-0.0.9.tar.gz