django-npdatetime 0.1.0__tar.gz

django_npdatetime-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+# Django package build artifacts
+build/
+dist/
+*.egg-info/
+__pycache__/
+*.pyc
+*.pyo
+
+# Local development
+.venv/
+env/
+venv/
+.env
+
+# JavaScript build artifacts (copied via sync)
+npdatetime_django/static/npdatetime_django/js/pkg/
+npdatetime_django/static/npdatetime_django/js/date_picker.min.js
+npdatetime_django/static/npdatetime_django/css/date_picker.css

django_npdatetime-0.1.0/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to django-npdatetime will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-02-04
+
+### Added
+- Initial release of django-npdatetime
+- Custom model fields:
+  - `NepaliDateField` for storing Nepali dates
+  - `NepaliDateTimeField` for storing Nepali dates with time
+- Custom form fields:
+  - `NepaliDateField` with validation
+  - `NepaliDateTimeField` with validation
+  - `NepaliDateRangeField` for date ranges
+- Custom widgets:
+  - `NepaliDatePickerWidget` with rich features
+  - `NepaliDateRangeWidget` for selecting date ranges
+- Template tags and filters:
+  - `to_nepali_date` - Convert Gregorian to Nepali
+  - `to_gregorian_date` - Convert Nepali to Gregorian
+  - `format_nepali_date` - Format Nepali dates
+  - `nepali_month_name` - Get month names
+  - `to_nepali_number` - Convert to Nepali numerals
+  - `nepali_date_today` - Get today's Nepali date
+- Utility functions for date conversion and validation
+- Django admin integration
+- Bilingual support (English and Nepali)
+- Multiple theme support (auto, light, dark)
+- Comprehensive documentation and examples
+
+[Unreleased]: https://github.com/4mritGiri/npdatetime-rust/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/4mritGiri/npdatetime-rust/releases/tag/v0.1.0

django_npdatetime-0.1.0/DEVELOPER.md

