apsniper0673-dataprovider 0.1.1__tar.gz

apsniper0673_dataprovider-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 HyuntaMansei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

apsniper0673_dataprovider-0.1.1/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: apsniper0673_dataprovider
+Version: 0.1.1
+Summary: My stock data provider for APSniper0673
+Author: apsniper0673
+Requires-Python: >=3.8
+License-File: LICENSE
+Dynamic: license-file

apsniper0673_dataprovider-0.1.1/README.md

@@ -0,0 +1,14 @@
+# mystockdataprovider
+
+모듈 하이라키
+
+Most Independent
+  - odi
+  - utility에 있는 모든 모듈
+    - crawler
+    - db 등등
+
+Hierarchy
+  - frame > raw > ppd > rdf > rdp > sdp
+  - provider > krx / naver > wdp > rdp > sdp
+

apsniper0673_dataprovider-0.1.1/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "apsniper0673_dataprovider"
+version = "0.1.1"
+description = "My stock data provider for APSniper0673"
+authors = [
+  { name = "apsniper0673" }
+]
+requires-python = ">=3.8"
+dependencies = [
+    # "pandas",
+    # "numpy",
+]
+
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]

apsniper0673_dataprovider-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

apsniper0673_dataprovider-0.1.1/src/apsniper0673_dataprovider.egg-info/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: apsniper0673_dataprovider
+Version: 0.1.1
+Summary: My stock data provider for APSniper0673
+Author: apsniper0673
+Requires-Python: >=3.8
+License-File: LICENSE
+Dynamic: license-file

apsniper0673_dataprovider-0.1.1/src/apsniper0673_dataprovider.egg-info/SOURCES.txt

@@ -0,0 +1,64 @@
+LICENSE
+README.md
+pyproject.toml
+src/apsniper0673_dataprovider.egg-info/PKG-INFO
+src/apsniper0673_dataprovider.egg-info/SOURCES.txt
+src/apsniper0673_dataprovider.egg-info/dependency_links.txt
+src/apsniper0673_dataprovider.egg-info/top_level.txt
+src/mydataprovider/__init__.py
+src/mydataprovider/api.py
+src/mydataprovider/simple.py
+src/mydataprovider/test_api.py
+src/mydataprovider/frame/__init__.py
+src/mydataprovider/frame/feather_manager.py
+src/mydataprovider/frame/stock_dataframe.py
+src/mydataprovider/frame/odi/df_odi.py
+src/mydataprovider/frame/odi/odi_functions.py
+src/mydataprovider/frame/ppd/__init__.py
+src/mydataprovider/frame/ppd/convert_to_ppd_df.py
+src/mydataprovider/frame/ppd/df_ppd.py
+src/mydataprovider/frame/ppd/ppdps/__init__.py
+src/mydataprovider/frame/ppd/ppdps/ppdp_baisc.py
+src/mydataprovider/frame/ppd/ppdps/ppdp_custom.py
+src/mydataprovider/frame/raw/__init__.py
+src/mydataprovider/frame/raw/df_raw.py
+src/mydataprovider/frame/raw/df_raw_krx.py
+src/mydataprovider/frame/raw/df_raw_nxt.py
+src/mydataprovider/frame/raw/merge_raw.py
+src/mydataprovider/frame/raw/stock_data_handler_for_raw.py
+src/mydataprovider/provider/__init__.py
+src/mydataprovider/provider/stock_data_provider.py
+src/mydataprovider/provider/rdp/__init__.py
+src/mydataprovider/provider/rdp/realtime_dataframe_provider.py
+src/mydataprovider/provider/rdp/flask/__init__.py
+src/mydataprovider/provider/rdp/flask/rdf_client.py
+src/mydataprovider/provider/rdp/flask/rdf_server.py
+src/mydataprovider/provider/rdp/rdf/__init__.py
+src/mydataprovider/provider/rdp/rdf/df_rdf.py
+src/mydataprovider/provider/web/__init__.py
+src/mydataprovider/provider/web/web_data_provider.py
+src/mydataprovider/provider/web/krx/__init__.py
+src/mydataprovider/provider/web/krx/krx_data_provider.py
+src/mydataprovider/provider/web/naver/__init__.py
+src/mydataprovider/provider/web/naver/naver_data_provider.py
+src/mydataprovider/provider/web/naver/flask/__init__.py
+src/mydataprovider/provider/web/naver/flask/naver_data_client.py
+src/mydataprovider/provider/web/naver/flask/naver_data_fetcher.py
+src/mydataprovider/provider/web/naver/flask/naver_data_server.py
+src/mydataprovider/table/__init__.py
+src/mydataprovider/table/db_with_sql.py
+src/mydataprovider/table/stock_table_manager.py
+src/mydataprovider/table/tm_odi.py
+src/mydataprovider/table/tm_raw_krx.py
+src/mydataprovider/table/tm_raw_nxt.py
+src/mydataprovider/utility/__init__.py
+src/mydataprovider/utility/get_available_server.py
+src/mydataprovider/utility/crawler/__init__.py
+src/mydataprovider/utility/crawler/krx.py
+src/mydataprovider/utility/crawler/naver.py
+src/mydataprovider/utility/crawler/nxt.py
+src/mydataprovider/utility/db/sql.py
+src/mydataprovider/z_handler/handler_functions.py
+src/mydataprovider/z_handler/singleday_data_handler.py
+src/mydataprovider/z_handler/stock_data_handler.py
+src/mydataprovider/z_handler/update_upsert_df.py

