bw-essentials-core 0.0.7__py3-none-any.whl → 0.0.9__py3-none-any.whl

bw_essentials/services/market_pricer.py

@@ -67,7 +67,8 @@ class MarketPricer(ApiClient):
         self.name = Services.MARKET_PRICER.value
         self.urls = {
             "live": "live",
-            "eod": "eod"
+            "eod": "eod",
+            "index_performance": "index/{}/performance",
         }
 
     def get_live_prices(self, securities, exchange):
@@ -231,3 +232,71 @@ class MarketPricer(ApiClient):
 
         logger.info(f"{market_pricing_eod_response=}")
         return market_pricing_eod_response.get("data")
+
+    def get_index_performance_by_dates(self, index_name, start_date, end_date):
+        """
+        Fetches index performance metrics over a given date range.
+
+        Args:
+            index_name (str): The index name (e.g., "NIFTY50").
+            start_date (str): The start date for performance metrics in 'YYYY-MM-DD' format.
+            end_date (str): The end date for performance metrics in 'YYYY-MM-DD' format.
+
+        Returns:
+            dict: A dictionary containing cumulative return, volatility, drawdown, and a list
+                  of daily return data.
+                  Example:
+                    {
+                      "data": {
+                        "cumulative_return": 2.332968692796598,
+                        "volatility": 6.378354401960588,
+                        "drawdown": 0,
+                        "daily_returns": [
+                          {
+                            "date": "2025-06-05",
+                            "close": 22934.5,
+                            "daily_return": 0.5552912703301827,
+                            "current_weight": 100.55529127033019
+                          },
+                          {
+                            "date": "2025-06-06",
+                            "close": 23165.1,
+                            "daily_return": 1.0054721053434745,
+                            "current_weight": 101.56634667450024
+                          },
+                          {
+                            "date": "2025-06-09",
+                            "close": 23329.4,
+                            "daily_return": 0.7092565972087517,
+                            "current_weight": 102.28671268883305
+                          },
+                          {
+                            "date": "2025-06-10",
+                            "close": 23339.95,
+                            "daily_return": 0.04522190883606836,
+                            "current_weight": 102.3329686927966
+                          }
+                        ]
+                      },
+                      "success": true
+                    }
+        Raises:
+            ValueError: If input parameters are missing or invalid.
+        """
+        logger.info(f"In - get_index_performance_by_dates | {index_name=}, {start_date=}, {end_date=}")
+
+        if not all([index_name, start_date, end_date]):
+            logger.error("Missing required parameters for index performance fetch")
+            raise ValueError("index_name, start_date, and end_date are required")
+
+        endpoint = self.urls['index_performance'].format(index_name)
+        params = {"start_date": start_date, "end_date": end_date}
+        response = self._get(
+            url=self.base_url,
+            endpoint=endpoint,
+            params=params
+        )
+        logger.debug(f"Raw response from MarketPricer index API: {response}")
+        data = response.get("data")
+        logger.info("Out - get_index_performance_by_dates success")
+        return data

bw_essentials/services/master_data.py

@@ -45,7 +45,8 @@ class MasterData(ApiClient):
             "broker_config": "broker/config/keys",
             "broker_details": "securities/{}/details",
             "isin_details": "company/details/isin",
-            "shorten_url": "shorten-url"
+            "shorten_url": "shorten-url",
+            "broker_partner_mapping_details": "partner/{}/broker/{}/"
         }
 
     def get_security_details(self, securities: List[str]) -> Optional[Dict[str, Any]]:
@@ -277,3 +278,24 @@ class MasterData(ApiClient):
                               data={"long_url": long_url})
         logger.info(f"Shortening URL {response =}")
         return response.get("data", {})
