neurostats-API 0.0.21__py3-none-any.whl → 0.0.22__py3-none-any.whl

neurostats_API/tools/tej_db/tej_db_skip_index.yaml

@@ -8,6 +8,7 @@ TWN/AINVFQ1:
 - curr
 - annd
 - fin_ind
+- eps
 TWN/AFESTM1:
 - coid
 - mdate
@@ -17,4 +18,5 @@ TWN/AFESTM1:
 - merg
 - curr
 - annd
-- fin_ind
+- fin_ind
+- eps

neurostats_API/tools/tej_db/tej_db_thousand_index.yaml

@@ -42,7 +42,6 @@ TWN/AINVFQ1:
 - isibt
 - isni
 - isnip
-- eps
 - ispsd
 - gm
 - opi

neurostats_API/tools/twse/balance_sheet.yaml

@@ -0,0 +1,35 @@
+balance_sheet:
+  mode: value_and_percentage
+
+total_asset:
+  mode: value_and_percentage
+  target_index: 
+    - 資產總額 負債總額 權益總額
+    - 資產總計 負債總計 權益總計
+ 
+current_asset:
+  mode: value_and_percentage
+  target_index: 
+    - 流動資產合計
+
+non_current_asset:
+  mode: value_and_percentage
+  target_index: 
+    - 非流動資產合計
+
+current_debt:
+  mode: value_and_percentage
+  target_index: 
+    - 流動負債合計
+    - 流動負債總額
+
+non_current_debt:
+  mode: value_and_percentage
+  target_index: 
+    - 非流動負債合計
+
+equity:
+  mode: value_and_percentage
+  target_index: 
+    - 權益總額
+    - 權益總計

neurostats_API/tools/twse/cash_flow_percentage.yaml

@@ -0,0 +1,39 @@
+# 注意此並非用於slicing
+CASHO:
+  main_index: 營業活動之淨現金流入（流出）
+  index: 
+    - 繼續營業單位稅前淨利（淨損）
+    - 收益費損項目合計
+    - 折舊費用
+    - 攤銷費用
+    - 與營業活動相關之資產及負債之淨變動合計
+    - 營業活動之淨現金流入（流出）
+
+CASHI:
+  main_index: 投資活動之淨現金流入（流出）
+  index: 
+    - 投資活動之淨現金流入（流出）
+    - 取得不動產、廠房及設備
+    - 處分不動產、廠房及設備
+    - 取得無形資產
+    - 處分無形資產
+    - 取得透過損益按公允價值衡量之金融資產
+    - 處分透過損益按公允價值衡量之金融資產
+    - 取得透過其他綜合損益按公允價值衡量之金融資產
+    - 處分透過其他綜合損益按公允價值衡量之金融資產
+    - 取得按攤銷後成本衡量之金融資產
+    - 處分按攤銷後成本衡量之金融資產
+    - 按攤銷後成本衡量之金融資產到期還本
+  
+CASHO:
+  main_index: 籌資活動之淨現金流入（流出）
+  index: 
+    - 籌資活動之淨現金流入（流出）
+    - 短期借款增加
+    - 短期借款減少
+    - 發行公司債
+    - 償還公司債
+    - 舉借長期借款
+    - 償還長期借款
+    - 發放現金股利
+    - 庫藏股票買回成本

neurostats_API/tools/twse/finance_overview_dict.yaml

