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

1"""Composition root: wires the real adapters into a Trader.""" 

2 

3from __future__ import annotations 

4 

5import logging 

6 

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 

15 

16log = logging.getLogger("PythonMetaTrader5") 

17 

18 

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))