django-npdatetime 0.1.0__py3-none-any.whl

django_npdatetime-0.1.0.dist-info/METADATA

@@ -0,0 +1,397 @@
+Metadata-Version: 2.4
+Name: django-npdatetime
+Version: 0.1.0
+Summary: Nepali Date Field and Date Picker Widget for Django
+Home-page: https://github.com/4mritGiri/npdatetime-rust
+Author: Amrit Giri
+Author-email: Amrit Giri <4mritgiri@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/4mritGiri/npdatetime-rust
+Project-URL: Documentation, https://github.com/4mritGiri/npdatetime-rust/tree/main/bindings/django
+Project-URL: Repository, https://github.com/4mritGiri/npdatetime-rust.git
+Project-URL: Bug Tracker, https://github.com/4mritGiri/npdatetime-rust/issues
+Keywords: django,nepali,bikram sambat,date picker,calendar
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 3.2
+Classifier: Framework :: Django :: 4.0
+Classifier: Framework :: Django :: 4.1
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=3.2
+Requires-Dist: npdatetime>=0.1.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Django NPDateTime
+
+**Nepali Date Field and Date Picker Widget for Django**
+
+A Django package that provides custom model fields, form fields, and a modern date picker widget for working with Nepali (Bikram Sambat) dates. Powered by the high-performance [npdatetime-rust](https://github.com/4mritGiri/npdatetime-rust) library.
+
+## Features
+
+✨ **Custom Model Fields** - `NepaliDateField` and `NepaliDateTimeField` for storing Nepali dates in your database
+
+🎨 **Beautiful Date Picker Widget** - Modern, responsive date picker with both BS and AD modes
+
+🌐 **Bilingual Support** - English and Nepali language options
+
+🔄 **Auto Conversion** - Seamless conversion between Bikram Sambat and Gregorian calendars
+
+📝 **Template Tags & Filters** - Rich template tags for date formatting and conversion
+
+⚡ **High Performance** - Built on Rust for maximum speed
+
+🎯 **Django Integration** - Works seamlessly with Django's forms and admin
+
+## For Developers
+
+If you're contributing to this package, the JavaScript/CSS files are synchronized from `../javascript/`. When you update the date picker:
+
+```bash
+# Run the build script to sync assets
+python build_assets.py
+# or
+./build_assets.sh
+```
+
+This copies:
+- `date_picker.js` → `static/npdatetime_django/js/date_picker.min.js`
+- `date_picker.css` → `static/npdatetime_django/css/date_picker.css`
+- `pkg/` → `static/npdatetime_django/js/pkg/`
+
+## Installation
+
+```bash
+pip install django-npdatetime
+```
+
+## Quick Start
+
+### 1. Add to INSTALLED_APPS
+
+```python
+# settings.py
+INSTALLED_APPS = [
+    ...
+    'npdatetime_django',
+    ...
+]
+```
+
+### 2. Use in Models
+
+```python
+from django.db import models
+from npdatetime_django import NepaliDateField
+
+class Person(models.Model):
+    name = models.CharField(max_length=100)
+    birth_date_bs = NepaliDateField()
+    
+    def __str__(self):
+        return f"{self.name} - {self.birth_date_bs}"
+```
+
+### 3. Use in Forms
+
+```python
+from django import forms
+from npdatetime_django import NepaliDateField, NepaliDatePickerWidget
+
+class PersonForm(forms.Form):
+    name = forms.CharField(max_length=100)
+    birth_date = NepaliDateField(
+        mode='BS',
+        language='np',
+        label='जन्म मिति'
+    )
+```
+
+### 4. Use Template Tags
+
+```django
+{% load nepali_date %}
+
+<p>Birth Date (BS): {{ person.birth_date_bs }}</p>
+<p>Birth Date (AD): {{ person.birth_date_bs|to_gregorian_date }}</p>
+<p>Today in BS: {% nepali_date_today %}</p>
+<p>Month: {{ 1|nepali_month_name:"np" }}</p>
+```
+
+## Usage Guide
+
+### Model Fields
+
+#### NepaliDateField
+
+Stores Nepali dates in `YYYY-MM-DD` format.
+
+```python
+from npdatetime_django.models import NepaliDateField
+
+class Event(models.Model):
+    event_name = models.CharField(max_length=200)
+    event_date_bs = NepaliDateField()
+```
+
+#### NepaliDateTimeField
+
+Stores Nepali dates with time in `YYYY-MM-DD HH:MM:SS` format.
+
+```python
+from npdatetime_django.models import NepaliDateTimeField
+
+class Meeting(models.Model):
+    title = models.CharField(max_length=200)
+    scheduled_at_bs = NepaliDateTimeField()
+```
+
+### Form Fields and Widgets
+
+#### Basic Date Picker
+
+```python
+from npdatetime_django.forms import NepaliDateField
+
+class PersonForm(forms.Form):
+    birth_date = NepaliDateField(
+        mode='BS',           # 'BS' or 'AD'
+        language='en',       # 'en' or 'np'
+    )
+```
+
+#### Advanced Configuration
+
+```python
+from npdatetime_django.widgets import NepaliDatePickerWidget
+
+class EventForm(forms.Form):
+    event_date = forms.CharField(
+        widget=NepaliDatePickerWidget(
+            mode='BS',
+            language='np',
+            theme='dark',
+            show_today_button=True,
+            show_clear_button=True,
+            min_date='2080-01-01',
+            max_date='2085-12-30',
+        )
+    )
+```
+
+#### Date Range Picker
+
+```python
+from npdatetime_django.forms import NepaliDateRangeField
+
+class ReportForm(forms.Form):
+    report_period = NepaliDateRangeField(
+        mode='BS',
+        language='np'
+    )
+    
+    def clean_report_period(self):
+        period = self.cleaned_data['report_period']
+        start_date, end_date = period.split(' to ')
+        # Process date range
+        return period
+```
+
+### Template Tags and Filters
+
+Load the template tag library:
+
+```django
+{% load nepali_date %}
+```
+
+#### Convert Gregorian to Nepali
+
+```django
+{{ gregorian_date|to_nepali_date }}
+{{ gregorian_date|to_nepali_date:"%Y/%m/%d" }}
+```
+
+#### Convert Nepali to Gregorian
+
+```django
+{{ nepali_date|to_gregorian_date }}
+{{ nepali_date|to_gregorian_date:"%d/%m/%Y" }}
+```
+
+#### Format Nepali Date
+
+```django
+{{ "2081-01-15"|format_nepali_date:"%Y/%m/%d" }}
+```
+
+#### Get Month Name
+
+```django
+{{ 1|nepali_month_name }}        {# Baisakh #}
+{{ 1|nepali_month_name:"np" }}   {# बैशाख #}
+```
+
+#### Convert to Nepali Numerals
+
+```django
+{{ 2081|to_nepali_number }}  {# २०८१ #}
+```
+
+#### Get Today's Date
+
+```django
+{% nepali_date_today %}
+{% nepali_date_today "%Y/%m/%d" %}
+```
+
+### Widget Options
+
+The `NepaliDatePickerWidget` accepts the following options:
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `mode` | str | `'BS'` | Calendar mode: `'BS'` or `'AD'` |
+| `language` | str | `'en'` | Interface language: `'en'` or `'np'` |
+| `theme` | str | `'auto'` | Color theme: `'auto'`, `'light'`, or `'dark'` |
+| `format` | str | `'%Y-%m-%d'` | Date format string |
+| `include_time` | bool | `False` | Include time picker |
+| `show_today_button` | bool | `True` | Show "Today" button |
+| `show_clear_button` | bool | `True` | Show "Clear" button |
+| `min_date` | str | `None` | Minimum selectable date |
+| `max_date` | str | `None` | Maximum selectable date |
+
+## Admin Integration
+
+The date picker automatically integrates with Django admin:
+
+```python
+from django.contrib import admin
+from .models import Person
+
+@admin.register(Person)
+class PersonAdmin(admin.ModelAdmin):
+    list_display = ['name', 'birth_date_bs']
+    fields = ['name', 'birth_date_bs']
+```
+
+## Examples
+
+### Complete Model Example
+
+```python
+from django.db import models
+from npdatetime_django.models import NepaliDateField, NepaliDateTimeField
+
+class Employee(models.Model):
+    name = models.CharField(max_length=100)
+    join_date_bs = NepaliDateField(help_text="Joining date in BS")
+    birth_date_bs = NepaliDateField(blank=True, null=True)
+    last_login_bs = NepaliDateTimeField(blank=True, null=True)
+    
+    class Meta:
+        ordering = ['-join_date_bs']
+    
+    def __str__(self):
+        return f"{self.name} (Joined: {self.join_date_bs})"
+```
+
+### ModelForm Example
+
+```python
+from django import forms
+from .models import Employee
+
+class EmployeeForm(forms.ModelForm):
+    class Meta:
+        model = Employee
+        fields = ['name', 'join_date_bs', 'birth_date_bs']
+        widgets = {
+            'join_date_bs': NepaliDatePickerWidget(
+                mode='BS',
+                language='np',
+                theme='light'
+            ),
+            'birth_date_bs': NepaliDatePickerWidget(
+                mode='BS',
+                language='np'
+            ),
+        }
+```
+
+### Template Example
+
+```django
+{% load nepali_date %}
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Employee Details</title>
+</head>
+<body>
+    <h1>{{ employee.name }}</h1>
+    
+    <div>
+        <strong>Join Date (BS):</strong> 
+        {{ employee.join_date_bs|format_nepali_date:"%Y/%m/%d" }}
+    </div>
+    
+    <div>
+        <strong>Join Date (AD):</strong> 
+        {{ employee.join_date_bs|to_gregorian_date:"%B %d, %Y" }}
+    </div>
+    
+    <div>
+        <strong>Birth Month:</strong>
+        {{ employee.birth_date_bs|slice:":7"|last|int|nepali_month_name:"np" }}
+    </div>
+</body>
+</html>
+```
+
+## Requirements
+
+- Python >= 3.8
+- Django >= 3.2
+- npdatetime >= 0.1.0
+
+## Browser Support
+
+- Chrome/Edge (latest)
+- Firefox (latest)
+- Safari (latest)
+- Mobile browsers (iOS Safari, Chrome Mobile)
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Credits
+
+Built on top of:
+- [npdatetime-rust](https://github.com/4mritGiri/npdatetime-rust) - High-performance Nepali datetime library
+
+## Support
+
+For bugs and feature requests, please open an issue on [GitHub](https://github.com/4mritGiri/npdatetime-rust/issues).

django_npdatetime-0.1.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+django_npdatetime-0.1.0.dist-info/licenses/LICENSE,sha256=gVuc3Mq5Di_4HysKLvqKlN9kI59DWllWt-iyKtoUxyo,1067
+npdatetime_django/__init__.py,sha256=tMrLAMIyg4MertUr_L7dBXsRGr9lC-JbVAJNf7Khd08,600
+npdatetime_django/apps.py,sha256=G00rkmxCLZU8LOZdHIhwUomReZn6LR-LsZsG6AK5wU8,402
+npdatetime_django/forms.py,sha256=Z_Gd9we317io_4GxeHiiHU6Y7F21BFXKIPSqYMJzRz4,7434
+npdatetime_django/models.py,sha256=dVtdN9dORk2ia2kFMkP1c_HPHbLXg0BkfZgenBRomlQ,6879
+npdatetime_django/utils.py,sha256=DLhOu-VR8JMGbprM0jIfD8b-5rMRpux9Uzfy8Gb39Hk,3662
+npdatetime_django/widgets.py,sha256=UnPn5GdOjPFBrIjZWH37AnIyIDOtGv1y7MDWG7Va5RU,5995
+npdatetime_django/static/npdatetime_django/css/date_picker.css,sha256=0enCHAXGDJz3Ob_ANCuY5srsvMxW0qCfs-BOqnexPc4,15513
+npdatetime_django/static/npdatetime_django/js/date_picker.min.js,sha256=cvHkuU_qDSyYAckJw69udgfsr8P0mHdvQUnV9dAXTDI,42410
+npdatetime_django/static/npdatetime_django/js/pkg/README.md,sha256=o-6pRdtzXlmbBcTy9qKv9dV9H_EogHl0R1SHrsddpa8,8436
+npdatetime_django/static/npdatetime_django/js/pkg/npdatetime_wasm.d.ts,sha256=R3n2IEm0gt2H1si12kizmRjz8Vsp8NRHNWcA9VvN3Z4,6895
+npdatetime_django/static/npdatetime_django/js/pkg/npdatetime_wasm.js,sha256=kIdYF9UnPAtxttIvq2ugTc0mumEt0sokTYgnteU8Tg0,26967
+npdatetime_django/static/npdatetime_django/js/pkg/npdatetime_wasm_bg.wasm,sha256=KqEmjA9ymYl25pD3CDVIO-kP8dF93cjugm_gUeS3-Mg,112951
+npdatetime_django/static/npdatetime_django/js/pkg/npdatetime_wasm_bg.wasm.d.ts,sha256=DuUkIhYBz9DGjE5ensvtezVwc5tO4UkTEgeMeXCS_aU,2236
+npdatetime_django/static/npdatetime_django/js/pkg/package.json,sha256=teJ3QvcNBDlwN4bOEeZrD1LGgDPL1EzO8OHcxnjdJps,285
+npdatetime_django/templates/npdatetime_django/widgets/date_picker.html,sha256=PpeqlRwTKwFY9ZU8LmsojM49F2DdQ5ufeiIKF_t_n-w,823
+npdatetime_django/templates/npdatetime_django/widgets/date_range.html,sha256=D7T4AZvm_MzKsU3Y_9Vi3wvcj-ykS0HZwcXKueQiIWQ,444
+npdatetime_django/templatetags/__init__.py,sha256=Q3mdMm9fnjF4_J8r-MZN-rh_xUEuvBu1E9gZgP8gLqI,7185
+npdatetime_django/templatetags/nepali_date.py,sha256=QxVZnMDkGMk5qZ3BMbxmG3zaUkFnhamoUN2YHv0ZT_Y,23
+django_npdatetime-0.1.0.dist-info/METADATA,sha256=yCsEqofMG-8lhh_sPbaHZOCUs877dA36PMO1UqgEMZo,9958
+django_npdatetime-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+django_npdatetime-0.1.0.dist-info/top_level.txt,sha256=rLaTmccDbdV7mqbq2Vexuw-LDuUy2giBrTCnSyoCKIM,18
+django_npdatetime-0.1.0.dist-info/RECORD,,

django_npdatetime-0.1.0.dist-info/WHEEL

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

django_npdatetime-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amrit Giri
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

django_npdatetime-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+npdatetime_django

npdatetime_django/__init__.py

@@ -0,0 +1,22 @@
+"""
+Django NPDateTime - Nepali Date Field and Picker for Django
+
+A Django package that provides Nepali (Bikram Sambat) date field and 
+a modern, feature-rich date picker widget powered by npdatetime-rust.
+"""
+
+__version__ = '0.1.0'
+__author__ = 'Amrit Giri'
+__email__ = 'amritgiri.dev@gmail.com'
+
+default_app_config = 'npdatetime_django.apps.NpdatetimeDjangoConfig'
+
+from .models import NepaliDateField
+from .forms import NepaliDateField as NepaliDateFormField
+from .widgets import NepaliDatePickerWidget
+
+__all__ = [
+    'NepaliDateField',
+    'NepaliDateFormField',
+    'NepaliDatePickerWidget',
+]

npdatetime_django/apps.py

@@ -0,0 +1,13 @@
+"""Django app configuration for npdatetime_django"""
+from django.apps import AppConfig
+
+
+class NpdatetimeDjangoConfig(AppConfig):
+    """Configuration for the npdatetime_django app"""
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'npdatetime_django'
+    verbose_name = 'Nepali DateTime for Django'
+    
+    def ready(self):
+        """Called when the app is ready"""
+        pass