Coverage for src/PythonMetaTrader5/connection.py: 100%
28 statements
« prev ^ index » next coverage.py v7.17.3, created at 2026-11-12 12:29 +0000
« prev ^ index » next coverage.py v7.17.3, created at 2026-11-12 12:29 +0000
1"""Composition root: wires the real adapters into a Trader."""
3from __future__ import annotations
5import logging
7from PythonMetaTrader5.adapters.mt5_terminal import MetaTrader5Terminal
8from PythonMetaTrader5.adapters.system_clock import SystemClock
9from PythonMetaTrader5.application.execution import RetryPolicy
10from PythonMetaTrader5.application.ports import Credentials, parse_login
11from PythonMetaTrader5.application.trader import Trader
12from PythonMetaTrader5.domain.errors import ErrorKind, TradeError
13from PythonMetaTrader5.domain.inputs import own_magic
14from PythonMetaTrader5.result import Err, Ok, Result
16log = logging.getLogger("PythonMetaTrader5")
19def connect(
20 login: int | str,
21 password: str,
22 server: str,
23 *,
24 path: str | None = None,
25 timeout_ms: int = 60_000,
26 magic: int = 0,
27 deviation: int = 10,
28 retry: RetryPolicy | None = None,
29) -> Result[Trader, TradeError]:
30 """Start (or attach to) the MT5 terminal, log in, and return a ready Trader."""
31 account = parse_login(login)
32 if account is None:
33 return Err(
34 TradeError(
35 ErrorKind.INVALID_ARGUMENT, f"login must be a positive integer, got {login!r}"
36 )
37 )
38 own = own_magic(magic)
39 if isinstance(own, Err):
40 return own
41 loaded = MetaTrader5Terminal.load()
42 if isinstance(loaded, Err):
43 return loaded
44 terminal = loaded.value
45 credentials = Credentials(account, str(password), str(server), path, timeout_ms)
46 connected = terminal.connect(credentials)
47 if isinstance(connected, Err):
48 return connected
49 # Login and server only: account_info() also carries the owner's name and
50 # balance, which do not belong in application logs.
51 log.info("connected to %s as %s", server, account)
52 return Ok(Trader(terminal, SystemClock(), magic=own.value, deviation=deviation, retry=retry))