Was ist der Unterschied zwischen RSpec ' s Thema und lassen? Wann sollte Sie verwendet werden oder nicht?

Zusammenfassung: RSpec Thema ist eine spezielle variable, die sich auf das Objekt getestet wird. Erwartungen kann es sich implizit unterstützt, die die one-line-Beispiele. Es ist dem Leser klar, in einigen idiomatischen Fällen, aber ist sonst schwer zu verstehen und sollte vermieden werden. RSpec ist let Variablen sind nur faul instanziiert (memoized) Variablen. Sie sind nicht so schwer zu Folgen, da das Thema, aber es kann noch immer führen zu Wirren tests so verwendet werden, sollten mit Diskretion.

Das Thema

, Wie es funktioniert

Ist das Subjekt-Objekt getestet. RSpec ist eine explizite Vorstellung von dem Thema. Es kann oder kann nicht definiert werden. Wenn es ist, RSpec, können rufen Sie die Methoden auf, ohne darauf zu verweisen ausdrücklich.

Standardmäßig, wenn das erste argument zu einem äußersten Beispiel Gruppe (describe oder context block) ist eine Klasse, RSpec erstellt eine Instanz der Klasse und weist auf das Thema. Zum Beispiel, die folgenden Pässe:

class A
end

describe A do
  it "is instantiated by RSpec" do
    expect(subject).to be_an(A)
  end
end

Können Sie definieren, das Thema selbst mit subject:

describe "anonymous subject" do
  subject { A.new }
  it "has been instantiated" do
    expect(subject).to be_an(A)
  end
end

Können Sie geben dem Thema einen Namen, wenn Sie es definieren:

describe "named subject" do
  subject(:a) { A.new }
  it "has been instantiated" do
    expect(a).to be_an(A)
  end
end

Selbst wenn Sie nennen Sie das Thema, können Sie immer noch finden es anonym:

describe "named subject" do
  subject(:a) { A.new }
  it "has been instantiated" do
    expect(subject).to be_an(A)
  end
end

Können Sie definieren, mehr als ein Thema benannt. Die zuletzt definierte benannte Thema ist die anonyme subject.

Aber das Thema ist definiert,

1. Ist es instanziiert träge. Das heißt, die implizite Instanziierung der beschriebenen Klasse oder mit der Ausführung der block übergeben subject nicht der Fall, bis subject oder der benannte Gegenstand ist, gemäß einem Beispiel. Wenn Sie möchten, dass Ihre explizite Thema instanziiert werden eifrig (vor ein Beispiel in seine Gruppe läuft), sagen subject! statt subject.

2. Erwartungen gesetzt werden können, auf die es implizit (ohne schreiben subject oder den Namen einer benannten Thema):

   describe A do
     it { is_expected.to be_an(A) }
   end

   Dem Thema existiert, um zu unterstützen, diese one-line-syntax.

, Wenn es zu benutzen

Einer impliziten subject (abgeleitet aus dem Beispiel-Gruppe) ist schwer zu verstehen, weil

• Es instanziiert hinter die kulissen.
• Ob es implizit (durch Aufruf is_expected ohne expliziten Empfänger) oder explizit (wie subject), der Leser erhält keine Informationen über die Rolle oder die Art des Objekts, auf dem die Erwartung genannt wird.
• Die one-liner Beispiel-syntax nicht ein Beispiel einer Beschreibung (das string-argument zu it im normalen Beispiel-syntax), so ist die einzige information, die die Leser über den Zweck des Beispiels ist die Erwartung selbst.

Daher es ist nur hilfreich, um ein implizites Thema ist, wenn der Kontext wahrscheinlich zu gut verstanden werden, indem alle Leser und es gibt wirklich keine Notwendigkeit für ein Beispiel Beschreibung. Der kanonische Fall ist die Prüfung ActiveRecord Validierungen mit shoulda Matcher:

describe Article do
  it { is_expected.to validate_presence_of(:title) }
end

Eine explizite anonyme subject (definiert mit subject ohne Namen) ist ein wenig besser, weil der Leser sehen kann, wie es ist instanziert, aber

• es kann immer noch die Instanziierung von dem Thema weit von dort, wo es verwendet wird (z.B. an der Spitze einer Gruppe mit vielen Beispielen, die es verwenden), die ist immer noch schwer zu Folgen, und
• es hat die anderen Probleme, die das implizite Subjekt hat.