apsniper0673_dataprovider-0.1.1/src/apsniper0673_dataprovider.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

apsniper0673_dataprovider-0.1.1/src/apsniper0673_dataprovider.egg-info/top_level.txt

@@ -0,0 +1 @@
+mydataprovider

apsniper0673_dataprovider-0.1.1/src/mydataprovider/api.py

@@ -0,0 +1,3 @@
+from .frame.odi.df_odi import odi
+from .table.db_with_sql import DBWithSQL
+from .provider.stock_data_provider import sdp, StockDataProvider

apsniper0673_dataprovider-0.1.1/src/mydataprovider/frame/feather_manager.py

@@ -0,0 +1,127 @@
+import pandas as pd
+import os
+from pathlib import Path
+import re
+
+from mydataprovider.frame.odi.df_odi import odi
+from mystockutil.etc import get_project_root
+
+from mystockutil.logging.logging_setup import CustomAdapter, logger as original_logger
+logger = CustomAdapter(original_logger, {'prefix': 'Feather'})
+
+class _FeatherManager():
+    def __init__(self, base_feather_name:str) -> None:
+        self.feather_name = base_feather_name
+        self._set_feather_dir()
+
+    def _set_feather_dir(self) -> None:
+        """
+        Feather 파일을 저장할 디렉토리를 설정합니다.
+        """
+        try:
+            self.feather_dir = get_project_root().joinpath('feather')
+        except:
+            try:
+                self.feather_dir = get_project_root(marker='feather').joinpath('feather')
+            except:
+                raise RuntimeError("Cannot find feather directory. Please check your project structure.")
+        
+    def _get_feather_dir(self) -> Path:
+        return self.feather_dir
+    def _generate_feather_path(self, date:pd.Timestamp=None) -> str:
+        if date is None:
+            # 디폴트 값으로 오늘 날짜를 사용
+            date = pd.Timestamp.today().normalize()
+        return os.path.join(self.feather_dir, date.strftime('%Y%m%d') + '_' + self.feather_name + '.feather')
+    def _find_latest_feather_path(self) -> Path | None:
+                # 파일 이름 패턴 정의: YYYYMMDD_table_name.feather
+        pattern = re.compile(r'(\d{8})_' + re.escape(self.feather_name) + r'\.feather$')
+        latest_date = None
+        latest_file = None
+        
+        # base_dir 내의 모든 파일을 순회
+        for file in self.feather_dir.iterdir():
+            if file.is_file():
+                match = pattern.match(file.name)
+                if match:
+                    date_str = match.group(1)
+                    try:
+                        file_date = pd.to_datetime(date_str, format='%Y%m%d')
+                        if (latest_date is None) or (file_date > latest_date):
+                            latest_date = file_date
+                            latest_file = file
+                    except ValueError:
+                        logger.warning(f"Filename '{file.name}' has invalid date format.")
+                        continue
+        if latest_file is None:
+            logger.warning(f"No feather files found for table '{self.feather_name}' in '{self.feather_dir}'.")
+        return latest_file
+    
+    def _load_latest_feather(self) -> pd.DataFrame:
+        """
+        지정된 테이블 이름에 해당하는 최신 Feather 파일을 로드
+
+        Args:
+            table_name (str): 테이블 이름
+
+        Returns:
+            pd.DataFrame: 로드된 데이터프레임
+
+        Raises:
+            FileNotFoundError: 해당 테이블에 대한 Feather 파일이 존재하지 않을 경우
+        """
+        latest_file = self._find_latest_feather_path()
+        
+        if latest_file:
+            logger.info(f"Loading latest file: {latest_file}")
+            df = pd.read_feather(latest_file)
+            return df
+        else:
+            raise FileNotFoundError(f"No feather files found for table '{self.feather_name}' in '{self.feather_dir}'.")
+
+class FeatherManager_del(_FeatherManager):
+    def delete_old_feathers(self, keep:int=3) -> None:
+        """
+        feather 디렉토리 내에서 가장 최근 `keep`개 파일을 제외하고 모두 삭제합니다.
+        
+        Args:
+            keep (int): 보존할 최신 feather 파일 개수. 그 외는 삭제됨.
+        """
+        pattern = re.compile(r'(\d{8})_' + re.escape(self.feather_name) + r'\.feather$')
+        files_with_dates = []
+
+        for file in self.feather_dir.iterdir():
+            if file.is_file():
+                match = pattern.match(file.name)
+                if match:
+                    try:
+                        date = pd.to_datetime(match.group(1), format='%Y%m%d')
+                        files_with_dates.append((date, file))
+                    except ValueError:
+                        logger.warning(f"Filename '{file.name}' has invalid date format.")
+                        continue
+        
+        # 날짜 기준으로 정렬
+        files_with_dates.sort(reverse=True)
+
+        # 삭제할 파일들 추출
+        files_to_delete = files_with_dates[keep:]
+
+        for _, file in files_to_delete:
+            try:
+                file.unlink()
+                logger.info(f"Deleted old feather file: {file}")
+            except Exception as e:
+                logger.error(f"Failed to delete file {file}: {e}")
+
+class FeatherManager(FeatherManager_del):
+    def load_from_feather(self) -> pd.DataFrame:
+        return self._load_latest_feather()
+
+    def save_to_feather(self, df:pd.DataFrame):
+        last_date = df.index.get_level_values('일자').max()
+        df.to_feather(self._generate_feather_path(date=last_date))
+        logger.info(f"Data saved to feather file: {self._generate_feather_path(date=last_date)}")
+
+if __name__ == '__main__':
+    pass

