unicex 0.4.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

unicex/extra.py

@@ -7,9 +7,11 @@ __all__ = [
     "generate_ex_link",
     "generate_tv_link",
     "generate_cg_link",
+    "make_humanreadable",
 ]
 
 import time
+from typing import Literal
 
 from .enums import Exchange, MarketType
 from .exceptions import NotSupported
@@ -205,3 +207,50 @@ def generate_cg_link(exchange: Exchange, market_type: MarketType, symbol: str) -
             return f"{base_url}/SPOT_{exchange.upper()}_{symbol.replace('USDT', '-USDT')}"
         # Для остальных бирж ссылки нет → возвращаем заглушку
         return base_url
+
+
+def make_humanreadable(value: float, locale: Literal["ru", "en"] = "ru") -> str:
+    """Функция превращает большие числа в удобочитаемый вид.
+
+    Принимает:
+        value (float): число для преобразования
+        locale (Literal["ru", "en"]): язык для форматирования числа
+
+    Возвращает:
+        str: Человеческое представление числа
+    """
+    suffixes = {
+        "ru": {
+            1_000: "тыс.",
+            1_000_000: "млн.",
+            1_000_000_000: "млрд.",
+            1_000_000_000_000: "трлн.",
+            1_000_000_000_000_000: "квдрлн.",
+            1_000_000_000_000_000_000: "квнтлн.",
+        },
+        "en": {
+            1_000: "K",
+            1_000_000: "M",
+            1_000_000_000: "B",
+            1_000_000_000_000: "T",
+            1_000_000_000_000_000: "Qa",  # Quadrillion
+            1_000_000_000_000_000_000: "Qi",  # Quintillion
+        },
+    }
+
+    selected_suffixes = suffixes[locale]
+
+    for divisor in sorted(selected_suffixes.keys(), reverse=True):
+        if abs(value) >= divisor:
+            number = value / divisor
+            if locale == "ru":
+                return (
+                    f"{number:,.2f}".replace(",", " ").replace(".", ",")
+                    + f" {selected_suffixes[divisor]}"
+                )
+            return f"{number:,.2f} {selected_suffixes[divisor]}"
+
+    # Форматирование "малых" чисел
+    if locale == "ru":
+        return f"{value:,.2f}".replace(",", " ").replace(".", ",")
+    return f"{value:,.2f}"

{unicex-0.4.0.dist-info → unicex-0.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unicex
-Version: 0.4.0
+Version: 0.5.0
 Summary: Unified Crypto Exchange API 
 Author-email: LoveBloodAndDiamonds <ayazshakirzyanov27@gmail.com>
 License: BSD 3-Clause License

{unicex-0.4.0.dist-info → unicex-0.5.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
 unicex/__init__.py,sha256=YcTqQ92p6EZXAn3dQqpORHVqzHVZf5u5oxQ3TLv4yzA,6645
 unicex/enums.py,sha256=fEdvOdr35E0m8AFInZxaM1fh5CMsEORwNO6fM3svjuU,9124
 unicex/exceptions.py,sha256=r-xZzX78VuxVnI5pe99AM8FIiGcdIUDcF5CaTkQ4NE0,2213
-unicex/extra.py,sha256=TcYbqSscp4B_8O3mvM2_NpZkAZvEdTr-WBQC8PAJ8Hs,8639
+unicex/extra.py,sha256=fy_SS5vXtMIu9i_NdiD-XFHOnT0QC6PApHUGj6SrmPU,10376
 unicex/mapper.py,sha256=hqgDVibYIIyUlVjq0A3R3sHiwDjC4k72ats3ca_JMB4,4928
 unicex/types.py,sha256=QW0AEak5rPmiFwmRtAfO19Yaj2pkGfmLHzS81V2hMEI,2871
 unicex/utils.py,sha256=dwU1VYuP2xcMpzaETtNQerL1V8Y_JH8H8EsLJ__-M4s,8050
@@ -116,8 +116,8 @@ unicex/xt/uni_client.py,sha256=Boi13Lsbik3p5WOzb4_gspZMrD8pM5Y8W8Gjtk61TXI,6353
 unicex/xt/uni_websocket_manager.py,sha256=_mwIZuY9AEtRvYlUy9yxBHdNyDYUDKhaN0P3SZuLRFA,9325
 unicex/xt/user_websocket.py,sha256=7OX1O5dIw9X3iXDBP9eT3xOyd1-xbjrQytKqZUSxdTc,125
 unicex/xt/websocket_manager.py,sha256=iQZIucT5PbPt27yeukcsR2ufMQGf9gvMJG9aAliG5Ws,266
-unicex-0.4.0.dist-info/licenses/LICENSE,sha256=lNNK4Vqak9cXm6qVJLhbqS7iR_BMj6k7fd7XQ6l1k54,1507
-unicex-0.4.0.dist-info/METADATA,sha256=45ziAYHXTQWEQ7vnYrboK4VV9i_YpbYsamcLIUtGd_M,8149
-unicex-0.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-unicex-0.4.0.dist-info/top_level.txt,sha256=_7rar-0OENIg4KRy6cgjWiebFYAJhjKEcMggAocGWG4,7
-unicex-0.4.0.dist-info/RECORD,,
+unicex-0.5.0.dist-info/licenses/LICENSE,sha256=lNNK4Vqak9cXm6qVJLhbqS7iR_BMj6k7fd7XQ6l1k54,1507
+unicex-0.5.0.dist-info/METADATA,sha256=WgBjx9bF-ZhFi-GBzfBq6BaVNLzulT_pUFAEIpfsTqc,8149
+unicex-0.5.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+unicex-0.5.0.dist-info/top_level.txt,sha256=_7rar-0OENIg4KRy6cgjWiebFYAJhjKEcMggAocGWG4,7
+unicex-0.5.0.dist-info/RECORD,,