bazis-uploadable 2.2.0__py3-none-any.whl

bazis/contrib/uploadable/__init__.py

@@ -0,0 +1,19 @@
+# Copyright 2026 EcoFuture Technology Services LLC and contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    from importlib.metadata import PackageNotFoundError, version
+    __version__ = version('bazis-uploadable')
+except PackageNotFoundError:
+    __version__ = 'dev'

bazis/contrib/uploadable/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '2.2.0'
+__version_tuple__ = version_tuple = (2, 2, 0)
+
+__commit_id__ = commit_id = None

bazis/contrib/uploadable/admin.py

@@ -0,0 +1,25 @@
+# Copyright 2026 EcoFuture Technology Services LLC and contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from django.contrib import admin
+
+from . import models
+
+
+@admin.register(models.FileUpload)
+class FileUploadAdmin(admin.ModelAdmin):
+    list_display = ('name',)
+    list_filter = ('extension',)
+    search_fields = ('name', 'extension')
+

bazis/contrib/uploadable/apps.py

@@ -0,0 +1,22 @@
+# Copyright 2026 EcoFuture Technology Services LLC and contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from django.utils.translation import gettext_lazy as _
+
+from bazis.core.apps import BaseConfig
+
+
+class UploadableConfig(BaseConfig):
+    name = 'bazis.contrib.uploadable'
+    verbose_name = _('Uploadable files')

bazis/contrib/uploadable/conf.py

@@ -0,0 +1,26 @@
+# Copyright 2026 EcoFuture Technology Services LLC and contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from django.utils.translation import gettext_lazy as _
+
+from pydantic import Field
+
+from bazis.core.utils.schemas import BazisSettings
+
+
+class Settings(BazisSettings):
+    BAZIS_STORAGE_FILE_UPLOAD: str = Field('', title=_('Uploadable files storage engine'))
+
+
+settings = Settings()

bazis/contrib/uploadable/locale/en/LC_MESSAGES/django.po

@@ -0,0 +1,39 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2024-07-03 15:09+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#: apps.py:8 models_abstract.py:45 router.py:8
+msgid "Uploadable files"
+msgstr ""
+
+#: conf.py:9
+msgid "Uploadable files storage engine"
+msgstr ""
+
+#: models_abstract.py:22 models_abstract.py:44
+msgid "File"
+msgstr ""
+
+#: models_abstract.py:23
+msgid "Name"
+msgstr ""
+
+#: models_abstract.py:24
+msgid "Extension"
+msgstr ""

bazis/contrib/uploadable/locale/ru/LC_MESSAGES/django.po

@@ -0,0 +1,41 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2024-07-03 15:09+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n"
+"%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || (n"
+"%100>=11 && n%100<=14)? 2 : 3);\n"
+
+#: apps.py:8 models_abstract.py:45 router.py:8
+msgid "Uploadable files"
+msgstr "Загружаемые файлы"
+
+#: conf.py:9
+msgid "Uploadable files storage engine"
+msgstr "Движок хранилища загружаемых файлов"
+
+#: models_abstract.py:22 models_abstract.py:44
+msgid "File"
+msgstr "Файл"
+
+#: models_abstract.py:23
+msgid "Name"
+msgstr "Наименование"
+
+#: models_abstract.py:24
+msgid "Extension"
+msgstr "Расширение"

bazis/contrib/uploadable/migrations/0001_initial.py

@@ -0,0 +1,47 @@
+# Copyright 2026 EcoFuture Technology Services LLC and contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by Django 5.0.6 on 2024-07-03 13:40
+
+import django.core.files.storage.filesystem
+from django.db import migrations, models
+
+import bazis.core.utils.orm
+import model_clone.mixin
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='FileUpload',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('file', models.FileField(storage=django.core.files.storage.filesystem.FileSystemStorage, upload_to=bazis.core.utils.orm.get_file_path, verbose_name='File')),
+                ('name', models.CharField(blank=True, max_length=255, null=True, verbose_name='Name')),
+                ('extension', models.CharField(blank=True, max_length=50, null=True, verbose_name='Extension')),
+            ],
+            options={
+                'verbose_name': 'File',
+                'verbose_name_plural': 'Uploadable files',
+                'abstract': False,
+            },
+            bases=(model_clone.mixin.CloneMixin, models.Model),
+        ),
+    ]

