twrate 0.1.1__py3-none-any.whl

twrate/__init__.py

@@ -0,0 +1,16 @@
+import os
+from typing import Final
+
+from loguru import logger
+from rich.logging import RichHandler
+
+LOGURU_LEVEL: Final[str] = os.getenv("LOGURU_LEVEL", "INFO")
+logger.configure(
+    handlers=[
+        {
+            "sink": RichHandler(show_time=False, omit_repeated_times=False, show_level=False, show_path=False),
+            "level": LOGURU_LEVEL,
+            # "format": "{time:YYYY-MM-DD HH:mm:ss,SSS} {level: <8} '{name}:{function}:{line}' {message}",
+        },
+    ]
+)

twrate/cli.py

@@ -0,0 +1,5 @@
+from loguru import logger
+
+
+def main() -> None:
+    logger.info("Hello, world!")

twrate/dbs.py

@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+from datetime import datetime
+
+import httpx
+from pydantic import BaseModel
+from pydantic import Field
+from pydantic import field_validator
+
+from .types import Rate
+
+# https://www.dbs.com.tw/personal-zh/rates/foreign-exchange-rates.page
+
+
+class RecDatum(BaseModel):
+    currency: str
+    tt_sell: float = Field(..., validation_alias="ttSell")
+    tt_buy: float = Field(..., validation_alias="ttBuy")
+    cash_sell: float | None = Field(..., validation_alias="cashSell")
+    cash_buy: float | None = Field(..., validation_alias="cashBuy")
+
+    @field_validator("tt_sell", "tt_buy", "cash_sell", "cash_buy", mode="before")
+    @classmethod
+    def convert_to_float(cls, value: str | None) -> float | None:
+        if value is None:
+            return None
+        return float(value)
+
+
+class Asset(BaseModel):
+    rec_data: list[RecDatum] = Field(..., validation_alias="recData")
+
+
+class Results(BaseModel):
+    assets: list[Asset]
+
+
+class DBSRateResponse(BaseModel):
+    total: int
+    start: int
+    included: int
+    results: Results
+    last_updated_date_and_time: datetime = Field(..., validation_alias="lastUpdatedDateAndTime")
+    effective_date_and_time: datetime = Field(..., validation_alias="effectiveDateAndTime")
+
+    @field_validator("total", "start", "included", mode="before")
+    @classmethod
+    def convert_to_int(cls, value: str) -> int:
+        return int(value)
+
+    @field_validator("last_updated_date_and_time", "effective_date_and_time", mode="before")
+    @classmethod
+    def convert_to_str(cls, value: str) -> datetime:
+        return datetime.strptime(value, "%Y-%m-%d %H:%M:%S")
+
+    def to_rates(self) -> list[Rate]:
+        rates = []
+        for asset in self.results.assets:
+            for rec_data in asset.rec_data:
+                rate = Rate(
+                    exchange="DBS",
+                    source=rec_data.currency,
+                    target="TWD",
+                    spot_buy_rate=rec_data.tt_buy,
+                    spot_sell_rate=rec_data.tt_sell,
+                    cash_buy_rate=rec_data.cash_buy,
+                    cash_sell_rate=rec_data.cash_sell,
+                )
+                rates.append(rate)
+        return rates
+
+
+def query_dbs_rates() -> list[Rate]:
+    url = "https://www.dbs.com.tw/tw-rates-api/v1/api/twrates/latestForexRates"
+    resp = httpx.get(url=url)
+    resp.raise_for_status()
+    return DBSRateResponse.model_validate(resp.json()).to_rates()

twrate/types.py

@@ -0,0 +1,27 @@
+from pydantic import BaseModel
+
+
+class Rate(BaseModel):
+    exchange: str
+    source: str
+    target: str
+    spot_buy_rate: float | None = None
+    spot_sell_rate: float | None = None
+    cash_buy_rate: float | None = None
+    cash_sell_rate: float | None = None
+
+    @property
+    def spot_mid_rate(self) -> float:
+        if self.spot_buy_rate is None or self.spot_sell_rate is None:
+            raise ValueError("spot_buy_rate and spot_sell_rate must be set to calculate mid rate")
+        return (self.spot_buy_rate + self.spot_sell_rate) / 2
+
+    @property
+    def cash_mid_rate(self) -> float:
+        if self.cash_buy_rate is None or self.cash_sell_rate is None:
+            raise ValueError("cash_buy_rate and cash_sell_rate must be set to calculate mid rate")
+        return (self.cash_buy_rate + self.cash_sell_rate) / 2
+
+    @property
+    def symbol(self) -> str:
+        return f"{self.source}/{self.target}"

twrate-0.1.1.dist-info/METADATA

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: twrate
+Version: 0.1.1
+Author-email: narumi <toucans-cutouts0f@icloud.com>
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pydantic>=2.11.4
+Requires-Dist: rich>=14.0.0
+Description-Content-Type: text/markdown
+
+# twrate

twrate-0.1.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+twrate/__init__.py,sha256=PbTPNrGXUI56OMKt9MjTHKy71yyr5teQs6-a-AuGYVE,477
+twrate/cli.py,sha256=aArjRIzAPPy-Rwtl3blyrgB1fxMYKmVeurdEnEPVx2I,81
+twrate/dbs.py,sha256=-zoIT0IdcQehLImY7tB5qpYT3vBlP33HRGZzFq7sDb4,2460
+twrate/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+twrate/types.py,sha256=arSRHwSjJ3PHkM4suDjZwh1St7TtgSqpDWNtEQ_l1fM,922
+twrate-0.1.1.dist-info/METADATA,sha256=StM6OLEfIvt2j0qRpmpidHhOwNA-JdpxkBGBPiqBwIw,315
+twrate-0.1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+twrate-0.1.1.dist-info/entry_points.txt,sha256=VTH4yoIXAcULcESrlUrk6Yy4n9Hg7IFfpal8S_6-2YY,43
+twrate-0.1.1.dist-info/licenses/LICENSE,sha256=H2T3_RTgmcngMeC7p_SXT3GwBLkd2DaNgAZuxulcfiA,1066
+twrate-0.1.1.dist-info/RECORD,,

twrate-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

twrate-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+twrate = twrate.cli:main

twrate-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 なるみ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.