hawk-sdk 0.0.6__py3-none-any.whl → 0.0.8__py3-none-any.whl

hawk_sdk/api/__init__.py

@@ -1,2 +1,3 @@
 from hawk_sdk.api.futures.main import Futures
+from hawk_sdk.api.equities.main import Equities
 from hawk_sdk.api.system.main import System

hawk_sdk/api/equities/__init__.py

@@ -0,0 +1 @@
+from hawk_sdk.api.futures.main import Futures

hawk_sdk/api/equities/main.py

@@ -0,0 +1,32 @@
+"""
+@description: Datasource API for Equities data access and export functions.
+@author: Rithwik Babu
+"""
+from typing import List
+
+from hawk_sdk.api.equities.repository import EquitiesRepository
+from hawk_sdk.api.equities.service import EquitiesService
+from hawk_sdk.core.common.data_object import DataObject
+
+
+class Equities:
+    """Datasource API for fetching Futures data."""
+
+    def __init__(self, environment="production") -> None:
+        """Initializes the Equities datasource with required configurations."""
+        self.repository = EquitiesRepository(environment=environment)
+        self.service = EquitiesService(self.repository)
+
+    def get_adjusted_ohlc(self, start_date: str, end_date: str, interval: str, hawk_ids: List[int]) -> DataObject:
+        """Fetch open, high, low, close data for the given date range and hawk_ids.
+
+        :param start_date: The start date for the data query (YYYY-MM-DD).
+        :param end_date: The end date for the data query (YYYY-MM-DD).
+        :param interval: The interval for the data query (e.g., '1d', '1h', '1m').
+        :param hawk_ids: A list of specific hawk_ids to filter by.
+        :return: A hawk DataObject containing the data.
+        """
+        return DataObject(
+            name="adjusted_equities_ohlcv",
+            data=self.service.get_adjusted_ohlc(start_date, end_date, interval, hawk_ids)
+        )

hawk_sdk/api/equities/repository.py

@@ -0,0 +1,80 @@
+"""
+@description: Repository layer for fetching Equities data from BigQuery.
+@author: Rithwik Babu
+"""
+import logging
+from typing import Iterator, List
+
+from google.cloud import bigquery
+
+from hawk_sdk.core.common.utils import get_bigquery_client
+
+
+class EquitiesRepository:
+    """Repository for accessing Equities raw data."""
+
+    def __init__(self, environment: str) -> None:
+        """Initializes the repository with a BigQuery client.
+
+        :param environment: The environment to fetch data from (e.g., 'production', 'development').
+        """
+        self.bq_client = get_bigquery_client()
+        self.environment = environment
+
+    def fetch_adjusted_ohlc(self, start_date: str, end_date: str, interval: str, hawk_ids: List[int]) -> Iterator[dict]:
+        """Fetches raw adjusted OHLC data from BigQuery for the given date range and hawk_ids using query parameters."""
+        query = f"""
+        WITH records_data AS (
+          SELECT 
+            r.record_timestamp AS date,
+            hi.value AS ticker,
+            MAX(CASE WHEN f.field_name = @open_field THEN r.double_value END) AS open,
+            MAX(CASE WHEN f.field_name = @high_field THEN r.double_value END) AS high,
+            MAX(CASE WHEN f.field_name = @low_field THEN r.double_value END) AS low,
+            MAX(CASE WHEN f.field_name = @close_field THEN r.double_value END) AS close
+          FROM 
+            `wsb-hc-qasap-ae2e.{self.environment}.records` AS r
+          JOIN 
+            `wsb-hc-qasap-ae2e.{self.environment}.fields` AS f
+            ON r.field_id = f.field_id
+          JOIN 
+            `wsb-hc-qasap-ae2e.{self.environment}.hawk_identifiers` AS hi
+            ON r.hawk_id = hi.hawk_id
+          WHERE 
+            r.hawk_id IN UNNEST(@hawk_ids)
+            AND f.field_name IN (@open_field, @high_field, @low_field, @close_field)
+            AND r.record_timestamp BETWEEN @start_date AND @end_date
+          GROUP BY 
+            date, ticker
+        )
+        SELECT DISTINCT
+          date,
+          ticker,
+          open,
+          high,
+          low,
+          close,
+        FROM 
+          records_data
+        ORDER BY 
+          date;
+        """
+
+        query_params = [
+            bigquery.ArrayQueryParameter("hawk_ids", "INT64", hawk_ids),
+            bigquery.ScalarQueryParameter("start_date", "STRING", start_date),
+            bigquery.ScalarQueryParameter("end_date", "STRING", end_date),
+            bigquery.ScalarQueryParameter("open_field", "STRING", f"adjusted_open_{interval}"),
+            bigquery.ScalarQueryParameter("high_field", "STRING", f"adjusted_high_{interval}"),
+            bigquery.ScalarQueryParameter("low_field", "STRING", f"adjusted_low_{interval}"),
+            bigquery.ScalarQueryParameter("close_field", "STRING", f"adjusted_close_{interval}")
+        ]
+
+        job_config = bigquery.QueryJobConfig(query_parameters=query_params)
+
+        try:
+            query_job = self.bq_client.query(query, job_config=job_config)
+            return query_job.result()
+        except Exception as e:
+            logging.error(f"Failed to fetch OHLC data: {e}")
+            raise

