microframex 2026.1__py3-none-any.whl

microframe/__init__.py

@@ -0,0 +1,2 @@
+from .dataframe import DataFrame
+from .reader import load

microframe/dataframe.py

@@ -0,0 +1,75 @@
+class DataFrame:
+    def __init__(self, rows, columns=None):
+
+        rows = list(rows)  # 🔥 强制统一
+        self.rows = []
+
+        if not rows:
+            return
+
+        # ========= dict 输入 =========
+        if isinstance(rows[0], dict):
+            self.rows = rows
+            return
+
+        # ========= row + columns =========
+        if not columns:
+            columns = list(rows[0])
+            rows = rows[1:]
+
+        self.rows = [
+            dict(zip(columns, row))
+            for row in rows
+        ]
+
+    def validate_keys(self, keys):
+        cols = set(self.columns)
+        keys = set(keys)
+
+        missing = keys - cols
+        if missing:
+            raise KeyError(f"字段 “{missing}” 不存在")
+
+    @property
+    def columns(self):
+        if not self.rows:
+            return []
+        return list(self.rows[0].keys())
+
+    def head(self, n=5):
+        return DataFrame(self.rows[:n])
+
+    def groupby(self, *keys):
+
+        # 👉 统一校验
+        self.validate_keys(keys)
+
+        groups = {}
+
+        for row in self.rows:
+
+            if len(keys) == 1:
+                k = row.get(keys[0])
+            else:
+                k = tuple(row.get(key) for key in keys)
+
+            groups.setdefault(k, []).append(row)
+
+        return {k: DataFrame(v) for k, v in groups.items()}
+
+    def __repr__(self):
+        n = min(5, len(self.rows))
+        preview = self.rows[:n]
+
+        col_count = len(self.columns)
+
+        lines = [f"DataFrame(rows={len(self.rows)}, cols={col_count})("]
+
+        for row in preview:
+            lines.append(f"  {row}")
+
+        if len(self.rows) > 5:
+            lines.append(f"  ...")
+
+        lines.append(")")
+        return "\n".join(lines)

microframe/reader.py

@@ -0,0 +1,66 @@
+from datetime import datetime
+from os.path import basename
+from .dataframe import DataFrame
+from openpyxl import load_workbook
+from sqlalchemy import create_engine, text
+
+def format_datetime_with_milliseconds():
+    """格式化时间为 2026-03-12 14:17:45.618 格式"""
+    dt = datetime.now()
+    # 获取日期时间部分（不含毫秒）
+    base_time = dt.strftime("%Y-%m-%d %H:%M:%S")
+    # 获取毫秒（微秒除以1000）
+    milliseconds = dt.microsecond // 1000
+    # 格式化毫秒为3位数，不足补零
+    ms_str = f"{milliseconds:03d}"
+    return f"{base_time}.{ms_str}"
+
+def load(source, sheet_name=None, query=None):
+    """
+    读取数据源并返回 DataFrame
+
+    Parameters
+    ----------
+    source : str
+        - Excel 文件路径（.xlsx）
+        - MySQL 连接字符串（mysql+pymysql://user:pwd@host/db）
+    sheet_name : str, optional
+        Excel sheet 名称（默认第一个 sheet）
+    query : str, optional
+        SQL 查询语句（仅数据库模式必填）
+
+    Returns
+    -------
+    DataFrame
+        microframe.DataFrame
+    """
+
+    # ========== 1. Excel ==========
+    if source.lower().endswith(".xlsx"):
+        wb = load_workbook(source, read_only=True, data_only=True)
+
+        ws = wb[sheet_name] if sheet_name else wb.active
+
+        sheet_name = sheet_name if sheet_name else ws.title
+
+        print(f'\033[32m{format_datetime_with_milliseconds()} \033[31m| \033[0mINFO \033[31m|\033[0m 读取excel文件名称：\033[35m“{basename(source)}”\033[0m，sheet名称：\033[35m“{sheet_name}”\033[0m')
+
+        data = list(ws.values)
+        return DataFrame(data)
+
+    # ========== 2. MySQL ==========
+    if source.startswith("mysql"):
+        if not query:
+            raise ValueError("数据库模式下必须提供 query")
+
+        engine = create_engine(source)
+
+        with engine.connect() as conn:
+            result = conn.execute(text(query))
+            rows = result.fetchall()
+            columns = result.keys()
+
+        return DataFrame(rows, columns = columns)
+
+    # ========== 3. 不支持的数据源 ==========
+    raise ValueError(f"不支持的数据源类型: {source}")

microframe/writer.py

@@ -0,0 +1,4 @@
+# encoding:utf-8
+# @File: writer.py
+# @Time: 2026/6/3 14:04
+# @Author: 唐旭东

microframex-2026.1.dist-info/METADATA

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: microframex
+Version: 2026.1
+Summary: 一个轻量级数据框架
+Author: 唐旭东
+Requires-Python: >=3.7
+Requires-Dist: openpyxl
+Requires-Dist: sqlalchemy
+Requires-Dist: colorama
+Dynamic: author
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

microframex-2026.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+microframe/__init__.py,sha256=Ua45u9Bldecvgn1UAn3lZqU8WnBSbJaZnhBIwf-L44Q,58
+microframe/dataframe.py,sha256=4ol7xEblNuLA23fUlbDCM26mj4Zfm1Kuv77csbv1YiI,1803
+microframe/reader.py,sha256=wILRh4_sRhcEML95PnvVubtkWgg_R0S_Wxr_qRBDx1Y,2233
+microframe/writer.py,sha256=LEZ17lROpeQnPDy2XCt1Ikb0qK5MIdmdeOByi7b1q3Y,85
+microframex-2026.1.dist-info/METADATA,sha256=B9C9Tr96SDb8RXE8Z1cXKh5d4XBGBQ7WXQig6oc6-h0,302
+microframex-2026.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+microframex-2026.1.dist-info/top_level.txt,sha256=E8duo4Yd6zWtch3JG12QFtWszaSx7QvFTMs_qHQpyAY,11
+microframex-2026.1.dist-info/RECORD,,

microframex-2026.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

microframex-2026.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+microframe