@ohos-ports/514labs-kafka-javascript 0.0.0-stage → 1.7.1-patch-beta.0

package/deps/librdkafka/Makefile

@@ -0,0 +1,125 @@
+LIBSUBDIRS=	src src-cpp
+
+CHECK_FILES+=	CONFIGURATION.md \
+		examples/rdkafka_example examples/rdkafka_performance \
+		examples/rdkafka_example_cpp
+
+DOC_FILES+=	LICENSE LICENSES.txt INTRODUCTION.md README.md \
+		CONFIGURATION.md STATISTICS.md CHANGELOG.md
+
+PKGNAME?=	librdkafka
+VERSION?=	$(shell python3 packaging/get_version.py src/rdkafka.h)
+SHELL	=	/bin/sh
+
+# Jenkins CI integration
+BUILD_NUMBER ?= 1
+
+# Skip copyright check in the following paths
+MKL_COPYRIGHT_SKIP?=^(tests|packaging|src/nanopb|src/opentelemetry)
+
+
+.PHONY:
+
+all: mklove-check libs CONFIGURATION.md check TAGS
+
+include mklove/Makefile.base
+
+libs:
+	@(for d in $(LIBSUBDIRS); do $(MAKE) -C $$d || exit $?; done)
+
+CONFIGURATION.md: src/rdkafka.h examples
+	@printf "$(MKL_YELLOW)Updating $@$(MKL_CLR_RESET)\n"
+	@echo "# Configuration properties" > CONFIGURATION.md.tmp
+	@(examples/rdkafka_performance -X list | \
+		sed 's/||/\\|\\|/g' >> \
+		CONFIGURATION.md.tmp; \
+		cmp CONFIGURATION.md CONFIGURATION.md.tmp || \
+		mv -f CONFIGURATION.md.tmp CONFIGURATION.md; \
+		rm -f CONFIGURATION.md.tmp)
+
+file-check: CONFIGURATION.md LICENSES.txt examples
+check: file-check
+	@(for d in $(LIBSUBDIRS); do $(MAKE) -C $$d $@ || exit $?; done)
+
+install-subdirs: libs
+	@(for d in $(LIBSUBDIRS); do $(MAKE) -C $$d install || exit $?; done)
+
+install: install-subdirs doc-install
+
+uninstall-subdirs:
+	@(for d in $(LIBSUBDIRS); do $(MAKE) -C $$d uninstall || exit $?; done)
+
+uninstall: uninstall-subdirs doc-uninstall
+
+examples tests: .PHONY libs
+	$(MAKE) -C $@
+
+docs:
+	doxygen Doxyfile
+	@echo "Documentation generated in staging-docs"
+
+clean-docs:
+	rm -rf staging-docs
+
+clean:
+	@$(MAKE) -C tests $@
+	@$(MAKE) -C examples $@
+	@(for d in $(LIBSUBDIRS); do $(MAKE) -C $$d $@ ; done)
+
+distclean: clean deps-clean
+	./configure --clean
+	rm -f config.log config.log.old
+
+archive:
+	git archive --prefix=$(PKGNAME)-$(VERSION)/ \
+		-o $(PKGNAME)-$(VERSION).tar.gz HEAD
+	git archive --prefix=$(PKGNAME)-$(VERSION)/ \
+		-o $(PKGNAME)-$(VERSION).zip HEAD
+
+rpm: distclean
+	$(MAKE) -C packaging/rpm
+
+LICENSES.txt: .PHONY
+	@(for i in LICENSE LICENSE.*[!~] ; do (echo "$$i" ; echo "--------------------------------------------------------------" ; cat $$i ; echo "" ; echo "") ; done) > $@.tmp
+	@cmp $@ $@.tmp || mv -f $@.tmp $@ ; rm -f $@.tmp
+
+
+TAGS: .PHONY
+	@(if which etags >/dev/null 2>&1 ; then \
+		echo "Using etags to generate $@" ; \
+		git ls-tree -r --name-only HEAD | egrep '\.(c|cpp|h)$$' | \
+			etags -f $@.tmp - ; \
+		cmp $@ $@.tmp || mv $@.tmp $@ ; rm -f $@.tmp ; \
+	 elif which ctags >/dev/null 2>&1 ; then \
+		echo "Using ctags to generate $@" ; \
+		git ls-tree -r --name-only HEAD | egrep '\.(c|cpp|h)$$' | \
+			ctags -e -f $@.tmp -L- ; \
+		cmp $@ $@.tmp || mv $@.tmp $@ ; rm -f $@.tmp ; \
+	fi)
+
+coverity: Makefile.config
+	@(which cov-build >/dev/null 2>&1 || echo "Make sure coverity../bin is in your PATH")
+	@(cd src && \
+	 make clean && \
+	 (rm -rf cov-int cov-librdkafka.tgz cov-build || true) && \
+	 cov-build --dir cov-int make -j && \
+	 tar cvzf ../cov-librdkafka.tgz cov-int && \
+	 printf "$(MKL_GREEN)Now upload cov-librdkafka.tgz to Coverity for analysis$(MKL_CLR_RESET)\n")
+
+
+style-check:
+	@(packaging/tools/style-format.sh \
+		$$(git ls-tree -r --name-only HEAD | egrep '\.(c|cpp|h|py)$$') )
+
+style-check-changed:
+	@(packaging/tools/style-format.sh \
+		$$( (git diff --name-only ; git diff --name-only --staged) | egrep '\.(c|cpp|h|py)$$'))
+
+style-fix:
+	@(packaging/tools/style-format.sh --fix \
+		$$(git ls-tree -r --name-only HEAD | egrep '\.(c|cpp|h|py)$$'))
+
+style-fix-changed:
+	@(packaging/tools/style-format.sh --fix \
+		$$( (git diff --name-only ; git diff --name-only --staged) | egrep '\.(c|cpp|h|py)$$'))
+

