mm-balance 0.6.0__tar.gz → 0.6.2__tar.gz

{mm_balance-0.6.0 → mm_balance-0.6.2}/.claude/settings.local.json

@@ -4,7 +4,8 @@
       "mcp__ide__getDiagnostics",
       "Bash(uv run pytest:*)",
       "Bash(just lint)",
-      "Bash(uv run ruff check:*)"
+      "Bash(uv run ruff check:*)",
+      "Bash(just test:*)"
     ],
     "deny": [],
     "ask": []

mm_balance-0.6.2/CLAUDE.md

@@ -0,0 +1,24 @@
+# AI Agent Start Guide
+
+## Critical: Language
+RESPOND IN ENGLISH. Always. No exceptions.
+User's language does NOT determine your response language.
+Only switch if user EXPLICITLY requests it (e.g., "respond in {language}").
+Language switching applies ONLY to chat. All code, comments, commit messages, and files must ALWAYS be in English — no exceptions.
+
+## Mandatory Rules (external)
+These files are REQUIRED. Read them fully and follow all rules.
+- `~/.claude/shared-rules/general.md`
+- `~/.claude/shared-rules/python.md`
+
+## Project Reading (context)
+These files are REQUIRED for project understanding.
+- `README.md`
+
+## Preflight (mandatory)
+Before your first response:
+1. Read all files listed above.
+2. Do not answer until all are read.
+3. In your first reply, list every file you have read from this document.
+
+Failure to follow this protocol is considered an error.

mm_balance-0.6.2/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: mm-balance
+Version: 0.6.2
+Requires-Python: >=3.14
+Requires-Dist: deepdiff==8.6.1
+Requires-Dist: mm-apt==0.6.0
+Requires-Dist: mm-btc==0.6.0
+Requires-Dist: mm-concurrency~=0.2.0
+Requires-Dist: mm-eth==0.8.0
+Requires-Dist: mm-sol==0.8.0

{mm_balance-0.6.0 → mm_balance-0.6.2}/pyproject.toml

@@ -1,14 +1,14 @@
 [project]
 name = "mm-balance"
-version = "0.6.0"
+version = "0.6.2"
 description = ""
-requires-python = ">=3.13"
+requires-python = ">=3.14"
 dependencies = [
-    "mm-concurrency~=0.1.0",
-    "mm-apt==0.5.0",
-    "mm-btc==0.5.5",
-    "mm-eth==0.7.3",
-    "mm-sol==0.7.3",
+    "mm-concurrency~=0.2.0",
+    "mm-apt==0.6.0",
+    "mm-btc==0.6.0",
+    "mm-eth==0.8.0",
+    "mm-sol==0.8.0",
     "deepdiff==8.6.1",
 ]
 [project.scripts]
@@ -20,23 +20,23 @@ build-backend = "hatchling.build"
 
 [dependency-groups]
 dev = [
-    "pytest~=8.4.2",
+    "pytest~=9.0.2",
     "pytest-xdist~=3.8.0",
-    "ruff~=0.14.2",
-    "pip-audit~=2.9.0",
-    "bandit~=1.8.6",
-    "mypy~=1.18.2",
+    "ruff~=0.15.0",
+    "pip-audit~=2.10.0",
+    "bandit~=1.9.3",
+    "mypy~=1.19.1",
 ]
 
 [tool.mypy]
-python_version = "3.13"
+python_version = "3.14"
 warn_no_return = false
 strict = true
 exclude = ["^tests/", "^tmp/"]
 
 [tool.ruff]
 line-length = 130
