fixcore-engine 0.1.0__py3-none-any.whl

fixcore/transport/framer.py

@@ -0,0 +1,107 @@
+"""MessageFramer — splits a raw TCP byte stream into complete FIX messages.
+
+FIX message structure on the wire::
+
+    8=FIX.4.2\\x01          ← BeginString  (variable length)
+    9=<body_length>\\x01    ← BodyLength   (variable length)
+    35=A\\x01...            ← body         (exactly body_length bytes)
+    10=NNN\\x01             ← CheckSum     (always exactly 7 bytes: "10=" + 3 digits + SOH)
+
+Framing algorithm:
+1. Scan for ``8=`` to sync to the start of a message.
+2. Parse ``9=<N>\\x01`` to read BodyLength.
+3. Wait until the buffer holds prefix + N + 7 bytes.
+4. Slice out the complete message and repeat.
+"""
+
+from __future__ import annotations
+
+# CheckSum field is always "10=NNN\x01" — exactly 7 bytes.
+_CHECKSUM_LEN = 7
+
+
+class MessageFramer:
+    """Stateful byte-stream framer for FIX messages.
+
+    Feed raw bytes in any chunk size; complete messages are returned.
+
+    Example::
+
+        framer = MessageFramer()
+        for raw_msg in framer.feed(socket_data):
+            process(raw_msg)
+    """
+
+    def __init__(self) -> None:
+        self._buf: bytearray = bytearray()
+
+    def feed(self, data: bytes) -> list[bytes]:
+        """Append *data* to the internal buffer and return all complete messages."""
+        self._buf.extend(data)
+        messages: list[bytes] = []
+        while True:
+            msg = self._try_extract()
+            if msg is None:
+                break
+            messages.append(msg)
+        return messages
+
+    def reset(self) -> None:
+        """Discard all buffered bytes."""
+        self._buf.clear()
+
+    # ------------------------------------------------------------------
+    # Internal
+    # ------------------------------------------------------------------
+
+    def _try_extract(self) -> bytes | None:
+        buf = self._buf
+
+        # ── 1. Sync to BeginString ────────────────────────────────────
+        start = buf.find(b"8=")
+        if start == -1:
+            # Keep a trailing '8' — it may be the first byte of '8=' once more data arrives
+            if buf and buf[-1] == ord("8"):
+                del buf[:-1]
+            else:
+                buf.clear()
+            return None
+        if start > 0:
+            del buf[:start]  # discard garbage before 8=
+
+        # ── 2. Find end of BeginString field ─────────────────────────
+        bs_soh = buf.find(b"\x01")
+        if bs_soh == -1:
+            return None  # incomplete BeginString
+
+        # ── 3. Parse BodyLength field (must immediately follow) ───────
+        bl_start = bs_soh + 1
+        if len(buf) < bl_start + 3:  # need at least "9=X"
+            return None
+
+        if buf[bl_start : bl_start + 2] != b"9=":
+            # Malformed — skip past this "8=" and retry
+            del buf[:2]
+            return None
+
+        bl_soh = buf.find(b"\x01", bl_start + 2)
+        if bl_soh == -1:
+            return None  # incomplete BodyLength field
+
+        try:
+            body_length = int(buf[bl_start + 2 : bl_soh])
+        except ValueError:
+            # Corrupt BodyLength — drop up to and including this SOH
+            del buf[: bl_soh + 1]
+            return None
+
+        # ── 4. Wait for full message ──────────────────────────────────
+        body_start = bl_soh + 1
+        total = body_start + body_length + _CHECKSUM_LEN
+
+        if len(buf) < total:
+            return None
+
+        msg = bytes(buf[:total])
+        del buf[:total]
+        return msg

fixcore/transport/initiator.py

