cm-grade 1.0.0__tar.gz

cm_grade-1.0.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: cm_grade
+Version: 1.0.0
+Summary: 计算概论C课程成绩 CSV 分析和报告工具
+Author: Chen Mo
+Author-email: chenmoemail@126.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-python
+Dynamic: summary
+
+# cm_grade
+
+成绩 CSV 分析和报告工具，适合文件、字典、排序之后做综合练习。
+
+```bash
+pip install cm_grade
+```
+
+```python
+import cm_grade
+
+records = cm_grade.read_scores('成绩.csv')
+print(cm_grade.summary(records))
+print(cm_grade.rank_scores(records)[:5])
+
+report = cm_grade.make_report(records)
+cm_grade.save_report(report, '成绩报告.txt')
+```

cm_grade-1.0.0/README.md

@@ -0,0 +1,18 @@
+# cm_grade
+
+成绩 CSV 分析和报告工具，适合文件、字典、排序之后做综合练习。
+
+```bash
+pip install cm_grade
+```
+
+```python
+import cm_grade
+
+records = cm_grade.read_scores('成绩.csv')
+print(cm_grade.summary(records))
+print(cm_grade.rank_scores(records)[:5])
+
+report = cm_grade.make_report(records)
+cm_grade.save_report(report, '成绩报告.txt')
+```

cm_grade-1.0.0/cm_grade/__init__.py

@@ -0,0 +1,13 @@
+"""cm_grade - 成绩 CSV 分析和报告工具。"""
+
+from .core import (
+    read_scores,
+    summary,
+    rank_scores,
+    score_bands,
+    make_report,
+    save_report,
+)
+
+__version__ = '1.0.0'
+__all__ = ['read_scores', 'summary', 'rank_scores', 'score_bands', 'make_report', 'save_report']

cm_grade-1.0.0/cm_grade/core.py

@@ -0,0 +1,79 @@
+import csv
+from pathlib import Path
+from statistics import mean, median
+
+
+def read_scores(filename, name_col='姓名', score_col='成绩'):
+    """读取包含姓名和成绩两列的 CSV，返回 [{'姓名': ..., '成绩': ...}, ...]。"""
+    result = []
+    with open(filename, 'r', encoding='utf-8-sig', newline='') as f:
+        reader = csv.DictReader(f)
+        for row in reader:
+            if not row.get(name_col):
+                continue
+            result.append({'姓名': row[name_col], '成绩': float(row[score_col])})
+    return result
+
+
+def _scores(records):
+    scores = [float(row['成绩']) for row in records]
+    if not scores:
+        raise ValueError('没有成绩数据')
+    return scores
+
+
+def summary(records):
+    """计算平均分、中位数、最高分、最低分。"""
+    scores = _scores(records)
+    return {
+        '人数': len(scores),
+        '平均分': round(mean(scores), 2),
+        '中位数': round(median(scores), 2),
+        '最高分': max(scores),
+        '最低分': min(scores),
+    }
+
+
+def rank_scores(records, reverse=True):
+    """按成绩排序并添加名次。"""
+    ordered = sorted(records, key=lambda row: float(row['成绩']), reverse=reverse)
+    return [{**row, '名次': index} for index, row in enumerate(ordered, start=1)]
+
+
+def score_bands(records, bands=None):
+    """按分数段统计人数。"""
+    if bands is None:
+        bands = [(90, 100, '90-100'), (80, 89.999, '80-89'), (70, 79.999, '70-79'), (60, 69.999, '60-69'), (0, 59.999, '0-59')]
+    result = {label: 0 for _, _, label in bands}
+    for row in records:
+        score = float(row['成绩'])
+        for low, high, label in bands:
+            if low <= score <= high:
+                result[label] += 1
+                break
+    return result
+
+
+def make_report(records):
+    """生成中文成绩分析报告。"""
+    s = summary(records)
+    bands = score_bands(records)
+    lines = [
+        '成绩分析报告',
+        f"人数：{s['人数']}",
+        f"平均分：{s['平均分']}",
+        f"中位数：{s['中位数']}",
+        f"最高分：{s['最高分']}",
+        f"最低分：{s['最低分']}",
+        '分数段统计：',
+    ]
+    lines.extend(f'{band}：{count} 人' for band, count in bands.items())
+    return '\n'.join(lines)
+
+
+def save_report(report, filename):
+    """保存文字报告。"""
+    path = Path(filename)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(report, encoding='utf-8')
+    return str(path)

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

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: cm_grade
+Version: 1.0.0
+Summary: 计算概论C课程成绩 CSV 分析和报告工具
+Author: Chen Mo
+Author-email: chenmoemail@126.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-python
+Dynamic: summary
+
+# cm_grade
+
+成绩 CSV 分析和报告工具，适合文件、字典、排序之后做综合练习。
+
+```bash
+pip install cm_grade
+```
+
+```python
+import cm_grade
+
+records = cm_grade.read_scores('成绩.csv')
+print(cm_grade.summary(records))
+print(cm_grade.rank_scores(records)[:5])
+
+report = cm_grade.make_report(records)
+cm_grade.save_report(report, '成绩报告.txt')
+```

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

@@ -0,0 +1,8 @@
+README.md
+setup.py
+cm_grade/__init__.py
+cm_grade/core.py
+cm_grade.egg-info/PKG-INFO
+cm_grade.egg-info/SOURCES.txt
+cm_grade.egg-info/dependency_links.txt
+cm_grade.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+cm_grade

cm_grade-1.0.0/setup.cfg

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

cm_grade-1.0.0/setup.py

@@ -0,0 +1,20 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='cm_grade',
+    version='1.0.0',
+    author='Chen Mo',
+    author_email='chenmoemail@126.com',
+    description='计算概论C课程成绩 CSV 分析和报告工具',
+    long_description=open('README.md', encoding='utf-8').read(),
+    long_description_content_type='text/markdown',
+    packages=find_packages(),
+    python_requires='>=3.8',
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+        'Natural Language :: Chinese (Simplified)',
+        'Intended Audience :: Education',
+    ],
+)