django-nepkit 0.1.0__py3-none-any.whl

django_nepkit/static/django_nepkit/css/admin-nepali-datepicker.css

@@ -0,0 +1,37 @@
+.ndp-container.ndp-dark{
+  background:#1f2937; /* slate-800-ish */
+  color:#e5e7eb;
+  border:1px solid rgba(255,255,255,.12);
+  box-shadow:0 10px 25px rgba(0,0,0,.45);
+}
+
+.ndp-container.ndp-dark .ndp-header{
+  border-bottom:1px solid rgba(255,255,255,.12);
+}
+
+.ndp-container.ndp-dark .ndp-header .ndp-header-link{
+  color:#e5e7eb;
+}
+
+.ndp-container.ndp-dark .ndc-nav-button:hover,
+.ndp-container.ndp-dark .ndp-header-link:hover,
+.ndp-container.ndp-dark .ndp-table td:hover{
+  background:rgba(255,255,255,.08);
+}
+
+.ndp-container.ndp-dark .ndp-table th{
+  color:rgba(229,231,235,.75);
+}
+
+.ndp-container.ndp-dark .ndp-table td{
+  color:#e5e7eb;
+}
+
+.ndp-container.ndp-dark .ndp-table td.ndp-selected{
+  background:#2563eb; /* blue-600 */
+  color:#fff;
+}
+
+.ndp-container.ndp-dark .ndp-table td.ndp-today{
+  color:#93c5fd; /* blue-300 */
+}

django_nepkit/static/django_nepkit/js/address-chaining.js

@@ -0,0 +1,64 @@
+(function() {
+    'use strict';
+
+    function updateOptions(selectElement, data, placeholder) {
+        selectElement.innerHTML = '';
+        if (placeholder) {
+            const opt = document.createElement('option');
+            opt.value = '';
+            opt.textContent = placeholder;
+            selectElement.appendChild(opt);
+        }
+        data.forEach(item => {
+            const opt = document.createElement('option');
+            opt.value = item.id;
+            opt.textContent = item.text;
+            selectElement.appendChild(opt);
+        });
+        selectElement.dispatchEvent(new Event('change'));
+    }
+
+    document.addEventListener('change', function(e) {
+        if (e.target.matches('.nepkit-province-select')) {
+            const province = e.target.value;
+            const container = e.target.closest('form') || document;
+            const districtSelect = container.querySelector('.nepkit-district-select');
+            const municipalitySelect = container.querySelector('.nepkit-municipality-select');
+
+            if (districtSelect) {
+                if (!province) {
+                    updateOptions(districtSelect, [], 'Select District');
+                    if (municipalitySelect) updateOptions(municipalitySelect, [], 'Select Municipality');
+                    return;
+                }
+
+                const url = districtSelect.dataset.url + '?province=' + encodeURIComponent(province);
+                fetch(url)
+                    .then(response => response.json())
+                    .then(data => {
+                        updateOptions(districtSelect, data, 'Select District');
+                    });
+            }
+        }
+
+        if (e.target.matches('.nepkit-district-select')) {
+            const district = e.target.value;
+            const container = e.target.closest('form') || document;
+            const municipalitySelect = container.querySelector('.nepkit-municipality-select');
+
+            if (municipalitySelect) {
+                if (!district) {
+                    updateOptions(municipalitySelect, [], 'Select Municipality');
+                    return;
+                }
+
+                const url = municipalitySelect.dataset.url + '?district=' + encodeURIComponent(district);
+                fetch(url)
+                    .then(response => response.json())
+                    .then(data => {
+                        updateOptions(municipalitySelect, data, 'Select Municipality');
+                    });
+            }
+        }
+    });
+})();

django_nepkit/static/django_nepkit/js/admin-jquery-bridge.js

@@ -0,0 +1,10 @@
+(function () {
+  "use strict";
+
+  // Django admin exposes jQuery as `django.jQuery`.
+  // Many third-party plugins expect `window.jQuery`/`window.$`.
+  if (typeof window !== "undefined" && window.django && window.django.jQuery) {
+    window.jQuery = window.django.jQuery;
+    window.$ = window.django.jQuery;
+  }
+})();

