itchfeed 1.0.5__tar.gz → 1.0.6__tar.gz

{itchfeed-1.0.5/itchfeed.egg-info → itchfeed-1.0.6}/PKG-INFO

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: itchfeed
-Version: 1.0.5
+Version: 1.0.6
 Summary: Simple parser for ITCH messages
-Home-page: https://github.com/bbalouki/itch
-Download-URL: https://pypi.org/project/itchfeed/
-Author: Bertin Balouki SIMYELI
-Author-email: <bertin@bbstrader.com>
-Maintainer: Bertin Balouki SIMYELI
-License: The MIT License (MIT)
+Author-email: Bertin Balouki SIMYELI <bertin@bbs-trading.com>
+Maintainer-email: Bertin Balouki SIMYELI <bertin@bbs-trading.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/bbalouki/itch
+Project-URL: Download, https://pypi.org/project/itchfeed/
 Project-URL: Source Code, https://github.com/bbalouki/itch
 Keywords: Finance,Financial,Quantitative,Equities,Totalview-ITCH,Totalview,Nasdaq-ITCH,Nasdaq,ITCH,Data,Feed,ETFs,Funds,Trading,Investing
 Classifier: Development Status :: 5 - Production/Stable
@@ -19,20 +18,7 @@ Classifier: Operating System :: OS Independent
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pytest
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: download-url
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
 Dynamic: license-file
