dao-treasury 0.0.58__cp311-cp311-win32.whl → 0.0.63__cp311-cp311-win32.whl

dao_treasury/_docker.py

@@ -14,17 +14,16 @@ This is the main entry for all Docker-based orchestration.
 """
 
 import logging
-from importlib import resources
-import subprocess
 from functools import wraps
-from typing import Any, Callable, Coroutine, Final, Iterable, Tuple, TypeVar, List
+from importlib import resources
+from typing import Any, Callable, Coroutine, Final, Literal, Tuple, TypeVar, List
 
 import eth_portfolio_scripts.docker
 from typing_extensions import ParamSpec
 
 logger: Final = logging.getLogger(__name__)
 
-compose_file: Final = str(
+COMPOSE_FILE: Final = str(
     resources.files("dao_treasury").joinpath("docker-compose.yaml")
 )
 """The path of dao-treasury's docker-compose.yaml file on your machine"""
@@ -55,7 +54,7 @@ def up(*services: str) -> None:
     # eth-portfolio containers must be started first so dao-treasury can attach to the eth-portfolio docker network
     eth_portfolio_scripts.docker.up("victoria-metrics")
     build(*services)
-    print(f"starting the {', '.join(services) if services else 'grafana'} container(s)")
+    _print_notice("starting", services)
     _exec_command(["up", "-d", *services])
 
 
@@ -72,6 +71,7 @@ def down() -> None:
     See Also:
         :func:`up`
     """
+    print("stopping all dao-treasury containers")
     _exec_command(["down"])
 
 
@@ -90,10 +90,24 @@ def build(*services: str) -> None:
         :func:`up`
         :func:`_exec_command`
     """
-    print("building the grafana containers")
+    _print_notice("building", services)
     _exec_command(["build", *services])
 
 
+def _print_notice(
+    doing: Literal["building", "starting"], services: Tuple[str, ...]
+) -> None:
+    if len(services) == 1:
+        container = services[0]
+        print(f"{doing} the {container} container")
+    elif len(services) == 2:
+        first, second = services
+        print(f"{doing} the {first} and {second} containers")
+    else:
+        *all_but_last, last = services
+        print(f"{doing} the {', '.join(all_but_last)}, and {last} containers")
+
+
 _P = ParamSpec("_P")
 _T = TypeVar("_T")
 
@@ -174,17 +188,6 @@ def _exec_command(command: List[str], *, compose_options: Tuple[str, ...] = ())
     See Also:
         :func:`check_system`
     """
-    eth_portfolio_scripts.docker.check_system()
-    try:
-        subprocess.check_output(
-            ["docker", "compose", *compose_options, "-f", compose_file, *command]
-        )
-    except (subprocess.CalledProcessError, FileNotFoundError) as e:
-        try:
-            subprocess.check_output(
-                ["docker-compose", *compose_options, "-f", compose_file, *command]
-            )
-        except (subprocess.CalledProcessError, FileNotFoundError) as _e:
-            raise RuntimeError(
-                f"Error occurred while running {' '.join(command)}: {_e}"
-            ) from _e
+    eth_portfolio_scripts.docker._exec_command(
+        command, compose_file=COMPOSE_FILE, compose_options=compose_options
+    )

dao_treasury/db.py

@@ -18,6 +18,7 @@ and creating SQL views for reporting.
 
 import typing
 from asyncio import Semaphore
+from collections import OrderedDict
 from decimal import Decimal, InvalidOperation
 from functools import lru_cache
 from logging import getLogger
@@ -75,6 +76,9 @@ from dao_treasury.constants import CHAINID
 from dao_treasury.types import TxGroupDbid, TxGroupName
 
 
+EventItem = _EventItem[_EventItem[OrderedDict[str, Any]]]
+
+
 SQLITE_DIR = Path(path.expanduser("~")) / ".dao-treasury"
 """Path to the directory in the user's home where the DAO treasury SQLite database is stored."""
 
