neurostats-API 0.0.19__tar.gz → 0.0.20__tar.gz

{neurostats_api-0.0.19 → neurostats_api-0.0.20}/PKG-INFO

@@ -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 → neurostats_api-0.0.20}/README.md

@@ -712,6 +712,7 @@ data = fetcher.get(
 #### 回傳資料
 ##### `YOY_NOCAL` 與 `QOQ_NOCAL` 
 為回傳`pd.DataFrame`，column名稱為<年份>Q<季>， row名稱為指定財報項目
+
 ```Python
 # fetch_mode = fetcher.FetchMode.QOQ_NOCAL
         2024Q3        2024Q2        2024Q1
@@ -726,17 +727,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
@@ -744,17 +746,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 → neurostats_api-0.0.20}/neurostats_API/__init__.py

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

{neurostats_api-0.0.19 → neurostats_api-0.0.20}/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-0.0.19 → neurostats_api-0.0.20}/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-0.0.19 → neurostats_api-0.0.20}/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 → neurostats_api-0.0.20}/neurostats_API.egg-info/PKG-INFO

@@ -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 → neurostats_api-0.0.20}/neurostats_API.egg-info/requires.txt

@@ -1,4 +1,4 @@
-numpy>=2.1.0
+numpy
 pandas>=2.2.0
 pymongo
 pytz

{neurostats_api-0.0.19 → neurostats_api-0.0.20}/setup.py

@@ -2,11 +2,11 @@ from setuptools import setup, find_packages
 
 setup(
     name='neurostats_API',
-    version='0.0.19',
+    version='0.0.20',
     long_description=open('README.md', 'r', encoding='utf-8').read(),
     long_description_content_type='text/markdown',
     install_requires=[
-        "numpy>=2.1.0",
+        "numpy",
         "pandas>=2.2.0",
         "pymongo",
         "pytz",