analyser_hj3415 3.2.2__py3-none-any.whl → 3.3.1__py3-none-any.whl

analyser_hj3415/analyser/eval/common.py

@@ -9,22 +9,34 @@ mylogger = setup_logger(__name__,'WARNING')
 
 
 class Tools:
+    """
+    재무 데이터 분석 및 계산에 필요한 유틸리티 메서드를 제공하는 클래스.
+
+    이 클래스는 주어진 재무 데이터를 기반으로 다양한 계산을 수행하며,
+    로그를 통해 계산 과정 및 결과를 디버깅할 수 있도록 지원합니다.
+
+    주요 기능:
+        - Sigmoid 및 로그 점수 계산.
+        - 두 값 간의 괴리율(Deviation) 계산.
+        - 유효하지 않은 값(NaN, None 등) 필터링.
+        - 당기순이익, 유동자산, 유동부채 계산 등.
+    """
     @staticmethod
     def sigmoid_score(deviation, a=1.0, b=2.0):
-        """
-        Calculates a normalized score using a sigmoid function based on the provided deviation value.
+        """"
+        주어진 괴리율(Deviation)에 대해 Sigmoid 함수를 적용하여 점수를 계산합니다.
 
-        This method applies the sigmoid function to a logarithmically transformed deviation value
-        to map it to a range between 0 and 100. The shape of the sigmoid curve can be adjusted
-        with parameters `a` and `b`.
+        이 함수는 Sigmoid 함수에 로그 변환된 괴리율을 입력으로 사용하며,
+        결과를 0에서 100 사이의 점수로 변환합니다. `a`와 `b` 매개변수를 사용하여
+        Sigmoid 곡선의 기울기와 x-축 오프셋을 조정할 수 있습니다.
 
-        Parameters:
-            deviation (float): The deviation value to be transformed. Must be a non-negative value.
-            a (float): The steepness of the sigmoid curve. Default is 1.0.
-            b (float): The x-offset for the sigmoid curve. Default is 2.0.
+        매개변수:
+            deviation (float): 계산할 괴리율 값 (0 이상의 값이어야 함).
+            a (float): Sigmoid 곡선의 기울기 조정값. 기본값은 1.0.
+            b (float): Sigmoid 곡선의 x-축 오프셋. 기본값은 2.0.
 
-        Returns:
-            float: A score between 0 and 100 derived from the provided deviation value.
+        반환값:
+            float: Sigmoid 함수로 변환된 0~100 사이의 점수.
         """
         # 예: x = log10(deviation + 1)
         x = math.log10(deviation + 1)
@@ -34,40 +46,33 @@ class Tools:
     @staticmethod
     def log_score(deviation):
         """
-            Compute and return the logarithmic score scaled by a constant factor.
+        주어진 괴리율(Deviation)에 대해 로그 점수를 계산합니다.
 
-            This method takes a numerical deviation value, adds one to it, computes its
-            base-10 logarithm, and then multiplies the result by a constant factor of 33
-            to scale the resulting logarithmic score.
+        괴리율 값에 1을 더한 뒤, 로그 변환(Base-10)을 수행하고
+        결과를 상수(33)로 곱하여 점수를 계산합니다.
 
-            Parameters:
-                deviation (float): The numerical deviation value to calculate the
-                logarithmic score for. Should be a non-negative number.
+        매개변수:
+            deviation (float): 계산할 괴리율 값.
 
-            Returns:
-                float: The scaled logarithmic score computed based on the input deviation.
+        반환값:
+            float: 계산된 로그 점수.
         """
         return math.log10(deviation + 1) * 33
 
     @staticmethod
     def cal_deviation(v1: float, v2: float) -> float:
         """
