feat: add Nepali currency support, number-to-words conversion, and REST API enhancements

- Implement NepaliCurrencyField for model-level currency handling.
- Add format_nepali_currency utility with Lakhs/Crores comma formatting and decimal support.
- Implement number_to_nepali_words and english_to_nepali_unicode helper functions.
- Add nepali_currency, nepali_words, and nepali_unicode template filters.
- Enhance REST API (DRF) support:
    - Added NepaliCurrencySerializerField for formatted currency output.
    - Added NepaliLocalizedSerializerMixin for automatic Devanagari field generation.
    - Added flexible NepaliCurrencyRangeFilter and NepaliDateRangeFilter.
- Integrated automatic currency formatting into NepaliModelAdmin.
- Expanded the example demo app with a Transaction model and updated filters.
- Added comprehensive unit tests for formatting, models, and API components.
- Updated documentation (README.md and todo.md) to reflect new features.
This commit is contained in:
sankalp committed 2026-01-30 20:06:39 +05:45
1 parent 12de34e354
commit c6301686cc
10 files changed
+295 -13

No files matched your search

+15 -3
View File
@@ -1,9 +1,13 @@
from rest_framework import serializers
from django_nepkit.serializers import NepaliDateSerializerField
from .models import Person, Citizen, AuditedPerson
from django_nepkit.serializers import (
NepaliDateSerializerField,
NepaliCurrencySerializerField,
NepaliLocalizedSerializerMixin,
)
from .models import Person, Citizen, AuditedPerson, Transaction
class PersonSerializer(serializers.ModelSerializer):
class PersonSerializer(NepaliLocalizedSerializerMixin, serializers.ModelSerializer):
birth_date = NepaliDateSerializerField()
class Meta:
@@ -11,6 +15,14 @@ class PersonSerializer(serializers.ModelSerializer):
fields = "__all__"
class TransactionSerializer(NepaliLocalizedSerializerMixin, serializers.ModelSerializer):
amount_formatted = NepaliCurrencySerializerField(source="amount")
class Meta:
model = Transaction
fields = ["id", "title", "amount", "amount_formatted", "date"]
class CitizenSerializer(serializers.ModelSerializer):
class Meta:
model = Citizen
+1
View File
@@ -8,6 +8,7 @@ router = DefaultRouter()
router.register("api/persons", views.PersonViewSet, basename="person-api")
router.register("api/citizens", views.CitizenViewSet, basename="citizen-api")
router.register("api/audited", views.AuditedPersonViewSet, basename="audited-api")
router.register("api/transactions", views.TransactionViewSet, basename="transaction-api")
urlpatterns = [
path("", views.person_list, name="person-list"),
+28 -1
View File
@@ -4,7 +4,18 @@ from rest_framework import viewsets, filters as drf_filters
from django_filters import rest_framework as django_filters
from django_nepkit.filters import NepaliDateYearFilter, NepaliDateMonthFilter
from .models import Person, Citizen, AuditedPerson, Transaction
from .serializers import PersonSerializer, CitizenSerializer, AuditedPersonSerializer
from .serializers import (
PersonSerializer,
CitizenSerializer,
AuditedPersonSerializer,
TransactionSerializer,
)
from django_nepkit.filters import (
NepaliDateYearFilter,
NepaliDateMonthFilter,
NepaliCurrencyRangeFilter,
NepaliDateRangeFilter,
)
class PersonForm(forms.ModelForm):
@@ -110,3 +121,19 @@ class AuditedPersonViewSet(viewsets.ModelViewSet):
filter_backends = [drf_filters.SearchFilter, drf_filters.OrderingFilter]
search_fields = ["name", "birth_date"]
ordering_fields = ["created_at"]
class TransactionViewSet(viewsets.ModelViewSet):
queryset = Transaction.objects.all()
serializer_class = TransactionSerializer
filter_backends = [django_filters.DjangoFilterBackend]
class TransactionFilter(django_filters.FilterSet):
amount_range = NepaliCurrencyRangeFilter(field_name="amount")
date_range = NepaliDateRangeFilter(field_name="date")
class Meta:
model = Transaction
fields = ["title", "amount", "date"]
filterset_class = TransactionFilter