extensible-django-commerce 1.0.0__py3-none-any.whl

django_commerce/admin.py

@@ -0,0 +1 @@
+# Register your models here.

django_commerce/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class DjangoCommerceConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_commerce'

django_commerce/cart/admin.py

@@ -0,0 +1 @@
+# Register your models here.

django_commerce/cart/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class CartConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_commerce.cart'

django_commerce/cart/migrations/0001_initial.py

@@ -0,0 +1,53 @@
+# Generated by Django 6.0.4 on 2026-05-09 12:36
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = [
+        ("product", "0001_initial"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="CartItem",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+                    ),
+                ),
+                ("quantity", models.PositiveIntegerField()),
+                (
+                    "product",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE, to="product.baseproduct"
+                    ),
+                ),
+            ],
+        ),
+        migrations.CreateModel(
+            name="Cart",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+                    ),
+                ),
+                (
+                    "user",
+                    models.OneToOneField(
+                        on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL
+                    ),
+                ),
+                ("cart_items", models.ManyToManyField(to="cart.cartitem")),
+            ],
+        ),
+    ]

django_commerce/cart/migrations/0002_cart_active_cartitem__final_price_cartitem_active_and_more.py

@@ -0,0 +1,37 @@
+# Generated by Django 6.0.4 on 2026-06-23 12:06
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("cart", "0001_initial"),
+        ("product", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="cart",
+            name="active",
+            field=models.BooleanField(default=True),
+        ),
+        migrations.AddField(
+            model_name="cartitem",
+            name="_final_price",
+            field=models.DecimalField(decimal_places=2, max_digits=20, null=True),
+        ),
+        migrations.AddField(
+            model_name="cartitem",
+            name="active",
+            field=models.BooleanField(default=True),
+        ),
+        migrations.AlterField(
+            model_name="cartitem",
+            name="product",
+            field=models.ForeignKey(
+                on_delete=django.db.models.deletion.PROTECT, to="product.baseproduct"
+            ),
+        ),
+    ]

django_commerce/cart/migrations/0003_remove_cart_user.py

@@ -0,0 +1,17 @@
+# Generated by Django 6.0.4 on 2026-06-29 14:16
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("cart", "0002_cart_active_cartitem__final_price_cartitem_active_and_more"),
+    ]
+
+    operations = [
+        migrations.RemoveField(
+            model_name="cart",
+            name="user",
+        ),
+    ]

django_commerce/cart/models.py

@@ -0,0 +1,86 @@
+from decimal import Decimal
+
+from django.conf import settings
+from django.db import models
+
+
+class CartItem(models.Model):
+    product = models.ForeignKey('product.BaseProduct', on_delete=models.PROTECT)
+    quantity = models.PositiveIntegerField()
+    _final_price = models.DecimalField(max_digits=20, decimal_places=2,null=True)
+    active = models.BooleanField(default=True)
+
+    def __str__(self):
+        return f"{self.product.name} - {self.quantity}"
+
+
+    @property
+    def final_price(self):
+        return self._final_price
+
+    @final_price.setter
+    def final_price(self, value):
+        self._final_price = value
+
+    @property
+    def product_price(self):
+        return self.product.price if self.active else self.final_price or Decimal(0)
+
+    @property
+    def total(self):
+        return self.quantity * self.product_price
+
+
+    def increase_quantity(self):
+        self.quantity += 1
+
+    def decrease_quantity(self):
+        self.quantity -= 1
+
+    def payment_finished(self):
+        self.active = False
+        self.final_price = self.product.price
+        self.save()
+
+
+class Cart(models.Model):
+    from django_commerce.product.models import BaseProduct
+
+    cart_items = models.ManyToManyField(CartItem)
+    active = models.BooleanField(default=True)  # order is not paid
+
+    def add_to_cart(self, product: BaseProduct):
+        quantity_increased = False
+        for cart_item in self.cart_items.select_related('product').all():
+            if cart_item.product == product:
+                cart_item.increase_quantity()
+                cart_item.save()
+                quantity_increased = True
+                break
+        if not quantity_increased:
+            cart_item = CartItem.objects.create(product=product, quantity=1)
+            self.cart_items.add(cart_item)
+
+    def remove_from_cart(self, product: BaseProduct) -> bool:
+        for cart_item in self.cart_items.all():
+            if cart_item.product == product:
+                if cart_item.quantity == 1:
+                    self.cart_items.remove(cart_item)
+                else:
+                    cart_item.decrease_quantity()
+                    cart_item.save()
+                return True
+        return False
+
+    @property
+    def total(self):
+        total = Decimal(0)
+        for cart_item in self.cart_items.all():
+            total += cart_item.total
+        return total
+
+    def close_cart(self):
+        for cart_item in self.cart_items.all():
+            cart_item.payment_finished()
+        self.active = False
+        self.save()

django_commerce/cart/tests.py

@@ -0,0 +1 @@
+# Create your tests here.

django_commerce/cart/views.py

@@ -0,0 +1 @@
+# Create your views here.

django_commerce/models.py

@@ -0,0 +1,2 @@
+
+

django_commerce/offsite_payment_gateway/admin.py

@@ -0,0 +1 @@
+# Register your models here.

django_commerce/offsite_payment_gateway/apps.py

@@ -0,0 +1,11 @@
+from django.apps import AppConfig
+from django_plugin_system import register_plugin_type
+
+
+class OffsitePaymentGatewayConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_commerce.offsite_payment_gateway'
+
+    def ready(self):
+        from .plugins import OffsitePayment
+        register_plugin_type({"interface":OffsitePayment})

django_commerce/offsite_payment_gateway/migrations/0001_initial.py

@@ -0,0 +1,41 @@
+# Generated by Django 6.0.4 on 2026-06-23 12:08
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ("django_plugin_system", "0001_initial"),
+        ("order", "0002_remove_order_cart_items_order_cart_and_more"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="InProgressPayment",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+                    ),
+                ),
+                (
+                    "order",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.PROTECT, to="order.order"
+                    ),
+                ),
+                (
+                    "plugin_instance",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.PROTECT,
+                        to="django_plugin_system.plugininstance",
+                    ),
+                ),
+            ],
+        ),
+    ]

django_commerce/offsite_payment_gateway/models.py

@@ -0,0 +1,7 @@
+from django.db import models
+from django_plugin_system.models import PluginInstance
+
+
+class InProgressPayment(models.Model):
+    plugin_instance = models.ForeignKey(PluginInstance, on_delete=models.PROTECT)
+    order = models.ForeignKey('order.Order', on_delete=models.PROTECT)

django_commerce/offsite_payment_gateway/plugins.py

@@ -0,0 +1,35 @@
+from typing import Tuple, Dict
+
+from django.http import HttpRequest, HttpResponseRedirect
+from django.urls import reverse
+from django_plugin_system import required_plugin_item_method
+
+from ..payment.plugins import PaymentPlugin
+
+BASE_URL = 'http://127.0.0.1:8000'
+
+class OffsitePayment(PaymentPlugin):
+    name = 'Offsite Payment'
+
+    def create_payment(self, order):
+        from .models import InProgressPayment
+        in_progress_payment = InProgressPayment.objects.create(
+            order=order,
+            plugin_instance=self.plugin_item.plugin_instance
+        )
+        callback_url = BASE_URL + HttpResponseRedirect(reverse('payment_callback', args=[in_progress_payment.pk])).url
+        return self.plugin_item.get_payment_gateway_url(order, callback_url)
+
+    @required_plugin_item_method
+    def get_payment_gateway_url(self, order, callback_url: str) -> Tuple[bool,str]:
+        """
+        :param order:
+        :param callback_url:
+        :return: str
+         The return value should be the gateway url as string
+        """
+        pass
+
+    @required_plugin_item_method
+    def verify_payment(self, order, callback_request: HttpRequest | None = None) -> Tuple[bool, Dict]:
+        pass

django_commerce/offsite_payment_gateway/tests.py

@@ -0,0 +1 @@
+# Create your tests here.

django_commerce/offsite_payment_gateway/urls.py

@@ -0,0 +1,7 @@
+from django.urls import path
+
+from .views import callback_view
+
+urlpatterns = [
+    path('payment-callback/<int:payment_id>', callback_view, name='payment_callback'),
+]

django_commerce/offsite_payment_gateway/views.py

