django-content-studio 1.0.0b2.post3__tar.gz

django_content_studio-1.0.0b2.post3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Leon van der Grient
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

django_content_studio-1.0.0b2.post3/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.3
+Name: django-content-studio
+Version: 1.0.0b2.post3
+Summary: Modern & flexible Django admin
+License: MIT
+Author: Leon van der Grient
+Author-email: leon@devtastic.io
+Requires-Python: >=3.10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Description-Content-Type: text/markdown
+
+# Django Content Studio
+
+[![PyPI version](https://badge.fury.io/py/django-content-studio.svg)](https://badge.fury.io/py/django-content-studio)
+[![Python versions](https://img.shields.io/pypi/pyversions/django-content-studio.svg)](https://pypi.org/project/django-content-studio/)
+[![Django versions](https://img.shields.io/badge/django-5.0%2B-blue.svg)](https://www.djangoproject.com/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+Django Content Studio is a modern, flexible alternative to the Django admin.
+
+## 🚀 Quick Start
+
+### Installation
+
+☝️ Django Content Studio depends on Django and Django Rest Framework.
+
+```bash
+pip install django-content-studio
+```
+
+### Add to Django Settings
+
+```python
+# settings.py
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'rest_framework',
+    'content_studio',  # Add this
+    # ... your apps
+]
+```
+### Add URLs
+
+```python
+# urls.py
+urlpatterns = [
+    path("admin/", include("content_studio.urls")),
+    # ... your urls
+]
+```
+
+## 🐛 Issues & Support
+
+- 🐛 **Bug Reports**: [GitHub Issues](https://github.com/BitsOfAbstraction/django-content-studio/issues)
+- 💬 **Discussions**: [GitHub Discussions](https://github.com/BitsOfAbstraction/django-content-studio/discussions)
+- 📧 **Email**: leon@devtastic.io
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Built with React and Tailwind CSS
+- Inspired by the original Django admin
+- Thanks to all contributors and the Django community
+
+## 🔗 Links
+
+- [PyPI Package](https://pypi.org/project/django-content-studio/)
+- [GitHub Repository](https://github.com/BitsOfAbstraction/django-content-studio)
+- [Changelog](CHANGELOG.md)
+
+---
+
+Made in Europe 🇪🇺 with 💚 for Django

django_content_studio-1.0.0b2.post3/README.md

@@ -0,0 +1,70 @@
+# Django Content Studio
+
+[![PyPI version](https://badge.fury.io/py/django-content-studio.svg)](https://badge.fury.io/py/django-content-studio)
+[![Python versions](https://img.shields.io/pypi/pyversions/django-content-studio.svg)](https://pypi.org/project/django-content-studio/)
+[![Django versions](https://img.shields.io/badge/django-5.0%2B-blue.svg)](https://www.djangoproject.com/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+Django Content Studio is a modern, flexible alternative to the Django admin.
+
+## 🚀 Quick Start
+
+### Installation
+
+☝️ Django Content Studio depends on Django and Django Rest Framework.
+
+```bash
+pip install django-content-studio
+```
+
+### Add to Django Settings
+
+```python
+# settings.py
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'rest_framework',
+    'content_studio',  # Add this
+    # ... your apps
+]
+```
+### Add URLs
+
+```python
+# urls.py
+urlpatterns = [
+    path("admin/", include("content_studio.urls")),
+    # ... your urls
+]
+```
+
+## 🐛 Issues & Support
+
+- 🐛 **Bug Reports**: [GitHub Issues](https://github.com/BitsOfAbstraction/django-content-studio/issues)
+- 💬 **Discussions**: [GitHub Discussions](https://github.com/BitsOfAbstraction/django-content-studio/discussions)
+- 📧 **Email**: leon@devtastic.io
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Built with React and Tailwind CSS
+- Inspired by the original Django admin
+- Thanks to all contributors and the Django community
+
+## 🔗 Links
+
+- [PyPI Package](https://pypi.org/project/django-content-studio/)
+- [GitHub Repository](https://github.com/BitsOfAbstraction/django-content-studio)
+- [Changelog](CHANGELOG.md)
+
+---
+
+Made in Europe 🇪🇺 with 💚 for Django

django_content_studio-1.0.0b2.post3/content_studio/__init__.py

@@ -0,0 +1,7 @@
+__title__ = "Django Content Studio"
+__version__ = "1.0.0-beta.2"
+__author__ = "Leon van der Grient"
+__license__ = "MIT"
+
+# Version synonym
+VERSION = __version__

django_content_studio-1.0.0b2.post3/content_studio/admin.py

@@ -0,0 +1,298 @@
+from typing import Type
+
+from django.contrib import admin
+from django.db import models
+from django.db.models import Model
+from rest_framework.request import HttpRequest
+
+from . import widgets, formats
+from .form import FormSet, FormSetGroup
+from .login_backends import LoginBackendManager
+from .token_backends import TokenBackendManager
+from .utils import get_related_field_name
+
+register = admin.register
+
+
+class StackedInline(admin.StackedInline):
+    pass
+
+
+class TabularInline(admin.TabularInline):
+    pass
+
+
+class AdminSite(admin.AdminSite):
+    """
+    Enhanced admin site for Django Content Studio.
+    """
+
+    token_backend = TokenBackendManager()
+
+    login_backend = LoginBackendManager()
+
+    dashboard = None
+
+    model_groups = None
+
+    default_widget_mapping = {
+        models.CharField: widgets.InputWidget,
+        models.IntegerField: widgets.InputWidget,
+        models.SmallIntegerField: widgets.InputWidget,
+        models.BigIntegerField: widgets.InputWidget,
+        models.PositiveIntegerField: widgets.InputWidget,
+        models.PositiveSmallIntegerField: widgets.InputWidget,
+        models.PositiveBigIntegerField: widgets.InputWidget,
+        models.FloatField: widgets.InputWidget,
+        models.DecimalField: widgets.InputWidget,
+        models.SlugField: widgets.SlugWidget,
+        models.TextField: widgets.TextAreaWidget,
+        models.BooleanField: widgets.CheckboxWidget,
+        models.NullBooleanField: widgets.CheckboxWidget,
+        models.ForeignKey: widgets.ForeignKeyWidget,
+        models.ManyToManyField: widgets.ManyToManyWidget,
+        models.OneToOneField: widgets.ForeignKeyWidget,
+        models.DateField: widgets.DateWidget,
+        models.DateTimeField: widgets.DateTimeWidget,
+        models.TimeField: widgets.TimeWidget,
+        models.JSONField: widgets.JSONWidget,
+        # Common third-party fields
+        "AutoSlugField": widgets.SlugWidget,
+    }
+
+    default_format_mapping = {
+        models.CharField: formats.TextFormat,
+        models.IntegerField: formats.NumberFormat,
+        models.SmallIntegerField: formats.NumberFormat,
+        models.BigIntegerField: formats.NumberFormat,
+        models.PositiveIntegerField: formats.NumberFormat,
+        models.PositiveSmallIntegerField: formats.NumberFormat,
+        models.PositiveBigIntegerField: formats.NumberFormat,
+        models.FloatField: formats.NumberFormat,
+        models.DecimalField: formats.NumberFormat,
+        models.SlugField: formats.TextFormat,
+        models.TextField: formats.TextFormat,
+        models.BooleanField: formats.BooleanFormat,
+        models.NullBooleanField: formats.BooleanFormat,
+        models.DateField: formats.DateFormat,
+        models.DateTimeField: formats.DateTimeFormat,
+        models.TimeField: formats.TimeFormat,
+        models.ForeignKey: formats.ForeignKeyFormat,
+        models.OneToOneField: formats.ForeignKeyFormat,
+        models.JSONField: formats.JSONFormat,
+    }
+
+    def setup(self):
+        # Add token backend's view set to the
+        # Content Studio router.
+        self.token_backend.set_up_router()
+        # Add login backend's view set to the
+        # Content Studio router.
+        self.login_backend.set_up_router()
+        # Add dashboard's view set to the
+        # Content Studio router.
+        if self.dashboard:
+            self.dashboard.set_up_router()
+
+    def get_thumbnail(self, obj) -> str:
+        """
+        Method for getting and manipulating the image path (or URL).
+        By default, this returns the image path as is.
+        """
+        return obj.file.url
+
+
+admin_site = AdminSite()
+
+
+class ModelAdmin(admin.ModelAdmin):
+    """
+    Enhanced model admin for Django Content Studio and integration with
+    Django Content Framework. Although it's relatively backwards compatible,
+    some default behavior has been changed.
+    """
+
+    # Whether the model is a singleton and should not show
+    # the list view.
+    is_singleton = False
+
+    # Override the widget used for certain fields by adding
+    # a map of field to widget. Fields that are not included
+    # will fall back to their default widget.
+    #
+    # @example
+    # widget_mapping = {'is_published': widgets.SwitchWidget}
+    widget_mapping = None
+
+    # Override the format used for certain fields by adding
+    # a map of field to format. Fields that are not included
+    # will fall back to their default format.
+    #
+    # @example
+    # format_mapping = {'file_size': widgets.FileSizeWidget}
+    format_mapping = None
+
+    # We set a lower limit than Django's default of 100
+    list_per_page = 20
+
+    # Description shown below model name on list pages
+    list_description = ""
+
+    # Configure the main section in the edit-view.
+    edit_main: list[type[FormSetGroup | FormSet | str]] = []
+
+    # Configure the sidebar in the edit-view.
+    edit_sidebar: list[type[FormSet | str]] = []
+
+    icon = None
+
+    def save_model(self, request, obj, form, change):
+        if hasattr(obj, "edited_by"):
+            obj.edited_by = request.user
+        super().save_model(request, obj, form, change)
+
+    def has_add_permission(self, request):
+        is_singleton = getattr(self.model, "is_singleton", False)
+
+        # Don't allow to add more than one singleton object.
+        if is_singleton and self.model.objects.get():
+            return False
+
+        return super().has_add_permission(request)
+
+    def has_delete_permission(self, request, obj=None):
+        is_singleton = getattr(self.model, "is_singleton", False)
+
+        if is_singleton:
+            return False
+
+        return super().has_delete_permission(request, obj)
+
+    def render_change_form(self, request, context, *args, **kwargs):
+        is_singleton = getattr(self.model, "is_singleton", False)
+
+        context["show_save_and_add_another"] = not is_singleton
+
+        return super().render_change_form(request, context, *args, **kwargs)
+
+
+class AdminSerializer:
+    """
+    Class for serializing Django admin classes.
+    """
+
+    def __init__(self, admin_class: ModelAdmin):
+        self.admin_class = admin_class
+
+    def serialize(self, request: HttpRequest):
+        admin_class = self.admin_class
+        format_mapping = getattr(admin_class, "format_mapping", None) or {}
+        widget_mapping = getattr(admin_class, "widget_mapping", None) or {}
+
+        return {
+            "icon": getattr(admin_class, "icon", None),
+            "is_singleton": getattr(admin_class, "is_singleton", False),
+            "edit": {
+                "main": self.serialize_edit_main(request),
+                "sidebar": self.serialize_edit_sidebar(request),
+                "inlines": [
+                    {
+                        "model": inline.model._meta.label_lower,
+                        "fk_name": get_related_field_name(inline, admin_class.model),
+                        "list_display": getattr(inline, "list_display", None)
+                        or ["__str__"],
+                    }
+                    for inline in admin_class.inlines
+                ],
+            },
+            "list": {
+                "per_page": admin_class.list_per_page,
+                "description": getattr(admin_class, "list_description", ""),
+                "display": admin_class.list_display,
+                "search": len(admin_class.search_fields) > 0,
+                "filter": admin_class.list_filter,
+                "sortable_by": admin_class.sortable_by,
+            },
+            "widget_mapping": {
+                field: widget.serialize() for field, widget in widget_mapping.items()
+            },
+            "format_mapping": {
+                field: format.serialize() for field, format in format_mapping.items()
+            },
+            "permissions": {
+                "add_permission": admin_class.has_add_permission(request),
+                "delete_permission": admin_class.has_delete_permission(request),
+                "change_permission": admin_class.has_change_permission(request),
+                "view_permission": admin_class.has_view_permission(request),
+            },
+        }
+
+    def serialize_edit_main(self, request):
+        admin_class = self.admin_class
+
+        return [
+            i.serialize()
+            for i in self.get_edit_main(
+                getattr(admin_class, "edit_main", admin_class.get_fields(request))
+            )
+        ]
+
+    def serialize_edit_sidebar(self, request):
+        admin_class = self.admin_class
+
+        return [
+            i.serialize()
+            for i in self.get_edit_sidebar(getattr(admin_class, "edit_sidebar", None))
+        ]
+
+    def get_edit_main(self, edit_main):
+        """
+        Returns a normalized list of form set groups.
+
+        Form sets will be wrapped in a form set group. If the edit_main attribute is a list of fields,
+        they are wrapped in a form set and a form set group.
+        """
+        if not edit_main:
+            return []
+        if isinstance(edit_main[0], FormSetGroup):
+            return edit_main
+        if isinstance(edit_main[0], FormSet):
+            return [FormSetGroup(formsets=edit_main)]
+
+        return [FormSetGroup(formsets=[FormSet(fields=edit_main)])]
+
+    def get_edit_sidebar(self, edit_sidebar):
+        """
+        Returns a normalized list of form sets for the edit_sidebar.
+
+        If the edit_sidebar attribute is a list of fields,
+        they are wrapped in a form set.
+        """
+        if not edit_sidebar:
+            return []
+        if isinstance(edit_sidebar[0], FormSet):
+            return edit_sidebar
+
+        return [FormSet(fields=edit_sidebar)]
+
+
+class ModelGroup:
+    name = None
+    label = None
+    icon = None
+    color = None
+    models = None
+
+    def __init__(
+        self,
+        name: str,
+        label: str = None,
+        icon: str = None,
+        color: str = None,
+        models: list[Type[Model]] = None,
+    ):
+        self.name = name
+        self.label = label or name.capitalize()
+        self.icon = icon
+        self.color = color
+        self.models = models or []

django_content_studio-1.0.0b2.post3/content_studio/apps.py

@@ -0,0 +1,100 @@
+from django.apps import AppConfig
+from django.contrib import admin
+
+from . import VERSION
+from .paginators import ContentPagination
+from .settings import cs_settings
+from .utils import is_runserver
+
+
+class DjangoContentStudioConfig(AppConfig):
+    name = "content_studio"
+    label = "content_studio"
+    initialized = False
+
+    def ready(self):
+        from .utils import log
+
+        if is_runserver() and not self.initialized:
+            self.initialized = True
+
+            log("\n")
+            log("----------------------------------------")
+            log("Django Content Studio")
+            log(f"Version {VERSION}")
+            log("----------------------------------------")
+            log(":rocket:", "Starting Django Content Studio")
+            log(":mag:", "Discovering admin models...")
+            registered_models = len(admin.site._registry)
+            log(
+                ":white_check_mark:",
+                f"[green]Found {registered_models} admin models[/green]",
+            )
+            # Set up admin site routes
+            admin_site = cs_settings.ADMIN_SITE
+            admin_site.setup()
+
+            # Set up content CRUD APIs
+            self._create_crud_api()
+
+            log("\n")
+
+    def _create_crud_api(self):
+        from .utils import log
+
+        for model, admin_model in admin.site._registry.items():
+            self._create_view_set(model, admin_model)
+
+            for inline in admin_model.inlines:
+                self._create_view_set(
+                    parent=model, model=inline.model, admin_model=inline
+                )
+
+        log(
+            ":white_check_mark:",
+            f"[green]Created CRUD API[/green]",
+        )
+
+    def _create_view_set(self, model, admin_model, parent=None):
+        from .viewsets import BaseModelViewSet
+        from .router import content_studio_router
+        from .serializers import ContentSerializer
+
+        class Pagination(ContentPagination):
+            page_size = getattr(admin_model, "list_per_page", 10)
+
+        class ViewSet(BaseModelViewSet):
+            _model = model
+            _admin_model = admin_model
+            is_singleton = getattr(admin_model, "is_singleton", False)
+            pagination_class = Pagination
+            queryset = _model.objects.all()
+            search_fields = list(getattr(_admin_model, "search_fields", []))
+
+            def get_serializer_class(self):
+                # For list views we include the specified list_display fields.
+                if self.action == "list" and not self.is_singleton:
+                    available_fields = [
+                        "id",
+                        "__str__",
+                    ] + list(getattr(self._admin_model, "list_display", []))
+                # In all other cases we include all fields.
+                else:
+                    available_fields = "__all__"
+
+                class Serializer(ContentSerializer):
+
+                    class Meta:
+                        model = self._model
+                        fields = available_fields
+
+                return Serializer
+
+        if parent:
+            prefix = f"api/inlines/{parent._meta.label_lower}/{model._meta.label_lower}"
+            basename = f"content_studio_api-{parent._meta.label_lower}-{model._meta.label_lower}"
+        else:
+            prefix = f"api/content/{model._meta.label_lower}"
+            basename = f"content_studio_api-{model._meta.label_lower}"
+
+        content_studio_router.register(prefix, ViewSet, basename)

django_content_studio-1.0.0b2.post3/content_studio/dashboard/__init__.py

@@ -0,0 +1,64 @@
+from rest_framework.decorators import action
+from rest_framework.exceptions import NotFound
+from rest_framework.parsers import JSONParser
+from rest_framework.renderers import JSONRenderer
+from rest_framework.response import Response
+from rest_framework.viewsets import ViewSet
+
+from content_studio.settings import cs_settings
+
+
+class Dashboard:
+    """
+    The Dashboard class is used to define the structure of the dashboard
+    in Django Content Studio.
+    """
+
+    widgets = None
+
+    def __init__(self, **kwargs):
+        self.widgets = kwargs.get("widgets", [])
+
+    def set_up_router(self):
+        from content_studio.router import content_studio_router
+
+        content_studio_router.register(
+            "api/dashboard",
+            DashboardViewSet,
+            basename="content_studio_dashboard",
+        )
+
+    def serialize(self):
+        return {
+            "widgets": [
+                {"name": w.__class__.__name__, "col_span": getattr(w, "col_span", 1)}
+                for w in self.widgets
+            ]
+        }
+
+
+class DashboardViewSet(ViewSet):
+    parser_classes = [JSONParser]
+    renderer_classes = [JSONRenderer]
+
+    def __init__(self, *args, **kwargs):
+        super(ViewSet, self).__init__()
+        admin_site = cs_settings.ADMIN_SITE
+
+        self.dashboard = admin_site.dashboard
+        self.authentication_classes = [
+            admin_site.token_backend.active_backend.authentication_class
+        ]
+
+    @action(detail=False, url_path="(?P<name>[^/.]+)")
+    def get(self, request, name=None):
+        widget = None
+
+        for w in self.dashboard.widgets:
+            if name == w.__class__.__name__.lower():
+                widget = w
+
+        if not widget:
+            raise NotFound()
+
+        return Response(data=widget.get_data(request))

django_content_studio-1.0.0b2.post3/content_studio/dashboard/activity_log.py

@@ -0,0 +1,34 @@
+from django.contrib.admin.models import LogEntry
+from rest_framework import serializers
+
+from content_studio.serializers import ContentSerializer
+
+
+class LogEntrySerializer(ContentSerializer):
+    object_model = serializers.SerializerMethodField()
+
+    class Meta:
+        model = LogEntry
+        fields = [
+            "id",
+            "action_flag",
+            "action_time",
+            "user",
+            "object_id",
+            "object_repr",
+            "object_model",
+        ]
+
+    def get_object_model(self, obj):
+        return f"{obj.content_type.app_label}.{obj.content_type.model}"
+
+
+class ActivityLogWidget:
+    """
+    Widget for showing activity logs.
+    """
+
+    col_span = 2
+
+    def get_data(self, request):
+        return LogEntrySerializer(LogEntry.objects.all()[0:5], many=True).data