openneodb 1.0.0__tar.gz

openneodb-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,98 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Run tests
+        run: python -m unittest discover -s tests -v
+
+  build:
+    name: Build package
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # setuptools-scm needs the full history and tags to compute the version.
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build twine
+          python -m build
+          twine check dist/*
+      - name: Check version
+        run: |
+          python -m pip install dist/*.whl
+          version=$(python -c "import openneodb; print(openneodb.__version__)")
+          echo "Package version: $version"
+          echo "## openneodb $version" >> "$GITHUB_STEP_SUMMARY"
+          if [[ "$GITHUB_REF_TYPE" == "tag" && "$version" != "${GITHUB_REF_NAME#v}" ]]; then
+            echo "::error::Version $version does not match tag $GITHUB_REF_NAME"
+            exit 1
+          fi
+          neodb --help
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  release:
+    name: GitHub Release
+    if: github.ref_type == 'tag'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Create release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: >
+          gh release create "$GITHUB_REF_NAME" dist/*
+          --repo "$GITHUB_REPOSITORY"
+          --title "$GITHUB_REF_NAME"
+          --generate-notes
+
+  publish:
+    name: Publish to PyPI
+    if: github.ref_type == 'tag'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/openneodb/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

openneodb-1.0.0/.gitignore

@@ -0,0 +1,5 @@
+reference
+post
+__pycache__
+.DS_Store
+openneodb/_version.py

openneodb-1.0.0/LICENSE

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

openneodb-1.0.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: openneodb
+Version: 1.0.0
+Summary: Конвертер баз камер CityGuide и iGo в формат Neoline / CityGuide and iGo to Neoline speed-camera database converter
+Author: Dmitry Titov
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/korableg/openneodb
+Project-URL: Source, https://github.com/korableg/openneodb
+Project-URL: Issues, https://github.com/korableg/openneodb/issues
+Project-URL: Author, https://titovde.ru
+Keywords: neoline,speedcam,cityguide,igo,gps,radar-detector
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Natural Language :: Russian
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# openneodb
+
+Конвертер баз камер CityGuide и iGoExt в бинарную базу для видеорегистратора
+Neoline X-COP R9000c.
+
+## Структура
+
+Пакет `openneodb`:
+
+- [`openneodb.cityguide`](openneodb/cityguide/README.md) — чтение CityGuide
+  Speedcam v2 (`.bkm`);
+- [`openneodb.igo`](openneodb/igo/README.md) — чтение SpeedCamOnline iGoExt
+  (`.txt`);
+- [`openneodb.db`](openneodb/db/README.md) — формирование базы Neoline
+  (`*_Baza_GPS.db`);
+- `openneodb.rows` — общий разбор значений строк для readers;
+- `openneodb.cli` — командная строка `neodb`, связывающая reader выбранного
+  формата с writer Neoline.
+
+## Использование
+
+```text
+neodb igo [-i INPUT] [-o OUTPUT] [--date DDMMYY]
+neodb cityguide [-i INPUT] [-o OUTPUT] [--date DDMMYY]
+```
+
+Запуск на выбор, зависимостей нет:
+
+- `pip install .` — появляется команда `neodb`;
+- без установки — `python3 neodb.py ...`
+- без установки из корня репозитория — `python3 -m openneodb ...`.
+
+```bash
+neodb igo -i cameras.txt -o X-COP_9000c_Baza_GPS.db
+neodb cityguide -i SpeedCam.bkm -o X-COP_9000c_Baza_GPS.db --date 270926
+cat cameras.txt | python3 -m openneodb igo > X-COP_9000c_Baza_GPS.db
+```
+
+По умолчанию используется локальная дата запуска в формате `DDMMYY`.
+Внутреннее имя файла всегда `https://github.com/korableg/openneodb`.
+
+Некорректная строка (пустой тип, нарушенная структура, неверное число,
+значение вне диапазона) пропускается с предупреждением. Неизвестный непустой
+тип преобразуется в базовый стационарный радар `0x06`. Ошибка всего файла
+(кодировка, заголовок, CSV) или неверная `--date` завершает процесс
+ненулевым кодом до записи результата. Файл `-o` заменяется атомарно: при
+сбое прежняя база остаётся нетронутой.
+
+## Использование как библиотеки
+
+Все публичные классы доступны из корня пакета:
+
+```python
+from openneodb import IGoReader, CityGuideReader, NeolineDBWriter
+
+with open("cameras.txt", "rb") as source:
+    result = IGoReader().read(source)
+
+for message in result.stats.warning_messages:
+    print(message)
+
+data = NeolineDBWriter(date="270926").build(result.records)
+with open("X-COP_9000c_Baza_GPS.db", "wb") as target:
+    target.write(data)
+```
+
+- `IGoReader().read(source)` и `CityGuideReader().read(source)` принимают
+  бинарный поток и возвращают `ReadResult`: кортеж `records` и статистику
+  `stats` (`read`, `skipped`, `fallback`, `warning_messages`). Библиотека
+  ничего не печатает и не пишет в лог.
+- `NeolineDBWriter(date).build(records)` принимает любые `CameraRecord`
+  и возвращает готовую базу как `bytes`; дата — строка `DDMMYY`.
+- Ошибки: `IGoFormatError`, `CityGuideFormatError` (весь входной файл
+  некорректен) и `NeolineDBError` (неверная дата, запись вне диапазона,
+  превышен размер базы). Все наследуют `ValueError`.
+- Пакет содержит аннотации типов (`py.typed`), версия — `openneodb.__version__`.
+
+### `CameraRecord`
+
+Записи можно собирать самостоятельно. Поля — целые числа в единицах формата
+Neoline, например координаты в градусах × 10000 с округлением вниз
+(`55.75583` → `557558`). Значение каждого поля описано в
+[структуре записи](https://github.com/korableg/openneodb/blob/main/openneodb/db/README.md#структура-записи).
+
+```python
+from openneodb import CameraRecord, NeolineDBWriter
+
+camera = CameraRecord(
+    camera_type=0x06,
+    latitude=557558,
+    longitude=376173,
+    direction=90,
+    direction_type=1,
+    speed=60,
+)
+data = NeolineDBWriter(date="270926").build([camera])
+```
+
+## Проверка
+
+Тесты используют только стандартную библиотеку Python:
+
+```bash
+python3 -m unittest discover -s tests
+```

openneodb-1.0.0/README.md

@@ -0,0 +1,105 @@
+# openneodb
+
+Конвертер баз камер CityGuide и iGoExt в бинарную базу для видеорегистратора
+Neoline X-COP R9000c.
+
+## Структура
+
+Пакет `openneodb`:
+
+- [`openneodb.cityguide`](openneodb/cityguide/README.md) — чтение CityGuide
+  Speedcam v2 (`.bkm`);
+- [`openneodb.igo`](openneodb/igo/README.md) — чтение SpeedCamOnline iGoExt
+  (`.txt`);
+- [`openneodb.db`](openneodb/db/README.md) — формирование базы Neoline
+  (`*_Baza_GPS.db`);
+- `openneodb.rows` — общий разбор значений строк для readers;
+- `openneodb.cli` — командная строка `neodb`, связывающая reader выбранного
+  формата с writer Neoline.
+
+## Использование
+
+```text
+neodb igo [-i INPUT] [-o OUTPUT] [--date DDMMYY]
+neodb cityguide [-i INPUT] [-o OUTPUT] [--date DDMMYY]
+```
+
+Запуск на выбор, зависимостей нет:
+
+- `pip install .` — появляется команда `neodb`;
+- без установки — `python3 neodb.py ...`
+- без установки из корня репозитория — `python3 -m openneodb ...`.
+
+```bash
+neodb igo -i cameras.txt -o X-COP_9000c_Baza_GPS.db
+neodb cityguide -i SpeedCam.bkm -o X-COP_9000c_Baza_GPS.db --date 270926
+cat cameras.txt | python3 -m openneodb igo > X-COP_9000c_Baza_GPS.db
+```
+
+По умолчанию используется локальная дата запуска в формате `DDMMYY`.
+Внутреннее имя файла всегда `https://github.com/korableg/openneodb`.
+
+Некорректная строка (пустой тип, нарушенная структура, неверное число,
+значение вне диапазона) пропускается с предупреждением. Неизвестный непустой
+тип преобразуется в базовый стационарный радар `0x06`. Ошибка всего файла
+(кодировка, заголовок, CSV) или неверная `--date` завершает процесс
+ненулевым кодом до записи результата. Файл `-o` заменяется атомарно: при
+сбое прежняя база остаётся нетронутой.
+
+## Использование как библиотеки
+
+Все публичные классы доступны из корня пакета:
+
+```python
+from openneodb import IGoReader, CityGuideReader, NeolineDBWriter
+
+with open("cameras.txt", "rb") as source:
+    result = IGoReader().read(source)
+
+for message in result.stats.warning_messages:
+    print(message)
+
+data = NeolineDBWriter(date="270926").build(result.records)
+with open("X-COP_9000c_Baza_GPS.db", "wb") as target:
+    target.write(data)
+```
+
+- `IGoReader().read(source)` и `CityGuideReader().read(source)` принимают
+  бинарный поток и возвращают `ReadResult`: кортеж `records` и статистику
+  `stats` (`read`, `skipped`, `fallback`, `warning_messages`). Библиотека
+  ничего не печатает и не пишет в лог.
+- `NeolineDBWriter(date).build(records)` принимает любые `CameraRecord`
+  и возвращает готовую базу как `bytes`; дата — строка `DDMMYY`.
+- Ошибки: `IGoFormatError`, `CityGuideFormatError` (весь входной файл
+  некорректен) и `NeolineDBError` (неверная дата, запись вне диапазона,
+  превышен размер базы). Все наследуют `ValueError`.
+- Пакет содержит аннотации типов (`py.typed`), версия — `openneodb.__version__`.
+
+### `CameraRecord`
+
+Записи можно собирать самостоятельно. Поля — целые числа в единицах формата
+Neoline, например координаты в градусах × 10000 с округлением вниз
+(`55.75583` → `557558`). Значение каждого поля описано в
+[структуре записи](https://github.com/korableg/openneodb/blob/main/openneodb/db/README.md#структура-записи).
+
+```python
+from openneodb import CameraRecord, NeolineDBWriter
+
+camera = CameraRecord(
+    camera_type=0x06,
+    latitude=557558,
+    longitude=376173,
+    direction=90,
+    direction_type=1,
+    speed=60,
+)
+data = NeolineDBWriter(date="270926").build([camera])
+```
+
+## Проверка
+
+Тесты используют только стандартную библиотеку Python:
+
+```bash
+python3 -m unittest discover -s tests
+```

openneodb-1.0.0/neodb.py

@@ -0,0 +1,11 @@
+#!/usr/bin/env python3
+"""Run the converter without installation: python3 neodb.py igo -i ... -o ..."""
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+
+from openneodb.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

openneodb-1.0.0/openneodb/__init__.py

@@ -0,0 +1,34 @@
+from .cityguide import CityGuideFormatError, CityGuideReader
+from .db import (
+    FALLBACK_CAMERA_TYPE,
+    MAX_ALERT_DISTANCE,
+    MIN_ALERT_DISTANCE,
+    CameraRecord,
+    NeolineDBError,
+    NeolineDBWriter,
+    ReaderStats,
+    ReadResult,
+)
+from .igo import IGoFormatError, IGoReader
+
+try:
+    from ._version import __version__
+except ImportError:
+    # Running from a source checkout without installation.
+    __version__ = "0.0.0+unknown"
+
+__all__ = (
+    "FALLBACK_CAMERA_TYPE",
+    "MAX_ALERT_DISTANCE",
+    "MIN_ALERT_DISTANCE",
+    "CameraRecord",
+    "CityGuideFormatError",
+    "CityGuideReader",
+    "IGoFormatError",
+    "IGoReader",
+    "NeolineDBError",
+    "NeolineDBWriter",
+    "ReaderStats",
+    "ReadResult",
+    "__version__",
+)

openneodb-1.0.0/openneodb/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())

openneodb-1.0.0/openneodb/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '1.0.0'
+__version_tuple__ = version_tuple = (1, 0, 0)
+
+__commit_id__ = commit_id = 'gc8a5cc44b'

openneodb-1.0.0/openneodb/cityguide/README.md

@@ -0,0 +1,70 @@
+# CityGuide Speedcam v2
+
+Каталог содержит `CityGuideReader`, который только читает CityGuide BKM и
+возвращает нормализованные `CameraRecord`.
+
+## Формат
+
+Файл — текст в кодировке CP1251 с CRLF. Заголовок имеет фиксированный вид:
+
+```text
+2|Radars|1251
+```
+
+Каждая следующая строка:
+
+```text
+TYPE|ID|LAT|LON|TAG|VALUE|TAG|VALUE|...|
+```
+
+| Поле или тег | Значение |
+| --- | --- |
+| `TYPE` | тип объекта CityGuide |
+| `ID` | идентификатор; при конвертации не используется |
+| `LAT`, `LON` | координаты в градусах |
+| `1709` | ограничение скорости, км/ч |
+| `1713` | направленность CityGuide |
+| `1705` | азимут камеры, `0`…`359` |
+| `1706` | дистанция предупреждения в метрах |
+
+Координаты сохраняются как `floor(value × 10000)`; поддерживаются только
+северная широта `0`…`90` и восточная долгота `0`…`180`. Азимут камеры
+переводится в направление движения добавлением 180° по модулю 360. Дистанция
+делится на 10 с округлением вниз и приводится к пределам RevM60: больше
+2000 м ограничивается 2000 м (прошивка читает `>200` декаметров как 500 м),
+от 1 до 9 м поднимается до 100 м (`0` означает 500 м), оба случая — с
+предупреждением.
+
+Отсутствующие теги получают безопасные значения с предупреждением:
+`1709 = 0`, `1713 = 0`, `1705` — направление `0` без поворота, `1706 = 0`.
+Пустые строки игнорируются. Строка с пустым типом, нарушенной структурой,
+некорректным числом или значением вне диапазона пропускается с
+предупреждением.
+
+## Преобразование типов
+
+| CityGuide `TYPE` | Neoline |
+| --- | --- |
+| `18059`, `18951`, `18925` | `0x06` |
+| `18952` | `0x01`, `flags = 0x02` |
+| `18958`, `18950` | `0x4A` |
+| любой другой непустой | `0x06` с предупреждением |
+
+Направленность из тега `1713` преобразуется так:
+
+| CityGuide | Neoline |
+| --- | --- |
+| `0` | `1`, одно направление |
+| `1` | `1`, одно направление |
+| `2` | `0`, все направления |
+
+`0` и `1` описывают один контролируемый поток; встречное направление в
+bkm — отдельная строка. По выгрузке 2026-09-19 записи с `0` и `1`
+статистически неразличимы: встречная запись в радиусе ~50 м есть у 80 % и
+78 %, совпадают распределения типов, скоростей и дистанций, вендор кодирует
+обе как `direction_type = 1`, `tol = 0`. Вероятно, это режим съёмки
+(«в лоб»/«в спину»), для Neoline не значимый. Прежнее прочтение `1` как
+«оба направления» давало лишние оповещения на встречке.
+
+Круговые камеры записываются по семантике RevM60: `direction_type = 0`, без
+флага `0x20` и без принудительного допуска 5°.

openneodb-1.0.0/openneodb/cityguide/__init__.py

@@ -0,0 +1,3 @@
+from .reader import CityGuideFormatError, CityGuideReader
+
+__all__ = ("CityGuideFormatError", "CityGuideReader")

openneodb-1.0.0/openneodb/cityguide/reader.py

@@ -0,0 +1,145 @@
+from typing import BinaryIO
+
+from ..db import (
+    MAX_ALERT_DISTANCE,
+    MIN_ALERT_DISTANCE,
+    CameraRecord,
+    ReaderStats,
+    ReadResult,
+)
+from ..rows import (
+    MAX_LATITUDE,
+    MAX_LONGITUDE,
+    RowError,
+    check_range,
+    map_camera_type,
+    optional_integer,
+    parse_coordinate,
+    parse_integer,
+)
+
+
+class CityGuideFormatError(ValueError):
+    pass
+
+
+class CityGuideReader:
+    HEADER = "2|Radars|1251"
+    TYPE_MAPPING = {
+        "18059": 0x06,
+        "18925": 0x06,
+        "18950": 0x4A,
+        "18951": 0x06,
+        "18952": 0x01,
+        "18958": 0x4A,
+    }
+    # 0 and 1 are both a single controlled direction (likely head-on versus
+    # rear shooting); opposite directions are separate rows. 2 is circular.
+    DIRECTION_TYPE_MAPPING = {0: 1, 1: 1, 2: 0}
+
+    def read(self, source: BinaryIO) -> ReadResult:
+        try:
+            text = source.read().decode("cp1251")
+        except UnicodeDecodeError as error:
+            raise CityGuideFormatError("CityGuide input must use CP1251") from error
+        lines = text.splitlines()
+        if not lines:
+            raise CityGuideFormatError("empty CityGuide input")
+        if lines[0] != self.HEADER:
+            raise CityGuideFormatError(
+                f"invalid CityGuide header {lines[0]!r}, expected {self.HEADER!r}"
+            )
+        records = []
+        stats = ReaderStats()
+        for line_number, line in enumerate(lines[1:], start=2):
+            if not line.strip():
+                continue
+            stats.read += 1
+            try:
+                records.append(self._record(line, line_number, stats))
+            except RowError as error:
+                stats.skip(line_number, str(error))
+        return ReadResult(tuple(records), stats)
+
+    def _record(self, line: str, line_number: int, stats: ReaderStats) -> CameraRecord:
+        parts = line.split("|")
+        if parts[-1] != "" or len(parts) < 5 or len(parts) % 2 == 0:
+            raise RowError("malformed CityGuide row")
+        source_type = parts[0].strip()
+        if not source_type:
+            raise RowError("blank camera type")
+        tags = self._tags(parts[4:-1], line_number, stats)
+        latitude = parse_coordinate(parts[2].strip(), "latitude", MAX_LATITUDE)
+        longitude = parse_coordinate(parts[3].strip(), "longitude", MAX_LONGITUDE)
+        speed = self._tag_integer(tags, "1709", 0, line_number, stats)
+        check_range(speed, "tag 1709", 0, 255)
+        source_direction_type = self._tag_integer(tags, "1713", 0, line_number, stats)
+        check_range(source_direction_type, "tag 1713", 0, 2)
+        direction = self._direction(tags, line_number, stats)
+        distance_metres = self._tag_integer(tags, "1706", 0, line_number, stats)
+        if distance_metres < 0:
+            raise RowError(f"tag 1706={distance_metres} must not be negative")
+        return CameraRecord(
+            camera_type=map_camera_type(
+                self.TYPE_MAPPING, source_type, "camera type", line_number, stats
+            ),
+            latitude=latitude,
+            longitude=longitude,
+            direction=direction,
+            direction_type=self.DIRECTION_TYPE_MAPPING[source_direction_type],
+            speed=speed,
+            flags=0x02 if source_type == "18952" else 0,
+            distance=self._distance(distance_metres, line_number, stats),
+        )
+
+    @staticmethod
+    def _direction(tags: dict[str, str], line_number: int, stats: ReaderStats) -> int:
+        value = tags.get("1705", "").strip()
+        if not value:
+            stats.warn(line_number, "missing tag 1705, using direction 0")
+            return 0
+        source_direction = parse_integer(value, "tag 1705")
+        check_range(source_direction, "tag 1705", 0, 359)
+        # Tag 1705 is the camera heading; Neoline stores the traffic heading.
+        return (source_direction + 180) % 360
+
+    @staticmethod
+    def _distance(metres: int, line_number: int, stats: ReaderStats) -> int:
+        distance = metres // 10
+        if metres and distance == 0:
+            # 0 means the 500 m default, not "closer than 10 m".
+            stats.warn(
+                line_number,
+                f"tag 1706={metres} raised to {MIN_ALERT_DISTANCE * 10} metres",
+            )
+            return MIN_ALERT_DISTANCE
+        if distance > MAX_ALERT_DISTANCE:
+            stats.warn(
+                line_number,
+                f"tag 1706={metres} clamped to {MAX_ALERT_DISTANCE * 10} metres",
+            )
+            return MAX_ALERT_DISTANCE
+        return distance
+
+    @staticmethod
+    def _tags(
+        fields: list[str], line_number: int, stats: ReaderStats
+    ) -> dict[str, str]:
+        tags = {}
+        for tag, value in zip(fields[0::2], fields[1::2]):
+            if tag in tags:
+                stats.warn(line_number, f"duplicate tag {tag}, using last value")
+            tags[tag] = value
+        return tags
+
+    @staticmethod
+    def _tag_integer(
+        tags: dict[str, str],
+        tag: str,
+        default: int,
+        line_number: int,
+        stats: ReaderStats,
+    ) -> int:
+        return optional_integer(
+            tags.get(tag, "").strip(), f"tag {tag}", default, line_number, stats
+        )