Benannte Thema bietet eine aufschlussreichere name, aber der einzige Grund für die Verwendung einer benannten Thema, anstatt ein let variable ist, wenn Sie möchten, verwenden Sie das anonyme Thema für einige Zeit, und wir haben nur erklärt, warum der anonyme Thema ist schwer zu verstehen.

So, legitimen Nutzungen der eine explizite anonyme subject oder eine benannte Thema sind sehr selten.

let Variablen

, Wie Sie funktionieren

let Variablen sind genau wie die benannten Fächer bis auf zwei Unterschiede:

• Sie definiert sind, mit let/let! statt subject/subject!
• Sie nicht die anonyme subject oder erlauben, den Erwartungen gerecht zu werden rief es implizit.

Wann Sie zu verwenden

Es ist völlig legitim, zu verwenden let zu reduzieren, Doppelarbeit zu Beispielen. Allerdings tun Sie dies nur, wenn es nicht Opfer test Klarheit. Die sicherste Zeit, um let ist, wenn die let variable hat den Zweck ganz klar aus seinem Namen (so dass der Leser nicht finden, die definition, die viele Zeilen entfernt, zu verstehen, jedes Beispiel) und es ist verwendet in der gleichen Weise in jedem Beispiel. Wenn entweder von diesen Dingen ist nicht wahr, betrachten Sie definieren das Objekt in einem normalen alten lokalen Variablen oder den Aufruf einer factory-Methode direkt in der Beispiel.

let! ist riskant, weil es ist nicht faul. Wenn jemand fügt ein Beispiel an, das Beispiel Gruppe, die enthält die let!, aber das Beispiel muss nicht die let! variable,

• die beispielsweise schwer zu verstehen, weil der Leser wird sehen, die let! variable und Frage mich, ob und wie es wirkt sich auf das Beispiel
• Beispiel langsamer, als es sein muss, weil die Zeit, die zum erstellen der let! variablle

So verwenden let!, wenn überhaupt, nur in kleinen, einfachen Beispiel Gruppen, in denen es weniger wahrscheinlich ist, dass zukünftige Beispiel Autoren in diese Falle tappen.

Die single-Erwartung-pro-Beispiel Fetisch

Es ist eine Allgemeine überbeanspruchung der Subjekte oder let Variablen, die den Wert der Diskussion getrennt. Einige Leute mögen, Sie zu benutzen wie diese:

describe 'Calculator' do
  describe '#calculate' do
    subject { Calculator.calculate }
    it { is_expected.to be >= 0 }
    it { is_expected.to be <= 9 }
  end
end

(Dies ist ein einfaches Beispiel einer Methode, die eine Zahl zurückgibt, für was brauchen wir zwei Erwartungen, aber dieser Stil kann viele weitere Beispiele/Erwartungen, wenn die Methode gibt ein komplizierter Wert, muss vielen Erwartungen und/oder hat viele Nebenwirkungen, die brauchen alle Erwartungen.)

Menschen tun dies, weil Sie gehört haben, dass man nur eine Erwartung pro Beispiel (gemischt mit der gültigen Regel, dass man nur testen Sie eine Methode aufrufen pro Beispiel) oder weil Sie in der Liebe mit RSpec trickiness. Tun Sie es nicht, ob eine anonyme oder eine benannte Person oder einer let variable! Dieser Stil hat mehrere Probleme:

• Das anonyme Subjekt ist nicht das Subjekt des Beispiele — die Methode ist das Thema. Schreiben des Tests auf diese Weise nach oben Schrauben, die Sprache, die es schwerer zu denken.
• Wie immer mit one-line-Beispiele, es gibt keinen Raum, um zu erklären Sie die Bedeutung der Erwartungen.
• Das Subjekt konstruiert werden, für jedes Beispiel, das ist langsam.

Stattdessen schreiben Sie ein einziges Beispiel:

describe 'Calculator' do
  describe '#calculate' do
    it "returns a single-digit number" do
      result = Calculator.calculate
      expect(result).to be >= 0
      expect(result).to be <= 9
    end
  end
end

subject ist, was ist unter test, in der Regel eine Instanz oder eine Klasse. let ist für die Zuweisung der Variablen in den tests, die bewertet werden faul vs. Verwendung von Instanz-Variablen. Es gibt einige schöne Beispiele in diesem thread.

https://github.com/reachlocal/rspec-style-guide/issues/6