Skip to content

Commit fc9c8af

Browse files
committed
feat: add initial stage description for CreateTopics API implementation
Introduce the first stage description for the CreateTopics API, detailing the inclusion of the API in the APIVersions response. This stage outlines the necessary tests and notes for implementation, setting the groundwork for subsequent stages.
1 parent f859242 commit fc9c8af

File tree

7 files changed

+28
-0
lines changed

7 files changed

+28
-0
lines changed
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
In this stage, you'll add an entry for the `CreateTopics` API to the APIVersions response.
2+
3+
### APIVersions
4+
5+
Your Kafka implementation should include the CreateTopics API (key=19) in the ApiVersions response before implementing topic creation functionality. This lets the client know that the broker supports the CreateTopics API.
6+
7+
### Tests
8+
9+
The tester will execute your program like this:
10+
11+
```bash
12+
./your_program.sh
13+
```
14+
15+
It'll then connect to your server on port 9092 and send a valid `APIVersions` (v4) request.
16+
17+
The tester will validate that:
18+
19+
- The first 4 bytes of your response (the "message length") are valid.
20+
- The correlation ID in the response header matches the correlation ID in the request header.
21+
- The error code in the response body is `0` (No Error).
22+
- The response body contains at least one entry for the API key `19` (CreateTopics).
23+
- The `MaxVersion` for the CreateTopics API is at least 7.
24+
25+
### Notes
26+
27+
- You don't have to implement support for the `CreateTopics` request in this stage. We'll get to this in later stages.
28+
- You'll still need to include the entry for `APIVersions` in your response to pass the previous stage.

stage_descriptions/create-topics-02_ve7.md

Whitespace-only changes.

stage_descriptions/create-topics-03_cb8.md

Whitespace-only changes.

stage_descriptions/create-topics-04_us2.md

Whitespace-only changes.

stage_descriptions/create-topics-05_rk2.md

Whitespace-only changes.

stage_descriptions/create-topics-06_fl3.md

Whitespace-only changes.

stage_descriptions/create-topics-07_hh9.md

Whitespace-only changes.

0 commit comments

Comments
 (0)