Swiftpack.co - Apodini/Apodini as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by Apodini.
Apodini/Apodini 0.8.0
Apodini - A declarative, composable server-side Swift framework
⭐️ 70
🕓 1 week ago
macOS
.package(url: "https://github.com/Apodini/Apodini.git", from: "0.8.0")

Apodini

DOI codecov jazzy Build and Test

Apodini is a declarative, composable framework to build web services using Swift. It is part of a research project at the TUM Research Group for Applied Software Engineering.

Getting Started

Installation

Apodini uses the Swift Package Manager:

Add it as a project-dependency:

dependencies: [
    .package(url: "https://github.com/Apodini/Apodini.git", .branch("develop"))
]

Add the base package and all exporters you want to use to your target:

targets: [
    .target(
        name: "Your Target",
        dependencies: [
            .product(name: "Apodini", package: "Apodini"),
            .product(name: "ApodiniREST", package: "Apodini"),
            .product(name: "ApodiniOpenAPI", package: "Apodini")
        ])
]‚

Hello World

Getting started is really easy:

import Apodini
import ApodiniREST

struct Greeter: Handler {
    @Parameter var country: String?

    func handle() -> String {
        "Hello, \(country ?? "World")!"
    }
}

struct HelloWorld: WebService {
    var configuration: Configuration {
        REST()
    }

    var content: some Component {
        Greeter()
    }
}

HelloWorld.main()

// http://localhost -> Hello, World!
// http://localhost?country=Italy -> Hello, Italy!

Apodini knows enough about your service to automatically generate OpenAPI docs. Just add the respective exporter:

import ApodiniOpenAPI
...
struct HelloWorld: WebService {
    var configuration: Configuration {
        REST { 
            OpenAPI()
        }
    }
    ...
}

// JSON definition: http://localhost/openapi
// Swagger UI: http://localhost/openapi-ui

With Bindings we can re-use Handlers in different contexts:

struct Greeter: Handler {
    @Binding var country: String?

    func handle() -> String {
        "Hello, \(country ?? "World")!"
    }
}

struct HelloWorld: WebService {
    var configuration: Configuration {
        REST { 
            OpenAPI()
        }
    }

    var content: some Component {
        Greeter(country: nil)
            .description("Say 'Hello' to the World.")
        Group("country") {
            CountrySubsystem()
        }
    }
}

struct CountrySubsystem: Component {
    @PathParameter var country: String
    
    var content: some Component {
        Group($country) {
            Greeter(country: Binding<String?>($country))
                .description("Say 'Hello' to a country.")
        }
    }
}

// http://localhost -> Hello, World!
// http://localhost/country/Italy -> Hello, Italy!

Apodini allows the developer to specify CLI-arguments that are passed to the WebService. The arguments can for example be used in Configuration:

struct HelloWorld: WebService {
    @Flag(help: "Generate an OpenAPI documentation of the WebService.")
    var generateOpenAPIDocs = false
    
    var configuration: Configuration {
        if(generateOpenAPIDocs) {
            REST { 
                OpenAPI()
            }
        } else {
            REST()
        }
    }
}

For further information on how to specify CLI-arguments see https://github.com/apple/swift-argument-parser

Documentation

The framework is in early alpha phase. You can inspect the current development manifestos describing the framework in the documentation folder

You can find a generated technical documentation for the different Swift types at https://apodini.github.io/Apodini

Contributing

Contributions to this project are welcome. Please make sure to read the contribution guidelines first.

License

This project is licensed under the MIT License. See License for more information.

Code of conduct

For our code of conduct see Code of conduct

GitHub

link
Stars: 70
Last commit: 2 days ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

0.8.0
1 week ago

Semantic Version Major

  • Add Basic GraphQL Support by @lukaskollmer in https://github.com/Apodini/Apodini/pull/402

    Migration Guide
    • Breaking: Renamed the tlsConfigurationBuilder argument of the HTTPConfiguration to tlsConfiguration.
    • Breaking: Fixed typos in the Response and AnyEndpointParameter types, renaming typeErasured... to typeErased...
    • Breaking: Removed the gRPCMethodName modifier, use endpointName(_:) instead
    • Added a new GraphQLInterfaceExporter
    • Protobuffer: Added support for the Foundation.Date, Foundation.URL, and Foundation.UUID types
    • Added a new "endpoint name" API, which allows users to specify endpoint names, either at handler-type-level (via the metadata property), or at DSL-level (via the endpointName(_:) modifier. Endpoint names are made available to interface exporters, which can use them to generate user-facing names for the individual endpoints in the exported API.
    • Added a few convenience functions and types to make Configurations conditional. This allows enabling/disabling configuration entries based on certain conditions such as whether HTTPS is enabled, the build type (debug vs release), or others.

Semantic Version Minor

Full Changelog: https://github.com/Apodini/Apodini/compare/0.7.1...0.8.0

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics