You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iggy.apache.org by hg...@apache.org on 2025/06/07 19:53:20 UTC

(iggy) branch master updated: feat(repo): add basic BDD scenario, implement it for Rust SDK (#1842)

This is an automated email from the ASF dual-hosted git repository.

hgruszecki pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/iggy.git


The following commit(s) were added to refs/heads/master by this push:
     new fee13602 feat(repo): add basic BDD scenario, implement it for Rust SDK (#1842)
fee13602 is described below

commit fee13602c0e70624b65a3f39084e4d30d5266a5d
Author: Hubert Gruszecki <h....@gmail.com>
AuthorDate: Sat Jun 7 21:53:13 2025 +0200

    feat(repo): add basic BDD scenario, implement it for Rust SDK (#1842)
    
    This commit introduces a Behavior-Driven Development (BDD)
    testing scenario. The BDD tests are designed to be used by SDKs
    in other languages for pull request testing. The changes include:
    
    - New directory with BDD scenarios.
    - Addition of a new `bdd` package for Rust SDK.
    - Implementation of basic messaging operations as a feature.
    - Creation of helper modules for test data and step definitions.
    - Integration of the BDD framework into the existing workspace.
    - Updates to `Cargo.toml` files to include new dependencies and
    configurations.
---
 Cargo.lock                                         | 377 ++++++++++++++++++++-
 Cargo.toml                                         |   1 +
 DEPENDENCIES.md                                    |  35 ++
 bdd/basic_messaging.feature                        |  45 +++
 .../sinks/stdout_sink => bdd}/Cargo.toml           |  41 ++-
 core/bdd/tests/basic_messaging.rs                  |  29 ++
 core/bdd/tests/common/global_context.rs            |  36 ++
 core/bdd/tests/common/mod.rs                       |  19 ++
 core/bdd/tests/helpers/mod.rs                      |  19 ++
 core/bdd/tests/helpers/test_data.rs                |  37 ++
 core/bdd/tests/steps/auth.rs                       |  45 +++
 core/bdd/tests/steps/messages.rs                   | 183 ++++++++++
 core/bdd/tests/steps/mod.rs                        |  23 ++
 core/bdd/tests/steps/server.rs                     |  31 ++
 core/bdd/tests/steps/streams.rs                    |  72 ++++
 core/bdd/tests/steps/topics.rs                     |  83 +++++
 core/connectors/sinks/quickwit_sink/Cargo.toml     |   8 +-
 core/connectors/sinks/stdout_sink/Cargo.toml       |   8 +-
 core/connectors/sources/random_source/Cargo.toml   |   8 +-
 core/server/Cargo.toml                             |   6 +-
 20 files changed, 1067 insertions(+), 39 deletions(-)

diff --git a/Cargo.lock b/Cargo.lock
index d2b1d828..1f410423 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -848,6 +848,17 @@ dependencies = [
  "zeroize",
 ]
 
+[[package]]
+name = "bdd"
+version = "0.0.1"
+dependencies = [
+ "bytes",
+ "cucumber",
+ "iggy",
+ "integration",
+ "tokio",
+]
+
 [[package]]
 name = "bench"
 version = "0.2.4"
@@ -1201,6 +1212,12 @@ dependencies = [
  "syn 1.0.109",
 ]
 
+[[package]]
+name = "bytecount"
+version = "0.6.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "175812e0be2bccb6abe50bb8d566126198344f707e304f45c648fd8f2cc0365e"
+
 [[package]]
 name = "bytemuck"
 version = "1.23.0"
@@ -1387,6 +1404,7 @@ dependencies = [
  "anstyle",
  "clap_lex",
  "strsim",
+ "terminal_size",
 ]
 
 [[package]]
@@ -1404,7 +1422,7 @@ version = "4.5.32"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "09176aae279615badda0765c0c0b3f6ed53f4709118af73cf4655d85d1530cd7"
 dependencies = [
- "heck",
+ "heck 0.5.0",
  "proc-macro2",
  "quote",
  "syn 2.0.101",
@@ -1495,6 +1513,19 @@ dependencies = [
  "yaml-rust2",
 ]
 
+[[package]]
+name = "console"
+version = "0.15.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "054ccb5b10f9f2cbf51eb355ca1d05c2d279ce1804688d0db74b4733a5aeafd8"
+dependencies = [
+ "encode_unicode",
+ "libc",
+ "once_cell",
+ "unicode-width",
+ "windows-sys 0.59.0",
+]
+
 [[package]]
 name = "console-api"
 version = "0.8.1"
@@ -1790,6 +1821,65 @@ dependencies = [
  "cipher",
 ]
 
+[[package]]
+name = "cucumber"
+version = "0.21.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6cd12917efc3a8b069a4975ef3cb2f2d835d42d04b3814d90838488f9dd9bf69"
+dependencies = [
+ "anyhow",
+ "clap",
+ "console",
+ "cucumber-codegen",
+ "cucumber-expressions",
+ "derive_more 0.99.20",
+ "drain_filter_polyfill",
+ "either",
+ "futures",
+ "gherkin",
+ "globwalk",
+ "humantime",
+ "inventory",
+ "itertools 0.13.0",
+ "lazy-regex",
+ "linked-hash-map",
+ "once_cell",
+ "pin-project",
+ "regex",
+ "sealed",
+ "smart-default",
+]
+
+[[package]]
+name = "cucumber-codegen"
+version = "0.21.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9e19cd9e8e7cfd79fbf844eb6a7334117973c01f6bad35571262b00891e60f1c"
+dependencies = [
+ "cucumber-expressions",
+ "inflections",
+ "itertools 0.13.0",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "syn 2.0.101",
+ "synthez",
+]
+
+[[package]]
+name = "cucumber-expressions"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d794fed319eea24246fb5f57632f7ae38d61195817b7eb659455aa5bdd7c1810"
+dependencies = [
+ "derive_more 0.99.20",
+ "either",
+ "nom",
+ "nom_locate",
+ "regex",
+ "regex-syntax 0.7.5",
+]
+
 [[package]]
 name = "darling"
 version = "0.20.11"
@@ -2078,6 +2168,12 @@ version = "0.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1435fa1053d8b2fbbe9be7e97eca7f33d37b28409959813daefc1446a14247f1"
 
+[[package]]
+name = "drain_filter_polyfill"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "669a445ee724c5c69b1b06fe0b63e70a1c84bc9bb7d9696cd4f4e3ec45050408"
+
 [[package]]
 name = "dtoa"
 version = "1.0.10"
@@ -2123,6 +2219,12 @@ version = "0.6.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "edd0f118536f44f5ccd48bcb8b111bdc3de888b58c74639dfb034a357d0f206d"
 
+[[package]]
+name = "encode_unicode"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34aa73646ffb006b8f5147f3dc182bd4bcb190227ce861fc4a4844bf8e3cb2c0"
+
 [[package]]
 name = "encoding_rs"
 version = "0.8.35"
@@ -2604,6 +2706,23 @@ dependencies = [
  "polyval",
 ]
 
+[[package]]
+name = "gherkin"
+version = "0.14.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "20b79820c0df536d1f3a089a2fa958f61cb96ce9e0f3f8f507f5a31179567755"
+dependencies = [
+ "heck 0.4.1",
+ "peg",
+ "quote",
+ "serde",
+ "serde_json",
+ "syn 2.0.101",
+ "textwrap",
+ "thiserror 1.0.69",
+ "typed-builder",
+]
+
 [[package]]
 name = "gimli"
 version = "0.31.1"
@@ -2631,6 +2750,30 @@ version = "0.3.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a8d1add55171497b4705a648c6b583acafb01d58050a51727785f0b2c8e0a2b2"
 
+[[package]]
+name = "globset"
+version = "0.4.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "54a1028dfc5f5df5da8a56a73e6c153c9a9708ec57232470703592a3f18e49f5"
+dependencies = [
+ "aho-corasick",
+ "bstr",
+ "log",
+ "regex-automata 0.4.9",
+ "regex-syntax 0.8.5",
+]
+
+[[package]]
+name = "globwalk"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0bf760ebf69878d9fd8f110c89703d90ce35095324d1f1edcb595c63945ee757"
+dependencies = [
+ "bitflags 2.9.0",
+ "ignore",
+ "walkdir",
+]
+
 [[package]]
 name = "gloo"
 version = "0.8.1"
@@ -3196,6 +3339,12 @@ dependencies = [
  "stable_deref_trait",
 ]
 
+[[package]]
+name = "heck"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "95505c38b4572b2d910cecb0281560f54b440a19336cbbcb27bf6ce6adc6f5a8"
+
 [[package]]
 name = "heck"
 version = "0.5.0"
@@ -3779,6 +3928,22 @@ dependencies = [
  "tracing-subscriber",
 ]
 
+[[package]]
+name = "ignore"
+version = "0.4.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6d89fd380afde86567dfba715db065673989d6253f42b88179abd3eae47bda4b"
+dependencies = [
+ "crossbeam-deque",
+ "globset",
+ "log",
+ "memchr",
+ "regex-automata 0.4.9",
+ "same-file",
+ "walkdir",
+ "winapi-util",
+]
+
 [[package]]
 name = "impl-more"
 version = "0.1.9"
@@ -3833,6 +3998,12 @@ version = "0.3.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "0e125c680c3871dc195cfd3ff94a877a78f31d5e9c1a3a62cce82689ece14bf7"
 
+[[package]]
+name = "inflections"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a257582fdcde896fd96463bf2d40eefea0580021c0712a0e2b028b60b47a837a"
+
 [[package]]
 name = "inlinable_string"
 version = "0.1.15"
@@ -3914,6 +4085,15 @@ dependencies = [
  "zip",
 ]
 
+[[package]]
+name = "inventory"
+version = "0.3.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ab08d7cd2c5897f2c949e5383ea7c7db03fb19130ffcfbf7eda795137ae3cb83"
+dependencies = [
+ "rustversion",
+]
+
 [[package]]
 name = "ipnet"
 version = "2.11.0"
@@ -3945,6 +4125,15 @@ dependencies = [
  "either",
 ]
 
+[[package]]
+name = "itertools"
+version = "0.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "413ee7dfc52ee1a4949ceeb7dbc8a33f2d6c088194d9f922fb8318faf1f01186"
+dependencies = [
+ "either",
+]
+
 [[package]]
 name = "itertools"
 version = "0.14.0"
@@ -4099,6 +4288,29 @@ version = "0.3.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d4345964bb142484797b161f473a503a434de77149dd8c7427788c6e13379388"
 
+[[package]]
+name = "lazy-regex"
+version = "3.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60c7310b93682b36b98fa7ea4de998d3463ccbebd94d935d6b48ba5b6ffa7126"
+dependencies = [
+ "lazy-regex-proc_macros",
+ "once_cell",
+ "regex",
+]
+
+[[package]]
+name = "lazy-regex-proc_macros"
+version = "3.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4ba01db5ef81e17eb10a5e0f2109d1b3a3e29bac3070fdbd7d156bf7dbd206a1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "regex",
+ "syn 2.0.101",
+]
+
 [[package]]
 name = "lazy_static"
 version = "1.5.0"
@@ -4233,6 +4445,12 @@ dependencies = [
  "vcpkg",
 ]
 
+[[package]]
+name = "linked-hash-map"
+version = "0.5.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0717cef1bc8b636c6e1c1bbdefc09e6322da8a9321966e8928ef80d20f7f770f"
+
 [[package]]
 name = "linux-raw-sys"
 version = "0.4.15"
@@ -4547,6 +4765,17 @@ dependencies = [
  "minimal-lexical",
 ]
 
+[[package]]
+name = "nom_locate"
+version = "4.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e3c83c053b0713da60c5b8de47fe8e494fe3ece5267b2f23090a07a053ba8f3"
+dependencies = [
+ "bytecount",
+ "memchr",
+ "nom",
+]
+
 [[package]]
 name = "nonzero_ext"
 version = "0.3.0"
@@ -5092,6 +5321,33 @@ dependencies = [
  "syn 2.0.101",
 ]
 
+[[package]]
+name = "peg"
+version = "0.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f76678828272f177ac33b7e2ac2e3e73cc6c1cd1e3e387928aa69562fa51367"
+dependencies = [
+ "peg-macros",
+ "peg-runtime",
+]
+
+[[package]]
+name = "peg-macros"
+version = "0.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "636d60acf97633e48d266d7415a9355d4389cea327a193f87df395d88cd2b14d"
+dependencies = [
+ "peg-runtime",
+ "proc-macro2",
+ "quote",
+]
+
+[[package]]
+name = "peg-runtime"
+version = "0.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9555b1514d2d99d78150d3c799d4c357a3e2c2a8062cd108e93a06d9057629c5"
+
 [[package]]
 name = "pem"
 version = "3.0.5"
@@ -5766,6 +6022,12 @@ version = "0.6.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f162c6dd7b008981e4d40210aca20b4bd0f9b60ca9271061b07f78537722f2e1"
 
+[[package]]
+name = "regex-syntax"
+version = "0.7.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dbb5fb1acd8a1a18b3dd5be62d25485eb770e05afb408a9627d14d451bae12da"
+
 [[package]]
 name = "regex-syntax"
 version = "0.8.5"
@@ -6224,6 +6486,18 @@ version = "4.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1c107b6f4780854c8b126e228ea8869f4d7b71260f962fefb57b996b8959ba6b"
 
+[[package]]
+name = "sealed"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f4a8caec23b7800fb97971a1c6ae365b6239aaeddfb934d6265f8505e795699d"
+dependencies = [
+ "heck 0.4.1",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.101",
+]
+
 [[package]]
 name = "secrecy"
 version = "0.10.3"
@@ -6611,6 +6885,17 @@ version = "1.15.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8917285742e9f3e1683f0a9c4e6b57960b7314d0b08d30d1ecd426713ee2eee9"
 
+[[package]]
+name = "smart-default"
+version = "0.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0eb01866308440fc64d6c44d9e86c5cc17adfe33c4d6eed55da9145044d0ffc1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.101",
+]
+
 [[package]]
 name = "smartstring"
 version = "1.0.1"
@@ -6622,6 +6907,12 @@ dependencies = [
  "version_check",
 ]
 
+[[package]]
+name = "smawk"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b7c388c1b5e93756d0c740965c41e8822f866621d41acbdf6336a6a168f8840c"
+
 [[package]]
 name = "snafu"
 version = "0.8.5"
@@ -6637,7 +6928,7 @@ version = "0.8.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "03c3c6b7927ffe7ecaa769ee0e3994da3b8cafc8f444578982c83ecb161af917"
 dependencies = [
- "heck",
+ "heck 0.5.0",
  "proc-macro2",
  "quote",
  "syn 2.0.101",
@@ -6718,7 +7009,7 @@ version = "0.27.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c77a8c5abcaf0f9ce05d62342b7d298c346515365c36b673df4ebe3ced01fde8"
 dependencies = [
- "heck",
+ "heck 0.5.0",
  "proc-macro2",
  "quote",
  "rustversion",
@@ -6773,6 +7064,39 @@ dependencies = [
  "syn 2.0.101",
 ]
 
+[[package]]
+name = "synthez"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a3d2c2202510a1e186e63e596d9318c91a8cbe85cd1a56a7be0c333e5f59ec8d"
+dependencies = [
+ "syn 2.0.101",
+ "synthez-codegen",
+ "synthez-core",
+]
+
+[[package]]
+name = "synthez-codegen"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f724aa6d44b7162f3158a57bccd871a77b39a4aef737e01bcdff41f4772c7746"
+dependencies = [
+ "syn 2.0.101",
+ "synthez-core",
+]
+
+[[package]]
+name = "synthez-core"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78bfa6ec52465e2425fd43ce5bbbe0f0b623964f7c63feb6b10980e816c654ea"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "sealed",
+ "syn 2.0.101",
+]
+
 [[package]]
 name = "sysinfo"
 version = "0.34.2"
@@ -6825,6 +7149,16 @@ dependencies = [
  "windows-sys 0.59.0",
 ]
 
+[[package]]
+name = "terminal_size"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "45c6481c4829e4cc63825e62c49186a34538b7b2750b73b266581ffb612fb5ed"
+dependencies = [
+ "rustix 1.0.7",
+ "windows-sys 0.59.0",
+]
+
 [[package]]
 name = "termtree"
 version = "0.5.1"
@@ -6864,6 +7198,17 @@ dependencies = [
  "test-case-core",
 ]
 
+[[package]]
+name = "textwrap"
+version = "0.16.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c13547615a44dc9c452a8a534638acdf07120d4b6847c8178705da06306a3057"
+dependencies = [
+ "smawk",
+ "unicode-linebreak",
+ "unicode-width",
+]
+
 [[package]]
 name = "thiserror"
 version = "1.0.69"
@@ -7343,6 +7688,26 @@ dependencies = [
  "rand 0.8.5",
 ]
 
+[[package]]
+name = "typed-builder"
+version = "0.15.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7fe83c85a85875e8c4cb9ce4a890f05b23d38cd0d47647db7895d3d2a79566d2"
+dependencies = [
+ "typed-builder-macro",
+]
+
+[[package]]
+name = "typed-builder-macro"
+version = "0.15.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29a3151c41d0b13e3d011f98adc24434560ef06673a155a6c7f66b9879eecce2"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.101",
+]
+
 [[package]]
 name = "typenum"
 version = "1.18.0"
@@ -7386,6 +7751,12 @@ version = "1.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5a5f39404a5da50712a4c1eecf25e90dd62b613502b7e925fd4e4d19b5c96512"
 
+[[package]]
+name = "unicode-linebreak"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b09c83c3c29d37506a3e260c08c03743a6bb66a9cd432c6934ab501a190571f"
+
 [[package]]
 name = "unicode-segmentation"
 version = "1.12.0"
diff --git a/Cargo.toml b/Cargo.toml
index e8fa444e..61e69b25 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -21,6 +21,7 @@ codegen-units = 1
 
 [workspace]
 members = [
+    "core/bdd",
     "core/bench",
     "core/bench/dashboard/frontend",
     "core/bench/dashboard/server",
diff --git a/DEPENDENCIES.md b/DEPENDENCIES.md
index 65ae29a2..df8be09c 100644
--- a/DEPENDENCIES.md
+++ b/DEPENDENCIES.md
@@ -65,6 +65,7 @@ backtrace: 0.3.75, "Apache-2.0 OR MIT",
 base64: 0.21.7, "Apache-2.0 OR MIT",
 base64: 0.22.1, "Apache-2.0 OR MIT",
 bcrypt: 0.17.0, "MIT",
+bdd: 0.0.1, "Apache-2.0",
 bench: 0.2.4, "Apache-2.0",
 bench-dashboard-frontend: 0.4.1, "Apache-2.0",
 bench-dashboard-server: 0.4.0, "Apache-2.0",
@@ -93,6 +94,7 @@ bumpalo: 3.17.0, "Apache-2.0 OR MIT",
 byte-unit: 5.1.6, "MIT",
 bytecheck: 0.6.12, "MIT",
 bytecheck_derive: 0.6.12, "MIT",
+bytecount: 0.6.9, "Apache-2.0 OR MIT",
 bytemuck: 1.23.0, "Apache-2.0 OR MIT OR Zlib",
 byteorder: 1.5.0, "MIT OR Unlicense",
 bytes: 1.10.1, "MIT",
@@ -124,6 +126,7 @@ combine: 4.6.7, "MIT",
 comfy-table: 7.1.4, "MIT",
 concurrent-queue: 2.5.0, "Apache-2.0 OR MIT",
 config: 0.15.11, "Apache-2.0 OR MIT",
+console: 0.15.11, "MIT",
 console-api: 0.8.1, "MIT",
 console-subscriber: 0.4.1, "MIT",
 console_error_panic_hook: 0.1.7, "Apache-2.0 OR MIT",
@@ -155,6 +158,9 @@ crypto-common: 0.1.6, "Apache-2.0 OR MIT",
 ctor: 0.4.2, "Apache-2.0 OR MIT",
 ctor-proc-macro: 0.0.5, "Apache-2.0 OR MIT",
 ctr: 0.9.2, "Apache-2.0 OR MIT",
+cucumber: 0.21.1, "Apache-2.0 OR MIT",
+cucumber-codegen: 0.21.1, "Apache-2.0 OR MIT",
+cucumber-expressions: 0.3.0, "Apache-2.0 OR MIT",
 darling: 0.20.11, "MIT",
 darling_core: 0.20.11, "MIT",
 darling_macro: 0.20.11, "MIT",
@@ -183,6 +189,7 @@ dlv-list: 0.5.2, "Apache-2.0 OR MIT",
 doc-comment: 0.3.3, "MIT",
 dotenvy: 0.15.7, "MIT",
 downcast: 0.11.0, "MIT",
+drain_filter_polyfill: 0.1.3, "Apache-2.0 OR MIT",
 dtoa: 1.0.10, "Apache-2.0 OR MIT",
 dtor: 0.0.6, "Apache-2.0 OR MIT",
 dtor-proc-macro: 0.0.5, "Apache-2.0 OR MIT",
@@ -190,6 +197,7 @@ dunce: 1.0.5, "Apache-2.0 OR CC0-1.0 OR MIT-0",
 either: 1.15.0, "Apache-2.0 OR MIT",
 embedded-io: 0.4.0, "Apache-2.0 OR MIT",
 embedded-io: 0.6.1, "Apache-2.0 OR MIT",
+encode_unicode: 1.0.0, "Apache-2.0 OR MIT",
 encoding_rs: 0.8.35, "(Apache-2.0 OR MIT) AND BSD-3-Clause",
 enum_dispatch: 0.3.13, "Apache-2.0 OR MIT",
 env_filter: 0.1.3, "Apache-2.0 OR MIT",
@@ -240,9 +248,12 @@ generic-array: 0.14.7, "MIT",
 getrandom: 0.2.16, "Apache-2.0 OR MIT",
 getrandom: 0.3.3, "Apache-2.0 OR MIT",
 ghash: 0.5.1, "Apache-2.0 OR MIT",
+gherkin: 0.14.0, "Apache-2.0 OR MIT",
 gimli: 0.31.1, "Apache-2.0 OR MIT",
 git2: 0.20.2, "Apache-2.0 OR MIT",
 glob: 0.3.2, "Apache-2.0 OR MIT",
+globset: 0.4.16, "MIT OR Unlicense",
+globwalk: 0.9.1, "MIT",
 gloo: 0.8.1, "Apache-2.0 OR MIT",
 gloo: 0.10.0, "Apache-2.0 OR MIT",
 gloo: 0.11.0, "Apache-2.0 OR MIT",
@@ -283,6 +294,7 @@ hashbrown: 0.15.3, "Apache-2.0 OR MIT",
 hashlink: 0.10.0, "Apache-2.0 OR MIT",
 hdrhistogram: 7.5.4, "Apache-2.0 OR MIT",
 heapless: 0.7.17, "Apache-2.0 OR MIT",
+heck: 0.4.1, "Apache-2.0 OR MIT",
 heck: 0.5.0, "Apache-2.0 OR MIT",
 hermit-abi: 0.3.9, "Apache-2.0 OR MIT",
 hex: 0.4.3, "Apache-2.0 OR MIT",
@@ -327,22 +339,26 @@ iggy_connector_runtime: 0.1.0, "Apache-2.0",
 iggy_connector_sdk: 0.1.0, "Apache-2.0",
 iggy_connector_stdout_sink: 0.1.0, "Apache-2.0",
 iggy_examples: 0.0.5, "Apache-2.0",
+ignore: 0.4.23, "MIT OR Unlicense",
 impl-more: 0.1.9, "Apache-2.0 OR MIT",
 implicit-clone: 0.4.9, "Apache-2.0 OR MIT",
 implicit-clone-derive: 0.1.2, "Apache-2.0 OR MIT",
 indexmap: 1.9.3, "Apache-2.0 OR MIT",
 indexmap: 2.9.0, "Apache-2.0 OR MIT",
 indices: 0.3.6, "Apache-2.0",
+inflections: 1.1.1, "MIT",
 inlinable_string: 0.1.15, "Apache-2.0 OR MIT",
 inotify: 0.11.0, "ISC",
 inotify-sys: 0.1.5, "ISC",
 inout: 0.1.4, "Apache-2.0 OR MIT",
 instant: 0.1.13, "BSD-3-Clause",
 integration: 0.0.1, "Apache-2.0",
+inventory: 0.3.20, "Apache-2.0 OR MIT",
 ipnet: 2.11.0, "Apache-2.0 OR MIT",
 iri-string: 0.7.8, "Apache-2.0 OR MIT",
 is_terminal_polyfill: 1.70.1, "Apache-2.0 OR MIT",
 itertools: 0.12.1, "Apache-2.0 OR MIT",
+itertools: 0.13.0, "Apache-2.0 OR MIT",
 itertools: 0.14.0, "Apache-2.0 OR MIT",
 itoa: 1.0.15, "Apache-2.0 OR MIT",
 jiff: 0.2.13, "MIT OR Unlicense",
@@ -358,6 +374,8 @@ keyring: 3.6.2, "Apache-2.0 OR MIT",
 kqueue: 1.1.1, "MIT",
 kqueue-sys: 1.0.4, "MIT",
 language-tags: 0.3.2, "Apache-2.0 OR MIT",
+lazy-regex: 3.4.1, "MIT",
+lazy-regex-proc_macros: 3.4.1, "MIT",
 lazy_static: 1.5.0, "Apache-2.0 OR MIT",
 lazycell: 1.3.0, "Apache-2.0 OR MIT",
 lending-iterator: 0.1.7, "Apache-2.0 OR MIT OR Zlib",
@@ -371,6 +389,7 @@ libredox: 0.1.3, "MIT",
 libssh2-sys: 0.3.1, "Apache-2.0 OR MIT",
 libyml: 0.0.5, "MIT",
 libz-sys: 1.1.22, "Apache-2.0 OR MIT",
+linked-hash-map: 0.5.6, "Apache-2.0 OR MIT",
 linux-raw-sys: 0.4.15, "Apache-2.0 OR Apache-2.0 WITH LLVM-exception OR MIT",
 linux-raw-sys: 0.9.4, "Apache-2.0 OR Apache-2.0 WITH LLVM-exception OR MIT",
 litemap: 0.8.0, "Unicode-3.0",
@@ -405,6 +424,7 @@ native-tls: 0.2.14, "Apache-2.0 OR MIT",
 never-say-never: 6.6.666, "Apache-2.0 OR MIT OR Zlib",
 nix: 0.30.1, "MIT",
 nom: 7.1.3, "MIT",
+nom_locate: 4.2.0, "MIT",
 nonzero_ext: 0.3.0, "Apache-2.0",
 nonzero_lit: 0.1.2, "Apache-2.0 OR CC0-1.0 OR MIT",
 normalize-line-endings: 0.3.0, "Apache-2.0",
@@ -456,6 +476,9 @@ pathdiff: 0.2.3, "Apache-2.0 OR MIT",
 pbkdf2: 0.12.2, "Apache-2.0 OR MIT",
 pear: 0.2.9, "Apache-2.0 OR MIT",
 pear_codegen: 0.2.9, "Apache-2.0 OR MIT",
+peg: 0.6.3, "MIT",
+peg-macros: 0.6.3, "MIT",
+peg-runtime: 0.6.3, "MIT",
 pem: 3.0.5, "MIT",
 percent-encoding: 2.3.1, "Apache-2.0 OR MIT",
 pest: 2.8.0, "Apache-2.0 OR MIT",
@@ -522,6 +545,7 @@ regex-automata: 0.1.10, "MIT OR Unlicense",
 regex-automata: 0.4.9, "Apache-2.0 OR MIT",
 regex-lite: 0.1.6, "Apache-2.0 OR MIT",
 regex-syntax: 0.6.29, "Apache-2.0 OR MIT",
+regex-syntax: 0.7.5, "Apache-2.0 OR MIT",
 regex-syntax: 0.8.5, "Apache-2.0 OR MIT",
 rend: 0.4.2, "MIT",
 reqwest: 0.12.15, "Apache-2.0 OR MIT",
@@ -561,6 +585,7 @@ scoped-tls: 1.0.1, "Apache-2.0 OR MIT",
 scopeguard: 1.2.0, "Apache-2.0 OR MIT",
 sdd: 3.0.8, "Apache-2.0",
 seahash: 4.1.0, "MIT",
+sealed: 0.5.0, "Apache-2.0 OR MIT",
 secrecy: 0.10.3, "Apache-2.0 OR MIT",
 security-framework: 2.11.1, "Apache-2.0 OR MIT",
 security-framework: 3.2.0, "Apache-2.0 OR MIT",
@@ -592,7 +617,9 @@ simple_asn1: 0.6.3, "ISC",
 siphasher: 1.0.1, "Apache-2.0 OR MIT",
 slab: 0.4.9, "MIT",
 smallvec: 1.15.0, "Apache-2.0 OR MIT",
+smart-default: 0.7.1, "MIT",
 smartstring: 1.0.1, "MPL-2.0+",
+smawk: 0.3.2, "MIT",
 snafu: 0.8.5, "Apache-2.0 OR MIT",
 snafu-derive: 0.8.5, "Apache-2.0 OR MIT",
 socket2: 0.5.9, "Apache-2.0 OR MIT",
@@ -609,15 +636,20 @@ syn: 1.0.109, "Apache-2.0 OR MIT",
 syn: 2.0.101, "Apache-2.0 OR MIT",
 sync_wrapper: 1.0.2, "Apache-2.0",
 synstructure: 0.13.2, "MIT",
+synthez: 0.3.1, "BlueOak-1.0.0",
+synthez-codegen: 0.3.1, "BlueOak-1.0.0",
+synthez-core: 0.3.1, "BlueOak-1.0.0",
 sysinfo: 0.34.2, "MIT",
 sysinfo: 0.35.0, "MIT",
 tagptr: 0.2.0, "Apache-2.0 OR MIT",
 tap: 1.0.1, "MIT",
 tempfile: 3.19.1, "Apache-2.0 OR MIT",
+terminal_size: 0.4.2, "Apache-2.0 OR MIT",
 termtree: 0.5.1, "MIT",
 test-case: 3.3.1, "MIT",
 test-case-core: 3.3.1, "MIT",
 test-case-macros: 3.3.1, "MIT",
+textwrap: 0.16.2, "MIT",
 thiserror: 1.0.69, "Apache-2.0 OR MIT",
 thiserror: 2.0.12, "Apache-2.0 OR MIT",
 thiserror-impl: 1.0.69, "Apache-2.0 OR MIT",
@@ -659,12 +691,15 @@ trait-variant: 0.1.2, "Apache-2.0 OR MIT",
 trim-in-place: 0.1.7, "MIT",
 try-lock: 0.2.5, "MIT",
 twox-hash: 2.1.0, "MIT",
+typed-builder: 0.15.2, "Apache-2.0 OR MIT",
+typed-builder-macro: 0.15.2, "Apache-2.0 OR MIT",
 typenum: 1.18.0, "Apache-2.0 OR MIT",
 ucd-trie: 0.1.7, "Apache-2.0 OR MIT",
 ulid: 1.2.1, "MIT",
 uncased: 0.9.10, "Apache-2.0 OR MIT",
 unicase: 2.8.1, "Apache-2.0 OR MIT",
 unicode-ident: 1.0.18, "(MIT OR Apache-2.0) AND Unicode-3.0",
+unicode-linebreak: 0.1.5, "Apache-2.0",
 unicode-segmentation: 1.12.0, "Apache-2.0 OR MIT",
 unicode-width: 0.2.0, "Apache-2.0 OR MIT",
 unicode-xid: 0.2.6, "Apache-2.0 OR MIT",
diff --git a/bdd/basic_messaging.feature b/bdd/basic_messaging.feature
new file mode 100644
index 00000000..f736aee8
--- /dev/null
+++ b/bdd/basic_messaging.feature
@@ -0,0 +1,45 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+Feature: Basic Messaging Operations
+  As a developer using Apache Iggy
+  I want to perform basic messaging operations
+  So that I can send and receive messages through the platform
+
+  Background:
+    Given I have a running Iggy server
+    And I am authenticated as the root user
+
+  Scenario: Create stream and send messages
+    Given I have no streams in the system
+    When I create a stream with ID 1 and name test-stream
+    Then the stream should be created successfully
+    And the stream should have ID 1 and name test-stream
+    
+    When I create a topic with ID 1 and name test-topic in stream 1 with 3 partitions
+    Then the topic should be created successfully
+    And the topic should have ID 1 and name test-topic 
+    And the topic should have 3 partitions
+    
+    When I send 10 messages to stream 1, topic 1, partition 1
+    Then all messages should be sent successfully
+    
+    When I poll messages from stream 1, topic 1, partition 1 starting from offset 0
+    Then I should receive 10 messages
+    And the messages should have sequential offsets from 0 to 9
+    And each message should have the expected payload content
+    And the last polled message should match the last sent message
\ No newline at end of file
diff --git a/core/connectors/sinks/stdout_sink/Cargo.toml b/core/bdd/Cargo.toml
similarity index 50%
copy from core/connectors/sinks/stdout_sink/Cargo.toml
copy to core/bdd/Cargo.toml
index cf6a8f4d..c459f2dd 100644
--- a/core/connectors/sinks/stdout_sink/Cargo.toml
+++ b/core/bdd/Cargo.toml
@@ -16,29 +16,28 @@
 # under the License.
 
 [package]
-name = "iggy_connector_stdout_sink"
-version = "0.1.0"
-description = "Iggy is the persistent message streaming platform written in Rust, supporting QUIC, TCP and HTTP transport protocols, capable of processing millions of messages per second."
+description = "Behavior-Driven Development (BDD) tests for Apache Iggy"
+name = "bdd"
+version = "0.0.1"
 edition = "2024"
 license = "Apache-2.0"
-keywords = ["iggy", "messaging", "streaming"]
-categories = ["command-line-utilities", "database", "network-programming"]
-homepage = "https://iggy.apache.org"
-documentation = "https://iggy.apache.org/docs"
-repository = "https://github.com/apache/iggy"
-readme = "../../README.md"
 
-[lib]
-crate-type = ["cdylib", "lib"]
-
-[dependencies]
-async-trait = { workspace = true }
-dashmap = { workspace = true }
-iggy_connector_sdk = { workspace = true }
-once_cell = { workspace = true }
-serde = { workspace = true }
+[dev-dependencies]
+bytes = { workspace = true }
+cucumber = "0.21"
+iggy = { workspace = true }
+integration = { path = "../integration" }
 tokio = { workspace = true }
-tracing = { workspace = true }
 
-[package.metadata.cargo-machete]
-ignored = ["dashmap", "once_cell"]
+[[test]]
+name = "basic_messaging"
+harness = false
+
+# Future test scenarios can be added here:
+# [[test]]
+# name = "user_management"
+# harness = false
+#
+# [[test]]
+# name = "consumer_groups"
+# harness = false
diff --git a/core/bdd/tests/basic_messaging.rs b/core/bdd/tests/basic_messaging.rs
new file mode 100644
index 00000000..b2f34976
--- /dev/null
+++ b/core/bdd/tests/basic_messaging.rs
@@ -0,0 +1,29 @@
+/* Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+pub(crate) mod common;
+pub(crate) mod helpers;
+pub(crate) mod steps;
+
+use crate::common::global_context::GlobalContext;
+use cucumber::World;
+
+#[tokio::main]
+async fn main() {
+    GlobalContext::run("../../bdd/basic_messaging.feature").await;
+}
diff --git a/core/bdd/tests/common/global_context.rs b/core/bdd/tests/common/global_context.rs
new file mode 100644
index 00000000..be6a954c
--- /dev/null
+++ b/core/bdd/tests/common/global_context.rs
@@ -0,0 +1,36 @@
+/* Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+use cucumber::World;
+use iggy::clients::client::IggyClient;
+use iggy::prelude::{IggyMessage, PolledMessages};
+use integration::test_server::TestServer;
+
+#[derive(Debug, World, Default)]
+pub struct GlobalContext {
+    pub server: Option<TestServer>,
+    pub client: Option<IggyClient>,
+    pub server_addr: Option<String>,
+    pub last_stream_id: Option<u32>,
+    pub last_stream_name: Option<String>,
+    pub last_topic_id: Option<u32>,
+    pub last_topic_name: Option<String>,
+    pub last_topic_partitions: Option<u32>,
+    pub last_polled_messages: Option<PolledMessages>,
+    pub last_sent_message: Option<IggyMessage>,
+}
diff --git a/core/bdd/tests/common/mod.rs b/core/bdd/tests/common/mod.rs
new file mode 100644
index 00000000..0c28f3a5
--- /dev/null
+++ b/core/bdd/tests/common/mod.rs
@@ -0,0 +1,19 @@
+/* Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+pub mod global_context;
diff --git a/core/bdd/tests/helpers/mod.rs b/core/bdd/tests/helpers/mod.rs
new file mode 100644
index 00000000..b9f11962
--- /dev/null
+++ b/core/bdd/tests/helpers/mod.rs
@@ -0,0 +1,19 @@
+/* Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+pub mod test_data;
diff --git a/core/bdd/tests/helpers/test_data.rs b/core/bdd/tests/helpers/test_data.rs
new file mode 100644
index 00000000..99ab18b5
--- /dev/null
+++ b/core/bdd/tests/helpers/test_data.rs
@@ -0,0 +1,37 @@
+/* Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+use bytes::Bytes;
+use iggy::prelude::IggyMessage;
+
+#[must_use]
+pub fn create_test_messages(count: u32) -> Vec<IggyMessage> {
+    let mut messages = Vec::new();
+    for i in 0..count {
+        let id = u128::from(i + 1);
+        let payload = Bytes::from(format!("test message {i}"));
+        messages.push(
+            IggyMessage::builder()
+                .id(id)
+                .payload(payload)
+                .build()
+                .expect("Should be able to create message"),
+        );
+    }
+    messages
+}
diff --git a/core/bdd/tests/steps/auth.rs b/core/bdd/tests/steps/auth.rs
new file mode 100644
index 00000000..5b2e0f47
--- /dev/null
+++ b/core/bdd/tests/steps/auth.rs
@@ -0,0 +1,45 @@
+/* Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+use crate::common::global_context::GlobalContext;
+use cucumber::given;
+use iggy::clients::client::IggyClient;
+use iggy::prelude::SystemClient;
+use integration::tcp_client::TcpClientFactory;
+use integration::test_server::{ClientFactory, login_root};
+
+#[given("I am authenticated as the root user")]
+pub async fn given_authenticated_as_root(world: &mut GlobalContext) {
+    let server_addr = world
+        .server_addr
+        .as_ref()
+        .expect("Server should be running")
+        .clone();
+    let client_factory = TcpClientFactory {
+        server_addr,
+        ..Default::default()
+    };
+
+    let client = client_factory.create_client().await;
+    let client = IggyClient::create(client, None, None);
+
+    client.ping().await.expect("Server should respond to ping");
+    login_root(&client).await;
+
+    world.client = Some(client);
+}
diff --git a/core/bdd/tests/steps/messages.rs b/core/bdd/tests/steps/messages.rs
new file mode 100644
index 00000000..220d4313
--- /dev/null
+++ b/core/bdd/tests/steps/messages.rs
@@ -0,0 +1,183 @@
+/* Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+use crate::common::global_context::GlobalContext;
+use crate::helpers::test_data::create_test_messages;
+use bytes::Bytes;
+use cucumber::{then, when};
+use iggy::prelude::{
+    Consumer, ConsumerKind, Identifier, IggyMessage, MessageClient, Partitioning, PollingStrategy,
+};
+
+#[when(regex = r"^I send (\d+) messages to stream (\d+), topic (\d+), partition (\d+)$")]
+pub async fn when_send_messages(
+    world: &mut GlobalContext,
+    message_count: u32,
+    stream_id: u32,
+    topic_id: u32,
+    partition_id: u32,
+) {
+    let client = world.client.as_ref().expect("Client should be available");
+    let mut messages = create_test_messages(message_count);
+
+    if let Some(last_message) = messages.last() {
+        let sent_msg = IggyMessage::builder()
+            .id(last_message.header.id)
+            .payload(last_message.payload.clone())
+            .build()
+            .expect("Should be able to create message");
+        world.last_sent_message = Some(sent_msg);
+    }
+
+    client
+        .send_messages(
+            &Identifier::numeric(stream_id).unwrap(),
+            &Identifier::numeric(topic_id).unwrap(),
+            &Partitioning::partition_id(partition_id),
+            &mut messages,
+        )
+        .await
+        .expect("Should be able to send messages");
+}
+
+#[when(
+    regex = r"^I poll messages from stream (\d+), topic (\d+), partition (\d+) starting from offset (\d+)$"
+)]
+pub async fn when_poll_messages(
+    world: &mut GlobalContext,
+    stream_id: u32,
+    topic_id: u32,
+    partition_id: u32,
+    start_offset: u64,
+) {
+    let client = world.client.as_ref().expect("Client should be available");
+    let consumer = Consumer {
+        kind: ConsumerKind::Consumer,
+        id: Identifier::numeric(1).unwrap(),
+    };
+
+    let polled_messages = client
+        .poll_messages(
+            &Identifier::numeric(stream_id).unwrap(),
+            &Identifier::numeric(topic_id).unwrap(),
+            Some(partition_id),
+            &consumer,
+            &PollingStrategy::offset(start_offset),
+            100,
+            false,
+        )
+        .await
+        .expect("Should be able to poll messages");
+
+    world.last_polled_messages = Some(polled_messages);
+}
+
+#[then("all messages should be sent successfully")]
+pub async fn then_messages_sent_successfully(_world: &mut GlobalContext) {}
+
+#[then(regex = r"^I should receive (\d+) messages$")]
+pub async fn then_should_receive_messages(world: &mut GlobalContext, expected_count: u32) {
+    let polled_messages = world
+        .last_polled_messages
+        .as_ref()
+        .expect("Should have polled messages");
+    assert_eq!(
+        polled_messages.messages.len() as u32,
+        expected_count,
+        "Should receive exactly {} messages",
+        expected_count
+    );
+}
+
+#[then(regex = r"^the messages should have sequential offsets from (\d+) to (\d+)$")]
+pub async fn then_messages_have_sequential_offsets(
+    world: &mut GlobalContext,
+    start_offset: u64,
+    end_offset: u64,
+) {
+    let polled_messages = world
+        .last_polled_messages
+        .as_ref()
+        .expect("Should have polled messages");
+
+    for (index, message) in polled_messages.messages.iter().enumerate() {
+        let expected_offset = start_offset + index as u64;
+        assert_eq!(
+            message.header.offset, expected_offset,
+            "Message at index {} should have offset {}",
+            index, expected_offset
+        );
+    }
+
+    let last_message = polled_messages.messages.last().unwrap();
+    assert_eq!(
+        last_message.header.offset, end_offset,
+        "Last message should have offset {}",
+        end_offset
+    );
+}
+
+#[then("each message should have the expected payload content")]
+pub async fn then_messages_have_expected_payload(world: &mut GlobalContext) {
+    let polled_messages = world
+        .last_polled_messages
+        .as_ref()
+        .expect("Should have polled messages");
+
+    for (index, message) in polled_messages.messages.iter().enumerate() {
+        let expected_payload = format!("test message {}", index);
+        assert_eq!(
+            message.payload,
+            Bytes::from(expected_payload.clone()),
+            "Message at offset {} should have payload '{}'",
+            index,
+            expected_payload
+        );
+    }
+}
+
+#[then("the last polled message should match the last sent message")]
+pub async fn then_last_polled_message_matches_sent(world: &mut GlobalContext) {
+    let polled_messages = world
+        .last_polled_messages
+        .as_ref()
+        .expect("Should have polled messages");
+
+    let sent_message = world
+        .last_sent_message
+        .as_ref()
+        .expect("Should have a sent message to compare");
+
+    assert!(
+        !polled_messages.messages.is_empty(),
+        "Should have at least one polled message"
+    );
+
+    let last_polled = polled_messages.messages.last().unwrap();
+
+    assert_eq!(
+        last_polled.header.id, sent_message.header.id,
+        "Message IDs should match: sent {} vs polled {}",
+        sent_message.header.id, last_polled.header.id
+    );
+
+    assert_eq!(
+        last_polled.payload, sent_message.payload,
+        "Message payloads should match"
+    );
+}
diff --git a/core/bdd/tests/steps/mod.rs b/core/bdd/tests/steps/mod.rs
new file mode 100644
index 00000000..e9d00b62
--- /dev/null
+++ b/core/bdd/tests/steps/mod.rs
@@ -0,0 +1,23 @@
+/* Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+pub mod auth;
+pub mod messages;
+pub mod server;
+pub mod streams;
+pub mod topics;
diff --git a/core/bdd/tests/steps/server.rs b/core/bdd/tests/steps/server.rs
new file mode 100644
index 00000000..e2dca32b
--- /dev/null
+++ b/core/bdd/tests/steps/server.rs
@@ -0,0 +1,31 @@
+/* Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+use crate::common::global_context::GlobalContext;
+use cucumber::given;
+use integration::test_server::TestServer;
+
+#[given("I have a running Iggy server")]
+pub async fn given_running_server(world: &mut GlobalContext) {
+    let mut test_server = TestServer::default();
+    test_server.start();
+    let server_addr = test_server.get_raw_tcp_addr().unwrap();
+
+    world.server_addr = Some(server_addr);
+    world.server = Some(test_server);
+}
diff --git a/core/bdd/tests/steps/streams.rs b/core/bdd/tests/steps/streams.rs
new file mode 100644
index 00000000..f64f680e
--- /dev/null
+++ b/core/bdd/tests/steps/streams.rs
@@ -0,0 +1,72 @@
+/* Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+use crate::common::global_context::GlobalContext;
+use cucumber::{given, then, when};
+use iggy::prelude::StreamClient;
+
+#[given("I have no streams in the system")]
+pub async fn given_no_streams(world: &mut GlobalContext) {
+    let client = world.client.as_ref().expect("Client should be available");
+    let streams = client
+        .get_streams()
+        .await
+        .expect("Should be able to get streams");
+    assert!(
+        streams.is_empty(),
+        "System should have no streams initially"
+    );
+}
+
+#[when(regex = r"^I create a stream with ID (\d+) and name (.+)$")]
+pub async fn when_create_stream(world: &mut GlobalContext, stream_id: u32, stream_name: String) {
+    let client = world.client.as_ref().expect("Client should be available");
+    let stream = client
+        .create_stream(&stream_name, Some(stream_id))
+        .await
+        .expect("Should be able to create stream");
+
+    world.last_stream_id = Some(stream.id);
+    world.last_stream_name = Some(stream.name.clone());
+}
+
+#[then("the stream should be created successfully")]
+pub async fn then_stream_created_successfully(world: &mut GlobalContext) {
+    assert!(
+        world.last_stream_id.is_some(),
+        "Stream should have been created"
+    );
+}
+
+#[then(regex = r"^the stream should have ID (\d+) and name (.+)$")]
+pub async fn then_stream_has_id_and_name(
+    world: &mut GlobalContext,
+    expected_id: u32,
+    expected_name: String,
+) {
+    let stream_id = world.last_stream_id.expect("Stream should exist");
+    let stream_name = world
+        .last_stream_name
+        .as_ref()
+        .expect("Stream should exist");
+    assert_eq!(stream_id, expected_id, "Stream should have expected ID");
+    assert_eq!(
+        stream_name, &expected_name,
+        "Stream should have expected name"
+    );
+}
diff --git a/core/bdd/tests/steps/topics.rs b/core/bdd/tests/steps/topics.rs
new file mode 100644
index 00000000..93557663
--- /dev/null
+++ b/core/bdd/tests/steps/topics.rs
@@ -0,0 +1,83 @@
+/* Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+use crate::common::global_context::GlobalContext;
+use cucumber::{then, when};
+use iggy::prelude::{CompressionAlgorithm, Identifier, IggyExpiry, MaxTopicSize, TopicClient};
+
+#[when(
+    regex = r"^I create a topic with ID (\d+) and name (.+) in stream (\d+) with (\d+) partitions$"
+)]
+pub async fn when_create_topic(
+    world: &mut GlobalContext,
+    topic_id: u32,
+    topic_name: String,
+    stream_id: u32,
+    partitions_count: u32,
+) {
+    let client = world.client.as_ref().expect("Client should be available");
+    let topic = client
+        .create_topic(
+            &Identifier::numeric(stream_id).unwrap(),
+            &topic_name,
+            partitions_count,
+            CompressionAlgorithm::default(),
+            None,
+            Some(topic_id),
+            IggyExpiry::NeverExpire,
+            MaxTopicSize::ServerDefault,
+        )
+        .await
+        .expect("Should be able to create topic");
+
+    world.last_topic_id = Some(topic.id);
+    world.last_topic_name = Some(topic.name.clone());
+    world.last_topic_partitions = Some(topic.partitions_count);
+}
+
+#[then("the topic should be created successfully")]
+pub async fn then_topic_created_successfully(world: &mut GlobalContext) {
+    assert!(
+        world.last_topic_id.is_some(),
+        "Topic should have been created"
+    );
+}
+
+#[then(regex = r"^the topic should have ID (\d+) and name (.+)$")]
+pub async fn then_topic_has_id_and_name(
+    world: &mut GlobalContext,
+    expected_id: u32,
+    expected_name: String,
+) {
+    let topic_id = world.last_topic_id.expect("Topic should exist");
+    let topic_name = world.last_topic_name.as_ref().expect("Topic should exist");
+    assert_eq!(topic_id, expected_id, "Topic should have expected ID");
+    assert_eq!(
+        topic_name, &expected_name,
+        "Topic should have expected name"
+    );
+}
+
+#[then(regex = r"^the topic should have (\d+) partitions$")]
+pub async fn then_topic_has_partitions(world: &mut GlobalContext, expected_partitions: u32) {
+    let topic_partitions = world.last_topic_partitions.expect("Topic should exist");
+    assert_eq!(
+        topic_partitions, expected_partitions,
+        "Topic should have expected number of partitions"
+    );
+}
diff --git a/core/connectors/sinks/quickwit_sink/Cargo.toml b/core/connectors/sinks/quickwit_sink/Cargo.toml
index 5d17d058..3537cbbd 100644
--- a/core/connectors/sinks/quickwit_sink/Cargo.toml
+++ b/core/connectors/sinks/quickwit_sink/Cargo.toml
@@ -28,8 +28,8 @@ documentation = "https://iggy.apache.org/docs"
 repository = "https://github.com/apache/iggy"
 readme = "../../README.md"
 
-[lib]
-crate-type = ["cdylib", "lib"]
+[package.metadata.cargo-machete]
+ignored = ["dashmap", "once_cell"]
 
 [dependencies]
 async-trait = { workspace = true }
@@ -42,5 +42,5 @@ serde_yml = { workspace = true }
 simd-json = { workspace = true }
 tracing = { workspace = true }
 
-[package.metadata.cargo-machete]
-ignored = ["dashmap", "once_cell"]
+[lib]
+crate-type = ["cdylib", "lib"]
diff --git a/core/connectors/sinks/stdout_sink/Cargo.toml b/core/connectors/sinks/stdout_sink/Cargo.toml
index cf6a8f4d..5ad4fa40 100644
--- a/core/connectors/sinks/stdout_sink/Cargo.toml
+++ b/core/connectors/sinks/stdout_sink/Cargo.toml
@@ -28,8 +28,8 @@ documentation = "https://iggy.apache.org/docs"
 repository = "https://github.com/apache/iggy"
 readme = "../../README.md"
 
-[lib]
-crate-type = ["cdylib", "lib"]
+[package.metadata.cargo-machete]
+ignored = ["dashmap", "once_cell"]
 
 [dependencies]
 async-trait = { workspace = true }
@@ -40,5 +40,5 @@ serde = { workspace = true }
 tokio = { workspace = true }
 tracing = { workspace = true }
 
-[package.metadata.cargo-machete]
-ignored = ["dashmap", "once_cell"]
+[lib]
+crate-type = ["cdylib", "lib"]
diff --git a/core/connectors/sources/random_source/Cargo.toml b/core/connectors/sources/random_source/Cargo.toml
index efd6c389..53d17933 100644
--- a/core/connectors/sources/random_source/Cargo.toml
+++ b/core/connectors/sources/random_source/Cargo.toml
@@ -28,8 +28,8 @@ documentation = "https://iggy.apache.org/docs"
 repository = "https://github.com/apache/iggy"
 readme = "../../README.md"
 
-[lib]
-crate-type = ["cdylib", "lib"]
+[package.metadata.cargo-machete]
+ignored = ["dashmap", "once_cell"]
 
 [dependencies]
 async-trait = { workspace = true }
@@ -44,5 +44,5 @@ tokio = { workspace = true }
 tracing = { workspace = true }
 uuid = { workspace = true }
 
-[package.metadata.cargo-machete]
-ignored = ["dashmap", "once_cell"]
+[lib]
+crate-type = ["cdylib", "lib"]
diff --git a/core/server/Cargo.toml b/core/server/Cargo.toml
index 0b4ee673..ceb95a33 100644
--- a/core/server/Cargo.toml
+++ b/core/server/Cargo.toml
@@ -25,6 +25,9 @@ license = "Apache-2.0"
 [package.metadata.cargo-udeps.ignore]
 normal = ["tracing-appender"]
 
+[package.metadata.cargo-machete]
+ignored = ["rust-s3"]
+
 [features]
 default = ["mimalloc"]
 tokio-console = ["dep:console-subscriber", "tokio/tracing"]
@@ -128,6 +131,3 @@ serial_test = { workspace = true }
 [[bin]]
 name = "iggy-server"
 path = "src/main.rs"
-
-[package.metadata.cargo-machete]
-ignored = ["rust-s3"]