-target-version = "py313"
+target-version = "py314"
 [tool.ruff.lint]
 select = ["ALL"]
 ignore = [

{mm_balance-0.6.0 → mm_balance-0.6.2}/src/mm_balance/balance_fetcher.py

@@ -39,7 +39,7 @@ class BalanceFetcher:
 
     async def process(self) -> None:
         with self.progress_bar:
-            runner = AsyncTaskRunner(max_concurrent_tasks=10)
+            runner = AsyncTaskRunner(concurrency=10)
             for network in self.config.networks():
                 runner.add(f"process_{network}", self._process_network(network))
             await runner.run()
@@ -54,7 +54,7 @@ class BalanceFetcher:
         return result
 
     async def _process_network(self, network: Network) -> None:
-        runner = AsyncTaskRunner(max_concurrent_tasks=self.config.workers[network])
+        runner = AsyncTaskRunner(concurrency=self.config.workers[network])
         for idx, task in enumerate(self.tasks[network]):
             runner.add(str(idx), self._get_balance(network, task.wallet_address, task.token_address))
         res = await runner.run()

{mm_balance-0.6.0 → mm_balance-0.6.2}/src/mm_balance/cli.py

@@ -4,13 +4,13 @@ import pkgutil
 from pathlib import Path
 from typing import Annotated
 
-import mm_print
 import typer
+from mm_print import print_toml
 
 from mm_balance import command_runner
 from mm_balance.command_runner import CommandParameters
 from mm_balance.constants import NETWORKS
-from mm_balance.utils import PrintFormat
+from mm_balance.utils import PrintFormat, fatal
 
 app = typer.Typer(no_args_is_help=True, pretty_exceptions_enable=False, add_completion=False)
 
@@ -25,8 +25,8 @@ def example_callback(value: bool) -> None:
     if value:
         data = pkgutil.get_data(__name__, "config/example.toml")
         if data is None:
-            mm_print.exit_with_error("Example config not found")
-        mm_print.toml(data.decode("utf-8"))
+            fatal("Example config not found")
+        print_toml(data.decode("utf-8"))
         raise typer.Exit
 
 

{mm_balance-0.6.0 → mm_balance-0.6.2}/src/mm_balance/command_runner.py

@@ -1,7 +1,6 @@
 import getpass
 from pathlib import Path
 
-import mm_print
 from pydantic import BaseModel
 
 from mm_balance.balance_fetcher import BalanceFetcher
@@ -11,7 +10,7 @@ from mm_balance.output.formats import json_format, table_format
 from mm_balance.price import Prices, get_prices
 from mm_balance.result import create_balances_result
 from mm_balance.token_decimals import get_token_decimals
-from mm_balance.utils import PrintFormat
+from mm_balance.utils import PrintFormat, fatal
 
 
 class CommandParameters(BaseModel):
@@ -63,7 +62,7 @@ async def run(params: CommandParameters) -> None:
     elif config.settings.print_format is PrintFormat.JSON:
         json_format.print_result(config, token_decimals, prices, workers, result)
     else:
-        mm_print.exit_with_error("Unsupported print format")
+        fatal("Unsupported print format")
 
     if params.save_balances:
         BalancesDict.from_balances_result(result).save_to_path(params.save_balances)

{mm_balance-0.6.0 → mm_balance-0.6.2}/src/mm_balance/config.py

@@ -1,16 +1,13 @@
-from __future__ import annotations
-
 from decimal import Decimal
 from pathlib import Path
 from typing import Annotated, Self
 
-import mm_print
 import pydash
 from mm_web3 import ConfigValidators, Web3CliConfig
 from pydantic import BeforeValidator, Field, StringConstraints, model_validator
 
 from mm_balance.constants import DEFAULT_NODES, TOKEN_ADDRESS, Network
-from mm_balance.utils import PrintFormat, evaluate_share_expression
+from mm_balance.utils import PrintFormat, evaluate_share_expression, fatal
 
 
 class Validators(ConfigValidators):
@@ -62,7 +59,7 @@ class AssetGroup(Web3CliConfig):
                 if path.is_file():
                     result += path.read_text().strip().splitlines()
                 else:
-                    mm_print.exit_with_error(f"File with addresses not found: {path}")
+                    fatal(f"File with addresses not found: {path}")
             elif line.startswith("group:"):
                 group_name = line.removeprefix("group:").strip()
                 address_group = next((ag for ag in address_groups if ag.name == group_name), None)

{mm_balance-0.6.0 → mm_balance-0.6.2}/src/mm_balance/diff.py

@@ -1,12 +1,10 @@
-from __future__ import annotations
-
 import json
 import re
 from decimal import Decimal
 from pathlib import Path
 
-import mm_print
 from deepdiff.diff import DeepDiff
+from mm_print import print_json, print_plain, print_table
 from pydantic import BaseModel, RootModel
 
 from mm_balance.result import Balance, BalancesResult
@@ -21,7 +19,8 @@ class BalancesDict(RootModel[dict[str, dict[str, dict[str, Decimal]]]]):  # netw
         return set(self.model_dump()[network].keys())
 
     def save_to_path(self, balances_file: Path) -> None:
-        json.dump(self.model_dump(), balances_file.open("w"), default=str, indent=2)
+        with balances_file.open("w") as f:
+            json.dump(self.model_dump(), f, default=str, indent=2)
 
     @staticmethod
     def from_balances_result(result: BalancesResult) -> BalancesDict:
@@ -38,7 +37,8 @@ class BalancesDict(RootModel[dict[str, dict[str, dict[str, Decimal]]]]):  # netw
 
     @staticmethod
     def from_file(path: Path) -> BalancesDict:
-        return BalancesDict(json.load(path.open("r")))
+        with path.open("r") as f:
+            return BalancesDict(json.load(f))
 
 
 class Diff(BaseModel):
@@ -72,23 +72,23 @@ class Diff(BaseModel):
             and not self.address_removed
             and not self.balance_changed
         ):
-            mm_print.plain("Diff: no changes")
+            print_plain("Diff: no changes")
             return
 
