neurostats-API 0.0.19__py3-none-any.whl → 0.0.20__py3-none-any.whl

neurostats_API/__init__.py

@@ -1,4 +1,4 @@
-__version__='0.0.19'
+__version__='0.0.20'
 
 from .fetchers import (
     BalanceSheetFetcher,

neurostats_API/fetchers/base.py

@@ -81,10 +81,14 @@ class BaseTEJFetcher(abc.ABC):
 
     def get_latest_data_time(self, ticker):
         latest_data = self.collection.find_one(
-            {"ticker": ticker}, {
+            {
+                "ticker": ticker
+            }, 
+            {
                 "last_update": 1,
                 "_id": 0
-            })
+            }
+        )
 
         try:
             latest_date = latest_data['last_update']["latest_data_date"]
@@ -116,9 +120,8 @@ class BaseTEJFetcher(abc.ABC):
                         try:
                             past_year = year - shift
                             last_value = data_dict[f"{past_year}Q{season}"][key]
-                            temp_dict[
-                                f"YoY_{shift}"] = YoY_Calculator.cal_growth(
-                                    this_value, last_value, delta=shift)
+                            temp_dict[f"YoY_{shift}"] = YoY_Calculator.cal_growth(
+                                    this_value, last_value, delta=shift) * 100
                         except Exception as e:
                             temp_dict[f"YoY_{shift}"] = None
 
@@ -160,7 +163,7 @@ class BaseTEJFetcher(abc.ABC):
                             key]['value']
 
                         temp_dict['growth'] = YoY_Calculator.cal_growth(
-                            this_value, last_value, delta=1)
+                            this_value, last_value, delta=1) * 100
                     except Exception as e:
                         temp_dict['growth'] = None
 
@@ -180,31 +183,21 @@ class BaseTEJFetcher(abc.ABC):
         return data_dict
 
     def set_time_shift(self, date: Union[str, datetime], period: str):
-        if (isinstance(date, str)):
+        if isinstance(date, str):
             date = datetime.strptime(date, "%Y-%m-%d")
-        if (period == '1d'):
-            return date - timedelta(days=1)
-
-        elif (period == '7d'):
-            return date - timedelta(days=7)
-
-        elif (period == '1m'):
-            return date - timedelta(days=30)
-
-        elif (period == '3m'):
-            return date - timedelta(days=90)
 
-        elif (period == '1y'):
-            return date - timedelta(days=365)
-
-        elif (period == '3y'):
-            return date - timedelta(days=365 * 3)
-
-        elif (period == '5y'):
-            return date - timedelta(days=365 * 5)
-
-        elif (period == '10y'):
-            return date - timedelta(days=365 * 10)
+        period_mapping = {
+            "1d": timedelta(days=1),
+            "7d": timedelta(days=7),
+            "1m": timedelta(days=30),
+            "3m": timedelta(days=90),
+            "1y": timedelta(days=365),
+            "3y": timedelta(days=365 * 3),
+            "5y": timedelta(days=365 * 5),
+            "10y": timedelta(days=365 * 10),
+        }
 
-        elif (period == 'all'):
+        if period == "all":
             return datetime.strptime("1991-01-01", "%Y-%m-%d")
+
+        return date - period_mapping.get(period, timedelta(days=0))  # 預設為不變

neurostats_API/fetchers/tech.py

@@ -85,7 +85,7 @@ class TechFetcher(StatsFetcher):
             ticker_full = self.collection.find_one(query)
 
             if not ticker_full:
-                raise
+                raise ValueError("No ticker found in database")
 
             daily_data = ticker_full.get("data", [])
             if not isinstance(daily_data, list):

neurostats_API/fetchers/tej_finance_report.py

@@ -20,7 +20,7 @@ class FinanceReportFetcher(BaseTEJFetcher):
     def __init__(
             self,
             mongo_uri,
-            db_name=".company",
+            db_name="company",
             collection_name="TWN/AINVFQ1"
         ):
         self.client = MongoClient(mongo_uri)

{neurostats_API-0.0.19.dist-info → neurostats_API-0.0.20.dist-info}/METADATA