django_nepkit/static/django_nepkit/js/nepali-datepicker-init.js

@@ -0,0 +1,108 @@
+(function () {
+    'use strict';
+
+    function isDarkTheme() {
+        var docEl = document.documentElement;
+        var body = document.body;
+
+        // Common theme markers used by Django admin themes / dark-mode packages
+        var markers = [
+            docEl && docEl.getAttribute('data-theme'),
+            docEl && docEl.getAttribute('data-color-scheme'),
+            body && body.getAttribute('data-theme'),
+            body && body.getAttribute('data-color-scheme')
+        ].filter(Boolean).join(' ').toLowerCase();
+
+        var classNames = [
+            docEl && docEl.className,
+            body && body.className
+        ].filter(Boolean).join(' ').toLowerCase();
+
+        if (markers.indexOf('dark') !== -1 || classNames.indexOf('dark') !== -1) return true;
+
+        // Fallback to OS preference
+        try {
+            return window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
+        } catch (e) {
+            return false;
+        }
+    }
+
+    function applyThemeToDatepickerContainers() {
+        var dark = isDarkTheme();
+        var containers = document.querySelectorAll('.ndp-container');
+        if (!containers || !containers.length) return;
+
+        containers.forEach(function (c) {
+            c.classList.remove('ndp-dark');
+            c.classList.remove('ndp-light');
+            c.classList.add(dark ? 'ndp-dark' : 'ndp-light');
+        });
+    }
+
+    function initNepaliDatePickers() {
+        var inputs = document.querySelectorAll('.nepkit-datepicker:not(.nepali-datepicker-initialized)');
+        if (!inputs || !inputs.length) return;
+
+        inputs.forEach(function (el) {
+            // Nepali Datepicker v5 exposes `element.NepaliDatePicker(options)`
+            if (typeof el.NepaliDatePicker === 'function') {
+                el.NepaliDatePicker({
+                    dateFormat: 'YYYY-MM-DD'
+                });
+                el.classList.add('nepali-datepicker-initialized');
+
+                // Ensure theme is applied when the picker is actually shown.
+                // (The plugin often creates/inserts DOM on focus.)
+                var applySoon = function () {
+                    // Run twice: once immediately, once after paint.
+                    applyThemeToDatepickerContainers();
+                    window.setTimeout(applyThemeToDatepickerContainers, 0);
+                };
+
+                el.addEventListener('focus', applySoon);
+                el.addEventListener('click', applySoon);
+            }
+        });
+    }
+
+    // Initialize on page load
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', initNepaliDatePickers);
+    } else {
+        initNepaliDatePickers();
+    }
+
+    // Keep in sync if system theme changes (fallback path)
+    if (window.matchMedia) {
+        try {
+            var mql = window.matchMedia('(prefers-color-scheme: dark)');
+            if (mql && typeof mql.addEventListener === 'function') {
+                mql.addEventListener('change', applyThemeToDatepickerContainers);
+            } else if (mql && typeof mql.addListener === 'function') {
+                mql.addListener(applyThemeToDatepickerContainers);
+            }
+        } catch (e) {
+            // ignore
+        }
+    }
+
+    // Re-initialize when Django admin adds inlines dynamically
+    if (typeof django !== 'undefined' && django.jQuery) {
+        django.jQuery(document).on('formset:added', function () {
+            initNepaliDatePickers();
+        });
+    }
+
+    // Also listen for DOM changes (admin popups/other dynamic content)
+    if (typeof MutationObserver !== 'undefined') {
+        var observer = new MutationObserver(function () {
+            initNepaliDatePickers();
+            applyThemeToDatepickerContainers();
+        });
+        observer.observe(document.body, {
+            childList: true,
+            subtree: true
+        });
+    }
+})();

django_nepkit/templatetags/nepali.py

