All Projects → IBM-Swift → Generator Swiftserver

IBM-Swift / Generator Swiftserver

Licence: apache-2.0
WARNING: This repository is no longer maintained

Programming Languages

javascript
184084 projects - #8 most used programming language
swift
15916 projects

Projects that are alternatives of or similar to Generator Swiftserver

Go Whatsapp Rest
Go WhatsApp Implementation in REST API
Stars: ✭ 86 (+34.38%)
Mutual labels:  api, rest, server
Appy Backend
A user system to bootstrap your app.
Stars: ✭ 96 (+50%)
Mutual labels:  api, rest, server
Node Typescript Mongodb
node js typescript mongodb express generator yo
Stars: ✭ 96 (+50%)
Mutual labels:  rest, generator, yeoman
Generator Http Fake Backend
Yeoman generator for building a fake backend by providing the content of JSON files or JavaScript objects through configurable routes.
Stars: ✭ 49 (-23.44%)
Mutual labels:  api, rest, yeoman
Kanary
A minimalist web framework for building REST APIs in Kotlin/Java.
Stars: ✭ 319 (+398.44%)
Mutual labels:  api, rest, server
Smoke
💨 Simple yet powerful file-based mock server with recording abilities
Stars: ✭ 142 (+121.88%)
Mutual labels:  api, rest, server
Api Client Generator
Angular REST API client generator from Swagger YAML or JSON file with camel case settigs
Stars: ✭ 92 (+43.75%)
Mutual labels:  api, rest, generator
Dito
Dito.js is a declarative and modern web framework with a focus on API driven development, based on Objection.js, Koa.js and Vue.js – Released in 2018 under the MIT license, with support by Lineto.com
Stars: ✭ 44 (-31.25%)
Mutual labels:  api, rest, server
Flaresolverr
Proxy server to bypass Cloudflare protection
Stars: ✭ 241 (+276.56%)
Mutual labels:  api, rest, server
Mockoon
Mockoon is the easiest and quickest way to run mock APIs locally. No remote deployment, no account required, open source.
Stars: ✭ 3,448 (+5287.5%)
Mutual labels:  api, rest, server
Deno Drash
A REST microframework for Deno's HTTP server with zero 3rd party dependencies.
Stars: ✭ 795 (+1142.19%)
Mutual labels:  api, rest, server
Openapi Generator
OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)
Stars: ✭ 10,634 (+16515.63%)
Mutual labels:  api, rest, generator
Sdmx Rest
This repository is used for maintaining the SDMX RESTful web services specification.
Stars: ✭ 50 (-21.87%)
Mutual labels:  api, rest
Flask Restx
Fork of Flask-RESTPlus: Fully featured framework for fast, easy and documented API development with Flask
Stars: ✭ 1,050 (+1540.63%)
Mutual labels:  api, rest
Compojure Api
Sweet web apis with Compojure & Swagger
Stars: ✭ 1,056 (+1550%)
Mutual labels:  api, rest
Sechub
SecHub - one central and easy way to use different security tools with one API/Client
Stars: ✭ 52 (-18.75%)
Mutual labels:  api, server
Rest Control
Framework for testing and validation REST services
Stars: ✭ 51 (-20.31%)
Mutual labels:  api, rest
Mailman
Mailman is a GUI to help you manage your email accounts stored in a MySQL/MariaDB database.
Stars: ✭ 62 (-3.12%)
Mutual labels:  api, rest
Githubapi
Swift implementation of Github REST API v3
Stars: ✭ 55 (-14.06%)
Mutual labels:  api, rest
Api Strategy
Equinor API Strategy
Stars: ✭ 56 (-12.5%)
Mutual labels:  api, rest

WARNING: This repository is no longer maintained ⚠️

The generated content is now available in our Swift static application.

This repository will not be updated. The repository will be kept available in read-only mode.

generator-swiftserver

Build Status codecov Version DownloadsMonthly DownloadsTotal License Greenkeeper badge

This module is a Yeoman generator for creating REST webservices based on the Kitura web framework with the Swift language.

This generator and the Yeoman library runs on Node.js and generates a Swift 5.0 application.

Contents

  1. Prerequisites
  2. Installation
  3. Usage
  4. Generated Artifacts
  5. Development
  6. Testing
  7. Contributing

Prerequisites

To use this module, you will need Node.js and Swift 5.0 installed on your Linux or macOS system. You can get Node.js from https://nodejs.org and Swift 5.0 from https://swift.org/download.

You will also need the Yeoman command line utility yo installed in your global Node.js module directory.

To install yo, run:

npm install -g yo

Installation

To install generator-swiftserver, run:

npm install -g generator-swiftserver

Usage

To create a Swift Server Generator project with no models defined, run:

yo swiftserver

To add a data model to your generated project, cd to the new project directory and run:

yo swiftserver:<model>

For more information on data models, check out this guide on Kitura.io.

Options

You can also change how generator-swiftserver is invoked by choosing options:

yo swiftserver [options]
Option Type Description
--init n/a Generate basic default scaffold without prompting user for input.
--skip-build n/a Skip building the generated application
--single-shot n/a Creates application without including generator metadata files
--bluemix Json Invoke generator-swiftserver using a bluemix json object
--name String Project name
--type String Give a specific type of application to generate. (web, bff, scaffold, crud)
--metrics Boolean Generate embedded metrics dashboard for project
--docker Boolean Generate Dockerfile for project
--healthcheck Boolean Add health checking to project
--openapi Boolean Add Kitura-OpenAPI to project
--spec Json Invoke generator-swiftserver using a spec json object

Run

To run the generated server, use: <project-dir>/.build/debug/<app-name>

Generated Artifacts

File Purpose
Dockerfile Configuration file for the run container
Dockerfile-tools Configuration file for the tools container
LICENSE License for generated project
Package.resolved Results of dependency resolution from Swift Package Manager
Package.swift Swift file containing dependencies and targets for project
README.md Instructions for building, running, and deploying the project
Sources/* Folder containing project source files
Tests/* Folder containing project test files
chart/* Folder containing Kubernetes Helm Chart files for project
cli-config.yml Yaml file containing mappings for various commands, files, and settings, utilized by the cli commands
manifest.yml Yaml file containing various information for deployment to IBM Cloud
spec.json JSON file containing information about the project, used to generate the project
myProjectName.xcodeproj Generated xcodeproj for project

Development

To get started with development, simply clone this repository and link it via npm:

git clone https://github.com/IBM-Swift/generator-swiftserver
cd generator-swiftserver
npm link

Testing

To run the unit tests, run:

npm test

Contributing

To contribute, you will need to fork the repository or branch off the develop branch.

Make sure to follow the conventional commit specification when contributing.

Once you are finished with your changes, run npm test to make sure all tests pass. Then, create a pull request against develop, and a team member will review and merge your pull request.

Once the pull request is merged, an auto generated pull request will be created against master to update the changelog and increase the versioning. After the auto-generated pull request has been merged to master, the version will be bumped and published to npm.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].