forked from confluentinc/confluent-kafka-go
-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
68 lines (38 loc) · 1.56 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
Information for confluent-kafka-go developers
=============================================
Whenever librdkafka error codes are updated make sure to run generate before building:
$ (cd go_rdkafka_generr && go install) && go generate
$ go build
Testing
=======
Some of the tests included in this directory, the benchmark tests in particular,
require an existing Kafka cluster and a testconf.json configuration file to
provide tests with bootstrap brokers, topic name, etc.
The format of testconf.json is a JSON object:
```
{
"Brokers": "<bootstrap-brokers>",
"Topic": "<test-topic-name>"
}
```
See testconf-example.json for an example and full set of available options.
To run unit-tests:
$ go test
To run benchmark tests:
$ go test -bench .
Build tags (static linking)
===========================
Different build types are supported through Go build tags (`-tags ..`),
these tags should be specified on the **application** build command.
* `static` - Build with librdkafka linked statically (but librdkafka
dependencies linked dynamically).
* `static_all` - Build with all libraries linked statically.
* neither - Build with librdkafka (and its dependencies) linked dynamically.
Generate HTML documentation
===========================
To generate one-page HTML documentation run the mk/doc-gen.py script from the
top-level directory. This script requires the beautifulsoup4 Python package.
$ source .../your/virtualenv/bin/activate
$ pip install beautifulsoup4
..
$ mk/doc-gen.py > kafka.html