random-walk-lib 1.0.0__tar.gz

random_walk_lib-1.0.0/PKG-INFO

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: random-walk-lib
+Version: 1.0.0
+Summary: A Python library for 2D random walk with visualization
+Home-page: https://github.com/hello1-UI/random-walk-lib
+Author: hello1-UI
+Author-email: freetongdynastynet@hotmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: matplotlib>=3.0
+
+# Random Walk Lib
+一个实现二维随机游走的Python库，支持步数控制、位置记录和路径可视化。
+
+## 安装
+### 本地安装
+```bash
+# 进入项目根目录
+cd path/to/random_walk_lib
+pip install .
+```
+
+---
+
+### 第二步：本地安装并测试
+打开终端，按以下步骤操作：
+#### 1. 进入项目根目录
+```bash
+cd path/to/random_walk_lib  # 替换成你的项目根目录路径
+```

random_walk_lib-1.0.0/README.md

@@ -0,0 +1,19 @@
+# Random Walk Lib
+一个实现二维随机游走的Python库，支持步数控制、位置记录和路径可视化。
+
+## 安装
+### 本地安装
+```bash
+# 进入项目根目录
+cd path/to/random_walk_lib
+pip install .
+```
+
+---
+
+### 第二步：本地安装并测试
+打开终端，按以下步骤操作：
+#### 1. 进入项目根目录
+```bash
+cd path/to/random_walk_lib  # 替换成你的项目根目录路径
+```

random_walk_lib-1.0.0/pyproject.toml

@@ -0,0 +1,4 @@
+[build-system]
+# 指定打包依赖和构建后端
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"

random_walk_lib-1.0.0/random_walk_lib/__init__.py

@@ -0,0 +1,11 @@
+# random_walk_lib/__init__.py
+"""
+Random Walk Library
+一个实现二维随机游走的Python库，支持步数控制、位置记录和路径可视化
+"""
+
+# 暴露核心类，方便外部导入
+from .random_walk import RandomWalk
+
+# 定义库的版本（可选）
+__version__ = "1.0.0"

random_walk_lib-1.0.0/random_walk_lib/random_walk.py

@@ -0,0 +1,84 @@
+# random_walk_lib/random_walk.py
+import random
+from typing import List, Optional
+
+
+class RandomWalk:
+    """
+    随机游走类，实现二维平面上的随机方向移动
+
+    Attributes:
+        rn (list): 当前位置坐标 [x, y]
+        all_positions (list): 记录所有走过的位置，格式为 [[x1,y1], [x2,y2], ...]
+    """
+
+    def __init__(self, start_position: List[int] = None):
+        """
+        初始化随机游走对象
+
+        Args:
+            start_position: 起始位置，默认 [0, 0]
+        """
+        self.rn = start_position if start_position is not None else [0, 0]
+        self.CHOICES = ['up', 'down', 'left', 'right']
+        self.UD = ['up', 'down']
+        self.LR = ['left', 'right']
+        self.all_positions = [self.rn.copy()]  # 初始化位置记录
+
+    def _choice_walk(self) -> List[int]:
+        """私有方法：执行单次随机移动，更新位置"""
+        choice = random.choice(self.CHOICES)
+        if choice in self.UD:
+            self.rn[0] += 1 if choice == 'up' else -1
+        else:
+            self.rn[1] += 1 if choice == 'right' else -1
+        self.all_positions.append(self.rn.copy())
+        return self.rn
+
+    def walk(self, steps: int, verbose: bool = True) -> List[List[int]]:
+        """
+        执行指定步数的随机游走
+
+        Args:
+            steps: 移动步数
+            verbose: 是否打印每步位置，默认 True
+
+        Returns:
+            所有走过的位置列表
+        """
+        for step in range(1, steps + 1):
+            self._choice_walk()
+            if verbose:
+                print(f"Step {step}: x={self.rn[0]}, y={self.rn[1]}")
+        return self.all_positions
+
+    def plot_walk(self, figsize: tuple = (8, 6)) -> None:
+        """
+        可视化随机游走路径（需安装matplotlib）
+
+        Args:
+            figsize: 图表尺寸，默认 (8,6)
+        """
+        try:
+            import matplotlib.pyplot as plt
+        except ImportError:
+            raise ImportError("请先安装matplotlib: pip install matplotlib")
+
+        x_coords = [pos[0] for pos in self.all_positions]
+        y_coords = [pos[1] for pos in self.all_positions]
+
+        plt.figure(figsize=figsize)
+        plt.plot(x_coords, y_coords, marker='o', markersize=4, linestyle='-', color='blue')
+        plt.scatter(x_coords[0], y_coords[0], color='green', s=100, label='Start')
+        plt.scatter(x_coords[-1], y_coords[-1], color='red', s=100, label='End')
+        plt.xlabel('X Position')
+        plt.ylabel('Y Position')
+        plt.title('Random Walk Path')
+        plt.legend()
+        plt.grid(True)
+        plt.show()
+
+    @property
+    def current_position(self) -> str:
+        """返回当前位置的可读字符串"""
+        return f"x position: {self.rn[0]}, y position: {self.rn[1]}"

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

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: random-walk-lib
+Version: 1.0.0
+Summary: A Python library for 2D random walk with visualization
+Home-page: https://github.com/hello1-UI/random-walk-lib
+Author: hello1-UI
+Author-email: freetongdynastynet@hotmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: matplotlib>=3.0
+
+# Random Walk Lib
+一个实现二维随机游走的Python库，支持步数控制、位置记录和路径可视化。
+
+## 安装
+### 本地安装
+```bash
+# 进入项目根目录
+cd path/to/random_walk_lib
+pip install .
+```
+
+---
+
+### 第二步：本地安装并测试
+打开终端，按以下步骤操作：
+#### 1. 进入项目根目录
+```bash
+cd path/to/random_walk_lib  # 替换成你的项目根目录路径
+```

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

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+setup.cfg
+random_walk_lib/__init__.py
+random_walk_lib/random_walk.py
+random_walk_lib.egg-info/PKG-INFO
+random_walk_lib.egg-info/SOURCES.txt
+random_walk_lib.egg-info/dependency_links.txt
+random_walk_lib.egg-info/requires.txt
+random_walk_lib.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+matplotlib>=3.0

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

@@ -0,0 +1 @@
+random_walk_lib

random_walk_lib-1.0.0/setup.cfg

@@ -0,0 +1,26 @@
+[metadata]
+name = random-walk-lib
+version = 1.0.0
+author = hello1-UI
+author_email = freetongdynastynet@hotmail.com
+description = A Python library for 2D random walk with visualization
+long_description = file: README.md
+long_description_content_type = text/markdown
+url = https://github.com/hello1-UI/random-walk-lib
+classifiers = 
+	Programming Language :: Python :: 3
+	License :: OSI Approved :: MIT License
+	Operating System :: OS Independent
+
+[options]
+packages = find:
+python_requires = >=3.8
+install_requires = matplotlib>=3.0
+
+[options.packages.find]
+where = .
+
+[egg_info]
+tag_build = 
+tag_date = 0
+