@@ -0,0 +1,185 @@
+# 財務概況
+revenue:
+  field: 
+    - 營業收入合計
+  value: value
+
+gross_profit:
+  field: 
+    - 營業毛利（毛損）淨額
+  value: value
+
+operating_income:
+  field: 
+    - 營業利益（損失）
+  value: value
+
+net_income:
+  field: 
+    - 本期淨利（淨損）
+  value: value
+
+tax_fee:
+  field: 
+    - 所得稅費用（利益）合計
+  value: value
+
+# TODO: 以下所爬到的資料都是累計的，Ifa有額外計算當季的變化量
+operating_cash_flow:
+  field: 
+    - 營業活動之淨現金流入（流出）
+  value: single_season_value
+
+invest_cash_flow:
+  field: 
+    - 投資活動之淨現金流入（流出）
+  value: single_season_value
+
+financing_cash_flow:
+  field: 
+    - 籌資活動之淨現金流入（流出）
+  value: single_season_value
+# ^^^ 以上皆需要額外在DataBase處理
+
+# 每股財務狀況
+capital:
+  field: 
+    - 普通股股本
+  value: value
+
+eps:
+  field: 
+    - 基本每股盈餘
+  value: value
+
+# 獲利能力
+total_assets:
+  field: 
+    - 資產總額
+  value: value
+
+equity:
+  field: 
+    - 權益總額
+  value: value
+
+net_income_before_tax:
+  field: 
+    - 稅前淨利（淨損）
+  value: value
+
+interest:
+  field: 
+    - 利息收入
+  value: value
+
+operating_expenses:
+  field: 
+    - 營業費用合計
+  value: value
+
+net_income_rate:
+  field: 
+    - 本期淨利（淨損）
+  value: percentage
+# 成長動能
+revenue_YoY:
+  field: 
+    - 營業收入合計
+  value: YoY_1
+
+gross_prof_YoY:
+  field: 
+    - 營業毛利（毛損）淨額
+  value: YoY_1
+
+operating_income_YoY:
+  field: 
+    - 營業利益（損失）
+  value: YoY_1
+
+net_income_YoY:
+  field: 
+    - 本期淨利（淨損）
+  value: YoY_1
+
+operating_cash_flow_YoY:
+  field: 
+    - 營業活動之淨現金流入（流出）
+  value: single_season_YoY
+
+# operating_cash_flow_per_share_YoY:
+#   field: 每股營業現金流年成長率
+#   value: YoY_1
+# 營運指標
+account_receive:
+  field: 
+    - 應收帳款淨額
+  value: value
+
+account_pay:
+  field: 
+    - 應付帳款
+  value: value
+
+inventories:
+  field: 
+    - 存貨
+  value: value
+
+operating_cost:
+  field: 
+    - 營業成本合計
+  value: value
+
+application:
+  field: 
+    - 不動產、廠房及設備
+  value: value
+
+# 財務韌性
+current_assets:
+  field: 
+    - 流動資產合計
+  value: value
+
+current_liabilities:
+  field: 
+    - 流動負債合計
+  value: value
+
+total_liabilities:
+  field: 
+    - 負債總額
+  value: value
+
+short_term_liabilities:
+  field: 
+    - 短期借款
+  value: value
+
+long_term_liabilities:
+  field: 
+    - 長期借款
+  value: value
+# 
+cash_and_cash_equivalents:
+  field: 
+    - 現金及約當現金
+  value: value
+
+interest_expense: 
+  field: 
+    - 利息費用
+  value: value
+
+non_current_assets:
+  field: 
+    - 非流動資產合計
+  value: value
+
+non_current_liabilities:
+  field: 
+    - 非流動負債合計
+  value: value
+

neurostats_API/tools/twse/profit_lose.yaml

