hossam 0.4.12__py3-none-any.whl → 0.4.14__py3-none-any.whl

hossam/hs_study.py

@@ -0,0 +1,76 @@
+import ast
+import os
+import pandas as pd
+from pathlib import Path
+from IPython.display import Markdown, display
+from .hs_util import pretty_table
+
+
+def module_list():
+    """
+    현재 패키지(hossam) 내의 모든 모듈(파이썬 파일) 이름을 데이터프레임으로 반환함.
+    - .py 확장자만 대상, __init__.py는 제외
+    - 컬럼명: 'module'
+    """
+    pkg_dir = os.path.dirname(__file__)
+    files = [f for f in os.listdir(pkg_dir) if f.endswith(".py") and f != "__init__.py"]
+    modules = [os.path.splitext(f)[0] for f in files]
+    df = pd.DataFrame({"module": modules})
+    df.sort_values(by='module', inplace=True)
+    df.reset_index(drop=True, inplace=True)
+    pretty_table(df)
+
+
+def function_list(module_name: str, keyword: str | None = None):
+    """
+    지정한 모듈 내의 모든 함수 이름과 간단한 설명을 데이터프레임으로 반환함.
+
+    - module_name: 모듈 이름 (예: 'hs_cluster')
+    - keyword: 함수 이름 또는 설명에 포함된 키워드로 필터링 (선택 사항)
+    """
+    pkg_dir = os.path.dirname(__file__)
+    py_path = os.path.join(pkg_dir, module_name + ".py")
+    if not os.path.exists(py_path):
+        raise FileNotFoundError(f"{py_path} 파일이 존재하지 않음")
+
+    with open(py_path, encoding="utf-8") as f:
+        src = f.read()
+    tree = ast.parse(src)
+    rows = []
+    for node in tree.body:
+        if isinstance(node, ast.FunctionDef):
+            func_name = node.name
+            doc = ast.get_docstring(node) or ''
+            # # 파라미터 추출
+            # params = []
+            # for arg in node.args.args:
+            #     if arg.arg != 'self':
+            #         params.append(arg.arg)
+            # # 리턴 타입
+            # returns = ''
+            # if node.returns:
+            #     try:
+            #         returns = ast.unparse(node.returns)
+            #     except Exception:
+            #         returns = str(node.returns)
+            rows.append({
+                'function': func_name,
+                'description': doc.split('\n')[0] if doc else '',
+                # 'parameters': ', '.join(params),
+                # 'returns': returns
+                'reference': f"https://py.hossam.kr/api/{module_name}/#{module_name}.{func_name}"
+            })
+    df = pd.DataFrame(rows)
+    df.sort_values(by='function', inplace=True)
+    df.reset_index(drop=True, inplace=True)
+
+    # df.style.format(
+    #     {"reference": lambda x: f"<a href='{x}' target='_blank'>view</a>"},
+    #     escape=False    # type: ignore
+    # )
+
+    if keyword:
+        mask = df['function'].str.contains(keyword, case=False) | df['description'].str.contains(keyword, case=False)
+        df = df[mask].reset_index(drop=True)
+
+    pretty_table(df)

{hossam-0.4.12.dist-info → hossam-0.4.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hossam
-Version: 0.4.12
+Version: 0.4.14
 Summary: Hossam Data Helper
 Author-email: Lee Kwang-Ho <leekh4232@gmail.com>
 License-Expression: MIT

{hossam-0.4.12.dist-info → hossam-0.4.14.dist-info}/RECORD

@@ -1,16 +1,17 @@
 hossam/NotoSansKR-Regular.ttf,sha256=0SCufUQwcVWrWTu75j4Lt_V2bgBJIBXl1p8iAJJYkVY,6185516
-hossam/__init__.py,sha256=4cGvavSotmQKhkHS4UCANhzszrMNwXNESAhh0RuFF-w,2893
+hossam/__init__.py,sha256=lJ-_g2HAmFnixOmKjCv7_cMSdiYwbM6SNlHEtptUlUI,4045
 hossam/hs_classroom.py,sha256=Sb1thy49LKn2zU90aiOVwHWhyWSMHLZbZX7eXmQlquc,27523
-hossam/hs_cluster.py,sha256=anjoZ12JsIDWoGhm6agd0IF4N_md5czutyW4rbXnDEM,4255
+hossam/hs_cluster.py,sha256=umgJRRr9vXkaFVIs6V_K3SrOo6Q5AEqVYmQSMaGj7rY,31945
 hossam/hs_gis.py,sha256=DVmndBK-_7GMK3J1_on3ieEQk1S0MfUZ8_wlX-cDdZQ,11581
-hossam/hs_plot.py,sha256=5j498vga_1wZBRlMUZ047LswNSvfTEpGP6uL7yzl3-g,92744
+hossam/hs_plot.py,sha256=zq1tP5mEoDe85ljLT8poTgeY4httjOTdpNWsXEO6IEU,94919
 hossam/hs_prep.py,sha256=ypuX97mCxpo7CLoI_S79bUw7th0ok5LCZjt4vzRaGiI,38326
 hossam/hs_stats.py,sha256=MDS3rvaXDP8aYwcE36JTetWiZgE4fkXnNo0vwlXu-pA,119890
+hossam/hs_study.py,sha256=ZzL76_V0IHnk_YUTbWncIIBruOj2Sz3xs91snS6cpu0,2776
 hossam/hs_timeserise.py,sha256=NzGV4bJmVQr3qUFySOP25qENItmloYjgh3VgwSbSmXc,43163
 hossam/hs_util.py,sha256=ptl-2W7-0Ad_BemZMR8cFnDt6-SHCRRCk1Gh7giFjSs,16149
 hossam/leekh.png,sha256=1PB5NQ24SDoHA5KMiBBsWpSa3iniFcwFTuGwuOsTHfI,6395
-hossam-0.4.12.dist-info/licenses/LICENSE,sha256=nIqzhlcFY_2D6QtFsYjwU7BWkafo-rUJOQpDZ-DsauI,941
-hossam-0.4.12.dist-info/METADATA,sha256=XPQw6z2P4PLhq1zVeZdOBvOqSJoLQyKWj6Qv9XmU8xc,3803
-hossam-0.4.12.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-hossam-0.4.12.dist-info/top_level.txt,sha256=_-7bwjhthHplWhywEaHIJX2yL11CQCaLjCNSBlk6wiQ,7
-hossam-0.4.12.dist-info/RECORD,,
+hossam-0.4.14.dist-info/licenses/LICENSE,sha256=nIqzhlcFY_2D6QtFsYjwU7BWkafo-rUJOQpDZ-DsauI,941
+hossam-0.4.14.dist-info/METADATA,sha256=7ImpA00AlStHil2PdLPHNwA3aU23zFLfbbaA6zE6pqM,3803
+hossam-0.4.14.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+hossam-0.4.14.dist-info/top_level.txt,sha256=_-7bwjhthHplWhywEaHIJX2yL11CQCaLjCNSBlk6wiQ,7
+hossam-0.4.14.dist-info/RECORD,,