-            Calculates the percentage deviation between two values.
-
-            This method computes the percentage deviation of the second value
-            from the first value based on the formula:
-            deviation = abs((v1 - v2) / v1) * 100. In the event the first value is
-            zero (division by zero), the function will return NaN to signify
-            an invalid computation.
-
-            Parameters:
-            v1 (float): The reference value. It represents the base for the relative
-                        deviation calculation.
-            v2 (float): The value to compare against the reference.
-
-            Returns:
-            float: The computed percentage deviation. Returns NaN if the reference
-                   value (v1) is zero.
+        두 값 간의 퍼센트 괴리율(Deviation)을 계산합니다.
+
+        주어진 두 값 간의 상대적 차이를 백분율로 반환합니다.
+        기준값(v1)이 0인 경우, 계산은 NaN을 반환합니다.
+
+        매개변수:
+            v1 (float): 기준값.
+            v2 (float): 비교할 값.
+
+        반환값:
+            float: 두 값 간의 퍼센트 괴리율. 기준값이 0인 경우 NaN.
         """
         try:
             deviation = abs((v1 - v2) / v1) * 100
@@ -78,50 +83,33 @@ class Tools:
     @staticmethod
     def date_set(*args) -> list:
         """
-            인자로 받은 값의 비유효한 내용 제거(None,nan)하고 중복된 항목 제거하고 리스트로 반환한다.
+        주어진 값들에서 유효하지 않은 값을 제거하고 중복 없이 리스트로 반환합니다.
 
-            여기서 set의 의미는 집합을 뜻함
+        NaN, None, 빈 문자열 등 유효하지 않은 값을 필터링한 뒤,
+        고유한 값만 포함하는 리스트를 생성합니다.
 
-            Filters and returns a list of unique non-null, non-empty values from
-            the provided arguments.
+        매개변수:
+            *args: 필터링할 값들.
 
-            This static method processes the input arguments to retain only unique
-            values that are not empty strings, NaN values, or None. The result is
-            returned as a list.
-
-            Args:
-                *args: Arbitrary positional arguments to be filtered.
-
-            Returns:
-                list: A list of unique values after filtering out invalid entries.
+        반환값:
+            list: 유효한 값만 포함하는 고유 리스트.
         """
         return [i for i in {*args} if i != "" and i is not math.nan and i is not None]
 
     @staticmethod
     def calc당기순이익(c103: myredis.C103, refresh: bool) -> Tuple[str, float]:
         """
-            지배지분 당기순이익 계산
-
-            일반적인 경우로는 직전 지배주주지분 당기순이익을 찾아서 반환한다.
-
-            금융기관의 경우는 지배당기순이익이 없기 때문에 계산을 통해서 간접적으로 구한다.
+        지배주주지분 당기순이익을 계산하여 반환합니다.
 
-            Calculates "지배당기순이익" (Controlling Comprehensive Income) based on the given
-            financial data. The method retrieves or computes the value utilizing methods from
-            the `myredis.C103` class. It handles missing or 'Not-a-Number' conditions by
-            manually calculating from quarterly and annual financial figures. Logs the process
-            at various stages for debugging and auditing.
+        기본적으로 재무 데이터에서 지배주주지분 당기순이익을 검색하며,
+        데이터가 없거나 유효하지 않은 경우 간접적으로 계산합니다.
 
-            Args:
-                c103 (myredis.C103): An instance containing financial data and utilities to
-                    access specific data points for the targeted calculation.
-                refresh (bool): A flag to determine whether or not to refresh the data
-                    while accessing or computing financial values.
+        매개변수:
+            c103 (myredis.C103): 재무 데이터에 접근하기 위한 객체.
+            refresh (bool): 데이터를 새로고침할지 여부.
 
-            Returns:
-                Tuple[str, float]: A tuple where the first item is the most relevant date for
-                    the calculated or retrieved value, and the second item is the calculated
-                    or retrieved "지배당기순이익" (Controlling Comprehensive Income).
+        반환값:
+            Tuple[str, float]: 날짜와 계산된 지배주주지분 당기순이익.
         """
         name = myredis.Corps(c103.code, 'c101').get_name(refresh=refresh)
 
@@ -156,35 +144,17 @@ class Tools:
     @staticmethod
     def calc유동자산(c103: myredis.C103, refresh: bool) -> Tuple[str, float]:
         """
