fastmile-parser 0.1.0__tar.gz

fastmile_parser-0.1.0/LICENSE

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

fastmile_parser-0.1.0/PKG-INFO

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: fastmile-parser
+Version: 0.1.0
+Summary: Shared Nokia FastMile router snapshot parser
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.32
+Requires-Dist: beautifulsoup4>=4.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Dynamic: license-file
+
+# fastmile-parser
+
+Shared Nokia FastMile parser package.
+
+## What it does
+
+- fetches `https://<router>/status.php`
+- parses the status page into typed snapshot models
+- preserves the exact field set used by `fastmile-api`
+
+## Usage
+
+```python
+from fastmile_parser.router_client import RouterClient
+from fastmile_parser.scraper import parse_snapshot
+
+html = RouterClient("192.168.0.1").fetch_status_html()
+snapshot = parse_snapshot(html)
+```

fastmile_parser-0.1.0/README.md

@@ -0,0 +1,19 @@
+# fastmile-parser
+
+Shared Nokia FastMile parser package.
+
+## What it does
+
+- fetches `https://<router>/status.php`
+- parses the status page into typed snapshot models
+- preserves the exact field set used by `fastmile-api`
+
+## Usage
+
+```python
+from fastmile_parser.router_client import RouterClient
+from fastmile_parser.scraper import parse_snapshot
+
+html = RouterClient("192.168.0.1").fetch_status_html()
+snapshot = parse_snapshot(html)
+```

