laplace-python-sdk 1.3.0__tar.gz → 1.4.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.
Files changed (29) hide show
  1. {laplace_python_sdk-1.3.0/src/laplace_python_sdk.egg-info → laplace_python_sdk-1.4.0}/PKG-INFO +1 -1
  2. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/pyproject.toml +3 -3
  3. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/models.py +40 -0
  4. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/news.py +111 -2
  5. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0/src/laplace_python_sdk.egg-info}/PKG-INFO +1 -1
  6. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/LICENSE +0 -0
  7. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/MANIFEST.in +0 -0
  8. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/README.md +0 -0
  9. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/setup.cfg +0 -0
  10. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/__init__.py +0 -0
  11. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/base.py +0 -0
  12. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/brokers.py +0 -0
  13. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/capital_increase.py +0 -0
  14. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/client.py +0 -0
  15. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/collections.py +0 -0
  16. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/earnings.py +0 -0
  17. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/financials.py +0 -0
  18. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/funds.py +0 -0
  19. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/live_price.py +0 -0
  20. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/politician.py +0 -0
  21. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/screener.py +0 -0
  22. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/search.py +0 -0
  23. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/state.py +0 -0
  24. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/stocks.py +0 -0
  25. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/websocket.py +0 -0
  26. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace_python_sdk.egg-info/SOURCES.txt +0 -0
  27. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace_python_sdk.egg-info/dependency_links.txt +0 -0
  28. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace_python_sdk.egg-info/requires.txt +0 -0
  29. {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace_python_sdk.egg-info/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: laplace-python-sdk
3
- Version: 1.3.0
3
+ Version: 1.4.0
4
4
  Summary: Python SDK for Laplace stock data platform
5
5
  Author: Laplace SDK Team
6
6
  License: MIT
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "laplace-python-sdk"
7
- version = "1.3.0"
7
+ version = "1.4.0"
8
8
  description = "Python SDK for Laplace stock data platform"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.8"
@@ -64,14 +64,14 @@ profile = "black"
64
64
  line_length = 100
65
65
 
66
66
  [tool.mypy]
67
- python_version = "1.3.0"
67
+ python_version = "1.4.0"
68
68
  strict = true
69
69
  warn_return_any = true
70
70
  warn_unused_configs = true
71
71
 
72
72
  [tool.ruff]
73
73
  line-length = 100
74
- target-version = "1.3.0"
74
+ target-version = "1.4.0"
75
75
 
76
76
  [tool.ruff.lint]
77
77
  select = ["E", "W", "F", "I", "N", "B", "UP"]
@@ -847,6 +847,19 @@ class NewsOrderBy(str, Enum):
847
847
  QUALITY_SCORE = "quality_score"
848
848
 
849
849
 
850
+ class NewsLane(str, Enum):
851
+ """News lane options for the filter-news and stream-news endpoints.
852
+
853
+ Lanes are surface-scoped: ``GLOBAL_MACRO`` and ``FAST_MOVERS`` belong to the
854
+ ``us`` region, while ``TR_EKONOMI`` and ``BIST`` belong to the ``tr`` region.
855
+ """
856
+
857
+ GLOBAL_MACRO = "global_macro"
858
+ TR_EKONOMI = "tr_ekonomi"
859
+ BIST = "bist"
860
+ FAST_MOVERS = "fast_movers"
861
+
862
+
850
863
  class NewsTicker(BaseModel):
851
864
  id: str
852
865
  name: str
@@ -894,6 +907,33 @@ class NewsCategoryListItem(BaseModel):
894
907
 
895
908
  model_config = {"populate_by_name": True}
896
909
 
910
+
911
+ class NewsLaneListItem(BaseModel):
912
+ """A news lane as returned by /api/v1/news/lanes.
913
+
914
+ The ``id`` is the exact value accepted by the ``lane`` filter of the
915
+ filter-news and stream-news endpoints (see :class:`NewsLane`).
916
+ """
917
+
918
+ id: str
919
+ label: str
920
+
921
+ model_config = {"populate_by_name": True}
922
+
923
+
924
+ class NewsApiSourceListItem(BaseModel):
925
+ """A configured news source as returned by /api/v1/news/api-source-names.
926
+
927
+ The ``id`` is the exact value accepted by the ``apiSource`` filter of the
928
+ filter-news and stream-news endpoints (comma-separated for multiple);
929
+ ``name`` is the display name (e.g. "BBC Business").
930
+ """
931
+
932
+ id: str
933
+ name: str
934
+
935
+ model_config = {"populate_by_name": True}
936
+
897
937
  class NewsContent(BaseModel):
898
938
  title: str
899
939
  description: str
@@ -11,8 +11,11 @@ from .models import (
11
11
  Locale,
12
12
  News,
13
13
  NewsV2,
14
+ NewsApiSourceListItem,
14
15
  NewsCategoryListItem,
15
16
  NewsHighlight,
17
+ NewsLane,
18
+ NewsLaneListItem,
16
19
  NewsOrderBy,
17
20
  NewsType,
18
21
  PaginatedResponse,
@@ -43,18 +46,22 @@ class NewsStream:
43
46
  base_client: BaseClient,
44
47
  locale: Locale,
45
48
  region: Region,
49
+ lane: Optional[NewsLane] = None,
46
50
  sectors: Optional[List[str]] = None,
47
51
  tickers: Optional[List[str]] = None,
48
52
  categories: Optional[List[str]] = None,
49
53
  industries: Optional[List[str]] = None,
54
+ api_sources: Optional[List[str]] = None,
50
55
  ):
51
56
  self.base_client = base_client
52
57
  self.locale = locale
53
58
  self.region = region
59
+ self.lane = lane
54
60
  self.sectors = sectors
55
61
  self.tickers = tickers
56
62
  self.categories = categories
57
63
  self.industries = industries
64
+ self.api_sources = api_sources
58
65
  self._task: Optional[asyncio.Task] = None
59
66
  self._queue: Optional[asyncio.Queue[NewsStreamResult[List[NewsV2]]]] = None
60
67
  self._is_closed = False
@@ -106,6 +113,8 @@ class NewsStream:
106
113
  """Build the streaming URL for the news endpoint."""
107
114
  url = f"{self.base_client.base_url}/v1/news/stream"
108
115
  params = {"locale": self.locale, "region": self.region.value}
116
+ if self.lane is not None:
117
+ params["lane"] = self.lane.value
109
118
  if self.sectors:
110
119
  params["sectors"] = ",".join(self.sectors)
111
120
  if self.tickers:
@@ -114,6 +123,8 @@ class NewsStream:
114
123
  params["categories"] = ",".join(self.categories)
115
124
  if self.industries:
116
125
  params["industries"] = ",".join(self.industries)
126
+ if self.api_sources:
127
+ params["apiSource"] = ",".join(self.api_sources)
117
128
 
118
129
  query_string = urllib.parse.urlencode(params)
119
130
  return f"{url}?{query_string}"
@@ -198,18 +209,47 @@ class NewsClient:
198
209
  news_type: Optional[NewsType] = None,
199
210
  news_order_by: Optional[NewsOrderBy] = None,
200
211
  direction: Optional[SortDirection] = None,
212
+ lane: Optional[NewsLane] = None,
213
+ api_source: Optional[str] = None,
214
+ symbols: Optional[str] = None,
215
+ categories: Optional[str] = None,
216
+ sectors: Optional[str] = None,
217
+ industries: Optional[str] = None,
218
+ quality_score_min: Optional[int] = None,
219
+ quality_score_max: Optional[int] = None,
220
+ timestamp_from: Optional[str] = None,
221
+ timestamp_to: Optional[str] = None,
201
222
  extra_filters: Optional[str] = None,
202
223
  page: int = 0,
203
224
  page_size: PaginationPageSize = PaginationPageSize.PAGE_SIZE_10,
204
225
  ) -> PaginatedResponse[News]:
205
226
  """Retrieve paginated news.
206
227
 
228
+ Within a single filter, comma-separated values are OR-ed; different
229
+ filters are AND-ed together (e.g. ``(AAPL OR MSFT) AND Technology``).
230
+ The ``categories``, ``sectors`` and ``industries`` filters only accept
231
+ values returned by their respective listing endpoints
232
+ (``/api/v1/news/categories`` ``name``, ``/api/v1/sector`` ``title``,
233
+ ``/api/v1/industry`` ``title``).
234
+
207
235
  Args:
208
236
  locale: Locale code (e.g. "tr", "en")
209
237
  region: Region enum (e.g. Region.TR)
210
238
  news_type: Optional news type filter
211
- news_order_by: Optional sorting field
239
+ news_order_by: Optional sorting field (timestamp, quality_score)
212
240
  direction: Optional sort direction
241
+ lane: Optional lane filter. Lanes are region-scoped: US lanes are
242
+ GLOBAL_MACRO and FAST_MOVERS; TR lanes are TR_EKONOMI and BIST.
243
+ api_source: Optional comma-separated source ids from
244
+ :meth:`get_news_api_source_names` (e.g. "BBCBusiness,MarketWatch")
245
+ symbols: Optional comma-separated ticker symbols (e.g. "AAPL,MSFT")
246
+ categories: Optional comma-separated category names
247
+ sectors: Optional comma-separated sector titles
248
+ industries: Optional comma-separated industry titles
249
+ quality_score_min: Optional minimum quality score, inclusive (0-10)
250
+ quality_score_max: Optional maximum quality score, inclusive (0-10)
251
+ timestamp_from: Optional start date, inclusive (YYYY-MM-DD)
252
+ timestamp_to: Optional end date, inclusive (YYYY-MM-DD)
213
253
  extra_filters: Optional extra filters (API-specific)
214
254
  page: Page number (default: 0)
215
255
  page_size: Page size enum (default: 10)
@@ -230,6 +270,26 @@ class NewsClient:
230
270
  params["orderBy"] = news_order_by.value
231
271
  if direction is not None:
232
272
  params["orderByDirection"] = direction.value
273
+ if lane is not None:
274
+ params["lane"] = lane.value
275
+ if api_source:
276
+ params["apiSource"] = api_source
277
+ if symbols:
278
+ params["symbols"] = symbols
279
+ if categories:
280
+ params["categories"] = categories
281
+ if sectors:
282
+ params["sectors"] = sectors
283
+ if industries:
284
+ params["industries"] = industries
285
+ if quality_score_min is not None:
286
+ params["qualityScoreMin"] = quality_score_min
287
+ if quality_score_max is not None:
288
+ params["qualityScoreMax"] = quality_score_max
289
+ if timestamp_from:
290
+ params["timestampFrom"] = timestamp_from
291
+ if timestamp_to:
292
+ params["timestampTo"] = timestamp_to
233
293
  if extra_filters:
234
294
  params["extraFilters"] = extra_filters
235
295
 
@@ -243,6 +303,8 @@ class NewsClient:
243
303
  news_type: Optional[NewsType] = None,
244
304
  news_order_by: Optional[NewsOrderBy] = None,
245
305
  direction: Optional[SortDirection] = None,
306
+ lane: Optional[NewsLane] = None,
307
+ api_source: Optional[str] = None,
246
308
  symbols: Optional[str] = None,
247
309
  categories: Optional[str] = None,
248
310
  sectors: Optional[str] = None,
@@ -269,6 +331,10 @@ class NewsClient:
269
331
  news_type: Optional news type filter
270
332
  news_order_by: Optional sorting field (timestamp, quality_score)
271
333
  direction: Optional sort direction
334
+ lane: Optional lane filter. Lanes are region-scoped: US lanes are
335
+ GLOBAL_MACRO and FAST_MOVERS; TR lanes are TR_EKONOMI and BIST.
336
+ api_source: Optional comma-separated source ids from
337
+ :meth:`get_news_api_source_names` (e.g. "BBCBusiness,MarketWatch")
272
338
  symbols: Optional comma-separated ticker symbols (e.g. "AAPL,MSFT")
273
339
  categories: Optional comma-separated category names
274
340
  sectors: Optional comma-separated sector titles
@@ -296,6 +362,10 @@ class NewsClient:
296
362
  params["orderBy"] = news_order_by.value
297
363
  if direction is not None:
298
364
  params["orderByDirection"] = direction.value
365
+ if lane is not None:
366
+ params["lane"] = lane.value
367
+ if api_source:
368
+ params["apiSource"] = api_source
299
369
  if symbols:
300
370
  params["symbols"] = symbols
301
371
  if categories:
@@ -341,6 +411,36 @@ class NewsClient:
341
411
  response = self._client.get("v1/news/categories", params=params)
342
412
  return [NewsCategoryListItem(**item) for item in response]
343
413
 
414
+ def get_news_lanes(self) -> List[NewsLaneListItem]:
415
+ """Retrieve the fixed news lane list.
416
+
417
+ Returns every lane (``id`` + ``label``) for building a lane filter. The
418
+ returned ``id`` values are the exact values accepted by the ``lane``
419
+ filter of :meth:`get_news`, :meth:`get_news_v2` and
420
+ :meth:`get_news_stream` (see :class:`~laplace.models.NewsLane`).
421
+
422
+ Returns:
423
+ List of NewsLaneListItem
424
+ """
425
+ response = self._client.get("v1/news/lanes")
426
+ return [NewsLaneListItem(**item) for item in response]
427
+
428
+ def get_news_api_source_names(self) -> List[NewsApiSourceListItem]:
429
+ """Retrieve the configured news sources.
430
+
431
+ Returns every source (``id`` + ``name``), registry sources first, then
432
+ any legacy sources still on old rows. The returned ``id`` values are
433
+ the exact values accepted by the ``api_source`` filter of
434
+ :meth:`get_news` and :meth:`get_news_v2` and the ``api_sources``
435
+ filter of :meth:`get_news_stream`; ``name`` is the display name
436
+ (e.g. "BBC Business").
437
+
438
+ Returns:
439
+ List of NewsApiSourceListItem
440
+ """
441
+ response = self._client.get("v1/news/api-source-names")
442
+ return [NewsApiSourceListItem(**item) for item in response]
443
+
344
444
  def get_highlights(
345
445
  self,
346
446
  locale: Locale,
@@ -367,20 +467,27 @@ class NewsClient:
367
467
  self,
368
468
  locale: Locale,
369
469
  region: Region,
470
+ lane: Optional[NewsLane] = None,
370
471
  sectors: Optional[List[str]] = None,
371
472
  tickers: Optional[List[str]] = None,
372
473
  categories: Optional[List[str]] = None,
373
474
  industries: Optional[List[str]] = None,
475
+ api_sources: Optional[List[str]] = None,
374
476
  ) -> NewsStream:
375
477
  """Start streaming news updates.