bazis/contrib/uploadable/migrations/0002_alter_fileupload_file.py

@@ -0,0 +1,34 @@
+# Copyright 2026 EcoFuture Technology Services LLC and contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by Django 5.0.1 on 2025-02-12 13:39
+
+import bazis.core.utils.orm
+import django.core.files.storage.filesystem
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('uploadable', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='fileupload',
+            name='file',
+            field=models.FileField(max_length=255, storage=django.core.files.storage.filesystem.FileSystemStorage, upload_to=bazis.core.utils.orm.get_file_path, verbose_name='File'),
+        ),
+    ]

bazis/contrib/uploadable/migrations/__init__.py

@@ -0,0 +1,14 @@
+# Copyright 2026 EcoFuture Technology Services LLC and contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+

bazis/contrib/uploadable/models.py

@@ -0,0 +1,19 @@
+# Copyright 2026 EcoFuture Technology Services LLC and contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from bazis.contrib.uploadable.models_abstract import FileUploadAbstract
+
+
+class FileUpload(FileUploadAbstract):
+    pass

bazis/contrib/uploadable/models_abstract.py

@@ -0,0 +1,63 @@
+# Copyright 2026 EcoFuture Technology Services LLC and contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from django.conf import settings
+from django.core.files.storage import FileSystemStorage
+from django.db import models
+from django.utils.functional import cached_property
+from django.utils.translation import gettext_lazy as _
+
+from bazis.core.models_abstract import JsonApiMixin
+from bazis.core.utils.imp import import_class
+from bazis.core.utils.orm import get_file_path
+
+
+if settings.BAZIS_STORAGE_FILE_UPLOAD:
+    FileStorage = import_class(settings.BAZIS_STORAGE_FILE_UPLOAD)
+else:
+    FileStorage = FileSystemStorage
+
+
+class FileUploadAbstract(JsonApiMixin):
+    file = models.FileField(_('File'), upload_to=get_file_path, max_length=255)
+    name = models.CharField(_('Name'), max_length=255, blank=True, null=True)
+    extension = models.CharField(_('Extension'), max_length=50, blank=True, null=True)
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self._meta.get_field('file').storage = FileStorage()
+
+    @cached_property
+    def size(self) -> int | None:
+        try:
+            return self.file.size
+        except FileNotFoundError:
+            return 0
+
+    def __str__(self):
+        return self.file.name
+
+    def save(self, *args, **kwargs):
+        if not self.name:
+            self.name = os.path.basename(self.file.name)
+        _, self.extension = (os.path.splitext(self.name) + ('',))[:2]
+        self.extension = self.extension[1:]
+        return super().save(*args, **kwargs)
+
+    class Meta:
+        verbose_name = _('File')
+        verbose_name_plural = _('Uploadable files')
+        abstract = True

bazis/contrib/uploadable/router.py

@@ -0,0 +1,23 @@
+# Copyright 2026 EcoFuture Technology Services LLC and contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from django.utils.translation import gettext_lazy as _
+
+from bazis.core.routing import BazisRouter
+
+from .routes import FileUploadRouteSet
+
+
+router = BazisRouter(tags=[_('Uploadable files')])
+router.register(FileUploadRouteSet.as_router())

bazis/contrib/uploadable/routes.py