package/deps/librdkafka/README.md

@@ -0,0 +1,199 @@
+librdkafka - the Apache Kafka C/C++ client library
+==================================================
+
+Copyright (c) 2012-2022, [Magnus Edenhill](http://www.edenhill.se/).
+              2023 [Confluent Inc.](https://www.confluent.io/).
+
+[https://github.com/confluentinc/librdkafka](https://github.com/confluentinc/librdkafka)
+
+**librdkafka** is a C library implementation of the
+[Apache Kafka](https://kafka.apache.org/) protocol, providing Producer, Consumer
+and Admin clients. It was designed with message delivery reliability
+and high performance in mind, current figures exceed 1 million msgs/second for
+the producer and 3 million msgs/second for the consumer.
+
+**librdkafka** is licensed under the 2-clause BSD license.
+
+KAFKA is a registered trademark of The Apache Software Foundation and
+has been licensed for use by librdkafka. librdkafka has no
+affiliation with and is not endorsed by The Apache Software Foundation.
+
+
+# Features #
+  * Full Exactly-Once-Semantics (EOS) support
+  * High-level producer, including Idempotent and Transactional producers
+  * High-level balanced KafkaConsumer (requires broker >= 0.9)
+  * Simple (legacy) consumer
+  * Admin client
+  * Compression: snappy, gzip, lz4, zstd
+  * [SSL](https://github.com/confluentinc/librdkafka/wiki/Using-SSL-with-librdkafka) support
+  * [SASL](https://github.com/confluentinc/librdkafka/wiki/Using-SASL-with-librdkafka) (GSSAPI/Kerberos/SSPI, PLAIN, SCRAM, OAUTHBEARER) support
+  * Full list of [supported KIPs](INTRODUCTION.md#supported-kips)
+  * Broker version support: >=0.8 (see [Broker version compatibility](INTRODUCTION.md#broker-version-compatibility))
+  * Guaranteed API stability for C & C++ APIs (ABI safety guaranteed for C)
+  * [Statistics](STATISTICS.md) metrics
+  * Debian package: librdkafka1 and librdkafka-dev in Debian and Ubuntu
+  * RPM package: librdkafka and librdkafka-devel
+  * Gentoo package: dev-libs/librdkafka
+  * Portable: runs on Linux, MacOS X, Windows, Solaris, FreeBSD, AIX, ...
+
+# Documentation
+
+ * Public API in [C header](src/rdkafka.h) and [C++ header](src-cpp/rdkafkacpp.h).
+ * Introduction and manual in [INTRODUCTION.md](https://github.com/confluentinc/librdkafka/blob/master/INTRODUCTION.md).
+ * Configuration properties in
+[CONFIGURATION.md](https://github.com/confluentinc/librdkafka/blob/master/CONFIGURATION.md).
+ * Statistics metrics in [STATISTICS.md](https://github.com/confluentinc/librdkafka/blob/master/STATISTICS.md).
+ * [Frequently asked questions](https://github.com/confluentinc/librdkafka/wiki).
+ * Step-by-step tutorial [Getting Started with Apache Kafka and C/C++](https://developer.confluent.io/get-started/c/).
+
+**NOTE**: The `master` branch is actively developed, use latest [release](https://github.com/confluentinc/librdkafka/releases) for production use.
+
+
+# Installation
+
+## Installing prebuilt packages
+
+On Mac OSX, install librdkafka with homebrew:
+
+```bash
+$ brew install librdkafka
+```
+
+On Debian and Ubuntu, install librdkafka from the Confluent APT repositories,
+see instructions [here](https://docs.confluent.io/current/installation/installing_cp/deb-ubuntu.html#get-the-software) and then install librdkafka:
+
+ ```bash
+ $ apt install librdkafka-dev
+ ```
+
+On RedHat, CentOS, Fedora, install librdkafka from the Confluent YUM repositories,
+instructions [here](https://docs.confluent.io/current/installation/installing_cp/rhel-centos.html#get-the-software) and then install librdkafka:
+
+```bash
+$ yum install librdkafka-devel
+```
+
+On Windows, reference [librdkafka.redist](https://www.nuget.org/packages/librdkafka.redist/) NuGet package in your Visual Studio project.
+
+
+For other platforms, follow the source building instructions below.
+
+
+## Installing librdkafka using vcpkg
+
+You can download and install librdkafka using the [vcpkg](https://github.com/Microsoft/vcpkg) dependency manager:
+
+```bash
+# Install vcpkg if not already installed
+$ git clone https://github.com/Microsoft/vcpkg.git
+$ cd vcpkg
+$ ./bootstrap-vcpkg.sh
+$ ./vcpkg integrate install
+
+# Install librdkafka
+$ vcpkg install librdkafka
+```
+
+The librdkafka package in vcpkg is kept up to date by Microsoft team members and community contributors.
+If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.
+
+
+## Build from source
+
+### Requirements
+	The GNU toolchain
+	GNU make
+   	pthreads
+	zlib-dev (optional, for gzip compression support)
+	libssl-dev (optional, for SSL and SASL SCRAM support)
+	libsasl2-dev (optional, for SASL GSSAPI support)
+	libzstd-dev (optional, for ZStd compression support)
+	libcurl-dev (optional, for SASL OAUTHBEARER OIDC support)
+
+**NOTE**: Static linking of ZStd (requires zstd >= 1.2.1) in the producer
+          enables encoding the original size in the compression frame header,
+          which will speed up the consumer.
+          Use `STATIC_LIB_libzstd=/path/to/libzstd.a ./configure --enable-static`
+          to enable static ZStd linking.
+          MacOSX example:
+          `STATIC_LIB_libzstd=$(brew ls -v zstd | grep libzstd.a$) ./configure --enable-static`
+
+
+### Building
+
+      ./configure
+      # Or, to automatically install dependencies using the system's package manager:
+      # ./configure --install-deps
+      # Or, build dependencies from source:
+      # ./configure --install-deps --source-deps-only
+
+      make
+      sudo make install
+
+
+**NOTE**: See [README.win32](README.win32) for instructions how to build
+          on Windows with Microsoft Visual Studio.
+
+**NOTE**: See [CMake instructions](packaging/cmake/README.md) for experimental
+          CMake build (unsupported).
+
+
+## Usage in code
+
+See [getting Started with Apache Kafka and C/C++](https://developer.confluent.io/get-started/c/) for a basic tutorial.
+
+1. Refer to the [examples directory](examples/) for code using:
+
+    * Producers: basic producers, idempotent producers, transactional producers.
+    * Consumers: basic consumers, reading batches of messages.
+    * Performance and latency testing tools.
+
+2. Refer to the [examples GitHub repo](https://github.com/confluentinc/examples/tree/master/clients/cloud/c) for code connecting to a cloud streaming data service based on Apache Kafka
+
+3. Link your program with `-lrdkafka` (C) or `-lrdkafka++` (C++).
+
+
+## Commercial support
+
+Commercial support is available from [Confluent Inc](https://www.confluent.io/)
+
+
+## Community support
+
+**Only the [latest official release](https://github.com/confluentinc/librdkafka/releases) is supported for community members.**
+
+File bug reports and feature requests using [GitHub Issues](https://github.com/confluentinc/librdkafka/issues).
+
+Questions and discussions are welcome on the [Discussions](https://github.com/confluentinc/librdkafka/discussions) forum, and on the [Confluent Community slack](https://launchpass.com/confluentcommunity) #clients channel.
+
+
+# Language bindings #
+
+  * C#/.NET: [confluent-kafka-dotnet](https://github.com/confluentinc/confluent-kafka-dotnet) (based on [rdkafka-dotnet](https://github.com/ah-/rdkafka-dotnet))
+  * C++: [cppkafka](https://github.com/mfontanini/cppkafka)
+  * C++: [modern-cpp-kafka](https://github.com/Morgan-Stanley/modern-cpp-kafka)
+  * Common Lisp: [cl-rdkafka](https://github.com/SahilKang/cl-rdkafka)
+  * D (C-like): [librdkafka](https://github.com/DlangApache/librdkafka/)
+  * D (C++-like): [librdkafkad](https://github.com/tamediadigital/librdkafka-d)
+  * Erlang: [erlkaf](https://github.com/silviucpp/erlkaf)
+  * Go: [confluent-kafka-go](https://github.com/confluentinc/confluent-kafka-go)
+  * Haskell (kafka, conduit, avro, schema registry): [hw-kafka](https://github.com/haskell-works/hw-kafka)
+  * Kotlin Native: [Kafka-Kotlin-Native](https://github.com/icemachined/kafka-kotlin-native)
+  * Lua: [luardkafka](https://github.com/mistsv/luardkafka)
+  * Node.js: [node-rdkafka](https://github.com/Blizzard/node-rdkafka)
+  * OCaml: [ocaml-kafka](https://github.com/didier-wenzek/ocaml-kafka)
+  * Perl: [Net::Kafka](https://github.com/bookingcom/perl-Net-Kafka)
+  * PHP: [php-rdkafka](https://github.com/arnaud-lb/php-rdkafka)
+  * PHP: [php-simple-kafka-client](https://github.com/php-kafka/php-simple-kafka-client)
+  * Python: [confluent-kafka-python](https://github.com/confluentinc/confluent-kafka-python)
+  * Python: [PyKafka](https://github.com/Parsely/pykafka)
+  * Ruby: [Hermann](https://github.com/reiseburo/hermann)
+  * Ruby: [rdkafka-ruby](https://github.com/appsignal/rdkafka-ruby)
+  * Rust: [rust-rdkafka](https://github.com/fede1024/rust-rdkafka)
+  * Tcl: [KafkaTcl](https://github.com/flightaware/kafkatcl)
+  * Shell: [kafkacat](https://github.com/edenhill/kafkacat) - Apache Kafka command line tool
+  * Swift: [Perfect-Kafka](https://github.com/PerfectlySoft/Perfect-Kafka)
+
+
+See [Powered by librdkafka](https://github.com/confluentinc/librdkafka/wiki/Powered-by-librdkafka) for an incomplete list of librdkafka users.

package/deps/librdkafka/README.win32

@@ -0,0 +1,26 @@
+
+Native win32 build instructions using Microsoft Visual Studio 2015 (MSVC).
+
+Requirements:
+ * zlib is installed automatically from NuGet,
+   but probably requires the NuGet VS extension.
+ * OpenSSL-win32 must be installed in C:\OpenSSL-win32 and C:\OpenSSL-Win64
+   depending on your architecture.
+   Download and install the latest v1.0.2 non-light package from:
+   https://slproweb.com/products/Win32OpenSSL.html
+   (This would be using NuGet too but the current
+    OpenSSL packages are outdated and with broken
+    dependencies, so no luck)
+
+The Visual Studio solution file for librdkafka resides in win32/librdkafka.sln
+
+Artifacts:
+ - C library
+ - C++ library
+ - rdkafka_example, rdkafka_performance
+ - tests
+
+
+If you build librdkafka with an external tool (ie CMake) you can get rid of the 
+__declspec(dllexport) / __declspec(dllimport) decorations by adding a define
+-DLIBRDKAFKA_STATICLIB to your CFLAGS