@@ -0,0 +1,74 @@
+from django import template
+from nepali.datetime import nepalidate, nepalihumanize
+from nepali.number import nepalinumber
+import datetime
+
+register = template.Library()
+
+
+def _coerce_ad_date_to_bs(value):
+    """
+    Internal helper: if value is AD date/datetime, convert to `nepalidate`.
+    Does NOT attempt to parse strings (keeps template behavior minimal).
+    """
+    if isinstance(value, (datetime.datetime, datetime.date)):
+        return nepalidate.from_date(value)
+    return value
+
+
+@register.filter
+def nepali_date(value, format_str="%Y-%m-%d"):
+    """
+    Formats a date or datetime object into a Nepali date string.
+    """
+    if value is None:
+        return ""
+
+    value = _coerce_ad_date_to_bs(value)
+
+    if hasattr(value, "strftime"):
+        return value.strftime(format_str)
+    return value
+
+
+@register.filter
+def nepali_date_ne(value, format_str="%Y-%m-%d"):
+    """
+    Formats a date or datetime object into a Nepali date string (Devanagari).
+    """
+    if value is None:
+        return ""
+
+    value = _coerce_ad_date_to_bs(value)
+
+    if hasattr(value, "strftime_ne"):
+        return value.strftime_ne(format_str)
+    return value
+
+
+@register.filter
+def nepali_number(value):
+    """
+    Converts a number to Devanagari.
+    """
+    if value is None:
+        return ""
+    return nepalinumber(value).str_ne()
+
+
+@register.filter
+def nepali_humanize(value, threshold=None, format_str=None):
+    """
+    Returns a human-readable "time ago" string in Nepali.
+    """
+    if value is None:
+        return ""
+
+    # Threshold and format_str are optional
+    kwargs = {}
+    if threshold:
+        kwargs["threshold"] = threshold
+    if format_str:
+        kwargs["format"] = format_str
+
+    return nepalihumanize(value, **kwargs)

django_nepkit/urls.py

@@ -0,0 +1,10 @@
+from django.urls import path
+
+from django_nepkit.views import district_list_view, municipality_list_view
+
+app_name = "django_nepkit"
+
+urlpatterns = [
+    path("districts/", district_list_view, name="district-list"),
+    path("municipalities/", municipality_list_view, name="municipality-list"),
+]

django_nepkit/utils.py

@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from nepali.datetime import nepalidate, nepalidatetime
+
+
+BS_DATE_FORMAT = "%Y-%m-%d"
+BS_DATETIME_FORMAT = "%Y-%m-%d %H:%M:%S"
+
+
+def try_parse_nepali_date(value: Any) -> Optional[nepalidate]:
+    """
+    Best-effort conversion to `nepalidate`.
+
+    - Returns `None` for empty values.
+    - Returns `nepalidate` for valid inputs.
+    - Returns `None` if the value cannot be parsed.
+
+    Callers decide whether to raise, fallback, etc.
+    """
+    if value in (None, ""):
+        return None
+    if isinstance(value, nepalidate):
+        return value
+    if isinstance(value, str):
+        try:
+            return nepalidate.strptime(value.strip(), BS_DATE_FORMAT)
+        except Exception:
+            return None
+    return None
+
+
+def try_parse_nepali_datetime(value: Any) -> Optional[nepalidatetime]:
+    """
+    Best-effort conversion to `nepalidatetime`.
+
+    - Returns `None` for empty values.
+    - Returns `nepalidatetime` for valid inputs.
+    - Returns `None` if the value cannot be parsed.
+
+    Callers decide whether to raise, fallback, etc.
+    """
+    if value in (None, ""):
+        return None
+    if isinstance(value, nepalidatetime):
+        return value
+    if isinstance(value, str):
+        try:
+            return nepalidatetime.strptime(value.strip(), BS_DATETIME_FORMAT)
+        except Exception:
+            return None
+    return None
+
+
+def get_districts_by_province(province_name):
+    """
+    Returns a list of districts in the given province.
+    """
+    from nepali.locations import provinces
+
+    selected_province = next((p for p in provinces if p.name == province_name), None)
+    if not selected_province:
+        return []
+    return [{"id": d.name, "text": d.name} for d in selected_province.districts]
+
+
+def get_municipalities_by_district(district_name):
+    """
+    Returns a list of municipalities in the given district.
+    """
+    from nepali.locations import districts
+
+    selected_district = next((d for d in districts if d.name == district_name), None)
+    if not selected_district:
+        return []
+    return [{"id": m.name, "text": m.name} for m in selected_district.municipalities]

