chore: update app settings, README.

Author: Two Dev

README.md

@@ -2,7 +2,7 @@
 
 Django Chunk File Upload is an alternative utility that helps you easily edit Django's chunked, drag and drop file uploads.
 
-<img src="https://i.ibb.co/9y2SgmS/f-P5-Or-Gkxk0-Ynj00ct-G.webp" alt="f-P5-Or-Gkxk0-Ynj00ct-G" border="0">
+<img src="https://i.ibb.co/9y2SgmS/f-P5-Or-Gkxk0-Ynj00ct-G.webp" alt="f-P5-Or-Gkxk0-Ynj00ct-G">
 
 Features
 ----------
@@ -76,7 +76,8 @@ DJANGO_CHUNK_FILE_UPLOAD = {
         "max_width": 1024,
         "max_height": 720,
         "to_webp": True,  # focus convert image to webp type.
-    }
+    },
+    "permission_classes": ("django_chunk_file_upload.permissions.AllowAny",)  # default: IsAuthenticated
 }
 
 ```
@@ -88,14 +89,14 @@ models.py
 
 ```python
 from django.db import models
-from django_chunk_file_upload.models import FileManager
+from django_chunk_file_upload.models import FileManagerMixin
 
 
 class Tag(models.Model):
     name = models.CharField(max_length=255)
 
 
-class YourModel(FileManager):
+class YourModel(FileManagerMixin):
     tags = models.ManyToManyField(Tag)
     custom_field = models.CharField(max_length=255)
 
@@ -116,6 +117,7 @@ class YourForm(ChunkedUploadFileForm):
 
 views.py
 
+Accepted methods: GET, POST, DELETE (UPDATE, PUT does not work with FormData).
 ```python
 from django_chunk_file_upload.views import ChunkedUploadView
 from django_chunk_file_upload.typed import File
@@ -126,12 +128,18 @@ from .forms import YourForm
 class CustomChunkedUploadView(ChunkedUploadView):
     form_class = YourForm
     permission_classes = (IsAuthenticated,)
+
     # file_class = File  # file class
+    # file_status = app_settings.status  # default: PENDING (Used when using background task, you can change it to COMPLETED.)
     # optimize = True  # default: True
     # remove_file_on_update = True  # update image on admin page.
     # chunk_size = 1024 * 1024 * 2  # custom chunk size upload (default: 2MB).
     # upload_to = "custom_folder/%Y/%m/%d"  # custom upload folder.
     # template_name = "custom_template.html"  # custom template
+
+    # # Run background task like celery when upload is complete
+    # def background_task(self, instance):
+    #     pass
 ```
 
 custom_template.html

django_chunk_file_upload/app_settings.py

@@ -1,11 +1,12 @@
 from __future__ import annotations
 
+import importlib
 from dataclasses import dataclass, field, fields
 
 from django.conf import settings
 
+from . import permissions
 from .constants import StatusChoices
-from .permissions import BasePermission, IsAuthenticated
 
 
 @dataclass(kw_only=True)
@@ -49,7 +50,9 @@ class _LazySettings(_Settings):
     is_metadata_storage: bool = False
     remove_file_on_update: bool = True
     status: StatusChoices = StatusChoices.PENDING
-    permission_classes: tuple[BasePermission] = (IsAuthenticated,)
+    permission_classes: tuple[permissions.BasePermission] = (
+        permissions.IsAuthenticated,
+    )
     optimize: bool = True
     image_optimizer: _ImageSettings = field(default_factory=_ImageSettings)
 
@@ -63,6 +66,22 @@ def from_kwargs(cls, **kwargs) -> "_LazySettings":
         image_optimizer = kwargs.pop("image_optimizer", {}) or {}
         if image_optimizer and isinstance(image_optimizer, dict):
             kwargs["image_optimizer"] = _ImageSettings.from_kwargs(**image_optimizer)
+
+        permission_classes = kwargs.pop("permission_classes")
+        if permission_classes and isinstance(
+            permission_classes, (tuple, list, set, str)
+        ):
+            if isinstance(permission_classes, str):
+                permission_classes = [permission_classes]
+
+            perms = []
+            for permission_class in permission_classes:
+                paths = permission_class.split(".")
+                module = importlib.import_module(".".join(paths[:-1]), "")
+                permission_class = getattr(module, paths[-1])
+                perms.append(permission_class)
+
+            kwargs["permission_classes"] = tuple(perms)
         return cls(**kwargs)
 
 

django_chunk_file_upload/templates/django_chunk_file_upload/chunked_upload.html

@@ -1,4 +1,4 @@
-{% load i18n %}
+{% load static i18n %}
 <!DOCTYPE html>
 <html lang="en">
     <head>
@@ -13,30 +13,30 @@
               integrity="sha384-Gn5384xqQ1aoWXA+058RXPxPg6fy4IWvTNh0E263XmFcJlSAwiGgFAW/dAiS6JXm"
               crossorigin="anonymous">
         <style>
-      :root {
-        --input-padding-x: .75rem;
-        --input-padding-y: .75rem;
-      }
+            :root {
+              --input-padding-x: .75rem;
+              --input-padding-y: .75rem;
+            }
 
-      html,
-      body {
-        height: 100%;
-      }
+            html,
+            body {
+              height: 100%;
+            }
 
-      body {
-        display: -ms-flexbox;
-        display: -webkit-box;
-        display: flex;
-        -ms-flex-align: center;
-        -ms-flex-pack: center;
-        -webkit-box-align: center;
-        align-items: center;
-        -webkit-box-pack: center;
-        justify-content: center;
-        padding-top: 40px;
-        padding-bottom: 40px;
-        background-color: #f5f5f5;
-      }
+            body {
+              display: -ms-flexbox;
+              display: -webkit-box;
+              display: flex;
+              -ms-flex-align: center;
+              -ms-flex-pack: center;
+              -webkit-box-align: center;
+              align-items: center;
+              -webkit-box-pack: center;
+              justify-content: center;
+              padding-top: 40px;
+              padding-bottom: 40px;
+              background-color: #f5f5f5;
+            }
 
         </style>
         {{ form.media }}

examples/examples/settings.py

@@ -60,7 +60,7 @@
 
 ROOT_URLCONF = "examples.urls"
 
-TEMPLATES = [
+TEMPLATES = [  # noqa
     {
         "BACKEND": "django.template.backends.django.DjangoTemplates",
         "DIRS": [],
@@ -136,3 +136,21 @@
 # https://docs.djangoproject.com/en/5.0/ref/settings/#default-auto-field
 
 DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
+
+
+# Django Chunk File Upload
+DJANGO_CHUNK_FILE_UPLOAD = {
+    "chunk_size": 1024 * 1024 * 2,  # # custom chunk size upload (default: 2MB).
+    "upload_to": "custom_folder/%Y/%m/%d",  # custom upload folder.
+    "is_metadata_storage": True,  # save file metadata,
+    "remove_file_on_update": True,
+    "optimize": True,
+    "image_optimizer": {
+        "quality": 82,
+        "compress_level": 9,
+        "max_width": 1024,
+        "max_height": 720,
+        "to_webp": True,  # focus convert image to webp type.
+    },
+    "permission_classes": ("django_chunk_file_upload.permissions.AllowAny"),
+}