@@ -0,0 +1,251 @@
+# Developer Guide - Django NPDateTime
+
+## For Package Maintainers
+
+### Project Structure
+
+The Django package lives in `bindings/django/` but depends on assets from `bindings/javascript/`:
+
+```
+npdatetime-rust/
+├── bindings/
+│   ├── javascript/              # Source of truth for UI
+│   │   ├── date_picker.js      # Main date picker
+│   │   ├── date_picker.css     # Styles
+│   │   └── pkg/                # WASM bindings
+│   │
+│   └── django/                 # Django package
+│       ├── build_assets.py     # Asset sync script ⭐
+│       ├── npdatetime_django/
+│       │   └── static/npdatetime_django/
+│       │       ├── js/
+│       │       │   ├── date_picker.min.js  # Copied from ../javascript/
+│       │       │   └── pkg/                # Copied from ../javascript/
+│       │       └── css/
+│       │           └── date_picker.css     # Copied from ../javascript/
+```
+
+## Important: Single Source of Truth
+
+**DO NOT edit files in `npdatetime_django/static/` directly!**
+
+These files are **copied** from `bindings/javascript/`. If you edit them directly, your changes will be overwritten.
+
+### Workflow When Updating JavaScript/CSS
+
+1. **Edit the source files** in `bindings/javascript/`:
+   - `date_picker.js`
+   - `date_picker.css`
+
+2. **Run the build script** to sync to Django:
+   ```bash
+   cd bindings/django
+   python3 build_assets.py
+   # or
+   ./build_assets.sh
+   ```
+
+3. **Test the Django package**:
+   ```bash
+   pip install -e .  # Install in development mode
+   # Test in a Django project
+   ```
+
+4. **Commit both locations** if needed:
+   ```bash
+   git add bindings/javascript/date_picker.js
+   git add bindings/django/npdatetime_django/static/npdatetime_django/js/date_picker.min.js
+   git commit -m "Update date picker UI"
+   ```
+
+## Build Assets Script
+
+### What It Does
+
+The `build_assets.py` script:
+- Copies `date_picker.js` → `static/npdatetime_django/js/date_picker.min.js`
+- Copies `date_picker.css` → `static/npdatetime_django/css/date_picker.css`
+- Copies `pkg/` directory → `static/npdatetime_django/js/pkg/`
+
+### When to Run It
+
+Run the build script whenever you:
+- Update the JavaScript date picker code
+- Update the CSS styles
+- Rebuild the WASM bindings
+- Before publishing a new version
+
+### Usage
+
+```bash
+# Python version (cross-platform)
+python3 build_assets.py
+
+# Bash version (Linux/Mac)
+./build_assets.sh
+```
+
+## Development Setup
+
+### 1. Install the Package in Development Mode
+
+```bash
+cd bindings/django
+pip install -e .
+```
+
+This creates a symlink so changes are reflected immediately.
+
+### 2. Create a Test Django Project
+
+```bash
+django-admin startproject testproject
+cd testproject
+
+# Add to settings.py
+INSTALLED_APPS = [
+    ...
+    'npdatetime_django',
+]
+
+# Create test app
+python manage.py startapp testapp
+```
+
+### 3. Test the Package
+
+Create test models, forms, and views using the package components.
+
+## Publishing Workflow
+
+### 1. Update Version
+
+Update version in:
+- `setup.py`
+- `pyproject.toml`
+- `npdatetime_django/__init__.py`
+- `CHANGELOG.md`
+
+### 2. Build Assets
+
+```bash
+python3 build_assets.py
+```
+
+### 3. Build Package
+
+```bash
+python setup.py sdist bdist_wheel
+```
+
+### 4. Test on TestPyPI (Optional)
+
+```bash
+pip install twine
+twine upload --repository testpypi dist/*
+```
+
+### 5. Publish to PyPI
+
+```bash
+twine upload dist/*
+```
+
+## Common Tasks
+
+### Update JavaScript Only
+
+```bash
+# 1. Edit bindings/javascript/date_picker.js
+# 2. Run build script
+cd bindings/django
+python3 build_assets.py
+```
+
+### Update WASM Bindings
+
+```bash
+# 1. Rebuild WASM
+cd bindings/javascript
+wasm-pack build
+
+# 2. Sync to Django
+cd ../django
+python3 build_assets.py
+```
+
+### Update CSS Styles
+
+```bash
+# 1. Edit bindings/javascript/date_picker.css
+# 2. Run build script
+cd bindings/django
+python3 build_assets.py
+```
+
+## Testing Checklist
+
+Before publishing a new version:
+
+- [ ] Run `build_assets.py` to sync latest changes
+- [ ] Test in a fresh Django project
+- [ ] Test model fields (create, read, update, delete)
+- [ ] Test form widgets in regular forms
+- [ ] Test form widgets in Django admin
+- [ ] Test all template tags and filters
+- [ ] Test BS ↔ AD conversion
+- [ ] Test both English and Nepali languages
+- [ ] Test all three themes (auto, light, dark)
+- [ ] Check that WASM files load correctly
+- [ ] Verify static files are included in package
+- [ ] Update CHANGELOG.md
+- [ ] Tag release in git
+
+## File Organization
+
+### Python Files (Edit Freely)
+- `npdatetime_django/__init__.py`
+- `npdatetime_django/models.py`
+- `npdatetime_django/forms.py`
+- `npdatetime_django/widgets.py`
+- `npdatetime_django/utils.py`
+- `npdatetime_django/templatetags/nepali_date.py`
+
+### Template Files (Edit Freely)
+- `npdatetime_django/templates/`
+
+### Static Files (DO NOT EDIT - Run build script)
+- `npdatetime_django/static/` ← Copied from `../javascript/`
+
+### Configuration Files (Edit When Needed)
+- `setup.py` - Package metadata
+- `pyproject.toml` - Modern packaging config
+- `MANIFEST.in` - Package data inclusion
+
+## Troubleshooting
+
+### Static Files Not Loading
+
+1. Check that `build_assets.py` ran successfully
+2. Verify files exist in `static/npdatetime_django/`
+3. Run `python manage.py collectstatic` in test project
+4. Check browser console for 404 errors
+
+### WASM Not Loading
+
+1. Ensure `pkg/` directory was copied
+2. Check WASM MIME type in web server config
+3. Verify CORS headers if serving from CDN
+
+### Changes Not Reflected
+
+1. Clear browser cache
+2. Restart Django development server
+3. Check that you ran `build_assets.py`
+4. Verify you're editing source files, not copies
+
+## Questions?
+
+- Check the [main README](README.md)
+- Review [example code](example/)
+- Open an issue on GitHub

django_npdatetime-0.1.0/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/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include LICENSE
+recursive-include npdatetime_django/static *
+recursive-include npdatetime_django/templates *
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]