Perfect README

The project's README from github.com/PerfectlySoft/Perfect. As one markdown file: README.md.

Perfect: Server-Side Swift 简体中文

Get Involed with Perfect!

Swift 5.2 Platforms macOS | Linux License Apache

Perfect: Server-Side Swift

Perfect is a complete and powerful toolbox, framework, and application server for Linux, iOS, and macOS (OS X). It provides everything a Swift engineer needs for developing lightweight, maintainable, and scalable apps and other REST services entirely in the Swift programming language for both client-facing and server-side applications.

Perfect includes a suite of tools that will enhance your productivity as you use only one programming language to build your apps: Swift. The global development community’s most dynamic and popular server-side toolbox and framework available today, Perfect is the backbone for many live web applications and apps available on iTunes.

This guide is designed for developers at all levels of experience to get Perfect up and running quickly.

Working with Perfect

Compatibility with Swift

The master branch of this project currently compiles with Xcode 11 or the Swift 5 toolchain on Ubuntu.

Getting Started

Access a tutorial to help you get started using Perfect quickly. It includes straightforward examples of how Perfect can be used.

Documentation

Get started working with Perfect, deploy your apps, and find more detailed help by consulting our reference library.

We welcome contributions to Perfect’s documentation. If you spot a typo, bug, or other errata, or have additions or suggestions to recommend, please create a pull request or issue in Github.

Community

We all need a little help now and then. If you do too, don’t be shy, ask us or the friendly and supportive Perfect community:

Slack | Twitter

Deployment

Your Perfect project can be deployed to any Swift compatible Linux server. We provide a macOS desktop application, Perfect Assistant, to help with AWS and Google Cloud deployments. Additional deployment options are in the works.

Samples, Examples, and Tutorials

Our library continues to grow as members of the Swift-Perfect development community have shared many samples and examples of their projects in Perfect. Examples include:

There are many more examples you can explore. Please share yours!

Core Perfect Modules

Perfect project is divided into several repositories to make it easy for you to find, download, and install the components you need:

Examples

DataSources

Utilities

More about Perfect

Perfect operates using either a standalone HTTP server, HTTPS server, or through FastCGI server. It provides a system for loading your Swift-based modules at startup, for interfacing those modules with its request/response objects, or to the built-in Mustache template processing system.

Perfect is built on a completely asynchronous, high-performance networking engine to provide a scalable option for internet services. It supports Secure Sockets Layer (SSL) encryption, and it features a suite of tools commonly required by internet servers such as WebSockets and iOS push notifications, but you are not limited to those options.

Feel free to use your favourite JSON or templating systems, etc.

Join and Contribute to the Community

The Swift-Perfect developer community is vital to improving Perfect and supporting one another.  

You can help other developers by sharing your expertise and tips, as well as learn from others, by joining the Perfect Slack channel. Contributions of all kinds are welcome: reporting issues, updating documentation, fixing bugs, building examples, sharing projects, and any other tips that may help the Swift-Perfect community.

If you would like to share your example project, tutorial, or video, please share the URL of your work on GitHub and Twitter, and the Perfect team will highlight it to the community.

Code of Conduct

The Perfect team welcomes people of all ethnicities, nationalities, ages, gender, disability, levels of experience, and religious beliefs to use and contribute to the Perfect project. We pledge to foster and enforce a harassment-free environment of openness, respect, and cooperation for everyone in all project and public spaces online or offline.

Please report any behaviour that violates our Code of Conduct to [email protected]. The Perfect team is committed to enforcing this Code of Conduct to ensure everyone who wishes to use, contribute to, and comment on the Perfect project may do so freely and openly and without fear of reprisal.

We will investigate all complaints of unacceptable or abusive behaviour or comments expediently, and we will maintain the confidentiality of the person who reports any perceived infraction or wrongdoing to us. We will not tolerate any form of direct or indirect harassment or discrimination within the Swift-Perfect community, and will take appropriate, fair, and corrective action to any instance of inappropriate behaviour.

The Perfect team maintains the right to remove, edit, or reject any comments, code, edits, or issues that do not align with our Code of Conduct.

Perfect (PerfectlySoft/Perfect)

Searching Database…

13.7K ·GitHub
Что это такое?Perfect — это полноценный набор инструментов, фреймворк и сервер приложений для Swift на стороне сервера: разработчики на Swift используют его, чтобы делать сайты, REST-сервисы и бэкенды для мобильных приложений целиком на Swift.
Так это фреймворк, библиотека или целый сервер?И то, и другое, и третье сразу. В этом репозитории лежит ядро PerfectLib, а отдельные модули добавляют HTTP 1.1-сервер, коннекторы к базам данных, WebSockets, шаблонизатор Mustache и многое другое — вы собираете те части, которые нужны вашему сервису.
Как начать с ним первый проект?Склонируйте стартовый проект Perfect Template и соберите его через Swift Package Manager — на выходе получится самостоятельный исполняемый HTTP-сервер. Рядом опубликованы учебник для новичков и полная справка по API.
Что нужно установить, чтобы что-то собрать?Только сам Swift: ветка master компилируется с Xcode 11 или тулчейном Swift 5 на Ubuntu, поэтому достаточно Mac с Xcode или машины с Ubuntu и Swift 5.
Проект ещё развивается?Нет. Репозиторий теперь помечен как Legacy Perfect, так что относитесь к нему как к зрелому, но замороженному проекту: для обучения или существующих сервисов он подходит, а вот перед началом чего-то нового стоит проверить совместимость.
Обязательно быть разработчиком на Swift, чтобы им пользоваться?Да — Perfect создан для Swift-разработчиков, которые хотят использовать один язык и на клиенте, и на сервере, хотя руководство подойдёт для любого уровня подготовки.
Куда можно развернуть готовый сервис?На любой Linux-сервер с поддержкой Swift. Есть ещё Perfect Assistant — настольное приложение для macOS, которое помогает с развёртыванием на AWS и Google Cloud.
С какими базами данных он умеет работать из коробки?Есть официальные коннекторы для Redis, SQLite, PostgreSQL, MySQL, MongoDB и FileMaker Server, а также модуль FastCGI для Apache 2.4, если вы хоститесь через Apache вместо встроенного сервера.
Зачем писать веб-сервер на Swift?Идея в том, чтобы везде использовать один язык: разработчики под iOS и macOS могут делать свои приложения и серверные REST-сервисы одним и тем же набором инструментов — в README сказано, что это повышает продуктивность.
Сетевая часть асинхронная?Да. Perfect работает на полностью асинхронном высокопроизводительном сетевом движке, рассчитанном на масштабируемые интернет-сервисы, а встроенные JSON и шаблонизатор можно заменить на свои любимые.
На каких примерах можно учиться?Примеры от сообщества включают сервер WebSockets, URL-роутинг и перечислитель загрузок; ещё больше — в репозитории Perfect Examples, плюс есть вводный туториал для первых шагов.
What are similar projects?drogon, aiohttp, chat, vapor, sails, martini, carno.js, gin-vue-admin
Size
5.3 MB
Stars
13.7K
Age
11y
Commits · 90 Days