-        mm_print.plain("\nDiff")
+        print_plain("\nDiff")
 
         if self.network_added:
-            mm_print.plain(f"networks added: {self.network_added}")
+            print_plain(f"networks added: {self.network_added}")
         if self.network_removed:
-            mm_print.plain(f"networks removed: {self.network_removed}")
+            print_plain(f"networks removed: {self.network_removed}")
         if self.ticker_added:
-            mm_print.plain(f"tickers added: {self.ticker_added}")
+            print_plain(f"tickers added: {self.ticker_added}")
         if self.ticker_removed:
-            mm_print.plain(f"tickers removed: {self.ticker_removed}")
+            print_plain(f"tickers removed: {self.ticker_removed}")
         if self.address_added:
-            mm_print.plain(f"addresses added: {self.address_added}")
+            print_plain(f"addresses added: {self.address_added}")
         if self.address_removed:
-            mm_print.plain(f"addresses removed: {self.address_removed}")
+            print_plain(f"addresses removed: {self.address_removed}")
 
         if self.balance_changed:
             rows = []
@@ -97,11 +97,11 @@ class Diff(BaseModel):
                     for address in self.balance_changed[network][ticker]:
                         old_value, new_value = self.balance_changed[network][ticker][address]
                         rows.append([network, ticker, address, old_value, new_value, new_value - old_value])
-            mm_print.table(["Network", "Ticker", "Address", "Old", "New", "Change"], rows)
+            print_table(["Network", "Ticker", "Address", "Old", "New", "Change"], rows)
 
     def _print_json(self) -> None:
-        # mm_print.json(data=self.model_dump(), type_handlers=str) ?? default?
-        mm_print.json(data=self.model_dump())
+        # print_json(data=self.model_dump(), type_handlers=str) ?? default?
+        print_json(data=self.model_dump())
 
     @staticmethod
     def calc(balances1: BalancesDict, balances2: BalancesDict) -> Diff:

{mm_balance-0.6.0 → mm_balance-0.6.2}/src/mm_balance/output/formats/json_format.py

@@ -1,4 +1,4 @@
-import mm_print
+from mm_print import print_json
 
 from mm_balance.balance_fetcher import BalanceFetcher
 from mm_balance.config import Config