@@ -0,0 +1,33 @@
+from django.conf import settings
+from django.http import HttpRequest
+from django.http import HttpResponse
+from django.shortcuts import redirect
+
+from .models import InProgressPayment
+from ..transaction.models import Transaction
+
+
+def callback_view(request: HttpRequest, payment_id):
+    system_error = getattr(settings, "OFFSITE_PAYMENT_SYSTEM_ERROR", None)
+    payment_not_verified = getattr(settings, "OFFSITE_PAYMENT_NOT_VERIFIED", None)
+    payment_success = getattr(settings, "OFFSITE_PAYMENT_SUCCESS", None)
+    try:
+        processing_payment = InProgressPayment.objects.select_related('order', 'plugin_instance').get(pk=payment_id)
+        order = processing_payment.order
+        plugin_instance = processing_payment.plugin_instance
+        processing_payment.delete()
+        transaction = Transaction.objects.create(order=processing_payment.order)
+        plugin_implementation = plugin_instance.load_implementation()
+        if not plugin_implementation:
+            transaction.failed("Offsite payment gateway instance not found!")
+            return redirect(system_error) if system_error else "System Error: undefined payment gateway"
+        verified, details = plugin_implementation.verify_payment(order, request)
+        print(details)
+        if verified:
+            transaction.succeeded(details)
+            print('verified')
+            return redirect(payment_success) if payment_success else HttpResponse(status=200, content=details)
+        transaction.failed(details)
+        return redirect(payment_not_verified) if payment_not_verified else HttpResponse(status=403, content=details)
+    except InProgressPayment.DoesNotExist:
+        return redirect(system_error) if system_error else HttpResponse(status=404, content='payment not listed!')

django_commerce/order/admin.py

@@ -0,0 +1 @@
+# Register your models here.

django_commerce/order/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class OrderConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_commerce.order'

django_commerce/order/migrations/0001_initial.py

@@ -0,0 +1,47 @@
+# Generated by Django 6.0.4 on 2026-05-09 12:36
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = [
+        ("cart", "0001_initial"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="Order",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+                    ),
+                ),
+                (
+                    "status",
+                    models.IntegerField(
+                        choices=[
+                            (2, "Pending"),
+                            (3, "Processing"),
+                            (4, "Completed"),
+                            (5, "Canceled"),
+                        ],
+                        default=2,
+                    ),
+                ),
+                ("cart_items", models.ManyToManyField(to="cart.cartitem")),
+                (
+                    "user",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL
+                    ),
+                ),
+            ],
+        ),
+    ]

django_commerce/order/migrations/0002_remove_order_cart_items_order_cart_and_more.py

