prozorro-cli 0.1.0__py3-none-any.whl

prozorro_cli/__init__.py

@@ -0,0 +1,4 @@
+"""Command-line client for public Prozorro tender data."""
+
+__version__ = "0.1.0"
+

prozorro_cli/__main__.py

@@ -0,0 +1,6 @@
+from prozorro_cli.cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
+

prozorro_cli/cli.py

@@ -0,0 +1,141 @@
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+import webbrowser
+from collections.abc import Sequence
+
+from prozorro_cli.client import (
+    ProzorroError,
+    download_documents,
+    fetch_tender,
+    normal_guid,
+    public_api_link,
+    resolve_guid,
+    tender_link,
+)
+
+
+def configure_windows_streams() -> None:
+    for stream in (sys.stdout, sys.stderr):
+        reconfigure = getattr(stream, "reconfigure", None)
+        if reconfigure is not None:
+            reconfigure(encoding="utf-8")
+
+
+def print_link(url: str, *, open_in_browser: bool) -> None:
+    print(url)
+    if open_in_browser and not webbrowser.open(url, new=2):
+        raise ProzorroError("Не вдалося відкрити посилання у браузері.")
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="prozorro-cli",
+        description="Отримання публічних даних про тендери Prozorro.",
+    )
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    tender_parser = subparsers.add_parser(
+        "tender",
+        help="отримати посилання, GUID або повний JSON тендера",
+    )
+    tender_parser.add_argument(
+        "reference",
+        metavar="REFERENCE",
+        help="UA-ID, GUID, UUID або посилання на тендер Prozorro",
+    )
+
+    output_group = tender_parser.add_mutually_exclusive_group()
+    output_group.add_argument(
+        "--link",
+        action="store_true",
+        help="вивести посилання на повний JSON у Public API",
+    )
+    output_group.add_argument(
+        "--link-html",
+        "--linkhtml",
+        dest="link_html",
+        action="store_true",
+        help="вивести посилання на HTML-сторінку тендера",
+    )
+    output_group.add_argument(
+        "--guid",
+        action="store_true",
+        help="вивести внутрішній id Prozorro без дефісів",
+    )
+    output_group.add_argument(
+        "--guid-normal",
+        action="store_true",
+        help="вивести внутрішній id у стандартному форматі UUID",
+    )
+    tender_parser.add_argument(
+        "--open",
+        action="store_true",
+        help="відкрити посилання з --link або --link-html у браузері",
+    )
+
+    documents_parser = subparsers.add_parser(
+        "documents",
+        help="завантажити всі файли з data.documents тендера",
+    )
+    documents_parser.add_argument(
+        "reference",
+        metavar="REFERENCE",
+        help="UA-ID, GUID, UUID або посилання на тендер Prozorro",
+    )
+    documents_parser.add_argument(
+        "--output",
+        required=True,
+        metavar="DIRECTORY",
+        help="каталог для завантажених документів",
+    )
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    configure_windows_streams()
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    try:
+        if args.command == "tender":
+            if args.open and not (args.link or args.link_html):
+                parser.error("--open потребує --link або --link-html.")
+
+            if args.link:
+                print_link(
+                    public_api_link(args.reference),
+                    open_in_browser=args.open,
+                )
+                return 0
+
+            if args.link_html:
+                print_link(
+                    tender_link(args.reference),
+                    open_in_browser=args.open,
+                )
+                return 0
+
+            if args.guid or args.guid_normal:
+                guid = resolve_guid(args.reference)
+                print(normal_guid(guid) if args.guid_normal else guid)
+                return 0
+
+            payload = fetch_tender(args.reference)
+            json.dump(payload, sys.stdout, ensure_ascii=False, indent=2)
+            sys.stdout.write("\n")
+            return 0
+
+        if args.command == "documents":
+            downloaded = download_documents(args.reference, args.output)
+            for path in downloaded:
+                print(path)
+            print(f"Завантажено документів: {len(downloaded)}")
+            return 0
+    except ProzorroError as error:
+        parser.exit(1, f"Помилка: {error}\n")
+
+    parser.error("Невідома команда.")
+    return 2

prozorro_cli/client.py