-            유효한 유동자산 계산
+        기업의 유동자산을 계산하여 반환합니다.
 
-            일반적인 경우로 유동자산을 찾아서 반환한다.
+        최근 4분기의 데이터를 기반으로 유동자산을 계산하며,
+        데이터가 없거나 유효하지 않을 경우 간접적으로 계산합니다.
 
-            금융기관의 경우는 간접적으로 계산한다.
+        매개변수:
+            c103 (myredis.C103): 재무 데이터에 접근하기 위한 객체.
+            refresh (bool): 데이터를 새로고침할지 여부.
 
-            Calculates the current assets for a given company code.
-
-            For a specified company, the function calculates the recent 4-quarter
-            sum of current assets if available. If the data is not available or
-            contains invalid values, it attempts to calculate the current assets
-            manually using financial asset data such as cash equivalents, trading
-            securities, available-for-sale securities, and held-to-maturity securities.
-
-            Logs relevant information and warnings during the calculation process,
-            including any cases where data is unavailable or a manual calculation
-            is required.
-
-            Parameters:
-                c103 (myredis.C103): The instance representing financial data of a
-                    specific company. This includes methods to extract and calculate
-                    various data points.
-                refresh (bool): Indicator flag to determine whether to refresh the
-                    underlying data before performing calculations.
-
-            Returns:
-                Tuple[str, float]: A tuple containing the date associated with the
-                    financial data and the calculated or retrieved value of current
-                    assets. If dates are not available, the date field may be empty.
+        반환값:
+            Tuple[str, float]: 날짜와 계산된 유동자산.
         """
 
         name = myredis.Corps(c103.code, 'c101').get_name(refresh=refresh)
@@ -220,25 +190,17 @@ class Tools:
     @staticmethod
     def calc유동부채(c103: myredis.C103, refresh: bool) -> Tuple[str, float]:
         """
-            유효한 유동부채 계산
-
-            일반적인 경우로 유동부채를 찾아서 반환한다.
-
-            금융기관의 경우는 간접적으로 계산한다.
-
-            Calculate '유동부채' (Current Liabilities) based on financial data of a specific entity.
+        기업의 유동부채를 계산하여 반환합니다.
 
-            This static method computes the recent '유동부채' value either from the sum of recent four
-            quarters using predefined keys or calculates manually if no valid data is available.
-            It includes logging for intermediate steps and supports handling missing values by logging
-            warnings and attempting a composed manual computation using alternative financial terms.
+        최근 4분기의 데이터를 기반으로 유동부채를 계산하며,
+        데이터가 없거나 유효하지 않을 경우 간접적으로 계산합니다.
 
-            Args:
-                c103 (myredis.C103): The object containing financial data and operations for obtaining the required data.
-                refresh (bool): A flag to indicate whether to fetch the latest data forcibly.
+        매개변수:
+            c103 (myredis.C103): 재무 데이터에 접근하기 위한 객체.
+            refresh (bool): 데이터를 새로고침할지 여부.
 
-            Returns:
-                Tuple[str, float]: A tuple containing the `date` of financial data and the computed '유동부채' value.
+        반환값:
+            Tuple[str, float]: 날짜와 계산된 유동부채.
         """
 
         name = myredis.Corps(c103.code, 'c101').get_name(refresh=refresh)

analyser_hj3415/analyser/eval/growth.py

@@ -1,5 +1,5 @@
 import os
-from dataclasses import dataclass, asdict
+from dataclasses import dataclass
 
 from utils_hj3415 import tools, setup_logger
 from db_hj3415 import myredis
@@ -13,6 +13,21 @@ expire_time = tools.to_int(os.getenv('DEFAULT_EXPIRE_TIME_H', 48)) * 3600
 
 @dataclass()
 class GrowthData:
+    """
+    기업의 성장 데이터를 저장하는 데이터 클래스.
+
+    이 클래스는 기업의 성장 데이터를 관리하며, 매출액 증가율 및 영업이익률 데이터를 포함합니다.
+    또한, 평가 점수와 관련된 날짜 데이터를 관리합니다.
+
+    속성:
+        code (str): 기업의 종목 코드 (6자리 숫자 문자열).
+        name (str): 기업명.
+        매출액증가율_r (float): 최신 매출액 증가율.
+        매출액증가율_dict (dict): 매출액 증가율과 관련된 과거 데이터.
+        영업이익률_c106 (dict): c106 데이터를 기반으로 한 영업이익률 데이터.
+        score (list): 평가 점수.
+        date (list): 성장 데이터와 관련된 날짜 목록.
+    """
     code: str
     name: str
 
@@ -26,6 +41,19 @@ class GrowthData:
 
 
 class Growth:
+    """
+    기업의 성장 데이터를 계산하고 관리하는 클래스.
+
+    이 클래스는 기업의 매출액 증가율, 영업이익률 등과 같은 성장 지표를 계산하며,
+    Redis 캐시를 통해 데이터를 저장하고 재사용할 수 있도록 지원합니다.
+
+    속성:
+        c101 (myredis.C101): 기업 정보와 데이터를 가져오기 위한 객체.
+        c104 (myredis.C104): 매출액 증가율 데이터를 관리하기 위한 객체.
+        c106 (myredis.C106): 영업이익률 데이터를 관리하기 위한 객체.
+        name (str): 기업명.
+        _code (str): 기업 종목 코드.
+    """
     def __init__(self, code: str):
         assert tools.is_6digit(code), f'Invalid value : {code}'
         mylogger.debug(f"Growth : 종목코드 ({code})")
@@ -42,10 +70,27 @@ class Growth:
 
     @property
     def code(self) -> str:
+        """
+        현재 기업의 종목 코드를 반환합니다.
+
+        반환값:
+            str: 기업의 종목 코드 (6자리 숫자 문자열).
+        """
         return self._code
 
     @code.setter
     def code(self, code: str):
+        """
+        기업의 종목 코드를 변경합니다.
+
+        종목 코드 변경 시 관련된 데이터 객체(c101, c104, c106)의 코드도 함께 변경됩니다.
+
+        매개변수:
+            code (str): 변경할 종목 코드 (6자리 숫자 문자열).
+
+        예외:
+            AssertionError: 종목 코드가 6자리 숫자 문자열이 아닐 경우 발생.
+        """
         assert tools.is_6digit(code), f'Invalid value : {code}'
         mylogger.debug(f"Growth : 종목코드 변경({self.code} -> {code})")
 
@@ -60,6 +105,21 @@ class Growth:
         return [0,]
 
     def _generate_data(self, refresh=False) -> GrowthData:
+        """
+        성장 데이터를 계산하여 GrowthData 객체를 생성합니다.
+
+        이 함수는 매출액 증가율, 영업이익률 등의 데이터를 계산하고,
+        이를 GrowthData 객체로 정리하여 반환합니다.
+
+        매개변수:
+            refresh (bool, optional): 데이터를 새로고침할지 여부. 기본값은 False.
+
+        반환값:
+            GrowthData: 계산된 성장 데이터를 포함하는 객체.
+
+        예외:
+            ValueError: 날짜 데이터가 없을 경우 기본값으로 빈 날짜 리스트를 설정.
+        """
         self.c104.page = 'c104y'
         _, 매출액증가율_dict = self.c104.find('매출액증가율', remove_yoy=True, refresh=refresh)
 
@@ -95,9 +155,20 @@ class Growth:
 
     def get(self, refresh = False, verbose = True) -> GrowthData:
         """
-        GrowthData 형식의 데이터를 계산하여 리턴하고 레디스 캐시에 저장한다.
-        :param refresh:
-        :return:
+        GrowthData 객체를 Redis 캐시에서 가져오거나 새로 생성하여 반환합니다.
+
+        캐시에서 데이터를 검색하고, 없을 경우 `_generate_data`를 호출하여 데이터를 생성합니다.
+        생성된 데이터는 Redis 캐시에 저장되어 재사용됩니다.
+
+        매개변수:
+            refresh (bool, optional): 캐시 데이터를 무시하고 새로 계산할지 여부. 기본값은 False.
+            verbose (bool, optional): 실행 중 상세 정보를 출력할지 여부. 기본값은 True.
+
+        반환값:
+            GrowthData: Redis 캐시에서 가져오거나 새로 생성된 GrowthData 객체.
+
+        로그:
+            - 캐시 검색 상태와 새로 생성된 데이터를 출력합니다.
         """
         redis_name = f"{self.code}_growth"
         mylogger.info(f"{self} GrowthData를 레디스캐시에서 가져오거나 새로 생성합니다.. refresh : {refresh}")
@@ -105,6 +176,6 @@ class Growth:
             print(f"{self} redisname: '{redis_name}' / refresh : {refresh} / expire_time : {expire_time/3600}h")
 
         def fetch_generate_data(refresh_in: bool) -> dict:
-            return asdict(self._generate_data(refresh_in))
+            return self._generate_data(refresh_in) # type: ignore
 
-        return GrowthData(**myredis.Base.fetch_and_cache_data(redis_name, refresh, fetch_generate_data, refresh, timer=expire_time))
+        return myredis.Base.fetch_and_cache_data(redis_name, refresh, fetch_generate_data, refresh, timer=expire_time)

analyser_hj3415/analyser/eval/mil.py

@@ -1,5 +1,5 @@
 import os
-from dataclasses import dataclass, asdict
+from dataclasses import dataclass
 from typing import Tuple
 import math
 
@@ -15,6 +15,32 @@ expire_time = tools.to_int(os.getenv('DEFAULT_EXPIRE_TIME_H', 48)) * 3600
 
 @dataclass
 class MilData:
+    """
+    기업의 주요 재무 데이터를 나타내는 데이터 클래스.
+
+    이 클래스는 기업의 다양한 재무 데이터를 포함하며,
+    이를 통해 투자 수익률, 가치 지표, 현금 흐름 등을 분석할 수 있습니다.
+
+    속성:
+        code (str): 기업의 종목 코드 (6자리 숫자 문자열).
+        name (str): 기업명.
+        시가총액억 (float): 기업의 시가총액 (억 단위).
+        주주수익률 (float): 재무활동 현금흐름을 기반으로 계산된 주주 수익률.
+        재무활동현금흐름 (float): 재무활동으로 인한 현금흐름.
+        이익지표 (float): 기업의 이익지표.
+        영업활동현금흐름 (float): 영업활동으로 인한 현금흐름.
+        지배주주당기순이익 (float): 지배주주에게 귀속된 당기순이익.
+        roic_r (float): ROIC(투하자본이익률).
+        roic_dict (dict): ROIC와 관련된 데이터.
+        roe_r (float): ROE(자기자본이익률).
+        roe_106 (dict): ROE와 관련된 상세 데이터.
+        roa_r (float): ROA(총자산이익률).
+        fcf_dict (dict): FCF(자유 현금 흐름) 관련 데이터.
+        pfcf_dict (dict): PFCF(주가 대비 자유 현금 흐름 비율) 관련 데이터.
+        pcr_dict (dict): PCR(주가 대비 현금 흐름 비율) 관련 데이터.
+        score (list): 계산된 평가 점수.
+        date (list): 재무 데이터와 관련된 날짜 목록.
+    """
     code: str
     name: str
 
@@ -44,6 +70,21 @@ class MilData:
 
 
 class Mil:
+    """
+    기업의 재무 데이터를 분석하고 계산하는 클래스.
+
+    이 클래스는 주어진 종목 코드에 대해 다양한 재무 데이터를 수집하고,
+    이를 기반으로 주요 재무 지표(예: ROIC, ROE, 이익지표 등)를 계산합니다.
+    또한 Redis 캐시를 활용하여 계산된 데이터를 저장하고 재사용할 수 있습니다.
+
+    속성:
+        c101 (myredis.C101): 기업 정보 및 최근 데이터 접근 객체.
+        c103 (myredis.C103): 재무 상태표 데이터 접근 객체.
+        c104 (myredis.C104): 투자 지표 데이터 접근 객체.
+        c106 (myredis.C106): ROE 관련 데이터 접근 객체.
+        name (str): 기업명.
+        _code (str): 기업 종목 코드.
+    """
     def __init__(self, code: str):
         assert tools.is_6digit(code), f'Invalid value : {code}'
         mylogger.debug(f"Mil : 종목코드 ({code})")
@@ -78,8 +119,16 @@ class Mil:
 
     def get_marketcap억(self, refresh: bool) -> float:
         """
