artesian-sdk 4.2.2.dev2__py3-none-any.whl → 4.2.2.dev14__py3-none-any.whl

Artesian/MarketData/_Dto/UpsertData.py

@@ -2,7 +2,9 @@ from dataclasses import dataclass
 from datetime import datetime
 from typing import Dict, List, Optional
 from dateutil import tz
+
 from Artesian.MarketData._Dto import MarketDataIdentifier
+from .._Enum import UpsertMode
 
 
 @dataclass
@@ -104,6 +106,7 @@ class UpsertData:
         deferDataGeneration: flag to choose between synchronous
                              and asynchronous data generation (MUV)
         keepNulls: when false, nulls are discarded client side and not sent
+        upsertMode: Merge or Replace, when None/Merge then data is merged with existing data
     """
 
     ID: MarketDataIdentifier
@@ -117,3 +120,4 @@ class UpsertData:
     deferCommandExecution: bool = False
     deferDataGeneration: bool = True
     keepNulls: bool = False
+    upsertMode: Optional[UpsertMode] = None

Artesian/MarketData/_Enum/UpsertMode.py

@@ -0,0 +1,6 @@
+from enum import Enum
+
+
+class UpsertMode(Enum):
+    Merge = 0
+    Replace = 1

Artesian/MarketData/_Enum/__init__.py

@@ -3,6 +3,7 @@ from ...Granularity import Granularity
 from .MarketDataType import MarketDataType
 from .ArtesianMetadataFacetType import ArtesianMetadataFacetType
 from .DerivedAlgorithm import DerivedAlgorithm
+from .UpsertMode import UpsertMode
 
 __all__ = [
     AggregationRule.__name__,
@@ -10,4 +11,5 @@ __all__ = [
     MarketDataType.__name__,
     ArtesianMetadataFacetType.__name__,
     DerivedAlgorithm.__name__,
+    UpsertMode.__name__
 ]  # type: ignore

Artesian/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '4.2.2.dev2'
-__version_tuple__ = version_tuple = (4, 2, 2, 'dev2')
+__version__ = version = '4.2.2.dev14'
+__version_tuple__ = version_tuple = (4, 2, 2, 'dev14')
 
 __commit_id__ = commit_id = None

{artesian_sdk-4.2.2.dev2.dist-info → artesian_sdk-4.2.2.dev14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: artesian-sdk
-Version: 4.2.2.dev2
+Version: 4.2.2.dev14
 Summary: Library provides read access to the Artesian API
 Author-email: ARK Lab <arklab@ark-energy.eu>
 Maintainer-email: ARK Lab <arklab@ark-energy.eu>
@@ -783,8 +783,19 @@ data = MarketData.UpsertData(mkdid, 'CET',
   )
 
 mkservice.upsertData(data)
+```
 
+Upsert has optional switches that can be applied
+```
+mkservice.upsertData(data, deferCommandExecution, deferDataGeneration, keepNulls, upsertMode)
 ```
+The switch details are,
+
+deferCommandExecution (true/false) choose between syncronoys and asyncronous command execution, default is false.
+deferDataGeneration (true/false) choose between syncronoys and asyncronous precomputed data generation, default is true.
+keepNulls (true/false) if true then nulls are written in the curve replacing any data present for the instant, default is false.
+upsertMode (Merge/Replace) for ActualTimeSeries the two modes are equivalent. Leaving Null/None/Empty is equivalent to Merge.
+
 
 DerivedCfg can be of algorithm type: Coalesce, Sum, Muv.
 
@@ -884,6 +895,37 @@ mkservice.upsertData(data)
 
 ```
 
+Upsert has optional switches that can be applied
+```
+mkservice.upsertData(data, deferCommandExecution, deferDataGeneration, keepNulls, upsertMode)
+```
+The switch details are,
+
+deferCommandExecution (true/false) choose between syncronoys and asyncronous command execution, default is false.
+deferDataGeneration (true/false) choose between syncronoys and asyncronous precomputed data generation, default is true.
+keepNulls (true/false) if true then nulls are written in the curve replacing any data present for the instant, default is false.
+upsertMode (Merge/Replace) for VersionedTimeSeries the merge writes in to the curve replacing existing data for an existing instant, replace writes the payload removing any previous data for the version. Leaving Null/None/Empty is equivalent to Merge.
+
+| DATETIME | EXISTING | PAYLOAD | MERGE | REPALACE |
+|---|---|---|---|---|
+| VERSION NAME | 2025-01-01 | 2025-01-01 | 2025-01-01 | 2025-01-01 |
+| 2025-01-01 |        |        |        |        |
+| 2025-01-02 | 999.99 | 222.22 | 222.22 | 222.22 |
+| 2025-01-03 | 999.99 | 222.22 | 222.22 | 222.22 |
+| 2025-01-04 | 999.99 | 222.22 | 222.22 | 222.22 |
+| 2025-01-05 | 999.99 | 222.22 | 222.22 | 222.22 |
+| 2025-01-06 | 999.99 | 222.22 | 222.22 | 222.22 |
+| 2025-01-07 | 999.99 | 222.22 | 222.22 | 222.22 |
+| 2025-01-08 |        | 222.22 | 222.22 | 222.22 |
+| 2025-01-09 |        |        |        |        |
+| 2025-01-10 |        |        |        |        |
+| 2025-01-11 | 999.99 |        | 999.99 |        |
+| 2025-01-12 | 999.99 |        | 999.99 |        |
+| 2025-01-13 | 999.99 |        | 999.99 |        |
+| 2025-01-14 |        |        |        |        |
+| 2025-01-15 |        |        |        |        |
+
+
 ### Write Data in a Market Assessment Time Series
 
 ```Python
@@ -931,6 +973,18 @@ mkservice.upsertData(marketAssessment)
 
 ```
 
+Upsert has optional switches that can be applied
+```
+mkservice.upsertData(data, deferCommandExecution, deferDataGeneration, keepNulls, upsertMode)
+```
+The switch details are,
+
+deferCommandExecution (true/false) choose between syncronoys and asyncronous command execution, default is false.
+deferDataGeneration (true/false) choose between syncronoys and asyncronous precomputed data generation, default is true.
+keepNulls (true/false) if true then nulls are written in the curve replacing any data present for the instant, default is false.
+upsertMode (Merge/Replace) for MarketAssessment merge adds the new products to the existing and overwrites existing with the new ones while replace replaces all the existing products with the new ones. Leaving Null/None/Empty is equivalent to Merge.
+
+
 ### Write Data in a Bid Ask Time Series
 
 ```Python
@@ -977,6 +1031,18 @@ bidAsk = MarketData.UpsertData(MarketData.MarketDataIdentifier('PROVIDER', 'MARK
 mkservice.upsertData(bidAsk)
 ```
 
+Upsert has optional switches that can be applied
+```
+mkservice.upsertData(data, deferCommandExecution, deferDataGeneration, keepNulls, upsertMode)
+```
+The switch details are,
+
+deferCommandExecution (true/false) choose between syncronoys and asyncronous command execution, default is false.
+deferDataGeneration (true/false) choose between syncronoys and asyncronous precomputed data generation, default is true.
+keepNulls (true/false) if true then nulls are written in the curve replacing any data present for the instant, default is false.
+upsertMode (Merge/Replace) for BidAsk merge adds the new products to the existing and overwrites existing with the new ones while replace replaces all the existing products with the new ones. Leaving Null/None/Empty is equivalent to Merge.
+
+
 ### Write Data in an Auction Time Series
 
 ```Python
@@ -1021,8 +1087,19 @@ auctionRows = MarketData.UpsertData(MarketData.MarketDataIdentifier('PROVIDER',
 
   mkservice.upsertData(auctionRows)
 
+```
 
+Upsert has optional switches that can be applied
 ```
+mkservice.upsertData(data, deferCommandExecution, deferDataGeneration, keepNulls, upsertMode)
+```
+The switch details are,
+
+deferCommandExecution (true/false) choose between syncronoys and asyncronous command execution, default is false.
+deferDataGeneration (true/false) choose between syncronoys and asyncronous precomputed data generation, default is true.
+keepNulls (true/false) if true then nulls are written in the curve replacing any data present for the instant, default is false.
+upsertMode (Merge/Replace) for Auction merge and replace are equivalent. Leaving Null/None/Empty is equivalent to Merge.
+
 
 ## Delete Data in Artesian
 

{artesian_sdk-4.2.2.dev2.dist-info → artesian_sdk-4.2.2.dev14.dist-info}/RECORD

@@ -4,7 +4,7 @@ Artesian/ArtesianPolicyConfig.py,sha256=ULLngwH1762K8Kre08_JZ7aNYs4LZOxocTYLPJjX
 Artesian/Exceptions.py,sha256=asPwxz8TaIpjZV4GJmWchGen_04Ib3Rdd7_Btud4X9E,6141
 Artesian/Granularity.py,sha256=EOeBP9Wz-tAhdm3rVVJBXx9jAkiMH9OIMJUsrNawsNU,206
 Artesian/__init__.py,sha256=c-Fu4VGOuvQCGRefF5C4CY9OxoGTDce7CgjipZN8lIo,1119
-Artesian/_version.py,sha256=okjYkL3eRro8MybmD00XtTcXNtJLhlGW1t4nzg9LkfM,717
+Artesian/_version.py,sha256=02STA5n-yMEPI2MMK3u27l2PRLWdQTBUst_5jag4d-U,719
 Artesian/GMEPublicOffers/ExtractionRangeConfig.py,sha256=pXVFdLpLqFvgzu2Y5UTckDWysFiJDKc0ZaXjuv46iJU,415
 Artesian/GMEPublicOffers/GMEPublicOfferQuery.py,sha256=IECU7nk6wN7alLIxiUQmPUWaeXWsoSDC1R9qv5JMjYI,15367
 Artesian/GMEPublicOffers/GMEPublicOfferQueryParameters.py,sha256=gs5SVNEYJTpwV9whZFw07jm5cIsion6TvgRDAeHj1Kw,3330
@@ -33,13 +33,14 @@ Artesian/MarketData/_Dto/MarketDataEntityOutput.py,sha256=TKV4n0aBZzInFVY_yI8UAS
 Artesian/MarketData/_Dto/MarketDataIdentifier.py,sha256=egNOuOI3qugbFl8_w3IUSV9mOdBj-akq7M4Gj0X4Ig8,289
 Artesian/MarketData/_Dto/PagedResult.py,sha256=-o0zKOLTbLg2wdz8K4K4qQJTkarEl-4SYppS6cf6j2o,736
 Artesian/MarketData/_Dto/UnitOfMeasure.py,sha256=B6Axt5wxMhLsjdXIiK0K912REmbCaZcaxWMImxEjXXY,304
-Artesian/MarketData/_Dto/UpsertData.py,sha256=qMEULDYcXG4s44P8jrBLFExPF4Ad4sVCgsKz6oMbO9U,3829
+Artesian/MarketData/_Dto/UpsertData.py,sha256=abIA7kQTW-9u3D-sjgv7mMEiY6UCARnj8Z1dMNYc8hM,3998
 Artesian/MarketData/_Dto/__init__.py,sha256=iTYvyR14J0tq7iuj-zQtn9xO1W1eJCX1GzsDvGrMkhQ,1289
 Artesian/MarketData/_Enum/AggregationRule.py,sha256=fkYmouBQwC68rFMyG_j-D_0IQA5JVrJRfSA7KxsCF-4,120
 Artesian/MarketData/_Enum/ArtesianMetadataFacetType.py,sha256=1wE9VOzZ4gHk5oBjwpJd_kCgrUIfyNQmxuOZevj4f28,92
 Artesian/MarketData/_Enum/DerivedAlgorithm.py,sha256=m64IQxmlyGPghLuTKaBAE6Y5afYBJdYofp8z0FQbASw,95
 Artesian/MarketData/_Enum/MarketDataType.py,sha256=lIXV21b1wNWEah0q76OD4bMV1n_dtsUHQNSr8SbTBcE,159
-Artesian/MarketData/_Enum/__init__.py,sha256=wdXoxKaDXNiMqeNAQg8UZH8EGp2I8Bea9PiYHrbjVNg,426
+Artesian/MarketData/_Enum/UpsertMode.py,sha256=UuAMKcvehXN8pagJ-UtadbVIer7mjJaYOoEop-QjvrU,78
+Artesian/MarketData/_Enum/__init__.py,sha256=7YM19VPx7kz7prHe3fHj23aF3efievZziaND50AxKUA,485
 Artesian/Query/ActualQuery.py,sha256=R3rKa8RAlximWhjflUh5M5SkAA_mlt-p6okFb31aN3c,10554
 Artesian/Query/AuctionQuery.py,sha256=Ns9e1YhY-Gaj35pMIOtVPhMmFYn0fnh_LufKIOnM27E,5087
 Artesian/Query/BidAskQuery.py,sha256=0KOeEX5C-GAlIMpEzpWguqW4zpFr7tyryWyGmUFU-lI,8125
@@ -67,8 +68,8 @@ Artesian/_ClientsExecutor/ArtesianJsonSerializer.py,sha256=CDnq1sgKLvxSampykFtF9
 Artesian/_ClientsExecutor/Client.py,sha256=AYVMOj9mf3QmCY1vmWzHQA4WRL2zqCB-yhE5XRfk8RE,3833
 Artesian/_ClientsExecutor/RequestExecutor.py,sha256=KKq31g8GFS-Mdp3S1QXFm5tZhacjnIeWs1YFc3f8NkY,10613
 Artesian/_ClientsExecutor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-artesian_sdk-4.2.2.dev2.dist-info/licenses/LICENSE,sha256=Y27w-dSf1pHlXO4yNy70OCCO4VuYYVxUdDOQ-sLdXds,1074
-artesian_sdk-4.2.2.dev2.dist-info/METADATA,sha256=OORtvJNkAuTqyBLZUG04gAaw3REUh57xGOFkM3h9sKA,33761
-artesian_sdk-4.2.2.dev2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-artesian_sdk-4.2.2.dev2.dist-info/top_level.txt,sha256=1Fv89OOnRKHLMmQEBRXPaNuPMoZytK4dnfrOFDdGGYI,9
-artesian_sdk-4.2.2.dev2.dist-info/RECORD,,
+artesian_sdk-4.2.2.dev14.dist-info/licenses/LICENSE,sha256=Y27w-dSf1pHlXO4yNy70OCCO4VuYYVxUdDOQ-sLdXds,1074
+artesian_sdk-4.2.2.dev14.dist-info/METADATA,sha256=IsyZAsLRaDRzbVzlK0Y3lTTVsyhIksQ39Em6oi0GzGk,38369
+artesian_sdk-4.2.2.dev14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+artesian_sdk-4.2.2.dev14.dist-info/top_level.txt,sha256=1Fv89OOnRKHLMmQEBRXPaNuPMoZytK4dnfrOFDdGGYI,9
+artesian_sdk-4.2.2.dev14.dist-info/RECORD,,