Metadata-Version: 2.4
Name: nepali-date-library
Version: 1.0.1
Summary: A Nepali Date Library for Python (Bikram Sambat ↔ AD conversion and manipulation)
Author-email: Sandip Ghimire <sandipghimire2076@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://nepalidate.sandip-ghimire.com.np
Project-URL: Repository, https://github.com/SandipGhimire/Nepali-Date-Library-Python
Project-URL: Issues, https://github.com/SandipGhimire/Nepali-Date-Library-Python/issues
Keywords: nepali,nepal,nepali-date-library,nepali-calendar,nepali-date,bikram-sambat,bs-date,date-conversion,ad-to-bs,bs-to-ad
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# NepaliDate Library (Python)

[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/SandipGhimire/Nepali-Date-Library-Python/blob/master/LICENSE)
[![Docs](https://img.shields.io/badge/Docs-Official%20Wiki-blue)](https://nepalidate.sandip-ghimire.com.np)
[![GitHub](https://img.shields.io/badge/GitHub-Repository-black)](https://github.com/SandipGhimire/nepali-date-library-Python)

## Overview

The `NepaliDate` Python library provides a proper way to work with Nepali (Bikram Sambat) dates.  
It allows you to create, manipulate, format, and convert between Nepali Bikram Sambat dates (1976/01/01 - 2100/12/31) and Gregorian dates (1919-03-13 - 2044-04-12). It also supports fiscal years, quarters, and extensive date operations.

This library is a Python port of the original TypeScript/JavaScript `NepaliDate` library.

---

## 📚 Documentation

For detailed guides, API references, and examples, please visit the official Wiki:

👉 **[nepalidate.sandip-ghimire.com.np](https://nepalidate.sandip-ghimire.com.np)**

---

## Installation

```bash
pip install nepali-date-library
```

## Quick Start

```py
from nepali_date_library import NepaliDate;

now = NepaliDate()
print(now.format("YYYY-MM-DD"))
```

For more advanced usage, please refer to the [Wiki](https://nepalidate.sandip-ghimire.com.np).

## Development

This project uses [uv](https://docs.astral.sh/uv/) to manage the dev environment and dependencies.

```bash
uv sync --group dev   # create .venv and install dev dependencies
uv run task test      # black --check, flake8, and pytest
uv build              # build sdist/wheel into dist/
```

## License

[MIT](https://choosealicense.com/licenses/mit/)