-        시가총액(억원) 반환
-        :return:
+        기업의 시가총액(억 단위)을 반환합니다.
+
+        매개변수:
+            refresh (bool): 데이터를 새로고침할지 여부.
+
+        반환값:
+            float: 기업의 시가총액 (억 단위).
+
+        로그:
+            - 계산된 시가총액 정보를 출력합니다.
         """
         c101r = self.c101.get_recent(refresh)
         시가총액 = tools.to_int(tools.to_float(c101r.get('시가총액', math.nan)) / 100000000)
@@ -87,6 +136,19 @@ class Mil:
         return 시가총액
 
     def _calc주주수익률(self, 시가총액_억: float, refresh: bool) -> Tuple[str, float, float]:
+        """
+        주주수익률을 계산합니다.
+
+        매개변수:
+            시가총액_억 (float): 기업의 시가총액 (억 단위).
+            refresh (bool): 데이터를 새로고침할지 여부.
+
+        반환값:
+            Tuple[str, float, float]: 최근 날짜, 주주수익률, 재무활동 현금흐름.
+
+        예외:
+            ZeroDivisionError: 시가총액이 0일 경우 주주수익률을 계산하지 못합니다.
+        """
         self.c103.page = 'c103현금흐름표q'
         d, 재무활동현금흐름 = self.c103.sum_recent_4q('재무활동으로인한현금흐름', refresh)
         try:
@@ -97,6 +159,19 @@ class Mil:
         return d, 주주수익률, 재무활동현금흐름
 
     def _calc이익지표(self, 시가총액_억: float, refresh: bool) -> Tuple[str, float, float, float]:
+        """
+        이익지표를 계산합니다.
+
+        매개변수:
+            시가총액_억 (float): 기업의 시가총액 (억 단위).
+            refresh (bool): 데이터를 새로고침할지 여부.
+
+        반환값:
+            Tuple[str, float, float, float]: 최근 날짜, 이익지표, 영업활동 현금흐름, 지배주주 당기순이익.
+
+        예외:
+            ZeroDivisionError: 시가총액이 0일 경우 이익지표를 계산하지 못합니다.
+        """
         d1, 지배주주당기순이익 = Tools.calc당기순이익(self.c103, refresh)
         self.c103.page = 'c103현금흐름표q'
         d2, 영업활동현금흐름 = self.c103.sum_recent_4q('영업활동으로인한현금흐름', refresh)
@@ -113,6 +188,15 @@ class Mil:
         return date , 이익지표, 영업활동현금흐름, 지배주주당기순이익
 
     def _calc투자수익률(self, refresh: bool) -> tuple:
+        """
+        ROIC, ROE, ROA 등의 투자 수익률을 계산합니다.
+
+        매개변수:
+            refresh (bool): 데이터를 새로고침할지 여부.
+
+        반환값:
+            tuple: 계산된 ROIC, ROE, ROA 및 관련 데이터.
+        """
         self.c104.page = 'c104q'
         self.c106.page = 'c106q'
         d1, roic_r = self.c104.sum_recent_4q('ROIC', refresh)
@@ -131,13 +215,16 @@ class Mil:
 
     def _calcFCF(self, refresh: bool) -> dict:
         """