fastmile_parser-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fastmile-parser"
+version = "0.1.0"
+description = "Shared Nokia FastMile router snapshot parser"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+dependencies = [
+  "requests>=2.32",
+  "beautifulsoup4>=4.12",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

fastmile_parser-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fastmile_parser-0.1.0/src/fastmile_parser/__init__.py

@@ -0,0 +1 @@
+"""FastMile parser package."""

fastmile_parser-0.1.0/src/fastmile_parser/models.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass(slots=True)
+class DeviceInfo:
+    model: str
+    software_version: str
+    serial_number: str
+    imei: str
+    imsi: str
+    mac: str
+    lock_status: str
+
+
+@dataclass(slots=True)
+class TrafficValue:
+    val: float
+    unit: str
+    val_gb: float
+
+
+@dataclass(slots=True)
+class InterfaceData:
+    download: TrafficValue
+    upload: TrafficValue
+
+
+@dataclass(slots=True)
+class ApnInfo:
+    name: str
+    ipv4: Optional[str]
+    ipv6: Optional[str]
+
+
+@dataclass(slots=True)
+class CaInfo:
+    enb: int
+    cid: int
+    dl_bands: list[int]
+    ul_bands: list[int]
+
+
+@dataclass(slots=True)
+class CellSignal:
+    pci: int
+    earfcn: int
+    cell_type: Optional[str]
+    rsrp: int
+    rsrq: int
+    rssi: int
+    sinr: int
+
+
+@dataclass(slots=True)
+class LteInfo:
+    ca: CaInfo
+    active: list[CellSignal]
+    available: list[CellSignal]
+
+
+@dataclass(slots=True)
+class SnapshotData:
+    eth: InterfaceData
+    lte: InterfaceData
+
+
+@dataclass(slots=True)
+class Snapshot:
+    device: DeviceInfo
+    apns: list[ApnInfo]
+    data: SnapshotData
+    lte: LteInfo

fastmile_parser-0.1.0/src/fastmile_parser/router_client.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+import requests
+
+
+class RouterClient:
+    def __init__(self, host: str, timeout: int = 30) -> None:
+        self.host = host
+        self.timeout = timeout
+
+    def fetch_status_html(self) -> str:
+        response = requests.get(
+            f"https://{self.host}/status.php",
+            timeout=self.timeout,
+            verify=False,
+        )
+        response.raise_for_status()
+        return response.text

fastmile_parser-0.1.0/src/fastmile_parser/scraper.py

@@ -0,0 +1,211 @@
+from __future__ import annotations
+
+import re
+from typing import Optional
+
+from bs4 import BeautifulSoup, Comment, Tag
+
+from fastmile_parser.models import (
+    ApnInfo,
+    CaInfo,
+    CellSignal,
+    DeviceInfo,
+    InterfaceData,
+    LteInfo,
+    Snapshot,
+    SnapshotData,
+    TrafficValue,
+)
+
+
+def _text(tag: Tag) -> str:
+    return tag.get_text(strip=True)
+
+
+def _first_text(soup: BeautifulSoup, element_id: str) -> str:
+    tag = soup.find(id=element_id)
+    if tag is None:
+        raise ValueError(f"missing element: {element_id}")
+    return _text(tag)
+
+
+def _parse_int(value: str) -> int:
+    match = re.search(r"-?\d+", value)
+    if not match:
+        raise ValueError(f"expected integer in: {value!r}")
+    return int(match.group(0))
+
+
+def _parse_ip(value: str) -> Optional[str]:
+    value = value.strip()
+    return None if value in {"", "::"} else value
+
+
+def _parse_traffic(value: str) -> TrafficValue:
+    cleaned = value.strip().upper()
+    match = re.match(r"([0-9.]+)\s*([A-Z]+)", cleaned)
+    if not match:
+        raise ValueError(f"invalid traffic value: {value!r}")
+    amount = float(match.group(1))
+    unit = match.group(2)
+    if unit == "MB":
+        val_gb = amount / 1000
+    elif unit == "GB":
+        val_gb = amount
+    elif unit == "KB":
+        val_gb = amount / 1_000_000
+    else:
+        val_gb = amount
+    return TrafficValue(val=amount, unit=unit, val_gb=val_gb)
+
+
+def _find_comment_section(soup: BeautifulSoup, comment_text: str) -> Optional[Tag]:
+    comment = soup.find(string=lambda text: isinstance(text, Comment) and text.strip() == comment_text)
+    if comment is None:
+        return None
+    sibling = comment.find_next_sibling()
+    while sibling is not None and not isinstance(sibling, Tag):
+        sibling = sibling.find_next_sibling()
+    return sibling
+
+
+def _parse_apns(soup: BeautifulSoup) -> list[ApnInfo]:
+    section = _find_comment_section(soup, "APNs card")
+    if section is None:
+        return []
+    values = section.find_all("div", id=None)
+    if len(values) < 3:
+        return []
+    result: list[ApnInfo] = []
+    for index in range(2, len(values), 3):
+        if index + 2 >= len(values):
+            break
+        result.append(
+            ApnInfo(
+                name=_text(values[index]),
+                ipv4=_parse_ip(_text(values[index + 1])),
+                ipv6=_parse_ip(_text(values[index + 2])),
+            )
+        )
+    return result
+
+
+def _parse_cell_group(section: Tag, cell_type: Optional[str]) -> list[CellSignal]:
+    values = section.find_all(class_="name-of-value-in-card-bold")
+    result: list[CellSignal] = []
+    for index in range(0, len(values), 7):
+        chunk = values[index : index + 7]
+        if len(chunk) < 7:
+            break
+        result.append(
+            CellSignal(
+                pci=_parse_int(_text(chunk[0])),
+                earfcn=_parse_int(_text(chunk[1])),
+                cell_type=_text(chunk[2]) if cell_type is not None else None,
+                rsrp=_parse_int(_text(chunk[3])),
+                rsrq=_parse_int(_text(chunk[4])),
+                rssi=_parse_int(_text(chunk[5])),
+                sinr=_parse_int(_text(chunk[6])),
+            )
+        )
+    return result
+
+
+def _parse_available_cells(soup: BeautifulSoup) -> list[CellSignal]:
+    result: list[CellSignal] = []
+    index = 0
+    while True:
+        cell_id = soup.find(id=f"available-cell-id-{index}")
+        if cell_id is None:
+            break
+        result.append(
+            CellSignal(
+                pci=_parse_int(_text(cell_id)),
+                earfcn=_parse_int(_first_text(soup, f"available-earfcn-{index}")),
+                cell_type=None,
+                rsrp=_parse_int(_first_text(soup, f"rsrp-{index}")),
+                rsrq=_parse_int(_first_text(soup, f"rsrq-{index}")),
+                rssi=_parse_int(_first_text(soup, f"rssi-{index}")),
+                sinr=_parse_int(_first_text(soup, f"sinr-{index}")),
+            )
+        )
+        index += 1
+    return result
+
+
+def _parse_ca(soup: BeautifulSoup) -> CaInfo:
+    attached = soup.find(id="attached-cell-val")
+    if attached is None:
+        raise ValueError("missing attached-cell-val")
+    spans = attached.find_all("span")
+    if len(spans) < 3:
+        raise ValueError("missing carrier aggregation values")
+    enb = _parse_int(_text(spans[0]))
+    cid = _parse_int(_text(spans[1]))
+    primary_band = _parse_int(_text(spans[2]))
+
+    dl_text = _first_text(soup, "bandDL-val")
+    ul_text = _first_text(soup, "bandUL-val")
+    dl_bands = [primary_band]
+    ul_bands = [primary_band]
+    dl_match = re.findall(r"B(\d+)", dl_text)
+    ul_match = re.findall(r"B(\d+)", ul_text)
+    dl_bands.extend(int(value) for value in dl_match)
+    ul_bands.extend(int(value) for value in ul_match)
+    return CaInfo(enb=enb, cid=cid, dl_bands=dl_bands, ul_bands=ul_bands)
+
+
+def _parse_interface_data(soup: BeautifulSoup, name: str) -> InterfaceData:
+    section = soup.find(class_=name)
+    if section is None:
+        raise ValueError(f"missing traffic section: {name}")
+    bytes_values = section.find_all(class_="bytes")
+    if len(bytes_values) < 2:
+        raise ValueError(f"missing traffic values for: {name}")
+    return InterfaceData(
+        download=_parse_traffic(_text(bytes_values[0])),
+        upload=_parse_traffic(_text(bytes_values[1])),
+    )
+
+
+def parse_snapshot(html: str) -> Snapshot:
+    soup = BeautifulSoup(html, "html.parser")
+
+    device = DeviceInfo(
+        model=_first_text(soup, "model-value"),
+        software_version=_first_text(soup, "software-version-val"),
+        serial_number=_first_text(soup, "sn-value"),
+        imei=_first_text(soup, "imei-value"),
+        imsi=_first_text(soup, "imsi-name-value"),
+        mac=_first_text(soup, "eth-mac-value"),
+        lock_status=_first_text(soup, "lockStatus-name-value"),
+    )
+
+    data = SnapshotData(
+        eth=_parse_interface_data(soup, "Ethernet"),
+        lte=_parse_interface_data(soup, "LTE"),
+    )
+
+    primary_section = _find_comment_section(soup, "Primary Cell information card")
+    secondary_section = _find_comment_section(soup, "Secondary Cell information card")
+    available_section = _find_comment_section(soup, "Available cells grid (*x6)")
+
+    active: list[CellSignal] = []
+    if primary_section is not None:
+        active.extend(_parse_cell_group(primary_section, cell_type="primary"))
+    if secondary_section is not None:
+        active.extend(_parse_cell_group(secondary_section, cell_type="secondary"))
+
+    available: list[CellSignal] = []
+    if available_section is not None:
+        available = _parse_available_cells(soup)
+
+    lte = LteInfo(
+        ca=_parse_ca(soup),
+        active=active,
+        available=available,
+    )
+
+    apns = _parse_apns(soup)
+
+    return Snapshot(device=device, apns=apns, data=data, lte=lte)

fastmile_parser-0.1.0/src/fastmile_parser.egg-info/PKG-INFO

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: fastmile-parser
+Version: 0.1.0
+Summary: Shared Nokia FastMile router snapshot parser
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.32
+Requires-Dist: beautifulsoup4>=4.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Dynamic: license-file
+
+# fastmile-parser
+
+Shared Nokia FastMile parser package.
+
+## What it does
+
+- fetches `https://<router>/status.php`
+- parses the status page into typed snapshot models
+- preserves the exact field set used by `fastmile-api`
+
+## Usage
+
+```python
+from fastmile_parser.router_client import RouterClient
+from fastmile_parser.scraper import parse_snapshot
+
+html = RouterClient("192.168.0.1").fetch_status_html()
+snapshot = parse_snapshot(html)
+```

fastmile_parser-0.1.0/src/fastmile_parser.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/fastmile_parser/__init__.py
+src/fastmile_parser/models.py
+src/fastmile_parser/router_client.py
+src/fastmile_parser/scraper.py
+src/fastmile_parser.egg-info/PKG-INFO
+src/fastmile_parser.egg-info/SOURCES.txt
+src/fastmile_parser.egg-info/dependency_links.txt
+src/fastmile_parser.egg-info/requires.txt
+src/fastmile_parser.egg-info/top_level.txt
+tests/test_router_client.py
+tests/test_scraper.py

fastmile_parser-0.1.0/src/fastmile_parser.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fastmile_parser-0.1.0/src/fastmile_parser.egg-info/requires.txt

@@ -0,0 +1,5 @@
+requests>=2.32
+beautifulsoup4>=4.12
+
+[dev]
+pytest>=8.0

fastmile_parser-0.1.0/src/fastmile_parser.egg-info/top_level.txt

@@ -0,0 +1 @@
+fastmile_parser

fastmile_parser-0.1.0/tests/test_router_client.py

@@ -0,0 +1,26 @@
+import requests
+
+from fastmile_parser.router_client import RouterClient
+
+
+def test_fetch_status_html_uses_https_and_verify_false(monkeypatch):
+    calls = {}
+
+    class Response:
+        status_code = 200
+        text = "<html>ok</html>"
+
+        def raise_for_status(self):
+            return None
+
+    def fake_get(url, timeout, verify):
+        calls["url"] = url
+        calls["timeout"] = timeout
+        calls["verify"] = verify
+        return Response()
+
+    monkeypatch.setattr(requests, "get", fake_get)
+
+    client = RouterClient("192.168.0.1", timeout=30)
+    assert client.fetch_status_html() == "<html>ok</html>"
+    assert calls == {"url": "https://192.168.0.1/status.php", "timeout": 30, "verify": False}

fastmile_parser-0.1.0/tests/test_scraper.py

@@ -0,0 +1,101 @@
+from fastmile_parser.scraper import parse_snapshot
+
+
+HTML = """
+<html>
+  <div id="model-value">ODU - Multiband - 4G05-B</div>
+  <div id="software-version-val">FASTMILE2_D020110B83T0101M01E0153S</div>
+  <div id="sn-value">FSH22010081D</div>
+  <div id="imei-value">356088101152952</div>
+  <div id="imsi-name-value">260032773115333</div>
+  <div id="eth-mac-value">DC:8D:8A:97:47:C2</div>
+  <div id="lockStatus-name-value">Normal</div>
+
+  <div id="attached-cell-val">eNBID: <span>291067</span> Cell ID: <span>53</span> Band: <span>3</span></div>
+  <div id="bandDL-val">B1</div>
+  <div id="bandUL-val">CA Not Available</div>
+
+  <!-- Primary Cell information card -->
+  <div class="card-sevencol-grid">
+    <div class="name-of-value-in-card-bold">131</div>
+    <div class="name-of-value-in-card-bold">1725</div>
+    <div class="name-of-value-in-card-bold">CellPrimary</div>
+    <div class="name-of-value-in-card-bold">-106</div>
+    <div class="name-of-value-in-card-bold">-13</div>
+    <div class="name-of-value-in-card-bold">-74</div>
+    <div class="name-of-value-in-card-bold">6</div>
+  </div>
+
+  <!-- Secondary Cell information card -->
+  <div class="card-sevencol-grid">
+    <div class="name-of-value-in-card-bold">311</div>
+    <div class="name-of-value-in-card-bold">75</div>
+    <div class="name-of-value-in-card-bold">CellSecondary</div>
+    <div class="name-of-value-in-card-bold">-110</div>
+    <div class="name-of-value-in-card-bold">-14</div>
+    <div class="name-of-value-in-card-bold">-77</div>
+    <div class="name-of-value-in-card-bold">3</div>
+  </div>
+
+  <!-- LTE stats -->
+  <div class="LTE"><div class="bytes">1.5 GB</div><div class="bytes">256 MB</div></div>
+  <div class="Ethernet"><div class="bytes">256 MB</div><div class="bytes">1.5 GB</div></div>
+
+  <!-- APNs card -->
+  <div class="apns-section">
+    <div></div><div></div>
+    <div>internet</div><div>10.0.0.2</div><div>::</div>
+  </div>
+
+  <!-- Available cells grid (*x6) -->
+  <div id="available-cell-id-0">470</div>
+  <div id="available-earfcn-0">150</div>
+  <div id="rsrp-0">-56</div>
+  <div id="rsrq-0">-14</div>
+  <div id="rssi-0">-31</div>
+  <div id="sinr-0">30</div>
+</html>
+"""
+
+
+def test_parse_snapshot_extracts_full_status_payload():
+    snapshot = parse_snapshot(HTML)
+
+    assert snapshot.device.model == "ODU - Multiband - 4G05-B"
+    assert snapshot.device.software_version == "FASTMILE2_D020110B83T0101M01E0153S"
+    assert snapshot.device.serial_number == "FSH22010081D"
+    assert snapshot.device.imei == "356088101152952"
+    assert snapshot.device.imsi == "260032773115333"
+    assert snapshot.device.mac == "DC:8D:8A:97:47:C2"
+    assert snapshot.device.lock_status == "Normal"
+
+    assert snapshot.lte.ca.enb == 291067
+    assert snapshot.lte.ca.cid == 53
+    assert snapshot.lte.ca.dl_bands == [3, 1]
+    assert snapshot.lte.ca.ul_bands == [3]
+
+    assert snapshot.lte.active[0].pci == 131
+    assert snapshot.lte.active[0].earfcn == 1725
+    assert snapshot.lte.active[0].cell_type == "CellPrimary"
+    assert snapshot.lte.active[0].rsrp == -106
+    assert snapshot.lte.active[0].rsrq == -13
+    assert snapshot.lte.active[0].rssi == -74
+    assert snapshot.lte.active[0].sinr == 6
+
+    assert snapshot.lte.active[1].pci == 311
+    assert snapshot.lte.active[1].cell_type == "CellSecondary"
+
+    assert snapshot.lte.available[0].pci == 470
+    assert snapshot.lte.available[0].earfcn == 150
+    assert snapshot.lte.available[0].rsrp == -56
+    assert snapshot.lte.available[0].rsrq == -14
+    assert snapshot.lte.available[0].rssi == -31
+    assert snapshot.lte.available[0].sinr == 30
+
+    assert snapshot.apns[0].name == "internet"
+    assert snapshot.apns[0].ipv4 == "10.0.0.2"
+    assert snapshot.apns[0].ipv6 is None
+
+    assert snapshot.data.eth.download.unit == "MB"
+    assert snapshot.data.eth.download.val_gb == 0.256
+    assert snapshot.data.lte.upload.unit == "MB"