Metadata-Version: 2.4
Name: decitobin
Version: 2026.5
Summary: A powerful CLI & GUI toolkit for base conversions (Decimal, Binary, Hex, Duo, etc.)
Author-email: Thailam12 <thailam160317@outlook.com>
License: MIT
Project-URL: Homepage, https://github.com/Thailam12/decimal-to-binary
Project-URL: Issues, https://github.com/Thailam12/decimal-to-binary/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# decitobin

A small Python library and CLI for converting decimal, binary, hexadecimal, octal,
ASCII, and duodecimal values.

## Features

- Python API with fractional decimal support
- Common aliases such as `dec`, `bin`, `hexadecimal`, and `base16`
- Friendly Tkinter desktop interface
- Simple CLI entry points

## Installation

```bash
pip install decitobin
```

## Python API

```python
from decitobin import convert_value

print(convert_value("10", "decimal", "binary"))
print(convert_value("1010", "binary", "decimal"))
print(convert_value("FF", "hexadecimal", "dec"))
```

Supported conversions are decimal, binary, hex, octal, ASCII, and duodecimal.
Unsupported source/target pairs raise `ConversionError`; malformed values raise
`ValueError`.

## GUI

Run the interface with:

```bash
decitobin
```

## CLI

```bash
decitobin-cli --from decimal --to binary 10
# 1010
```

## Testing

Run the standard-library test suite from the project directory:

```bash
python -m unittest discover -s tests -v
```