376
478
 
377
479
  Args:
378
480
  locale: Locale code (e.g., "tr", "en")
379
481
  region: Region enum (e.g. Region.TR)
482
+ lane: Optional lane filter. Lanes are region-scoped: US lanes are
483
+ GLOBAL_MACRO and FAST_MOVERS; TR lanes are TR_EKONOMI and BIST.
380
484
  sectors: Optional list of sectors
381
- tickers: Optional list of tickers
485
+ tickers: Optional list of tickers (stream uses tickers, not symbols)
382
486
  categories: Optional list of categories
383
487
  industries: Optional list of industries
488
+ api_sources: Optional list of source ids from
489
+ :meth:`get_news_api_source_names`; only these sources are
490
+ streamed
384
491
 
385
492
  Returns:
386
493
  NewsStream for consuming news items
@@ -389,10 +496,12 @@ class NewsClient:
389
496
  self._client,
390
497
  locale,
391
498
  region,
499
+ lane=lane,
392
500
  sectors=sectors,
393
501
  tickers=tickers,
394
502
  categories=categories,
395
503
  industries=industries,
504
+ api_sources=api_sources,
396
505
  )
397
506
  await stream.subscribe()
398
507
  return stream
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: laplace-python-sdk
3
- Version: 1.3.0
3
+ Version: 1.4.0
4
4
  Summary: Python SDK for Laplace stock data platform
5
5
  Author: Laplace SDK Team
6
6
  License: MIT