@@ -1,13 +1,13 @@
 Metadata-Version: 2.1
 Name: neurostats_API
-Version: 0.0.19
+Version: 0.0.20
 Summary: The service of NeuroStats website
 Home-page: https://github.com/NeurowattStats/NeuroStats_API.git
 Author: JasonWang@Neurowatt
 Author-email: jason@neurowatt.ai
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
-Requires-Dist: numpy>=2.1.0
+Requires-Dist: numpy
 Requires-Dist: pandas>=2.2.0
 Requires-Dist: pymongo
 Requires-Dist: pytz
@@ -728,6 +728,7 @@ data = fetcher.get(
 #### 回傳資料
 ##### `YOY_NOCAL` 與 `QOQ_NOCAL` 
 為回傳`pd.DataFrame`，column名稱為<年份>Q<季>， row名稱為指定財報項目
+
 ```Python
 # fetch_mode = fetcher.FetchMode.QOQ_NOCAL
         2024Q3        2024Q2        2024Q1
@@ -742,17 +743,18 @@ bp51  3.111298e+09  3.173919e+09  2.453840e+09
 
 ##### `YOY` 與 `QOQ`
 回傳為`Dict[pd.DataFrame]`, key 為指定的index, DataFrame中則是該index歷年的數值與成長率
+成長率單位為`%`
 ```Python
 # fetch_mode = fetcher.FetchMode.QOQ
 {
         'bp41':               
         2024Q3        2024Q2        2024Q1
 value   7.082005e+07  6.394707e+07  5.761001e+07
-growth  1.074791e-01  1.099994e-01  5.532101e-03, 
+growth  1.074791e+01  1.099994e+01  5.532101e-01, 
         'bp51':               
         2024Q3        2024Q2        2024Q1
 value   3.111298e+09  3.145373e+09  3.091985e+09
-growth -1.083335e-02  1.726663e-02 -4.159542e-03
+growth -1.083335e+00  1.726663e+00 -4.159542e-01
 }
 
 # fetch_mode = fetcher.FetchMode.YOY
@@ -760,17 +762,17 @@ growth -1.083335e-02  1.726663e-02 -4.159542e-03
 'bp41':               
         2024Q3        2023Q3        2022Q3
 value   7.082005e+07  5.377231e+07  6.201822e+07
-YoY_1            NaN           NaN  4.130744e-01
-YoY_3   1.729171e-01  9.556684e-02  1.883274e-01
-YoY_5   1.389090e-01  1.215242e-01  1.642914e-01
-YoY_10  1.255138e-01  1.356297e-01  1.559702e-01, 
+YoY_1   3.170357e+01 -1.329596e+01  4.130744e+01
+YoY_3   1.729171e+01  9.556684e+00  1.883274e+01
+YoY_5   1.389090e+01  1.215242e+01  1.642914e+01
+YoY_10  1.255138e+01  1.356297e+01  1.559702e+01
 'bp51':               
         2024Q3        2023Q3        2022Q3
 value   3.111298e+09  3.173919e+09  2.453840e+09
-YoY_1            NaN           NaN  3.179539e-01
-YoY_3   1.866752e-01  2.766851e-01  2.638677e-01
-YoY_5   2.068132e-01  2.479698e-01  1.815106e-01
-YoY_10  1.420500e-01  1.586797e-01  1.551364e-01
+YoY_1  -1.972987e+00  2.934499e+01  3.179539e+01 
+YoY_3   1.866752e+01  2.766851e+01  2.638677e+01 
+YoY_5   2.068132e+01  2.479698e+01  1.815106e+01
+YoY_10  1.420500e+01  1.586797e+01  1.551364e+01
 }
 ```
 

{neurostats_API-0.0.19.dist-info → neurostats_API-0.0.20.dist-info}/RECORD

@@ -1,17 +1,17 @@
-neurostats_API/__init__.py,sha256=U-0Tn9McUXzABJINU15pYkGchFGI5R3njBMgn-F4CzM,288
+neurostats_API/__init__.py,sha256=Kn7oiUopkqGqo6EOJPdszCzLnzb9FwYpN_e4zjI5MBw,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=sQv4Gk5uoKURLEdh57YknOQWiyVwaXJ2Mw75jxNqUS0,5804
-neurostats_API/fetchers/base.py,sha256=hlHtCDKpVFFs2n0uJ0yjz26dTzgc2ZtOKleiguT_HxY,6673
+neurostats_API/fetchers/base.py,sha256=Gw1pUFJtl-ot5kp7v_1ueTA7Y__-mghNqD3kFlbVBTc,6515
 neurostats_API/fetchers/cash_flow.py,sha256=TY7VAWVXkj5-mzH5Iu0sIE-oV8MvGmmDy0URNotNV1E,7614
 neurostats_API/fetchers/finance_overview.py,sha256=PxUdWY0x030olYMLcCHDBn068JLmCE2RTOce1dxs5vM,27753
 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=nixX2llzjCFr2m2YVjxrSfkBusnZPrPb2dRDq1XLGhw,4251
 neurostats_API/fetchers/profit_lose.py,sha256=EN9Y0iamcAaHMZdjHXO6b_2buLnORssf8ZS7A0hi74s,5896
-neurostats_API/fetchers/tech.py,sha256=116UQP00FyZUGwOttHsauJLxAMNE99rPL6nl4U3ETK4,13386
-neurostats_API/fetchers/tej_finance_report.py,sha256=1q_c2B_Dd7qIagdlXt9eNT7O53JmsquCrgdi2OOeQ6w,14008
+neurostats_API/fetchers/tech.py,sha256=mcwfE3xzZNmo6P7NS37wQBFnCt4f0uwxWUDSOC00I7M,13428
+neurostats_API/fetchers/tej_finance_report.py,sha256=VZximF1Lct3r-E01VwcDX0Zj_CIVSvpdEAuU9I9OsJc,14007
 neurostats_API/fetchers/value_invest.py,sha256=b_x2Dpgs8VBU5HdG8ocKtfIEkqhU-Q0S5n6RxuFuM2g,7467
 neurostats_API/tools/balance_sheet.yaml,sha256=6XygNG_Ybb1Xkk1e39LMLKr7ATvaCP3xxuwFbgNl6dA,673
 neurostats_API/tools/cash_flow_percentage.yaml,sha256=fk2Z4eb1JjGFvP134eJatHacB7BgTkBenhDJr83w8RE,1345
@@ -25,7 +25,7 @@ neurostats_API/utils/data_process.py,sha256=A--dzOsu42jRxqqCD41gTtjE5rhEBYmhB6y-
 neurostats_API/utils/datetime.py,sha256=XJya4G8b_-ZOaBbMXgQjWh2MC4wc-o6goQ7EQJQMWrQ,773
 neurostats_API/utils/db_client.py,sha256=OYe6yazcR4Aa6jYmy47JrryUeh2NnKGqY2K_lSZe6i8,455
 neurostats_API/utils/fetcher.py,sha256=VbrUhjA-GG5AyjPX2SHtFIbZM4dm3jo0RgZzuCbb_Io,40927
-neurostats_API-0.0.19.dist-info/METADATA,sha256=2YG4AS_jlIEZ8gPBxd7rZ9CEOyuAqTiBStFDH4k9ntM,30981
-neurostats_API-0.0.19.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
-neurostats_API-0.0.19.dist-info/top_level.txt,sha256=nSlQPMG0VtXivJyedp4Bkf86EOy2TpW10VGxolXrqnU,15
-neurostats_API-0.0.19.dist-info/RECORD,,
+neurostats_API-0.0.20.dist-info/METADATA,sha256=uG49C2eYBlTroejgDPkECjyfkRxBp7APAGxAihksMo0,30997
+neurostats_API-0.0.20.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
+neurostats_API-0.0.20.dist-info/top_level.txt,sha256=nSlQPMG0VtXivJyedp4Bkf86EOy2TpW10VGxolXrqnU,15
+neurostats_API-0.0.20.dist-info/RECORD,,