Currency Tool

from django_cfg import DjangoConfig, CurrencyConfig
 
class MyConfig(DjangoConfig):
    currency = CurrencyConfig(
        enabled=True,
        target_currency="USD",
        update_interval=3600,  # 1 hour
    )

from django.db import models
from django_cfg.modules.django_currency import MoneyField
 
class Property(models.Model):
    # Creates: price, price_currency, price_target (USD)
    price = MoneyField(
        max_digits=15,
        decimal_places=2,
        default_currency="IDR",
        target_currency="USD",
    )

property = Property.objects.get(id=1)
 
# Original price
print(property.price)           # 300000000 (IDR)
print(property.price_currency)  # "IDR"
 
# Auto-converted to USD
print(property.price_target)    # 18750.00 (USD)
 
# Formatted display
print(property.price_display)        # "Rp 300M"
print(property.price_target_display) # "$18,750"

from django_cfg.apps.tools.currency.services import annotate_converted_price
 
# Annotate queryset with USD prices
qs = annotate_converted_price(
    Property.objects.all(),
    price_field="price",
    currency_field="price_currency",
    target_currency="USD",
    annotation_name="price_usd",
)
 
# Now filter/sort by converted price
affordable = qs.filter(price_usd__lte=50000).order_by("price_usd")