-        FCF 계산
-        Returns:
-            dict: 계산된 fcf 딕셔너리 또는 영업현금흐름 없는 경우 - {}
+        자유 현금 흐름(FCF)을 계산합니다.
+
+        매개변수:
+            refresh (bool): 데이터를 새로고침할지 여부.
 
-        Note:
-            CAPEX 가 없는 업종은 영업활동현금흐름을 그대로 사용한다.\n
+        반환값:
+            dict: 계산된 FCF 딕셔너리. 영업활동 현금흐름 데이터가 없는 경우 빈 딕셔너리를 반환합니다.
 
+        참고:
+            - CAPEX가 없는 업종의 경우, 영업활동 현금흐름을 그대로 사용합니다.
         """
         self.c103.page = 'c103현금흐름표y'
         _, 영업활동현금흐름_dict = self.c103.find('영업활동으로인한현금흐름', remove_yoy=True, del_unnamed_key=True, refresh=refresh)
@@ -172,13 +259,16 @@ class Mil:
         return dict(sorted(fcf_dict.items(), reverse=False))
 
     def _calcPFCF(self, 시가총액_억: float, fcf_dict: dict) -> dict:
-        """Price to Free Cash Flow Ratio(주가 대비 자유 현금 흐름 비율)계산
+        """
+        PFCF(Price to Free Cash Flow Ratio)를 계산합니다.
 
-            PFCF = 시가총액 / FCF
+        매개변수:
+            시가총액_억 (float): 기업의 시가총액 (억 단위).
+            fcf_dict (dict): 자유 현금 흐름(FCF) 데이터.
 
-            Note:
-                https://www.investopedia.com/terms/p/pricetofreecashflow.asp
-            """
+        반환값:
+            dict: 계산된 PFCF 딕셔너리.
+        """
         if math.isnan(시가총액_억):
             mylogger.warning(f"{self} - 시가총액이 nan으로 pFCF를 계산할수 없습니다.")
             return {}
@@ -259,9 +349,20 @@ class Mil:
 
     def get(self, refresh = False, verbose = True) -> MilData:
         """
-        MilData 형식의 데이터를 계산하여 리턴하고 레디스 캐시에 저장한다.
-        :param refresh:
-        :return:
+        MilData 객체를 Redis 캐시에서 가져오거나 새로 생성하여 반환합니다.
+
+        캐시에서 데이터를 검색하고, 없을 경우 `_generate_data`를 호출하여 데이터를 생성합니다.
+        생성된 데이터는 Redis 캐시에 저장되어 재사용됩니다.
+
+        매개변수:
+            refresh (bool): 캐시를 무시하고 새로 데이터를 계산할지 여부. 기본값은 False.
+            verbose (bool): 실행 중 상세 정보를 출력할지 여부. 기본값은 True.
+
+        반환값:
+            MilData: Redis 캐시에서 가져오거나 새로 생성된 MilData 객체.
+
+        로그:
+            - 캐시 검색 상태와 새로 생성된 데이터를 출력합니다.
         """
         redis_name = f"{self.code}_mil"
         mylogger.info(f"{self} MilData를 레디스캐시에서 가져오거나 새로 생성합니다.. refresh : {refresh}")
@@ -269,6 +370,6 @@ class Mil:
             print(f"{self} redisname: '{redis_name}' / refresh : {refresh} / expire_time : {expire_time/3600}h")
 
         def fetch_generate_data(refresh_in: bool) -> dict:
-            return asdict(self._generate_data(refresh_in))
+            return self._generate_data(refresh_in) # type: ignore
 
-        return MilData(**myredis.Base.fetch_and_cache_data(redis_name, refresh, fetch_generate_data, refresh, timer=expire_time))
+        return myredis.Base.fetch_and_cache_data(redis_name, refresh, fetch_generate_data, refresh, timer=expire_time)