apsniper0673_dataprovider-0.1.1/src/mydataprovider/frame/odi/df_odi.py

@@ -0,0 +1,368 @@
+# 보편적 Library
+import pandas as pd
+import datetime
+
+# User Defined Library
+from mystockutil.logging.logging_setup import CustomAdapter, logger as original_logger
+logger = CustomAdapter(original_logger, {'prefix': 'ODI'})
+
+"""
+Opening Day Information (ODI) 관리 클래스
+"""
+
+# Essential Imports
+import exchange_calendars as ecal
+
+# Essential User Defined Imports
+from mydataprovider.table.tm_odi import TM_ODI
+from mydataprovider.frame.odi.odi_functions import get_offset_value_with_target
+
+class _ODI():
+    def __init__(self) -> None:
+        super().__init__()
+        
+        self.tm = TM_ODI() # ODI 테이블을 관리하는 클래스       
+        
+        # 개장일에 대한 정보를 저장하는 DataFrame
+        # index: date, columns: '개장여부', 'raw', 'ppd'
+        # index는 pd.Timestamp로 사용, 오름차순 정렬
+        self.df:pd.DataFrame = pd.DataFrame()
+        
+class ODI_data_ready(_ODI):
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        
+        # 장시작 후 실시간 데이터 수집 가능 시간
+        self.krx_realtime_data_ready_time = datetime.time(hour=9, minute=20)  # KRX 개장 후 20분 후
+        self.nxt_realtime_data_ready_time = datetime.time(hour=8, minute=20)  # NXT 개장 후 20분 후
+
+        # KRX와 NXT의 기준시간 데이터
+        self.krx_final_data_ready_time = datetime.time(hour=18, minute=30)  # KRX 폐장 후 30분 후
+        self.nxt_final_data_ready_time = datetime.time(hour=20, minute=10)  # NXT 폐장 후 30분 후
+
+    def is_krx_realtime_data_ready(self) -> bool:
+        """현재 시간이 KRX 실시간 데이터 수집 가능 시간인지 확인
+        휴장일인 경우에는 True를 반환한다."""
+        if not self.today_is_openday:
+            return True
+        else:
+            return pd.Timestamp.now().time() >= self.krx_realtime_data_ready_time
+    def is_nxt_realtime_data_ready(self) -> bool:
+        """현재 시간이 NXT 실시간 데이터 수집 가능 시간인지 확인
+        휴장일인 경우에는 True를 반환한다."""
+        if not self.today_is_openday:
+            return True
+        else:
+            return pd.Timestamp.now().time() >= self.nxt_realtime_data_ready_time            
+    def is_today_krx_final_data_ready(self) -> bool:
+        if not self.today_is_openday:
+            return True
+        else:
+            return pd.Timestamp.now().time() >= self.krx_final_data_ready_time
+    def is_today_nxt_final_data_ready(self) -> bool:
+        if not self.today_is_openday:
+            return True
+        else:
+            return pd.Timestamp.now().time() >= self.nxt_final_data_ready_time
+    @property
+    def today_is_openday(self)-> bool:
+        today:pd.Timestamp = pd.Timestamp.today().normalize()
+        if today in self.df.index:
+            # index에 있으면 그 값을 리턴
+            return self.df.loc[[today]]['개장여부'].iloc[0]
+            # return self.df.loc[today]['개장여부']
+        else:
+            raise ValueError("Today's data is not in the DataFrame.")
+    @property
+    def today_is_holiday(self) -> bool:
+        return not self.today_is_openday
+    @property
+    def today(self) -> pd.Timestamp:
+        return pd.Timestamp.today().normalize()
+    @property
+    def yesterday(self) -> pd.Timestamp:
+        return pd.Timestamp.today().normalize() - pd.Timedelta(1, unit='D')
+    @property
+    def tomorrow(self) -> pd.Timestamp:
+        return pd.Timestamp.today().normalize() + pd.Timedelta(1, unit='D')
+
+
+class ODI_with_df(ODI_data_ready):
+    # 금일 주위의 데이터를 보여줌 
+    def get_recent_days_df(self, past_days:int = 10, forward_days:int=10) -> pd.DataFrame:
+        """금일을 기준으로 최근 days일의 ODI DataFrame을 반환한다."""
+        start_date = self.today - pd.Timedelta(past_days, unit='D')
+        end_date = self.today + pd.Timedelta(forward_days, unit='D')
+        return self.df[(self.df.index >= start_date) & (self.df.index <= end_date)]
+    @property
+    def df_recent(self) -> pd.DataFrame:
+        """금일을 포함한 최근 ODI DataFrame을 반환한다."""
+        days = 5
+        return self.get_recent_days_df(days, days)
+    @property
+    def df_past_recent(self) -> pd.DataFrame:
+        """금일을 포함한 최근 ODI DataFrame을 반환한다."""
+        days = 5
+        return self.get_recent_days_df(days, 0)
+    @property
+    def df_future_recent(self) -> pd.DataFrame:
+        """금일을 포함한 최근 ODI DataFrame을 반환한다."""
+        days = 5
+        return self.get_recent_days_df(0, days)
+    @property
+    def df_on(self):
+        return self.df[self.df['개장여부']==True]
+    @property
+    def df_off(self):
+        return self.df[self.df['개장여부']==False]
+    @property
+    def days(self):
+        return self.df.index
+    @property
+    def ondays(self):
+        return self.df_on.index
+    @property
+    def offdays(self):
+        return self.df_off.index
+
+
+class ODI_with_TM(ODI_with_df):
+    def fetch_whole(self):
+        self.df = self.tm.fetch_whole()
+            
+    def add_onday(self, date: datetime.date):
+        """특정일을 개장일로 추가한다."""
+        date = pd.to_datetime(date).normalize()
+        self._add_date(date, is_open=True)
+        
+    def add_offday(self, date: datetime.date):
+        """특정일을 휴일로 추가한다."""
+        date = pd.to_datetime(date)
+        self._add_date(date, is_open=False)
+
+    def _add_date(self, date: pd.Timestamp, is_open: bool):
+        """특정일을 개장일 또는 휴일로 추가한다.
+        is_open이 True인 경우 개장일로, False인 경우 휴일로 추가한다.
+        """
+        date = pd.to_datetime(date).normalize()
+        if date not in self.df.index:
+            # 필요한 컬럼만 지정해서 안전하게 추가
+            new_row = pd.Series({
+                    '일자': date,
+                    '개장여부': is_open,
+                    '개장시간': pd.Timedelta(hours=9),
+                    '폐장시간': pd.Timedelta(hours=15, minutes=30)
+                }, name=date)
+            index_name = self.df.index.name
+            self.df = pd.concat([self.df, new_row.to_frame().T])
+            self.df.index.name = index_name  # 또는 '일자'
+        else:
+            self.df.loc[date, '개장여부'] = True
+        self.df.sort_index(inplace=True)
+        self._post_date(date)
+        
+    def _post_date(self, date: datetime.date):
+        """특정일을 DB에 업데이트한다."""
+        date = pd.to_datetime(date).normalize()
+        df = self.df.loc[date:date, :]
+        self.tm.post_df(df)
+
+
+class ODI_premaker(ODI_with_TM):
+    def make_base_odi_in_year(self, year:int):
+        # 먼저 해당 연도에서 df에 없는 모든 날짜를 추가한다. 
+        # 그 후, 토/일 공휴일을 추가한다.
+        # krx에서 추가적인 공휴일을 추가한다. 
+        
+        xkrx = ecal.get_calendar('XKRX')
+        
+        all_days = pd.date_range(f"{year}-01-01", f"{year}-12-31", freq='D')
+        open_days = xkrx.schedule.loc[f'{year}-01-01':f'{year}-12-31']
+        # Fixme: 작동 하는지 확인 필요
+        open_days = open_days.index.normalize()
+        off_days = all_days.difference(open_days)
+        
+        # 이미 checked된 날짜는 제외한다.
+        days_in_df = self.df.index[(self.df.index >= pd.Timestamp(f"{year}-01-01")) & (self.df.index <= pd.Timestamp(f"{year}-12-31"))]
+        subset = self.df.loc[days_in_df]
+        filtered_subset = subset[subset['checked']]
+        days_in_df = filtered_subset.index
+        days_not_in_df = all_days.difference(days_in_df)
+        for d in days_not_in_df:
+            if d in open_days:
+                self.add_onday(d)
+            elif d in off_days:
+                self.add_offday(d)
+            else:
+                raise ValueError(f"Date {d} is not in open_days or off_days.")
+
+
+class ODI_base_calculation(ODI_premaker):
+    # 인접날짜 조회
+    def get_next_day(self, date: pd.Timestamp=None, offset:int=1):
+        """date로부터 offset만큼 떨어진 날짜를 반환"""
+        date = pd.to_datetime(date).normalize() if date is not None else pd.Timestamp.today().normalize()
+        return date+pd.Timedelta(offset, unit='D')
+    
+    def get_next_open_day(self, date: pd.Timestamp, offset:int=1):
+        """date로부터 offset만큼 떨어진 개장일을 반환
+        offset이 0이 아닌 경우, 해당 날짜가 개장일 여부는 상관 없음
+        """
+        # 이 경우, offset이 양수인지, 음수인지에 따라 처리가 달라진다.
+        date = pd.to_datetime(date).normalize()
+        # offset이 0인 경우, 해당 날짜가 개장일인지 확인
+        if offset == 0:
+            if date in self.ondays:
+                return date
+            else:
+                # offset이 0인데 개장일이 아닌 경우 에러 발생
+                raise ValueError(f"{date} is not an open day.")
+        return get_offset_value_with_target(self.ondays, date, offset)
+    
+    def get_next_off_day(self, date: datetime.date, offset:int=1):
+        """date로부터 offset만큼 떨어진 휴일을 반환
+        offset이 0이 아닌 경우, 해당 날짜가 개장일 여부는 상관 없음
+        """
+        date = pd.to_datetime(date).normalize()
+        if offset == 0:
+            if date in self.offdays:
+                return date
+            else:
+                raise ValueError(f"{date} is not an off day.")
+        date = pd.to_datetime(date)
+        return get_offset_value_with_target(self.offdays, date, offset)   
+
+    def get_prev_day(self, date: pd.Timestamp, offset:int=1) -> pd.Timestamp:
+        """date로부터 offset만큼 떨어진 이전 날짜를 반환"""
+        return self.get_next_day(date, -offset)
+    def get_prev_open_day(self, date: pd.Timestamp, offset:int=1) -> pd.Timestamp:
+        """date로부터 개장일 중 offset만큼 떨어진 이전 개장일을 반환"""
+        return self.get_next_open_day(date, -offset)
+    def get_prev_off_day(self, date: pd.Timestamp, offset:int=1) -> pd.Timestamp:
+        """date로부터 휴일 중 offset만큼 떨어진 이전 휴일을 반환"""
+        return self.get_next_off_day(date, -offset)
+
+
+class ODI_calculation(ODI_base_calculation):
+    """
+    ODI를 계산하는 클래스
+    ---- ODI 조회 ----
+    next_day, next_open_day, next_off_day 메쏘드는 자동으로 금일기준으로 조회. offset 사용 가능 
+        Fixme: 미래시점의 경우, DB에 없는 경우 처리가 필요.
+    get_next_day, get_next_open_day, get_next_off_day 메쏘드의 경우 특정일을 기준으로 사용할 수 있다. 
+    """
+    @property
+    def next_day(self):
+        """오늘 기준으로 다음 날을 반환한다."""
+        return self.get_next_day(pd.Timestamp.today().normalize())
+    @property
+    def next_open_day(self):
+        """오늘 기준으로 다음 개장일을 반환한다."""
+        return self.get_next_open_day(pd.Timestamp.today().normalize())
+    @property
+    def next_off_day(self):
+        """오늘 기준으로 다음 휴일을 반환한다."""
+        return self.get_next_off_day(pd.Timestamp.today().normalize())
+    @property
+    def prev_day(self):
+        """오늘 기준으로 이전 날을 반환한다."""
+        return self.get_next_day(pd.Timestamp.today().normalize(), -1)
+    @property
+    def prev_open_day(self):
+        """오늘 기준으로 이전 개장일을 반환한다."""
+        return self.get_next_open_day(pd.Timestamp.today().normalize(), -1)
+    @property
+    def recent_open_day(self):
+        """금일 포함 최근 개장일을 반환한다."""
+        if self.today_is_openday:
+            return self.today
+        return self.recent_open_day_except_today
+    @property
+    def recent_open_day_except_today(self):
+        """오늘을 제외한 최근 개장일을 반환한다."""
+        return self.get_prev_open_day(self.today)
+    @property
+    def second_recent_open_day(self):
+        """금일 포함 두번째로 최근 개장일을 반환한다.
+        즉, 오늘이 개장일인 경우, 이전 개장일을 반환하고, 
+        오늘이 휴일인 경우, 전전 개장일을 반환한다.
+        """
+        if self.today_is_openday:
+            return self.get_prev_open_day(self.today)
+        return self.get_prev_open_day(self.today, 2)
+    
+    # 최근 개장일 인덱스 반환
+    def get_recent_open_days_index(self, past_days:int=5, forward_days:int=5):
+        """금일을 기준으로 최근 개장일의 인덱스를 반환한다.
+        past_days: 과거 개장일 수
+        forward_days: 미래 개장일 수
+        """
+        past = self.ondays[self.ondays <= self.today][-past_days:]  # 과거 개장일
+        forward = self.ondays[self.ondays > self.today][:forward_days]
+        return past.append(forward).sort_values()
+    def get_recent_past_open_days_index(self, past_days:int=5):
+        """금일을 포함한 최근 과거 개장일의 인덱스를 반환한다.
+        past_days: 과거 개장일 수
+        """
+        return self.get_recent_open_days_index(past_days, 0)
+    @property
+    def recent_open_days_index(self):
+        return self.get_recent_open_days_index(5, 5)
+    @property
+    def recent_past_open_days_index(self):
+        return self.get_recent_past_open_days_index(5)
+    @property
+    def recent_future_open_days_index(self):
+        return self.get_recent_open_days_index(0, 5) # 금일 제외 미래 개장일만
+    
+    # 특정일 개장유무 조회 - 해당일이 index에 없는 경우 에러 발생
+    def is_open_day(self, date: datetime.date):
+        """특정일이 개장일인지 확인한다."""
+        date = pd.to_datetime(date).normalize()
+        if date not in self.days:
+            raise ValueError(f"{date} is not in the index of ODI DataFrame.")
+        return True if date in self.ondays else False
+    # 개장일 range 조회
+    def get_open_days(self, start_date: pd.Timestamp, end_date: pd.Timestamp):
+        """특정 기간 내의 개장일을 반환한다."""
+        start_date = pd.to_datetime(start_date).normalize()
+        end_date = pd.to_datetime(end_date).normalize()
+        return self.ondays[(self.ondays >= start_date) & (self.ondays <= end_date)]
+
+
+class OpeningDayInformation(ODI_calculation):    
+    """
+    ODI를 유지하고 사용하는 클래스. 내부적인 작동은 감추도록 한다 > 외부에서 사용하는 함수들에 대해서만 정의할 것
+    1. 필요한 기능
+    -1. 특정일 추가 - 휴일, 개장일 모두 추가 가능
+    -2. 특정일이 개장일인지 확인
+    추후
+    -3. 특정일의 개장/폐장 시간도 설정 가능
+    
+    DF의 구조
+    - index로 date를 사용. date는 pd.Timestamp
+    - columns: '일자', '개장여부', '개장시간', '폐장시간'
+    """
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        self.fetch_whole() # ODI DataFrame을 서버에서 가져온다.
+        # print(self.df.index)
+
+odi = OpeningDayInformation()
+
+def test_add():
+    """ODI에 특정일을 추가하는 테스트"""
+    odi.add_onday('2027-01-01')
+    
+def test_df_recent():
+    print("Testing df_recent property...")
+    print(odi.df_recent)
+    print("Testing df_past_recent property...")
+    print(odi.df_past_recent)
+    print("Testing df_future_recent property...")
+    print(odi.df_future_recent)
+    
+if __name__ == '__main__':
+    print(odi.get_recent_open_days_index())
+    print(odi.get_recent_past_open_days_index())
+    print("Finished ODI test.")