@@ -0,0 +1,50 @@
+# Generated by Django 6.0.4 on 2026-06-23 12:06
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("cart", "0002_cart_active_cartitem__final_price_cartitem_active_and_more"),
+        ("order", "0001_initial"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.RemoveField(
+            model_name="order",
+            name="cart_items",
+        ),
+        migrations.AddField(
+            model_name="order",
+            name="cart",
+            field=models.ForeignKey(
+                null=True, on_delete=django.db.models.deletion.PROTECT, to="cart.cart"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="order",
+            name="status",
+            field=models.IntegerField(
+                choices=[
+                    (0, "Draft"),
+                    (1, "Processing"),
+                    (2, "Pending"),
+                    (3, "Paid"),
+                    (4, "Completed"),
+                    (5, "Canceled"),
+                ],
+                default=0,
+            ),
+        ),
+        migrations.AlterField(
+            model_name="order",
+            name="user",
+            field=models.ForeignKey(
+                null=True, on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL
+            ),
+        ),
+    ]

django_commerce/order/models.py

@@ -0,0 +1,84 @@
+from dataclasses import dataclass
+from typing import Dict
+
+from django.conf import settings
+from django.contrib.auth.models import User
+from django.db import models
+from django_plugin_system import BasePluginItem
+from django_plugin_system.models import PluginType
+
+from .signals import order_payment_completed, order_payment_failed, order_canceled
+from ..cart.models import Cart
+from ..payment.plugins import PaymentPlugin
+
+
+class OrderState(models.IntegerChoices):
+    DRAFT = 0
+    PROCESSING = 1
+    PENDING = 2
+    PAID = 3
+    COMPLETED = 4
+    CANCELED = 5
+
+IN_PROGRESS_ORDERS = [OrderState.DRAFT, OrderState.PROCESSING, OrderState.PENDING]
+
+@dataclass
+class EmptyOrderException(Exception):
+    message: str = "The empty order can not be paid."
+
+@dataclass
+class NoPaymentPluginException(Exception):
+    message: str = "No payment plugin is available."
+
+
+class Order(models.Model):
+    User = settings.AUTH_USER_MODEL
+
+    cart = models.ForeignKey(Cart, on_delete=models.PROTECT, null=True)
+    user = models.ForeignKey(User, on_delete=models.CASCADE, null=True)
+    status = models.IntegerField(choices=OrderState, default=OrderState.DRAFT)
+
+    @property
+    def is_empty(self):
+        return self.cart.cart_items.count() == 0
+
+    @property
+    def total_price(self):
+        return self.cart.total
+
+    def do_payment(self, payment_plugin: BasePluginItem | None = None):
+        if self.is_empty:
+            raise EmptyOrderException()
+        if not payment_plugin:
+            payment_type = PluginType.get_plugin_type_by_class(PaymentPlugin)
+            payment_plugin_instance = payment_type.get_single_plugin()
+            if not payment_plugin_instance:
+                raise NoPaymentPluginException()
+            payment_plugin = payment_plugin_instance.load_implementation()
+        return payment_plugin.create_payment(self)
+
+
+    def order_paid_successfully(self, transaction_info: Dict):
+        self.cart.close_cart()
+        self.status = OrderState.PAID
+        self.save()
+        order_payment_completed.send(sender=self.__class__, order=self, info=transaction_info)
+
+    def order_payment_failed(self, transaction_info):
+        self.status = OrderState.PENDING
+        self.save()
+        order_payment_failed.send(sender=self.__class__, order=self, info=transaction_info)
+
+    def cancel_order(self):
+        self.status = OrderState.CANCELED
+        self.cart.close_cart()
+        self.save()
+        order_canceled.send(sender=self.__class__, order=self)
+
+    @staticmethod
+    def get_user_current_order(user: User):
+        try:
+            return Order.objects.get(user=user, status__in=IN_PROGRESS_ORDERS)
+        except Order.DoesNotExist:
+            cart = Cart.objects.create()
+            return Order.objects.create(user=user, cart=cart)

django_commerce/order/signals.py

@@ -0,0 +1,5 @@
+from django.dispatch import Signal
+
+order_payment_completed = Signal()
+order_payment_failed = Signal()
+order_canceled = Signal()

django_commerce/order/tests.py

@@ -0,0 +1 @@
+# Create your tests here.

django_commerce/order/views.py

@@ -0,0 +1 @@
+# Create your views here.

django_commerce/payment/admin.py

@@ -0,0 +1 @@
+# Register your models here.

django_commerce/payment/apps.py

@@ -0,0 +1,11 @@
+from django.apps import AppConfig
+from django_plugin_system import register_plugin_type
+
+
+class PaymentConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_commerce.payment'
+
+    def ready(self):
+        from .plugins import PaymentPlugin
+        register_plugin_type({"interface": PaymentPlugin})

django_commerce/payment/models.py

@@ -0,0 +1 @@
+

django_commerce/payment/plugins.py

@@ -0,0 +1,11 @@
+from abc import abstractmethod
+
+from django_plugin_system import BasePluginType
+
+
+class PaymentPlugin(BasePluginType):
+    name = 'payment'
+
+    @abstractmethod
+    def create_payment(self, order):
+        pass

django_commerce/payment/tests.py

@@ -0,0 +1 @@
+# Create your tests here.

django_commerce/payment/views.py

@@ -0,0 +1 @@
+# Create your views here.

django_commerce/product/admin.py

@@ -0,0 +1 @@
+# Register your models here.

django_commerce/product/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class ProductConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_commerce.product'

django_commerce/product/migrations/0001_initial.py

@@ -0,0 +1,21 @@
+# Generated by Django 6.0 on 2026-01-05 11:38
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='BaseProduct',
+            fields=[
+                ('squid', models.CharField(max_length=30, primary_key=True, serialize=False)),
+                ('name', models.CharField(max_length=30)),
+                ('price', models.DecimalField(decimal_places=2, max_digits=10)),
+            ],
+        ),
+    ]

django_commerce/product/models.py

@@ -0,0 +1,7 @@
+from django.db import models
+
+
+class BaseProduct(models.Model):
+    squid = models.CharField(max_length=30, primary_key=True)
+    name = models.CharField(max_length=30)
+    price = models.DecimalField(max_digits=20, decimal_places=2)

django_commerce/product/tests.py

