R规格大型规格文件组织

Question

我只是想知道其他人如何组织大型规范文件（尤其是模型），其中许多上下文和部分组织在描述块中，以进行验证和其他可以以某种有意义的方式分组的规范。

你们是否将有关模型的所有规格保留在该模型的同一规格文件中，或者以某种方式拆分为模块？

到目前为止，我从来没有太关心这个问题，但我想知道其他人在做什么，因为似乎没有就最佳实践等达成某种共识。

我有一些模型的相当大的规格文件，我想将它们组织成较小的文件，并且不同模型之间几乎没有共享的功能，所以我不确定共享示例是否是解决这个问题的方法（不管可重用性）或者是否有更好的方法。有什么建议吗？

提前致谢。

Answer 1

嵌套上下文可以在这里为您提供帮助，但请保持浅层（通常深一层）。每个示例中需要考虑两个变量：给定（起始状态）和正在调用的方法。您可以按方法或状态对事物进行分组：

# by method
describe Stack do
  describe "#push" do
    it "adds an element to an empty stack"
    it "adds an element to a non-empty stack"
  end

  describe "#pop" do
    it "returns nil from an empty stack"
    it "returns the last element of a non-empty stack"
    it "removes the last element from a non-empty stack"
  end
end

# by state
describe Stack do
  context "when empty" do
    specify "push adds an element"
    specify "pop returns nil"
  end

  context "when not empty" do
    specify "push adds an element"
    specify "pop returns last element"
    specify "pop removes last element"
  end
end

我已经使用了这两种方法，并且发现它们都工作得非常好和非常糟糕。这两种方法的关键在于，当您从上到下阅读时，示例会讲述一个故事。随着需求的发展，这意味着您需要检查此文件，就像检查实现代码一样。
检查规范是否有意义的一个简单方法是使用文档格式化程序运行它：

rspec stack_spec.rb --format documentation

这会按顺序吐出所有名称（假设您没有使用 --order rand）：

Stack
  #push
    adds an element to an empty stack
    adds an element to a non-empty stack
  #pop
    returns nil from an empty stack
    returns the last element of a non-empty stack
    removes the last element from a non-empty stack

或者

Stack
  when empty
    push adds an element
    pop returns nil
  when not empty
    push adds an element
    pop returns last element
    pop removes last element

一旦您看到此输出，它就会您非常清楚您所使用的组织是否有意义。