@@ -0,0 +1,146 @@
+"""SocketInitiator — manages outbound FIX connections with auto-reconnect."""
+
+from __future__ import annotations
+
+import asyncio
+
+from fixcore.application import Application
+from fixcore.log.base import LogFactory
+from fixcore.session.session import Session
+from fixcore.session.session_id import SessionID
+from fixcore.session.session_settings import SessionSettings
+from fixcore.store.factory import StoreFactory
+from fixcore.transport.framer import MessageFramer
+
+
+class SocketInitiator:
+    """Dials outbound TCP connections for each configured initiator session.
+
+    Each session runs in its own :func:`asyncio.create_task` loop.  On
+    disconnect the loop waits ``ReconnectInterval`` seconds (default 10) and
+    tries again until :meth:`stop` is called.
+
+    Usage::
+
+        initiator = SocketInitiator(settings, app, store_factory, log_factory)
+        async with initiator:
+            await asyncio.sleep(3600)
+    """
+
+    def __init__(
+        self,
+        settings: SessionSettings,
+        application: Application,
+        store_factory: StoreFactory,
+        log_factory: LogFactory,
+    ) -> None:
+        self._settings = settings
+        self._app = application
+        self._store_factory = store_factory
+        self._log_factory = log_factory
+
+        self._sessions: dict[SessionID, Session] = {}
+        self._tasks: list[asyncio.Task[None]] = []
+        self._stop_event = asyncio.Event()
+
+        for sid in settings.session_ids:
+            conn_type = settings.get_or(sid, "ConnectionType", "initiator").lower()
+            if conn_type == "initiator":
+                self._sessions[sid] = Session(
+                    sid, settings, application,
+                    store_factory.create(sid),
+                    log_factory.create(sid),
+                )
+
+    # ------------------------------------------------------------------
+    # Lifecycle
+    # ------------------------------------------------------------------
+
+    async def start(self) -> None:
+        """Launch a connect-loop task for each configured initiator session."""
+        self._stop_event.clear()
+        for sid, session in self._sessions.items():
+            task = asyncio.create_task(
+                self._connect_loop(sid, session),
+                name=f"initiator-{sid}",
+            )
+            self._tasks.append(task)
+
+    async def stop(self) -> None:
+        """Signal all connect loops to exit and wait for them to finish."""
+        self._stop_event.set()
+        if self._tasks:
+            await asyncio.gather(*self._tasks, return_exceptions=True)
+            self._tasks.clear()
+
+    async def __aenter__(self) -> "SocketInitiator":
+        await self.start()
+        return self
+
+    async def __aexit__(self, *_: object) -> None:
+        await self.stop()
+
+    @property
+    def sessions(self) -> dict[SessionID, Session]:
+        return dict(self._sessions)
+
+    # ------------------------------------------------------------------
+    # Per-session connect loop
+    # ------------------------------------------------------------------
+
+    async def _connect_loop(self, sid: SessionID, session: Session) -> None:
+        host = self._settings.get(sid, "SocketConnectHost")
+        port = int(self._settings.get(sid, "SocketConnectPort"))
+        reconnect = self._settings.get_int(sid, "ReconnectInterval", 10)
+
+        while not self._stop_event.is_set():
+            try:
+                reader, writer = await asyncio.open_connection(host, port)
+            except OSError:
+                # Connection refused or network error — wait and retry
+                await self._interruptible_sleep(reconnect)
+                continue
+
+            framer = MessageFramer()
+
+            async def send_fn(data: bytes, _w: asyncio.StreamWriter = writer) -> None:
+                _w.write(data)
+                await _w.drain()
+
+            await session.on_connect(send_fn)
+
+            try:
+                while not self._stop_event.is_set():
+                    try:
+                        data = await asyncio.wait_for(reader.read(4096), timeout=1.0)
+                    except asyncio.TimeoutError:
+                        continue
+                    except (ConnectionResetError, asyncio.IncompleteReadError):
+                        break
+                    if not data:
+                        break
+
+                    for raw_msg in framer.feed(data):
+                        await session.on_data(raw_msg)
+
+            finally:
+                await session.on_disconnect()
+                try:
+                    writer.close()
+                    await writer.wait_closed()
+                except Exception:
+                    pass
+                framer.reset()
+
+            if not self._stop_event.is_set():
+                await self._interruptible_sleep(reconnect)
+
+    async def _interruptible_sleep(self, seconds: float) -> None:
+        """Sleep for *seconds* but wake immediately if stop is requested."""
+        try:
+            await asyncio.wait_for(
+                asyncio.shield(self._stop_event.wait()),
+                timeout=seconds,
+            )
+        except asyncio.TimeoutError:
+            pass

fixcore_engine-0.1.0.dist-info/METADATA

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: fixcore-engine
+Version: 0.1.0
+Summary: Pure Python FIX protocol engine
+Author-email: Aidan Chisholm <aidan.chisholm@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Aidan Alexander Chisholm
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/aidan-chisholm/fixcore
+Project-URL: Repository, https://github.com/aidan-chisholm/fixcore
+Keywords: fix,financial,protocol,trading,quickfix
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Provides-Extra: gui
+Requires-Dist: aiohttp>=3.9; extra == "gui"
+Dynamic: license-file
+
+<img src="fixcore_logo.svg" alt="FIXcore" width="340" />
+
+Pure Python FIX protocol engine — mirrors the QuickFIX architecture (QuickFIX/n, QuickFIX/J).
+
+## Features
+
+- Full FIX 4.2 session layer (Logon, Logout, Heartbeat, ResendRequest, SequenceReset, Reject)
+- Message encoding/decoding with DataDictionary validation
+- Repeating groups
+- Async transport: `SocketAcceptor` + `SocketInitiator` with auto-reconnect
+- `FileStore` and `MemoryStore` persistence
+- `MessageCracker` dispatch mixin
+- Lightweight browser GUI via aiohttp (`tools/fix_gui.py`) — session management, message builder, live message log
+
+## Quick start
+
+```bash
+pip install fixcore-engine
+pip install "fixcore-engine[gui]"  # includes aiohttp for the GUI
+```
+
+## Development
+
+```bash
+pip install -e ".[dev,gui]"
+pytest
+python tools/fix_gui.py
+```

