The master branch of this project currently requires the Swift 3.0-dev toolchain. Download release-1.0 if you are using Xcode 7.3 with Swift 2.2.
Perfect is an application server for Linux or OS X which provides a framework for developing web and other REST services in the Swift programming language. Its primary focus is on facilitating mobile apps which require backend server software, enabling you to use one language for both front and back ends.
Perfect operates using either its own stand-alone HTTP server or through FastCGI but is flexible enough to be attached to the server of your choice or to your own custom server. It provides a system for loading your own Swift based modules at startup and for interfacing those modules with its request/response objects or to the built-in mustache template processing system.
Perfect is built on its own high performance completely asynchronous networking engine with the goal of providing a scalable option for internet services. It supports SSL out of the box and provides a suite of tools which are commonly required by internet servers, such as WebSockets and iOS push notifications, but does not limit your options. Feel free to swap in your own favorite JSON or templating systems, etc.
Please Note v1.0 has been released. For a stable development environment, switch to branch release-1.0 or download v1.0. v1.0 requires the Swift 2.2 toolchain.
(2016-04-18) We have finished the main refactoring tasks required to support Swift Package Manager. The Perfect project has been split up into the following repositories:
- Perfect - This repository contains the core PerfectLib and will continue to be the main landing point for the project.
- PerfectServer - Contains the PerfectServer variants, including the stand-alone HTTP and FastCGI servers. Those wishing to do a manual deployment should clone and build from this repository.
- PerfectStarter - This umbrella repository allows one to pull in all the related Perfect modules in one go, including the servers, examples, database connectors and documentation. This is a great place to start for people wishing to get up to speed with Perfect.
- PerfectDocs - Contains all API reference related material.
- PerfectExamples - All the Perfect example projects and documentation.
- Perfect-FastCGI-Apache2.4 - Apache 2.4 FastCGI module; required for the Perfect FastCGI server variant.
- Perfect-SQLite - SQLite3 database connector.
- Perfect-PostgreSQL - PostgreSQL database connector.
- Perfect-MySQL - MySQL database connector.
- Perfect-MongoDB - MongoDB database connector.
The database connectors are all stand-alone and can be used outside of the Perfect framework and server.
Note that we are still making some tweaks to this layout and are currently ensuring that everything builds properly on Linux and OS X using SPM and Xcode. This new code requires a Swift 3.0 toolchain and is currently being built against the March 24, 2016 snapshot. It will not compile with Swift 2.2.
(2016-04-05) We are refactoring the Perfect project repository with the ultimate goal of supporting the Swift Package Manager. The various modules, such as the PerfectLib, server, database connectors and examples pack are being split off into their own repositories. This change will also include some API streamlining and fewer 3rd party dependencies resulting in easier installation and deployment. Once this task has completed we will release as v1.1 and continue from there. We hope to have these changes solidified by the end of the week and we appreciate all the feedback we've received along the way.
If you've been working on a Perfect project switch to branch release-1.0 to maintain the stable API you've been developing against.
For more information on the Perfect project, please visit perfect.org.