langchain-polias 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,20 @@
1
+ # Publishes to PyPI via Trusted Publishing when a version tag (v*) is pushed. No token needed.
2
+ name: Publish
3
+ on:
4
+ push:
5
+ tags: ['v*']
6
+ jobs:
7
+ publish:
8
+ runs-on: ubuntu-latest
9
+ environment: pypi
10
+ permissions:
11
+ id-token: write
12
+ contents: read
13
+ steps:
14
+ - uses: actions/checkout@v4
15
+ - uses: actions/setup-python@v5
16
+ with:
17
+ python-version: '3.12'
18
+ - run: python -m pip install build
19
+ - run: python -m build
20
+ - uses: pypa/gh-action-pypi-publish@release/v1
@@ -0,0 +1,7 @@
1
+ __pycache__/
2
+ *.egg-info/
3
+ dist/
4
+ build/
5
+ .venv/
6
+ .pytest_cache/
7
+ doku-pr/
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Polias
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,78 @@
1
+ Metadata-Version: 2.5
2
+ Name: langchain-polias
3
+ Version: 0.1.0
4
+ Summary: An integration package connecting Polias search and LangChain
5
+ Project-URL: Homepage, https://api.polias.eu/
6
+ Project-URL: Source Code, https://github.com/Polias-Team/langchain-polias
7
+ Author-email: Polias <hallo@polias.eu>
8
+ License-Expression: MIT
9
+ License-File: LICENSE
10
+ Keywords: langchain,legal,polias,search,web search
11
+ Requires-Python: <4.0,>=3.10
12
+ Requires-Dist: langchain-core<2.0,>=0.3.70
13
+ Requires-Dist: requests>=2.31.0
14
+ Description-Content-Type: text/markdown
15
+
16
+ # langchain-polias
17
+
18
+ This package connects LangChain to [Polias](https://api.polias.eu/), a search engine with its own index, hosted in the EU.
19
+ Agents can use it to search the web, news, official sources and law.
20
+
21
+ ## Installation
22
+
23
+ ```bash
24
+ pip install -U langchain-polias
25
+ ```
26
+
27
+ You need a Polias API key. Create an account at [api.polias.eu/account](https://api.polias.eu/account), as a company or as a
28
+ private person (private accounts: residents of Germany, Austria or Switzerland, 18 or older, non-commercial use only).
29
+ Each month, 1,000 searches are free for companies and 100 for private persons. More is available as packages, see
30
+ [pricing](https://api.polias.eu/pricing).
31
+
32
+ ```bash
33
+ export POLIAS_API_KEY="pol_..."
34
+ ```
35
+
36
+ ## Tools
37
+
38
+ ```python
39
+ from langchain_polias import PoliasAISearch, PoliasLegalSearch, PoliasSearch
40
+
41
+ search = PoliasSearch()
42
+ search.invoke({"query": "Kündigung Eigenbedarf", "areas": ["web", "legal"], "count": 5})
43
+ ```
44
+
45
+ - `PoliasSearch` returns results with title, URL and a short snippet. The areas are `web`, `news` (last 30 days),
46
+ `legal` (court decisions and legislation) and `official` (websites of public authorities in Germany, Austria,
47
+ Switzerland and the EU). The optional `town` field focuses local results, e.g. `"Köln"`.
48
+ - `PoliasAISearch` returns results for AI answers. Each result carries licence details and, where the licence allows,
49
+ a longer excerpt. For `legal` results, the full text is included where the licence allows it.
50
+ - `PoliasLegalSearch` searches court decisions and legislation from the EU and European countries. It returns court,
51
+ case number, date, ECLI and source. Please show the source notice (`notice`) with the result.
52
+
53
+ With an agent:
54
+
55
+ ```python
56
+ from langchain.agents import create_agent
57
+
58
+ agent = create_agent(model, tools=[PoliasSearch(), PoliasLegalSearch()]) # any chat model with tool calling
59
+ ```
60
+
61
+ ## Retriever
62
+
63
+ ```python
64
+ from langchain_polias import PoliasRetriever
65
+
66
+ retriever = PoliasRetriever(k=3, areas=["web", "legal"])
67
+ docs = retriever.invoke("Mietminderung Schimmel")
68
+ ```
69
+
70
+ ## Options
71
+
72
+ All classes take these options:
73
+ - `lang`: `"de"` (the default) or `"en"`. English focuses on technical topics such as developer documentation, software
74
+ and IT.
75
+ - `country`: `"de"`, `"at"` or `"ch"`, to prefer results from that country.
76
+ - `api_key`: use this instead of the environment variable.
77
+
78
+ Documentation: [api.polias.eu](https://api.polias.eu/) · Questions: hallo@polias.eu
@@ -0,0 +1,63 @@
1
+ # langchain-polias
2
+
3
+ This package connects LangChain to [Polias](https://api.polias.eu/), a search engine with its own index, hosted in the EU.
4
+ Agents can use it to search the web, news, official sources and law.
5
+
6
+ ## Installation
7
+
8
+ ```bash
9
+ pip install -U langchain-polias
10
+ ```
11
+
12
+ You need a Polias API key. Create an account at [api.polias.eu/account](https://api.polias.eu/account), as a company or as a
13
+ private person (private accounts: residents of Germany, Austria or Switzerland, 18 or older, non-commercial use only).
14
+ Each month, 1,000 searches are free for companies and 100 for private persons. More is available as packages, see
15
+ [pricing](https://api.polias.eu/pricing).
16
+
17
+ ```bash
18
+ export POLIAS_API_KEY="pol_..."
19
+ ```
20
+
21
+ ## Tools
22
+
23
+ ```python
24
+ from langchain_polias import PoliasAISearch, PoliasLegalSearch, PoliasSearch
25
+
26
+ search = PoliasSearch()
27
+ search.invoke({"query": "Kündigung Eigenbedarf", "areas": ["web", "legal"], "count": 5})
28
+ ```
29
+
30
+ - `PoliasSearch` returns results with title, URL and a short snippet. The areas are `web`, `news` (last 30 days),
31
+ `legal` (court decisions and legislation) and `official` (websites of public authorities in Germany, Austria,
32
+ Switzerland and the EU). The optional `town` field focuses local results, e.g. `"Köln"`.
33
+ - `PoliasAISearch` returns results for AI answers. Each result carries licence details and, where the licence allows,
34
+ a longer excerpt. For `legal` results, the full text is included where the licence allows it.
35
+ - `PoliasLegalSearch` searches court decisions and legislation from the EU and European countries. It returns court,
36
+ case number, date, ECLI and source. Please show the source notice (`notice`) with the result.
37
+
38
+ With an agent:
39
+
40
+ ```python
41
+ from langchain.agents import create_agent
42
+
43
+ agent = create_agent(model, tools=[PoliasSearch(), PoliasLegalSearch()]) # any chat model with tool calling
44
+ ```
45
+
46
+ ## Retriever
47
+
48
+ ```python
49
+ from langchain_polias import PoliasRetriever
50
+
51
+ retriever = PoliasRetriever(k=3, areas=["web", "legal"])
52
+ docs = retriever.invoke("Mietminderung Schimmel")
53
+ ```
54
+
55
+ ## Options
56
+
57
+ All classes take these options:
58
+ - `lang`: `"de"` (the default) or `"en"`. English focuses on technical topics such as developer documentation, software
59
+ and IT.
60
+ - `country`: `"de"`, `"at"` or `"ch"`, to prefer results from that country.
61
+ - `api_key`: use this instead of the environment variable.
62
+
63
+ Documentation: [api.polias.eu](https://api.polias.eu/) · Questions: hallo@polias.eu
@@ -0,0 +1,17 @@
1
+ from importlib import metadata
2
+
3
+ from langchain_polias.retrievers import PoliasRetriever
4
+ from langchain_polias.tools import PoliasAISearch, PoliasLegalSearch, PoliasSearch
5
+
6
+ try:
7
+ __version__ = metadata.version(__package__)
8
+ except metadata.PackageNotFoundError:
9
+ __version__ = ""
10
+
11
+ __all__ = [
12
+ "PoliasAISearch",
13
+ "PoliasLegalSearch",
14
+ "PoliasRetriever",
15
+ "PoliasSearch",
16
+ "__version__",
17
+ ]
@@ -0,0 +1,42 @@
1
+ """Small HTTP client for the Polias API."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import os
6
+ from typing import Any, Dict, Optional
7
+
8
+ import requests
9
+
10
+ DEFAULT_BASE_URL = "https://api.polias.eu/v1"
11
+
12
+
13
+ def resolve_api_key(api_key: Optional[str]) -> str:
14
+ key = api_key or os.environ.get("POLIAS_API_KEY")
15
+ if not key:
16
+ raise ValueError(
17
+ "A Polias API key is required: pass api_key or set POLIAS_API_KEY."
18
+ )
19
+ return key
20
+
21
+
22
+ def get_json(
23
+ path: str,
24
+ params: Dict[str, Any],
25
+ api_key: str,
26
+ base_url: str = DEFAULT_BASE_URL,
27
+ timeout: float = 20.0,
28
+ ) -> Dict[str, Any]:
29
+ params = {k: v for k, v in params.items() if v not in (None, "", [])}
30
+ response = requests.get(
31
+ f"{base_url.rstrip('/')}{path}",
32
+ params=params,
33
+ headers={"Authorization": f"Bearer {api_key}", "Accept": "application/json"},
34
+ timeout=timeout,
35
+ )
36
+ if response.status_code >= 400:
37
+ try:
38
+ message = response.json().get("error", response.text)
39
+ except ValueError:
40
+ message = response.text
41
+ raise ValueError(f"Polias API error {response.status_code}: {message}")
42
+ return response.json()
File without changes
@@ -0,0 +1,101 @@
1
+ """Polias retriever."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Any, Dict, List, Literal, Optional
6
+
7
+ from langchain_core.callbacks import CallbackManagerForRetrieverRun
8
+ from langchain_core.documents import Document
9
+ from langchain_core.retrievers import BaseRetriever
10
+ from pydantic import SecretStr, model_validator
11
+
12
+ from langchain_polias._client import DEFAULT_BASE_URL, get_json, resolve_api_key
13
+
14
+
15
+ class PoliasRetriever(BaseRetriever):
16
+ """Retrieve documents from Polias for AI answers.
17
+
18
+ Each document carries licence details; where the licence allows, the text is a
19
+ longer excerpt, and for legal results the full text.
20
+
21
+ Setup:
22
+ .. code-block:: bash
23
+
24
+ pip install -U langchain-polias
25
+ export POLIAS_API_KEY="pol_..."
26
+
27
+ Instantiate:
28
+ .. code-block:: python
29
+
30
+ from langchain_polias import PoliasRetriever
31
+
32
+ retriever = PoliasRetriever(k=3, areas=["web", "legal"])
33
+
34
+ Usage:
35
+ .. code-block:: python
36
+
37
+ docs = retriever.invoke("Mietminderung Schimmel")
38
+ """
39
+
40
+ api_key: Optional[SecretStr] = None
41
+ """Polias API key (starts with "pol_"). Falls back to POLIAS_API_KEY."""
42
+ k: int = 3
43
+ """Number of documents to return, 1 to 10."""
44
+ areas: Optional[List[Literal["web", "news", "legal"]]] = None
45
+ """Areas: "web", "news" and "legal". Default: web and news."""
46
+ lang: Literal["de", "en"] = "de"
47
+ country: Optional[str] = None
48
+ base_url: str = DEFAULT_BASE_URL
49
+
50
+ @model_validator(mode="before")
51
+ @classmethod
52
+ def _validate_key(cls, values: Dict[str, Any]) -> Dict[str, Any]:
53
+ key = values.get("api_key")
54
+ if isinstance(key, SecretStr):
55
+ key = key.get_secret_value()
56
+ values["api_key"] = SecretStr(resolve_api_key(key))
57
+ return values
58
+
59
+ def _get_relevant_documents(
60
+ self,
61
+ query: str,
62
+ *,
63
+ run_manager: CallbackManagerForRetrieverRun,
64
+ k: Optional[int] = None,
65
+ ) -> List[Document]:
66
+ assert self.api_key is not None
67
+ k = k or self.k
68
+ data = get_json(
69
+ "/ki",
70
+ {
71
+ "q": query,
72
+ "scope": ",".join(self.areas or []),
73
+ "count": k,
74
+ "lang": self.lang,
75
+ "land": self.country,
76
+ },
77
+ self.api_key.get_secret_value(),
78
+ self.base_url,
79
+ )
80
+ docs: List[Document] = []
81
+ for area in ("web", "news", "official", "legal"):
82
+ for r in data.get(area) or []:
83
+ metadata = {
84
+ "area": area,
85
+ "title": r.get("title") or r.get("titel"),
86
+ "url": r.get("url"),
87
+ "date": r.get("as_of") or r.get("date"),
88
+ "license": r.get("license") or r.get("lizenz"),
89
+ "notice": r.get("notice") or r.get("hinweis"),
90
+ "court": r.get("court"),
91
+ "case_number": r.get("case_number"),
92
+ "ecli": r.get("ecli"),
93
+ "full_text": bool(r.get("volltext")),
94
+ }
95
+ docs.append(
96
+ Document(
97
+ page_content=r.get("volltext") or r.get("excerpt") or r.get("snippet") or "",
98
+ metadata={key: val for key, val in metadata.items() if val not in (None, "")},
99
+ )
100
+ )
101
+ return docs[:k]
@@ -0,0 +1,249 @@
1
+ """Polias tools."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Any, Dict, List, Literal, Optional, Type
6
+
7
+ from langchain_core.callbacks import CallbackManagerForToolRun
8
+ from langchain_core.tools import BaseTool
9
+ from pydantic import BaseModel, Field, SecretStr, model_validator
10
+
11
+ from langchain_polias._client import DEFAULT_BASE_URL, get_json, resolve_api_key
12
+
13
+ Area = Literal["web", "news", "legal", "official"]
14
+ _AREA_PARAM = {"legal": "recht", "official": "amtlich"}
15
+ _AREA_NAME = {"recht": "legal", "amtlich": "official"}
16
+
17
+
18
+ def _clean(d: Dict[str, Any]) -> Dict[str, Any]:
19
+ return {k: v for k, v in d.items() if v not in (None, "")}
20
+
21
+
22
+ class _PoliasBase(BaseTool):
23
+ api_key: Optional[SecretStr] = None
24
+ """Polias API key (starts with "pol_"). Falls back to POLIAS_API_KEY."""
25
+ lang: Literal["de", "en"] = "de"
26
+ """Index language. "en" focuses on technical topics."""
27
+ country: Optional[str] = None
28
+ """Prefer results from a country, e.g. "de", "at" or "ch"."""
29
+ base_url: str = DEFAULT_BASE_URL
30
+
31
+ @model_validator(mode="before")
32
+ @classmethod
33
+ def _validate_key(cls, values: Dict[str, Any]) -> Dict[str, Any]:
34
+ values["api_key"] = SecretStr(resolve_api_key(_plain(values.get("api_key"))))
35
+ return values
36
+
37
+ def _get(self, path: str, params: Dict[str, Any]) -> Dict[str, Any]:
38
+ assert self.api_key is not None
39
+ return get_json(path, params, self.api_key.get_secret_value(), self.base_url)
40
+
41
+
42
+ def _plain(value: Any) -> Optional[str]:
43
+ if isinstance(value, SecretStr):
44
+ return value.get_secret_value()
45
+ return value
46
+
47
+
48
+ class PoliasSearchInput(BaseModel):
49
+ """Input for PoliasSearch."""
50
+
51
+ query: str = Field(description="Search query, up to 200 characters. Case numbers and ECLI work too.")
52
+ areas: Optional[List[Area]] = Field(
53
+ default=None,
54
+ description=(
55
+ 'Areas to search: "web", "news" (last 30 days), "legal" (court decisions '
56
+ 'and legislation), "official" (websites of public authorities; not together '
57
+ 'with "web"). Default: web.'
58
+ ),
59
+ )
60
+ count: int = Field(default=5, ge=1, le=10, description="Number of results, 1 to 10.")
61
+ town: Optional[str] = Field(
62
+ default=None,
63
+ description="Optional municipality in Germany, Austria or Switzerland for local results.",
64
+ )
65
+
66
+
67
+ class PoliasSearch(_PoliasBase):
68
+ """Search the web, news, law and official sources with Polias.
69
+
70
+ Setup:
71
+ .. code-block:: bash
72
+
73
+ pip install -U langchain-polias
74
+ export POLIAS_API_KEY="pol_..."
75
+
76
+ Invocation:
77
+ .. code-block:: python
78
+
79
+ from langchain_polias import PoliasSearch
80
+
81
+ tool = PoliasSearch()
82
+ tool.invoke({"query": "Kündigung Eigenbedarf", "areas": ["web", "legal"]})
83
+ """
84
+
85
+ name: str = "polias_search"
86
+ description: str = (
87
+ "Search an EU-hosted index for web pages, news, official sources and law. "
88
+ "Returns title, URL and a short snippet per result."
89
+ )
90
+ args_schema: Type[BaseModel] = PoliasSearchInput
91
+
92
+ def _run(
93
+ self,
94
+ query: str,
95
+ areas: Optional[List[str]] = None,
96
+ count: int = 5,
97
+ town: Optional[str] = None,
98
+ run_manager: Optional[CallbackManagerForToolRun] = None,
99
+ ) -> List[Dict[str, Any]]:
100
+ data = self._get(
101
+ "/search",
102
+ {
103
+ "q": query,
104
+ "result_filter": ",".join(_AREA_PARAM.get(a, a) for a in (areas or [])),
105
+ "count": count,
106
+ "lang": self.lang,
107
+ "land": self.country,
108
+ "ort": town,
109
+ },
110
+ )
111
+ if "results" in data:
112
+ blocks = {"web": data["results"]}
113
+ else:
114
+ blocks = {a: data.get(a, {}).get("results", []) for a in data.get("result_filter", [])}
115
+ return [
116
+ _clean(
117
+ {
118
+ "area": _AREA_NAME.get(area, area),
119
+ "title": r.get("title"),
120
+ "url": r.get("url"),
121
+ "snippet": r.get("snippet"),
122
+ "published": r.get("page_age"),
123
+ "notice": r.get("hinweis"),
124
+ }
125
+ )
126
+ for area, results in blocks.items()
127
+ for r in results
128
+ ]
129
+
130
+
131
+ class PoliasAISearchInput(BaseModel):
132
+ """Input for PoliasAISearch."""
133
+
134
+ query: str = Field(description="Search query, up to 200 characters.")
135
+ areas: Optional[List[Literal["web", "news", "legal"]]] = Field(
136
+ default=None,
137
+ description='Areas: "web", "news" and "legal". Default: web and news.',
138
+ )
139
+ count: int = Field(default=3, ge=1, le=10, description="Results per area, 1 to 10.")
140
+
141
+
142
+ class PoliasAISearch(_PoliasBase):
143
+ """Search for AI answers: licence details per result and, where the licence
144
+ allows, a longer excerpt or the full legal text.
145
+
146
+ Invocation:
147
+ .. code-block:: python
148
+
149
+ from langchain_polias import PoliasAISearch
150
+
151
+ PoliasAISearch().invoke({"query": "Mietminderung Schimmel", "areas": ["legal"]})
152
+ """
153
+
154
+ name: str = "polias_ai_search"
155
+ description: str = (
156
+ "Search an EU-hosted index for use in AI answers. Each result carries licence "
157
+ "details and, where the licence allows, a longer excerpt; legal results include "
158
+ "the full text where allowed. Cite the source notice."
159
+ )
160
+ args_schema: Type[BaseModel] = PoliasAISearchInput
161
+
162
+ def _run(
163
+ self,
164
+ query: str,
165
+ areas: Optional[List[str]] = None,
166
+ count: int = 3,
167
+ run_manager: Optional[CallbackManagerForToolRun] = None,
168
+ ) -> List[Dict[str, Any]]:
169
+ data = self._get(
170
+ "/ki",
171
+ {"q": query, "scope": ",".join(areas or []), "count": count, "lang": self.lang, "land": self.country},
172
+ )
173
+ return [
174
+ _clean(
175
+ {
176
+ "area": area,
177
+ "title": r.get("title") or r.get("titel"),
178
+ "url": r.get("url"),
179
+ "text": r.get("volltext") or r.get("excerpt") or r.get("snippet"),
180
+ "full_text": bool(r.get("volltext")),
181
+ "date": r.get("as_of") or r.get("date"),
182
+ "license": r.get("license") or r.get("lizenz"),
183
+ "notice": r.get("notice") or r.get("hinweis"),
184
+ "court": r.get("court"),
185
+ "case_number": r.get("case_number"),
186
+ "ecli": r.get("ecli"),
187
+ }
188
+ )
189
+ for area in ("web", "news", "official", "legal")
190
+ for r in (data.get(area) or [])
191
+ ]
192
+
193
+
194
+ class PoliasLegalSearchInput(BaseModel):
195
+ """Input for PoliasLegalSearch."""
196
+
197
+ query: str = Field(description='Topic, case number, ECLI or citation such as "§ 536 BGB".')
198
+ country: Optional[str] = Field(
199
+ default=None,
200
+ description='Country codes, comma-separated: "de", "at", "ch", "eu", "fr", "nl", "es".',
201
+ )
202
+ court: Optional[str] = Field(default=None, description='Court, e.g. "BGH" or "CJEU".')
203
+ count: int = Field(default=5, ge=1, le=10, description="Number of results, 1 to 10.")
204
+
205
+
206
+ class PoliasLegalSearch(_PoliasBase):
207
+ """Search court decisions and legislation from the EU and European countries.
208
+
209
+ Invocation:
210
+ .. code-block:: python
211
+
212
+ from langchain_polias import PoliasLegalSearch
213
+
214
+ PoliasLegalSearch().invoke({"query": "Mietminderung Schimmel", "country": "de"})
215
+ """
216
+
217
+ name: str = "polias_legal_search"
218
+ description: str = (
219
+ "Search court decisions and legislation from the EU and European countries. "
220
+ "Returns court, case number, date, ECLI, an excerpt and a source notice to show."
221
+ )
222
+ args_schema: Type[BaseModel] = PoliasLegalSearchInput
223
+
224
+ def _run(
225
+ self,
226
+ query: str,
227
+ country: Optional[str] = None,
228
+ court: Optional[str] = None,
229
+ count: int = 5,
230
+ run_manager: Optional[CallbackManagerForToolRun] = None,
231
+ ) -> List[Dict[str, Any]]:
232
+ data = self._get("/legal", {"q": query, "country": country, "court": court, "count": count})
233
+ return [
234
+ _clean(
235
+ {
236
+ "title": r.get("title"),
237
+ "url": r.get("url"),
238
+ "court": r.get("court"),
239
+ "case_number": r.get("case_number"),
240
+ "date": r.get("date"),
241
+ "ecli": r.get("ecli"),
242
+ "country": r.get("country"),
243
+ "excerpt": r.get("excerpt") or r.get("ausschnitt"),
244
+ "license": r.get("license"),
245
+ "notice": r.get("notice"),
246
+ }
247
+ )
248
+ for r in data.get("results", [])
249
+ ]
@@ -0,0 +1,36 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "langchain-polias"
7
+ version = "0.1.0"
8
+ description = "An integration package connecting Polias search and LangChain"
9
+ authors = [{name = "Polias", email = "hallo@polias.eu"}]
10
+ readme = "README.md"
11
+ license = "MIT"
12
+ requires-python = ">=3.10,<4.0"
13
+ keywords = ["polias", "langchain", "search", "web search", "legal"]
14
+ dependencies = [
15
+ "langchain-core>=0.3.70,<2.0",
16
+ "requests>=2.31.0",
17
+ ]
18
+
19
+ [project.urls]
20
+ "Homepage" = "https://api.polias.eu/"
21
+ "Source Code" = "https://github.com/Polias-Team/langchain-polias"
22
+
23
+ [dependency-groups]
24
+ test = [
25
+ "pytest>=8",
26
+ "pytest-asyncio>=0.23",
27
+ "pytest-socket>=0.7",
28
+ "langchain-tests>=0.3.20",
29
+ ]
30
+
31
+ [tool.hatch.build.targets.wheel]
32
+ packages = ["langchain_polias"]
33
+
34
+ [tool.pytest.ini_options]
35
+ asyncio_mode = "auto"
36
+ markers = ["compile: mark placeholder test used to compile integration tests without running them"]
File without changes
@@ -0,0 +1,63 @@
1
+ """Run against the live API: needs POLIAS_API_KEY."""
2
+
3
+ from typing import Type
4
+
5
+ from langchain_tests.integration_tests import RetrieversIntegrationTests, ToolsIntegrationTests
6
+
7
+ from langchain_polias import PoliasAISearch, PoliasLegalSearch, PoliasRetriever, PoliasSearch
8
+
9
+
10
+ class TestPoliasSearchIntegration(ToolsIntegrationTests):
11
+ @property
12
+ def tool_constructor(self) -> Type[PoliasSearch]:
13
+ return PoliasSearch
14
+
15
+ @property
16
+ def tool_constructor_params(self) -> dict:
17
+ return {}
18
+
19
+ @property
20
+ def tool_invoke_params_example(self) -> dict:
21
+ return {"query": "VIII ZR 15/23", "areas": ["web", "legal"], "count": 3}
22
+
23
+
24
+ class TestPoliasAISearchIntegration(ToolsIntegrationTests):
25
+ @property
26
+ def tool_constructor(self) -> Type[PoliasAISearch]:
27
+ return PoliasAISearch
28
+
29
+ @property
30
+ def tool_constructor_params(self) -> dict:
31
+ return {}
32
+
33
+ @property
34
+ def tool_invoke_params_example(self) -> dict:
35
+ return {"query": "Mietminderung Schimmel", "areas": ["web", "legal"], "count": 2}
36
+
37
+
38
+ class TestPoliasLegalSearchIntegration(ToolsIntegrationTests):
39
+ @property
40
+ def tool_constructor(self) -> Type[PoliasLegalSearch]:
41
+ return PoliasLegalSearch
42
+
43
+ @property
44
+ def tool_constructor_params(self) -> dict:
45
+ return {}
46
+
47
+ @property
48
+ def tool_invoke_params_example(self) -> dict:
49
+ return {"query": "Mietminderung Schimmel", "country": "de", "count": 2}
50
+
51
+
52
+ class TestPoliasRetrieverIntegration(RetrieversIntegrationTests):
53
+ @property
54
+ def retriever_constructor(self) -> Type[PoliasRetriever]:
55
+ return PoliasRetriever
56
+
57
+ @property
58
+ def retriever_constructor_params(self) -> dict:
59
+ return {"k": 2}
60
+
61
+ @property
62
+ def retriever_query_example(self) -> str:
63
+ return "Mietminderung Schimmel"
File without changes
@@ -0,0 +1,58 @@
1
+ from unittest.mock import Mock, patch
2
+
3
+ import pytest
4
+
5
+ from langchain_polias import PoliasAISearch, PoliasRetriever, PoliasSearch
6
+
7
+
8
+ def _resp(payload, status=200):
9
+ r = Mock()
10
+ r.status_code = status
11
+ r.json.return_value = payload
12
+ r.text = str(payload)
13
+ return r
14
+
15
+
16
+ def test_key_required(monkeypatch):
17
+ monkeypatch.delenv("POLIAS_API_KEY", raising=False)
18
+ with pytest.raises(ValueError):
19
+ PoliasSearch()
20
+
21
+
22
+ def test_key_hidden():
23
+ assert "pol_secret" not in repr(PoliasSearch(api_key="pol_secret"))
24
+
25
+
26
+ @patch("langchain_polias._client.requests.get")
27
+ def test_search_areas(mock_get):
28
+ mock_get.return_value = _resp(
29
+ {
30
+ "result_filter": ["legal"],
31
+ "legal": {"results": [{"title": "L", "url": "https://l", "snippet": "s", "hinweis": "Quelle"}]},
32
+ }
33
+ )
34
+ out = PoliasSearch(api_key="pol_t").invoke({"query": "q", "areas": ["legal"]})
35
+ assert mock_get.call_args.kwargs["params"]["result_filter"] == "recht"
36
+ assert out == [{"area": "legal", "title": "L", "url": "https://l", "snippet": "s", "notice": "Quelle"}]
37
+
38
+
39
+ @patch("langchain_polias._client.requests.get")
40
+ def test_ai_search_full_text(mock_get):
41
+ mock_get.return_value = _resp({"legal": [{"titel": "U", "url": "https://u", "volltext": "VT", "lizenz": "CC0"}]})
42
+ out = PoliasAISearch(api_key="pol_t").invoke({"query": "q", "areas": ["legal"]})
43
+ assert out[0]["text"] == "VT" and out[0]["full_text"] is True and out[0]["license"] == "CC0"
44
+
45
+
46
+ @patch("langchain_polias._client.requests.get")
47
+ def test_retriever(mock_get):
48
+ mock_get.return_value = _resp({"web": [{"title": "W", "url": "https://w", "snippet": "s"}]})
49
+ docs = PoliasRetriever(api_key="pol_t", k=1).invoke("q")
50
+ assert docs[0].page_content == "s" and docs[0].metadata["url"] == "https://w"
51
+ assert mock_get.call_args.args[0] == "https://api.polias.eu/v1/ki"
52
+
53
+
54
+ @patch("langchain_polias._client.requests.get")
55
+ def test_error(mock_get):
56
+ mock_get.return_value = _resp({"error": "API key missing or unknown"}, 401)
57
+ with pytest.raises(ValueError, match="401"):
58
+ PoliasSearch(api_key="pol_bad").invoke({"query": "q"})
@@ -0,0 +1,47 @@
1
+ from typing import Type
2
+
3
+ from langchain_tests.unit_tests import ToolsUnitTests
4
+
5
+ from langchain_polias import PoliasAISearch, PoliasLegalSearch, PoliasSearch
6
+
7
+
8
+ class TestPoliasSearchUnit(ToolsUnitTests):
9
+ @property
10
+ def tool_constructor(self) -> Type[PoliasSearch]:
11
+ return PoliasSearch
12
+
13
+ @property
14
+ def tool_constructor_params(self) -> dict:
15
+ return {"api_key": "pol_test"}
16
+
17
+ @property
18
+ def tool_invoke_params_example(self) -> dict:
19
+ return {"query": "wetter berlin", "areas": ["web"], "count": 3}
20
+
21
+
22
+ class TestPoliasAISearchUnit(ToolsUnitTests):
23
+ @property
24
+ def tool_constructor(self) -> Type[PoliasAISearch]:
25
+ return PoliasAISearch
26
+
27
+ @property
28
+ def tool_constructor_params(self) -> dict:
29
+ return {"api_key": "pol_test"}
30
+
31
+ @property
32
+ def tool_invoke_params_example(self) -> dict:
33
+ return {"query": "Mietminderung Schimmel", "areas": ["legal"], "count": 2}
34
+
35
+
36
+ class TestPoliasLegalSearchUnit(ToolsUnitTests):
37
+ @property
38
+ def tool_constructor(self) -> Type[PoliasLegalSearch]:
39
+ return PoliasLegalSearch
40
+
41
+ @property
42
+ def tool_constructor_params(self) -> dict:
43
+ return {"api_key": "pol_test"}
44
+
45
+ @property
46
+ def tool_invoke_params_example(self) -> dict:
47
+ return {"query": "Mietminderung Schimmel", "country": "de", "count": 2}