hawk_sdk/api/equities/service.py

@@ -0,0 +1,41 @@
+"""
+@description: Service layer for processing and normalizing Equities data.
+@author: Rithwik Babu
+"""
+from typing import List, Iterator
+
+import pandas as pd
+
+from hawk_sdk.api.equities.repository import EquitiesRepository
+
+
+class EquitiesService:
+    """Service class for Futures business logic."""
+
+    def __init__(self, repository: EquitiesRepository) -> None:
+        """Initializes the service with a repository.
+
+        :param repository: An instance of FuturesRepository for data access.
+        """
+        self.repository = repository
+
+    def get_adjusted_ohlc(self, start_date: str, end_date: str, interval: str, hawk_ids: List[int]) -> pd.DataFrame:
+        """Equities and normalizes data into a pandas DataFrame.
+
+        :param start_date: The start date for the data query (YYYY-MM-DD).
+        :param end_date: The end date for the data query (YYYY-MM-DD).
+        :param interval: The interval for the data query (e.g., '1d', '1h', '1m').
+        :param hawk_ids: A list of specific hawk_ids to filter by.
+        :return: A pandas DataFrame containing the normalized data.
+        """
+        raw_data = self.repository.fetch_adjusted_ohlc(start_date, end_date, interval, hawk_ids)
+        return self._normalize_data(raw_data)
+
+    @staticmethod
+    def _normalize_data(data: Iterator[dict]) -> pd.DataFrame:
+        """Converts raw data into a normalized pandas DataFrame.
+
+        :param data: An iterator over raw data rows.
+        :return: A pandas DataFrame containing normalized data.
+        """
+        return pd.DataFrame([dict(row) for row in data])

hawk_sdk/api/futures/main.py

@@ -4,12 +4,9 @@
 """
 from typing import List
 
-from google.cloud import bigquery
-
-from hawk_sdk.core.common.constants import PROJECT_ID
-from hawk_sdk.core.common.data_object import DataObject
 from hawk_sdk.api.futures.repository import FuturesRepository
 from hawk_sdk.api.futures.service import FuturesService
+from hawk_sdk.core.common.data_object import DataObject
 
 
 class Futures:
@@ -17,8 +14,7 @@ class Futures:
 
     def __init__(self, environment="production") -> None:
         """Initializes the Futures datasource with required configurations."""
-        self.connector = bigquery.Client(project=PROJECT_ID)
-        self.repository = FuturesRepository(self.connector, environment=environment)
+        self.repository = FuturesRepository(environment=environment)
         self.service = FuturesService(self.repository)
 
     def get_ohlcvo(self, start_date: str, end_date: str, interval: str, hawk_ids: List[int]) -> DataObject:
@@ -45,4 +41,4 @@ class Futures:
         return DataObject(
             name="futures_snapshot",
             data=self.service.get_snapshot(timestamp, hawk_ids)
-        )
+        )

hawk_sdk/api/futures/repository.py

@@ -6,19 +6,19 @@ import logging
 from typing import Iterator, List
 
 from google.cloud import bigquery
-from google.cloud.bigquery import Client
+
+from hawk_sdk.core.common.utils import get_bigquery_client
 
 
 class FuturesRepository:
     """Repository for accessing Futures raw data."""
 
-    def __init__(self, bq_client: Client, environment: str) -> None:
+    def __init__(self, environment: str) -> None:
         """Initializes the repository with a BigQuery client.
 
-        :param bq_client: An instance of BigQuery Client.
         :param environment: The environment to fetch data from (e.g., 'production', 'development').
         """
-        self.bq_client = bq_client
+        self.bq_client = get_bigquery_client()
         self.environment = environment
 
     def fetch_ohlcvo(self, start_date: str, end_date: str, interval: str, hawk_ids: List[int]) -> Iterator[dict]:

hawk_sdk/api/system/main.py

@@ -4,12 +4,9 @@
 """
 from typing import List
 
