MultiFactor 0.2.4__tar.gz → 0.2.5__tar.gz

{multifactor-0.2.4 → multifactor-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MultiFactor
-Version: 0.2.4
+Version: 0.2.5
 Summary: 멀티팩터 기반 주식 데이터 수집 패키지
 Author-email: HANHO <hanhoman@gmail.com>
 Classifier: Programming Language :: Python :: 3
@@ -73,7 +73,7 @@ Requires-Dist: yfinance
 ### 1. 패키지 불러오기 
 다음 코드로 멀티팩터 패키지를 불러옵니다. 
 ```python
-from MultiFactor import MultiFactor
+from MultiFactor import MultiFactorKR
 ```
 
 <br>
@@ -81,7 +81,7 @@ from MultiFactor import MultiFactor
 ### 2. 멀티팩터 객체 생성  
 멀티팩터 객체 생성 시, 수집 대상 종목 수(N)를 반드시 지정해야 합니다. N은 시가총액 상위 순으로 N개까지 종목을 수집함을 의미합니다. N이 커질수록 데이터 수집 시간이 길어지므로, 초기 테스트에는 종목수(N)를 5~50 사이로 지정한 후 차츰 늘려가기를 권장합니다. 
 ```python
-mf = MultiFactor(N=50)  # 시가총액 상위 50개 종목 
+mf = MultiFactorKR(N=50)  # 시가총액 상위 50개 종목 
 ```
 <br>
 
@@ -154,8 +154,8 @@ print(stock_list)
 ```get_score```함수로 멀티팩터 종합점수 데이터를 간단하게 생성할 수 있습니다. 다음 코드는 시가총액 상위 10개 종목의 종합 점수를 추출하여 파이썬 데이터프레임(df)에 저장합니다.
 
 ```python 
-from MultiFactor import MultiFactor
-mf = MultiFactor(N=10) 
+from MultiFactor import MultiFactorKR
+mf = MultiFactorKR(N=10) 
 df = mf.get_score()
 ```
 
@@ -428,7 +428,7 @@ df[cols].head()
 
 ```python
 # 시가총액 상위 100 종목 멀티팩터 종합점수 추출 
-mf = MultiFactor(N=100)  
+mf = MultiFactorKR(N=100)  
 df = mf.get_score()  
 ``` 
 
@@ -606,7 +606,7 @@ df[['scode', 'sname', '종합점수', '종합순위']].head()
 get_Ngroup() 함수를 사용하면 전체 종목을 원하는 개수의 그룹으로 깔끔하게 묶어 요약할 수 있습니다.
 
 ```python
-mf = MultiFactor(N=100)
+mf = MultiFactorKR(N=100)
 df = mf.get_score()  
 mf.get_Ngroup(df, Ngroup=10)  # 종합점수 상위 순 10개 그룹으로 분류
 

{multifactor-0.2.4 → multifactor-0.2.5}/README.md

@@ -56,7 +56,7 @@
 ### 1. 패키지 불러오기 
 다음 코드로 멀티팩터 패키지를 불러옵니다. 
 ```python
-from MultiFactor import MultiFactor
+from MultiFactor import MultiFactorKR
 ```
 
 <br>
@@ -64,7 +64,7 @@ from MultiFactor import MultiFactor
 ### 2. 멀티팩터 객체 생성  
 멀티팩터 객체 생성 시, 수집 대상 종목 수(N)를 반드시 지정해야 합니다. N은 시가총액 상위 순으로 N개까지 종목을 수집함을 의미합니다. N이 커질수록 데이터 수집 시간이 길어지므로, 초기 테스트에는 종목수(N)를 5~50 사이로 지정한 후 차츰 늘려가기를 권장합니다. 
 ```python
-mf = MultiFactor(N=50)  # 시가총액 상위 50개 종목 
+mf = MultiFactorKR(N=50)  # 시가총액 상위 50개 종목 
 ```
 <br>
 
@@ -137,8 +137,8 @@ print(stock_list)
 ```get_score```함수로 멀티팩터 종합점수 데이터를 간단하게 생성할 수 있습니다. 다음 코드는 시가총액 상위 10개 종목의 종합 점수를 추출하여 파이썬 데이터프레임(df)에 저장합니다.
 
 ```python 
-from MultiFactor import MultiFactor
-mf = MultiFactor(N=10) 
+from MultiFactor import MultiFactorKR
+mf = MultiFactorKR(N=10) 
 df = mf.get_score()
 ```
 
@@ -411,7 +411,7 @@ df[cols].head()
 
 ```python
 # 시가총액 상위 100 종목 멀티팩터 종합점수 추출 
-mf = MultiFactor(N=100)  
+mf = MultiFactorKR(N=100)  
 df = mf.get_score()  
 ``` 
 
@@ -589,7 +589,7 @@ df[['scode', 'sname', '종합점수', '종합순위']].head()
 get_Ngroup() 함수를 사용하면 전체 종목을 원하는 개수의 그룹으로 깔끔하게 묶어 요약할 수 있습니다.
 
 ```python
-mf = MultiFactor(N=100)
+mf = MultiFactorKR(N=100)
 df = mf.get_score()  
 mf.get_Ngroup(df, Ngroup=10)  # 종합점수 상위 순 10개 그룹으로 분류
 

{multifactor-0.2.4 → multifactor-0.2.5}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 # 1. PyPI에 등록될 배포 이름 (pip install MultiFactor)
 name = "MultiFactor"
-version = "0.2.4"
+version = "0.2.5"
 authors = [
   { name="HANHO", email="hanhoman@gmail.com" },
 ]

multifactor-0.2.5/src/MultiFactor/__init__.py

@@ -0,0 +1,18 @@
+# src/MultiFactor/__init__.py
+import warnings
+import logging
+import os
+
+# 1. 모든 로그 비활성 (라이브러리 내부 chatter 차단)
+logging.disable(logging.CRITICAL)
+# 2. 모든 경고 무시
+warnings.filterwarnings("ignore")
+# 3. 환경 변수 수준에서 무시
+os.environ['PYTHONWARNINGS'] = 'ignore'
+
+# 같은 폴더의 core.py/us_core.py에서 클래스를 가져옵니다.
+from .core import MultiFactorKR
+from .us_core import MultiFactorUS
+
+# 패키지를 import할 때 노출할 항목을 명시합니다.
+__all__ = ['MultiFactorKR', 'MultiFactorUS']

{multifactor-0.2.4 → multifactor-0.2.5}/src/MultiFactor/core.py

@@ -22,7 +22,7 @@ from . import score_adj_weight as scw
 
 
 
-class MultiFactor:
+class MultiFactorKR:
     def __init__(self, N: int):
         """
         멀티팩터 : 분석 대상 종목수 (시가총액 상위 N개)

multifactor-0.2.5/src/MultiFactor/us_stockinfo.py

@@ -0,0 +1,74 @@
+import FinanceDataReader as fdr
+
+import pandas as pd
+import numpy as np
+
+def get_us_stockinfo(N=500): 
+    """
+    미국 종목정보 추출 (GitHub 시가총액 데이터 + FDR 상세정보 병합)
+    """
+    url = "https://raw.githubusercontent.com/Ate329/top-us-stock-tickers/master/tickers/sp500.csv"
+    
+    try:
+        # 1. GitHub에서 최신 S&P 500 데이터 로드 (시가총액 등 순위용)
+        df = pd.read_csv(url)
+        
+        # 2. FDR에서 KR/US 전체 상장 종목 정보 로드 (명칭 일관성 유지)
+        df_sp500 = fdr.StockListing('S&P500')
+        df_nasdaq = fdr.StockListing('NASDAQ')
+        df_nyse = fdr.StockListing('NYSE')
+        
+        # 3. FDR 데이터 병합 및 중복 제거
+        fdr_stocks = pd.concat([df_sp500, df_nasdaq, df_nyse])
+        fdr_stocks = fdr_stocks.drop_duplicates(subset='Symbol')
+        
+        # 4. Symbol 기준으로 조인하여 FDR의 Name을 사용
+        # fdr_stocks 에는 Symbol, Name, Sector, Industry 컬럼이 포함됨
+        df = df.merge(fdr_stocks[['Symbol', 'Name']], left_on='symbol', right_on='Symbol', how='left')
+        
+        # 5. 컬럼명을 기존 시스템과 동일하게 변경 (GitHub의 name 대신 FDR의 Name 사용)
+        column_map = {
+            'symbol': 'Code',
+            'Name': 'Name',
+            'marketCap': 'MarketCap',
+            'industry': 'Industry',
+            'price': 'Price',
+            'volume': 'Volume'
+        }
+        df = df.rename(columns=column_map)
+        
+        # 6. 시가총액 순으로 내림차순 정렬
+        if 'MarketCap' in df.columns:
+            df = df.sort_values(by='MarketCap', ascending=False)
+            
+    except Exception as e:
+        print(f"데이터 로드 및 상세 정보 병합 실패: {e}. 기본 FDR 방식으로 전환합니다.")
+        try:
+            df_sp500 = fdr.StockListing('S&P500')
+            df_nasdaq = fdr.StockListing('NASDAQ')
+            df_nyse = fdr.StockListing('NYSE')
+            df = pd.concat([df_sp500, df_nasdaq, df_nyse]).drop_duplicates(subset='Symbol')
+        except:
+            df_nasdaq = fdr.StockListing('NASDAQ')
+            df_nyse = fdr.StockListing('NYSE')
+            df = pd.concat([df_nasdaq, df_nyse]).drop_duplicates(subset='Symbol')
+        
+        if 'Symbol' in df.columns:
+            df = df.rename(columns={'Symbol': 'Code'})
+
+    # 7. 종목코드 클렌징 (yfinance 호환을 위해 / 를 - 로 변경. 예: BRK/B -> BRK-B)
+    if 'Code' in df.columns:
+        df['Code'] = df['Code'].str.replace('/', '-', regex=False)
+
+    # 8. 상위 N개 추출 및 인덱스 초기화
+    df = df.head(N).reset_index(drop=True)
+    
+    # 9. 요청된 필수 컬럼만 필터링 (Code, Name, Price, MarketCap, Volume, Industry)
+    target_cols = ['Code', 'Name', 'Price', 'MarketCap', 'Volume', 'Industry']
+    # 존재하는 컬럼만 선택 (fallback 시 일부 컬럼이 없을 수 있음 대비)
+    available_cols = [col for col in target_cols if col in df.columns]
+    df = df[available_cols]
+    
+    print("미국 종목 추출 건수 ", len(df))
+    
+    return df

{multifactor-0.2.4 → multifactor-0.2.5}/src/MultiFactor.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MultiFactor
-Version: 0.2.4
+Version: 0.2.5
 Summary: 멀티팩터 기반 주식 데이터 수집 패키지
 Author-email: HANHO <hanhoman@gmail.com>
 Classifier: Programming Language :: Python :: 3
@@ -73,7 +73,7 @@ Requires-Dist: yfinance
 ### 1. 패키지 불러오기 
 다음 코드로 멀티팩터 패키지를 불러옵니다. 
 ```python
-from MultiFactor import MultiFactor
+from MultiFactor import MultiFactorKR
 ```
 
 <br>
@@ -81,7 +81,7 @@ from MultiFactor import MultiFactor
 ### 2. 멀티팩터 객체 생성  
 멀티팩터 객체 생성 시, 수집 대상 종목 수(N)를 반드시 지정해야 합니다. N은 시가총액 상위 순으로 N개까지 종목을 수집함을 의미합니다. N이 커질수록 데이터 수집 시간이 길어지므로, 초기 테스트에는 종목수(N)를 5~50 사이로 지정한 후 차츰 늘려가기를 권장합니다. 
 ```python
-mf = MultiFactor(N=50)  # 시가총액 상위 50개 종목 
+mf = MultiFactorKR(N=50)  # 시가총액 상위 50개 종목 
 ```
 <br>
 
@@ -154,8 +154,8 @@ print(stock_list)
 ```get_score```함수로 멀티팩터 종합점수 데이터를 간단하게 생성할 수 있습니다. 다음 코드는 시가총액 상위 10개 종목의 종합 점수를 추출하여 파이썬 데이터프레임(df)에 저장합니다.
 
 ```python 
-from MultiFactor import MultiFactor
-mf = MultiFactor(N=10) 
+from MultiFactor import MultiFactorKR
+mf = MultiFactorKR(N=10) 
 df = mf.get_score()
 ```
 
@@ -428,7 +428,7 @@ df[cols].head()
 
 ```python
 # 시가총액 상위 100 종목 멀티팩터 종합점수 추출 
-mf = MultiFactor(N=100)  
+mf = MultiFactorKR(N=100)  
 df = mf.get_score()  
 ``` 
 
@@ -606,7 +606,7 @@ df[['scode', 'sname', '종합점수', '종합순위']].head()
 get_Ngroup() 함수를 사용하면 전체 종목을 원하는 개수의 그룹으로 깔끔하게 묶어 요약할 수 있습니다.
 
 ```python
-mf = MultiFactor(N=100)
+mf = MultiFactorKR(N=100)
 df = mf.get_score()  
 mf.get_Ngroup(df, Ngroup=10)  # 종합점수 상위 순 10개 그룹으로 분류
 

multifactor-0.2.4/src/MultiFactor/__init__.py

@@ -1,8 +0,0 @@
-# src/MultiFactor/__init__.py
-
-# 같은 폴더의 core.py/us_core.py에서 클래스를 가져옵니다.
-from .core import MultiFactor
-from .us_core import MultiFactorUS
-
-# 패키지를 import할 때 노출할 항목을 명시합니다.
-__all__ = ['MultiFactor', 'MultiFactorUS']

multifactor-0.2.4/src/MultiFactor/us_stockinfo.py

@@ -1,53 +0,0 @@
-import FinanceDataReader as fdr
-
-import pandas as pd
-import numpy as np
-
-def get_us_stockinfo(N=500): 
-    """
-    미국 종목정보 추출 (GitHub S&P 500 데이터 활용 및 정렬)
-    """
-    url = "https://raw.githubusercontent.com/Ate329/top-us-stock-tickers/master/tickers/sp500.csv"
-    
-    try:
-        # 1. GitHub에서 최신 S&P 500 데이터 로드
-        df = pd.read_csv(url)
-        
-        # 2. 컬럼명을 기존 시스템과 동일하게 변경
-        column_map = {
-            'symbol': 'Code',
-            'name': 'Name',
-            'marketCap': 'MarketCap',
-            'industry': 'Industry',
-            'price': 'Price',
-            'volume': 'Volume'
-        }
-        df = df.rename(columns=column_map)
-        
-        # 3. 시가총액 순으로 내림차순 정렬
-        if 'MarketCap' in df.columns:
-            df = df.sort_values(by='MarketCap', ascending=False)
-            
-    except Exception as e:
-        print(f"GitHub 데이터 로드 실패: {e}. 기존 FDR 방식으로 전환합니다.")
-        # 실패 시 기존 FinanceDataReader 로직 사용
-        try:
-            df = fdr.StockListing('S&P500')
-        except:
-            df_nasdaq = fdr.StockListing('NASDAQ')
-            df_nyse = fdr.StockListing('NYSE')
-            df = pd.concat([df_nasdaq, df_nyse])
-        
-        if 'Symbol' in df.columns:
-            df = df.rename(columns={'Symbol': 'Code'})
-
-    # 4. 종목코드 클렌징 (yfinance 호환을 위해 / 를 - 로 변경. 예: BRK/B -> BRK-B)
-    if 'Code' in df.columns:
-        df['Code'] = df['Code'].str.replace('/', '-', regex=False)
-
-    # 5. 상위 N개 추출 및 인덱스 초기화
-    df = df.head(N).reset_index(drop=True)
-    
-    print("미국 종목 추출 건수 ", len(df))
-    
-    return df