michraz 0.1.0__tar.gz

michraz-0.1.0/LICENSE

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

michraz-0.1.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: michraz
+Version: 0.1.0
+Summary: One clean interface to Israeli public tenders.
+Author-email: Yoav Haimov <haimovyoav.work@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Zikithezikit/michraz
+Project-URL: Documentation, https://github.com/Zikithezikit/michraz#readme
+Project-URL: Issues, https://github.com/Zikithezikit/michraz/issues
+Project-URL: Changelog, https://github.com/Zikithezikit/michraz/blob/main/CHANGELOG.md
+Project-URL: PyPI, https://pypi.org/project/michraz/
+Keywords: israel,tenders,procurement,michraz,open-data
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+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: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: tzdata; sys_platform == "win32"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: respx; extra == "dev"
+Requires-Dist: pandas; extra == "dev"
+Provides-Extra: pandas
+Requires-Dist: pandas; extra == "pandas"
+Dynamic: license-file
+
+# michraz
+
+[![PyPI](https://img.shields.io/pypi/v/michraz)](https://pypi.org/project/michraz/)
+[![Python](https://img.shields.io/pypi/pyversions/michraz)](https://pypi.org/project/michraz/)
+[![CI](https://github.com/Zikithezikit/michraz/actions/workflows/ci.yml/badge.svg)](https://github.com/Zikithezikit/michraz/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/Zikithezikit/michraz/blob/main/LICENSE)
+
+Israeli public tenders (מכרזים) in Python. One `Tender` object, whichever site it came from.
+
+Sources today: Israel Land Authority land tenders and Beer Sheva municipal tenders.
+
+> Unofficial client. It can lag or miss tenders, and parsing can break when a source changes. Confirm deadlines on
+> the publisher's page before you act. Not affiliated with the Israel Land Authority or any municipality.
+
+![What michraz does](https://raw.githubusercontent.com/Zikithezikit/michraz/main/docs/images/overview.png)
+
+## Install
+
+```bash
+pip install michraz            # Python 3.10+
+pip install "michraz[pandas]"  # optional, for DataFrames
+```
+
+## Use it
+
+```python
+from michraz import Michraz, to_csv
+
+with Michraz() as m:
+    tenders = m.search(keyword="גינון", open_only=True)
+
+for t in tenders:
+    print(f"{t.deadline:%Y-%m-%d}  {t.title}  {t.url}")
+
+to_csv(tenders, "tenders.csv")
+```
+
+Results are sorted by deadline. Filter by `source`, `closing_before` and `closing_after` (dates or aware
+datetimes) too. Each tender has an `attribution` string. Keep it when you republish the data.
+
+Or from the terminal:
+
+```bash
+michraz search --open --source rmi
+michraz search --keyword גינון --csv gardening.csv
+```
+
+![Terminal output](https://raw.githubusercontent.com/Zikithezikit/michraz/main/docs/images/cli.png)
+
+A record that fails to parse is skipped and listed in `m.last_errors`. An unreachable source raises
+`SourceUnavailableError`. More scripts are in [examples](https://github.com/Zikithezikit/michraz/tree/main/examples).
+
+## Add a source
+
+Write a class with `name`, `description`, `attribution`, `errors` and a `fetch()` that yields `Tender`s, then pass
+it to `Michraz([MySource()])`.
+
+![Classes](https://raw.githubusercontent.com/Zikithezikit/michraz/main/docs/images/classes.png)
+
+Fields are documented in [docs/model.md](https://github.com/Zikithezikit/michraz/blob/main/docs/model.md), and how
+each source was checked in [docs/sources.md](https://github.com/Zikithezikit/michraz/blob/main/docs/sources.md).
+
+## Polite by default
+
+![Request flow](https://raw.githubusercontent.com/Zikithezikit/michraz/main/docs/images/request_flow.png)
+
+Honest User-Agent, one request per second per host, one-hour disk cache, at most two retries. Tune it with
+`Michraz(cache_dir=None, cache_ttl=..., min_interval=...)`.
+
+## Limitations
+
+- RMI region, type, purpose and status are raw numeric codes in `tender.extra`. No verified label table exists.
+- RMI tender details and documents are not fetched yet.
+- Keyword search is a Unicode-normalized substring match. No stemming.
+
+## Development
+
+```bash
+make venv && make check
+```
+
+Tests run against recorded responses and never touch the network. See
+[CONTRIBUTING.md](https://github.com/Zikithezikit/michraz/blob/main/CONTRIBUTING.md).
+
+MIT licensed. The data belongs to its publishers and carries their licenses.

michraz-0.1.0/README.md

@@ -0,0 +1,85 @@
+# michraz
+
+[![PyPI](https://img.shields.io/pypi/v/michraz)](https://pypi.org/project/michraz/)
+[![Python](https://img.shields.io/pypi/pyversions/michraz)](https://pypi.org/project/michraz/)
+[![CI](https://github.com/Zikithezikit/michraz/actions/workflows/ci.yml/badge.svg)](https://github.com/Zikithezikit/michraz/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/Zikithezikit/michraz/blob/main/LICENSE)
+
+Israeli public tenders (מכרזים) in Python. One `Tender` object, whichever site it came from.
+
+Sources today: Israel Land Authority land tenders and Beer Sheva municipal tenders.
+
+> Unofficial client. It can lag or miss tenders, and parsing can break when a source changes. Confirm deadlines on
+> the publisher's page before you act. Not affiliated with the Israel Land Authority or any municipality.
+
+![What michraz does](https://raw.githubusercontent.com/Zikithezikit/michraz/main/docs/images/overview.png)
+
+## Install
+
+```bash
+pip install michraz            # Python 3.10+
+pip install "michraz[pandas]"  # optional, for DataFrames
+```
+
+## Use it
+
+```python
+from michraz import Michraz, to_csv
+
+with Michraz() as m:
+    tenders = m.search(keyword="גינון", open_only=True)
+
+for t in tenders:
+    print(f"{t.deadline:%Y-%m-%d}  {t.title}  {t.url}")
+
+to_csv(tenders, "tenders.csv")
+```
+
+Results are sorted by deadline. Filter by `source`, `closing_before` and `closing_after` (dates or aware
+datetimes) too. Each tender has an `attribution` string. Keep it when you republish the data.
+
+Or from the terminal:
+
+```bash
+michraz search --open --source rmi
+michraz search --keyword גינון --csv gardening.csv
+```
+
+![Terminal output](https://raw.githubusercontent.com/Zikithezikit/michraz/main/docs/images/cli.png)
+
+A record that fails to parse is skipped and listed in `m.last_errors`. An unreachable source raises
+`SourceUnavailableError`. More scripts are in [examples](https://github.com/Zikithezikit/michraz/tree/main/examples).
+
+## Add a source
+
+Write a class with `name`, `description`, `attribution`, `errors` and a `fetch()` that yields `Tender`s, then pass
+it to `Michraz([MySource()])`.
+
+![Classes](https://raw.githubusercontent.com/Zikithezikit/michraz/main/docs/images/classes.png)
+
+Fields are documented in [docs/model.md](https://github.com/Zikithezikit/michraz/blob/main/docs/model.md), and how
+each source was checked in [docs/sources.md](https://github.com/Zikithezikit/michraz/blob/main/docs/sources.md).
+
+## Polite by default
+
+![Request flow](https://raw.githubusercontent.com/Zikithezikit/michraz/main/docs/images/request_flow.png)
+
+Honest User-Agent, one request per second per host, one-hour disk cache, at most two retries. Tune it with
+`Michraz(cache_dir=None, cache_ttl=..., min_interval=...)`.
+
+## Limitations
+
+- RMI region, type, purpose and status are raw numeric codes in `tender.extra`. No verified label table exists.
+- RMI tender details and documents are not fetched yet.
+- Keyword search is a Unicode-normalized substring match. No stemming.
+
+## Development
+
+```bash
+make venv && make check
+```
+
+Tests run against recorded responses and never touch the network. See
+[CONTRIBUTING.md](https://github.com/Zikithezikit/michraz/blob/main/CONTRIBUTING.md).
+
+MIT licensed. The data belongs to its publishers and carries their licenses.

michraz-0.1.0/pyproject.toml

@@ -0,0 +1,72 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "michraz"
+version = "0.1.0"
+description = "One clean interface to Israeli public tenders."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Yoav Haimov", email = "haimovyoav.work@gmail.com" }]
+keywords = ["israel", "tenders", "procurement", "michraz", "open-data"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Topic :: Software Development :: Libraries",
+  "Typing :: Typed",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+]
+
+dependencies = [
+  "httpx>=0.27",
+  "tzdata; sys_platform == 'win32'",
+]
+
+[project.urls]
+Homepage = "https://github.com/Zikithezikit/michraz"
+Documentation = "https://github.com/Zikithezikit/michraz#readme"
+Issues = "https://github.com/Zikithezikit/michraz/issues"
+Changelog = "https://github.com/Zikithezikit/michraz/blob/main/CHANGELOG.md"
+PyPI = "https://pypi.org/project/michraz/"
+
+[project.optional-dependencies]
+dev = ["pytest", "pytest-cov", "ruff", "mypy", "build", "twine", "respx", "pandas"]
+pandas = ["pandas"]
+
+[project.scripts]
+michraz = "michraz.cli:main"
+
+[tool.setuptools.package-data]
+michraz = ["py.typed", "sources/data/*.json"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-m 'not live'"
+markers = ["live: talks to the real services; run with `pytest -m live`"]
+
+[tool.ruff]
+line-length = 120
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["E501"]
+
+[tool.mypy]
+files = ["src"]
+strict = true
+
+[[tool.mypy.overrides]]
+module = "pandas"
+ignore_missing_imports = true

michraz-0.1.0/setup.cfg

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

michraz-0.1.0/src/michraz/__init__.py

@@ -0,0 +1,34 @@
+"""michraz: one clean interface to Israeli public tenders.
+
+from michraz import Michraz
+
+with Michraz() as m:
+    for tender in m.search(keyword="גינון", open_only=True):
+        print(tender.deadline, tender.title)
+"""
+
+from michraz._version import __version__
+from michraz.client import Michraz
+from michraz.errors import MichrazError, SourceFormatError, SourceUnavailableError
+from michraz.export import to_csv, to_dataframe, to_dicts
+from michraz.models import Document, Tender
+from michraz.sources import BeerShevaExtra, BeerShevaSource, RmiExtra, RmiSource, Source, SourceName
+
+__all__ = [
+    "BeerShevaExtra",
+    "BeerShevaSource",
+    "Document",
+    "Michraz",
+    "MichrazError",
+    "RmiExtra",
+    "RmiSource",
+    "Source",
+    "SourceName",
+    "SourceFormatError",
+    "SourceUnavailableError",
+    "Tender",
+    "__version__",
+    "to_csv",
+    "to_dataframe",
+    "to_dicts",
+]

michraz-0.1.0/src/michraz/__main__.py

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

michraz-0.1.0/src/michraz/_closeable.py

@@ -0,0 +1,25 @@
+"""Context-manager behaviour shared by every object that owns a connection pool."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from types import TracebackType
+from typing import TypeVar
+
+_T = TypeVar("_T", bound="Closeable")
+
+
+class Closeable(ABC):
+    """An object with a :meth:`close` method that can be used in a ``with`` block."""
+
+    @abstractmethod
+    def close(self) -> None:
+        """Releases the resources this object owns."""
+
+    def __enter__(self: _T) -> _T:
+        return self
+
+    def __exit__(
+        self, exc_type: type[BaseException] | None, exc: BaseException | None, tb: TracebackType | None
+    ) -> None:
+        self.close()

michraz-0.1.0/src/michraz/_dates.py

@@ -0,0 +1,68 @@
+"""Date parsing helpers. Every datetime michraz produces is timezone-aware."""
+
+from __future__ import annotations
+
+import re
+from datetime import datetime
+from zoneinfo import ZoneInfo
+
+TIMEZONE_NAME = "Asia/Jerusalem"
+JERUSALEM = ZoneInfo(TIMEZONE_NAME)
+
+LOCAL_FORMAT = "%d/%m/%Y %H:%M:%S"
+
+UTC_DESIGNATOR = "Z"
+UTC_OFFSET = "+00:00"
+
+_FRACTION = re.compile(r"\.(\d+)")
+MICROSECOND_DIGITS = 6
+
+
+def _pad_fraction(match: re.Match[str]) -> str:
+    # Python 3.10 only accepts fractions of exactly 3 or 6 digits; the RMI API sends 2 ("57.55").
+    return "." + match.group(1)[:MICROSECOND_DIGITS].ljust(MICROSECOND_DIGITS, "0")
+
+
+def parse_iso(value: str | None) -> datetime | None:
+    """Parses an ISO 8601 timestamp and converts it to Asia/Jerusalem.
+
+    Args:
+        value: Timestamp such as ``"2026-12-28T12:00:00+02:00"``. A value without an offset is taken as
+            Asia/Jerusalem local time.
+
+    Returns:
+        An aware datetime, or None if ``value`` is None or blank.
+
+    Raises:
+        ValueError: If ``value`` is not a valid ISO 8601 timestamp.
+    """
+    if value is None or not value.strip():
+        return None
+    text = _FRACTION.sub(_pad_fraction, value.strip().replace(UTC_DESIGNATOR, UTC_OFFSET))
+    parsed = datetime.fromisoformat(text)
+    if parsed.tzinfo is None:
+        return parsed.replace(tzinfo=JERUSALEM)
+    return parsed.astimezone(JERUSALEM)
+
+
+def parse_local(value: str | None, fmt: str = LOCAL_FORMAT) -> datetime | None:
+    """Parses a local Israeli timestamp such as ``"10/11/2026 12:00:00"``.
+
+    Args:
+        value: Text to parse.
+        fmt: ``strptime`` format. Defaults to ``dd/mm/yyyy HH:MM:SS``.
+
+    Returns:
+        An aware datetime in Asia/Jerusalem, or None if ``value`` is None or blank.
+
+    Raises:
+        ValueError: If ``value`` does not match ``fmt``.
+    """
+    if value is None or not value.strip():
+        return None
+    return datetime.strptime(value.strip(), fmt).replace(tzinfo=JERUSALEM)
+
+
+def now() -> datetime:
+    """Returns the current time in Asia/Jerusalem."""
+    return datetime.now(JERUSALEM)

michraz-0.1.0/src/michraz/_enums.py

@@ -0,0 +1,14 @@
+"""Enum base used across the package."""
+
+from enum import Enum
+
+
+class StrEnum(str, Enum):
+    """A string enum whose members equal, hash and print as their values.
+
+    ``StrEnum.MEMBER == "value"`` is true and members work as dictionary keys next to plain strings, so code
+    that still passes the raw string keeps working. ``enum.StrEnum`` exists only from Python 3.11.
+    """
+
+    def __str__(self) -> str:
+        return str(self.value)