infosoud 0.1.0__tar.gz

infosoud-0.1.0/LICENSE

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

infosoud-0.1.0/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: infosoud
+Version: 0.1.0
+Summary: Czech court case lookup tool (infosoud.gov.cz)
+Author: pravnikovo.info
+License-Expression: MIT
+Project-URL: Homepage, https://infosoud.pravnikovo.info
+Project-URL: Repository, https://github.com/pravnikovo/infosoud
+Keywords: czech,court,justice,infosoud,právní,soud
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business
+Classifier: Natural Language :: Czech
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.20
+Provides-Extra: web
+Requires-Dist: flask>=2.0; extra == "web"
+Dynamic: license-file
+
+# InfoSoud
+
+Neoficiální klient pro [InfoSoud](https://infosoud.gov.cz) — vyhledávání v soudních řízeních České republiky.
+
+Umožňuje vyhledat průběh soudního řízení, nařízená jednání a události podle spisové značky. Data pocházejí z veřejného API Ministerstva spravedlnosti ČR.
+
+**[infosoud.pravnikovo.info](https://infosoud.pravnikovo.info)** — webové rozhraní
+
+## Instalace
+
+```bash
+pip install infosoud
+```
+
+## Použití
+
+### Příkazový řádek
+
+```bash
+# Vyhledat řízení
+infosoud "1 T 64/2024" OSSCEDC
+infosoud "1T64_2024 OSSCEDC"          # kompaktní formát
+infosoud "4 T 21/2025 melnik"         # název soudu místo kódu
+
+# Zobrazit jednání
+infosoud --hearings "1 T 64/2024" OSSCEDC
+
+# JSON výstup
+infosoud --json "1 T 64/2024" OSSCEDC
+
+# CSV výstup (události)
+infosoud --csv "1 T 64/2024" OSSCEDC
+
+# Vypsat soudy
+infosoud --courts
+infosoud --courts --csv
+```
+
+### Python
+
+```python
+from infosoud import InfoSoudClient, parse_spis_zn
+
+client = InfoSoudClient()
+
+# Vyhledat řízení
+case = client.search_case("1 T 64/2024", "OSSCEDC")
+print(case["stav"])          # "nevyřízená věc"
+print(case["organizace"])    # "Okresní soud Děčín"
+
+for event in case["udalosti"]:
+    print(f"{event['datum']}  {event['udalost']}")
+
+# Vyhledat jednání
+hearings = client.search_hearings("1 T 64/2024", "OSSCEDC")
+for h in hearings["udalosti"]:
+    print(f"{h['datum']} {h['cas']}  {h['druhJednani']}  {h['resitel']}")
+
+# Detail události (čas, jednací síň)
+detail = client.get_event_detail("1 T 64/2024", "OSSCEDC", "NAR_JED", 48)
+for attr in detail["atributy"]:
+    print(f"{attr['typ']}: {attr['hodnota']}")
+
+# Spisová značka — tolerantní parser
+spis = parse_spis_zn("1T64_2024")
+print(spis.canonical())  # "1 T 64/2024"
+print(spis.compact())    # "1T64_2024"
+
+# Fuzzy vyhledání soudu
+code = client.resolve_court_name("melnik")  # → "OSSTCME"
+code = client.resolve_court_name("praha 9") # → "OSPHA09"
+
+# Seznam soudů
+courts = client.build_court_map()  # {kód: název} pro všech 104 soudů
+```
+
+### Formáty spisové značky
+
+Parser je maximálně tolerantní — všechny tyto formáty jsou ekvivalentní:
+
+```
+1 T 64/2024       1T64/2024       1T 64/2024
+1 T64/2024        1T64_2024       1 T 64 / 2024
+```
+
+Kód soudu lze přidat za sp. zn.: `1T64_2024 OSSCEDC`
+
+Místo kódu soudu lze zadat název: `4 T 21/2025 melnik` (bez diakritiky)
+
+## API endpointy
+
+| Endpoint | Metoda | Popis |
+|----------|--------|-------|
+| `/api/v1/rizeni/vyhledej` | POST | Vyhledání řízení |
+| `/api/v1/jednani/vyhledej` | POST | Vyhledání jednání |
+| `/api/v1/udalost/vyhledej` | POST | Detail události |
+| `/api/v1/organizace/lov` | GET | Seznam krajských/vrchních soudů |
+| `/api/v1/organizace/podrizene/lov` | GET | Seznam okresních soudů |
+
+Base URL: `https://infosoud.gov.cz/api/v1`
+
+## Kódy soudů
+
+Kompletní seznam 104 soudů (96 z API + 8 poboček):
+
+```bash
+infosoud --courts
+```
+
+Příklady: `OSSCEDC` (OS Děčín), `OSPHA09` (OS Praha 9), `KSJIMBM` (KS Brno), `MSPHAAB` (MS Praha)
+
+## Webové rozhraní
+
+```bash
+pip install infosoud[web]
+python -m infosoud.web
+```
+
+Otevře webserver na `http://localhost:8060` s vyhledávacím formulářem, timeline událostí, ICS exportem jednání a CSV exportem.
+
+## Licence
+
+MIT — viz [LICENSE](LICENSE)
+
+---
+
+*Neoficiální nástroj. Data pocházejí z [infosoud.gov.cz](https://infosoud.gov.cz). Projekt [pravnikovo.info](https://pravnikovo.info) — open source nástroje pro právníky.*

infosoud-0.1.0/README.md

@@ -0,0 +1,127 @@
+# InfoSoud
+
+Neoficiální klient pro [InfoSoud](https://infosoud.gov.cz) — vyhledávání v soudních řízeních České republiky.
+
+Umožňuje vyhledat průběh soudního řízení, nařízená jednání a události podle spisové značky. Data pocházejí z veřejného API Ministerstva spravedlnosti ČR.
+
+**[infosoud.pravnikovo.info](https://infosoud.pravnikovo.info)** — webové rozhraní
+
+## Instalace
+
+```bash
+pip install infosoud
+```
+
+## Použití
+
+### Příkazový řádek
+
+```bash
+# Vyhledat řízení
+infosoud "1 T 64/2024" OSSCEDC
+infosoud "1T64_2024 OSSCEDC"          # kompaktní formát
+infosoud "4 T 21/2025 melnik"         # název soudu místo kódu
+
+# Zobrazit jednání
+infosoud --hearings "1 T 64/2024" OSSCEDC
+
+# JSON výstup
+infosoud --json "1 T 64/2024" OSSCEDC
+
+# CSV výstup (události)
+infosoud --csv "1 T 64/2024" OSSCEDC
+
+# Vypsat soudy
+infosoud --courts
+infosoud --courts --csv
+```
+
+### Python
+
+```python
+from infosoud import InfoSoudClient, parse_spis_zn
+
+client = InfoSoudClient()
+
+# Vyhledat řízení
+case = client.search_case("1 T 64/2024", "OSSCEDC")
+print(case["stav"])          # "nevyřízená věc"
+print(case["organizace"])    # "Okresní soud Děčín"
+
+for event in case["udalosti"]:
+    print(f"{event['datum']}  {event['udalost']}")
+
+# Vyhledat jednání
+hearings = client.search_hearings("1 T 64/2024", "OSSCEDC")
+for h in hearings["udalosti"]:
+    print(f"{h['datum']} {h['cas']}  {h['druhJednani']}  {h['resitel']}")
+
+# Detail události (čas, jednací síň)
+detail = client.get_event_detail("1 T 64/2024", "OSSCEDC", "NAR_JED", 48)
+for attr in detail["atributy"]:
+    print(f"{attr['typ']}: {attr['hodnota']}")
+
+# Spisová značka — tolerantní parser
+spis = parse_spis_zn("1T64_2024")
+print(spis.canonical())  # "1 T 64/2024"
+print(spis.compact())    # "1T64_2024"
+
+# Fuzzy vyhledání soudu
+code = client.resolve_court_name("melnik")  # → "OSSTCME"
+code = client.resolve_court_name("praha 9") # → "OSPHA09"
+
+# Seznam soudů
+courts = client.build_court_map()  # {kód: název} pro všech 104 soudů
+```
+
+### Formáty spisové značky
+
+Parser je maximálně tolerantní — všechny tyto formáty jsou ekvivalentní:
+
+```
+1 T 64/2024       1T64/2024       1T 64/2024
+1 T64/2024        1T64_2024       1 T 64 / 2024
+```
+
+Kód soudu lze přidat za sp. zn.: `1T64_2024 OSSCEDC`
+
+Místo kódu soudu lze zadat název: `4 T 21/2025 melnik` (bez diakritiky)
+
+## API endpointy
+
+| Endpoint | Metoda | Popis |
+|----------|--------|-------|
+| `/api/v1/rizeni/vyhledej` | POST | Vyhledání řízení |
+| `/api/v1/jednani/vyhledej` | POST | Vyhledání jednání |
+| `/api/v1/udalost/vyhledej` | POST | Detail události |
+| `/api/v1/organizace/lov` | GET | Seznam krajských/vrchních soudů |
+| `/api/v1/organizace/podrizene/lov` | GET | Seznam okresních soudů |
+
+Base URL: `https://infosoud.gov.cz/api/v1`
+
+## Kódy soudů
+
+Kompletní seznam 104 soudů (96 z API + 8 poboček):
+
+```bash
+infosoud --courts
+```
+
+Příklady: `OSSCEDC` (OS Děčín), `OSPHA09` (OS Praha 9), `KSJIMBM` (KS Brno), `MSPHAAB` (MS Praha)
+
+## Webové rozhraní
+
+```bash
+pip install infosoud[web]
+python -m infosoud.web
+```
+
+Otevře webserver na `http://localhost:8060` s vyhledávacím formulářem, timeline událostí, ICS exportem jednání a CSV exportem.
+
+## Licence
+
+MIT — viz [LICENSE](LICENSE)
+
+---
+
+*Neoficiální nástroj. Data pocházejí z [infosoud.gov.cz](https://infosoud.gov.cz). Projekt [pravnikovo.info](https://pravnikovo.info) — open source nástroje pro právníky.*

infosoud-0.1.0/infosoud/__init__.py

@@ -0,0 +1,3 @@
+"""InfoSoud — Czech court case lookup tool (infosoud.gov.cz)."""
+
+__version__ = "0.1.0"

infosoud-0.1.0/infosoud/__main__.py

@@ -0,0 +1,165 @@
+"""CLI for InfoSoud — Czech court case lookup.
+
+Usage:
+    python -m infosoud "1 T 64/2024" OSSCEDC
+    python -m infosoud "1T64_2024 OSSCEDC"
+    python -m infosoud "4 T 21/2025 melnik"
+    python -m infosoud --hearings "1 T 64/2024" OSSCEDC
+    python -m infosoud --courts
+    python -m infosoud --json "1 T 64/2024" OSSCEDC
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+from .client import InfoSoudClient, parse_spis_zn, EVENT_LABELS
+
+
+def format_case_summary(data: dict) -> str:
+    """Format case data into human-readable summary."""
+    lines = []
+    org = data.get("organizace", "?")
+    nadr = data.get("nadrizenaOrganizace", "")
+    stav = data.get("stav") or "?"
+    stav_datum = data.get("stavDatum", "")
+
+    spzn = (f"{data.get('cislo', '') or ''} {data.get('druh', '') or ''} "
+            f"{data.get('bcVec', '') or ''}/{data.get('rocnik', '') or ''}")
+    lines.append(f"Sp. zn.: {spzn}")
+    lines.append(f"Soud: {org}" + (f" ({nadr})" if nadr else ""))
+    lines.append(f"Stav: {stav}" + (f" (od {stav_datum})" if stav_datum else ""))
+
+    events = data.get("udalosti") or []
+    if events:
+        lines.append(f"\nUdálosti ({len(events)}):")
+        for ev in events:
+            code = ev.get("udalost", "?")
+            label = EVENT_LABELS.get(code, code)
+            datum = ev.get("datum", "?")
+            zruseno = " [ZRUŠENO]" if ev.get("zruseno") else ""
+            lines.append(f"  {datum}  {label}{zruseno}")
+
+    return "\n".join(lines)
+
+
+def format_hearings_summary(data: dict) -> str:
+    """Format hearings data into human-readable summary."""
+    lines = [f"Jednání — {data.get('organizace', '?')}"]
+    events = data.get("udalosti") or []
+    if not events:
+        lines.append("  Žádná jednání nařízena.")
+        return "\n".join(lines)
+    for ev in events:
+        zruseno = " [ZRUŠENO]" if ev.get("jednaniZruseno") else ""
+        lines.append(f"  {ev.get('datum', '?')} {ev.get('cas', '?')}  "
+                     f"{ev.get('druhJednani', '?')}{zruseno}")
+        lines.append(f"    Soudce: {ev.get('resitel', '?')}")
+        lines.append(f"    Síň: {ev.get('jednaciSin', '?')}")
+    return "\n".join(lines)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="infosoud",
+        description="InfoSoud — vyhledávání v soudních řízeních (infosoud.gov.cz)",
+    )
+    parser.add_argument("spis_zn", nargs="?",
+                        help="Spisová značka (např. '1 T 64/2024', '1T64_2024 OSSCEDC', '4 T 21/2025 melnik')")
+    parser.add_argument("court_code", nargs="?",
+                        help="Kód soudu (nepovinné pokud je v sp. zn.)")
+    parser.add_argument("--hearings", action="store_true",
+                        help="Zobrazit nařízená jednání")
+    parser.add_argument("--courts", action="store_true",
+                        help="Vypsat seznam soudů")
+    parser.add_argument("--json", dest="json_out", action="store_true",
+                        help="Výstup v JSON")
+    parser.add_argument("--csv", dest="csv_out", action="store_true",
+                        help="Výstup v CSV")
+
+    args = parser.parse_args()
+    client = InfoSoudClient()
+
+    if args.courts:
+        courts = client.build_court_map()
+        if args.json_out:
+            print(json.dumps(courts, ensure_ascii=False, indent=2))
+        elif args.csv_out:
+            print("kod,nazev")
+            for code, name in sorted(courts.items(), key=lambda x: x[1]):
+                print(f"{code},{name}")
+        else:
+            for code, name in sorted(courts.items(), key=lambda x: x[1]):
+                print(f"  {code}  {name}")
+            print(f"\nCelkem: {len(courts)} soudů")
+        return
+
+    if not args.spis_zn:
+        parser.print_help()
+        sys.exit(1)
+
+    # Try to resolve court name from input
+    spis_zn_raw = args.spis_zn
+    court_code = args.court_code or ""
+
+    if not court_code:
+        # Check if trailing text in spis_zn is a court name
+        import re
+        m = re.match(
+            r"((?:\d+\s*[A-Za-z]+\s*\d+\s*[/_]\s*\d{4}))\s+(.+)$",
+            spis_zn_raw.strip(),
+        )
+        if m:
+            spzn_part = m.group(1).strip()
+            tail = m.group(2).strip()
+            if re.match(r"^[A-Z][A-Z0-9]{4,9}$", tail):
+                spis_zn_raw, court_code = spzn_part, tail
+            else:
+                resolved = client.resolve_court_name(tail)
+                if resolved:
+                    spis_zn_raw, court_code = spzn_part, resolved
+
+    spis_zn = parse_spis_zn(spis_zn_raw)
+    code = court_code or spis_zn.court_code
+
+    if not code:
+        print("Chybí kód soudu. Zadejte jako druhý argument nebo součást sp. zn.",
+              file=sys.stderr)
+        print("Příklad: python -m infosoud '1 T 64/2024' OSSCEDC", file=sys.stderr)
+        print("         python -m infosoud '4 T 21/2025 melnik'", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        if args.hearings:
+            data = client.search_hearings(spis_zn, code)
+            if args.json_out:
+                print(json.dumps(data, ensure_ascii=False, indent=2))
+            else:
+                print(format_hearings_summary(data))
+        else:
+            data = client.search_case(spis_zn, code)
+            if args.json_out:
+                print(json.dumps(data, ensure_ascii=False, indent=2))
+            elif args.csv_out:
+                events = data.get("udalosti") or []
+                print("datum;udalost;zruseno;souvisejici_spzn;soud")
+                for ev in events:
+                    code_ev = ev.get("udalost", "")
+                    label = EVENT_LABELS.get(code_ev, code_ev)
+                    zr = "Ano" if ev.get("zruseno") else ""
+                    zid = ev.get("znackaId", {})
+                    rel = (f"{zid.get('cisloSenatu', '')} {zid.get('druhVeci', '')} "
+                           f"{zid.get('bcVec', '')}/{zid.get('rocnik', '')} "
+                           f"{zid.get('organizace', '')}").strip()
+                    print(f"{ev.get('datum', '')};{label};{zr};{rel};{data.get('organizace', '')}")
+            else:
+                print(format_case_summary(data))
+    except Exception as e:
+        print(f"Chyba: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

infosoud-0.1.0/infosoud/client.py

@@ -0,0 +1,329 @@
+"""InfoSoud API client — Czech court case tracking (infosoud.gov.cz).
+
+Public REST API of the Czech Ministry of Justice for looking up
+court case status, events timeline, and scheduled hearings.
+
+No authentication required. Be polite — use reasonable delays between requests.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import re
+import time
+import unicodedata
+from dataclasses import dataclass
+
+import requests
+
+logger = logging.getLogger(__name__)
+
+BASE_URL = "https://infosoud.gov.cz/api/v1"
+
+# Universal regex — tolerant to any whitespace/separator combo
+_SPZN_UNIVERSAL = re.compile(
+    r"(\d+)\s*([A-Za-z]+)\s*(\d+)\s*[/_]\s*(\d{4})"
+    r"(?:\s+([A-Z][A-Z0-9]{4,9}))?$"
+)
+
+
+@dataclass(frozen=True)
+class SpisZn:
+    """Parsed spisová značka (Czech court case file number)."""
+    cislo_senatu: int
+    druh_veci: str
+    bc_vec: int
+    rocnik: int
+    court_code: str | None = None
+
+    def to_api_params(self, court_code: str | None = None) -> dict:
+        """Convert to InfoSoud API request body."""
+        code = court_code or self.court_code
+        params = {
+            "cisloSenatu": str(self.cislo_senatu),
+            "druhVeci": self.druh_veci,
+            "bcVec": str(self.bc_vec),
+            "rocnik": str(self.rocnik),
+        }
+        if code:
+            code = resolve_court_code(code)
+            ct = classify_court_code(code)
+            if ct == "NS":
+                params["typOrganizace"] = "NEJVYSSI"
+            elif ct in ("KS", "VS", "MS"):
+                params["druhOrganizace"] = code
+            else:
+                params["okresniSoud"] = code
+        return params
+
+    def canonical(self) -> str:
+        """Canonical form: '1 T 64/2024'."""
+        return f"{self.cislo_senatu} {self.druh_veci} {self.bc_vec}/{self.rocnik}"
+
+    def compact(self) -> str:
+        """Compact form: '1T64_2024'."""
+        return f"{self.cislo_senatu}{self.druh_veci}{self.bc_vec}_{self.rocnik}"
+
+    def __str__(self) -> str:
+        s = self.canonical()
+        if self.court_code:
+            s += f" {self.court_code}"
+        return s
+
+
+def parse_spis_zn(text: str) -> SpisZn:
+    """Parse spisová značka in any common format.
+
+    Extremely tolerant — whitespace and separators are ignored.
+    All of these parse identically:
+        "1 T 64/2024"       "1T64/2024"        "1T 64/2024"
+        "1 T64/2024"        "1T64_2024"        "1 T 64 / 2024"
+        "43T191_2024"       "43 T 191/2024 OSPHA09"
+        "11 C 233/2022"     "2 To 29/2023"     "6To436/2025"
+    """
+    text = text.strip()
+    m = _SPZN_UNIVERSAL.match(text)
+    if m:
+        return SpisZn(
+            cislo_senatu=int(m.group(1)),
+            druh_veci=m.group(2),
+            bc_vec=int(m.group(3)),
+            rocnik=int(m.group(4)),
+            court_code=m.group(5) if m.group(5) else None,
+        )
+    raise ValueError(f"Cannot parse spisová značka: {text!r}")
+
+
+# --- Court codes ---
+
+KS_CODES = {
+    "KSJIMBM": "Krajský soud Brno",
+    "KSJICCB": "Krajský soud České Budějovice",
+    "KSVYCHK": "Krajský soud Hradec Králové",
+    "KSSEMOS": "Krajský soud Ostrava",
+    "KSZPCPM": "Krajský soud Plzeň",
+    "KSSTCAB": "Krajský soud Praha",
+    "KSSCEUL": "Krajský soud Ústí nad Labem",
+    "MSPHAAB": "Městský soud Praha",
+    "VSSEMOL": "Vrchní soud Olomouc",
+    "VSPHAAB": "Vrchní soud Praha",
+}
+
+EXTRA_COURTS = {
+    "KSVYCPA": "Krajský soud Hradec Králové — pobočka Pardubice",
+    "KSSEMOC": "Krajský soud Ostrava — pobočka Olomouc",
+    "KSSCELB": "Krajský soud Ústí nad Labem — pobočka Liberec",
+    "VSSTCAB": "Vrchní soud Praha",
+    "VSSEMOC": "Vrchní soud Olomouc",
+    "OSSEMHA": "Okresní soud Karviná — pobočka Havířov",
+    "OSSEMKR": "Okresní soud Bruntál — pobočka Krnov",
+    "OSSEMVM": "Okresní soud Vsetín — pobočka Valašské Meziříčí",
+}
+
+COURT_CODE_ALIASES = {
+    "KSSEMOC": "KSSEMOS",
+    "VSSTCAB": "VSPHAAB",
+}
+
+PRAGUE_DISTRICTS = [f"OSPHA{i:02d}" for i in range(1, 11)]
+
+EVENT_LABELS = {
+    "ZAHAJ_RIZ": "Zahájení řízení",
+    "NAR_JED": "Nařízení jednání",
+    "ZRUS_JED": "Zrušení jednání",
+    "VYD_ROZH": "Vydání rozhodnutí",
+    "ODES_SPIS": "Odeslání spisu",
+    "VRAC_SPIS": "Vrácení spisu",
+    "POD_OP_PR": "Podání opravného prostředku",
+    "VYR_OP_PR": "Vyřízení opravného prostředku",
+    "ODVOLANI": "Řízení o odvolání",
+    "DOVOL_RIZ": "Řízení o dovolání",
+    "NAD_RIZENI": "Řízení u nadřízeného soudu",
+    "ST_VEC_ODS": "Skončení věci",
+    "ST_VEC_OBZ": "Obživnutí věci",
+    "ST_VEC_PRE": "Přerušení řízení",
+    "ST_VEC_UPR": "Ukončení přerušení",
+    "ST_VEC_VYR": "Vyřízení věci",
+    "ST_VEC_PUK": "Pravomocné ukončení",
+    "SPIS_K_SC": "Spis odeslán soudci",
+    "SPIS_K_SO": "Spis odeslán soudnímu komisaři",
+    "SPIS_OD_SC": "Soudce předal spis",
+    "SPIS_OD_SO": "Soudní komisař předal spis",
+    "PREVD_SPIS": "Převedeno pod jinou sp. zn.",
+    "PR_VEC_NS": "Přerušení věci",
+    "VR_SP_NS": "Vrácení spisu odvolacímu soudu",
+}
+
+
+def classify_court_code(code: str) -> str:
+    """Classify court code: NS, KS, VS, MS, or OS."""
+    if not code:
+        return "OS"
+    upper = code.upper()
+    for prefix in ("NS", "VS", "MS", "KS"):
+        if upper.startswith(prefix):
+            return prefix
+    return "OS"
+
+
+def resolve_court_code(code: str) -> str:
+    """Resolve alternative court codes to InfoSoud codes."""
+    return COURT_CODE_ALIASES.get(code.upper(), code)
+
+
+def strip_diacritics(text: str) -> str:
+    """Remove Czech diacritics for fuzzy matching."""
+    return "".join(
+        c for c in unicodedata.normalize("NFD", text)
+        if unicodedata.category(c) != "Mn"
+    )
+
+
+class InfoSoudClient:
+    """Client for the InfoSoud REST API.
+
+    Usage::
+
+        client = InfoSoudClient()
+        case = client.search_case("1 T 64/2024", "OSSCEDC")
+        hearings = client.search_hearings("1 T 64/2024", "OSSCEDC")
+        courts = client.build_court_map()
+    """
+
+    def __init__(self, delay: float = 0.5, timeout: int = 15,
+                 base_url: str = BASE_URL):
+        self.base_url = base_url
+        self.delay = delay
+        self.timeout = timeout
+        self.session = requests.Session()
+        self.session.headers.update({
+            "User-Agent": "infosoud-oss/0.1 (https://github.com/pravnikovo/infosoud)",
+            "Accept": "application/json",
+            "Content-Type": "application/json",
+        })
+        self._last_request = 0.0
+
+    def _throttle(self) -> None:
+        elapsed = time.monotonic() - self._last_request
+        if elapsed < self.delay:
+            time.sleep(self.delay - elapsed)
+
+    def _get(self, path: str, params: dict | None = None) -> dict | list:
+        self._throttle()
+        url = f"{self.base_url}{path}"
+        t0 = time.monotonic()
+        resp = self.session.get(url, params=params, timeout=self.timeout)
+        self._last_request = time.monotonic()
+        elapsed_ms = int((self._last_request - t0) * 1000)
+        logger.debug("GET %s → %d (%dms)", path, resp.status_code, elapsed_ms)
+        resp.raise_for_status()
+        return resp.json()
+
+    def _post(self, path: str, body: dict) -> dict:
+        self._throttle()
+        url = f"{self.base_url}{path}"
+        t0 = time.monotonic()
+        resp = self.session.post(url, json=body, timeout=self.timeout)
+        self._last_request = time.monotonic()
+        elapsed_ms = int((self._last_request - t0) * 1000)
+        logger.debug("POST %s → %d (%dms)", path, resp.status_code, elapsed_ms)
+        resp.raise_for_status()
+        return resp.json()
+
+    def search_case(self, spis_zn: str | SpisZn,
+                    court_code: str | None = None) -> dict:
+        """Search case by spisová značka. Returns events timeline."""
+        if isinstance(spis_zn, str):
+            spis_zn = parse_spis_zn(spis_zn)
+        code = court_code or spis_zn.court_code
+
+        if code and code.upper() in ("OSPHA", "OSPHA0"):
+            return self._search_prague(spis_zn, "/rizeni/vyhledej")
+
+        return self._post("/rizeni/vyhledej", spis_zn.to_api_params(court_code))
+
+    def search_hearings(self, spis_zn: str | SpisZn,
+                        court_code: str | None = None) -> dict:
+        """Search hearings for a case."""
+        if isinstance(spis_zn, str):
+            spis_zn = parse_spis_zn(spis_zn)
+        code = court_code or spis_zn.court_code
+
+        if code and code.upper() in ("OSPHA", "OSPHA0"):
+            return self._search_prague(spis_zn, "/jednani/vyhledej",
+                                       extra={"typHledani": "SPZN"})
+
+        params = spis_zn.to_api_params(court_code)
+        params["typHledani"] = "SPZN"
+        return self._post("/jednani/vyhledej", params)
+
+    def get_event_detail(self, spis_zn: str | SpisZn,
+                         court_code: str | None,
+                         event_type: str, event_order: int) -> dict:
+        """Fetch detail for a single event (room, time, result)."""
+        if isinstance(spis_zn, str):
+            spis_zn = parse_spis_zn(spis_zn)
+        params = spis_zn.to_api_params(court_code)
+        params["druhUdalosti"] = event_type
+        params["poradiUdalosti"] = str(event_order)
+        return self._post("/udalost/vyhledej", params)
+
+    def get_courts(self) -> list[dict]:
+        """Get list of krajské/vrchní soudy."""
+        return self._get("/organizace/lov")
+
+    def get_district_courts(self, ks_code: str | None = None) -> list[dict]:
+        """Get list of okresní soudy, optionally filtered by KS."""
+        params = {"kod": ks_code} if ks_code else None
+        return self._get("/organizace/podrizene/lov", params=params)
+
+    def build_court_map(self) -> dict[str, str]:
+        """Fetch and build complete court code → name mapping."""
+        result = dict(EXTRA_COURTS)
+        for court in self.get_courts():
+            result[court["kod"]] = court["nazev"]
+        for court in self.get_district_courts():
+            result[court["kod"]] = court["nazev"]
+        return result
+
+    def resolve_court_name(self, name: str,
+                           court_map: dict | None = None) -> str | None:
+        """Fuzzy-match a court name (diacritics-insensitive) to a court code."""
+        if court_map is None:
+            court_map = self.build_court_map()
+        name_lower = strip_diacritics(name.lower())
+        for prefix in ("os ", "okresni soud ", "krajsky soud ", "ks ", "ms "):
+            if name_lower.startswith(prefix):
+                name_lower = name_lower[len(prefix):]
+                break
+        best_code, best_score = None, 0
+        for code, full_name in court_map.items():
+            full_lower = strip_diacritics(full_name.lower())
+            if name_lower in full_lower:
+                score = len(name_lower) / len(full_lower)
+                if score > best_score:
+                    best_score = score
+                    best_code = code
+        return best_code
+
+    def _search_prague(self, spis_zn: SpisZn, path: str,
+                       extra: dict | None = None) -> dict:
+        """Try all Prague districts for an ambiguous OSPHA code."""
+        for district in PRAGUE_DISTRICTS:
+            params = spis_zn.to_api_params(district)
+            if extra:
+                params.update(extra)
+            try:
+                result = self._post(path, params)
+                if result.get("udalosti") or result.get("stav"):
+                    logger.info("Resolved OSPHA → %s for %s",
+                                district, spis_zn.canonical())
+                    return result
+            except requests.HTTPError as e:
+                if e.response is not None and e.response.status_code == 400:
+                    continue
+                raise
+        raise ValueError(
+            f"Cannot find {spis_zn.canonical()} in any Prague district court"
+        )

infosoud-0.1.0/infosoud.egg-info/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: infosoud
+Version: 0.1.0
+Summary: Czech court case lookup tool (infosoud.gov.cz)
+Author: pravnikovo.info
+License-Expression: MIT
+Project-URL: Homepage, https://infosoud.pravnikovo.info
+Project-URL: Repository, https://github.com/pravnikovo/infosoud
+Keywords: czech,court,justice,infosoud,právní,soud
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business
+Classifier: Natural Language :: Czech
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.20
+Provides-Extra: web
+Requires-Dist: flask>=2.0; extra == "web"
+Dynamic: license-file
+
+# InfoSoud
+
+Neoficiální klient pro [InfoSoud](https://infosoud.gov.cz) — vyhledávání v soudních řízeních České republiky.
+
+Umožňuje vyhledat průběh soudního řízení, nařízená jednání a události podle spisové značky. Data pocházejí z veřejného API Ministerstva spravedlnosti ČR.
+
+**[infosoud.pravnikovo.info](https://infosoud.pravnikovo.info)** — webové rozhraní
+
+## Instalace
+
+```bash
+pip install infosoud
+```
+
+## Použití
+
+### Příkazový řádek
+
+```bash
+# Vyhledat řízení
+infosoud "1 T 64/2024" OSSCEDC
+infosoud "1T64_2024 OSSCEDC"          # kompaktní formát
+infosoud "4 T 21/2025 melnik"         # název soudu místo kódu
+
+# Zobrazit jednání
+infosoud --hearings "1 T 64/2024" OSSCEDC
+
+# JSON výstup
+infosoud --json "1 T 64/2024" OSSCEDC
+
+# CSV výstup (události)
+infosoud --csv "1 T 64/2024" OSSCEDC
+
+# Vypsat soudy
+infosoud --courts
+infosoud --courts --csv
+```
+
+### Python
+
+```python
+from infosoud import InfoSoudClient, parse_spis_zn
+
+client = InfoSoudClient()
+
+# Vyhledat řízení
+case = client.search_case("1 T 64/2024", "OSSCEDC")
+print(case["stav"])          # "nevyřízená věc"
+print(case["organizace"])    # "Okresní soud Děčín"
+
+for event in case["udalosti"]:
+    print(f"{event['datum']}  {event['udalost']}")
+
+# Vyhledat jednání
+hearings = client.search_hearings("1 T 64/2024", "OSSCEDC")
+for h in hearings["udalosti"]:
+    print(f"{h['datum']} {h['cas']}  {h['druhJednani']}  {h['resitel']}")
+
+# Detail události (čas, jednací síň)
+detail = client.get_event_detail("1 T 64/2024", "OSSCEDC", "NAR_JED", 48)
+for attr in detail["atributy"]:
+    print(f"{attr['typ']}: {attr['hodnota']}")
+
+# Spisová značka — tolerantní parser
+spis = parse_spis_zn("1T64_2024")
+print(spis.canonical())  # "1 T 64/2024"
+print(spis.compact())    # "1T64_2024"
+
+# Fuzzy vyhledání soudu
+code = client.resolve_court_name("melnik")  # → "OSSTCME"
+code = client.resolve_court_name("praha 9") # → "OSPHA09"
+
+# Seznam soudů
+courts = client.build_court_map()  # {kód: název} pro všech 104 soudů
+```
+
+### Formáty spisové značky
+
+Parser je maximálně tolerantní — všechny tyto formáty jsou ekvivalentní:
+
+```
+1 T 64/2024       1T64/2024       1T 64/2024
+1 T64/2024        1T64_2024       1 T 64 / 2024
+```
+
+Kód soudu lze přidat za sp. zn.: `1T64_2024 OSSCEDC`
+
+Místo kódu soudu lze zadat název: `4 T 21/2025 melnik` (bez diakritiky)
+
+## API endpointy
+
+| Endpoint | Metoda | Popis |
+|----------|--------|-------|
+| `/api/v1/rizeni/vyhledej` | POST | Vyhledání řízení |
+| `/api/v1/jednani/vyhledej` | POST | Vyhledání jednání |
+| `/api/v1/udalost/vyhledej` | POST | Detail události |
+| `/api/v1/organizace/lov` | GET | Seznam krajských/vrchních soudů |
+| `/api/v1/organizace/podrizene/lov` | GET | Seznam okresních soudů |
+
+Base URL: `https://infosoud.gov.cz/api/v1`
+
+## Kódy soudů
+
+Kompletní seznam 104 soudů (96 z API + 8 poboček):
+
+```bash
+infosoud --courts
+```
+
+Příklady: `OSSCEDC` (OS Děčín), `OSPHA09` (OS Praha 9), `KSJIMBM` (KS Brno), `MSPHAAB` (MS Praha)
+
+## Webové rozhraní
+
+```bash
+pip install infosoud[web]
+python -m infosoud.web
+```
+
+Otevře webserver na `http://localhost:8060` s vyhledávacím formulářem, timeline událostí, ICS exportem jednání a CSV exportem.
+
+## Licence
+
+MIT — viz [LICENSE](LICENSE)
+
+---
+
+*Neoficiální nástroj. Data pocházejí z [infosoud.gov.cz](https://infosoud.gov.cz). Projekt [pravnikovo.info](https://pravnikovo.info) — open source nástroje pro právníky.*

infosoud-0.1.0/infosoud.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+infosoud/__init__.py
+infosoud/__main__.py
+infosoud/client.py
+infosoud.egg-info/PKG-INFO
+infosoud.egg-info/SOURCES.txt
+infosoud.egg-info/dependency_links.txt
+infosoud.egg-info/entry_points.txt
+infosoud.egg-info/requires.txt
+infosoud.egg-info/top_level.txt

infosoud-0.1.0/infosoud.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

infosoud-0.1.0/infosoud.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+infosoud = infosoud.__main__:main

infosoud-0.1.0/infosoud.egg-info/requires.txt

@@ -0,0 +1,4 @@
+requests>=2.20
+
+[web]
+flask>=2.0

infosoud-0.1.0/infosoud.egg-info/top_level.txt

@@ -0,0 +1 @@
+infosoud

infosoud-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "infosoud"
+version = "0.1.0"
+description = "Czech court case lookup tool (infosoud.gov.cz)"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [{name = "pravnikovo.info"}]
+keywords = ["czech", "court", "justice", "infosoud", "právní", "soud"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "Topic :: Office/Business",
+    "Natural Language :: Czech",
+]
+dependencies = ["requests>=2.20"]
+
+[project.optional-dependencies]
+web = ["flask>=2.0"]
+
+[project.scripts]
+infosoud = "infosoud.__main__:main"
+
+[project.urls]
+Homepage = "https://infosoud.pravnikovo.info"
+Repository = "https://github.com/pravnikovo/infosoud"

infosoud-0.1.0/setup.cfg

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