django_nepkit/validators.py

@@ -0,0 +1,12 @@
+from django.core.exceptions import ValidationError
+from django.utils.translation import gettext_lazy as _
+from nepali import phone_number
+
+
+# validates the given value is a valid nepali phone number
+def validate_nepali_phone_number(value):
+    if not phone_number.is_valid(value):
+        raise ValidationError(
+            _("%(value)s is not a valid nepali phone number"),
+            params={"value": value},
+        )

django_nepkit/views.py

@@ -0,0 +1,22 @@
+from django.http import JsonResponse
+
+from django_nepkit.utils import (
+    get_districts_by_province,
+    get_municipalities_by_district,
+)
+
+
+def district_list_view(request):
+    province = request.GET.get("province")
+    if not province:
+        return JsonResponse([], safe=False)
+    data = get_districts_by_province(province)
+    return JsonResponse(data, safe=False)
+
+
+def municipality_list_view(request):
+    district = request.GET.get("district")
+    if not district:
+        return JsonResponse([], safe=False)
+    data = get_municipalities_by_district(district)
+    return JsonResponse(data, safe=False)

django_nepkit/widgets.py

@@ -0,0 +1,72 @@
+from django import forms
+from django.urls import reverse_lazy
+
+
+def _append_css_class(attrs, class_name: str):
+    """
+    Django-idiomatic helper to append a CSS class without clobbering existing ones.
+    """
+    existing = (attrs.get("class") or "").strip()
+    attrs["class"] = (f"{existing} {class_name}").strip() if existing else class_name
+    return attrs
+
+
+class ChainedSelectWidget(forms.Select):
+    class Media:
+        js = ("django_nepkit/js/address-chaining.js",)
+
+
+class ProvinceSelectWidget(ChainedSelectWidget):
+    def __init__(self, *args, **kwargs):
+        attrs = kwargs.get("attrs", {})
+        _append_css_class(attrs, "nepkit-province-select")
+        kwargs["attrs"] = attrs
+        super().__init__(*args, **kwargs)
+
+
+class DistrictSelectWidget(ChainedSelectWidget):
+    def __init__(self, *args, **kwargs):
+        attrs = kwargs.get("attrs", {})
+        _append_css_class(attrs, "nepkit-district-select")
+        attrs["data-url"] = reverse_lazy("django_nepkit:district-list")
+        kwargs["attrs"] = attrs
+        super().__init__(*args, **kwargs)
+
+
+class MunicipalitySelectWidget(ChainedSelectWidget):
+    def __init__(self, *args, **kwargs):
+        attrs = kwargs.get("attrs", {})
+        _append_css_class(attrs, "nepkit-municipality-select")
+        attrs["data-url"] = reverse_lazy("django_nepkit:municipality-list")
+        kwargs["attrs"] = attrs
+        super().__init__(*args, **kwargs)
+
+
+class NepaliDatePickerWidget(forms.TextInput):
+    input_type = "text"
+
+    class Media:
+        css = {
+            "all": (
+                "https://unpkg.com/nepali-date-picker@2.0.2/dist/nepaliDatePicker.min.css",
+            )
+        }
+        js = (
+            "https://code.jquery.com/jquery-3.5.1.slim.min.js",
+            "https://unpkg.com/nepali-date-picker@2.0.2/dist/nepaliDatePicker.min.js",
+            "django_nepkit/js/nepali-datepicker-init.js",
+        )
+
+    def __init__(self, *args, **kwargs):
+        attrs = kwargs.get("attrs", {})
+        # Ensure we don't have vDateField class which triggers Django admin calendar
+        classes = attrs.get("class", "")
+        if "vDateField" in classes:
+            classes = classes.replace("vDateField", "")
+
+        attrs["class"] = (classes or "").strip()
+        _append_css_class(attrs, "nepkit-datepicker")
+        attrs["autocomplete"] = "off"
+        attrs["placeholder"] = "YYYY-MM-DD"
+        kwargs["attrs"] = attrs
+        super().__init__(*args, **kwargs)