-from google.cloud import bigquery
-
-from hawk_sdk.core.common.constants import PROJECT_ID
-from hawk_sdk.core.common.data_object import DataObject
 from hawk_sdk.api.system.repository import SystemRepository
 from hawk_sdk.api.system.service import SystemService
+from hawk_sdk.core.common.data_object import DataObject
 
 
 class System:
@@ -17,8 +14,7 @@ class System:
 
     def __init__(self, environment="production") -> None:
         """Initializes the System datasource with required configurations."""
-        self.connector = bigquery.Client(project=PROJECT_ID)
-        self.repository = SystemRepository(self.connector, environment=environment)
+        self.repository = SystemRepository(environment=environment)
         self.service = SystemService(self.repository)
 
     def get_hawk_ids(self, tickers: List[str]) -> DataObject:

hawk_sdk/api/system/repository.py

@@ -6,19 +6,20 @@ import logging
 from typing import Iterator, List
 
 from google.cloud import bigquery
-from google.cloud.bigquery import Client
+
+from hawk_sdk.core.common.utils import get_bigquery_client
 
 
 class SystemRepository:
     """Repository for accessing System data."""
 
-    def __init__(self, bq_client: Client, environment: str) -> None:
+    def __init__(self, environment: str) -> None:
         """Initializes the repository with a BigQuery client.
 
         :param bq_client: An instance of BigQuery Client.
         :param environment: The environment to fetch data from (e.g., 'production', 'development').
         """
-        self.bq_client = bq_client
+        self.bq_client = get_bigquery_client()
         self.environment = environment
 
     def fetch_hawk_ids(self, tickers: List[str]) -> Iterator[dict]:

hawk_sdk/core/common/utils.py

@@ -0,0 +1,21 @@
+import json
+import os
+
+from google.cloud import bigquery
+from google.oauth2 import service_account
+
+from hawk_sdk.core.common.constants import PROJECT_ID
+
+
+def get_bigquery_client() -> bigquery.Client:
+    if 'GOOGLE_APPLICATION_CREDENTIALS' in os.environ:
+        # Initialize the client using the json file in the environment variable
+        return bigquery.Client(project=PROJECT_ID)
+
+    else:
+        # Load the service account credentials from the JSON string
+        service_account_json = os.environ.get('SERVICE_ACCOUNT_JSON')
+        credentials = service_account.Credentials.from_service_account_info(
+            json.loads(service_account_json)
+        )
+        return bigquery.Client(project=PROJECT_ID, credentials=credentials)