@@ -0,0 +1,143 @@
+profit_lose:  # 總營收表
+  mode: value_and_percentage
+
+grand_total_profit_lose:
+  mode: grand_total_values
+  
+revenue:
+  mode: growth
+  target_index: 
+    - 營業收入合計
+    - 收入合計
+    - 利息收入
+
+grand_total_revenue:
+  mode: grand_total_growth
+  target_index: 
+    - 營業收入合計
+    - 收入合計
+    - 利息收入
+
+gross_profit:
+  mode: growth
+  target_index: 
+    -  營業毛利（毛損）淨額
+    -  利息淨收益
+
+grand_total_gross_profit:
+  mode: grand_total_growth
+  target_index: 
+    - 營業毛利（毛損）淨額
+    - 利息淨收益
+ 
+gross_profit_percentage:
+  mode: percentage
+  target_index: 
+    - 營業毛利（毛損）淨額
+    - 利息淨收益
+
+grand_total_gross_profit_percentage:
+  mode: grand_total_percentage
+  target_index: 
+    - 營業毛利（毛損）淨額
+    - 利息淨收益
+
+# 營利
+operating_income:
+  mode: growth
+  target_index: 
+    - 營業利益（損失）
+
+grand_total_operating_income:
+  mode: grand_total_growth
+  target_index: 
+    - 營業利益（損失）
+
+operating_income_percentage:
+  mode: percentage
+  target_index: 
+    - 營業利益（損失）
+
+grand_total_operating_income_percentage:
+  mode: grand_total_percentage
+  target_index: 
+    - 營業利益（損失）
+
+# 稅前淨利
+net_income_before_tax:
+  mode: growth
+  target_index: 
+    - 稅前淨利（淨損）
+    - 繼續營業單位稅前損益
+    - 繼續營業單位稅前淨利（淨損）
+
+grand_total_net_income_before_tax:
+  mode: grand_total_growth
+  target_index: 
+    - 稅前淨利（淨損）
+    - 繼續營業單位稅前損益
+    - 繼續營業單位稅前淨利（淨損）
+
+net_income_before_tax_percentage:
+  mode: percentage
+  target_index: 
+    - 稅前淨利（淨損）
+    - 繼續營業單位稅前損益
+    - 繼續營業單位稅前淨利（淨損）
+
+grand_total_net_income_before_tax_percentage:
+  mode: grand_total_percentage
+  target_index: 
+    - 稅前淨利（淨損）
+    - 繼續營業單位稅前損益
+    - 繼續營業單位稅前淨利（淨損）
+
+# 本期淨利
+net_income:
+  mode: growth
+  target_index: 
+    - 本期淨利（淨損）
+    - 本期稅後淨利（淨損）
+
+grand_total_net_income:
+  mode: grand_total_growth
+  target_index: 
+    - 本期淨利（淨損）
+    - 本期稅後淨利（淨損）
+
+net_income_percentage:
+  mode: percentage
+  target_index: 
+    - 本期淨利（淨損）
+    - 本期稅後淨利（淨損）
+
+grand_total_income_percentage:
+  mode: grand_total_percentage
+  target_index: 
+    - 本期淨利（淨損）
+    - 本期稅後淨利（淨損）
+
+# EPS
+EPS:
+  mode: value
+  target_index: 
+    - 基本每股盈餘
+    - 基本每股盈餘合計
+
+EPS_growth:
+  mode: growth
+  target_index: 
+    - 基本每股盈餘
+    - 基本每股盈餘合計
+
+grand_total_EPS:
+  mode: grand_total
+  target_index: 
+    - 基本每股盈餘
+    - 基本每股盈餘合計
+
+grand_total_EPS_growth:
+  mode: grand_total_growth
+  target_index: 
+    - 基本每股盈餘
+    - 基本每股盈餘合計

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,4 @@
+from .data_process import StatsProcessor
 class YoY_Calculator:
     def __init__(self):
         pass
@@ -23,4 +24,101 @@ class YoY_Calculator:
         if (isinstance(YoY, complex)): # 年化成長率有複數問題
             return None
 
-        return YoY
+        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_data[key])
+                
+                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 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(
@@ -275,4 +294,13 @@ class StatsProcessor:
             pop_key = delimeter.join(pop_keys)
             return_dict[pop_key] = data[data_key]
         
-        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):
+            return None