@@ -250,6 +254,10 @@ class Address(DbEntity):
     def contract(self) -> Contract:
         return Contract(self.address)
 
+    @property
+    def contract_coro(self) -> Coroutine[Any, Any, Contract]:
+        return Contract.coroutine(self.address)
+
     @staticmethod
     @lru_cache(maxsize=None)
     def get_dbid(address: HexAddress) -> int:
@@ -420,6 +428,10 @@ class Token(DbEntity):
     def contract(self) -> Contract:
         return Contract(self.address.address)
 
+    @property
+    def contract_coro(self) -> Coroutine[Any, Any, Contract]:
+        return Contract.coroutine(self.address.address)
+
     @property
     def scale(self) -> int:
         """Base for division according to `decimals`, e.g., `10**decimals`.
@@ -755,10 +767,10 @@ class TreasuryTx(DbEntity):
     @overload
     def get_events(
         self, event_name: str, sync: Literal[False]
-    ) -> Coroutine[Any, Any, _EventItem]: ...
+    ) -> Coroutine[Any, Any, EventItem]: ...
     @overload
-    def get_events(self, event_name: str, sync: bool = True) -> _EventItem: ...
-    def get_events(self, event_name: str, sync: bool = True) -> _EventItem:
+    def get_events(self, event_name: str, sync: bool = True) -> EventItem: ...
+    def get_events(self, event_name: str, sync: bool = True) -> EventItem:
         if not sync:
             return _EVENTS_THREADS.run(self.get_events, event_name)
         try:

dao_treasury/docker-compose.yaml

@@ -5,7 +5,7 @@ networks:
 
 services:
   grafana:
-    image: grafana/grafana:12.2.0
+    image: grafana/grafana:12.2.1
     ports:
       - 127.0.0.1:${DAO_TREASURY_GRAFANA_PORT:-3004}:3000
     environment:

{dao_treasury-0.0.58.dist-info → dao_treasury-0.0.63.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dao_treasury
-Version: 0.0.58
+Version: 0.0.63
 Summary: Produce comprehensive financial reports for your on-chain org
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -14,7 +14,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.10,<3.13
 Description-Content-Type: text/markdown
-Requires-Dist: eth-portfolio-temp<0.3,>=0.2.8.dev0
+Requires-Dist: eth-portfolio-temp==0.2.15
 Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
@@ -41,7 +41,7 @@ DAO Treasury is a comprehensive financial reporting and treasury management solu
 - First, you will need to bring your own archive node. This can be one you run yourself, or one from one of the common providers (Tenderly, Alchemy, QuickNode, etc.). Your archive node must have tracing enabled (free-tier Alchemy nodes do not support this option).
 - You must configure a [brownie network](https://eth-brownie.readthedocs.io/en/stable/network-management.html) to use your RPC.
 - You will need an auth token for [Etherscan](https://etherscan.io/)'s API. Follow their [guide](https://docs.etherscan.io/etherscan-v2/getting-an-api-key) to get your key, and set env var `ETHERSCAN_TOKEN` with its value.
-- You'll also need [Docker](https://www.docker.com/get-started/) installed on your system. If on MacOS, you will need to leave Docker Desktop open while Yearn Treasury is running.
+- You'll also need [Docker](https://www.docker.com/get-started/) installed on your system. If on MacOS, you will need to leave Docker Desktop open while DAO Treasury is running.
 
 ## Installation
 

{dao_treasury-0.0.58.dist-info → dao_treasury-0.0.63.dist-info}/RECORD

@@ -1,20 +1,20 @@
-dao_treasury__mypyc.cp311-win32.pyd,sha256=WndDytkYX_M-SDoi60HW_pBzmzzljjLstyGHngWcdN8,394240
+dao_treasury__mypyc.cp311-win32.pyd,sha256=jzBAOnQbmEPRrkfj_QwO_-xwxYOZnoXlEtgalzV8sn4,393728
 dao_treasury/ENVIRONMENT_VARIABLES.py,sha256=LS_D4ALB3BO-vYKyh1tzRHi10QBE6f654Zy8pmJ_xPY,656
 dao_treasury/__init__.py,sha256=ai8iALE_Zv43O9cH1jkNJ39bzhr60kBDX6L7C4Nj9FA,1539
-dao_treasury/_docker.cp311-win32.pyd,sha256=PSd7szrfMNOuko0lMG_0nhZGcL-xumkXYSI_LavR0hw,9216
-dao_treasury/_docker.py,sha256=UFMN-TIBUQBheMIhIhSMhaq7UFgt6ubUcfzwPNap_6o,6098
-dao_treasury/_nicknames.cp311-win32.pyd,sha256=7nML0mNW0LocKY8E0rFYLkyqNc5c23rWB_eX0A8h-Fk,9216
+dao_treasury/_docker.cp311-win32.pyd,sha256=7qGFFPgdx9HcZ6S7zcG03Aveqw9VOuXSMdWJpyFcqt4,9216
+dao_treasury/_docker.py,sha256=_kYZn_cIdHbAbyHujUFBxZy_Eu_DwTtLCzQoYNyHQhk,6075
+dao_treasury/_nicknames.cp311-win32.pyd,sha256=lXViqR4m-pBRoCDwWf0IW_XAL_WPge9yAKDJksrqmvE,9216
 dao_treasury/_nicknames.py,sha256=n8c-JZhORYymCMv6jsC96IthAzAhpslyEn-KCk_YiSM,1049
-dao_treasury/_wallet.cp311-win32.pyd,sha256=iw7Fm2ncTV9DmyWfoT88_4g5MfWuIDIPDACcPy9F_go,9216
+dao_treasury/_wallet.cp311-win32.pyd,sha256=OqcjXFGCLOjBcK50IhUB02-jdicTU5i6Ge0AMYz2n_U,9216
 dao_treasury/_wallet.py,sha256=nHBAKFJstdKuYbvpskGVx2KU80YrZHGHsEh5V3TwIHs,10712
-dao_treasury/constants.cp311-win32.pyd,sha256=_5pw6CeANWUvHJgolr8oiXxLSado2emwLjgIYYCC3ZI,9216
+dao_treasury/constants.cp311-win32.pyd,sha256=bYzWM7ZfHtP1NqfVfCpDVJWC5TrT3s1i_S6L1ouOQ9A,9216
 dao_treasury/constants.py,sha256=-T0oPw7lC5YeaiplHAtYL-2ss7knvKrJKQ1LCc8kX8g,1483
-dao_treasury/db.py,sha256=GhWwFYgSgnySsOLARn1aRBoPoYKxGvY8pInBMeVtogc,50262
-dao_treasury/docker-compose.yaml,sha256=jt1RjPzR3unoBXiCq_2144t7cNXK6NwyiSjjcXbHnLU,1350
+dao_treasury/db.py,sha256=3_-nm8vD92ECaHxjMYf0eaXfsBRC2ojGcm-AFz2ZLAQ,50625
+dao_treasury/docker-compose.yaml,sha256=wNNE9xmkchcV-nJxzrmUkbUA0CW1qgdGQKJ7uw2P8nU,1350
 dao_treasury/main.py,sha256=w7VBmBwNBYjOkz2LpT4_9FZ1CI8AVcr4vyfr1wZVk5Q,8458
 dao_treasury/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 dao_treasury/treasury.py,sha256=wh4wESLbYSHjcfpa-sW5TIqa5pSC9Y_7Id8tzLzJLaw,7414
-dao_treasury/types.cp311-win32.pyd,sha256=Ww_QcA8OIXj8avAMutYOmMtnxLQlPMd-2KtVfADN2KI,9216
+dao_treasury/types.cp311-win32.pyd,sha256=7oglWbBw5naRuL8gYsn4PkYgXkYvUfYd7Ks55oJVras,9216
 dao_treasury/types.py,sha256=KFz4WKPp4t_RBwIT6YGwOcgbzw8tdHIOcXTFsUA0pJA,3818
 dao_treasury/.grafana/provisioning/dashboards/dashboards.yaml,sha256=NfmmICGLVfIrI8ulzUTUYc7wFetk2v-x6eaoYHnCvQc,1914
 dao_treasury/.grafana/provisioning/dashboards/breakdowns/Expenses.json,sha256=gxfPI4eO3PDPe70Yx7_dN0Yx5isvgy-MKe-fizBClMw,16879
@@ -28,27 +28,27 @@ dao_treasury/.grafana/provisioning/dashboards/treasury/Current Treasury Assets.j
 dao_treasury/.grafana/provisioning/dashboards/treasury/Historical Treasury Balances.json,sha256=7qVXn2PjeBIp2pFRbVfxA4PeWxhhVKQCr4qIPZoIj90,133963
 dao_treasury/.grafana/provisioning/dashboards/treasury/Operating Cashflow.json,sha256=fYkiZ37Eg2vu9dPJavCZXPPtX6-rTDbJwE_Ougpo2Mk,15828
 dao_treasury/.grafana/provisioning/datasources/datasources.yaml,sha256=gLmJsOkEXNzWRDibShfHFySWeuExW-dSB_U0OSfH868,344
-dao_treasury/sorting/__init__.cp311-win32.pyd,sha256=vOJUPUz5iio1GvT3dfVLZAfKKUhAOrG9_2ybOldTom8,9216
+dao_treasury/sorting/__init__.cp311-win32.pyd,sha256=6HmrOG7soaKwhfm_WuBMQe4cJHKWEx8Dvu5DZ9Q-DFM,9216
 dao_treasury/sorting/__init__.py,sha256=_uxM_FE1paM8oDAhDdHSyhDwnrlxCYX_lGn2DOqCaHU,10666
-dao_treasury/sorting/_matchers.cp311-win32.pyd,sha256=4JtpHejqH3M4HhhPRxE7eOPiDhpm3XlBXysSJDEBhR8,9216
+dao_treasury/sorting/_matchers.cp311-win32.pyd,sha256=hS7ZNxAyKzr3r_a9NrJ7_O7vMZ6QnphQadS8Ph8_Bbo,9216
 dao_treasury/sorting/_matchers.py,sha256=ACi6aXZCKW5OTiztsID7CXCGJounj5c6ivhOCg2436M,14392
-dao_treasury/sorting/_rules.cp311-win32.pyd,sha256=51Yen1z5jwwRWJRF11wqsVcdcFc7tRbrVcY0zwG3yps,9216
+dao_treasury/sorting/_rules.cp311-win32.pyd,sha256=Rk1obO0pNWeax5vwGAzrvsh4bHd-DUAX4xMbZee7wo8,9216
 dao_treasury/sorting/_rules.py,sha256=DxhdUgpS0q0LWeLl9W1Bjn5LZz9z4OLA03vQllPMH9k,9229
-dao_treasury/sorting/factory.cp311-win32.pyd,sha256=4desXwaoqicpzuaFhQsmhvu_PyTY6OKpJIM2VuRHKl8,9216
+dao_treasury/sorting/factory.cp311-win32.pyd,sha256=1Lmg6aO0tF1RvQPAMMo8Uo71L8lb3Am-8GNIO_KycSY,9216
 dao_treasury/sorting/factory.py,sha256=zlJ18xlMTxv8ACV6_MimCVIDsw3K5AZcyvKaNYY7R14,10484
-dao_treasury/sorting/rule.cp311-win32.pyd,sha256=56A3eBLvAwyyRBI7TSO0acLqTfaoDwRunUwDQeV1mGE,9216
+dao_treasury/sorting/rule.cp311-win32.pyd,sha256=Zk9u8K-2q7Nza7Xm9Zu-_VLiBjzMmjBeig4G8aqmBlY,9216
 dao_treasury/sorting/rule.py,sha256=wbL8s0-6dxcCKghUtEDSkLDBnyvggsJ3gt_RawQ6kB4,11972
-dao_treasury/sorting/rules/__init__.cp311-win32.pyd,sha256=VuhMI1HL6BOE0Nw8yhRVvyzoHoDIXc-HnaR0z7Leiz4,9216
+dao_treasury/sorting/rules/__init__.cp311-win32.pyd,sha256=PxByqg4TgnCvdQ6LLX-GjsrVBe7tmC2kLlgArzUTBVc,9216
 dao_treasury/sorting/rules/__init__.py,sha256=hcLfejOEwD8RaM2RE-38Ej6_WkvL9BVGvIIGY848E6E,49
-dao_treasury/sorting/rules/ignore/__init__.cp311-win32.pyd,sha256=SIAWGjKY5DZCq1ngd8-8e-Wynxm9vdtoSGKuShcrIVE,9216
+dao_treasury/sorting/rules/ignore/__init__.cp311-win32.pyd,sha256=opzaEOaexBRGl54DfZUTCJ4o4fTaCYjDKcJrHRyBrzI,9216
 dao_treasury/sorting/rules/ignore/__init__.py,sha256=16THKoGdj6qfkkytuCFVG_R1M6KSErMI4AVE1p0ukS4,58
-dao_treasury/sorting/rules/ignore/llamapay.cp311-win32.pyd,sha256=UKvk2lK0A_5wy3j95EnxzN5NUi6Xal-TZdg4d9xSQAY,9216
+dao_treasury/sorting/rules/ignore/llamapay.cp311-win32.pyd,sha256=WhcwJ0uwV9pQuU1r0cF4ZF6WPGwHuNRn0VYn2GFJF5s,9216
 dao_treasury/sorting/rules/ignore/llamapay.py,sha256=aYyAJRlmv419IeaqkcV5o3ffx0UVfteU0lTl80j0BGo,783
-dao_treasury/streams/__init__.cp311-win32.pyd,sha256=_kCoNo-ozM2X_dyieX81eLUTBGOTkDJX-m66I-eK418,9216
+dao_treasury/streams/__init__.cp311-win32.pyd,sha256=Y9lCeIuidJQ2NEjMaKr89kwE8rD9WC264w1IGECI5ug,9216
 dao_treasury/streams/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-dao_treasury/streams/llamapay.cp311-win32.pyd,sha256=KX1HQFc4gmm1087QsnbPpRBjRWlnMbBdMXRjr6SUENE,9216
+dao_treasury/streams/llamapay.cp311-win32.pyd,sha256=CqCh5hyBig2jM9qwmGaW6aD8vOkFb2EPKwx3-g7ffds,9216
 dao_treasury/streams/llamapay.py,sha256=rO1Mh2ndTziR6pnRkKHnQ22a_Yx9PM_-BG7I4dspEZ8,13535
-dao_treasury-0.0.58.dist-info/METADATA,sha256=fdAHv_gbvBgjxYMzYLctnui3rGlXTlrcSWt1jMEdXjo,7242
-dao_treasury-0.0.58.dist-info/WHEEL,sha256=Ri8zddKrjGdgjlj1OpSsvpDnvHfnQhMQWi3E_v2pqng,97
-dao_treasury-0.0.58.dist-info/top_level.txt,sha256=CV8aYytuSYplDhLVY4n0GphckdysXCd1lHmbqfsPxNk,33
-dao_treasury-0.0.58.dist-info/RECORD,,
+dao_treasury-0.0.63.dist-info/METADATA,sha256=GhFbPwSJ9WZqXB_PhIGxv3MFPMtvWFSaMd-PX4xk6FI,7231
+dao_treasury-0.0.63.dist-info/WHEEL,sha256=Ri8zddKrjGdgjlj1OpSsvpDnvHfnQhMQWi3E_v2pqng,97
+dao_treasury-0.0.63.dist-info/top_level.txt,sha256=CV8aYytuSYplDhLVY4n0GphckdysXCd1lHmbqfsPxNk,33
+dao_treasury-0.0.63.dist-info/RECORD,,