{hawk_sdk-0.0.6.dist-info → hawk_sdk-0.0.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hawk-sdk
-Version: 0.0.6
+Version: 0.0.8
 Requires-Dist: google-cloud-bigquery
 Requires-Dist: pandas
 

hawk_sdk-0.0.8.dist-info/RECORD

@@ -0,0 +1,24 @@
+hawk_sdk/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hawk_sdk/api/__init__.py,sha256=kraovUX7vWIb9tgl5eJbA9jnp77QpoqZYHLvmz0hNrg,138
+hawk_sdk/api/equities/__init__.py,sha256=9mL1L6wlZKXTvMrTuQV35Fl9kTy4qjf3RIJzYBXcpeM,46
+hawk_sdk/api/equities/main.py,sha256=EeC-h0GKAOYZT9Q2BulO4_NxX1Me-dMgC0yT6y7_Mi0,1380
+hawk_sdk/api/equities/repository.py,sha256=oOboCi1w9e95_KK80mfEsojpUqKeT2HJKyBButUbi8Y,3133
+hawk_sdk/api/equities/service.py,sha256=4t8hcAd7D2cDFxTdiGZzWEnpWdeeP7FwibJLlRHhOKo,1584
+hawk_sdk/api/futures/__init__.py,sha256=9mL1L6wlZKXTvMrTuQV35Fl9kTy4qjf3RIJzYBXcpeM,46
+hawk_sdk/api/futures/main.py,sha256=XNihiVb75wyPx78dOzEVWhQ6vmN-NLHZTk4L7zY-4WQ,1909
+hawk_sdk/api/futures/repository.py,sha256=P6dsLJe8hQ2-hkDX_pa-VRoUUXaU-uBhA4S5mwK79_o,5983
+hawk_sdk/api/futures/service.py,sha256=0zJn3xJNoHgEOeVVpIF2i0r5g8mvf4y1K_YnvHDF5mU,2078
+hawk_sdk/api/system/__init__.py,sha256=Oy8XUp5WHx4fczjZXzfbkkHluHW-t7BLN4IgrOG6Pk4,44
+hawk_sdk/api/system/main.py,sha256=t2zWeEHSTYuWZAsqCMLt_CyRWoN8T8N6oEVshPgf6kk,1025
+hawk_sdk/api/system/repository.py,sha256=IllwoWXZyi46INuCRQeibHJaMDR1TfbT6l2uAhii2Xc,1654
+hawk_sdk/api/system/service.py,sha256=LOZIfrEBKynJlj8V-4UM4abzVV9ogwUVxM7s2xFXlpo,1262
+hawk_sdk/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hawk_sdk/core/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hawk_sdk/core/common/base_enum.py,sha256=ZgC8gZjTzsoJzzdgN2DjYk3dVL_uM2Stuaky5bo6GuQ,267
+hawk_sdk/core/common/constants.py,sha256=KmsNfRVCwGeXEBHfo3TzSaDYJDMtnL-YEQKsO1DnWV8,33
+hawk_sdk/core/common/data_object.py,sha256=f4YO415Zz-lm3QYJQ3sJ4ugH9ZX9Dc7T-JvO4IdeyOw,1073
+hawk_sdk/core/common/utils.py,sha256=bxF-iJzbqXGYtQKElH6k5-bSsdcvft0o51G9slZ1grI,745
+hawk_sdk-0.0.8.dist-info/METADATA,sha256=pngW5cV78C_9x-0_8PUZsAIXzZwXW6TdUjuAJF0XQpE,112
+hawk_sdk-0.0.8.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
+hawk_sdk-0.0.8.dist-info/top_level.txt,sha256=aSjbudHcWSYsKXH9Wg0L1ltJfDOHXzjYFPO3v3cP-SE,9
+hawk_sdk-0.0.8.dist-info/RECORD,,

hawk_sdk-0.0.6.dist-info/RECORD

@@ -1,19 +0,0 @@
-hawk_sdk/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hawk_sdk/api/__init__.py,sha256=BD8XgbQ2o4EIzECUu4h6g-9jzpg--BiT6brrnyO4Puc,90
-hawk_sdk/api/futures/__init__.py,sha256=9mL1L6wlZKXTvMrTuQV35Fl9kTy4qjf3RIJzYBXcpeM,46
-hawk_sdk/api/futures/main.py,sha256=aJ08ohKTIOSa8wQIb_ddos4yRlsX6Z16V2aNilRXlrc,2074
-hawk_sdk/api/futures/repository.py,sha256=MI61N4EfRFDM0SOzaW9M7EWT2uHkWGFY-DTTfHx0lLw,6029
-hawk_sdk/api/futures/service.py,sha256=0zJn3xJNoHgEOeVVpIF2i0r5g8mvf4y1K_YnvHDF5mU,2078
-hawk_sdk/api/system/__init__.py,sha256=Oy8XUp5WHx4fczjZXzfbkkHluHW-t7BLN4IgrOG6Pk4,44
-hawk_sdk/api/system/main.py,sha256=FdpXaHp5yPFi17M1-1v4LU9vnwywkdYeOelps1hnKr0,1191
-hawk_sdk/api/system/repository.py,sha256=3CfFjNVC0X09TKLh9sfwd5HxeLcb49MRCbvb3Su2Wnk,1642
-hawk_sdk/api/system/service.py,sha256=LOZIfrEBKynJlj8V-4UM4abzVV9ogwUVxM7s2xFXlpo,1262
-hawk_sdk/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hawk_sdk/core/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hawk_sdk/core/common/base_enum.py,sha256=ZgC8gZjTzsoJzzdgN2DjYk3dVL_uM2Stuaky5bo6GuQ,267
-hawk_sdk/core/common/constants.py,sha256=KmsNfRVCwGeXEBHfo3TzSaDYJDMtnL-YEQKsO1DnWV8,33
-hawk_sdk/core/common/data_object.py,sha256=f4YO415Zz-lm3QYJQ3sJ4ugH9ZX9Dc7T-JvO4IdeyOw,1073
-hawk_sdk-0.0.6.dist-info/METADATA,sha256=k77ZeTkssmZJ7J-k9QlZYfP8jxDlmKmyoZfBzHfun6k,112
-hawk_sdk-0.0.6.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
-hawk_sdk-0.0.6.dist-info/top_level.txt,sha256=aSjbudHcWSYsKXH9Wg0L1ltJfDOHXzjYFPO3v3cP-SE,9
-hawk_sdk-0.0.6.dist-info/RECORD,,