num2bangla


Namenum2bangla JSON
Version 1.0.0 PyPI version JSON
download
home_pagehttps://github.com/Mamuntheprogrammer/num2bangla
SummaryA package to convert numbers to Bengali/Bangla text and numerals with currency formatting support
upload_time2025-08-31 10:00:53
maintainerNone
docs_urlNone
authorMd.Amanullah Al Mamun
requires_python>=3.6
licenseMIT
keywords bangla bengali numbers num2words currency text numerals
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # num2bangla

[![PyPI version](https://badge.fury.io/py/num2bangla.svg)](https://badge.fury.io/py/num2bangla)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A powerful Python package for converting numbers to Bengali/Bangla text and numerals, with comprehensive support for currency formatting. Perfect for financial documents, invoices, and applications requiring Bengali number representation.

## 🚀 Features

- 📝 Convert numbers to words in Bangla or English
- 💱 Flexible currency formatting (e.g., "Taka", "āĻŸāĻžāĻ•āĻž")
- đŸ”ĸ Support for Bengali numerical digits
- đŸ’¯ Handle decimal numbers in traditional (āĻĒāĻ¯āĻŧāĻ¸āĻž) or modern (āĻĻāĻļāĻŽāĻŋāĻ•) style
- 📊 Process multiple numbers simultaneously
- 🔄 Support for large numbers (up to crores)
- đŸ’ģ Command-line interface (CLI)
- ⚙ī¸ Highly customizable output format

## đŸ“Ļ Installation

```bash
pip install num2bangla
```

## đŸŽ¯ Quick Start

### Basic Usage

```python
from num2bangla import taka

# Simple conversion
result = taka(200)  # "Two Hundred Taka Only"

### Advanced Usage

```python
from num2bangla import TakaConverter

# Bangla output with traditional paisa style
converter = TakaConverter(lang="bn", currency="āĻŸāĻžāĻ•āĻž", extension="āĻŽāĻžāĻ¤ā§āĻ°")
result = converter.convert_number(200.25)  
# Output: "āĻĻā§āĻ‡ āĻļāĻ¤ āĻŸāĻžāĻ•āĻž āĻāĻŦāĻ‚ āĻĒāĻāĻšāĻŋāĻļ āĻĒāĻ¯āĻŧāĻ¸āĻž āĻŽāĻžāĻ¤ā§āĻ°"

# Modern decimal style in Bangla
converter = TakaConverter(
    lang="bn",
    currency="āĻŸāĻžāĻ•āĻž",
    extension="āĻŽāĻžāĻ¤ā§āĻ°",
    decimal_style="decimal"
)
result = converter.convert_number(42.25)  
# Output: "āĻŦāĻŋāĻ¯āĻŧāĻžāĻ˛ā§āĻ˛āĻŋāĻļ āĻĻāĻļāĻŽāĻŋāĻ• āĻĻā§āĻ‡ āĻĒāĻžāĻāĻš āĻŸāĻžāĻ•āĻž āĻŽāĻžāĻ¤ā§āĻ°"

# Using Bengali numerals
converter = TakaConverter(numerical_digits="bn")
result = converter.convert_number(1234.56, return_numerical=True)  
# Output: "ā§§ā§¨ā§Šā§Ē.ā§Ģā§Ŧ"

# Multiple numbers at once
converter = TakaConverter(lang="en", currency="USD", extension="Only")
results = converter.convert_multiple(200, 100, 300)  
# Output: ["Two Hundred USD Only", "One Hundred USD Only", "Three Hundred USD Only"]
```

### Comprehensive Configuration

```python
converter = TakaConverter(
    lang="bn",                # Language: "bn" for Bangla, "en" for English
    currency="āĻŸāĻžāĻ•āĻž",          # Currency text
    extension="āĻŽāĻžāĻ¤ā§āĻ°",        # Extension text
    decimal_style="decimal",  # Decimal style: "default" or "decimal"
    numerical_digits="bn"     # Numerical digits: "bn" or "en"
)

text_result = converter.convert_number(42.25)  
# Text format: "āĻŦāĻŋāĻ¯āĻŧāĻžāĻ˛ā§āĻ˛āĻŋāĻļ āĻĻāĻļāĻŽāĻŋāĻ• āĻĻā§āĻ‡ āĻĒāĻžāĻāĻš āĻŸāĻžāĻ•āĻž āĻŽāĻžāĻ¤ā§āĻ°"

numeral_result = converter.convert_number(42.25, return_numerical=True)  
# Numeral format: "ā§Ēā§¨.ā§¨ā§Ģ"
```

## đŸ–Ĩī¸ Command Line Interface

The package includes a convenient command-line interface:

```bash
# Basic conversion
num2bangla 42.25

# Multiple numbers
num2bangla 100 200.50 1234.56

# Full configuration example
num2bangla 42.25 \
    --lang bn \
    --currency āĻŸāĻžāĻ•āĻž \
    --extension āĻŽāĻžāĻ¤ā§āĻ° \
    --decimal-style decimal \
    --numerical-digits bn
```

### CLI Options

| Option | Description | Values |
|--------|-------------|--------|
| `--lang` | Output language | `bn`, `en` |
| `--currency` | Currency text | e.g., āĻŸāĻžāĻ•āĻž, Taka |
| `--extension` | Extension text | e.g., āĻŽāĻžāĻ¤ā§āĻ°, Only |
| `--decimal-style` | Decimal format | `default`, `decimal` |
| `--numerical-digits` | Numeral style | `bn`, `en` |
| `--numerical-only` | Show only numerals | flag |

## 📝 Configuration Options

### TakaConverter Parameters

| Parameter | Default | Description |
|-----------|---------|-------------|
| `lang` | `"en"` | Output language (`"bn"` or `"en"`) |
| `currency` | `"Taka"` | Currency text to use in output |
| `extension` | `"Only"` | Extension text to append |
| `decimal_style` | `"default"` | Decimal number style |
| `numerical_digits` | `"en"` | Numeral style for numerical output |

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

## đŸ’Ŧ Support

If you have any questions or need help, please open an issue on GitHub.

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/Mamuntheprogrammer/num2bangla",
    "name": "num2bangla",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": null,
    "keywords": "bangla, bengali, numbers, num2words, currency, text, numerals",
    "author": "Md.Amanullah Al Mamun",
    "author_email": "pygemsbd@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/8e/77/4176d23a6c5ec98381a806c71e5195aef8563c39f5f1a8ec33d9cdff92e4/num2bangla-1.0.0.tar.gz",
    "platform": null,
    "description": "# num2bangla\r\n\r\n[![PyPI version](https://badge.fury.io/py/num2bangla.svg)](https://badge.fury.io/py/num2bangla)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\r\n\r\nA powerful Python package for converting numbers to Bengali/Bangla text and numerals, with comprehensive support for currency formatting. Perfect for financial documents, invoices, and applications requiring Bengali number representation.\r\n\r\n## \ud83d\ude80 Features\r\n\r\n- \ud83d\udcdd Convert numbers to words in Bangla or English\r\n- \ud83d\udcb1 Flexible currency formatting (e.g., \"Taka\", \"\u099f\u09be\u0995\u09be\")\r\n- \ud83d\udd22 Support for Bengali numerical digits\r\n- \ud83d\udcaf Handle decimal numbers in traditional (\u09aa\u09af\u09bc\u09b8\u09be) or modern (\u09a6\u09b6\u09ae\u09bf\u0995) style\r\n- \ud83d\udcca Process multiple numbers simultaneously\r\n- \ud83d\udd04 Support for large numbers (up to crores)\r\n- \ud83d\udcbb Command-line interface (CLI)\r\n- \u2699\ufe0f Highly customizable output format\r\n\r\n## \ud83d\udce6 Installation\r\n\r\n```bash\r\npip install num2bangla\r\n```\r\n\r\n## \ud83c\udfaf Quick Start\r\n\r\n### Basic Usage\r\n\r\n```python\r\nfrom num2bangla import taka\r\n\r\n# Simple conversion\r\nresult = taka(200)  # \"Two Hundred Taka Only\"\r\n\r\n### Advanced Usage\r\n\r\n```python\r\nfrom num2bangla import TakaConverter\r\n\r\n# Bangla output with traditional paisa style\r\nconverter = TakaConverter(lang=\"bn\", currency=\"\u099f\u09be\u0995\u09be\", extension=\"\u09ae\u09be\u09a4\u09cd\u09b0\")\r\nresult = converter.convert_number(200.25)  \r\n# Output: \"\u09a6\u09c1\u0987 \u09b6\u09a4 \u099f\u09be\u0995\u09be \u098f\u09ac\u0982 \u09aa\u0981\u099a\u09bf\u09b6 \u09aa\u09af\u09bc\u09b8\u09be \u09ae\u09be\u09a4\u09cd\u09b0\"\r\n\r\n# Modern decimal style in Bangla\r\nconverter = TakaConverter(\r\n    lang=\"bn\",\r\n    currency=\"\u099f\u09be\u0995\u09be\",\r\n    extension=\"\u09ae\u09be\u09a4\u09cd\u09b0\",\r\n    decimal_style=\"decimal\"\r\n)\r\nresult = converter.convert_number(42.25)  \r\n# Output: \"\u09ac\u09bf\u09af\u09bc\u09be\u09b2\u09cd\u09b2\u09bf\u09b6 \u09a6\u09b6\u09ae\u09bf\u0995 \u09a6\u09c1\u0987 \u09aa\u09be\u0981\u099a \u099f\u09be\u0995\u09be \u09ae\u09be\u09a4\u09cd\u09b0\"\r\n\r\n# Using Bengali numerals\r\nconverter = TakaConverter(numerical_digits=\"bn\")\r\nresult = converter.convert_number(1234.56, return_numerical=True)  \r\n# Output: \"\u09e7\u09e8\u09e9\u09ea.\u09eb\u09ec\"\r\n\r\n# Multiple numbers at once\r\nconverter = TakaConverter(lang=\"en\", currency=\"USD\", extension=\"Only\")\r\nresults = converter.convert_multiple(200, 100, 300)  \r\n# Output: [\"Two Hundred USD Only\", \"One Hundred USD Only\", \"Three Hundred USD Only\"]\r\n```\r\n\r\n### Comprehensive Configuration\r\n\r\n```python\r\nconverter = TakaConverter(\r\n    lang=\"bn\",                # Language: \"bn\" for Bangla, \"en\" for English\r\n    currency=\"\u099f\u09be\u0995\u09be\",          # Currency text\r\n    extension=\"\u09ae\u09be\u09a4\u09cd\u09b0\",        # Extension text\r\n    decimal_style=\"decimal\",  # Decimal style: \"default\" or \"decimal\"\r\n    numerical_digits=\"bn\"     # Numerical digits: \"bn\" or \"en\"\r\n)\r\n\r\ntext_result = converter.convert_number(42.25)  \r\n# Text format: \"\u09ac\u09bf\u09af\u09bc\u09be\u09b2\u09cd\u09b2\u09bf\u09b6 \u09a6\u09b6\u09ae\u09bf\u0995 \u09a6\u09c1\u0987 \u09aa\u09be\u0981\u099a \u099f\u09be\u0995\u09be \u09ae\u09be\u09a4\u09cd\u09b0\"\r\n\r\nnumeral_result = converter.convert_number(42.25, return_numerical=True)  \r\n# Numeral format: \"\u09ea\u09e8.\u09e8\u09eb\"\r\n```\r\n\r\n## \ud83d\udda5\ufe0f Command Line Interface\r\n\r\nThe package includes a convenient command-line interface:\r\n\r\n```bash\r\n# Basic conversion\r\nnum2bangla 42.25\r\n\r\n# Multiple numbers\r\nnum2bangla 100 200.50 1234.56\r\n\r\n# Full configuration example\r\nnum2bangla 42.25 \\\r\n    --lang bn \\\r\n    --currency \u099f\u09be\u0995\u09be \\\r\n    --extension \u09ae\u09be\u09a4\u09cd\u09b0 \\\r\n    --decimal-style decimal \\\r\n    --numerical-digits bn\r\n```\r\n\r\n### CLI Options\r\n\r\n| Option | Description | Values |\r\n|--------|-------------|--------|\r\n| `--lang` | Output language | `bn`, `en` |\r\n| `--currency` | Currency text | e.g., \u099f\u09be\u0995\u09be, Taka |\r\n| `--extension` | Extension text | e.g., \u09ae\u09be\u09a4\u09cd\u09b0, Only |\r\n| `--decimal-style` | Decimal format | `default`, `decimal` |\r\n| `--numerical-digits` | Numeral style | `bn`, `en` |\r\n| `--numerical-only` | Show only numerals | flag |\r\n\r\n## \ud83d\udcdd Configuration Options\r\n\r\n### TakaConverter Parameters\r\n\r\n| Parameter | Default | Description |\r\n|-----------|---------|-------------|\r\n| `lang` | `\"en\"` | Output language (`\"bn\"` or `\"en\"`) |\r\n| `currency` | `\"Taka\"` | Currency text to use in output |\r\n| `extension` | `\"Only\"` | Extension text to append |\r\n| `decimal_style` | `\"default\"` | Decimal number style |\r\n| `numerical_digits` | `\"en\"` | Numeral style for numerical output |\r\n\r\n## \ud83d\udcc4 License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n## \ud83e\udd1d Contributing\r\n\r\nContributions are welcome! Feel free to open issues or submit pull requests.\r\n\r\n## \ud83d\udcac Support\r\n\r\nIf you have any questions or need help, please open an issue on GitHub.\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A package to convert numbers to Bengali/Bangla text and numerals with currency formatting support",
    "version": "1.0.0",
    "project_urls": {
        "Bug Tracker": "https://github.com/Mamuntheprogrammer/num2bangla/issues",
        "Homepage": "https://github.com/Mamuntheprogrammer/num2bangla",
        "Source": "https://github.com/Mamuntheprogrammer/num2bangla"
    },
    "split_keywords": [
        "bangla",
        " bengali",
        " numbers",
        " num2words",
        " currency",
        " text",
        " numerals"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "dcc98d9ab9dd3fb8a3017e528c9a219f7a4bbe0e57b2136b2cbf25a214d7d26d",
                "md5": "d9f66aba058ea000664ed7c039cf6599",
                "sha256": "e895b74a8e365cf70ed934042665237be5604088b15437217746a8295559b75c"
            },
            "downloads": -1,
            "filename": "num2bangla-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d9f66aba058ea000664ed7c039cf6599",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 7350,
            "upload_time": "2025-08-31T10:00:51",
            "upload_time_iso_8601": "2025-08-31T10:00:51.690935Z",
            "url": "https://files.pythonhosted.org/packages/dc/c9/8d9ab9dd3fb8a3017e528c9a219f7a4bbe0e57b2136b2cbf25a214d7d26d/num2bangla-1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "8e774176d23a6c5ec98381a806c71e5195aef8563c39f5f1a8ec33d9cdff92e4",
                "md5": "284ff74377895e4c671f7822d93f3e92",
                "sha256": "4f6fa291cf1dc8e62707f5dbbfb065c803c4ed954a93ddbe89dc1469ea6a01a6"
            },
            "downloads": -1,
            "filename": "num2bangla-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "284ff74377895e4c671f7822d93f3e92",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 6877,
            "upload_time": "2025-08-31T10:00:53",
            "upload_time_iso_8601": "2025-08-31T10:00:53.077841Z",
            "url": "https://files.pythonhosted.org/packages/8e/77/4176d23a6c5ec98381a806c71e5195aef8563c39f5f1a8ec33d9cdff92e4/num2bangla-1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-31 10:00:53",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Mamuntheprogrammer",
    "github_project": "num2bangla",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "num2bangla"
}
Md.Amanullah Al Mamun
Elapsed time: 1.01002s