🚀 Big News: Socket Acquires Coana to Bring Reachability Analysis to Every Appsec Team.Learn more
Socket
DemoInstallSign in
Socket

numt

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

numt

A light-weight utility library for formatting numbers, currencies, dates, units, and more.

0.1.1
PyPI
Maintainers
1

NumT

NumT is a powerful Python utility library for formatting numbers, currencies, dates, units, and more. It provides a simple and consistent interface for handling various numerical formatting needs.

Features

  • Currency formatting with support for multiple formats (Western, Indian, Continental, Swiss)
  • SI unit conversions and formatting for length, mass, and time
  • Number to word conversion with support for short and long formats
  • Human-readable number formatting with customizable precision

Installation

NumT is available on PyPI and can be installed using pip:

pip install numt

Or using Poetry:

poetry add numt

Usage Examples

Currency Formatting

from numt import format_currency

# Western format (default)
print(format_currency(1234567.89))  # $1,234,567.89

# Indian format
print(format_currency(1234567.89, format_type="indian"))  # ₹12,34,567.89

# Continental format
print(format_currency(1234567.89, format_type="continental"))  # €1.234.567,89

# Swiss format
print(format_currency(1234567.89, format_type="swiss"))  # CHF 1'234'567.89

SI Unit Conversions

from numt import convert_si, Length, Mass, Time

# Length conversions
length = Length(1500, "m")
print(length.format())  # 1.50 km

# Mass conversions
mass = Mass(0.5, "kg")
print(mass.format())  # 500.00 g

# Time conversions
time = Time(3660, "s")
print(time.format())  # 1.02 h

# Direct conversion
result = convert_si(1000, "m", "km", "length")
print(result)  # 1.0

Number Formatting

from numt import to_words

# Short format
print(to_words(1234567))  # 1.23 M
print(to_words(1234567, format_type="long"))  # 1.23 million

# With precision
print(to_words(1234567, precision=1))  # 1.2 M

# Strip zero cents
print(to_words(1000.00, strip_zero_cents=True))  # 1 K

Development

Setup Development Environment

  • Clone the repository:
git clone https://github.com/yourusername/numt.git
cd numt
  • Install dependencies using Poetry:
poetry install
  • Install pre-commit hooks:
poetry run pre-commit install

Running Tests

poetry run pytest

Building the Package

poetry build

Contributing

We welcome contributions! Please see our Contributing Guidelines for details on how to submit pull requests, report issues, and suggest improvements.

Code of Conduct

Please read our Code of Conduct to keep our community approachable and respectable.

License

This project is licensed under the terms of the LICENSE file.

Changelog

See the CHANGELOG.md file for a list of changes between versions.

Keywords

formatting

FAQs

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts