Skip to content

Commit

Permalink
Update README
Browse files Browse the repository at this point in the history
  • Loading branch information
iabudiab committed Nov 5, 2023
1 parent cdae2d0 commit 2787e28
Show file tree
Hide file tree
Showing 2 changed files with 17 additions and 16 deletions.
29 changes: 15 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
<img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fswiftkube%2Fclient%2Fbadge%3Ftype%3Dplatforms"/>
</a>
<a href="https://v1-28.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/">
<img src="https://img.shields.io/badge/Kubernetes-1.28.0-blue.svg" alt="Kubernetes 1.28.0"/>
<img src="https://img.shields.io/badge/Kubernetes-1.28.3-blue.svg" alt="Kubernetes 1.28.3"/>
</a>
<a href="https://swift.org/package-manager">
<img src="https://img.shields.io/badge/SwiftPM-compatible-brightgreen.svg?style=flat" alt="Swift Package Manager" />
Expand Down Expand Up @@ -42,7 +42,7 @@
Swift client for talking to a [Kubernetes](http://kubernetes.io/) cluster via a fluent DSL based
on [SwiftNIO](https://github.com/apple/swift-nio) and the [AysncHTTPClient](https://github.com/swift-server/async-http-client).

- [x] Covers all Kubernetes API Groups in v1.28.0
- [x] Covers all Kubernetes API Groups in v1.28.3
- [x] Automatic configuration discovery
- [x] DSL style API
- [x] For all API Groups/Versions
Expand All @@ -68,16 +68,17 @@ on [SwiftNIO](https://github.com/apple/swift-nio) and the [AysncHTTPClient](http

## Compatibility Matrix

| | 1.18.9 | 1.19.8 | 1.20.9 | 1.22.7 | 1.24.8 | 1.24.10 | 1.26.4 | 1.28.0 |
|-------------------|--------|--------|--------|--------|--------|---------|--------|--------|
| `0.6.x` || - | - | - | - | - | - | - |
| `0.7.x...0.9.x` | - || - | - | - | - | - | - |
| `0.10.x` | - | - || - | - | - | - | - |
| `0.11.x` | - | - | - || - | - | - | - |
| `0.12.x...0.13.x` | - | - | - | - || - | - | - |
| `0.14.x` | - | - | - | - | - || - | - |
| `0.15.x` | - | - | - | - | - | - || - |
| `0.16.x` | - | - | - | - | - | - | - ||
| | 1.18.9 | 1.19.8 | 1.20.9 | 1.22.7 | 1.24.8 | 1.24.10 | 1.26.4 | 1.28.0 | 1.28.3 |
|-------------------|--------|--------|--------|--------|--------|---------|--------|--------|--------|
| `0.6.x` || - | - | - | - | - | - | - | - |
| `0.7.x...0.9.x` | - || - | - | - | - | - | - | - |
| `0.10.x` | - | - || - | - | - | - | - | - |
| `0.11.x` | - | - | - || - | - | - | - | - |
| `0.12.x...0.13.x` | - | - | - | - || - | - | - | - |
| `0.14.x` | - | - | - | - | - || - | - | - |
| `0.15.x` | - | - | - | - | - | - || - | - |
| `0.16.x` | - | - | - | - | - | - | - || - |
| `0.17.x` | - | - | - | - | - | - | - | - ||

- `` Exact match of API objects in both client and the Kubernetes version.
- `-` API objects mismatches either due to the removal of old API or the addition of new API. However, everything the
Expand Down Expand Up @@ -546,7 +547,7 @@ app.get("metrics") { request -> EventLoopFuture<String> in
To use the `SwiftkubeClient` in a SwiftPM project, add the following line to the dependencies in your `Package.swift` file:

```swift
.package(name: "SwiftkubeClient", url: "https://github.com/swiftkube/client.git", from: "0.16.0")
.package(name: "SwiftkubeClient", url: "https://github.com/swiftkube/client.git", from: "0.17.0")
```

then include it as a dependency in your target:
Expand All @@ -557,7 +558,7 @@ import PackageDescription
let package = Package(
// ...
dependencies: [
.package(name: "SwiftkubeClient", url: "https://github.com/swiftkube/client.git", from: "0.16.0")
.package(name: "SwiftkubeClient", url: "https://github.com/swiftkube/client.git", from: "0.17.0")
],
targets: [
.target(name: "<your-target>", dependencies: [
Expand Down
4 changes: 2 additions & 2 deletions Sources/SwiftkubeClient/Watch/SwiftkubeClientTask.swift
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ import SwiftkubeModel
// MARK: - SwiftkubeClientTask

/// A Client task, which is created by the SwiftkubeClient in the context of ``GenericKubernetesClient/watch(in:options:retryStrategy:)``
/// or ``GenericKubernetesClient/follow(in:name:container:retryStrategy:)`` API requests.
/// or ``GenericKubernetesClient/follow(in:name:container:timestamps:retryStrategy:)`` API requests.
///
/// The task instance must be started explicitly via ``SwiftkubeClientTask/start()``, which returns an
/// ``AsyncThrowingStream``, that starts yielding items immediately as they are received from the Kubernetes API server.
Expand All @@ -35,7 +35,7 @@ import SwiftkubeModel
///
/// The task is executed indefinitely. Upon encountering non-transient errors this tasks reconnects to the
/// Kubernetes API server, basically restarting the previous ``GenericKubernetesClient/watch(in:options:retryStrategy:)``
/// or ``GenericKubernetesClient/follow(in:name:container:retryStrategy:)`` call.
/// or ``GenericKubernetesClient/follow(in:name:container:timestamps:retryStrategy:)`` call.
///
/// The retry semantics are controlled via the passed ``RetryStrategy`` instance by the Kubernetes client.
///
Expand Down

0 comments on commit 2787e28

Please sign in to comment.