neurostats-API 0.0.21b0__py3-none-any.whl → 0.0.23__py3-none-any.whl

neurostats_API/tools/tej_db/tej_db_percent_index.yaml

@@ -29,9 +29,6 @@ TWN/AINVFQ1:
 - r607
 - r613
 - r612
-- r609
-- r614
-- r611
 TWN/AFESTM1:
 - r105
 - r106

neurostats_API/tools/tej_db/tej_db_skip_index.yaml

@@ -8,6 +8,14 @@ TWN/AINVFQ1:
 - curr
 - annd
 - fin_ind
+- eps
+- r307
+- r305
+- r306
+- r316
+- r609
+- r614
+- r611
 TWN/AFESTM1:
 - coid
 - mdate
@@ -17,4 +25,9 @@ TWN/AFESTM1:
 - merg
 - curr
 - annd
-- fin_ind
+- fin_ind
+- eps
+- r307
+- r305
+- r306
+- r316

neurostats_API/tools/tej_db/tej_db_thousand_index.yaml

@@ -42,7 +42,6 @@ TWN/AINVFQ1:
 - isibt
 - isni
 - isnip
-- eps
 - ispsd
 - gm
 - opi
@@ -57,10 +56,6 @@ TWN/AINVFQ1:
 - person
 - shares
 - wavg
-- r304
-- r305
-- r306
-- r316
 - r834
 TWN/AFESTM1:
 - ip12

neurostats_API/utils/__init__.py

@@ -1,5 +1,4 @@
 from .datetime import StatsDateTime
 from .db_client import DBClient
 from .data_process import StatsProcessor
-from .fetcher import StatsFetcher
 from .calculate_value import YoY_Calculator

neurostats_API/utils/calculate_value.py

@@ -1,3 +1,5 @@
+from .data_process import StatsProcessor
+import numpy as np
 class YoY_Calculator:
     def __init__(self):
         pass
@@ -22,5 +24,104 @@ class YoY_Calculator:
 
         if (isinstance(YoY, complex)): # 年化成長率有複數問題
             return None
+        
+        if YoY != YoY:  # 確認是否為nan (Python 中 nan不等於自己)
+            return None
+
+        return YoY
+    @classmethod
+    def calculate_growth(cls, this_value, last_value, delta):
+        try:
+            return YoY_Calculator.cal_growth(
+                this_value, last_value, delta
+            ) * 100
+        except Exception:
+            return None
+
+    @classmethod
+    def cal_YoY(
+        cls, data_dict: dict
+    ):
+        year_shifts = [1, 3, 5, 10]
+        return_dict = {}
+
+        for time_index in data_dict.keys():
+            year, season = map(int, time_index.split("Q"))
+            
+            year_data = data_dict.get(f"{year}Q{season}", {}).copy()
+            if not year_data:
+                continue
+
+            for key, data in list(year_data.items()):
+                if key in ["year", "season"]:
+                    continue
+                
+                if (isinstance(data, dict)):
+                    temp_dict = data
+                    value = data.get("value", None)
+                else:
+                    temp_dict = {"value": data}
+                    value = data
+
+                this_value = StatsProcessor.process_str_to_float(value)
+                
+                for shift in year_shifts:
+                    past_value = data_dict.get(f"{year - shift}Q{season}", {}).get(key, {})
+                    if (isinstance(past_value, dict)):
+                        past_value = past_value.get('value', None)
+                    past_value = StatsProcessor.process_str_to_float(
+                        past_value
+                    )
+
+                    growth = cls.calculate_growth(this_value, past_value, shift) if past_value else None
+
+                    temp_dict[
+                        f"YoY_{shift}"
+                    ] = f"{growth:.2f}%" if growth else None
+
+                year_data[key] = temp_dict
+            return_dict[f"{year}Q{season}"] = year_data
+        return return_dict
+    @classmethod
+    def cal_QoQ(cls, data_dict):
+        return_dict = {}
+
+        for time_index, this_data in data_dict.items():
+            year, season = map(int, time_index.split("Q"))
+            last_year, last_season = (
+                year - 1, 4
+            ) if season == 1 else (year, season - 1)
+
+            for key in list(this_data.keys()):
+                if key == "season":
+                    continue
+
+                value = this_data.get(key, None)
+
+                if (isinstance(value, dict)):
+                    temp_dict = value
+                    this_value = value.get("value", None)
+                else:
+                    temp_dict = {"value": value}
+                    this_value = value
+                
+                this_value = StatsProcessor.process_str_to_float(this_value)
+                
+                last_value = data_dict.get(
+                    f"{last_year}Q{last_season}",{}
+                ).get(key, {})
+
+                if (isinstance(last_value, dict)):
+                    last_value = last_value.get("value", None)
+
+                last_value = StatsProcessor.process_str_to_float(last_value)
+                growth = cls.calculate_growth(
+                    this_value, last_value, 1
+                ) if last_value is not None else None
+                temp_dict['growth'] = (f"{growth:.2f}%" if growth else None)
+
+                this_data[key] = temp_dict
+
+            return_dict[time_index] = this_data
 
