laplace-python-sdk 1.2.2__py3-none-any.whl → 1.3.0__py3-none-any.whl
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.
- laplace/models.py +14 -0
- laplace/news.py +70 -5
- {laplace_python_sdk-1.2.2.dist-info → laplace_python_sdk-1.3.0.dist-info}/METADATA +1 -1
- {laplace_python_sdk-1.2.2.dist-info → laplace_python_sdk-1.3.0.dist-info}/RECORD +7 -7
- {laplace_python_sdk-1.2.2.dist-info → laplace_python_sdk-1.3.0.dist-info}/WHEEL +0 -0
- {laplace_python_sdk-1.2.2.dist-info → laplace_python_sdk-1.3.0.dist-info}/licenses/LICENSE +0 -0
- {laplace_python_sdk-1.2.2.dist-info → laplace_python_sdk-1.3.0.dist-info}/top_level.txt +0 -0
laplace/models.py
CHANGED
|
@@ -844,6 +844,7 @@ class NewsOrderBy(str, Enum):
|
|
|
844
844
|
"""News order by options."""
|
|
845
845
|
|
|
846
846
|
TIMESTAMP = "timestamp"
|
|
847
|
+
QUALITY_SCORE = "quality_score"
|
|
847
848
|
|
|
848
849
|
|
|
849
850
|
class NewsTicker(BaseModel):
|
|
@@ -881,6 +882,18 @@ class NewsCategory(BaseModel):
|
|
|
881
882
|
|
|
882
883
|
model_config = {"populate_by_name": True}
|
|
883
884
|
|
|
885
|
+
class NewsCategoryListItem(BaseModel):
|
|
886
|
+
"""A canonical news category as returned by /api/v1/news/categories.
|
|
887
|
+
|
|
888
|
+
The ``name`` is the exact value accepted by the ``categories`` filter of the
|
|
889
|
+
News V2 and Live News Stream endpoints.
|
|
890
|
+
"""
|
|
891
|
+
|
|
892
|
+
id: str
|
|
893
|
+
name: str
|
|
894
|
+
|
|
895
|
+
model_config = {"populate_by_name": True}
|
|
896
|
+
|
|
884
897
|
class NewsContent(BaseModel):
|
|
885
898
|
title: str
|
|
886
899
|
description: str
|
|
@@ -968,6 +981,7 @@ class ScreenerFilters(BaseModel):
|
|
|
968
981
|
class ScreenerSortBy(str, Enum):
|
|
969
982
|
"""Sort fields supported by the screener endpoint."""
|
|
970
983
|
|
|
984
|
+
SYMBOL = "symbol"
|
|
971
985
|
PRICE = "price"
|
|
972
986
|
DAILY_CHANGE = "dailyChange"
|
|
973
987
|
MARKET_CAP = "marketCap"
|
laplace/news.py
CHANGED
|
@@ -11,6 +11,7 @@ from .models import (
|
|
|
11
11
|
Locale,
|
|
12
12
|
News,
|
|
13
13
|
NewsV2,
|
|
14
|
+
NewsCategoryListItem,
|
|
14
15
|
NewsHighlight,
|
|
15
16
|
NewsOrderBy,
|
|
16
17
|
NewsType,
|
|
@@ -80,6 +81,10 @@ class NewsStream:
|
|
|
80
81
|
except asyncio.CancelledError:
|
|
81
82
|
break
|
|
82
83
|
|
|
84
|
+
def __aiter__(self) -> AsyncGenerator[NewsStreamResult[List[NewsV2]], None]:
|
|
85
|
+
"""Allow ``async for result in stream`` directly over the stream."""
|
|
86
|
+
return self.receive()
|
|
87
|
+
|
|
83
88
|
async def close(self) -> None:
|
|
84
89
|
"""Close the stream and cleanup resources."""
|
|
85
90
|
if self._is_closed:
|
|
@@ -238,19 +243,40 @@ class NewsClient:
|
|
|
238
243
|
news_type: Optional[NewsType] = None,
|
|
239
244
|
news_order_by: Optional[NewsOrderBy] = None,
|
|
240
245
|
direction: Optional[SortDirection] = None,
|
|
241
|
-
|
|
246
|
+
symbols: Optional[str] = None,
|
|
247
|
+
categories: Optional[str] = None,
|
|
248
|
+
sectors: Optional[str] = None,
|
|
249
|
+
industries: Optional[str] = None,
|
|
250
|
+
quality_score_min: Optional[int] = None,
|
|
251
|
+
quality_score_max: Optional[int] = None,
|
|
252
|
+
timestamp_from: Optional[str] = None,
|
|
253
|
+
timestamp_to: Optional[str] = None,
|
|
242
254
|
page: int = 0,
|
|
243
255
|
page_size: PaginationPageSize = PaginationPageSize.PAGE_SIZE_10,
|
|
244
256
|
) -> PaginatedResponse[NewsV2]:
|
|
245
257
|
"""Retrieve paginated news (v2).
|
|
246
258
|
|
|
259
|
+
Within a single filter, comma-separated values are OR-ed; different
|
|
260
|
+
filters are AND-ed together (e.g. ``(AAPL OR MSFT) AND Technology``).
|
|
261
|
+
The ``categories``, ``sectors`` and ``industries`` filters only accept
|
|
262
|
+
values returned by their respective listing endpoints
|
|
263
|
+
(``/api/v1/news/categories`` ``name``, ``/api/v1/sector`` ``title``,
|
|
264
|
+
``/api/v1/industry`` ``title``).
|
|
265
|
+
|
|
247
266
|
Args:
|
|
248
267
|
locale: Locale code (e.g. "tr", "en")
|
|
249
268
|
region: Region enum (e.g. Region.TR)
|
|
250
269
|
news_type: Optional news type filter
|
|
251
|
-
news_order_by: Optional sorting field
|
|
270
|
+
news_order_by: Optional sorting field (timestamp, quality_score)
|
|
252
271
|
direction: Optional sort direction
|
|
253
|
-
|
|
272
|
+
symbols: Optional comma-separated ticker symbols (e.g. "AAPL,MSFT")
|
|
273
|
+
categories: Optional comma-separated category names
|
|
274
|
+
sectors: Optional comma-separated sector titles
|
|
275
|
+
industries: Optional comma-separated industry titles
|
|
276
|
+
quality_score_min: Optional minimum quality score, inclusive (0-10)
|
|
277
|
+
quality_score_max: Optional maximum quality score, inclusive (0-10)
|
|
278
|
+
timestamp_from: Optional start date, inclusive (YYYY-MM-DD)
|
|
279
|
+
timestamp_to: Optional end date, inclusive (YYYY-MM-DD)
|
|
254
280
|
page: Page number (default: 0)
|
|
255
281
|
page_size: Page size enum (default: 10)
|
|
256
282
|
|
|
@@ -270,12 +296,51 @@ class NewsClient:
|
|
|
270
296
|
params["orderBy"] = news_order_by.value
|
|
271
297
|
if direction is not None:
|
|
272
298
|
params["orderByDirection"] = direction.value
|
|
273
|
-
if
|
|
274
|
-
params["
|
|
299
|
+
if symbols:
|
|
300
|
+
params["symbols"] = symbols
|
|
301
|
+
if categories:
|
|
302
|
+
params["categories"] = categories
|
|
303
|
+
if sectors:
|
|
304
|
+
params["sectors"] = sectors
|
|
305
|
+
if industries:
|
|
306
|
+
params["industries"] = industries
|
|
307
|
+
if quality_score_min is not None:
|
|
308
|
+
params["qualityScoreMin"] = quality_score_min
|
|
309
|
+
if quality_score_max is not None:
|
|
310
|
+
params["qualityScoreMax"] = quality_score_max
|
|
311
|
+
if timestamp_from:
|
|
312
|
+
params["timestampFrom"] = timestamp_from
|
|
313
|
+
if timestamp_to:
|
|
314
|
+
params["timestampTo"] = timestamp_to
|
|
275
315
|
|
|
276
316
|
response = self._client.get("v2/news", params=params)
|
|
277
317
|
return PaginatedResponse[NewsV2](**response)
|
|
278
318
|
|
|
319
|
+
def get_news_categories(
|
|
320
|
+
self,
|
|
321
|
+
locale: Optional[Locale] = None,
|
|
322
|
+
) -> List[NewsCategoryListItem]:
|
|
323
|
+
"""Retrieve the full canonical news category list.
|
|
324
|
+
|
|
325
|
+
Always returns every category regardless of whether it currently has
|
|
326
|
+
tagged news, ordered by id ascending. The returned ``name`` values are
|
|
327
|
+
the exact values accepted by the ``categories`` filter of
|
|
328
|
+
:meth:`get_news_v2` and :meth:`get_news_stream`.
|
|
329
|
+
|
|
330
|
+
Args:
|
|
331
|
+
locale: Optional language code ("tr", "en"). Defaults to "en";
|
|
332
|
+
any unsupported value falls back to "en".
|
|
333
|
+
|
|
334
|
+
Returns:
|
|
335
|
+
List of NewsCategoryListItem
|
|
336
|
+
"""
|
|
337
|
+
params: Dict[str, object] = {}
|
|
338
|
+
if locale is not None:
|
|
339
|
+
params["locale"] = locale
|
|
340
|
+
|
|
341
|
+
response = self._client.get("v1/news/categories", params=params)
|
|
342
|
+
return [NewsCategoryListItem(**item) for item in response]
|
|
343
|
+
|
|
279
344
|
def get_highlights(
|
|
280
345
|
self,
|
|
281
346
|
locale: Locale,
|
|
@@ -8,16 +8,16 @@ laplace/earnings.py,sha256=y1fVgfJUXGl3vOSF9g6ryuoYYygXuxcsfk4VO2SVRjE,2114
|
|
|
8
8
|
laplace/financials.py,sha256=QJPlOzd5dhhOC2bdtbGmPfnsHx9bCf9nCM34bVtzYag,3132
|
|
9
9
|
laplace/funds.py,sha256=o-lmCtXX60ehaoYOuCRayU7P1n9D6oHaZR6N3OXq5kU,3200
|
|
10
10
|
laplace/live_price.py,sha256=4l3YhfVjnRv7f_h-EBFLo5m0tGTGYdP5E6BcNrTXegE,16360
|
|
11
|
-
laplace/models.py,sha256=
|
|
12
|
-
laplace/news.py,sha256=
|
|
11
|
+
laplace/models.py,sha256=8J7eTcnWr4fcy5gjmNaXQMbsKnw3tCOAj2zW2yFEoEA,29436
|
|
12
|
+
laplace/news.py,sha256=qVZqerPcjSbsdtsucKHwvpFS14l4USoPkkrevz1Ybxo,13755
|
|
13
13
|
laplace/politician.py,sha256=Llez12RDJZWC8AOwRn4vupT7NZ6mZNk_b6JcNSMJGyA,1778
|
|
14
14
|
laplace/screener.py,sha256=g1c9PZIcsBvkBCbe0qzdpWAu6-zEzawD1iXYeBdly9k,1981
|
|
15
15
|
laplace/search.py,sha256=JYsb8Nr5F-UMS53MGaMHL3d6VxJ7M8V3xHnFK22ORMg,1518
|
|
16
16
|
laplace/state.py,sha256=P2Ky0fToDc_VauBFD7bw91dywVkY3TaIN3mhf0Ms5sg,3417
|
|
17
17
|
laplace/stocks.py,sha256=ou4k_Kv9n_Nm_9hayYvLxHub1cX0qnjhgJeCM-6epo0,12552
|
|
18
18
|
laplace/websocket.py,sha256=9VNCA38Y_jznSDDajwybSoRtBz1BoANqcFZMZiUBG88,15603
|
|
19
|
-
laplace_python_sdk-1.
|
|
20
|
-
laplace_python_sdk-1.
|
|
21
|
-
laplace_python_sdk-1.
|
|
22
|
-
laplace_python_sdk-1.
|
|
23
|
-
laplace_python_sdk-1.
|
|
19
|
+
laplace_python_sdk-1.3.0.dist-info/licenses/LICENSE,sha256=7q_XpeQPP0BLMADuenSz0wqLxttWJtoOei0sYmqly0g,1063
|
|
20
|
+
laplace_python_sdk-1.3.0.dist-info/METADATA,sha256=kdalHL7K4lx8o7jp3hC5rdIEkgNnNJNCpq6FVFE6K0Q,9545
|
|
21
|
+
laplace_python_sdk-1.3.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
|
|
22
|
+
laplace_python_sdk-1.3.0.dist-info/top_level.txt,sha256=miT6qTaH7MSLy2iNStZCy478rCt72Hij9KP1bRBTGPA,8
|
|
23
|
+
laplace_python_sdk-1.3.0.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|
|
File without changes
|