查找和指定要运行的特定故事可能很麻烦。

使用“shortcut”函数，你只需指定出现在故事标题中的一个或多个关键词，就可以选择要运行的特定故事。 忽略大小写和特殊字符。

如果指定的关键词不匹配任何故事或匹配多个故事，则会引发错误。

代码示例

example1.story

Create file:
  steps:
    - Create file
Create file again:
  steps:
    - Create file

example2.story

Create files:
  steps:
    - Create file

使用代码

from hitchstory import StoryCollection, BaseEngine
from ensure import Ensure
from pathlib import Path

class Engine(BaseEngine):
    def create_file(self, filename="step1.txt", content="example"):
        with open(filename, 'w') as handle:
            handle.write(content)

story_collection = StoryCollection(Path(".").glob("*.story"), Engine())

找到并运行故事

story_collection.shortcut("file", "again").play()

将输出

RUNNING Create file again in /path/to/working/example1.story ... SUCCESS in 0.1 seconds.

找不到故事

story_collection.shortcut("toast").play()

找到多个故事

story_collection.shortcut("file").play()

可执行规范

从 shortcut.story storytests 自动生成的文档。