Skip to content

Commit 5e8963e

Browse files
Rename to swift-kafka-client (swift-server#108)
Modifications: * change project name to `swift-kafka-client` * replace package name `SwiftKafka` with `Kafka`
1 parent 8d45297 commit 5e8963e

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+177
-177
lines changed

CONTRIBUTING.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,8 @@ that your contributions are licensed under the Apache 2.0 license (see
1010

1111
Please ensure to specify the following:
1212

13-
* swift-kafka-gsoc commit hash
14-
* Contextual information (e.g. what you were trying to achieve with swift-kafka-gsoc)
13+
* swift-kafka-client commit hash
14+
* Contextual information (e.g. what you were trying to achieve with swift-kafka-client)
1515
* Simplest possible steps to reproduce
1616
* More complex the steps are, lower the priority will be.
1717
* A pull request with failing test case is preferred, but it's just fine to paste the test case into the issue description.
@@ -24,10 +24,10 @@ Please ensure to specify the following:
2424
### Example
2525

2626
```
27-
swift-kafka-gsoc commit hash: 22ec043dc9d24bb011b47ece4f9ee97ee5be2757
27+
swift-kafka-client commit hash: 22ec043dc9d24bb011b47ece4f9ee97ee5be2757
2828
2929
Context:
30-
While load testing my program written with swift-kafka-gsoc, I noticed
30+
While load testing my program written with swift-kafka-client, I noticed
3131
that one file descriptor is leaked per request.
3232
3333
Steps to reproduce:
@@ -50,7 +50,7 @@ My system has IPv6 disabled.
5050

5151
## Writing a Patch
5252

53-
A good swift-kafka-gsoc patch is:
53+
A good swift-kafka-client patch is:
5454

5555
1. Concise, and contains as few changes as needed to achieve the end result.
5656
2. Tested, ensuring that any tests provided failed before the patch and pass after it.
@@ -65,4 +65,4 @@ We require that your commit messages match our template. The easiest way to do t
6565

6666
## How to contribute your work
6767

68-
Please open a pull request at https://github.com/swift-server/swift-kafka-gsoc. Make sure the CI passes, and then wait for code review.
68+
Please open a pull request at https://github.com/swift-server/swift-kafka-client. Make sure the CI passes, and then wait for code review.

CONTRIBUTORS.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
For the purpose of tracking copyright, this is the list of individuals and
2-
organizations who have contributed source code to swift-kafka-gsoc.
2+
organizations who have contributed source code to swift-kafka-client.
33

44
For employees of an organization/company where the copyright of work done
55
by employees of that company is held by the company itself, only the company

NOTICE.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
Please visit the Swift Kafka Client web site for more information:
66

7-
* https://github.com/swift-server/swift-kafka-gsoc
7+
* https://github.com/swift-server/swift-kafka-client
88

99
Copyright 2023 The Swift Kafka Client Project
1010

Package.swift

+11-11
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
// swift-tools-version: 5.7
22
//===----------------------------------------------------------------------===//
33
//
4-
// This source file is part of the swift-kafka-gsoc open source project
4+
// This source file is part of the swift-kafka-client open source project
55
//
6-
// Copyright (c) 2022 Apple Inc. and the swift-kafka-gsoc project authors
6+
// Copyright (c) 2022 Apple Inc. and the swift-kafka-client project authors
77
// Licensed under Apache License v2.0
88
//
99
// See LICENSE.txt for license information
10-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
10+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1111
//
1212
// SPDX-License-Identifier: Apache-2.0
1313
//
@@ -27,7 +27,7 @@ let rdkafkaExclude = [
2727
]
2828

2929
let package = Package(
30-
name: "swift-kafka-gsoc",
30+
name: "swift-kafka-client",
3131
platforms: [
3232
.macOS(.v13),
3333
.iOS(.v16),
@@ -36,8 +36,8 @@ let package = Package(
3636
],
3737
products: [
3838
.library(
39-
name: "SwiftKafka",
40-
targets: ["SwiftKafka"]
39+
name: "Kafka",
40+
targets: ["Kafka"]
4141
),
4242
.library(
4343
name: "KafkaFoundationCompat",
@@ -74,7 +74,7 @@ let package = Package(
7474
]
7575
),
7676
.target(
77-
name: "SwiftKafka",
77+
name: "Kafka",
7878
dependencies: [
7979
"Crdkafka",
8080
.product(name: "NIOCore", package: "swift-nio"),
@@ -85,7 +85,7 @@ let package = Package(
8585
.target(
8686
name: "KafkaFoundationCompat",
8787
dependencies: [
88-
"SwiftKafka",
88+
"Kafka",
8989
]
9090
),
9191
.systemLibrary(
@@ -97,12 +97,12 @@ let package = Package(
9797
]
9898
),
9999
.testTarget(
100-
name: "SwiftKafkaTests",
101-
dependencies: ["SwiftKafka"]
100+
name: "KafkaTests",
101+
dependencies: ["Kafka"]
102102
),
103103
.testTarget(
104104
name: "IntegrationTests",
105-
dependencies: ["SwiftKafka"]
105+
dependencies: ["Kafka"]
106106
),
107107
]
108108
)

README.md

+10-10
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,29 @@
1-
# 🚧WIP🚧: SwiftKafka
1+
# 🚧WIP🚧: Swift Kafka Client
22

3-
SwiftKafka is a Swift Package in development that provides a convenient way to communicate with [Apache Kafka](https://kafka.apache.org) servers. The main goal was to create an API that leverages [Swift's new concurrency features](https://docs.swift.org/swift-book/LanguageGuide/Concurrency.html). Under the hood, this package uses the [`librdkafka`](https://github.com/confluentinc/librdkafka) C library.
3+
Swift Kafka Client is a Swift Package in development that provides a convenient way to communicate with [Apache Kafka](https://kafka.apache.org) servers. The main goal was to create an API that leverages [Swift's new concurrency features](https://docs.swift.org/swift-book/LanguageGuide/Concurrency.html). Under the hood, this package uses the [`librdkafka`](https://github.com/confluentinc/librdkafka) C library.
44

5-
## Adding SwiftKafka as a Dependency
5+
## Adding Kafka as a Dependency
66

7-
To use the `SwiftKafka` library in a SwiftPM project,
7+
To use the `Kafka` library in a SwiftPM project,
88
add the following line to the dependencies in your `Package.swift` file:
99

1010
```swift
11-
.package(url: "https://github.com/swift-server/swift-kafka-gsoc", branch: "main")
11+
.package(url: "https://github.com/swift-server/swift-kafka-client", branch: "main")
1212
```
1313

14-
Include `"SwiftKafka"` as a dependency for your executable target:
14+
Include `"Kafka"` as a dependency for your executable target:
1515

1616
```swift
1717
.target(name: "<target>", dependencies: [
18-
.product(name: "SwiftKafka", package: "swift-kafka-gsoc"),
18+
.product(name: "Kafka", package: "swift-kafka-client"),
1919
]),
2020
```
2121

22-
Finally, add `import SwiftKafka` to your source code.
22+
Finally, add `import Kafka` to your source code.
2323

2424
## Usage
2525

26-
`SwiftKafka` should be used within a [`Swift Service Lifecycle`](https://github.com/swift-server/swift-service-lifecycle)
26+
`Kafka` should be used within a [`Swift Service Lifecycle`](https://github.com/swift-server/swift-service-lifecycle)
2727
[`ServiceGroup`](https://swiftpackageindex.com/swift-server/swift-service-lifecycle/main/documentation/servicelifecycle/servicegroup) for proper startup and shutdown handling.
2828
Both the `KafkaProducer` and the `KafkaConsumer` implement the [`Service`](https://swiftpackageindex.com/swift-server/swift-service-lifecycle/main/documentation/servicelifecycle/service) protocol.
2929

@@ -116,7 +116,7 @@ await withThrowingTaskGroup(of: Void.self) { group in
116116

117117
#### Consumer Groups
118118

119-
SwiftKafka also allows users to subscribe to an array of topics as part of a consumer group.
119+
Kafka also allows users to subscribe to an array of topics as part of a consumer group.
120120

121121
```swift
122122
let broker = KafkaConfiguration.Broker(host: "localhost", port: 9092)

Sources/SwiftKafka/Configuration/KafkaConfiguration+Security.swift renamed to Sources/Kafka/Configuration/KafkaConfiguration+Security.swift

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2023 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2023 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//

Sources/SwiftKafka/Configuration/KafkaConfiguration.swift renamed to Sources/Kafka/Configuration/KafkaConfiguration.swift

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2023 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2023 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//

Sources/SwiftKafka/Configuration/KafkaConsumerConfiguration.swift renamed to Sources/Kafka/Configuration/KafkaConsumerConfiguration.swift

+4-4
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2022 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2022 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//
@@ -16,7 +16,7 @@ import Crdkafka
1616
import struct Foundation.UUID
1717

1818
public struct KafkaConsumerConfiguration {
19-
// MARK: - SwiftKafka-specific Config properties
19+
// MARK: - Kafka-specific Config properties
2020

2121
/// The time between two consecutive polls.
2222
/// Effectively controls the rate at which incoming events and messages are consumed.

Sources/SwiftKafka/Configuration/KafkaProducerConfiguration.swift renamed to Sources/Kafka/Configuration/KafkaProducerConfiguration.swift

+4-4
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2022 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2022 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//
1313
//===----------------------------------------------------------------------===//
1414

1515
public struct KafkaProducerConfiguration {
16-
// MARK: - SwiftKafka-specific Config properties
16+
// MARK: - Kafka-specific Config properties
1717

1818
/// The time between two consecutive polls.
1919
/// Effectively controls the rate at which incoming events are consumed.

Sources/SwiftKafka/Configuration/KafkaTopicConfiguration.swift renamed to Sources/Kafka/Configuration/KafkaTopicConfiguration.swift

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2022 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2022 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//

Sources/SwiftKafka/Data/Array+KafkaContiguousBytes.swift renamed to Sources/Kafka/Data/Array+KafkaContiguousBytes.swift

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2023 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2023 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//

Sources/SwiftKafka/Data/ByteBuffer+KafkaContiguousBytes.swift renamed to Sources/Kafka/Data/ByteBuffer+KafkaContiguousBytes.swift

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2023 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2023 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//

Sources/SwiftKafka/Data/KafkaContiguousBytes.swift renamed to Sources/Kafka/Data/KafkaContiguousBytes.swift

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2023 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2023 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//

Sources/SwiftKafka/Data/Never+KafkaContiguousBytes.swift renamed to Sources/Kafka/Data/Never+KafkaContiguousBytes.swift

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2023 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2023 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//

Sources/SwiftKafka/Data/String+KafkaContiguousBytes.swift renamed to Sources/Kafka/Data/String+KafkaContiguousBytes.swift

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2023 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2023 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//

Sources/SwiftKafka/KafkaAcknowledgedMessage.swift renamed to Sources/Kafka/KafkaAcknowledgedMessage.swift

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2022 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2022 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//

Sources/SwiftKafka/KafkaConsumer.swift renamed to Sources/Kafka/KafkaConsumer.swift

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2022 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2022 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//

Sources/SwiftKafka/KafkaConsumerEvent.swift renamed to Sources/Kafka/KafkaConsumerEvent.swift

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
//===----------------------------------------------------------------------===//
22
//
3-
// This source file is part of the swift-kafka-gsoc open source project
3+
// This source file is part of the swift-kafka-client open source project
44
//
5-
// Copyright (c) 2023 Apple Inc. and the swift-kafka-gsoc project authors
5+
// Copyright (c) 2023 Apple Inc. and the swift-kafka-client project authors
66
// Licensed under Apache License v2.0
77
//
88
// See LICENSE.txt for license information
9-
// See CONTRIBUTORS.txt for the list of swift-kafka-gsoc project authors
9+
// See CONTRIBUTORS.txt for the list of swift-kafka-client project authors
1010
//
1111
// SPDX-License-Identifier: Apache-2.0
1212
//

0 commit comments

Comments
 (0)