Stash规则的基本功能

Stash规则可以自动缓存某些文件,例如生成的文档、脚本、测试用例等，当运行时，Stash会根据缓存文件的内容快速加载这些文件，而不是从文件头读取。

配置Stash规则的步骤

选择缓存文件

Stash需要一个缓存文件,通常命名为 stash.cbin应包含可执行的命令行脚本或 Python 代码，以供Stash读取。

选择路径：

• 将缓存文件放置在项目目录下,src 或 src/test。
• 或者在项目根目录下,~/.stash。

缓存路径：

• 缓存文件的路径通常设置为 stash.cbin。
• 如果需要更具体的路径,可以在项目目录下设置，src/test/stash.cbin。

配置缓存路径

Stash会根据当前项目目录自动查找缓存文件。

• 如果项目目录是 myproject, 那么缓存文件通常在 myproject/src/test/stash.cbin。
• 如果项目目录是 , 那么默认在 src/test/stash.cbin。

缓存路径的设置：

• 如果需要修改缓存文件的位置,可以在项目目录中设置，

  mkdir src/test/stash.cbin

  然后在 myproject/src/test 目录下放置文件。

缓存大小（Size）

Stash默认缓存大小为 256 KB，如果需要更大的缓存，可以调整大小。

调整大小：

stash --size 512

缓存时间（Time）

Stash默认缓存时间是 1 分钟，如果需要更短的时间，可以调整。

调整时间：

stash --time 3

缓存文件格式（Format）

Stash默认文件格式为 ASCII，如果需要中文或其他格式，可以指定。

设置格式：

stash --format UTF-8

缓存文件内容（Content）

Stash会读取缓存文件的内容,通常使用文件内容或 Python 代码，如果需要手动编写代码，可以将代码添加到文件内容中。

编写代码：

stash --content "import os\nprint(os.path.dirname(__file__))"

使用场景

1. 开发环境： 尽可能减少启动时的等待时间。
2. 测试： 添加缓存文件，快速加载测试用例。
3. 自动化： 用于自动化脚本或脚本脚本的自动执行。

常见问题和解决方案

问题：缓存未生效（Stash未生效）

• 原因： 缓存文件未被写入或读取。
• 解决方法：
  1. 确保缓存文件已写入。
  2. 确保文件路径正确。
  3. 确保Python版本正确。

问题：缓存失败（Stash失败）

• 原因： 缓存文件未被读取。
• 解决方法：
  1. 确保缓存文件已写入。
  2. 确保文件路径正确。
  3. 确保Python版本正确。
  4. 调整缓存大小或时间。

问题：缓存时间过长（Stash过时）

• 原因： 时间设置过长，导致缓存文件过期。
• 解决方法：

  调整时间设置,减少过时时间。