-Dynamic: maintainer
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: summary
 
 # Nasdaq TotalView-ITCH 5.0 Parser
 [![PYPI Version](https://img.shields.io/pypi/v/itchfeed)](https://pypi.org/project/itchfeed/)
@@ -111,6 +97,8 @@ After installation (typically via pip), import the necessary modules directly in
 
 ## Usage
 
+Download some sample data [here](https://emi.nasdaq.com/ITCH/Nasdaq%20ITCH/)
+
 ### Parsing from a Binary File
 
 This is useful for processing historical ITCH data stored in files. The `MessageParser` handles buffering efficiently.
@@ -131,9 +119,8 @@ parser = MessageParser() # Parses all messages by default
 
 # Path to your ITCH 5.0 data file
 itch_file_path = 'path/to/your/data'
-# you can find sample data [here](https://emi.nasdaq.com/ITCH/Nasdaq%20ITCH/)
 
-# The `read_message_from_file()` method reads the ITCH data in chunks.
+# The `parse_file()` method reads the ITCH data in chunks.
 # - `cachesize` (optional, default: 65536 bytes): This parameter determines the size of data chunks
 #   read from the file at a time. Adjusting this might impact performance for very large files
 #   or memory usage, but the default is generally suitable.
@@ -144,13 +131,9 @@ itch_file_path = 'path/to/your/data'
 
 try:
     with open(itch_file_path, 'rb') as itch_file:
-        # read_message_from_file returns a list of parsed message objects
-        parsed_messages = parser.read_message_from_file(itch_file) # You can also pass cachesize here, e.g., parser.read_message_from_file(itch_file, cachesize=131072)
-
-        print(f"Parsed {len(parsed_messages)} messages.")
-
+        # parse_file returns an Iterator of parsed message objects
         # Process the messages
-        for message in parsed_messages:
+        for message in parser.parse_file(itch_file):
             # Access attributes directly
             print(f"Type: {message.message_type.decode()}, Timestamp: {message.timestamp}")
 
@@ -192,14 +175,8 @@ parser = MessageParser()
 # Example: \x00\x0bS...\x00\x25R...\x00\x27F...
 raw_binary_data: bytes = b"..." # Your raw ITCH 5.0 data chunk
 
-# read_message_from_bytes returns a queue of parsed message objects
-message_queue: Queue = parser.read_message_from_bytes(raw_binary_data)
-
-print(f"Parsed {message_queue.qsize()} messages from the byte chunk.")
-
-# Process messages from the queue
-while not message_queue.empty():
-    message = message_queue.get()
+# parse_stream returns an Iterator of parsed message objects
+for message in parser.parse_stream(raw_binary_data)
 
     print(f"Type: {message.message_type.decode()}, Timestamp: {message.timestamp}")
 
@@ -462,11 +439,12 @@ Common scenarios that can lead to a `ValueError` include:
 
 It's crucial to anticipate these errors in your application:
 
-*   **Use `try-except` Blocks:** Wrap your parsing calls (especially `read_message_from_file` or `read_message_from_bytes`) in `try-except ValueError as e:` blocks.
+*   **Use `try-except` Blocks:** Wrap your parsing calls (especially `parse_file` or `parse_stream`) in `try-except ValueError as e:` blocks.
     ```python
     try:
         # ... parsing operations ...
-        messages = parser.read_message_from_file(itch_file)
+        for message in parser.parse_file(itch_file):
+            ...
     except ValueError as e:
         print(f"An error occurred during parsing: {e}")
         # Log the error, problematic data chunk, or take other actions

{itchfeed-1.0.5 → itchfeed-1.0.6}/README.md

@@ -75,6 +75,8 @@ After installation (typically via pip), import the necessary modules directly in
 
 ## Usage
 
+Download some sample data [here](https://emi.nasdaq.com/ITCH/Nasdaq%20ITCH/)
+
 ### Parsing from a Binary File
 
 This is useful for processing historical ITCH data stored in files. The `MessageParser` handles buffering efficiently.
@@ -95,9 +97,8 @@ parser = MessageParser() # Parses all messages by default
 
 # Path to your ITCH 5.0 data file
 itch_file_path = 'path/to/your/data'
-# you can find sample data [here](https://emi.nasdaq.com/ITCH/Nasdaq%20ITCH/)
 
-# The `read_message_from_file()` method reads the ITCH data in chunks.
+# The `parse_file()` method reads the ITCH data in chunks.
 # - `cachesize` (optional, default: 65536 bytes): This parameter determines the size of data chunks
 #   read from the file at a time. Adjusting this might impact performance for very large files
 #   or memory usage, but the default is generally suitable.
@@ -108,13 +109,9 @@ itch_file_path = 'path/to/your/data'
 
 try:
     with open(itch_file_path, 'rb') as itch_file:
-        # read_message_from_file returns a list of parsed message objects
-        parsed_messages = parser.read_message_from_file(itch_file) # You can also pass cachesize here, e.g., parser.read_message_from_file(itch_file, cachesize=131072)
-
-        print(f"Parsed {len(parsed_messages)} messages.")
-
+        # parse_file returns an Iterator of parsed message objects
         # Process the messages
-        for message in parsed_messages:
+        for message in parser.parse_file(itch_file):
             # Access attributes directly
             print(f"Type: {message.message_type.decode()}, Timestamp: {message.timestamp}")
 
@@ -156,14 +153,8 @@ parser = MessageParser()
 # Example: \x00\x0bS...\x00\x25R...\x00\x27F...
 raw_binary_data: bytes = b"..." # Your raw ITCH 5.0 data chunk
 
-# read_message_from_bytes returns a queue of parsed message objects
-message_queue: Queue = parser.read_message_from_bytes(raw_binary_data)
-
-print(f"Parsed {message_queue.qsize()} messages from the byte chunk.")
-
-# Process messages from the queue
-while not message_queue.empty():
-    message = message_queue.get()
+# parse_stream returns an Iterator of parsed message objects
+for message in parser.parse_stream(raw_binary_data)
 
     print(f"Type: {message.message_type.decode()}, Timestamp: {message.timestamp}")
 
@@ -426,11 +417,12 @@ Common scenarios that can lead to a `ValueError` include:
 
 It's crucial to anticipate these errors in your application:
 
-*   **Use `try-except` Blocks:** Wrap your parsing calls (especially `read_message_from_file` or `read_message_from_bytes`) in `try-except ValueError as e:` blocks.
+*   **Use `try-except` Blocks:** Wrap your parsing calls (especially `parse_file` or `parse_stream`) in `try-except ValueError as e:` blocks.
     ```python
     try:
         # ... parsing operations ...
-        messages = parser.read_message_from_file(itch_file)
+        for message in parser.parse_file(itch_file):
+            ...
     except ValueError as e:
         print(f"An error occurred during parsing: {e}")
         # Log the error, problematic data chunk, or take other actions

itchfeed-1.0.6/itch/__init__.py

@@ -0,0 +1,17 @@
+"""
+Nasdaq TotalView-ITCH 5.0 Parser
+"""
+
+__author__ = "Bertin Balouki SIMYELI"
+__copyright__ = "2025 Bertin Balouki SIMYELI"
+__email__ = "bertin@bbs-trading.com"
+__license__ = "MIT"
+
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("itchfeed")
+except PackageNotFoundError:
+    __version__ = "unknown"
+
+

{itchfeed-1.0.5 → itchfeed-1.0.6}/itch/messages.py

@@ -46,7 +46,7 @@ class MarketMessage(object):
     def __bytes__(self) -> bytes:
         return self.to_bytes()
 
-    def to_bytes(self) -> bytes:
+    def to_bytes(self) -> bytes: # type: ignore
         """
         Packs the message into bytes using the defined message_pack_format.
         This method should be overridden by subclasses to include specific fields.
@@ -109,9 +109,7 @@ class MarketMessage(object):
         ts1 = self.timestamp >> 32
         ts2 = self.timestamp - (ts1 << 32)
         return (ts1, ts2)
-        ts1 = self.timestamp >> 32
-        ts2 = self.timestamp - (ts1 << 32)
-        return (ts1, ts2)
+
 
     def decode_price(self, price_attr: str) -> float:
         precision = getattr(self, "price_precision")

{itchfeed-1.0.5 → itchfeed-1.0.6}/itch/parser.py

@@ -1,4 +1,4 @@
-from typing import IO, BinaryIO, Iterator
+from typing import IO, BinaryIO, Callable, Iterator, Optional, Tuple
 
 from itch.messages import MESSAGES, MarketMessage
 from itch.messages import messages as msgs
@@ -13,8 +13,70 @@ class MessageParser(object):
     def __init__(self, message_type: bytes = MESSAGES):
         self.message_type = message_type
 
-    def read_message_from_file(
-        self, file: BinaryIO, cachesize: int = 65_536, save_file: IO = None
+    def get_message_type(self, message: bytes) -> MarketMessage:
+        """
+        Take an entire bytearray and return the appropriate ITCH message
+        instance based on the message type indicator (first byte of the message).
+
+        All message type indicators are single ASCII characters.
+        """
+        message_type = message[0:1]
+        try:
+            return msgs[message_type](message)  # type: ignore
+        except Exception:
+            raise ValueError(
+                f"Unknown message type: {message_type.decode(encoding='ascii')}"
+            )
+
+    def _parse_message_from_buffer(
+        self, buffer: memoryview, offset: int
+    ) -> Optional[Tuple[MarketMessage, int]]:
+        """
+        Parses a single ITCH message from a memory buffer.
+
+        This method checks for a 2-byte header (a null byte and a length byte),
+        determines the full message size, and extracts the message if the
+        complete message is present in the buffer.
+
+        Args:
+            buffer (memoryview):
+                The buffer containing the binary data.
+            offset (int):
+                The starting position in the buffer to begin parsing.
+
+        Returns:
+            Optional[Tuple[MarketMessage, int]]:
+                A tuple containing the parsed MarketMessage and the total length
+                of the message including the header. Returns None if a complete
+                message could not be parsed.
+
+        Raises:
+            ValueError:
+                If the data at the current offset does not start with the
+                expected 0x00 byte.
+        """
+        buffer_len = len(buffer)
+        if offset + 2 > buffer_len:
+            return None
+
+        if buffer[offset : offset + 1] != b"\x00":
+            raise ValueError(
+                f"Unexpected start byte at offset {offset}: "
+                f"{buffer[offset : offset + 1].tobytes()}"
+            )
+
+        msg_len = buffer[offset + 1]
+        total_len = 2 + msg_len
+
+        if offset + total_len > buffer_len:
+            return None
+
+        raw_msg = buffer[offset + 2 : offset + total_len]
+        message = self.get_message_type(raw_msg.tobytes())
+        return message, total_len
+
+    def parse_file(
+        self, file: BinaryIO, cachesize: int = 65_536, save_file: Optional[IO] = None
     ) -> Iterator[MarketMessage]:
         """
         Reads and parses market messages from a binary file-like object.
@@ -55,7 +117,7 @@ class MessageParser(object):
             >>> with gzip.open(data_file, "rb") as itch_file:
             >>> message_count = 0
             >>> start_time = time.time()
-            >>> for message in parser.read_message_from_file(itch_file):
+            >>> for message in parser.parse_file(itch_file):
             >>>     message_count += 1
             >>>     if message_count <= 5:
             >>>         print(message)
@@ -66,46 +128,24 @@ class MessageParser(object):
         if not file.readable():
             raise ValueError("file must be opened in binary read mode")
 
-        if save_file is not None:
-            if not save_file.writable():
-                raise ValueError("save_file must be opened in binary write mode")
+        if save_file is not None and not save_file.writable():
+            raise ValueError("save_file must be opened in binary write mode")
 
         data_buffer = b""
         offset = 0
 
         while True:
-            if len(data_buffer) - offset < 2:
+            parsed = self._parse_message_from_buffer(memoryview(data_buffer), offset)
+            if parsed is None:
                 data_buffer = data_buffer[offset:]
                 offset = 0
-                new_data = file.read(cachesize)
-                if not new_data:
-                    break
-                data_buffer += new_data
-
-                if len(data_buffer) < 2:
-                    break
-
-            if data_buffer[offset : offset + 1] != b"\x00":
-                raise ValueError(
-                    "Unexpected byte: "
-                    + str(data_buffer[offset : offset + 1], encoding="ascii")
-                )
-
-            message_len = data_buffer[offset + 1]
-            total_len = 2 + message_len
-
-            if len(data_buffer) - offset < total_len:
-                data_buffer = data_buffer[offset:]
-                offset = 0
-
                 new_data = file.read(cachesize)
                 if not new_data:
                     break
                 data_buffer += new_data
                 continue
 
-            message_data = data_buffer[offset + 2 : offset + total_len]
-            message = self.get_message_type(message_data)
+            message, total_len = parsed
 
             if message.message_type in self.message_type:
                 if save_file is not None:
@@ -113,13 +153,16 @@ class MessageParser(object):
                     save_file.write(b"\x00" + msg_len_to_bytes + message.to_bytes())
                 yield message
 
-            if message.message_type == b"S":  # System message
-                if message.event_code == b"C":  # End of messages
-                    break
+            if (
+                message.message_type == b"S"
+                and getattr(message, "event_code", b"") == b"C"
+            ):
+                break
+
             offset += total_len
 
-    def read_message_from_bytes(
-        self, data: bytes, save_file: IO = None
+    def parse_stream(
+        self, data: bytes, save_file: Optional[IO] = None
     ) -> Iterator[MarketMessage]:
         """
         Process one or multiple ITCH binary messages from a raw bytes input.
@@ -139,30 +182,20 @@ class MessageParser(object):
             - No buffering is done here — this is meant for real-time decoding.
         """
         if not isinstance(data, (bytes, bytearray)):
-            raise TypeError("data must be bytes or bytearray not " + str(type(data)))
+            raise TypeError("data must be bytes or bytearray, not " + str(type(data)))
 
-        if save_file is not None:
-            if not save_file.writable():
-                raise ValueError("save_file must be opened in binary write mode")
+        if save_file is not None and not save_file.writable():
+            raise ValueError("save_file must be opened in binary write mode")
 
         offset = 0
         data_view = memoryview(data)
-        data_len = len(data_view)
-
-        while offset + 2 <= data_len:
-            if data_view[offset : offset + 1] != b"\x00":
-                raise ValueError(
-                    f"Unexpected start byte at offset {offset:offset+1}: "
-                    f"{data_view[offset : offset + 1].tobytes()}"
-                )
-            msg_len = data_view[offset + 1]
-            total_len = 2 + msg_len
-
-            if offset + total_len > data_len:
+
+        while True:
+            parsed = self._parse_message_from_buffer(data_view, offset)
+            if parsed is None:
                 break
 
-            raw_msg = data_view[offset + 2 : offset + total_len]
-            message = self.get_message_type(raw_msg.tobytes())
+            message, total_len = parsed
 
             if message.message_type in self.message_type:
                 if save_file is not None:
@@ -170,23 +203,26 @@ class MessageParser(object):
                     save_file.write(b"\x00" + msg_len_to_bytes + message.to_bytes())
                 yield message
 
-            if message.message_type == b"S":  # System message
-                if message.event_code == b"C":  # End of messages
-                    break
+            if (
+                message.message_type == b"S"
+                and getattr(message, "event_code", b"") == b"C"
+            ):
+                break
 
             offset += total_len
 
-    def get_message_type(self, message: bytes) -> MarketMessage:
+    def parse_messages(
+        self,
+        data: BinaryIO | bytes | bytearray,
+        callback: Callable[[MarketMessage], None],
+    ) -> None:
         """
-        Take an entire bytearray and return the appropriate ITCH message
-        instance based on the message type indicator (first byte of the message).
-
-        All message type indicators are single ASCII characters.
+        Parses messages from data and invokes a callback for each message.
         """
-        message_type = message[0:1]
-        try:
-            return msgs[message_type](message)
-        except Exception:
-            raise ValueError(
-                f"Unknown message type: {message_type.decode(encoding='ascii')}"
-            )
+        parser_func = (
+            self.parse_stream
+            if isinstance(data, (bytes, bytearray))
+            else self.parse_file
+        )
+        for message in parser_func(data):
+            callback(message)

{itchfeed-1.0.5 → itchfeed-1.0.6/itchfeed.egg-info}/PKG-INFO

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: itchfeed
-Version: 1.0.5
+Version: 1.0.6
 Summary: Simple parser for ITCH messages
-Home-page: https://github.com/bbalouki/itch
-Download-URL: https://pypi.org/project/itchfeed/
-Author: Bertin Balouki SIMYELI
-Author-email: <bertin@bbstrader.com>
-Maintainer: Bertin Balouki SIMYELI
-License: The MIT License (MIT)
+Author-email: Bertin Balouki SIMYELI <bertin@bbs-trading.com>
+Maintainer-email: Bertin Balouki SIMYELI <bertin@bbs-trading.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/bbalouki/itch
+Project-URL: Download, https://pypi.org/project/itchfeed/
 Project-URL: Source Code, https://github.com/bbalouki/itch
 Keywords: Finance,Financial,Quantitative,Equities,Totalview-ITCH,Totalview,Nasdaq-ITCH,Nasdaq,ITCH,Data,Feed,ETFs,Funds,Trading,Investing
 Classifier: Development Status :: 5 - Production/Stable
@@ -19,20 +18,7 @@ Classifier: Operating System :: OS Independent
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pytest
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: download-url
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
 Dynamic: license-file
-Dynamic: maintainer
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: summary
 
 # Nasdaq TotalView-ITCH 5.0 Parser
 [![PYPI Version](https://img.shields.io/pypi/v/itchfeed)](https://pypi.org/project/itchfeed/)
@@ -111,6 +97,8 @@ After installation (typically via pip), import the necessary modules directly in
 
 ## Usage
 
+Download some sample data [here](https://emi.nasdaq.com/ITCH/Nasdaq%20ITCH/)
+
 ### Parsing from a Binary File
 
 This is useful for processing historical ITCH data stored in files. The `MessageParser` handles buffering efficiently.
@@ -131,9 +119,8 @@ parser = MessageParser() # Parses all messages by default
 
 # Path to your ITCH 5.0 data file
 itch_file_path = 'path/to/your/data'
-# you can find sample data [here](https://emi.nasdaq.com/ITCH/Nasdaq%20ITCH/)
 
-# The `read_message_from_file()` method reads the ITCH data in chunks.
+# The `parse_file()` method reads the ITCH data in chunks.
 # - `cachesize` (optional, default: 65536 bytes): This parameter determines the size of data chunks
 #   read from the file at a time. Adjusting this might impact performance for very large files
 #   or memory usage, but the default is generally suitable.
@@ -144,13 +131,9 @@ itch_file_path = 'path/to/your/data'
 
 try:
     with open(itch_file_path, 'rb') as itch_file:
-        # read_message_from_file returns a list of parsed message objects
-        parsed_messages = parser.read_message_from_file(itch_file) # You can also pass cachesize here, e.g., parser.read_message_from_file(itch_file, cachesize=131072)
-
-        print(f"Parsed {len(parsed_messages)} messages.")
-
+        # parse_file returns an Iterator of parsed message objects
         # Process the messages
-        for message in parsed_messages:
+        for message in parser.parse_file(itch_file):
             # Access attributes directly
             print(f"Type: {message.message_type.decode()}, Timestamp: {message.timestamp}")
 
@@ -192,14 +175,8 @@ parser = MessageParser()
 # Example: \x00\x0bS...\x00\x25R...\x00\x27F...
 raw_binary_data: bytes = b"..." # Your raw ITCH 5.0 data chunk
 
-# read_message_from_bytes returns a queue of parsed message objects
-message_queue: Queue = parser.read_message_from_bytes(raw_binary_data)
-
-print(f"Parsed {message_queue.qsize()} messages from the byte chunk.")
-
-# Process messages from the queue
-while not message_queue.empty():
-    message = message_queue.get()
+# parse_stream returns an Iterator of parsed message objects
+for message in parser.parse_stream(raw_binary_data)
 
     print(f"Type: {message.message_type.decode()}, Timestamp: {message.timestamp}")
 
@@ -462,11 +439,12 @@ Common scenarios that can lead to a `ValueError` include:
 
 It's crucial to anticipate these errors in your application:
 
-*   **Use `try-except` Blocks:** Wrap your parsing calls (especially `read_message_from_file` or `read_message_from_bytes`) in `try-except ValueError as e:` blocks.
+*   **Use `try-except` Blocks:** Wrap your parsing calls (especially `parse_file` or `parse_stream`) in `try-except ValueError as e:` blocks.
     ```python
     try:
         # ... parsing operations ...
-        messages = parser.read_message_from_file(itch_file)
+        for message in parser.parse_file(itch_file):
+            ...
     except ValueError as e:
         print(f"An error occurred during parsing: {e}")
         # Log the error, problematic data chunk, or take other actions

{itchfeed-1.0.5 → itchfeed-1.0.6}/itchfeed.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 LICENSE
 MANIFEST.in
 README.md
+pyproject.toml
 requirements.txt
 setup.py
 itch/__init__.py
@@ -13,4 +14,5 @@ itchfeed.egg-info/dependency_links.txt
 itchfeed.egg-info/requires.txt
 itchfeed.egg-info/top_level.txt
 tests/test_create_message.py
-tests/test_messages.py
+tests/test_messages.py
+tests/test_parser.py

itchfeed-1.0.6/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=64.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "itchfeed"
+version = "1.0.6"
+authors = [
+    {name = "Bertin Balouki SIMYELI", email = "bertin@bbs-trading.com"},
+]
+maintainers = [
+    {name = "Bertin Balouki SIMYELI", email = "bertin@bbs-trading.com"},
+]
+description = "Simple parser for ITCH messages"
+readme = "README.md"
+license = "MIT"
+keywords = [
+    "Finance",
+    "Financial",
+    "Quantitative",
+    "Equities",
+    "Totalview-ITCH",
+    "Totalview",
+    "Nasdaq-ITCH",
+    "Nasdaq",
+    "ITCH",
+    "Data",
+    "Feed",
+    "ETFs",
+    "Funds",
+    "Trading",
+    "Investing",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "Topic :: Office/Business :: Financial :: Investment",
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+dynamic = ["dependencies"]
+
+[project.urls]
+"Homepage" = "https://github.com/bbalouki/itch"
+"Download" = "https://pypi.org/project/itchfeed/"
+"Source Code" = "https://github.com/bbalouki/itch"
+
+[tool.setuptools]
+packages = ["itch"]
+
+[tool.setuptools.dynamic]
+dependencies = { file = ["requirements.txt"] }

itchfeed-1.0.6/setup.py

@@ -0,0 +1,5 @@
+from setuptools import setup
+
+
+if __name__ == "__main__":
+    setup()

{itchfeed-1.0.5 → itchfeed-1.0.6}/tests/test_create_message.py

@@ -16,7 +16,7 @@ def test_create_message_and_pack(message_type, sample_data):
 
     # Unpack the message using the original class constructor
     message_class = messages[message_type]
-    unpacked_message = message_class(packed_message)
+    unpacked_message = message_class(packed_message) # type: ignore
 
     # Verify that the attributes of the unpacked message match the original data
     for key, expected_value in sample_data.items():

itchfeed-1.0.6/tests/test_parser.py

@@ -0,0 +1,110 @@
+import unittest
+from io import BytesIO
+
+import pytest
+
+from itch.messages import create_message
+from itch.parser import MessageParser
+from .data import TEST_DATA
+
+
+class TestMessageParser(unittest.TestCase):
+    def setUp(self):
+        self.parser = MessageParser()
+
+    def test_parse_stream_single_message(self):
+        """Test that the parser correctly parses a single message from a stream."""
+        raw_message = create_message(b"S", **TEST_DATA[b"S"]).to_bytes()
+        message_len = len(raw_message).to_bytes(1, "big")
+        data = b"\x00" + message_len + raw_message
+        messages = list(self.parser.parse_stream(data))
+        self.assertEqual(len(messages), 1)
+        self.assertIsInstance(
+            messages[0], type(create_message(b"S", **TEST_DATA[b"S"]))
+        )
+
+    def test_parse_stream_multiple_messages(self):
+        """Test that the parser correctly parses multiple messages from a stream."""
+        raw_message_1 = create_message(b"S", **TEST_DATA[b"S"]).to_bytes()
+        raw_message_2 = create_message(b"A", **TEST_DATA[b"A"]).to_bytes()
+        message_len_1 = len(raw_message_1).to_bytes(1, "big")
+        message_len_2 = len(raw_message_2).to_bytes(1, "big")
+        data = (
+            b"\x00"
+            + message_len_1
+            + raw_message_1
+            + b"\x00"
+            + message_len_2
+            + raw_message_2
+        )
+        messages = list(self.parser.parse_stream(data))
+        self.assertEqual(len(messages), 2)
+        self.assertIsInstance(
+            messages[0], type(create_message(b"S", **TEST_DATA[b"S"]))
+        )
+        self.assertIsInstance(
+            messages[1], type(create_message(b"A", **TEST_DATA[b"A"]))
+        )
+
+    def test_parse_file(self):
+        """Test that the parser correctly parses messages from a file."""
+        raw_message = create_message(b"S", **TEST_DATA[b"S"]).to_bytes()
+        message_len = len(raw_message).to_bytes(1, "big")
+        data = b"\x00" + message_len + raw_message
+        file = BytesIO(data)
+        messages = list(self.parser.parse_file(file))
+        self.assertEqual(len(messages), 1)
+        self.assertIsInstance(
+            messages[0], type(create_message(b"S", **TEST_DATA[b"S"]))
+        )
+
+    def test_unknown_message_type(self):
+        """Test that the parser raises a ValueError for an unknown message type."""
+        raw_message = b"\x00\x01\x00"
+        with self.assertRaises(ValueError):
+            list(self.parser.parse_stream(raw_message))
+
+    def test_incomplete_message(self):
+        """Test that the parser handles incomplete messages."""
+        raw_message = create_message(b"S", **TEST_DATA[b"S"]).to_bytes()
+        message_len = len(raw_message).to_bytes(1, "big")
+        data = b"\x00" + message_len + raw_message[:-1]
+        messages = list(self.parser.parse_stream(data))
+        self.assertEqual(len(messages), 0)
+
+    def test_stop_on_system_event_c(self):
+        """Test that the parser stops on a system event message with event code 'C'."""
+        kwargs = TEST_DATA[b"S"].copy()
+        kwargs["event_code"] = b"C"
+        raw_message_1 = create_message(b"S", **kwargs).to_bytes()
+        raw_message_2 = create_message(b"A", **TEST_DATA[b"A"]).to_bytes()
+        message_len_1 = len(raw_message_1).to_bytes(1, "big")
+        message_len_2 = len(raw_message_2).to_bytes(1, "big")
+        data = (
+            b"\x00"
+            + message_len_1
+            + raw_message_1
+            + b"\x00"
+            + message_len_2
+            + raw_message_2
+        )
+        messages = list(self.parser.parse_stream(data))
+        self.assertEqual(len(messages), 1)
+        self.assertIsInstance(messages[0], type(create_message(b"S", **kwargs)))
+
+
+@pytest.mark.parametrize("message_type", TEST_DATA.keys())
+def test_parse_all_message_types(message_type):
+    """Test that the parser correctly parses all message types."""
+    parser = MessageParser()
+    kwargs = TEST_DATA[message_type]
+    raw_message = create_message(message_type, **kwargs).to_bytes()
+    message_len = len(raw_message).to_bytes(1, "big")
+    data = b"\x00" + message_len + raw_message
+    messages = list(parser.parse_stream(data))
+    assert len(messages) == 1
+    assert isinstance(messages[0], type(create_message(message_type, **kwargs)))
+
+
+if __name__ == "__main__":
+    unittest.main()

itchfeed-1.0.5/itch/__init__.py

@@ -1,11 +0,0 @@
-"""
-Nasdaq TotalView-ITCH 5.0 Parser
-"""
-
-__author__ = "Bertin Balouki SIMYELI"
-__copyright__ = "2025 Bertin Balouki SIMYELI"
-__email__ = "bertin@bbstrader.com"
-__license__ = "MIT"
-__version__ = "1.0.4"
-
-

itchfeed-1.0.5/setup.py

@@ -1,68 +0,0 @@
-import io
-from os import path
-
-from setuptools import setup
-
-here = path.abspath(path.dirname(__file__))
-
-# Get the long description from the README file
-with io.open(path.join(here, "README.md"), encoding="utf-8") as f:
-    long_description = f.read()
-
-with io.open(path.join(here, "requirements.txt"), encoding="utf-8") as f:
-    REQUIREMENTS = [line.rstrip() for line in f]
-
-VERSION = "1.0.5"
-DESCRIPTION = "Simple parser for ITCH messages"
-
-KEYWORDS = [
-    "Finance",
-    "Financial",
-    "Quantitative",
-    "Equities",
-    "Totalview-ITCH",
-    "Totalview",
-    "Nasdaq-ITCH",
-    "Nasdaq",
-    "ITCH",
-    "Data",
-    "Feed",
-    "ETFs",
-    "Funds",
-    "Trading",
-    "Investing",
-]
-
-CLASSIFIERS = [
-    "Development Status :: 5 - Production/Stable",
-    "Intended Audience :: Developers",
-    "Intended Audience :: Financial and Insurance Industry",
-    "Topic :: Office/Business :: Financial :: Investment",
-    "Programming Language :: Python :: 3",
-    "Operating System :: OS Independent",
-]
-
-INLCUDE = ["itch"]
-EXCLUDE = ["tests"]
-
-# Setting up
-setup(
-    name="itchfeed",
-    version=VERSION,
-    author="Bertin Balouki SIMYELI",
-    url="https://github.com/bbalouki/itch",
-    download_url="https://pypi.org/project/itchfeed/",
-    project_urls={
-        "Source Code": "https://github.com/bbalouki/itch",
-    },
-    license="The MIT License (MIT)",
-    author_email="<bertin@bbstrader.com>",
-    maintainer="Bertin Balouki SIMYELI",
-    description=DESCRIPTION,
-    long_description=long_description,
-    long_description_content_type="text/markdown",
-    packages=INLCUDE,
-    install_requires=REQUIREMENTS,
-    keywords=KEYWORDS,
-    classifiers=CLASSIFIERS,
-)