Skip to content

Commit

Permalink
Prep 1.0 (#37)
Browse files Browse the repository at this point in the history
### Motivation

Prep 1.0 - docs.

### Modifications

See above.

### Result

Updated for 1.0.

### Test Plan

Previewed locally.
  • Loading branch information
czechboy0 authored Dec 11, 2023
1 parent bdb9c8f commit abfe558
Show file tree
Hide file tree
Showing 4 changed files with 8 additions and 32 deletions.
2 changes: 1 addition & 1 deletion Package.swift
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ let package = Package(
dependencies: [
.package(url: "https://github.com/apple/swift-nio", from: "2.58.0"),
.package(url: "https://github.com/swift-server/async-http-client.git", from: "1.19.0"),
.package(url: "https://github.com/apple/swift-openapi-runtime", exact: "1.0.0-alpha.1"),
.package(url: "https://github.com/apple/swift-openapi-runtime", from: "1.0.0"),
.package(url: "https://github.com/apple/swift-http-types", from: "1.0.0"),
.package(url: "https://github.com/apple/swift-docc-plugin", from: "1.0.0"),
],
Expand Down
14 changes: 3 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# AsyncHTTPClient Transport for Swift OpenAPI Generator

[![](https://img.shields.io/badge/docc-read_documentation-blue)](https://swiftpackageindex.com/swift-server/swift-openapi-async-http-client/documentation)
[![](https://img.shields.io/github/v/release/swift-server/swift-openapi-async-http-client)](https://github.com/swift-server/swift-openapi-async-http-client/releases)
[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fswift-server%2Fswift-openapi-async-http-client%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/swift-server/swift-openapi-async-http-client)
[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fswift-server%2Fswift-openapi-async-http-client%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/swift-server/swift-openapi-async-http-client)

Expand All @@ -18,28 +19,19 @@ Use the transport with client code generated by [Swift OpenAPI Generator](https:
Add the package dependency in your `Package.swift`:

```swift
.package(
url: "https://github.com/swift-server/swift-openapi-async-http-client",
exact: "1.0.0-alpha.1"
),
.package(url: "https://github.com/swift-server/swift-openapi-async-http-client", from: "1.0.0"),
```

Note that this repository does not have a 1.0 tag yet, so the API is not stable.

Next, in your target, add `OpenAPIAsyncHTTPClient` to your dependencies:

```swift
.target(name: "MyTarget", dependencies: [
.product(name: "OpenAPIAsyncHTTPClient", package: "swift-openapi-async-http-client"),
],
]),
```

Then, to get started, check out `AsyncHTTPClientTransport`.

## Reporting issues

Please report any issues related to this library in the [swift-openapi-generator](https://github.com/apple/swift-openapi-generator/issues) repository.

## Documentation

To learn more, check out the full [documentation](https://swiftpackageindex.com/swift-server/swift-openapi-async-http-client/documentation).
11 changes: 2 additions & 9 deletions Sources/OpenAPIAsyncHTTPClient/AsyncHTTPClientTransport.swift
Original file line number Diff line number Diff line change
Expand Up @@ -35,26 +35,19 @@ import protocol Foundation.LocalizedError
///
/// let transport = AsyncHTTPClientTransport()
///
/// Create the base URL of the server to call using your client. If the server
/// URL was defined in the OpenAPI document, you find a generated method for it
/// on the `Servers` type, for example:
///
/// let serverURL = try Servers.server1()
///
/// Instantiate the `Client` type generated by the Swift OpenAPI Generator for
/// your provided OpenAPI document. For example:
///
/// let client = Client(
/// serverURL: serverURL,
/// serverURL: URL(string: "https://example.com")!,
/// transport: transport
/// )
///
/// Use the client to make HTTP calls defined in your OpenAPI document. For
/// example, if the OpenAPI document contains an HTTP operation with
/// the identifier `checkHealth`, call it from Swift with:
///
/// let response = try await client.checkHealth(.init())
/// // ...
/// let response = try await client.checkHealth()
///
/// ### Provide a custom Client
///
Expand Down
13 changes: 2 additions & 11 deletions Sources/OpenAPIAsyncHTTPClient/Documentation.docc/Documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,28 +18,19 @@ Use the transport with client code generated by [Swift OpenAPI Generator](https:
Add the package dependency in your `Package.swift`:

```swift
.package(
url: "https://github.com/swift-server/swift-openapi-async-http-client",
exact: "1.0.0-alpha.1"
),
.package(url: "https://github.com/swift-server/swift-openapi-async-http-client", from: "1.0.0"),
```

Note that this repository does not have a 1.0 tag yet, so the API is not stable.

Next, in your target, add `OpenAPIAsyncHTTPClient` to your dependencies:

```swift
.target(name: "MyTarget", dependencies: [
.product(name: "OpenAPIAsyncHTTPClient", package: "swift-openapi-async-http-client"),
],
]),
```

Then, to get started, check out ``AsyncHTTPClientTransport``.

### Reporting issues

Please report any issues related to this library in the [swift-openapi-generator](https://github.com/apple/swift-openapi-generator/issues) repository.

## Topics

### Usage
Expand Down

0 comments on commit abfe558

Please sign in to comment.