@@ -0,0 +1 @@
+# Create your tests here.

django_commerce/product/views.py

@@ -0,0 +1 @@
+# Create your views here.

django_commerce/tests.py

@@ -0,0 +1 @@
+# Create your tests here.

django_commerce/transaction/admin.py

@@ -0,0 +1 @@
+# Register your models here.

django_commerce/transaction/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class TransactionConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_commerce.transaction'

django_commerce/transaction/migrations/0001_initial.py

@@ -0,0 +1,43 @@
+# Generated by Django 6.0.4 on 2026-05-09 12:37
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = [
+        ("django_plugin_system", "__first__"),
+        ("order", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="Transaction",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+                    ),
+                ),
+                ("tracing_code", models.CharField(max_length=100, null=True)),
+                ("result", models.TextField(null=True)),
+                ("success", models.BooleanField(default=False)),
+                (
+                    "order",
+                    models.ForeignKey(
+                        null=True, on_delete=django.db.models.deletion.PROTECT, to="order.order"
+                    ),
+                ),
+                (
+                    "plugin",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.PROTECT,
+                        to="django_plugin_system.pluginitem",
+                    ),
+                ),
+            ],
+        ),
+    ]

django_commerce/transaction/migrations/0002_remove_transaction_plugin_remove_transaction_result_and_more.py

@@ -0,0 +1,30 @@
+# Generated by Django 6.0.4 on 2026-06-23 12:06
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("transaction", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.RemoveField(
+            model_name="transaction",
+            name="plugin",
+        ),
+        migrations.RemoveField(
+            model_name="transaction",
+            name="result",
+        ),
+        migrations.RemoveField(
+            model_name="transaction",
+            name="tracing_code",
+        ),
+        migrations.AddField(
+            model_name="transaction",
+            name="info",
+            field=models.JSONField(null=True),
+        ),
+    ]

django_commerce/transaction/models.py

@@ -0,0 +1,19 @@
+from typing import Dict
+from django.db import models
+
+
+class Transaction(models.Model):
+    order = models.ForeignKey('order.Order', on_delete=models.PROTECT, null=True)
+    info = models.JSONField(null=True)
+    success = models.BooleanField(default=False)
+
+    def failed(self, reason: str | Dict):
+        self.info = reason if isinstance(reason, dict) else {"error": reason}
+        self.save()
+        self.order.order_payment_failed(self.info)
+
+    def succeeded(self, info: dict):
+        self.success = True
+        self.info = info
+        self.save()
+        self.order.order_paid_successfully(self.info)

django_commerce/transaction/tests.py

@@ -0,0 +1 @@
+# Create your tests here.

django_commerce/transaction/views.py

@@ -0,0 +1 @@
+# Create your views here.

django_commerce/views.py

@@ -0,0 +1 @@
+# Create your views here.