fixcore_engine-0.1.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+fixcore/__init__.py,sha256=kB3VWakZe8vfRllMdcPwFI7cIEnLKeVQKccgwvyjLuI,189
+fixcore/application.py,sha256=NF3bZ9e61PVTkH6MecMJHPY85Q26blxkq7eJ0zBis0Q,1658
+fixcore/log/__init__.py,sha256=LhtRdV8djjICrNRha-_hvWO44P8-SEJLGaBazfSTOnc,316
+fixcore/log/base.py,sha256=Tuyre4h2Cngw_hloB0749jRCMRKhLxF-HHbv56sHCJQ,695
+fixcore/log/factory.py,sha256=qYMSkel0w251ZWiBbtHiqpxejWmi1vfqXmw7CtSzM4A,384
+fixcore/log/file_log.py,sha256=6jaL--3idj8mjahnOi_kz4cEc9GTt1fgKDaiNy5YRD8,2177
+fixcore/log/screen.py,sha256=jQ6HsGpoYPNY1duASqosl6js5dQXX07Zm_f1bFTySMI,931
+fixcore/message/__init__.py,sha256=ITFr0KySajGvyMfCxVx430MUQSbDaCSWEhmVAv7kfCY,708
+fixcore/message/cracker.py,sha256=97xdfUeLJV2PmbDn4HJQVYbW5Zn4A5dGfwgI9jCsKs0,9160
+fixcore/message/data_dictionary.py,sha256=at1Pc0Ku7j2LMw2FEp7GA428v3aYCr88WzbxDy456Xs,11270
+fixcore/message/exceptions.py,sha256=SzjVpX0gs79lVeN5UdLhzSawBhph4T-GZx8S2jkkx_c,629
+fixcore/message/field.py,sha256=M9oi9upU5douqaG5iCxZDQB3SmOzzaIEqEMpxbN0Bgc,5018
+fixcore/message/message.py,sha256=pZNMSBbxKYON19CIq6gvlK4SzMVHcs7FPDZXVEfjqOE,13610
+fixcore/session/__init__.py,sha256=cVkPLJ_DzB3A7Z8ssQb7-FAr09n8_mnwdCHM4C7iMxI,344
+fixcore/session/session.py,sha256=LE2O7qOka5A8zUv8smoGgD0NEx5HsWta5kr42GpVSeY,20317
+fixcore/session/session_id.py,sha256=ykKDV38P6RRnC1uMDdKGKoFNLwOCl8rfjRPo5x444mA,880
+fixcore/session/session_settings.py,sha256=epx6aflPKrwSwL3CswnRmqqrLzWqdsxCYgH8z0EzzsU,5032
+fixcore/session/state.py,sha256=gazczlRCpSibNHFVxY_yiQRCzIMxxFf_V9j2OPP_K4Y,1537
+fixcore/store/__init__.py,sha256=co8EEl5aKMVI_9MHpsM8Gmhr_yIJA5xWu6cJ3-7TD68,431
+fixcore/store/base.py,sha256=nrpDlrU9L_htCpwpnNMhKJAM04FPZ0yjkWdwGOkdcMA,1577
+fixcore/store/factory.py,sha256=iZvAiITaZrwg2-SJjjc7r2_m7CNsdmc_8Ama_8CpVJg,990
+fixcore/store/file_store.py,sha256=Ih_15nohYDq5dI6BtO7cs87Bt1VpwVzTwfP_zkVP8GI,5469
+fixcore/store/memory.py,sha256=AkGsjXh1oTM-CXZEzsNpQWZXMRQ485GgXdRupPG-08U,1421
+fixcore/transport/__init__.py,sha256=EuZg6qPwWOMuoFPcgvBjDX2bFYsi5QjhpEwNa87oIPk,296
+fixcore/transport/acceptor.py,sha256=4fnxGaZdzHAgfS_L3Wku729xGhczRd3oizrz9pEsy1U,5933
+fixcore/transport/framer.py,sha256=tReh1gLDtX8yv3wlNO4Y1CTMx91WpseuUPxMnkSU4_o,3643
+fixcore/transport/initiator.py,sha256=mwRa4QRrCEDHkoCzpWrByIYAf4JjF9EbZK6HZnxnIf4,5169
+fixcore_engine-0.1.0.dist-info/licenses/LICENSE,sha256=CZx7yTfXMKsRzuWtSQetjP_1vrKdPY2AJIVbRA7H9eM,1081
+fixcore_engine-0.1.0.dist-info/METADATA,sha256=4upgAZxM_JdNPqSGI0OhRCMrRKM5SEO15oZekedkNRA,3028
+fixcore_engine-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+fixcore_engine-0.1.0.dist-info/top_level.txt,sha256=0K_SIcbEjG9Y6KafA3APKFq5S4ZizMkDmycBA41Lchk,8
+fixcore_engine-0.1.0.dist-info/RECORD,,

fixcore_engine-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fixcore_engine-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aidan Alexander Chisholm
+
+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.

fixcore_engine-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fixcore