npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

generator-swiftserver

v5.15.1

Published

Generator for Kitura REST webservice servers

Downloads

192

Readme

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.