Currency System

from django_cfg import DjangoConfig, CurrencyConfig
 
class MyConfig(DjangoConfig):
    # Minimal config - uses sensible defaults
    currency = CurrencyConfig(
        enabled=True,
        update_interval=3600,  # Update rates every hour
    )

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

from django_cfg.apps.tools.currency.models import CurrencyRate
 
# Get rate
rate = CurrencyRate.get_rate("KRW", "USD")
# Returns: CurrencyRate(base="KRW", quote="USD", rate=0.000678)
 
# Get rate value
value = CurrencyRate.get_rate_value("KRW", "USD")
# Returns: Decimal("0.000678")

from django_cfg.modules.django_admin.base import PydanticAdmin
 
@admin.register(Vehicle)
class VehicleAdmin(PydanticAdmin):
    config = vehicle_config

from django_cfg.modules.django_admin import MoneyFieldDisplay
 
display_fields = [
    # Auto-detects: price_currency, price_target, price_rate, price_rate_at
    MoneyFieldDisplay(
        name="price",
        title="Price",
    ),
]
# Renders: ₩50,000,000 → $33,900

Django startup
    ↓
Background thread spawned (non-blocking)
    ↓
sync_currencies_if_needed() → adds missing currencies
    ↓
update_rates_if_needed() → updates stale rates

# Update rates only
python manage.py update_currency_rates
 
# Sync currencies + rates
python manage.py update_currency_rates --all
 
# Show statistics
python manage.py update_currency_rates --stats --verbose

# models.py
from django.db import models
from django_cfg.modules.django_currency import MoneyField
 
class Vehicle(models.Model):
    name = models.CharField(max_length=200)
    price = MoneyField(
        default_currency="KRW",
        target_currency="USD",
    )
 
# admin.py
from django.contrib import admin
from django_cfg.modules.django_admin import AdminConfig, MoneyFieldDisplay
from django_cfg.modules.django_admin.base import PydanticAdmin
 
config = AdminConfig(
    model=Vehicle,
    list_display=["name", "price"],
    display_fields=[
        # Auto-detects: price_currency, price_target
        MoneyFieldDisplay(
            name="price",
            title="Price",
        ),
    ],
)
 
@admin.register(Vehicle)
class VehicleAdmin(PydanticAdmin):
    config = config