-        return YoY
+        return return_dict

neurostats_API/utils/data_process.py

@@ -36,6 +36,14 @@ class StatsProcessor:
             data = yaml.safe_load(f)
 
         return data
+    
+    @classmethod
+    def load_json(cls, filename):
+        yaml_path = files('neurostats_API.tools').joinpath(filename)
+        with open(yaml_path, 'r', encoding='utf-8') as f:
+            data = json.load(f)
+
+        return data
 
     @classmethod
     def expand_value_percentage(cls, dataframe):
@@ -52,6 +60,23 @@ class StatsProcessor:
         expanded_df = pd.concat(expanded_columns.values(), axis=1)
 
         return expanded_df
+    
+    @classmethod
+    def slice_old_table(
+        cls,
+        total_table,
+        target_index,
+    ):
+        """
+        對舊格式的轉換
+        對只有單層column的table，切出想要的index
+        """
+
+        if (target_index):
+            target_index = target_index.split()
+            return total_table.loc[target_index, :]
+        else:
+            return total_table
 
     @classmethod
     def slice_table(
@@ -61,30 +86,24 @@ class StatsProcessor:
             target_index=None,  # None or Str， 要特別抓哪個index
     ):
         """
-        total_table: column應為 <時間>_<單位>
-        對只有單層column的table，切出想要的index
+        total_table: column應為 <時間>_<季>
         """
-        times = [
-            column.split("_")[0] for column in total_table.columns.unique()
-        ]  #取出timeIndex
         try:
             target_metrics = target_metric_dict[mode]
         except KeyError as e:
-            return f"mode Error: Get mode should be {list(target_metric_dict.keys())} but get {mode}"
-
-        desired_order = [
-            f"{time}_{value_name}" for time in times
-            for value_name in target_metrics
-        ]
+            raise ValueError(f"mode Error: Get mode should be {list(target_metric_dict.keys())} but get {mode}")
 
         if (target_index):
-            target_index = target_index.split()
-            sliced_table = total_table.loc[target_index, desired_order].T
+            target_index = [index_name.strip() for index_name in target_index.split()]
+            desired_order = []
+            for index_name in target_index:
+                desired_order += [f"{index_name}_{metric_name}" for metric_name in target_metrics]
+            sliced_table = total_table.loc[desired_order, :].T
 
             return sliced_table.T
 
         else:
