Skip to content

๐ŸŒ Functional HTTP client generator from an OpenAPI/Swagger specification.

License

Notifications You must be signed in to change notification settings

bow-swift/bow-openapi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Bow OpenAPI

Build Site SPM compatible Gitter

Bow OpenAPI is a command-line tool to generate a Swift network client from an OpenAPI / Swagger specification file. Please, refer to the project website for extensive and detailed documentation about the project.

Features

๐Ÿ’ก Automatic generation of network clients written in Swift from an OpenAPI / Swagger specification file, in YAML or JSON formats.

๐Ÿ“ฆ Provision of a Swift Package that can be consumed from Swift Package Manager.

๐Ÿ”จ Integration with Xcode as a build phase to always keep your code in sync with your specification.

๐Ÿ’ฅ Usage of Environmental Effects from Bow to suspend side-effects, and improve their composition and testability.

โœ… Enhanced test support for integration or end-to-end test with no mocks.

ย 

Installation guide

Bow OpenAPI is compatible with Unix systems.

๐Ÿ’ป OS X users

You can install Bow OpenAPI using Homebrew. Its formula is not still in the main repository; therefore, you need to tap it first, before installing it:

brew tap bow-swift/bow
brew install bow-openapi

๐Ÿง Linux users

curl -s https://api.github.com/repos/bow-swift/bow-openapi/releases/latest \
 | grep -oP '"tag_name": "\K(.*)(?=")' \
 | xargs -I {} wget -O - https://github.com/bow-swift/bow-openapi/archive/{}.tar.gz \
 | tar xz \
 && sudo make linux -C bow-openapi-*

It will install the last stable version.

Bow OpenAPI depends on Java 8+ and swagger-codegen; both will be installed from Makefile. After the installation, you can type bow-openapi -h in a new termintal to check it.

โš™๏ธ Usage

You can invoke the tool with the following parameters:

bow-openapi --name <NAME> --schema <YAML | JSON> --output <FOLDER>
  • name is the name for the generated module in the resulting Swift Package. You will have to import it in your code using import <NAME>.
  • schema is the path to the OpenAPI / Swagger specification file. It accepts both YAML or JSON formats.
  • output is the folder where the result will be saved.

โค๏ธ Contributing to the project

We welcome your contributions! Help us make Bow OpenAPI better:

๐Ÿ› File an issue if you find a bug.

๐Ÿ†• Suggest a new feature for Bow OpenAPI.

โžก๏ธ Open a Pull Request fixing a problem or adding new functionality.

๐Ÿ’ฌ Discuss with us in our Gitter channel to help us shape the future of Bow OpenAPI.

โš–๏ธ License

Copyright (C) 2020-2021 The Bow Authors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.