{neurostats_API-0.0.21.dist-info → neurostats_API-0.0.22.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: neurostats_API
-Version: 0.0.21
+Version: 0.0.22
 Summary: The service of NeuroStats website
 Home-page: https://github.com/NeurowattStats/NeuroStats_API.git
 Author: JasonWang@Neurowatt
@@ -8,7 +8,7 @@ Author-email: jason@neurowatt.ai
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 Requires-Dist: numpy
-Requires-Dist: pandas>=2.2.0
+Requires-Dist: pandas
 Requires-Dist: pymongo
 Requires-Dist: pytz
 Requires-Dist: python-dotenv
@@ -89,7 +89,7 @@ pip install neurostats-API
 ```Python 
 >>> import neurostats_API
 >>> print(neurostats_API.__version__)
-0.0.21
+0.0.22
 ```
 
 ### 得到最新一期的評價資料與歷年評價

neurostats_API-0.0.22.dist-info/RECORD

@@ -0,0 +1,34 @@
+neurostats_API/__init__.py,sha256=bOEodI1kq0xK8AR_160U9DasXGcjCEZHi7BQGh6Ib-4,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=RgiX5wp9UoS7HcXHqwO_NMAFr2ESJSWJenyCwJj6rxU,6060
+neurostats_API/fetchers/base.py,sha256=BcGpwlA0TD8y-Uped68xPf-cZYHP9PB4UyDWgPcURe4,7155
+neurostats_API/fetchers/cash_flow.py,sha256=0it4hnKLKRLAFgrxrsrK2rk7dom7HvQi96z5LXh2w_c,7013
+neurostats_API/fetchers/finance_overview.py,sha256=dDe6THJg1UJffnJ25xwXd4K99s2DBTdGaxmCT3O-xdA,27763
+neurostats_API/fetchers/institution.py,sha256=UrcBc6t7u7CnEwUsf6YmLbbJ8VncdWpq8bCz17q2dgs,11168
+neurostats_API/fetchers/margin_trading.py,sha256=lQImtNdvaBoSlKhJvQ3DkH3HjSSgKRJz4ZZpyR5-Z4I,10433
+neurostats_API/fetchers/month_revenue.py,sha256=DZeOblfSz7NhQXVvL5xfMHZ1rv2B8pgqu-U-o_gcAuc,6323
+neurostats_API/fetchers/profit_lose.py,sha256=ZvSG4vx4gBrWMKmcyuSaoNyW6JGiOtIpFxRIeyCAeDY,7705
+neurostats_API/fetchers/tech.py,sha256=AyxdOjStVJIPFTVcofVOJknXPpv_D9dqkFPjEFXo6iY,14937
+neurostats_API/fetchers/tej_finance_report.py,sha256=5ERpg1kq2wSPdLMBYXX5MUWRxOrwwFHSBXNidSKeuRo,11233
+neurostats_API/fetchers/value_invest.py,sha256=b_x2Dpgs8VBU5HdG8ocKtfIEkqhU-Q0S5n6RxuFuM2g,7467
+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=-rBSdOoYs5UB9H6Y3FE5PTqV9meXEFZD2KhSlAQ_4Eg,323
+neurostats_API/tools/tej_db/tej_db_skip_index.yaml,sha256=nSbrflaJrWCIjL5WeHT3UDKZyN0WegVElUKVYA4YSa0,169
+neurostats_API/tools/tej_db/tej_db_thousand_index.yaml,sha256=S1k4PFZ7NsjGUgeCb89dyaojkOcvGPRdBr45hz3wlWY,507
+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=Zc5DG_qXnHZLkCjUYdoMWka3KVXu2o9AmDnEYixiXYQ,4197
+neurostats_API/utils/data_process.py,sha256=LdDmhQMGBg1UI6cIWCdsj9YTkixtf1cyrN1xq2JZmPo,9971
+neurostats_API/utils/datetime.py,sha256=XJya4G8b_-ZOaBbMXgQjWh2MC4wc-o6goQ7EQJQMWrQ,773
+neurostats_API/utils/db_client.py,sha256=OYe6yazcR4Aa6jYmy47JrryUeh2NnKGqY2K_lSZe6i8,455
+neurostats_API-0.0.22.dist-info/METADATA,sha256=yLp6sTftp5SaxhXZxtLfE7Fvd7OmtZYd3XjwyR4yoG4,31618
+neurostats_API-0.0.22.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
+neurostats_API-0.0.22.dist-info/top_level.txt,sha256=nSlQPMG0VtXivJyedp4Bkf86EOy2TpW10VGxolXrqnU,15
+neurostats_API-0.0.22.dist-info/RECORD,,