+
+    def get_or_create_broker_partner_mapping(self, broker_partner: str, broker: str) -> Dict[str, Any]:
+        """
+        Fetches or creates a broker-partner mapping from master data constants table.
+
+        This method sends a GET request to retrieve the mapping details for a given
+        broker and broker partner. If the mapping does not exist, the API
+        is expected to create it automatically (based on implementation).
+
+        Parameters:
+        - broker_partner (str): The identifier of the broker partner.
+        - broker (str): The identifier of the broker.
+
+        Returns:
+        - Dict[str, Any]: The mapping data returned from the service, or an empty
+          dictionary if no data is available.
+        """
+        logger.info(f"In - get_or_create_broker_partner_mapping | broker_partner={broker_partner} broker={broker}")
+        response = self._get(url=self.base_url, endpoint=self.urls["broker_partner_mapping_details"].format(broker_partner, broker))
+        logger.info(f"Broker partner mapping {response =}")
+        return response.get('data', {})

{bw_essentials_core-0.0.7.dist-info → bw_essentials_core-0.0.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bw-essentials-core
-Version: 0.0.7
+Version: 0.0.9
 Summary: Reusable utilities for S3, email, Data Loch, Microsoft Teams Notifications and more.
 Author: InvestorAI
 Author-email: support+tech@investorai.in

{bw_essentials_core-0.0.7.dist-info → bw_essentials_core-0.0.9.dist-info}/RECORD

@@ -13,13 +13,13 @@ bw_essentials/s3_utils/s3_utils.py,sha256=wzjVrTX22_8PMX86svKFYGMZwgjBHbOaeEsxO-
 bw_essentials/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 bw_essentials/services/api_client.py,sha256=74tKxhY_HiVCN3kgtk27a4GNznMaRphAspt9CWecuiY,7793
 bw_essentials/services/broker.py,sha256=As-VT1MxkCD9p-13dQJDwf0_aEJVA6H0wNqL-EYHO4g,8718
-bw_essentials/services/market_pricer.py,sha256=WAFcG5JfnqWxjzXRPrMdovPuKqWJIwa3ENvGAyEyjeM,8712
-bw_essentials/services/master_data.py,sha256=JpI7HfyN2hgkr9Mdcm4DzddSwmAv6AvsUmAuyrW0LYo,10828
+bw_essentials/services/market_pricer.py,sha256=Qc9lxzAjhefAvjyEKsBPDu60bF6_61cnSpZNfjGMyDg,11755
+bw_essentials/services/master_data.py,sha256=2o_r2gdhIKBeTFgn5IIY-becgCEpYBymO4BKmixdV1g,11987
 bw_essentials/services/model_portfolio_reporting.py,sha256=iOtm4gyfU8P7C0R1gp6gUJI4ZRxJD5K2GLOalI_gToM,3249
 bw_essentials/services/trade_placement.py,sha256=PrzeU2XXC9HF1IQ1dMDM_ZHxmC491sOl-JbA6GWPwII,20772
 bw_essentials/services/user_portfolio.py,sha256=_5M6yPfQt4MXedINBawEoPkb_o7IGzxPeHkvZkoQm8k,16191
 bw_essentials/services/user_portfolio_reporting.py,sha256=QaZzcw912Uos5ZafEaxLXDmCyetTFiVX3at3cTAv6MA,6003
-bw_essentials_core-0.0.7.dist-info/METADATA,sha256=6nghqDj90cybbLd3LiSk_Ws3vVYydKFocJ0fgeZriGI,7501
-bw_essentials_core-0.0.7.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
-bw_essentials_core-0.0.7.dist-info/top_level.txt,sha256=gDc5T_y5snwKGXDQUusEus-FEt0RFwG644Yn_58wQOQ,14
-bw_essentials_core-0.0.7.dist-info/RECORD,,
+bw_essentials_core-0.0.9.dist-info/METADATA,sha256=NZGAHCPsiUsVhqn8lQnMqdbHSQfTLb0SU_txe_t75B8,7501
+bw_essentials_core-0.0.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+bw_essentials_core-0.0.9.dist-info/top_level.txt,sha256=gDc5T_y5snwKGXDQUusEus-FEt0RFwG644Yn_58wQOQ,14
+bw_essentials_core-0.0.9.dist-info/RECORD,,

{bw_essentials_core-0.0.7.dist-info → bw_essentials_core-0.0.9.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.8.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any