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.
- {laplace_python_sdk-1.3.0/src/laplace_python_sdk.egg-info → laplace_python_sdk-1.4.0}/PKG-INFO +1 -1
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/pyproject.toml +3 -3
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/models.py +40 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/news.py +111 -2
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0/src/laplace_python_sdk.egg-info}/PKG-INFO +1 -1
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/LICENSE +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/MANIFEST.in +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/README.md +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/setup.cfg +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/__init__.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/base.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/brokers.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/capital_increase.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/client.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/collections.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/earnings.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/financials.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/funds.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/live_price.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/politician.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/screener.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/search.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/state.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/stocks.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace/websocket.py +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace_python_sdk.egg-info/SOURCES.txt +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace_python_sdk.egg-info/dependency_links.txt +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace_python_sdk.egg-info/requires.txt +0 -0
- {laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace_python_sdk.egg-info/top_level.txt +0 -0
|
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "laplace-python-sdk"
|
|
7
|
-
version = "1.
|
|
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.
|
|
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.
|
|
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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace_python_sdk.egg-info/SOURCES.txt
RENAMED
|
File without changes
|
|
File without changes
|
{laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace_python_sdk.egg-info/requires.txt
RENAMED
|
File without changes
|
{laplace_python_sdk-1.3.0 → laplace_python_sdk-1.4.0}/src/laplace_python_sdk.egg-info/top_level.txt
RENAMED
|
File without changes
|