semvec/pypi-packages huggingface dataset:
pyillion 1.2.0
Convert integers into long-form -illion notation (million, billion, ...)
License: MIT
Requires Python: >=3.8
Keywords: illion, big-number, number-format, math

# pyillion

<!-- BADGES -->
![PyPI](https://img.shields.io/pypi/v/pyillion)
![Python](https://img.shields.io/pypi/pyversions/pyillion)
![License](https://img.shields.io/pypi/l/pyillion)
![Wheel](https://img.shields.io/pypi/wheel/pyillion)
![Status](https://img.shields.io/badge/status-stable-brightgreen)

> Convert integers into long-form and short form **-illion notation**  
> (million, billion, trillion, …) with high precision and simplicity.

---

## ✨ Features

- 🔢 Convert large integers to human-readable **illion format**
- ⚡ Lightweight, zero dependencies
- 🧮 Custom decimal precision
- 🧠 Simple and explicit API
- 📦 Clean **src-layout**, PyPI-ready

---

## 📦 Installation

```bash
pip install pyillion
```

---

## 🚀 Quick Start

```python
from pyillion import illionify

print(illionify(1234567890))
# 1.234 billion
```

With custom precision:

```python
print(illionify(1234567890, r=4))
# 1.2345 billion
```
With short form:

```python
print(illionify(1234567890, short=True))
# 1.234B
```
---

## 🧩 API Reference

### `illionify(n: int, r: int = 3, short = False) -> str`

Turn a number into long-form or short-form *-illion* notation.

```python
illionify(9876543210)
# '9.876 billion'
```

---

### `il(n: int, bl: bool = False)`

Return the *-illion* name corresponding to `n`.

```python
il(7)
# 'sextillion'

il(7, bl=True)
# 1000 ** 7
```
### `il_short(n: int, bl: bool = False)`

Return the short form *-illion* name corresponding to `n`.

```python
il_short(7)
# 'Sx'

il(7, bl=True)
# 1000 ** 7
```
---

### `e(n: int)`

Return `1000 ** n`.

```python
e(4)
# 1000000000000
```

---

### `d(a, b, r: int = 3)`

Safe division with fixed decimal precision.

```python
d(215, 11, 4)
# 19.5454
```

---

## 📁 Project Structure

```text
pyillion/
├─ src/
│  └─ pyillion/
│     ├─ __init__.py
│     └─ illionifyer.py
├─ pyproject.toml
├─ README.md
└─ LICENSE
```

---

## 🧪 Supported Python Versions

- Python **3.8+**
- Tested on **3.13 / 3.14**

---

## 📜 License

This project is licensed under the **MIT License**.  
See [LICENSE](LICENSE) for details.

---

## 🌐 Links

- 🧾 PyPI: https://pypi.org/project/pyillion/
- 🧑‍💻 GitHub: https://github.com/phannoiershit/pyillion
- 🐞 Issues: https://github.com/phannoiershit/pyillion/issues

---

## ⭐ Why pyillion?

If you need:
- deterministic formatting
- full control over *-illion logic*
- **no hidden heuristics** like `humanize`

→ **pyillion is for you.**
magic-dash 0.5.0rc1
A command-line tool for quickly generating standard Dash application projects.
License: MIT
Requires Python: <3.14,>=3.8

<p align="center">
	<img src="./imgs/logo.svg" height=100></img>
</p>
<h1 align="center">magic-dash</h1>
<div align="center">

[![Pyhton](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](./setup.py)
[![GitHub](https://shields.io/badge/license-MIT-informational)](https://github.com/CNFeffery/magic-dash/blob/main/LICENSE)
[![PyPI](https://img.shields.io/pypi/v/magic-dash.svg?color=dark-green)](https://pypi.org/project/magic-dash/)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

</div>

命令行工具，用于快捷生成一系列开箱即用✨的标准[Dash](https://github.com/plotly/dash)应用工程模板，加速你的应用开发进程🚀。

## 目录

[1 安装](#install)<br>
[2 使用](#usage)<br>
[3 内置模板列表](#template-list)<br>
[4 内置模板文档](#template-doc)<br>
[5 更新日志](#changelog)<br>
[6 更多应用开发教程](#courses)<br>

<a name="install" ></a>

## 1 安装

```bash
pip install magic-dash -U
```

<a name="usage" ></a>

## 2 使用

### 2.1 查看内置项目模板

```bash
magic-dash list
```

### 2.2 生成指定项目模板

- 默认生成到当前路径

```bash
magic-dash create --name magic-dash
```

- 指定生成路径

```bash
magic-dash create --name magic-dash --path 目标路径
```

### 2.3 查看当前`magic-dash`版本

```bash
magic-dash --version
```

### 2.4 查看命令说明

```bash
magic-dash --help

magic-dash list --help

magic-dash create --help
```

<a name="template-list" ></a>

## 3 内置模板列表

```bash
内置Dash应用项目模板：

- magic-dash    基础多页面应用模板
- magic-dash-pro    多页面+用户登录应用模板
- simple-tool    单页面工具应用模板
```

<a name="template-doc" ></a>

## 4 各内置模板说明文档

|    模板名称    |        模板描述         |             说明文档             |
| :------------: | :---------------------: | :------------------------------: |
|   magic-dash   |   基础多页面应用模板    |   [查看](./docs/magic-dash.md)   |
| magic-dash-pro | 多页面+用户登录应用模板 | [查看](./docs/magic-dash-pro.md) |
|  simple-tool   |   单页面工具应用模板    |  [查看](./docs/simple-tool.md)   |

<a name="changelog" ></a>

## 5 更新日志

[历史版本更新日志](./changelog.md)

<a name="courses" ></a>

## 6 更多应用开发教程

> 微信公众号「玩转 Dash」，欢迎扫码关注 👇

<p align="center" >
  <img src="./imgs/公众号.png" height=220 />
</p>

> 「玩转 Dash」知识星球，海量教程案例模板资源，专业的答疑咨询服务，欢迎扫码加入 👇

<p align="center" >
  <img src="./imgs/知识星球.jpg" height=220 />
</p>