mahounou-uconv 0.2.4

Lightweight unit converter library with support for 13 unit categories

Mahounou UConv (Python)

Python implementation of the Mahounou UConv family.

Naming convention across ecosystems:

• NPM: @mahounou/uconv
• PyPI: mahounou-uconv
• Composer: mahounou/uconv

Import name in Python remains:

• from uconv import convert

Installation

From PyPI

pip install mahounou-uconv

From Source

git clone https://github.com/ksnjkdppdojdim-star/UconvPy.git
cd UconvPy
pip install -e .

CLI (Important)

This project installs these Python commands:

• uconvpy

Examples:

uconvpy 10 km m
uconvpy 60 l/min m3/h
uconvpy list --lang fr
uconvpy categories

Why not install a Python command named uconv by default?

• Because many machines already have the Node global command uconv from npm install -g @mahounou/uconv.
• Keeping Python command as uconvpy avoids command conflicts in PATH.

Quick Start (Library)

from uconv import convert

convert('10km', 'm')
convert('0c', 'f')
convert('100km/h', 'm/s')
convert('1kwh', 'j')

API Highlights

from uconv import (
		convert,
		convert_display,
		convert_currency_live,
		parse_input,
		register_unit,
)

Supported Categories

• distance
• weight
• time
• currency
• temperature
• speed
• area
• volume
• energy
• pressure
• power
• data

Project Structure (Scalable, Node-like)

UconvPy/
	uconv/
		__init__.py
		cli.py
		parser.py
		converters/
			area.py
			currency.py
			data.py
			distance.py
			energy.py
			power.py
			pressure.py
			speed.py
			temperature.py
			time.py
			volume.py
			weight.py
		i18n/
			en_US/LC_MESSAGES/
			fr_FR/LC_MESSAGES/
		units/
			area.py
			currency.py
			data.py
			distance.py
			energy.py
			power.py
			pressure.py
			speed.py
			temperature.py
			time.py
			volume.py
			weight.py
			__init__.py
		utils/
			convert.py
	tests/
		test_cli.py
		test_convert.py
		test_currency_live.py
		test_i18n_display.py
	.github/workflows/
		ci.yml
		package-check.yml

Development

git clone https://github.com/ksnjkdppdojdim-star/UconvPy.git
cd UconvPy
pip install -e ".[dev]"
pytest tests -v

License

MIT License - see LICENSE file for details.