@@ -0,0 +1,81 @@
+# Copyright 2026 EcoFuture Technology Services LLC and contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from functools import partial
+
+from django.apps import apps
+
+from fastapi import Form, Request
+
+from bazis.core.routes_abstract.initial import http_post
+from bazis.core.routes_abstract.jsonapi import (
+    JsonapiRouteBase,
+    api_action_init,
+    api_action_jsonapi_init,
+    api_action_response_init,
+    item_data_typing,
+    meta_fields_addition,
+)
+from bazis.core.schemas import CrudApiAction, SchemaFields
+from bazis.core.utils.django_types import UploadFileDjango
+
+
+class FileUploadRouteSet(JsonapiRouteBase):
+    model = apps.get_model('uploadable.FileUpload')
+
+    fields = {
+        None: SchemaFields(
+            include={
+                'size': None,
+                'extension': None,
+            }
+        )
+    }
+
+    @http_post(
+        '/',
+        status_code=201,
+        endpoint_callbacks=[
+            partial(meta_fields_addition, api_action=CrudApiAction.CREATE),
+            partial(api_action_init, api_action=CrudApiAction.CREATE),
+            partial(api_action_response_init, api_action=CrudApiAction.RETRIEVE),
+            partial(item_data_typing, api_action=CrudApiAction.CREATE),
+            api_action_jsonapi_init,
+        ],
+    )
+    def action_create(
+        self,
+        request: Request,
+        file: UploadFileDjango,
+        name: str | None = Form(None),
+        id: str | None = Form(None),
+        **kwargs,
+    ):
+        if not isinstance(file, UploadFileDjango):
+            file.__class__ = UploadFileDjango
+
+        request._json = {
+            'data': {
+                'id': id,
+                'type': self.model.get_resource_label(),
+                'attributes': {
+                    'name': name,
+                    'file': file,
+                }
+            },
+        }
+
+        item_data = self.schema_defaults[CrudApiAction.CREATE].model_validate(request._json)
+
+        return super().action_create.func(self, request, item_data)

bazis_uploadable-2.2.0.dist-info/METADATA

@@ -0,0 +1,682 @@
+Metadata-Version: 2.4
+Name: bazis-uploadable
+Version: 2.2.0
+Summary: File upload management module for Bazis framework.
+Author-email: Ilya Kharyn <ilya.tt07@gmail.com>
+Maintainer-email: Ilya Kharyn <ilya.tt07@gmail.com>
+Project-URL: Home, https://github.com/ecofuture-tech/bazis-uploadable
+Keywords: bazis,django,fastapi,pydantic,framework,jsonapi,uploadfiles,storage
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Framework :: Django
+Classifier: Framework :: FastAPI
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: bazis
+Requires-Dist: python-multipart
+Provides-Extra: test
+Requires-Dist: bazis-test-utils; extra == "test"
+Provides-Extra: dev
+Requires-Dist: ruff; extra == "dev"
+
+# Bazis Uploadable
+
+[![PyPI version](https://img.shields.io/pypi/v/bazis-uploadable.svg)](https://pypi.org/project/bazis-uploadable/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/bazis-uploadable.svg)](https://pypi.org/project/bazis-uploadable/)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+An extension package for Bazis, providing a ready-to-use solution for file uploading and management with support for various storage backends.
+
+## Quick Start
+
+```bash
+# Install the package
+uv add bazis-uploadable
+
+# Create a model for file uploads
+from bazis.contrib.uploadable.models_abstract import FileUploadAbstract
+from bazis.core.models_abstract import DtMixin, UuidMixin
+
+class Document(FileUploadAbstract, DtMixin, UuidMixin):
+    """Uploadable document"""
+
+    class Meta:
+        verbose_name = 'Document'
+        verbose_name_plural = 'Documents'
+
+# Create a route for uploads
+from bazis.contrib.uploadable.routes_abstract import FileUploadRouteSet
+from django.apps import apps
+
+class DocumentRouteSet(FileUploadRouteSet):
+    model = apps.get_model('myapp.Document')
+```
+
+## Table of Contents
+
+- [Description](#description)
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Core Components](#core-components)
+  - [FileUploadAbstract](#fileuploadabstract)
+  - [FileUploadRouteSet](#fileuploadrouteset)
+  - [Storage Configuration](#storage-configuration)
+- [Usage](#usage)
+  - [Creating a File Model](#creating-a-file-model)
+  - [Creating an Upload Route](#creating-an-upload-route)
+  - [Uploading Files via API](#uploading-files-via-api)
+- [Storage Configuration](#storage-configuration)
+- [Examples](#examples)
+- [License](#license)
+- [Links](#links)
+
+## Description
+
+**Bazis Uploadable** is an extension package for the Bazis framework that provides a ready-to-use solution for file uploading and management. The package includes:
+
+- **FileUploadAbstract** — abstract model with fields for storing files and metadata
+- **FileUploadRouteSet** — ready-to-use route with multipart/form-data upload support
+- **Flexible storage configuration** — support for local storage, S3, and other backends
+- **Automatic metadata extraction** — filename, extension, size
+- **JSON:API integration** — standardized response format
+
+**This package requires the base `bazis` package to be installed.**
+
+## Requirements
+
+- **Python**: 3.12+
+- **bazis**: latest version
+- **PostgreSQL**: 12+
+- **Redis**: For caching
+
+## Installation
+
+### Using uv (recommended)
+
+```bash
+uv add bazis-uploadable
+```
+
+### Using pip
+
+```bash
+pip install bazis-uploadable
+```
+
+## Core Components
+
+### FileUploadAbstract
+
+Abstract model for storing uploaded files.
+
+**Location**: `bazis.contrib.uploadable.models_abstract.FileUploadAbstract`
+
+**Fields**:
+
+- `file` — FileField for storing the file
+- `name` — filename (optional, automatically filled from file name)
+- `extension` — file extension (optional, automatically extracted)
+
+**Properties**:
+
+- `size` — file size in bytes (cached_property)
+
+**Features**:
+
+- Automatically extracts filename and extension on save
+- Uses `get_file_path` to generate storage path
+- Supports custom storage backends via settings
+- Returns 0 for `size` when file is absent instead of raising an error
+
+**Usage example**:
+
+```python
+from bazis.contrib.uploadable.models_abstract import FileUploadAbstract
+from bazis.core.models_abstract import DtMixin, UuidMixin, JsonApiMixin
+
+class Document(FileUploadAbstract, DtMixin, UuidMixin):
+    """Document with additional fields"""
+    description = models.TextField('Description', blank=True, null=True)
+
+    class Meta:
+        verbose_name = 'Document'
+        verbose_name_plural = 'Documents'
+```
+
+### FileUploadRouteSet
+
+Ready-to-use route for file uploading via multipart/form-data.
+
+**Location**: `bazis.contrib.uploadable.routes_abstract.FileUploadRouteSet`
+
+**Features**:
+
+- Accepts files via `multipart/form-data`
+- Automatically includes `size` and `extension` fields in schema
+- Supports optional `name` field for renaming files
+- Returns data in JSON:API format
+
+**Endpoint**:
+
+- **POST /** — upload a new file
+
+**Usage example**:
+
+```python
+from bazis.contrib.uploadable.routes_abstract import FileUploadRouteSet
+from django.apps import apps
+
+class DocumentRouteSet(FileUploadRouteSet):
+    model = apps.get_model('myapp.Document')
+```
+
+### Storage Configuration
+
+By default, Django's standard `FileSystemStorage` is used. You can configure custom storage via settings.
+
+**settings.py**:
+
+```python
+# Local storage (default)
+BAZIS_STORAGE_FILE_UPLOAD = None  # or 'django.core.files.storage.FileSystemStorage'
+
+# S3-compatible storage
+BAZIS_STORAGE_FILE_UPLOAD = 'storages.backends.s3boto3.S3Boto3Storage'
+
+# Other storage backends
+BAZIS_STORAGE_FILE_UPLOAD = 'path.to.your.CustomStorage'
+```
+
+## Usage
+
+### Creating a File Model
+
+```python
+from bazis.contrib.uploadable.models_abstract import FileUploadAbstract
+from bazis.core.models_abstract import DtMixin, UuidMixin, JsonApiMixin
+from django.db import models
+
+class Document(FileUploadAbstract, DtMixin, UuidMixin):
+    """Document with metadata"""
+    description = models.TextField('Description', blank=True, null=True)
+    category = models.CharField('Category', max_length=100, blank=True, null=True)
+
+    class Meta:
+        verbose_name = 'Document'
+        verbose_name_plural = 'Documents'
+
+    def __str__(self):
+        return self.name or self.file.name
+```
+
+### Creating an Upload Route
+
+**routes.py**:
+
+```python
+from bazis.contrib.uploadable.routes_abstract import FileUploadRouteSet
+from bazis.core.schemas.fields import SchemaField, SchemaFields
+from django.apps import apps
+
+class DocumentRouteSet(FileUploadRouteSet):
+    model = apps.get_model('myapp.Document')
+
+    # Adding additional fields to schema
+    fields = {
+        None: SchemaFields(
+            include={
+                'description': None,
+                'category': None,
+            },
+        ),
+    }
+```
+
+**router.py**:
+
+```python
+from bazis.core.routing import BazisRouter
+from . import routes
+
+router = BazisRouter(tags=['Documents'])
+router.register(routes.DocumentRouteSet.as_router())
+```
+
+### Uploading Files via API
+
+#### Uploading a file with automatic name
+
+```bash
+POST /api/v1/documents/document/
+Content-Type: multipart/form-data
+
+--boundary
+Content-Disposition: form-data; name="file"; filename="report.pdf"
+Content-Type: application/pdf
+
+[binary data]
+--boundary--
+```
+
+**Response**:
+```json
+{
+  "data": {
+    "type": "myapp.document",
+    "id": "123e4567-e89b-12d3-a456-426614174000",
+    "attributes": {
+      "name": "report.pdf",
+      "extension": "pdf",
+      "size": 102400,
+      "dt_created": "2024-01-15T10:30:00Z"
+    },
+    "relationships": {
+      "file": {
+        "data": {
+          "url": "/media/uploads/2024/01/15/report.pdf"
+        }
+      }
+    }
+  }
+}
+```
+
+#### Uploading a file with custom name
+
+```bash
+POST /api/v1/documents/document/
+Content-Type: multipart/form-data
+
+--boundary
+Content-Disposition: form-data; name="file"; filename="original.pdf"
+Content-Type: application/pdf
+
+[binary data]
+--boundary
+Content-Disposition: form-data; name="name"
+
+Monthly Report January 2024.pdf
+--boundary--
+```
+
+**Response**:
+```json
+{
+  "data": {
+    "type": "myapp.document",
+    "id": "123e4567-e89b-12d3-a456-426614174000",
+    "attributes": {
+      "name": "Monthly Report January 2024.pdf",
+      "extension": "pdf",
+      "size": 102400
+    }
+  }
+}
+```
+
+#### Uploading with additional fields
+
+```bash
+POST /api/v1/documents/document/
+Content-Type: multipart/form-data
+
+--boundary
+Content-Disposition: form-data; name="file"; filename="invoice.pdf"
+
+[binary data]
+--boundary
+Content-Disposition: form-data; name="name"
+
+Invoice #12345
+--boundary
+Content-Disposition: form-data; name="description"
+
+Invoice for January 2024 services
+--boundary
+Content-Disposition: form-data; name="category"
+
+Finance
+--boundary--
+```
+
+## Storage Configuration
+
+### Local Storage (default)
+
+```python
+# settings.py
+MEDIA_ROOT = '/var/www/media/'
+MEDIA_URL = '/media/'
+
+# FileSystemStorage is used by default
+BAZIS_STORAGE_FILE_UPLOAD = None
+```
+
+### Amazon S3
+
+```bash
+# Install dependencies
+uv add django-storages boto3
+```
+
+```python
+# settings.py
+BAZIS_STORAGE_FILE_UPLOAD = 'storages.backends.s3boto3.S3Boto3Storage'
+
+# S3 configuration
+AWS_ACCESS_KEY_ID = 'your-access-key'
+AWS_SECRET_ACCESS_KEY = 'your-secret-key'
+AWS_STORAGE_BUCKET_NAME = 'your-bucket-name'
+AWS_S3_REGION_NAME = 'us-east-1'
+AWS_S3_CUSTOM_DOMAIN = f'{AWS_STORAGE_BUCKET_NAME}.s3.amazonaws.com'
+AWS_DEFAULT_ACL = 'public-read'
+```
+
+### MinIO (S3-compatible storage)
+
+```python
+# settings.py
+BAZIS_STORAGE_FILE_UPLOAD = 'storages.backends.s3boto3.S3Boto3Storage'
+
+AWS_ACCESS_KEY_ID = 'minio-access-key'
+AWS_SECRET_ACCESS_KEY = 'minio-secret-key'
+AWS_STORAGE_BUCKET_NAME = 'uploads'
+AWS_S3_ENDPOINT_URL = 'http://minio:9000'
+AWS_S3_USE_SSL = False
+AWS_DEFAULT_ACL = 'public-read'
+```
+
+### Google Cloud Storage
+
+```bash
+# Install dependencies
+uv add django-storages google-cloud-storage
+```
+
+```python
+# settings.py
+BAZIS_STORAGE_FILE_UPLOAD = 'storages.backends.gcloud.GoogleCloudStorage'
+
+GS_BUCKET_NAME = 'your-bucket-name'
+GS_PROJECT_ID = 'your-project-id'
+GS_CREDENTIALS = service_account.Credentials.from_service_account_file(
+    'path/to/service-account.json'
+)
+```
+
+### Custom Storage
+
+You can create your own storage by inheriting from Django Storage:
+
+```python
+# myapp/storage.py
+from django.core.files.storage import FileSystemStorage
+
+class CustomStorage(FileSystemStorage):
+    def __init__(self):
+        super().__init__(
+            location='/custom/path/',
+            base_url='/custom/'
+        )
+
+    def _save(self, name, content):
+        # Custom save logic
+        return super()._save(name, content)
+```
+
+```python
+# settings.py
+BAZIS_STORAGE_FILE_UPLOAD = 'myapp.storage.CustomStorage'
+```
+
+## Examples
+
+### Complete document application example
+
+**models.py**:
+
+```python
+from bazis.contrib.uploadable.models_abstract import FileUploadAbstract
+from bazis.core.models_abstract import DtMixin, UuidMixin, JsonApiMixin
+from django.db import models
+
+class DocumentCategory(models.TextChoices):
+    INVOICE = 'invoice', 'Invoice'
+    CONTRACT = 'contract', 'Contract'
+    REPORT = 'report', 'Report'
+    OTHER = 'other', 'Other'
+
+class Document(FileUploadAbstract, DtMixin, UuidMixin):
+    """Document with category and description"""
+    description = models.TextField('Description', blank=True, null=True)
+    category = models.CharField(
+        'Category',
+        max_length=20,
+        choices=DocumentCategory.choices,
+        default=DocumentCategory.OTHER
+    )
+
+    class Meta:
+        verbose_name = 'Document'
+        verbose_name_plural = 'Documents'
+
+    def __str__(self):
+        return f'{self.get_category_display()}: {self.name}'
+```
+
+**routes.py**:
+
+```python
+from bazis.contrib.uploadable.routes_abstract import FileUploadRouteSet
+from bazis.core.schemas.fields import SchemaFields
+from django.apps import apps
+
+class DocumentRouteSet(FileUploadRouteSet):
+    model = apps.get_model('myapp.Document')
+
+    fields = {
+        None: SchemaFields(
+            include={
+                'description': None,
+                'category': None,
+            },
+        ),
+    }
+```
+
+**router.py**:
+
+```python
+from bazis.core.routing import BazisRouter
+from . import routes
+
+router = BazisRouter(tags=['Documents'])
+router.register(routes.DocumentRouteSet.as_router())
+```
+
+**admin.py**:
+
+```python
+from django.contrib import admin
+from bazis.core.admin_abstract import DtAdminMixin
+from .models import Document
+
+@admin.register(Document)
+class DocumentAdmin(DtAdminMixin, admin.ModelAdmin):
+    list_display = ('id', 'name', 'category', 'extension', 'size_display', 'dt_created')
+    list_filter = ('category', 'extension')
+    search_fields = ('name', 'description')
+    readonly_fields = ('extension', 'size', 'dt_created', 'dt_updated')
+
+    def size_display(self, obj):
+        """Human-readable file size"""
+        size = obj.size
+        if size < 1024:
+            return f'{size} B'
+        elif size < 1024 * 1024:
+            return f'{size / 1024:.2f} KB'
+        else:
+            return f'{size / (1024 * 1024):.2f} MB'
+    size_display.short_description = 'Size'
+```
+
+### Client application usage example
+
+**JavaScript (file upload)**:
+
+```javascript
+async function uploadDocument(file, category, description) {
+  const formData = new FormData();
+  formData.append('file', file);
+  formData.append('category', category);
+
+  if (description) {
+    formData.append('description', description);
+  }
+
+  const response = await fetch('/api/v1/documents/document/', {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${token}`
+    },
+    body: formData
+  });
+
+  if (!response.ok) {
+    throw new Error('Upload failed');
+  }
+
+  return await response.json();
+}
+
+// Usage
+const fileInput = document.getElementById('fileInput');
+const file = fileInput.files[0];
+
+try {
+  const result = await uploadDocument(file, 'invoice', 'Monthly invoice');
+  console.log('Uploaded:', result.data.id);
+  console.log('File URL:', result.data.attributes.file);
+} catch (error) {
+  console.error('Error:', error);
+}
+```
+
+**Python (file upload via requests)**:
+
+```python
+import requests
+
+def upload_document(file_path, category, description=None):
+    url = 'http://api.example.com/api/v1/documents/document/'
+
+    with open(file_path, 'rb') as file:
+        files = {'file': file}
+        data = {
+            'category': category,
+        }
+
+        if description:
+            data['description'] = description
+
+        headers = {
+            'Authorization': f'Bearer {token}'
+        }
+
+        response = requests.post(url, files=files, data=data, headers=headers)
+        response.raise_for_status()
+
+        return response.json()
+
+# Usage
+result = upload_document(
+    '/path/to/invoice.pdf',
+    category='invoice',
+    description='Monthly invoice for January'
+)
+
+print(f"Uploaded: {result['data']['id']}")
+print(f"Size: {result['data']['attributes']['size']} bytes")
+```
+
+### Getting list of files
+
+```bash
+GET /api/v1/documents/document/
+Authorization: Bearer <token>
+```
+
+**Response**:
+```json
+{
+  "data": [
+    {
+      "type": "myapp.document",
+      "id": "123e4567-e89b-12d3-a456-426614174000",
+      "attributes": {
+        "name": "invoice.pdf",
+        "extension": "pdf",
+        "size": 102400,
+        "category": "invoice",
+        "description": "Monthly invoice",
+        "dt_created": "2024-01-15T10:30:00Z"
+      }
+    },
+    {
+      "type": "myapp.document",
+      "id": "987e6543-e21b-32d1-b654-426614174001",
+      "attributes": {
+        "name": "report.docx",
+        "extension": "docx",
+        "size": 256000,
+        "category": "report",
+        "dt_created": "2024-01-16T14:20:00Z"
+      }
+    }
+  ],
+  "meta": {
+    "count": 2
+  }
+}
+```
+
+### Filtering by extension
+
+```bash
+GET /api/v1/documents/document/?filter[extension]=pdf
+```
+
+### Filtering by category
+
+```bash
+GET /api/v1/documents/document/?filter[category]=invoice
+```
+
+## License
+
+Apache License 2.0
+
+See [LICENSE](LICENSE) file for details.
+
+## Links
+
+- [Bazis Documentation](https://github.com/ecofuture-tech/bazis) — main repository
+- [Bazis Uploadable Repository](https://github.com/ecofuture-tech/bazis-uploadable) — package repository
+- [Issue Tracker](https://github.com/ecofuture-tech/bazis-uploadable/issues) — report bugs or request features
+- [Django Storages](https://django-storages.readthedocs.io/) — storage backend documentation
+
+## Support
+
+If you have questions or issues:
+- Check the [Bazis documentation](https://github.com/ecofuture-tech/bazis)
+- Search through [existing issues](https://github.com/ecofuture-tech/bazis-uploadable/issues)
+- Create a [new issue](https://github.com/ecofuture-tech/bazis-uploadable/issues/new) with detailed information
+
+---
+
+Made with ❤️ by Bazis team

bazis_uploadable-2.2.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+bazis/contrib/uploadable/__init__.py,sha256=yrZO1q_ut-i1aU1GYeg4bypwe_xjNccaqDrQmrUAniw,784
+bazis/contrib/uploadable/_version.py,sha256=6OGz4a0gjMGlckPyPCNiJDWyFDO-tWO8O_ZNx4ajT2Y,704
+bazis/contrib/uploadable/admin.py,sha256=218mMcrIER0bG58waDCoh5G2ctElTcVmioAHAGd5z0I,853
+bazis/contrib/uploadable/apps.py,sha256=M8rxoRma5YzI6HLIaht9IEYpiseLrT_r2J8qckhkstw,827
+bazis/contrib/uploadable/conf.py,sha256=y0AsAfMbJbz-oP0ld1HinXbprwCgEiLUB63I9KYWcNs,898
+bazis/contrib/uploadable/models.py,sha256=IW7oUTUlJqEsU6fz3iaKdTlTeiFMwpGJy-lLs8Bt3Qw,736
+bazis/contrib/uploadable/models_abstract.py,sha256=7HG5LGIKv2KRG9wDwwk-mm2qr8uOZAwksINuev_HA_Q,2197
+bazis/contrib/uploadable/router.py,sha256=SZW_3eLKP_KlvSsyyAQtomLtevYTFOr5q2ENacXoK30,855
+bazis/contrib/uploadable/routes.py,sha256=P9Zb87wEsln071jxDwSB1vEkiPUgievFJD2Z-NXgoxc,2516
+bazis/contrib/uploadable/locale/en/LC_MESSAGES/django.mo,sha256=N1pb17IfLd0ASiKO8d68-B4ygSpDkhKOCs8YTzMXQo0,380
+bazis/contrib/uploadable/locale/en/LC_MESSAGES/django.po,sha256=gYhnI4Ci3W-7Ioo7uSF6fGiql8C6mpZS-__tbovoYOI,948
+bazis/contrib/uploadable/locale/ru/LC_MESSAGES/django.mo,sha256=1oAU-_1G-Rez_Wgt21g_pkxM1dVxDC-pfr3ZeMCEXDc,856
+bazis/contrib/uploadable/locale/ru/LC_MESSAGES/django.po,sha256=5Gu4PyiP5fiHjIlGLHjoO2LS2MxEOgd1RbbZncxS6iw,1244
+bazis/contrib/uploadable/migrations/0001_initial.py,sha256=ZuA4ZRT9wJtWja0cly_if4D8bVfrdbZwaIKkCFuf85U,1773
+bazis/contrib/uploadable/migrations/0002_alter_fileupload_file.py,sha256=Me826ZVKboEOze051_b9N29PfTCjIslX7GSnkZH8Le0,1199
+bazis/contrib/uploadable/migrations/__init__.py,sha256=7MU6gF_TkvnR3NFi-Nfci4RIacoZ6bqMjwlR6ONK8Ms,615
+bazis_uploadable-2.2.0.dist-info/METADATA,sha256=Ah6I62SlUQgSWfiAEHbdRF1W1h5X0ExcuWs3BO5SxR4,17018
+bazis_uploadable-2.2.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+bazis_uploadable-2.2.0.dist-info/top_level.txt,sha256=WgdrPZTZBMG8i_EqxA3vU5qI4ETQ_RsqKqSqsfIApHY,6
+bazis_uploadable-2.2.0.dist-info/RECORD,,

bazis_uploadable-2.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

bazis_uploadable-2.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+bazis