getting-started

Getting Started

Project layout

A Behave project keeps spec files in a specs/ directory at the project root. The behave runner picks up any file matching spec.raku (e.g. 001-basic-spec.raku, users-spec.raku, subdir/admin-spec.raku).

my-project/
├── lib/
│   └── MyApp.rakumod
└── specs/
    ├── basic-spec.raku
    └── users/
        └── auth-spec.raku

Your first spec

Every spec file starts with use BDD::Behave; and then declares one or more top-level describe blocks.

use BDD::Behave;

describe 'arithmetic', {
  it 'adds integers', {
    expect(1 + 1).to.be(2);
  }

  it 'multiplies integers', {
    expect(3 * 4).to.be(12);
  }
}

Running specs

Run all specs found in specs/:

behave

Run a single spec file:

behave specs/basic-spec.raku

During local development of an app whose lib/ is not yet installed, prefix with raku -Ilib:

raku -Ilib bin/behave specs/basic-spec.raku

See Running Specs for the full set of options.

Where to go next

describe / context: group related examples
it: define an example
let: lazy, memoized values per example
Hooks: before-each, after-each, before-all, after-all
Shared Contexts: reusable lets and hooks via shared-context / include-context
expect: assertions

BDD::Behave v0.9.4

Behavior driven development framework

Authors

Greg Donald

License

Artistic-2.0

Dependencies

Test Dependencies

Test Test::META Test::Output

Provides

BDD::Behave
BDD::Behave::Benchmark
BDD::Behave::Benchmark::Baseline
BDD::Behave::Benchmark::Format
BDD::Behave::Bisect
BDD::Behave::Colors
BDD::Behave::Configuration
BDD::Behave::Coverage
BDD::Behave::DSL
BDD::Behave::Diff
BDD::Behave::DocExtractor
BDD::Behave::DryRun
BDD::Behave::Expectation
BDD::Behave::Failure
BDD::Behave::FailureStore
BDD::Behave::Failures
BDD::Behave::Files
BDD::Behave::Formatter
BDD::Behave::Formatter::Documentation
BDD::Behave::Formatter::HTML
BDD::Behave::Formatter::JSON
BDD::Behave::Formatter::JUnit
BDD::Behave::Formatter::JsonEvents
BDD::Behave::Formatter::Progress
BDD::Behave::Formatter::Registry
BDD::Behave::Formatter::TAP
BDD::Behave::Formatter::Tree
BDD::Behave::LetRuntime
BDD::Behave::Matcher
BDD::Behave::Matcher::Async
BDD::Behave::Matcher::Boolean
BDD::Behave::Matcher::Change
BDD::Behave::Matcher::Collection
BDD::Behave::Matcher::Core
BDD::Behave::Matcher::Custom
BDD::Behave::Matcher::Exception
BDD::Behave::Matcher::Numeric
BDD::Behave::Matcher::String
BDD::Behave::Matcher::Type
BDD::Behave::Mock::Allow
BDD::Behave::Mock::ArgMatcher
BDD::Behave::Mock::Double
BDD::Behave::Mock::HaveReceived
BDD::Behave::Mock::Spy
BDD::Behave::Mock::Stub
BDD::Behave::Parallel
BDD::Behave::Parallel::Distribution
BDD::Behave::Parallel::EventStream
BDD::Behave::Parallel::Manifest
BDD::Behave::Parallel::Queue
BDD::Behave::Parallel::WorkerPool
BDD::Behave::Runner
BDD::Behave::SharedContexts
BDD::Behave::SharedExamples
BDD::Behave::Slang
BDD::Behave::SpecLoader
BDD::Behave::SpecRegistry
BDD::Behave::SpecTree
BDD::Behave::SpecTree::Core
BDD::Behave::SpecTree::Example
BDD::Behave::SpecTree::ExampleGroup
BDD::Behave::SpecTree::Suite
BDD::Behave::Time
BDD::Behave::TypeName
BDD::Behave::Version
BDD::Behave::Watch
BDD::Behave::Watch::Session
BDD::Behave::Watch::SmartSelector
BDD::Behave::Watch::UI
BDD::Behave::Watch::Watcher
BDD::Behave::Worker