@@ -0,0 +1,297 @@
+from __future__ import annotations
+
+import json
+import re
+import shutil
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any
+from urllib.error import HTTPError, URLError
+from urllib.parse import quote, unquote, urlsplit
+from urllib.request import Request, urlopen
+
+
+SUMMARY_URL = "https://prozorro.gov.ua/api/tenders/{tender_id}/summary"
+PUBLIC_API_URL = "https://public-api.prozorro.gov.ua/api/2.5/tenders/{guid}"
+TENDER_PAGE_URL = "https://prozorro.gov.ua/tender/{tender_id}"
+
+TENDER_ID_PATTERN = re.compile(r"^UA-\d{4}-\d{2}-\d{2}-\d{6}-[a-z]$")
+GUID_PATTERN = re.compile(r"^[0-9a-fA-F]{32}$")
+NORMAL_GUID_PATTERN = re.compile(
+    r"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-"
+    r"[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+)
+SUPPORTED_HOSTS = {
+    "prozorro.gov.ua",
+    "www.prozorro.gov.ua",
+    "public-api.prozorro.gov.ua",
+}
+INVALID_FILENAME_CHARS = re.compile(r'[<>:"/\\|?*\x00-\x1f]')
+WINDOWS_RESERVED_FILENAMES = {
+    "CON",
+    "PRN",
+    "AUX",
+    "NUL",
+    *(f"COM{number}" for number in range(1, 10)),
+    *(f"LPT{number}" for number in range(1, 10)),
+}
+
+
+class ProzorroError(RuntimeError):
+    """A user-facing error returned by Prozorro or the network."""
+
+
+@dataclass(frozen=True)
+class TenderReference:
+    tender_id: str | None = None
+    guid: str | None = None
+
+
+def validate_tender_id(tender_id: str) -> str:
+    if not TENDER_ID_PATTERN.fullmatch(tender_id):
+        raise ProzorroError(
+            "Некоректний номер тендера. Очікується формат "
+            "UA-YYYY-MM-DD-NNNNNN-x."
+        )
+    return tender_id
+
+
+def compact_guid(guid: str) -> str:
+    if GUID_PATTERN.fullmatch(guid):
+        return guid.lower()
+    if NORMAL_GUID_PATTERN.fullmatch(guid):
+        return guid.replace("-", "").lower()
+    raise ProzorroError("Некоректний внутрішній id Prozorro.")
+
+
+def parse_tender_reference(value: str) -> TenderReference:
+    candidate = value.strip()
+    if TENDER_ID_PATTERN.fullmatch(candidate):
+        return TenderReference(tender_id=candidate)
+    if GUID_PATTERN.fullmatch(candidate) or NORMAL_GUID_PATTERN.fullmatch(candidate):
+        return TenderReference(guid=compact_guid(candidate))
+
+    parsed = urlsplit(candidate)
+    if parsed.scheme not in {"http", "https"} or parsed.hostname not in SUPPORTED_HOSTS:
+        raise ProzorroError(
+            "Очікується UA-ID, GUID, UUID або посилання на тендер Prozorro."
+        )
+
+    parts = [unquote(part) for part in parsed.path.strip("/").split("/") if part]
+    if len(parts) == 2 and parts[0] == "tender":
+        return TenderReference(tender_id=validate_tender_id(parts[1]))
+    if len(parts) == 3 and parts[0] in {"uk", "en"} and parts[1] == "tender":
+        return TenderReference(tender_id=validate_tender_id(parts[2]))
+    if (
+        len(parts) == 4
+        and parts[0:2] == ["api", "tenders"]
+        and parts[3] == "summary"
+    ):
+        return TenderReference(tender_id=validate_tender_id(parts[2]))
+    if (
+        len(parts) == 4
+        and parts[0:3] == ["api", "2.5", "tenders"]
+    ):
+        return TenderReference(guid=compact_guid(parts[3]))
+
+    raise ProzorroError("Посилання не веде на підтримуваний тендер Prozorro.")
+
+
+def tender_link(reference: str, *, timeout: float = 30.0) -> str:
+    tender_id = resolve_tender_id(reference, timeout=timeout)
+    return TENDER_PAGE_URL.format(tender_id=quote(tender_id, safe=""))
+
+
+def public_api_link(reference: str, *, timeout: float = 30.0) -> str:
+    guid = resolve_guid(reference, timeout=timeout)
+    return PUBLIC_API_URL.format(guid=guid)
+
+
+def fetch_json(url: str, *, timeout: float = 30.0) -> dict[str, Any]:
+    request = Request(
+        url,
+        headers={
+            "Accept": "application/json",
+            "Accept-Language": "uk",
+            "User-Agent": "prozorro-cli/0.1 (+https://prozorro.gov.ua)",
+        },
+    )
+
+    try:
+        with urlopen(request, timeout=timeout) as response:
+            payload = json.load(response)
+    except HTTPError as error:
+        if error.code == 404:
+            raise ProzorroError("Тендер не знайдено.") from error
+        raise ProzorroError(f"Prozorro повернув HTTP {error.code}.") from error
+    except URLError as error:
+        reason = getattr(error, "reason", error)
+        raise ProzorroError(f"Не вдалося підключитися до Prozorro: {reason}") from error
+    except (json.JSONDecodeError, UnicodeDecodeError) as error:
+        raise ProzorroError("Prozorro повернув некоректний JSON.") from error
+
+    if not isinstance(payload, dict):
+        raise ProzorroError("Prozorro повернув JSON неочікуваного формату.")
+    return payload
+
+
+def resolve_guid(reference: str, *, timeout: float = 30.0) -> str:
+    parsed = parse_tender_reference(reference)
+    if parsed.guid is not None:
+        return parsed.guid
+
+    tender_id = parsed.tender_id
+    if tender_id is None:
+        raise ProzorroError("Не вдалося визначити номер тендера.")
+    url = SUMMARY_URL.format(tender_id=quote(tender_id, safe=""))
+    summary = fetch_json(url, timeout=timeout)
+    guid = summary.get("id")
+
+    if not isinstance(guid, str) or not GUID_PATTERN.fullmatch(guid):
+        raise ProzorroError("У відповіді Prozorro немає коректного внутрішнього id.")
+    return guid.lower()
+
+
+def normal_guid(guid: str) -> str:
+    normalized = compact_guid(guid)
+    return (
+        f"{normalized[0:8]}-{normalized[8:12]}-{normalized[12:16]}-"
+        f"{normalized[16:20]}-{normalized[20:32]}"
+    )
+
+
+def fetch_tender(reference: str, *, timeout: float = 30.0) -> dict[str, Any]:
+    guid = resolve_guid(reference, timeout=timeout)
+    url = PUBLIC_API_URL.format(guid=guid)
+    return fetch_json(url, timeout=timeout)
+
+
+def safe_document_filename(value: str, *, fallback: str) -> str:
+    filename = INVALID_FILENAME_CHARS.sub("_", value).strip().rstrip(". ")
+    if not filename:
+        filename = fallback
+
+    stem = filename.split(".", 1)[0].upper()
+    if stem in WINDOWS_RESERVED_FILENAMES:
+        filename = f"_{filename}"
+    return filename
+
+
+def available_path(directory: Path, filename: str) -> Path:
+    candidate = directory / filename
+    if not candidate.exists():
+        return candidate
+
+    suffix = candidate.suffix
+    stem = candidate.name[: -len(suffix)] if suffix else candidate.name
+    number = 2
+    while True:
+        candidate = directory / f"{stem} ({number}){suffix}"
+        if not candidate.exists():
+            return candidate
+        number += 1
+
+
+def download_document(
+    url: str,
+    destination: Path,
+    *,
+    timeout: float = 30.0,
+) -> None:
+    parsed = urlsplit(url)
+    if parsed.scheme not in {"http", "https"} or not parsed.hostname:
+        raise ProzorroError("Документ містить некоректне посилання.")
+
+    request = Request(
+        url,
+        headers={"User-Agent": "prozorro-cli/0.1 (+https://prozorro.gov.ua)"},
+    )
+    try:
+        with urlopen(request, timeout=timeout) as response:
+            with destination.open("xb") as output:
+                shutil.copyfileobj(response, output)
+    except HTTPError as error:
+        destination.unlink(missing_ok=True)
+        raise ProzorroError(
+            f"Не вдалося завантажити документ: HTTP {error.code}."
+        ) from error
+    except URLError as error:
+        destination.unlink(missing_ok=True)
+        reason = getattr(error, "reason", error)
+        raise ProzorroError(
+            f"Не вдалося завантажити документ: {reason}"
+        ) from error
+    except OSError as error:
+        destination.unlink(missing_ok=True)
+        raise ProzorroError(
+            f"Не вдалося зберегти документ «{destination.name}»: {error}"
+        ) from error
+
+
+def download_documents(
+    reference: str,
+    output: str | Path,
+    *,
+    timeout: float = 30.0,
+) -> list[Path]:
+    payload = fetch_tender(reference, timeout=timeout)
+    data = payload.get("data")
+    documents = data.get("documents") if isinstance(data, dict) else None
+    if not isinstance(documents, list):
+        raise ProzorroError("У відповіді Prozorro немає масиву data.documents.")
+
+    output_directory = Path(output).expanduser()
+    try:
+        output_directory.mkdir(parents=True, exist_ok=True)
+    except OSError as error:
+        raise ProzorroError(
+            f"Не вдалося створити каталог «{output_directory}»: {error}"
+        ) from error
+    if not output_directory.is_dir():
+        raise ProzorroError(f"Шлях «{output_directory}» не є каталогом.")
+
+    downloaded: list[Path] = []
+    for index, document in enumerate(documents, start=1):
+        if not isinstance(document, dict):
+            raise ProzorroError(
+                f"Документ #{index} у data.documents має некоректний формат."
+            )
+
+        url = document.get("url")
+        if not isinstance(url, str) or not url.strip():
+            raise ProzorroError(
+                f"Документ #{index} у data.documents не містить url."
+            )
+
+        document_id = document.get("id")
+        fallback = (
+            document_id
+            if isinstance(document_id, str) and document_id.strip()
+            else f"document-{index}"
+        )
+        title = document.get("title")
+        filename = safe_document_filename(
+            title if isinstance(title, str) else "",
+            fallback=fallback,
+        )
+        destination = available_path(output_directory, filename)
+        download_document(url, destination, timeout=timeout)
+        downloaded.append(destination)
+
+    return downloaded
+
+
+def resolve_tender_id(reference: str, *, timeout: float = 30.0) -> str:
+    parsed = parse_tender_reference(reference)
+    if parsed.tender_id is not None:
+        return parsed.tender_id
+
+    guid = parsed.guid
+    if guid is None:
+        raise ProzorroError("Не вдалося визначити внутрішній id Prozorro.")
+    payload = fetch_json(PUBLIC_API_URL.format(guid=guid), timeout=timeout)
+    data = payload.get("data")
+    tender_id = data.get("tenderID") if isinstance(data, dict) else None
+    if not isinstance(tender_id, str):
+        raise ProzorroError("У відповіді Prozorro немає номера тендера.")
+    return validate_tender_id(tender_id)

prozorro_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: prozorro-cli
+Version: 0.1.0
+Summary: Small command-line client for public Prozorro tender data
+Author: prozorro-cli contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/radimbig2/prozorro-cli
+Project-URL: Issues, https://github.com/radimbig2/prozorro-cli/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Internet :: WWW/HTTP
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# prozorro-cli
+
+Невелика CLI для отримання публічних даних про тендери Prozorro за UA-ID,
+внутрішнім GUID, стандартним UUID або посиланням.
+
+## Встановлення
+
+```powershell
+pip install prozorro-cli
+prozorro-cli --help
+```
+
+Для ізольованого глобального встановлення CLI також можна використати
+`pipx install prozorro-cli`.
+
+## Команди
+
+```powershell
+# Посилання на повний JSON у Public API
+prozorro-cli tender UA-2026-06-15-003439-a --link
+
+# Посилання на HTML-сторінку тендера
+prozorro-cli tender UA-2026-06-15-003439-a --link-html
+
+# Надрукувати й відкрити JSON Public API у браузері
+prozorro-cli tender UA-2026-06-15-003439-a --link --open
+
+# Надрукувати й відкрити HTML-сторінку у браузері
+prozorro-cli tender UA-2026-06-15-003439-a --link-html --open
+
+# Скорочений alias для --link-html
+prozorro-cli tender UA-2026-06-15-003439-a --linkhtml --open
+
+# Внутрішній id Prozorro
+prozorro-cli tender UA-2026-06-15-003439-a --guid
+
+# Той самий id у стандартному форматі UUID
+prozorro-cli tender UA-2026-06-15-003439-a --guid-normal
+
+# Повний JSON із public-api.prozorro.gov.ua
+prozorro-cli tender UA-2026-06-15-003439-a
+
+# Повний JSON за GUID без дефісів
+prozorro-cli tender 5d2590ef8a1b455f8d09ceeae474b21f
+
+# Повний JSON за стандартним UUID
+prozorro-cli tender 5d2590ef-8a1b-455f-8d09-ceeae474b21f
+
+# Повний JSON за посиланням на сторінку тендера
+prozorro-cli tender https://prozorro.gov.ua/tender/UA-2026-06-15-003439-a
+
+# Повний JSON за посиланням Public API
+prozorro-cli tender https://public-api.prozorro.gov.ua/api/2.5/tenders/5d2590ef8a1b455f8d09ceeae474b21f
+
+# Завантажити всі файли з data.documents за посиланням Public API
+prozorro-cli documents https://public-api.prozorro.gov.ua/api/2.5/tenders/5d2590ef8a1b455f8d09ceeae474b21f --output /temp
+
+# Те саме за UA-ID
+prozorro-cli documents UA-2026-06-15-003439-a --output /temp
+```
+
+Для UA-ID і посилання на сторінку CLI спочатку отримує внутрішній `id` через
+публічний endpoint `https://prozorro.gov.ua/api/tenders/<UA-ID>/summary`.
+Для GUID, UUID і посилання Public API цей крок пропускається. Повний JSON
+завантажується з `https://public-api.prozorro.gov.ua/api/2.5/tenders/<id>`.
+
+Команда `documents` створює каталог із `--output`, якщо його ще немає, і
+завантажує туди всі файли з `data.documents`. Імена беруться з `title`;
+однакові імена не перезаписуються, а отримують суфікси `(2)`, `(3)` тощо.
+
+## Розробка
+
+```powershell
+$env:PYTHONPATH = "$PWD\src"
+python -m unittest discover -s tests -v
+python -m prozorro_cli tender UA-2026-06-15-003439-a --guid
+```
+
+## Реліз
+
+1. Оновіть `version` у `pyproject.toml` та `__version__` у
+   `src/prozorro_cli/__init__.py`.
+2. Створіть і опублікуйте GitHub Release з тегом тієї ж версії, наприклад
+   `v0.1.0`.
+3. GitHub Actions перевірить тести, збере wheel і sdist, додасть їх до Release
+   та опублікує пакет у PyPI.
+
+Для публікації потрібен GitHub Actions secret `PYPI_API_TOKEN` з API-токеном
+PyPI. Job публікації запускається в GitHub environment `pypi`.

prozorro_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+prozorro_cli/__init__.py,sha256=f5nEXYxLx9K2LTCu7O7npVNkD1Zfqjxxp5cAD6Ms5ng,83
+prozorro_cli/__main__.py,sha256=OqX5QqcJXR9KkCRi-aDOVAycnswOmMg2RXBioMVlXsg,93
+prozorro_cli/cli.py,sha256=-oDmywxy0OME6ErnuaXly1ba9zqP5g-kXuyLGhxS2aQ,4534
+prozorro_cli/client.py,sha256=9ryPqD9E9IClDCiTCdKn4JlsbSGUO6UFhTDa9SuEGzw,10651
+prozorro_cli-0.1.0.dist-info/licenses/LICENSE,sha256=hGKdMD9xcC-tN4dm1tdMvQdjvxz6YMJo-H1sCeJukRo,1083
+prozorro_cli-0.1.0.dist-info/METADATA,sha256=KsBwBtA_s2VowYVH5BgABXGzU-57ULB41TsTYcwvhpo,4678
+prozorro_cli-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+prozorro_cli-0.1.0.dist-info/entry_points.txt,sha256=cXh2mNyxCc2b8lqzDallHiqaMGDdLEPxBatQo1faWk0,55
+prozorro_cli-0.1.0.dist-info/top_level.txt,sha256=OJy-Q0hwUQTUCgd5LW3Fipk1zTIkW4mj_VuvD35pMWQ,13
+prozorro_cli-0.1.0.dist-info/RECORD,,

prozorro_cli-0.1.0.dist-info/WHEEL

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

prozorro_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+prozorro-cli = prozorro_cli.cli:main

prozorro_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 prozorro-cli contributors
+
+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.
+

prozorro_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+prozorro_cli