@@ -27,4 +27,4 @@ def print_result(
     if errors:
         data["errors"] = errors
 
-    mm_print.json(data)
+    print_json(data)

{mm_balance-0.6.0 → mm_balance-0.6.2}/src/mm_balance/output/formats/table_format.py

@@ -1,6 +1,6 @@
 from decimal import Decimal
 
-import mm_print
+from mm_print import print_table
 
 from mm_balance.balance_fetcher import BalanceFetcher
 from mm_balance.config import Config
@@ -14,18 +14,18 @@ def print_nodes(config: Config) -> None:
     rows = []
     for network, nodes in config.nodes.items():
         rows.append([network, "\n".join(nodes)])
-    mm_print.table(["network", "nodes"], rows, title="Nodes")
+    print_table(["network", "nodes"], rows, title="Nodes")
 
 
 def print_proxy_count(config: Config) -> None:
-    mm_print.table(["count"], [[len(config.settings.proxies)]], title="Proxies")
+    print_table(["count"], [[len(config.settings.proxies)]], title="Proxies")
 
 
 def print_token_decimals(token_decimals: TokenDecimals) -> None:
     rows = []
     for network, decimals in token_decimals.items():
         rows.append([network, decimals])
-    mm_print.table(["network", "decimals"], rows, title="Token Decimals")
+    print_table(["network", "decimals"], rows, title="Token Decimals")
 
 
 def print_prices(config: Config, prices: Prices) -> None:
@@ -35,7 +35,7 @@ def print_prices(config: Config, prices: Prices) -> None:
             rows.append(
                 [ticker, format_number(price, config.settings.format_number_separator, "$", config.settings.round_ndigits)]
             )
-        mm_print.table(["coin", "usd"], rows, title="Prices")
+        print_table(["coin", "usd"], rows, title="Prices")
 
 
 def print_result(config: Config, result: BalancesResult, workers: BalanceFetcher) -> None:
@@ -56,8 +56,10 @@ def _print_errors(config: Config, workers: BalanceFetcher) -> None:
     rows = []
     for task in error_tasks:
         group = config.groups[task.group_index]
-        rows.append([group.ticker + " / " + group.network, task.wallet_address, task.balance.error])  # type: ignore[union-attr]
-    mm_print.table(["coin", "address", "error"], rows, title="Errors")
+        # task.balance is guaranteed to be non-None ResultErr here since get_errors() filters for is_err()
+        if task.balance is not None:
+            rows.append([group.ticker + " / " + group.network, task.wallet_address, task.balance.unwrap_err()])
+    print_table(["coin", "address", "error"], rows, title="Errors")
 
 
 def _print_total(config: Config, total: Total, is_share_total: bool) -> None:
@@ -80,7 +82,7 @@ def _print_total(config: Config, total: Total, is_share_total: bool) -> None:
             rows.append(["stablecoin_sum", format_number(total.stablecoin_sum, config.settings.format_number_separator, "$")])
         rows.append(["total_usd_sum", format_number(total.total_usd_sum, config.settings.format_number_separator, "$")])
 
-    mm_print.table(headers, rows, title=table_name)
+    print_table(headers, rows, title=table_name)
 
 
 def _print_group(config: Config, group: GroupResult) -> None:
@@ -118,4 +120,4 @@ def _print_group(config: Config, group: GroupResult) -> None:
     table_headers = ["address", "balance"]
     if config.settings.price:
         table_headers += ["usd"]
-    mm_print.table(table_headers, rows, title=group_name)
+    print_table(table_headers, rows, title=group_name)

{mm_balance-0.6.0 → mm_balance-0.6.2}/src/mm_balance/price.py

@@ -34,7 +34,7 @@ async def get_prices(config: Config) -> Prices:
         if res.status_code != 200:
             continue
 
-        json_body = res.parse_json()
+        json_body = res.json_body().unwrap_or({})
 
         for ticker, coingecko_id in coingecko_map.items():
             if coingecko_id in json_body:

{mm_balance-0.6.0 → mm_balance-0.6.2}/src/mm_balance/result.py

@@ -80,6 +80,8 @@ def _create_total(use_share: bool, groups: list[GroupResult]) -> Total:
     if total_usd_sum > 0:
         for ticker, usd_value in coin_usd_values.items():
             if ticker in USD_STABLECOINS:
+                # Intentionally show total stablecoin share for all stablecoins.
+                # We care about combined stablecoin allocation, not individual USDT/USDC breakdown.
                 portfolio_share[ticker] = round(stablecoin_sum * 100 / total_usd_sum, 2)
             else:
                 portfolio_share[ticker] = round(usd_value * 100 / total_usd_sum, 2)

{mm_balance-0.6.0 → mm_balance-0.6.2}/src/mm_balance/token_decimals.py

@@ -1,8 +1,7 @@
-import mm_print
-
 from mm_balance import rpc
 from mm_balance.config import Config
 from mm_balance.constants import NETWORK_APTOS, NETWORK_BITCOIN, NETWORK_SOLANA, Network
+from mm_balance.utils import fatal
 
 
 class TokenDecimals(dict[Network, dict[str | None, int]]):  # {network: {None: 18}} -- None is for native token, ex. ETH
@@ -30,7 +29,7 @@ async def get_token_decimals(config: Config) -> TokenDecimals:
             elif group.network in (NETWORK_BITCOIN, NETWORK_APTOS):
                 result[group.network][None] = 8
             else:
-                mm_print.exit_with_error(f"Can't get token decimals for native token on network: {group.network}")
+                fatal(f"Can't get token decimals for native token on network: {group.network}")
             continue
 
         # get token_decimals via RPC
@@ -45,8 +44,8 @@ async def get_token_decimals(config: Config) -> TokenDecimals:
         if res.is_err():
             msg = f"can't get decimals for token {group.ticker} / {group.token}, error={res.unwrap_err()}"
             if config.settings.print_debug:
-                msg += f"\n{res.extra}"
-            mm_print.exit_with_error(msg)
+                msg += f"\n{res.context}"
+            fatal(msg)
 
         result[group.network][group.token] = res.unwrap()
 

{mm_balance-0.6.0 → mm_balance-0.6.2}/src/mm_balance/utils.py

@@ -1,6 +1,9 @@
 import re
 from decimal import Decimal
 from enum import StrEnum, unique
+from typing import NoReturn
+
+import typer
 
 
 def fnumber(value: Decimal, separator: str, extra: str | None = None) -> str:
@@ -15,7 +18,7 @@ def fnumber(value: Decimal, separator: str, extra: str | None = None) -> str:
 def scale_and_round(value: int, decimals: int, round_ndigits: int) -> Decimal:
     if value == 0:
         return Decimal(0)
-    return round(Decimal(value / 10**decimals), round_ndigits)
+    return round(Decimal(value) / Decimal(10**decimals), round_ndigits)
 
 
 def round_decimal(value: Decimal, round_ndigits: int) -> Decimal:
@@ -161,3 +164,9 @@ class PrintFormat(StrEnum):
     PLAIN = "plain"
     TABLE = "table"
     JSON = "json"
+
+
+def fatal(message: str) -> NoReturn:
+    """Print an error message and exit with code 1."""
+    typer.echo(message)
+    raise typer.Exit(1)