Merge pull request #9 from thewebscraping/dev

Dev

Author: thewebscraping

.gitignore

@@ -56,3 +56,4 @@ docs/_build
 .DS_Store
 examples/.DS_Store
 examples/db.sqlite3
+examples/media/

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/admin.py

@@ -11,6 +11,7 @@ class FileManagerModelAdmin(admin.ModelAdmin):
     form = ChunkedUploadFileAdminForm
     list_display = (
         "id",
+        "name",
         "status",
         "created_at",
         "updated_at",

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/migrations/0003_rename_file_manager_checksum_idx_filemanager_checksum_idx.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.0.7 on 2024-08-28 02:33
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("django_chunk_file_upload", "0002_alter_filemanager_options_and_more"),
+    ]
+
+    operations = [
+        migrations.RenameIndex(
+            model_name="filemanager",
+            new_name="filemanager_checksum_idx",
+            old_name="file_manager_checksum_idx",
+        ),
+    ]

django_chunk_file_upload/models.py

@@ -7,7 +7,9 @@
 from .constants import StatusChoices, TypeChoices
 
 
-class FileManager(models.Model):
+class FileManagerMixin(models.Model):
+    """File Manager Mixin for Django Models"""
+
     created_at = models.DateTimeField(auto_now_add=True)
     updated_at = models.DateTimeField(auto_now=True)
     file = models.FileField()
@@ -34,9 +36,25 @@ class FileManager(models.Model):
     )
     metadata = models.JSONField(default=dict)
 
+    class Meta:
+        abstract = True
+
+    def __str__(self):
+        return self.name
+
+    @property
+    def name(self) -> str:
+        if "name" in self.metadata and self.metadata["name"]:
+            return self.metadata["name"]
+        return self.file.name
+
+
+class FileManager(FileManagerMixin):
+    """File Manager for Django Models"""
+
     class Meta:
         db_table = "django_chunk_file_upload"
-        indexes = [models.Index(fields=["checksum"], name="file_manager_checksum_idx")]
+        indexes = [models.Index(fields=["checksum"], name="%(class)s_checksum_idx")]
         ordering = ("-created_at",)
         unique_together = (
             "user",

django_chunk_file_upload/permissions.py

@@ -1,3 +1,6 @@
+from __future__ import annotations
+
+
 class BasePermission:
     safe_methods = ("GET", "POST", "DELETE")
 

django_chunk_file_upload/static/js/upload.chunk.js

@@ -136,7 +136,6 @@ function deleteFile() {
           processData: false,
           contentType: false,
           error: function (response) {
-            console.log(response)
             let errorMessage = response.statusText;
             if (response.responseJSON) {
               errorMessage = response.responseJSON.message;

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 }}

django_chunk_file_upload/templates/django_chunk_file_upload/forms/widgets/drag_drop_input.html

@@ -1,4 +1,4 @@
-{% load i18n admin_tags %}
+{% load i18n %}
 <div class="dropzone-wrapper">
     <div class="loader hide"></div>
     {% if widget.is_initial %}