echoss-common 1.0.0__tar.gz

echoss_common-1.0.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+exclude tests/__pycache__/
+recursive-include echoss_fileformat *.txt *.md
+recursive-include tests *
+recursive-exclude tests __pycache__/*
+recursive-exclude * *.log *.log.*
+recursive-exclude * .*.un~

echoss_common-1.0.0/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: echoss-common
+Version: 1.0.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>6.0.2
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+
+# echoss-common
+
+echoss AI Bigdata Center 공통 유틸리티 라이브러리입니다.
+로깅(Logger)과 파일 포맷(FileUtil) 기능을 제공합니다.
+
+## 설치
+
+```bash
+pip install echoss-common
+```
+
+## 요구사항
+
+- Python >= 3.12
+- pyyaml > 6.0.2
+
+---
+
+## 기능
+
+### 1. Logger (`echoss_logger`)
+
+타임드 로테이팅 파일 핸들러와 콘솔 핸들러를 지원하는 로거 유틸리티입니다.
+
+#### 함수 목록
+
+| 함수 | 설명 |
+|------|------|
+| `get_logger()` | 새 로거 생성 또는 기존 로거 갱신 |
+| `use_logger()` | 이미 생성된 로거를 서브모듈에서 가져오기 |
+| `set_logger_level()` | 로거 레벨 변경 |
+| `modify_loggers_by_prefix()` | 이름 prefix로 여러 로거를 일괄 수정 |
+
+#### 상수
+
+| 상수 | 값 |
+|------|----|
+| `LOG_FORMAT_DETAIL` | `[날짜시간] 레벨 모듈.함수.라인 : 메시지` 형식 |
+
+#### 사용 예시
+
+```python
+from echoss_common import get_logger, use_logger, set_logger_level, modify_loggers_by_prefix, LOG_FORMAT_DETAIL
+
+# 기본 로거 생성 (콘솔 + 파일 출력)
+logger = get_logger(
+    logger_name='myapp',
+    logger_format=LOG_FORMAT_DETAIL,   # 상세 포맷 사용 (선택)
+    file_path='logs/myapp.log',        # 로그 파일 경로 (기본: logs/echoss.log)
+    backup_count=7,                    # 보관할 로그 파일 수 (0이면 전부 보관)
+    use_console=True,                  # 콘솔 출력 여부
+    level='DEBUG'                      # 로그 레벨
+)
+
+logger.info("애플리케이션 시작")
+logger.debug("디버그 메시지")
+logger.error("오류 발생")
+
+# 서브모듈에서 기존 로거 재사용
+logger = use_logger('myapp')
+logger.info("서브모듈에서 로거 사용")
+
+# 로거 레벨만 변경
+set_logger_level(logger, 'WARNING')
+
+# prefix로 시작하는 모든 로거 일괄 수정
+modify_loggers_by_prefix(
+    prefix='myapp',
+    new_format=LOG_FORMAT_DETAIL,
+    new_path='logs/myapp.log',
+    level='INFO'
+)
+```
+
+---
+
+### 2. FileUtil (`fileformat`)
+
+설정 파일(YAML, JSON, XML, Properties)을 딕셔너리로 읽고 쓰는 유틸리티 클래스입니다.
+
+#### 메서드 목록
+
+| 메서드 | 설명 |
+|--------|------|
+| `FileUtil.dict_load()` | 설정 파일을 `dict`로 읽기 |
+| `FileUtil.dict_dump()` | `dict`를 설정 파일로 쓰기 |
+
+#### 지원 포맷
+
+| 확장자 | 포맷 |
+|--------|------|
+| `.yaml`, `.yml` | YAML |
+| `.json` | JSON |
+| `.xml` | XML |
+| `.properties` | Java Properties |
+
+#### 사용 예시
+
+```python
+from echoss_common.fileformat import FileUtil
+
+# YAML 파일 읽기
+config = FileUtil.dict_load('config/settings.yaml')
+print(config)
+
+# JSON 파일 읽기
+data = FileUtil.dict_load('config/params.json')
+
+# Properties 파일 읽기
+props = FileUtil.dict_load('config/app.properties')
+
+# dict를 YAML 파일로 저장
+settings = {'host': 'localhost', 'port': 8080, 'debug': True}
+FileUtil.dict_dump(settings, 'config/settings.yaml')
+
+# dict를 JSON 파일로 저장 (들여쓰기 지정 가능)
+FileUtil.dict_dump(settings, 'config/settings.json', indent=2)
+
+# 파일이 이미 존재할 때 덮어쓰기 방지
+FileUtil.dict_dump(settings, 'config/settings.yaml', force_write=False)
+```
+
+---
+
+## API 참조
+
+### `get_logger(logger_name, logger_format, file_path, backup_count, use_console, level)`
+
+| 파라미터 | 타입 | 기본값 | 설명 |
+|----------|------|--------|------|
+| `logger_name` | str | `'echoss'` | 로거 이름 |
+| `logger_format` | str | `LOG_FORMAT` | 로그 포맷 문자열 |
+| `file_path` | str | `'logs/echoss.log'` | 로그 파일 경로 (`None`이면 파일 미사용) |
+| `backup_count` | int | `0` | 보관할 로테이팅 파일 수 (0이면 전부 보관) |
+| `use_console` | bool | `True` | 콘솔 출력 여부 |
+| `level` | str\|int | `'DEBUG'` | 로그 레벨 |
+
+### `FileUtil.dict_load(file_path, file_format, **kwargs)`
+
+| 파라미터 | 타입 | 기본값 | 설명 |
+|----------|------|--------|------|
+| `file_path` | str | — | 읽을 파일 경로 |
+| `file_format` | str | `None` | 포맷 강제 지정 (미지정 시 확장자 자동 인식) |
+
+### `FileUtil.dict_dump(config, file_path, file_format, force_write, xml_tag, **kwargs)`
+
+| 파라미터 | 타입 | 기본값 | 설명 |
+|----------|------|--------|------|
+| `config` | dict | — | 저장할 딕셔너리 |
+| `file_path` | str | — | 저장할 파일 경로 |
+| `file_format` | str | `None` | 포맷 강제 지정 (미지정 시 확장자 자동 인식) |
+| `force_write` | bool | `True` | 기존 파일 덮어쓰기 여부 |
+| `xml_tag` | str | `None` | XML 저장 시 루트 태그 이름 |
+
+---
+
+## 라이선스
+
+echoss AI Bigdata Center

echoss_common-1.0.0/README.md

@@ -0,0 +1,159 @@
+# echoss-common
+
+echoss AI Bigdata Center 공통 유틸리티 라이브러리입니다.
+로깅(Logger)과 파일 포맷(FileUtil) 기능을 제공합니다.
+
+## 설치
+
+```bash
+pip install echoss-common
+```
+
+## 요구사항
+
+- Python >= 3.12
+- pyyaml > 6.0.2
+
+---
+
+## 기능
+
+### 1. Logger (`echoss_logger`)
+
+타임드 로테이팅 파일 핸들러와 콘솔 핸들러를 지원하는 로거 유틸리티입니다.
+
+#### 함수 목록
+
+| 함수 | 설명 |
+|------|------|
+| `get_logger()` | 새 로거 생성 또는 기존 로거 갱신 |
+| `use_logger()` | 이미 생성된 로거를 서브모듈에서 가져오기 |
+| `set_logger_level()` | 로거 레벨 변경 |
+| `modify_loggers_by_prefix()` | 이름 prefix로 여러 로거를 일괄 수정 |
+
+#### 상수
+
+| 상수 | 값 |
+|------|----|
+| `LOG_FORMAT_DETAIL` | `[날짜시간] 레벨 모듈.함수.라인 : 메시지` 형식 |
+
+#### 사용 예시
+
+```python
+from echoss_common import get_logger, use_logger, set_logger_level, modify_loggers_by_prefix, LOG_FORMAT_DETAIL
+
+# 기본 로거 생성 (콘솔 + 파일 출력)
+logger = get_logger(
+    logger_name='myapp',
+    logger_format=LOG_FORMAT_DETAIL,   # 상세 포맷 사용 (선택)
+    file_path='logs/myapp.log',        # 로그 파일 경로 (기본: logs/echoss.log)
+    backup_count=7,                    # 보관할 로그 파일 수 (0이면 전부 보관)
+    use_console=True,                  # 콘솔 출력 여부
+    level='DEBUG'                      # 로그 레벨
+)
+
+logger.info("애플리케이션 시작")
+logger.debug("디버그 메시지")
+logger.error("오류 발생")
+
+# 서브모듈에서 기존 로거 재사용
+logger = use_logger('myapp')
+logger.info("서브모듈에서 로거 사용")
+
+# 로거 레벨만 변경
+set_logger_level(logger, 'WARNING')
+
+# prefix로 시작하는 모든 로거 일괄 수정
+modify_loggers_by_prefix(
+    prefix='myapp',
+    new_format=LOG_FORMAT_DETAIL,
+    new_path='logs/myapp.log',
+    level='INFO'
+)
+```
+
+---
+
+### 2. FileUtil (`fileformat`)
+
+설정 파일(YAML, JSON, XML, Properties)을 딕셔너리로 읽고 쓰는 유틸리티 클래스입니다.
+
+#### 메서드 목록
+
+| 메서드 | 설명 |
+|--------|------|
+| `FileUtil.dict_load()` | 설정 파일을 `dict`로 읽기 |
+| `FileUtil.dict_dump()` | `dict`를 설정 파일로 쓰기 |
+
+#### 지원 포맷
+
+| 확장자 | 포맷 |
+|--------|------|
+| `.yaml`, `.yml` | YAML |
+| `.json` | JSON |
+| `.xml` | XML |
+| `.properties` | Java Properties |
+
+#### 사용 예시
+
+```python
+from echoss_common.fileformat import FileUtil
+
+# YAML 파일 읽기
+config = FileUtil.dict_load('config/settings.yaml')
+print(config)
+
+# JSON 파일 읽기
+data = FileUtil.dict_load('config/params.json')
+
+# Properties 파일 읽기
+props = FileUtil.dict_load('config/app.properties')
+
+# dict를 YAML 파일로 저장
+settings = {'host': 'localhost', 'port': 8080, 'debug': True}
+FileUtil.dict_dump(settings, 'config/settings.yaml')
+
+# dict를 JSON 파일로 저장 (들여쓰기 지정 가능)
+FileUtil.dict_dump(settings, 'config/settings.json', indent=2)
+
+# 파일이 이미 존재할 때 덮어쓰기 방지
+FileUtil.dict_dump(settings, 'config/settings.yaml', force_write=False)
+```
+
+---
+
+## API 참조
+
+### `get_logger(logger_name, logger_format, file_path, backup_count, use_console, level)`
+
+| 파라미터 | 타입 | 기본값 | 설명 |
+|----------|------|--------|------|
+| `logger_name` | str | `'echoss'` | 로거 이름 |
+| `logger_format` | str | `LOG_FORMAT` | 로그 포맷 문자열 |
+| `file_path` | str | `'logs/echoss.log'` | 로그 파일 경로 (`None`이면 파일 미사용) |
+| `backup_count` | int | `0` | 보관할 로테이팅 파일 수 (0이면 전부 보관) |
+| `use_console` | bool | `True` | 콘솔 출력 여부 |
+| `level` | str\|int | `'DEBUG'` | 로그 레벨 |
+
+### `FileUtil.dict_load(file_path, file_format, **kwargs)`
+
+| 파라미터 | 타입 | 기본값 | 설명 |
+|----------|------|--------|------|
+| `file_path` | str | — | 읽을 파일 경로 |
+| `file_format` | str | `None` | 포맷 강제 지정 (미지정 시 확장자 자동 인식) |
+
+### `FileUtil.dict_dump(config, file_path, file_format, force_write, xml_tag, **kwargs)`
+
+| 파라미터 | 타입 | 기본값 | 설명 |
+|----------|------|--------|------|
+| `config` | dict | — | 저장할 딕셔너리 |
+| `file_path` | str | — | 저장할 파일 경로 |
+| `file_format` | str | `None` | 포맷 강제 지정 (미지정 시 확장자 자동 인식) |
+| `force_write` | bool | `True` | 기존 파일 덮어쓰기 여부 |
+| `xml_tag` | str | `None` | XML 저장 시 루트 태그 이름 |
+
+---
+
+## 라이선스
+
+echoss AI Bigdata Center

echoss_common-1.0.0/echoss_common/__init__.py

@@ -0,0 +1,11 @@
+# for v1.0
+from .echoss_logger import get_logger, use_logger, LOG_FORMAT_DETAIL, set_logger_level, modify_loggers_by_prefix
+from .fileformat import FileUtil
+
+__all__ = [
+    "get_logger",
+    "use_logger",
+    "LOG_FORMAT_DETAIL",
+    "set_logger_level",
+    "modify_loggers_by_prefix"
+]

echoss_common-1.0.0/echoss_common/echoss_logger.py

@@ -0,0 +1,154 @@
+import logging
+from logging.handlers import TimedRotatingFileHandler
+import os
+import sys
+from typing import Optional
+
+LOG_FORMAT = "[%(asctime)s.%(msecs)03d] %(levelname)-7s %(name)s : %(message)s"
+LOG_FORMAT_DETAIL = "[%(asctime)s.%(msecs)03d] %(levelname)-7s %(module)s.%(funcName)s.%(lineno)d : %(message)s"
+DATE_FORMAT = "%Y-%m-%d %H:%M:%S"
+
+LOG_FILE = "logs/echoss.log"
+
+# Set environment variable for Python IO encoding
+os.environ["PYTHONIOENCODING"] = "utf-8"
+
+def _get_console_handler(formatter):
+    console_handler = logging.StreamHandler(sys.stdout)
+    console_handler.setFormatter(formatter)
+    # set utf-8 encoding
+    return console_handler
+
+def _get_app(formatter):
+    console_handler = logging.StreamHandler(sys.stdout)
+    console_handler.setFormatter(formatter)
+    # set utf-8 encoding
+    return console_handler
+
+def _get_file_handler(formatter, file_path, backup_count):
+    file_handler = TimedRotatingFileHandler(file_path, when="midnight", backupCount=backup_count, encoding='utf-8')
+    file_handler.setFormatter(formatter)
+    return file_handler
+
+def use_logger(logger_name='echoss'):
+    """get parent logger in submodule python script
+    :param logger_name: logger name
+
+    :returns: logger of logger_name
+    :raises RuntimeError when logger_name is not made
+    """
+    logger = logging.getLogger(logger_name)
+
+    if logger.hasHandlers():
+        return logger
+    else:
+        raise RuntimeError(f"{logger_name} is not created yet")
+
+def get_logger(logger_name='echoss', logger_format=LOG_FORMAT, file_path=LOG_FILE, backup_count=0,
+               use_console=True, level="DEBUG"):
+    """
+    create new echoss logger or replace old logger
+    :param logger_name: logger name
+    :param logger_format: logging format
+    :param file_path: file path if File logging else None
+    :param backup_count: if 0 keep all timed rotating log files, else only keep backup count number of files
+    :param use_console: use console output or not
+    :param level:  (str or int) set logging level
+
+    :returns: generated logger
+    :raises None
+    """
+    logger = logging.getLogger(logger_name)
+    formatter = logging.Formatter(logger_format, datefmt=DATE_FORMAT)
+    set_logger_level(logger, level)
+    # with this pattern, it's rarely necessary to propagate the error up to parent
+    logger.propagate = False
+
+    # make file_path parent directory
+    parent_dir = os.path.dirname(file_path)
+    if parent_dir:
+        os.makedirs(parent_dir, exist_ok=True)
+
+    # Update or add console handler
+    has_console_handler = False
+    for handler in logger.handlers:
+        if not isinstance(handler, TimedRotatingFileHandler) and isinstance(handler, logging.StreamHandler):
+            if use_console:
+                handler.setFormatter(formatter)
+                has_console_handler = True
+            else:
+                # Remove StreamHandler
+                logger.removeHandler(handler)
+                handler.close()
+
+    if use_console and not has_console_handler:
+        logger.addHandler(_get_console_handler(formatter))
+
+    # Update or add file handler
+    file_handler_exists = False
+    for handler in logger.handlers:
+        if isinstance(handler, TimedRotatingFileHandler):
+            # Check if the existing handler path matches the current file_path
+            if handler.baseFilename == file_path:
+                handler.setFormatter(formatter)
+                file_handler_exists = True
+            else:
+                # Remove the old handler and close it
+                logger.removeHandler(handler)
+                handler.close()
+
+    if file_path and not file_handler_exists:
+        logger.addHandler(_get_file_handler(formatter, file_path, backup_count))
+
+    return logger
+
+
+def set_logger_level(logger, level):
+    """
+    :param logger: logger generated by get_logger()
+    :param level: string like "DEBUG" or "INFO" or integer logging.DEBUG or logging.INFO
+    :return: None
+    :raises ValueError or TypeError if level invalid
+    """
+    if isinstance(level, str):
+        level = level.upper()
+        numeric_level = getattr(logging, level, None)
+        if not isinstance(numeric_level, int):
+            raise ValueError(f"Invalid log level: {level}")
+    elif isinstance(level, int):
+        numeric_level = level
+    else:
+        raise TypeError("Level must be an integer or string")
+
+    logger.setLevel(numeric_level)
+
+
+def modify_loggers_by_prefix(prefix, new_format: str=LOG_FORMAT, new_path: str=LOG_FILE,
+                             backup_count: int=0, use_console=True, level="DEBUG"):
+    """
+    Modify loggers that logger name starting with a specific prefix.
+    :param prefix: prefix of lgger name
+    :param new_format: new logging format
+    :param new_path: new file path if File logging else None
+    :param backup_count: if 0 keep all timed rotating log files, else only keep backup count number of files
+    :param use_console: use console output or not
+    :param level: set logging level by level name or level number
+    :return: first logger
+    :raises None
+    """
+
+    # Iterate over all loggers in the logging manager
+    is_first = True
+    first_logger = None
+    for logger_name in logging.Logger.manager.loggerDict.keys():
+        if logger_name.startswith(prefix):
+            current_logger = get_logger(logger_name, logger_format=new_format, file_path=new_path,
+                       backup_count=backup_count, use_console=use_console, level=level)
+
+            if is_first:
+                is_first = False
+                first_logger = current_logger
+            if backup_count != 0:
+                backup_count = 0
+
+    return first_logger

echoss_common-1.0.0/echoss_common/fileformat.py

@@ -0,0 +1,121 @@
+"""
+    echoss AI Bigdata Center Solution - file format utilty (static version)
+"""
+import configparser
+import io
+import json
+import os
+import yaml
+
+from echoss_common import get_logger
+
+logger = get_logger("echoss_fileformat")
+EMPTY_DICT = dict()
+
+
+"""
+load/dump config file 
+"""
+def dict_load(file_path: str, file_format: str = None, **kwargs) -> dict:
+    """config file read to dict
+
+    Args:
+        file_path (str): 파일명
+        file_format : file extension name to read
+        kwargs : keyword arguments
+    Return:
+        dict
+    """
+    if file_format is None:
+        _, ext = os.path.splitext(file_path)
+        file_format = ext[1:].lower() if ext else None
+    if not os.path.exists(file_path):
+        logger.error(f"load config file [{file_path}] is not exist")
+        return EMPTY_DICT
+
+    if "yaml" == file_format or "yml" == file_format :
+        with open(file_path, 'r') as f:
+            yaml_dict = yaml.safe_load(f)
+            return yaml_dict
+    elif "json" == file_format:
+        with open(file_path, 'r') as f:
+            return json.load(f, **kwargs)
+    elif "xml" == file_format:
+        logger.error(f"Unsupported file format: {file_format}")
+        return EMPTY_DICT
+    elif 'properties' == file_format:
+        config = configparser.ConfigParser()
+        properties_dict = {}
+        with open(file_path, 'r') as f:
+            file_content = f.read()
+            if not file_content.strip().startswith('['):
+                file_content = '[DEFAULT]\n' + file_content
+            config.read_string(file_content)
+
+        if config.sections():  # Check if there are any sections
+            for section in config.sections():
+                properties_dict[section] = dict(config.items(section))
+        else:
+            properties_dict = dict(config.items(config.default_section))
+
+        return properties_dict
+    else:
+        logger.error(f"Unsupported file format [{file_format}]")
+        return EMPTY_DICT
+
+def dict_dump(config: dict, file_path: str, file_format=None, force_write=True, xml_tag=None, **kwargs):
+    """config dict write to file
+
+    Args:
+        config (dict): config dictionary
+        file_path (str): 파일명
+        file_format : file extension name to use
+        force_write : if True overwrite exist file or just return
+        xml_tag (str) : root tag to wrapping dictionary
+        kwargs : keyword arguments
+    """
+    if file_format is None:
+        _, ext = os.path.splitext(file_path)
+        file_format = ext[1:].lower() if ext else None
+
+    if os.path.exists(file_path) and force_write is False:
+        logger.error(f"Can not overwrite exist config file [{file_path}] use force_write=True if need")
+        return
+
+    if "yaml" == file_format or "yml" == file_format :
+        with open(file_path, 'w') as f:
+            yaml.dump(config, f, default_style=False, allow_unicode=True)
+    elif "json" == file_format:
+        with open(file_path, 'w') as f:
+            indent = kwargs.pop('indent', 4)
+            json.dump(config, f, indent=indent, **kwargs)
+    elif "xml" == file_format:
+        logger.error(f"Unsupported file format: {file_format}")
+        return EMPTY_DICT
+    elif 'properties' == file_format:
+        parser = configparser.ConfigParser()
+        have_section = any(isinstance(v, dict) for v in config.values())
+        if have_section:
+            for section, params in config.items():
+                if isinstance(params, dict):
+                    parser.add_section(section)
+                    for k, v in params.items():
+                        parser.set(section, k, str(v))
+                else:
+                    parser.set('DEFAULT', section, str(params))
+        else:
+            # parser.add_section('DEFAULT')
+            for k, v in config.items():
+                parser.set('DEFAULT', k, str(v))
+        with open(file_path, 'w') as f:
+            if have_section:
+                parser.write(f)
+            else:
+                with io.StringIO() as string_file:
+                    parser.write(string_file)
+                    clean_text = string_file.getvalue().replace("[DEFAULT]\n", "")
+                    f.write(clean_text)
+    else:
+        logger.error(f"Unsupported file format [{file_format}]")
+
+

echoss_common-1.0.0/echoss_common.egg-info/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: echoss-common
+Version: 1.0.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>6.0.2
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+
+# echoss-common
+
+echoss AI Bigdata Center 공통 유틸리티 라이브러리입니다.
+로깅(Logger)과 파일 포맷(FileUtil) 기능을 제공합니다.
+
+## 설치
+
+```bash
+pip install echoss-common
+```
+
+## 요구사항
+
+- Python >= 3.12
+- pyyaml > 6.0.2
+
+---
+
+## 기능
+
+### 1. Logger (`echoss_logger`)
+
+타임드 로테이팅 파일 핸들러와 콘솔 핸들러를 지원하는 로거 유틸리티입니다.
+
+#### 함수 목록
+
+| 함수 | 설명 |
+|------|------|
+| `get_logger()` | 새 로거 생성 또는 기존 로거 갱신 |
+| `use_logger()` | 이미 생성된 로거를 서브모듈에서 가져오기 |
+| `set_logger_level()` | 로거 레벨 변경 |
+| `modify_loggers_by_prefix()` | 이름 prefix로 여러 로거를 일괄 수정 |
+
+#### 상수
+
+| 상수 | 값 |
+|------|----|
+| `LOG_FORMAT_DETAIL` | `[날짜시간] 레벨 모듈.함수.라인 : 메시지` 형식 |
+
+#### 사용 예시
+
+```python
+from echoss_common import get_logger, use_logger, set_logger_level, modify_loggers_by_prefix, LOG_FORMAT_DETAIL
+
+# 기본 로거 생성 (콘솔 + 파일 출력)
+logger = get_logger(
+    logger_name='myapp',
+    logger_format=LOG_FORMAT_DETAIL,   # 상세 포맷 사용 (선택)
+    file_path='logs/myapp.log',        # 로그 파일 경로 (기본: logs/echoss.log)
+    backup_count=7,                    # 보관할 로그 파일 수 (0이면 전부 보관)
+    use_console=True,                  # 콘솔 출력 여부
+    level='DEBUG'                      # 로그 레벨
+)
+
+logger.info("애플리케이션 시작")
+logger.debug("디버그 메시지")
+logger.error("오류 발생")
+
+# 서브모듈에서 기존 로거 재사용
+logger = use_logger('myapp')
+logger.info("서브모듈에서 로거 사용")
+
+# 로거 레벨만 변경
+set_logger_level(logger, 'WARNING')
+
+# prefix로 시작하는 모든 로거 일괄 수정
+modify_loggers_by_prefix(
+    prefix='myapp',
+    new_format=LOG_FORMAT_DETAIL,
+    new_path='logs/myapp.log',
+    level='INFO'
+)
+```
+
+---
+
+### 2. FileUtil (`fileformat`)
+
+설정 파일(YAML, JSON, XML, Properties)을 딕셔너리로 읽고 쓰는 유틸리티 클래스입니다.
+
+#### 메서드 목록
+
+| 메서드 | 설명 |
+|--------|------|
+| `FileUtil.dict_load()` | 설정 파일을 `dict`로 읽기 |
+| `FileUtil.dict_dump()` | `dict`를 설정 파일로 쓰기 |
+
+#### 지원 포맷
+
+| 확장자 | 포맷 |
+|--------|------|
+| `.yaml`, `.yml` | YAML |
+| `.json` | JSON |
+| `.xml` | XML |
+| `.properties` | Java Properties |
+
+#### 사용 예시
+
+```python
+from echoss_common.fileformat import FileUtil
+
+# YAML 파일 읽기
+config = FileUtil.dict_load('config/settings.yaml')
+print(config)
+
+# JSON 파일 읽기
+data = FileUtil.dict_load('config/params.json')
+
+# Properties 파일 읽기
+props = FileUtil.dict_load('config/app.properties')
+
+# dict를 YAML 파일로 저장
+settings = {'host': 'localhost', 'port': 8080, 'debug': True}
+FileUtil.dict_dump(settings, 'config/settings.yaml')
+
+# dict를 JSON 파일로 저장 (들여쓰기 지정 가능)
+FileUtil.dict_dump(settings, 'config/settings.json', indent=2)
+
+# 파일이 이미 존재할 때 덮어쓰기 방지
+FileUtil.dict_dump(settings, 'config/settings.yaml', force_write=False)
+```
+
+---
+
+## API 참조
+
+### `get_logger(logger_name, logger_format, file_path, backup_count, use_console, level)`
+
+| 파라미터 | 타입 | 기본값 | 설명 |
+|----------|------|--------|------|
+| `logger_name` | str | `'echoss'` | 로거 이름 |
+| `logger_format` | str | `LOG_FORMAT` | 로그 포맷 문자열 |
+| `file_path` | str | `'logs/echoss.log'` | 로그 파일 경로 (`None`이면 파일 미사용) |
+| `backup_count` | int | `0` | 보관할 로테이팅 파일 수 (0이면 전부 보관) |
+| `use_console` | bool | `True` | 콘솔 출력 여부 |
+| `level` | str\|int | `'DEBUG'` | 로그 레벨 |
+
+### `FileUtil.dict_load(file_path, file_format, **kwargs)`
+
+| 파라미터 | 타입 | 기본값 | 설명 |
+|----------|------|--------|------|
+| `file_path` | str | — | 읽을 파일 경로 |
+| `file_format` | str | `None` | 포맷 강제 지정 (미지정 시 확장자 자동 인식) |
+
+### `FileUtil.dict_dump(config, file_path, file_format, force_write, xml_tag, **kwargs)`
+
+| 파라미터 | 타입 | 기본값 | 설명 |
+|----------|------|--------|------|
+| `config` | dict | — | 저장할 딕셔너리 |
+| `file_path` | str | — | 저장할 파일 경로 |
+| `file_format` | str | `None` | 포맷 강제 지정 (미지정 시 확장자 자동 인식) |
+| `force_write` | bool | `True` | 기존 파일 덮어쓰기 여부 |
+| `xml_tag` | str | `None` | XML 저장 시 루트 태그 이름 |
+
+---
+
+## 라이선스
+
+echoss AI Bigdata Center

echoss_common-1.0.0/echoss_common.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+MANIFEST.in
+README.md
+pyproject.toml
+echoss_common/__init__.py
+echoss_common/echoss_logger.py
+echoss_common/fileformat.py
+echoss_common.egg-info/PKG-INFO
+echoss_common.egg-info/SOURCES.txt
+echoss_common.egg-info/dependency_links.txt
+echoss_common.egg-info/requires.txt
+echoss_common.egg-info/top_level.txt

echoss_common-1.0.0/echoss_common.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

echoss_common-1.0.0/echoss_common.egg-info/requires.txt

@@ -0,0 +1,4 @@
+pyyaml>6.0.2
+
+[dev]
+pytest

echoss_common-1.0.0/echoss_common.egg-info/top_level.txt

@@ -0,0 +1 @@
+echoss_common

echoss_common-1.0.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=80.9.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name="echoss-common"
+version="1.0.0"
+description=""
+readme = "README.md"
+
+classifiers = [
+     "Programming Language :: Python :: 3",
+     "Operating System :: OS Independent"
+]
+
+requires-python='>=3.12'
+dependencies=[
+        "pyyaml>6.0.2"
+]
+
+[project.optional-dependencies]
+dev = ["pytest"]

echoss_common-1.0.0/setup.cfg

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