neurostats-API 1.0.1rc1__tar.gz → 1.0.2rc1__tar.gz

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: neurostats_API
-Version: 1.0.1rc1
+Version: 1.0.2rc1
 Summary: The service of NeuroStats website
 Home-page: https://github.com/NeurowattStats/NeuroStats_API.git
 Author: JasonWang@Neurowatt
@@ -71,7 +71,7 @@ pip install neurostats-API
 ```Python 
 >>> import neurostats_API
 >>> print(neurostats_API.__version__)
-1.0.0
+1.0.2rc1
 ```
 
 ### 下載舊版

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/README.md

@@ -54,7 +54,7 @@ pip install neurostats-API
 ```Python 
 >>> import neurostats_API
 >>> print(neurostats_API.__version__)
-1.0.0
+1.0.2rc1
 ```
 
 ### 下載舊版

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/neurostats_API/__init__.py

@@ -1,4 +1,4 @@
-__version__='1.0.0'
+__version__='1.0.2rc1'
 
 from .fetchers import (
     AgentFinanceOverviewFetcher,
@@ -25,5 +25,6 @@ from .async_mode import (
     AsyncTEJSeasonalFetcher,
     AsyncTWSEInstitutionFetcher,
     AsyncTWSEMarginFetcher,
-    AsyncTWSEStatsValueFetcher
+    AsyncTWSEStatsValueFetcher,
+    AsyncUSCelebrityFetcher
 )

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/neurostats_API/async_mode/__init__.py

@@ -9,5 +9,6 @@ from .fetchers import (
     AsyncTEJSeasonalFetcher,
     AsyncTWSEInstitutionFetcher,
     AsyncTWSEMarginFetcher,
-    AsyncTWSEStatsValueFetcher
+    AsyncTWSEStatsValueFetcher,
+    AsyncUSCelebrityFetcher
 )

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/neurostats_API/async_mode/db_extractors/__init__.py

@@ -4,8 +4,8 @@ from .daily import (
     AsyncDailyValueDBExtractor,
     AsyncTEJDailyValueDBExtractor,
     AsyncTWSEChipDBExtractor,
-    AsyncUS_F13DBExtractor
-
+    AsyncUS_F13DBExtractor,
+    AsyncUS_CelebrityDBExtractor
 )
 
 from .month_revenue import (

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/neurostats_API/async_mode/db_extractors/daily/__init__.py

@@ -4,5 +4,5 @@ from .value import (
     AsyncDailyValueDBExtractor, 
     AsyncTEJDailyValueDBExtractor
 )
-from .us_chip import AsyncUS_F13DBExtractor
+from .us_chip import AsyncUS_F13DBExtractor, AsyncUS_CelebrityDBExtractor
 from .yf import AsyncYFDailyTechDBExtractor

neurostats_api-1.0.2rc1/neurostats_API/async_mode/db_extractors/daily/us_chip.py

@@ -0,0 +1,132 @@
+from datetime import datetime, timedelta
+from pymongo import ASCENDING, DESCENDING
+from .base import BaseDailyTechDBExtractor
+from neurostats_API.utils import (
+    NotSupportedError, StatsProcessor
+)
+from pymongo import AsyncMongoClient
+
+class AsyncUS_F13DBExtractor(BaseDailyTechDBExtractor):
+
+    def __init__(self, ticker, client, managerTicker=None):
+        """
+        ticker: Issuer Ticker, 被持有的股票代碼
+        managerTicker: 持有者的股票代碼
+        """
+        super().__init__(ticker, client)
+        self.issuerTicker = ticker
+        self.managerTicker = managerTicker
+
+        if (self.get_zone() not in ['us']):
+            raise NotSupportedError("Supports US Company Only")
+
+    def _get_collection_name(self):
+        self.collection_name_map = {"us": "us_F13"}
+
+        return self.collection_name_map.get(self.zone, None)
+
+    def _prepare_query(self, start_date=None, end_date=None, get_latest=False):
+        query = {"issuerTicker": self.issuerTicker}
+
+        if (self.managerTicker):
+            query.update(
+                {
+                    "managerTicker": self.managerTicker
+                }
+            )
+
+        query = self._update_query_with_date(query, start_date, end_date)
+
+        projection = {
+            "_id": 0,
+        }
+
+        if (get_latest):
+            sort = [("reportDate", DESCENDING)]
+        else:
+            sort = [("reportDate", ASCENDING)]
+
+        return query, projection, sort
+
+    def _update_query_with_date(self, query, start_date, end_date):
+        start_date = self._transform_date(start_date)
+        end_date = self._transform_date(end_date)
+
+        date_range = {"$gte": start_date, "$lte": end_date}
+
+        query.update({"reportDate": date_range})
+
+        return query
+
+    async def query_data(
+        self, start_date=None, end_date=None, get_latest=False
+    ):
+        result = await super().query_data(start_date, end_date, get_latest)
+
+        return result
+
+class AsyncUS_CelebrityDBExtractor(AsyncUS_F13DBExtractor):
+    """        
+    用於查詢美國名人持股的專用extractor
+    """
+    def __init__(self, client:AsyncMongoClient, manager_name=None):
+        """
+        manager_name: 名人名稱
+        """
+        self.client = client
+        self.zone = "us"
+        self.manager = manager_name
+        self.collection_name_map = {"us": "us_F13"}
+        self.collection = self.client.get_database("company_us").get_collection("us_F13")
+    
+
+    def _get_collection_name(self):
+
+        return self.collection_name_map.get(self.zone, None)
+    
+    def _prepare_query(
+            self, start_date=None, end_date=None, get_latest=False,
+            value_throshold=None, title=None
+        ):
+
+        start_date = self._transform_date(start_date)
+        end_date = self._transform_date(end_date)
+
+        query = {
+            "manager": self.manager,
+            "reportDate": {"$gte": start_date, "$lte": end_date}
+        }
+
+        if value_throshold:
+            query["value"] = {"$gt": value_throshold}
+
+        if title:
+            query["titleOfClass"] = title
+
+        projection = {"_id": 0}
+
+        if (get_latest):
+            sort = [("reportDate", DESCENDING)]
+        else:
+            sort = [("reportDate", ASCENDING)]
+
+        return query, projection, sort
+    
+    async def query_data(
+        self, start_date=None, end_date=None, get_latest=False,
+        value_throshold=None, title=None
+    ):
+        query, projection, sort = self._prepare_query(
+            start_date=start_date, end_date=end_date, get_latest=get_latest,
+            value_throshold=value_throshold, title=title
+        )
+
+        if (get_latest):
+            cursor = self.collection.find(query, projection).sort(sort).limit(1)
+        else:
+            cursor = self.collection.find(query, projection).sort(sort)
+
+        fetched_data = [data async for data in cursor]
+
+        return fetched_data
+    

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/neurostats_API/async_mode/fetchers/__init__.py

@@ -8,4 +8,4 @@ from .month_revenue import AsyncMonthlyRevenueFetcher
 from .profit_lose import AsyncProfitLoseFetcher
 from .value import AsyncTWSEStatsValueFetcher
 from .tej import AsyncTEJDailyTechFetcher, AsyncTEJSeasonalFetcher
-from .us_chip import AsyncUSChipF13Fetcher
+from .us_chip import AsyncUSChipF13Fetcher, AsyncUSCelebrityFetcher

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/neurostats_API/async_mode/fetchers/us_chip.py

@@ -1,9 +1,9 @@
 from .base import AsyncBaseFetcher
 from ..db_extractors import (
-    AsyncDailyValueDBExtractor, AsyncTEJDailyValueDBExtractor
+    AsyncDailyValueDBExtractor, AsyncTEJDailyValueDBExtractor, AsyncUS_CelebrityDBExtractor
 )
 from neurostats_API.async_mode.factory import get_extractor
-from neurostats_API.transformers import US_F13_Transformer
+from neurostats_API.transformers import US_F13_Transformer, US_CelebrityTransformer
 from neurostats_API.utils import NotSupportedError
 
 
@@ -44,3 +44,26 @@ class AsyncUSChipF13Fetcher(AsyncBaseFetcher):
         )
 
         return transformed_data
+
+class AsyncUSCelebrityFetcher(AsyncBaseFetcher):
+
+    def __init__(self, client, manager_name):
+        self.manager_name = manager_name
+        self.extractor = AsyncUS_CelebrityDBExtractor(client, manager_name)
+        self.transformer = US_CelebrityTransformer()
+
+    async def query_data(
+        self, start_date=None, end_date=None, get_latest=False,
+        value_threshold=None, title=None, strftime=None
+    ):
+        fetched_data = await self.extractor.query_data(
+            start_date, end_date, get_latest,
+            value_throshold=value_threshold, title=title
+        )
+
+        transformed_data = self.transformer.process_transform(
+            fetched_datas = list(fetched_data),
+            strftime = strftime
+        )
+
+        return transformed_data

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/neurostats_API/transformers/__init__.py

@@ -14,7 +14,8 @@ from .daily_tech import(
 
 from .daily_chip import(
     TWSEChipTransformer,
-    US_F13_Transformer
+    US_F13_Transformer,
+    US_CelebrityTransformer
 )
 
 from .month_revenue import(

neurostats_api-1.0.2rc1/neurostats_API/transformers/daily_chip/__init__.py

@@ -0,0 +1,2 @@
+from .twse_chip import TWSEChipTransformer
+from .us import US_F13_Transformer, US_CelebrityTransformer

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/neurostats_API/transformers/daily_chip/us.py

@@ -4,6 +4,8 @@ import inspect
 import numpy as np
 import pandas as pd
 from neurostats_API.utils import StatsProcessor
+from collections import defaultdict
+from typing import List, Optional, Union
 
 class US_F13_Transformer(BaseChipTransformer):
     def __init__(self, ticker, company_name, zone):
@@ -37,4 +39,27 @@ class US_F13_Transformer(BaseChipTransformer):
 
         return return_dict
 
-        
+class US_CelebrityTransformer():
+
+    def __init__(self):
+        pass
+
+    def process_transform(
+        self,
+        fetched_datas: List[dict],
+        strftime: Optional[str] = None
+    ) -> dict[str, dict[Union[str, datetime], float]]:
+        
+        result = defaultdict(lambda: defaultdict(dict))
+
+        for record in fetched_datas:
+            ticker = record.get("issuerTicker")
+            report_date = record.get("reportDate")
+            value = record.get("value")
+            title = record.get("titleOfClass")
+
+            if ticker and report_date and title:
+                key = report_date.strftime(strftime) if strftime else report_date
+                result.setdefault(ticker, {}).setdefault(title, {})[key] = value
+
+        return dict(result)

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/neurostats_API.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: neurostats_API
-Version: 1.0.1rc1
+Version: 1.0.2rc1
 Summary: The service of NeuroStats website
 Home-page: https://github.com/NeurowattStats/NeuroStats_API.git
 Author: JasonWang@Neurowatt
@@ -71,7 +71,7 @@ pip install neurostats-API
 ```Python 
 >>> import neurostats_API
 >>> print(neurostats_API.__version__)
-1.0.0
+1.0.2rc1
 ```
 
 ### 下載舊版

{neurostats_api-1.0.1rc1 → neurostats_api-1.0.2rc1}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='neurostats_API',
-    version='1.0.1rc1',
+    version='1.0.2rc1',
     long_description=open('README.md', 'r', encoding='utf-8').read(),
     long_description_content_type='text/markdown',
     install_requires=[

neurostats_api-1.0.1rc1/neurostats_API/async_mode/db_extractors/daily/us_chip.py

@@ -1,66 +0,0 @@
-from datetime import datetime, timedelta
-from pymongo import ASCENDING, DESCENDING
-from .base import BaseDailyTechDBExtractor
-from neurostats_API.utils import (
-    NotSupportedError, StatsProcessor
-)
-
-
-class AsyncUS_F13DBExtractor(BaseDailyTechDBExtractor):
-
-    def __init__(self, ticker, client, managerTicker=None):
-        """
-        ticker: Issuer Ticker, 被持有的股票代碼
-        managerTicker: 持有者的股票代碼
-        """
-        super().__init__(ticker, client)
-        self.issuerTicker = ticker
-        self.managerTicker = managerTicker
-
-        if (self.get_zone() not in ['us']):
-            raise NotSupportedError("Supports US Company Only")
-
-    def _get_collection_name(self):
-        self.collection_name_map = {"us": "us_F13"}
-
-        return self.collection_name_map.get(self.zone, None)
-
-    def _prepare_query(self, start_date=None, end_date=None, get_latest=False):
-        query = {"issuerTicker": self.issuerTicker}
-
-        if (self.managerTicker):
-            query.update(
-                {
-                    "managerTicker": self.managerTicker
-                }
-            )
-
-        query = self._update_query_with_date(query, start_date, end_date)
-
-        projection = {
-            "_id": 0,
-        }
-
-        if (get_latest):
-            sort = [("reportDate", DESCENDING)]
-        else:
-            sort = [("reportDate", ASCENDING)]
-
-        return query, projection, sort
-
-    def _update_query_with_date(self, query, start_date, end_date):
-        start_date = self._transform_date(start_date)
-        end_date = self._transform_date(end_date)
-
-        date_range = {"$gte": start_date, "$lte": end_date}
-
-        query.update({"reportDate": date_range})
-
-        return query
-
-    async def query_data(
-        self, start_date=None, end_date=None, get_latest=False
-    ):
-        result = await super().query_data(start_date, end_date, get_latest)
-
-        return result

neurostats_api-1.0.1rc1/neurostats_API/transformers/daily_chip/__init__.py

@@ -1,2 +0,0 @@
-from .twse_chip import TWSEChipTransformer
-from .us import US_F13_Transformer