opencaselaw-cli 0.2.0__tar.gz

opencaselaw_cli-0.2.0/LICENSE

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

opencaselaw_cli-0.2.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: opencaselaw-cli
+Version: 0.2.0
+Summary: Composable, read-only research client for OpenCaseLaw
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# OpenCaseLaw research CLI
+
+Dependency-free Python 3.10+ client for the public, read-only research API.
+Install from the repository with `pipx install ./clients/python` (or
+`uv tool install ./clients/python`); both create the isolated environment
+that current Python installations require. Without them, use a virtual
+environment: `python3 -m venv .venv && .venv/bin/pip install ./clients/python`.
+This package does not install scraper/server dependencies or a local corpus.
+
+```sh
+ocl --help
+ocl citations resolve 'BGE 136 III 513' '4A_747/2012'          # do these exist, and which decisions are they?
+ocl bundle create 'Rachekündigung Art. 336 OR' --max-results 10 --passage 2 --law OR:336 --out evidence
+ocl decisions search 'Rachekündigung' --max-results 5 --format jsonl | ocl decisions get --stdin --format jsonl > decisions.jsonl
+ocl decisions passage bge_BGE_136_III_513 2.3
+```
+
+A bundle folder holds the selected decisions (JSON and plain text), the named
+Erwägungen and statute articles, a plain-language `INDEX.md`, and a
+`manifest.json` with every request, timestamp, source link and file hash.
+
+See the repository's [research CLI guide](https://github.com/jonashertner/opencaselaw/blob/main/docs/research-cli.md)
+for provenance, batch inputs, pagination, partial failures and repeatable workflows.
+Commands contact `https://mcp.opencaselaw.ch` by default; `--base-url` accepts an
+alternative HTTP(S) origin. Results come from a changing hosted corpus, not an
+offline snapshot. Preserve returned source evidence and pagination metadata.
+
+Exit codes: 0 success (including a bounded selection); 2 invalid input; 3 API
+or transport failure; 4 partial or unresolved result; 130 interruption.
+At a terminal the output is readable text (`--color never` or `NO_COLOR` for
+plain text); piped, or with `--format json|jsonl`, it is JSON on stdout;
+`table`, `csv` and `md` are for documents. Defaults can live in
+`~/.config/ocl/config` or `OCL_*` variables; `ocl completion zsh|bash|fish`
+prints a completion script. Diagnostics go to stderr. The client retries at most
+twice by default, spaces requests by at least 200 ms, and respects Retry-After
+up to 30 seconds; longer server delays fail without an early retry.

opencaselaw_cli-0.2.0/README.md

@@ -0,0 +1,36 @@
+# OpenCaseLaw research CLI
+
+Dependency-free Python 3.10+ client for the public, read-only research API.
+Install from the repository with `pipx install ./clients/python` (or
+`uv tool install ./clients/python`); both create the isolated environment
+that current Python installations require. Without them, use a virtual
+environment: `python3 -m venv .venv && .venv/bin/pip install ./clients/python`.
+This package does not install scraper/server dependencies or a local corpus.
+
+```sh
+ocl --help
+ocl citations resolve 'BGE 136 III 513' '4A_747/2012'          # do these exist, and which decisions are they?
+ocl bundle create 'Rachekündigung Art. 336 OR' --max-results 10 --passage 2 --law OR:336 --out evidence
+ocl decisions search 'Rachekündigung' --max-results 5 --format jsonl | ocl decisions get --stdin --format jsonl > decisions.jsonl
+ocl decisions passage bge_BGE_136_III_513 2.3
+```
+
+A bundle folder holds the selected decisions (JSON and plain text), the named
+Erwägungen and statute articles, a plain-language `INDEX.md`, and a
+`manifest.json` with every request, timestamp, source link and file hash.
+
+See the repository's [research CLI guide](https://github.com/jonashertner/opencaselaw/blob/main/docs/research-cli.md)
+for provenance, batch inputs, pagination, partial failures and repeatable workflows.
+Commands contact `https://mcp.opencaselaw.ch` by default; `--base-url` accepts an
+alternative HTTP(S) origin. Results come from a changing hosted corpus, not an
+offline snapshot. Preserve returned source evidence and pagination metadata.
+
+Exit codes: 0 success (including a bounded selection); 2 invalid input; 3 API
+or transport failure; 4 partial or unresolved result; 130 interruption.
+At a terminal the output is readable text (`--color never` or `NO_COLOR` for
+plain text); piped, or with `--format json|jsonl`, it is JSON on stdout;
+`table`, `csv` and `md` are for documents. Defaults can live in
+`~/.config/ocl/config` or `OCL_*` variables; `ocl completion zsh|bash|fish`
+prints a completion script. Diagnostics go to stderr. The client retries at most
+twice by default, spaces requests by at least 200 ms, and respects Retry-After
+up to 30 seconds; longer server delays fail without an early retry.

opencaselaw_cli-0.2.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "opencaselaw-cli"
+dynamic = ["version"]
+description = "Composable, read-only research client for OpenCaseLaw"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+dependencies = []
+
+[project.scripts]
+ocl = "opencaselaw_cli.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = {attr = "opencaselaw_cli._version.__version__"}
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

opencaselaw_cli-0.2.0/setup.cfg

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

opencaselaw_cli-0.2.0/src/opencaselaw_cli/__init__.py

@@ -0,0 +1,6 @@
+"""Dependency-free public research API client."""
+
+from ._version import __version__
+from .client import APIError, Client
+
+__all__ = ["APIError", "Client", "__version__"]

opencaselaw_cli-0.2.0/src/opencaselaw_cli/__main__.py

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

opencaselaw_cli-0.2.0/src/opencaselaw_cli/_version.py

@@ -0,0 +1,3 @@
+"""Single source of the client version (read by the package, the CLI and the User-Agent)."""
+
+__version__ = "0.2.0"