-            return total_table.loc[:, desired_order]
+            return total_table
 
     @classmethod
     def slice_multi_col_table(
@@ -172,7 +191,11 @@ class StatsProcessor:
     @classmethod
     def cal_percentage(cls, value, postfix="%"):
         if (isinstance(value, (float, int))):
+            if (np.isnan(value)):
+                return None
             value = np.round(value * 100, 2).item()
+            if (value != value): # nan值發生
+                return None
             value = f"{value:.2f}{postfix}"
 
             return value
@@ -183,10 +206,11 @@ class StatsProcessor:
     @classmethod
     def cal_non_percentage(cls, value, to_str=False, postfix="元"):
         if (isinstance(value, (float, int))):
-
+            if (np.isnan(value)):
+                return None
             value = np.round(value, 2).item()
             if (postfix == "千元"):
-                value *= 1000
+                value = value * 1000
                 try:
                     value = int(value)
                 except Exception as e:
@@ -264,7 +288,7 @@ class StatsProcessor:
         if (key):
             keys = [key]
         for data in data_list:
-            data = data['data']
+            data = data.get("data")
 
             pop_keys = []
 
@@ -273,6 +297,16 @@ class StatsProcessor:
                 pop_keys.append(str(data.pop(key)))
             
             pop_key = delimeter.join(pop_keys)
-            return_dict[pop_key] = data[data_key]
+            target_data = data.get(data_key)
+            return_dict[pop_key] = target_data
         
-        return return_dict
+        return return_dict
+    
+    @classmethod
+    def process_str_to_float(cls, value):
+        if isinstance(value, str) and "%" in value:
+            value = value.replace("%", "")
+        try:
+            return float(value)
+        except (ValueError, TypeError) as e:
+            return None

neurostats_API/utils/logger.py

@@ -0,0 +1,21 @@
+import logging
+from functools import wraps
+
+class StatsLogger:
+
+    @classmethod
+    def exception_log(cls, default_return=None, level='error'):
+        def decorator(func):
+            @wraps(func)
+            def wrapper(*args, **kwargs):
+                try:
+                    return func(*args, **kwargs)
+                except Exception as e:
+                    log_fn = getattr(logging, level, logging.error)
+                    log_fn(
+                        f"{func.__name__} failed | args={args}, kwargs={kwargs} | error={e}",
+                        exc_info=True
+                    )
+                    return default_return
+            return wrapper
+        return decorator

{neurostats_API-0.0.21b0.dist-info → neurostats_API-0.0.23.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: neurostats_API
-Version: 0.0.21b0
+Version: 0.0.23
 Summary: The service of NeuroStats website
 Home-page: https://github.com/NeurowattStats/NeuroStats_API.git
 Author: JasonWang@Neurowatt
@@ -89,7 +89,7 @@ pip install neurostats-API
 ```Python 
 >>> import neurostats_API
 >>> print(neurostats_API.__version__)
-0.0.21b0
+0.0.23
 ```
 
 ### 得到最新一期的評價資料與歷年評價

neurostats_API-0.0.23.dist-info/RECORD

@@ -0,0 +1,35 @@
+neurostats_API/__init__.py,sha256=0pjIrvtZhJd0auAFx4I4qYYyZ_HkE_94paLzWPLv7E8,288
+neurostats_API/cli.py,sha256=UJSWLIw03P24p-gkBb6JSEI5dW5U12UvLf1L8HjQD-o,873
+neurostats_API/main.py,sha256=QcsfmWivg2Dnqw3MTJWiI0QvEiRs0VuH-BjwQHFCv00,677
+neurostats_API/fetchers/__init__.py,sha256=KCw-yRSDFa3fw83u73LJ9OVop7gRl_YQYlQq-cITxuo,511
+neurostats_API/fetchers/balance_sheet.py,sha256=j2bDFk_IwdNhGRy32wfVGz8Y8-S-gtyIZmT-uRNzH80,6889
+neurostats_API/fetchers/base.py,sha256=fHdZJtBZ6OD1IUbW6sUTXsPJVWrj41Ay4TOJChp2keI,7236
+neurostats_API/fetchers/cash_flow.py,sha256=7VznJBKwGyc4EBL9uB7x19zg0JRgZcNrvBAviTNns6k,7978
+neurostats_API/fetchers/finance_overview.py,sha256=xRn4UF2iMS13ztsFgBFj4UykyJsWMriuUevNeZHQR7E,27815
+neurostats_API/fetchers/institution.py,sha256=f-Z_Kd6-gnOM8bE7tqWKFnvlMGiE-pGZbsc0JCIobcU,14786
+neurostats_API/fetchers/margin_trading.py,sha256=0enMPpq0J55uts0nJFHOylXvLEMWZYSb-gt1BH5_gBM,11430
+neurostats_API/fetchers/month_revenue.py,sha256=K1WZct6vLU3y_8uaXR3po5jzx2w3EYb2v3XkIX2_pBE,8313
+neurostats_API/fetchers/profit_lose.py,sha256=M-Ngn1l6FbulRurrs2BzlrP0iAeeNF9n5TdIoDa4G_s,9164
+neurostats_API/fetchers/tech.py,sha256=TsS8m25Otc3_2jTYITFe-wNHlDWcfWsHIxhOrqL8qMY,16016
+neurostats_API/fetchers/tej_finance_report.py,sha256=NHBqs1xbJ_IuXcBluNJyoZO4BYqmFN76UW201ss3R14,11936
+neurostats_API/fetchers/value_invest.py,sha256=QxQS2GcoLIU9ZBDEo8iRK2yHd8YLmBS70Bq42F3IsSw,8295
+neurostats_API/tools/company_list/tw.json,sha256=VWaDFvd0ACCVSWItcHHpmVuM_RzP71jLZl9RBHztu-0,51332
+neurostats_API/tools/tej_db/tej_db_index.yaml,sha256=lu-cmbB6dhx0eUlBSkyzXWqPKlwRtEvqlMTAh2y0oHs,969
+neurostats_API/tools/tej_db/tej_db_percent_index.yaml,sha256=xSgmamEK0DUBKRllUb94p9TxhJln_BzFoFYK9OJ0fkM,302
+neurostats_API/tools/tej_db/tej_db_skip_index.yaml,sha256=6UtMfPL7XvkKvEWTFXIIUZMJWZSagIduLYJb-r3HEg8,246
+neurostats_API/tools/tej_db/tej_db_thousand_index.yaml,sha256=K2YFBSrxqX1V2upy0IUeQ4ung4aPrjtlqYSvCGaaO8I,479
+neurostats_API/tools/twse/balance_sheet.yaml,sha256=6XygNG_Ybb1Xkk1e39LMLKr7ATvaCP3xxuwFbgNl6dA,673
+neurostats_API/tools/twse/cash_flow_percentage.yaml,sha256=fk2Z4eb1JjGFvP134eJatHacB7BgTkBenhDJr83w8RE,1345
+neurostats_API/tools/twse/finance_overview_dict.yaml,sha256=B9nV75StXkrF3yv2-eezzitlJ38eEK86RD_VY6588gQ,2884
+neurostats_API/tools/twse/profit_lose.yaml,sha256=iyp9asYJ04vAxk_HBUDse_IBy5oVvYHpwsyACg5YEeg,3029
+neurostats_API/tools/twse/seasonal_data_field_dict.txt,sha256=X8yc_el6p8BH_3FikTqBVFGsvWdXT6MHXLfKfi44334,8491
+neurostats_API/utils/__init__.py,sha256=uZk08lGPvVIc7MKAvRdZ2FJzgfa8GzsWG_hWAhF6C5U,152
+neurostats_API/utils/calculate_value.py,sha256=ioPV5VWitJ2NylBi5vwfs-payAUYxWhAiS7aaJjzQKQ,4305
+neurostats_API/utils/data_process.py,sha256=UlDjKPQHO2JklBQ0402rL6dCPIExyY90gvcLJ1de7sQ,10228
+neurostats_API/utils/datetime.py,sha256=XJya4G8b_-ZOaBbMXgQjWh2MC4wc-o6goQ7EQJQMWrQ,773
+neurostats_API/utils/db_client.py,sha256=OYe6yazcR4Aa6jYmy47JrryUeh2NnKGqY2K_lSZe6i8,455
+neurostats_API/utils/logger.py,sha256=egBiiPGTi5l1FoX_o6EvdGh81R0_k8hFPctSxq8RCoo,693
+neurostats_API-0.0.23.dist-info/METADATA,sha256=cowuJT-lpruk2usQAIE1K1NoWqgYcRalikHQkb897-w,31618
+neurostats_API-0.0.23.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
+neurostats_API-0.0.23.dist-info/top_level.txt,sha256=nSlQPMG0VtXivJyedp4Bkf86EOy2TpW10VGxolXrqnU,15
+neurostats_API-0.0.23.dist-info/RECORD,,