extensible_django_commerce-1.0.0.dist-info/METADATA

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: extensible-django-commerce
+Version: 1.0.0
+Summary: Basic yet highly extensible requirements for commerce in django.
+Author-email: Alireza Tabatabaeian <alireza.tabatabaeian@gmail.com>
+Project-URL: Homepage, https://github.com/Alireza-Tabatabaeian/django-commerce
+Project-URL: Issues, https://github.com/Alireza-Tabatabaeian/django-commerce/issues
+Keywords: django,commerce,cart,offsite payment gateway,extensibility
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: Django>=4.2
+Requires-Dist: django-plugin-system>=2.0.8
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-django>=4.8.0; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: django-stubs>=5.0.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: ruff>=0.5.0; extra == "dev"
+
+# Django Commerce
+
+A lightweight and extensible commerce foundation for Django projects.
+
+`django-commerce` provides reusable commerce primitives such as products, carts, orders, transactions, and pluggable offsite payment gateways — designed to integrate cleanly with modular Django architectures and plugin-based systems.
+
+This package is built on top of [django-plugin-system](https://github.com/Alireza-Tabatabaeian/django-plugin-system).
+
+CAUTION: The package has been changed signifactly and README does not guide well right now. Will be modified in near future.
+
+---
+
+# Features
+
+* Base product abstraction
+* Shopping cart system
+* Order management
+* Transaction tracking
+* Extensible offsite payment gateway architecture
+* Plugin-based payment providers
+* Designed for reusable Django applications
+
+---
+
+# Installation
+
+Install using pip:
+
+```bash
+pip install django-commerce
+```
+
+Add applications to your `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    ...
+
+    'django_plugin_system',
+
+    'django_commerce.product',
+    'django_commerce.cart',
+    'django_commerce.order',
+    'django_commerce.transaction',
+    'django_commerce.offsite_payment_gateway',
+]
+```
+
+Run migrations:
+
+```bash
+python manage.py migrate
+```
+
+---
+
+# Package Structure
+
+```text
+django_commerce/
+├── product/
+├── cart/
+├── order/
+├── transaction/
+└── offsite_payment_gateway/
+```
+
+---
+
+# Base Product
+
+The package provides a reusable `BaseProduct` model abstraction that can be extended in your own project.
+
+Example:
+
+```python
+from django.db import models
+from django_commerce.product.models import BaseProduct
+
+
+class Product(BaseProduct):
+    description = models.TextField()
+```
+
+---
+
+# Offsite Payment Gateway
+
+The package includes an abstract offsite payment gateway system that allows developers to integrate external payment providers such as:
+
+* Zarinpal
+* Stripe Checkout
+* PayPal
+* Mollie
+* Any redirect-based payment provider
+
+To create a custom gateway, extend `AbstractOffsitePaymentGateway`.
+
+---
+
+# Creating a Payment Gateway
+
+Example:
+
+```python
+from django.http import HttpRequest
+
+from django_commerce.offsite_payment_gateway.models import (
+    AbstractOffsitePaymentGateway
+)
+
+
+class ZarinpalGateway(AbstractOffsitePaymentGateway):
+    name = 'zarinpal'
+    _gateway_base_url = 'https://sandbox.zarinpal.com'
+
+    def get_payment_gateway(self, order):
+        transaction = self.create_transaction(order)
+
+        callback = self.callback_url(transaction)
+
+        return f'{self._gateway_base_url}/start/{transaction.id}?callback={callback}'
+
+    def verify_payment(self, transaction, callback_request: HttpRequest) -> bool:
+        authority = callback_request.GET.get('Authority')
+
+        if not authority:
+            return False
+
+        # Verify payment using provider API
+        # ...
+
+        transaction.is_verified = True
+        transaction.save()
+
+        return True
+```
+
+---
+
+# Registering Gateway Plugins
+
+Gateways are designed to work with the plugin system.
+
+Example registration:
+
+```python
+from django_plugin_system import register_plugin
+
+from .gateway import ZarinpalGateway
+
+
+register_plugin(
+    manager='django_commerce.offsite_payment_gateway',
+    title='Zarinpal Gateway',
+    plugin=ZarinpalGateway,
+)
+```
+
+---
+
+# Payment Callback View
+
+The package provides a callback endpoint handler for payment verification.
+
+Example URL configuration:
+
+```python
+from django.urls import path
+
+from django_commerce.offsite_payment_gateway.views import callback_view
+
+
+urlpatterns = [
+    path(
+        'payment-callback/<int:transaction_id>',
+        callback_view,
+        name='payment_callback'
+    ),
+]
+```
+
+After the payment provider redirects the user back to your application, the callback view:
+
+1. Loads the related transaction
+2. Resolves the payment gateway plugin
+3. Calls `verify_payment`
+4. Verifies and finalizes the transaction
+
+---
+
+# Transactions
+
+Each payment attempt creates a `Transaction` object associated with:
+
+* Order
+* Payment plugin
+* Verification state
+
+This makes payment tracking and auditing easier across multiple providers.
+
+---
+
+# Design Goals
+
+This package focuses on:
+
+* Reusability
+* Extensibility
+* Minimal assumptions
+* Plugin-oriented architecture
+* Separation of concerns
+
+It is intended to act as a commerce foundation rather than a complete e-commerce platform.
+
+---
+
+# Development
+
+Clone the repository:
+
+```bash
+git clone <repository-url>
+```
+
+Install in editable mode:
+
+```bash
+pip install -e .
+```
+
+Run migrations from the development project:
+
+```bash
+python manage.py migrate
+```
+
+---
+
+# License
+
+MIT License

extensible_django_commerce-1.0.0.dist-info/RECORD

@@ -0,0 +1,64 @@
+django_commerce/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_commerce/admin.py,sha256=xZHn9b5u2_7bD6Q48FnN0WiRPjEbE9c9dIm4aIe1M34,30
+django_commerce/apps.py,sha256=XvsQ2GOZ_MEMfNABRVnlCB5Ppob3QjPrAwcqikSri40,167
+django_commerce/models.py,sha256=26UWatnbm6ZIwQMuu9NNzQ0IW1ACO4Oe9caModuTpWM,4
+django_commerce/tests.py,sha256=p1bwJbR_nFqJjyfOygNEO5nXSrU3Ku0A3g2O8oZ74c0,27
+django_commerce/views.py,sha256=gQmOOQQgt5SMeC_hOzhacKuRPDLbcVfNqURLhP0M1U4,27
+django_commerce/cart/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_commerce/cart/admin.py,sha256=xZHn9b5u2_7bD6Q48FnN0WiRPjEbE9c9dIm4aIe1M34,30
+django_commerce/cart/apps.py,sha256=IMwEVY-k_7sSmTeaNRBH9xe87lm6DbiuAn0cCHEnK8Y,162
+django_commerce/cart/models.py,sha256=udeUsZSshq9DabTkLgYLim13w6POULUXAhuxWbb17e4,2631
+django_commerce/cart/tests.py,sha256=p1bwJbR_nFqJjyfOygNEO5nXSrU3Ku0A3g2O8oZ74c0,27
+django_commerce/cart/views.py,sha256=gQmOOQQgt5SMeC_hOzhacKuRPDLbcVfNqURLhP0M1U4,27
+django_commerce/cart/migrations/0001_initial.py,sha256=A7k5pJHO9a3zfhSfNmOYhdgS5BxX0RxAEMFn3H90ePU,1673
+django_commerce/cart/migrations/0002_cart_active_cartitem__final_price_cartitem_active_and_more.py,sha256=xaqDBmGEsBt292yJtaU8YhSdphSZebH9MJfQcniP5Es,1066
+django_commerce/cart/migrations/0003_remove_cart_user.py,sha256=xUljWXDgzH5qoCrBYzY3IVfD2DzNnuiN4siG21O1KaM,378
+django_commerce/cart/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_commerce/offsite_payment_gateway/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_commerce/offsite_payment_gateway/admin.py,sha256=xZHn9b5u2_7bD6Q48FnN0WiRPjEbE9c9dIm4aIe1M34,30
+django_commerce/offsite_payment_gateway/apps.py,sha256=rZACkIqhQsCMbduKHy94mE3-oZtgC7J0_iOVVnaaTRo,382
+django_commerce/offsite_payment_gateway/models.py,sha256=SMNzNL3xTLtAWj__WMpDAaUm-xdKXwI4MOEOKk2JUMk,285
+django_commerce/offsite_payment_gateway/plugins.py,sha256=sekOT8w1cWHrI-kLJWLst11IhWmHY5Rad4Z2qjoZS3A,1245
+django_commerce/offsite_payment_gateway/tests.py,sha256=p1bwJbR_nFqJjyfOygNEO5nXSrU3Ku0A3g2O8oZ74c0,27
+django_commerce/offsite_payment_gateway/urls.py,sha256=HQLnfMXzppG92EL-gBKvICYqFLUic5h1ogJw0Snqrl0,176
+django_commerce/offsite_payment_gateway/views.py,sha256=F-InU5jNGSc4UWi53tFo4bG0vjOMkS-KCghn7BkwxUc,1803
+django_commerce/offsite_payment_gateway/migrations/0001_initial.py,sha256=ftRQyPIdrIHa62DF4Y4CXX_C3tTUzydsf14y1txrinA,1227
+django_commerce/offsite_payment_gateway/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_commerce/order/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_commerce/order/admin.py,sha256=xZHn9b5u2_7bD6Q48FnN0WiRPjEbE9c9dIm4aIe1M34,30
+django_commerce/order/apps.py,sha256=yyuB6wNl-xJryEMIjSwNcaYmaU34DQ0S0eXUUXNqH_g,164
+django_commerce/order/models.py,sha256=oLMsEWtaS-OCkkv0er9sLsIgDG0Ie7kltuIF_w7POQg,2864
+django_commerce/order/signals.py,sha256=QCijQSfLYqBDnT50ffUZc1pUnF9jQreSBd7zYMxe3BU,134
+django_commerce/order/tests.py,sha256=p1bwJbR_nFqJjyfOygNEO5nXSrU3Ku0A3g2O8oZ74c0,27
+django_commerce/order/views.py,sha256=gQmOOQQgt5SMeC_hOzhacKuRPDLbcVfNqURLhP0M1U4,27
+django_commerce/order/migrations/0001_initial.py,sha256=t-eptwLQ3iIYQVP9ZOqu5b8JWar06kVwi4iuY2z8-Kg,1455
+django_commerce/order/migrations/0002_remove_order_cart_items_order_cart_and_more.py,sha256=GqZdHE6k4YGrntKxIHTu8cwftPc0T3P8Eqe9A1sR5bU,1525
+django_commerce/order/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_commerce/payment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_commerce/payment/admin.py,sha256=xZHn9b5u2_7bD6Q48FnN0WiRPjEbE9c9dIm4aIe1M34,30
+django_commerce/payment/apps.py,sha256=bfKVh3FXrReVzEdTjgeVnjRYevvUXDebK6yN3hqwjBI,351
+django_commerce/payment/models.py,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+django_commerce/payment/plugins.py,sha256=w-7bmkzEf0i4Et3hhxsaO3ndgGMS43EAY3p2AsCiBWo,222
+django_commerce/payment/tests.py,sha256=p1bwJbR_nFqJjyfOygNEO5nXSrU3Ku0A3g2O8oZ74c0,27
+django_commerce/payment/views.py,sha256=gQmOOQQgt5SMeC_hOzhacKuRPDLbcVfNqURLhP0M1U4,27
+django_commerce/product/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_commerce/product/admin.py,sha256=xZHn9b5u2_7bD6Q48FnN0WiRPjEbE9c9dIm4aIe1M34,30
+django_commerce/product/apps.py,sha256=ewryYz-X52DG8eK3u1TUJj4wR8JxUIdnBYxhk1qN6W0,168
+django_commerce/product/models.py,sha256=qmtFw3PZF88dMCRmO_Eh-YSOfqp8osCMQ27VMyTr-A0,241
+django_commerce/product/tests.py,sha256=p1bwJbR_nFqJjyfOygNEO5nXSrU3Ku0A3g2O8oZ74c0,27
+django_commerce/product/views.py,sha256=gQmOOQQgt5SMeC_hOzhacKuRPDLbcVfNqURLhP0M1U4,27
+django_commerce/product/migrations/0001_initial.py,sha256=CT82hdrg3EQ31pxfGcJNW5n7OGzXCjO7OtCzLlDqtOY,569
+django_commerce/product/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_commerce/transaction/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_commerce/transaction/admin.py,sha256=xZHn9b5u2_7bD6Q48FnN0WiRPjEbE9c9dIm4aIe1M34,30
+django_commerce/transaction/apps.py,sha256=5LoPgmNyQWD6-YE3MwkKLGxDiafbbLglfVxeS8KVloA,176
+django_commerce/transaction/models.py,sha256=PeztXfrNt25KnkoH3mInc4fx7qcoP9AsW4pu_MwV7nE,634
+django_commerce/transaction/tests.py,sha256=p1bwJbR_nFqJjyfOygNEO5nXSrU3Ku0A3g2O8oZ74c0,27
+django_commerce/transaction/views.py,sha256=gQmOOQQgt5SMeC_hOzhacKuRPDLbcVfNqURLhP0M1U4,27
+django_commerce/transaction/migrations/0001_initial.py,sha256=M8TCDrNQMBMuCm1-Wz3ASBp900cI6MUXZVkexuuhzYk,1382
+django_commerce/transaction/migrations/0002_remove_transaction_plugin_remove_transaction_result_and_more.py,sha256=1gDFNl8mSrekG1VUxagQtXCZ9Aw_L6DPz__-1jArNls,736
+django_commerce/transaction/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+extensible_django_commerce-1.0.0.dist-info/METADATA,sha256=naPWReJ6hFeX3oZ_zUSVy8kX4-GvqOYEl8_qeq_PAnQ,6425
+extensible_django_commerce-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+extensible_django_commerce-1.0.0.dist-info/top_level.txt,sha256=WO2yqDsJXl5hv5hRu4jwb8ZKtiRewlW-athKvDtKGfI,16
+extensible_django_commerce-1.0.0.dist-info/RECORD,,

extensible_django_commerce-1.0.0.dist-info/WHEEL

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

extensible_django_commerce-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+django_commerce