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 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
- extra_filters: Optional[str] = None,
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
- extra_filters: Optional extra filters (API-specific)
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 extra_filters:
274
- params["extraFilters"] = extra_filters
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,
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: laplace-python-sdk
3
- Version: 1.2.2
3
+ Version: 1.3.0
4
4
  Summary: Python SDK for Laplace stock data platform
5
5
  Author: Laplace SDK Team
6
6
  License: MIT
@@ -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=xZk6pOlIEeGbZdKAeIiAYvrIw2-xs0K0_gMZKBdk0Fo,29057
12
- laplace/news.py,sha256=8ZiJFLp9jOt0eFEQptK4fl9Mlmw-FF_eKnmnjhTzpqI,10826
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.2.2.dist-info/licenses/LICENSE,sha256=7q_XpeQPP0BLMADuenSz0wqLxttWJtoOei0sYmqly0g,1063
20
- laplace_python_sdk-1.2.2.dist-info/METADATA,sha256=udRpT3a67oseMCIScJTEuZnY4mcVcT8fEwXZ8dPR52w,9545
21
- laplace_python_sdk-1.2.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
22
- laplace_python_sdk-1.2.2.dist-info/top_level.txt,sha256=miT6qTaH7MSLy2iNStZCy478rCt72Hij9KP1bRBTGPA,8
23
- laplace_python_sdk-1.2.2.dist-info/RECORD,,
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,,