cm-picker 1.0.0__tar.gz

cm_picker-1.0.0/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: cm_picker
+Version: 1.0.0
+Summary: 计算概论C课程课堂随机点名、分组、抽奖和座位表工具
+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
+Classifier: Topic :: 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_picker
+
+《计算概论C》课堂随机点名、分组、抽奖和座位表工具。
+
+## 安装
+
+```bash
+pip install cm_picker
+```
+
+## 示例
+
+```python
+import cm_picker
+
+names = ['张三', '李四', '王五', '赵六', '钱七', '孙八']
+
+print(cm_picker.pick_one(names))
+print(cm_picker.group_by_count(names, 2))
+print(cm_picker.lucky_draw(names, ['一等奖', '二等奖']))
+
+chart = cm_picker.make_exam_seating_chart(names, rows=2, cols=3)
+cm_picker.save_result(chart, '座位表.csv')
+```
+
+这个库适合在学完列表、随机数、循环之后使用。库负责随机策略和表格保存，学生仍然需要自己准备名单、设计交互和展示结果。

cm_picker-1.0.0/README.md

@@ -0,0 +1,26 @@
+# cm_picker
+
+《计算概论C》课堂随机点名、分组、抽奖和座位表工具。
+
+## 安装
+
+```bash
+pip install cm_picker
+```
+
+## 示例
+
+```python
+import cm_picker
+
+names = ['张三', '李四', '王五', '赵六', '钱七', '孙八']
+
+print(cm_picker.pick_one(names))
+print(cm_picker.group_by_count(names, 2))
+print(cm_picker.lucky_draw(names, ['一等奖', '二等奖']))
+
+chart = cm_picker.make_exam_seating_chart(names, rows=2, cols=3)
+cm_picker.save_result(chart, '座位表.csv')
+```
+
+这个库适合在学完列表、随机数、循环之后使用。库负责随机策略和表格保存，学生仍然需要自己准备名单、设计交互和展示结果。

cm_picker-1.0.0/cm_picker/__init__.py

@@ -0,0 +1,24 @@
+"""cm_picker - 课堂随机点名、分组、抽奖和座位表工具。"""
+
+from .core import (
+    pick_one,
+    pick_many,
+    group_by_size,
+    group_by_count,
+    lucky_draw,
+    make_seating_chart,
+    make_exam_seating_chart,
+    save_result,
+)
+
+__version__ = '1.0.0'
+__all__ = [
+    'pick_one',
+    'pick_many',
+    'group_by_size',
+    'group_by_count',
+    'lucky_draw',
+    'make_seating_chart',
+    'make_exam_seating_chart',
+    'save_result',
+]

cm_picker-1.0.0/cm_picker/core.py

@@ -0,0 +1,96 @@
+import csv
+import random
+from pathlib import Path
+
+
+def _clean_names(names):
+    result = [str(name).strip() for name in names if str(name).strip()]
+    if not result:
+        raise ValueError('名单不能为空')
+    return result
+
+
+def pick_one(names):
+    """从名单中随机抽取 1 人。"""
+    return random.choice(_clean_names(names))
+
+
+def pick_many(names, k, repeat=False):
+    """从名单中抽取 k 人。repeat=True 时允许重复抽取。"""
+    names = _clean_names(names)
+    if k < 0:
+        raise ValueError('k 不能小于 0')
+    if repeat:
+        return random.choices(names, k=k)
+    if k > len(names):
+        raise ValueError('不重复抽取时，k 不能大于名单人数')
+    return random.sample(names, k)
+
+
+def group_by_size(names, size):
+    """按照每组 size 人随机分组。最后一组可能人数较少。"""
+    if size <= 0:
+        raise ValueError('每组人数必须大于 0')
+    names = _clean_names(names)
+    random.shuffle(names)
+    return [names[i:i + size] for i in range(0, len(names), size)]
+
+
+def group_by_count(names, count):
+    """把名单随机分成 count 组，人数尽量均衡。"""
+    if count <= 0:
+        raise ValueError('组数必须大于 0')
+    names = _clean_names(names)
+    random.shuffle(names)
+    groups = [[] for _ in range(count)]
+    for index, name in enumerate(names):
+        groups[index % count].append(name)
+    return groups
+
+
+def lucky_draw(names, prizes):
+    """根据奖品列表抽奖，返回 [(奖品, 获奖人), ...]。"""
+    names = _clean_names(names)
+    prizes = [str(prize).strip() for prize in prizes if str(prize).strip()]
+    if len(prizes) > len(names):
+        raise ValueError('奖品数量不能多于参与人数')
+    winners = random.sample(names, len(prizes))
+    return list(zip(prizes, winners))
+
+
+def make_seating_chart(names, rows, cols, empty=''):
+    """生成普通座位表，返回二维列表。"""
+    if rows <= 0 or cols <= 0:
+        raise ValueError('行数和列数必须大于 0')
+    names = _clean_names(names)
+    if len(names) > rows * cols:
+        raise ValueError('座位数不够')
+    random.shuffle(names)
+    seats = names + [empty] * (rows * cols - len(names))
+    return [seats[i * cols:(i + 1) * cols] for i in range(rows)]
+
+
+def make_exam_seating_chart(names, rows, cols, empty='', snake=True):
+    """生成考试座位表。snake=True 时相邻行方向相反，便于打印查看。"""
+    chart = make_seating_chart(names, rows, cols, empty=empty)
+    if snake:
+        return [row if i % 2 == 0 else list(reversed(row)) for i, row in enumerate(chart)]
+    return chart
+
+
+def save_result(result, filename):
+    """把分组、抽奖或座位表保存为 CSV 文件。"""
+    path = Path(filename)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    with path.open('w', encoding='utf-8-sig', newline='') as f:
+        writer = csv.writer(f)
+        if not result:
+            return str(path)
+        first = result[0]
+        if isinstance(first, tuple):
+            writer.writerows(result)
+        elif isinstance(first, list):
+            writer.writerows(result)
+        else:
+            writer.writerow(result)
+    return str(path)

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

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: cm_picker
+Version: 1.0.0
+Summary: 计算概论C课程课堂随机点名、分组、抽奖和座位表工具
+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
+Classifier: Topic :: 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_picker
+
+《计算概论C》课堂随机点名、分组、抽奖和座位表工具。
+
+## 安装
+
+```bash
+pip install cm_picker
+```
+
+## 示例
+
+```python
+import cm_picker
+
+names = ['张三', '李四', '王五', '赵六', '钱七', '孙八']
+
+print(cm_picker.pick_one(names))
+print(cm_picker.group_by_count(names, 2))
+print(cm_picker.lucky_draw(names, ['一等奖', '二等奖']))
+
+chart = cm_picker.make_exam_seating_chart(names, rows=2, cols=3)
+cm_picker.save_result(chart, '座位表.csv')
+```
+
+这个库适合在学完列表、随机数、循环之后使用。库负责随机策略和表格保存，学生仍然需要自己准备名单、设计交互和展示结果。

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+cm_picker

cm_picker-1.0.0/setup.cfg

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

cm_picker-1.0.0/setup.py

@@ -0,0 +1,21 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='cm_picker',
+    version='1.0.0',
+    author='Chen Mo',
+    author_email='chenmoemail@126.com',
+    description='计算概论C课程课堂随机点名、分组、抽奖和座位表工具',
+    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',
+        'Topic :: Education',
+    ],
+)