Бета — версия Vapor 5
Спустя шесть с половиной лет после выхода Vapor 4 и ровно через десять лет после релиза Vapor 1.0. Первый бета‑релиз увидел свет ровно через 10 лет после того, как был помечен тегом Vapor 1.0, и после почти 6,5 лет и 306 релизов Vapor 4 я невероятно рад объявить о первом бета‑релизе Vapor 5! Работа над Vapor 5 началась более двух лет назад, и с момента выхода первой альфа‑версии в июне мы потихоньку работали над альфа‑версиями. Теперь, после изменения 49 000 строк кода и завершения всех архитектурных изменений, мы готовы к тому, чтобы больше людей увидели и попробовали новую версию.
Новые возможности
Vapor 5 — это, по сути, полная переработка всего фреймворка. Ключевые изменения включают:
Больше никаких EventLoop и EventLoopFuture! Vapor 5 полностью построен на async/await с настоящей поддержкой структурированной конкурентности. Нам даже удалось почти полностью убрать NIO из публичных API; осталось удалить пару ByteBuffer из Multipart и разобраться с некоторой работой NIO, связанной со сжатием и TLS.
Совершенно новый HTTP‑сервер. Vapor 5 построен на основе Swift HTTP Server — нового современного HTTP‑сервера с поддержкой двунаправленной потоковой передачи, HTTP/3 и многого другого. Теперь Vapor может сосредоточиться на том, чтобы быть отличным веб‑фреймворком, и передать обработку HTTP новому серверу.
Потоковая передача по умолчанию. Тела запросов и ответов в Vapor 5 теперь ориентированы в первую очередь на потоковую передачу, что делает работу с большими файлами и обратным давлением (backpressure) очень простой при отличной эффективности использования памяти. У нас по‑прежнему есть много синтаксического сахара сверху, так что если вы работаете с Data или JSON, вы можете легко с ними обращаться. Более того, потоковые замыкания используют Span, что делает их максимально производительными.
Поддержка Service Lifecycle. Application в Vapor 5 — это просто Service, что делает интеграцию с более крупными приложениями очень простой. Мы также позволяем передавать другие сервисы в ваше Application и позволяем Vapor управлять жизненным циклом этих сервисов.
Поддержка Swift Configuration. Теперь мы используем Swift Configuration для управления конфигурацией Vapor, что упрощает интеграцию с остальной экосистемой Swift.
Swift HTTP Types. Наши типы запросов и ответов теперь предоставляют доступ к HTTPTypes, таким как Status, для лучшей интеграции с экосистемой и чтобы сделать HTTP‑сервер (и NIO) деталью реализации.
Совершенно новая, переписанная библиотека Vapor Testing, которая унифицирует API, предоставляя единый способ тестирования вашего приложения.
Поддержка потоковой передачи в Client и VaporTesting.
Все флаги SwiftPM! Мы включили почти все возможные флаги, включая InternalImportsByDefault, NonisolatedNonsendingByDefault и .strictMemorySafety(). Это не только гарантирует максимальную безопасность, но и готовит нас к будущему, чтобы справляться с версиями Swift.
Новые трейты (traits), которые позволяют легко отключать определённые функции, чтобы уменьшить объём Vapor, который нужно компилировать, использовать и распространять.
Новая экспериментальная библиотека макросов. Мы создали новую экспериментальную библиотеку макросов, чтобы помочь вам определять маршруты и контроллеры. Это привносит типобезопасную маршрутизацию и параметры, проверяемую компилятором аутентификацию и более простые определения маршрутов! Этому будет посвящён отдельный пост, и работа над ней всё ещё идёт быстрыми темпами.
Известные проблемы
В Vapor 5 Beta 1 есть несколько известных проблем, в частности поддержка сжатия, которая появится в ближайшее время, и поддержка WebSockets, которая ожидает реализации в HTTP‑сервере. Следите за страницей релизов, чтобы узнать, когда они появятся!
Требуется Swift 6.4
Vapor 5 требует Swift 6.4 или более поздней версии (и macOS 26 или более поздней), которая, к счастью, была выпущена только вчера! Это связано с тем, что мы в полной мере используем новые возможности Swift, поддержку fullSpan, а также гарантируем, что многие распространённые ошибки, включая, например, попытку захвата тела запроса, становятся ошибками компиляции.
Vapor 4
Vapor 4 по‑прежнему является текущей версией Vapor, но большая часть усилий и разработки новых функций теперь будет происходить в Vapor 5. Однако мы объявим график поддержки ближе к релизу Vapor 5, но будьте уверены, что Vapor 4 будет продолжать получать исправления ошибок и обновления безопасности ещё долго после выхода Vapor 5, а в ближайшее время появится официальная платная расширенная поддержка для тех, кому она нужна.
Попробуйте
Шаблон уже обновлён в ветке vapor5 с поддержкой Fluent при желании. Интеграция с Leaf появится в ближайшее время. Вы можете создать новый проект с помощью:
vapor new MyVapor5App --branch vapor5
sourcecraft.dev
Примечание: в настоящее время шаблон напрямую зависит от FluentKit, а часть интеграционной работы выполняется в шаблоне. Вероятно, в будущем это перейдёт в vapor/fluent, как только мы его обновим.
Вы также можете указать в вашем манифесте новый релиз, если у вас есть существующий проект, указав на бета‑версию:
.package(url: "vapor/vapor", from: "5.0.0-beta.1"),
sourcecraft.dev
Мы выпустим руководство по миграции и полную документацию в ближайшие недели. Нам также предстоит много работы со всеми интеграционными пакетами, чтобы упростить внедрение Fluent, JWT, Queues и так далее. Повторюсь, они появятся в ближайшем будущем.
Хотя бета‑версии должны быть достаточно стабильными, мы пока не рекомендуем использовать их в production для критически важных сервисов. Тем не менее, нам не терпится узнать, как вы найдёте Vapor 5. Как всегда, если вы обнаружите проблемы, вы можете сообщить о них на GitHub или связаться с нами в Discord.
У нас нет полного графика релиза Vapor 5, так как часть его зависит от зависимостей экосистемы, и мы хотим убедиться, что всё сделаем правильно. Vapor 4 был поддерживаемой версией уже 6,5 лет и продолжает оставаться таковой — мы хотим аналогичного срока жизни для Vapor 5.
Как всегда, мы не смогли бы этого сделать без поддержки сообщества. У нас уже есть множество вкладов от сообщества, и вы можете увидеть список задач на доске проекта, если хотите принять участие. И это было бы невозможно без поддержки наших спонсоров, как из Open Collective, так и из GitHub Sponsors.
Удачной разработки!
Mentions
Does anyone have the contact information for the maintainers of github.com/swift-server/async-http-client/issues or github.com/apple/containerization/issues ? I'd like to point out a few memory leaks. I've already fixed it in my forks and containerstack.bshk.app is no longer leaking. /сс @ivanfioravanti @Prince_Canuma
Бета — версия Vapor 5 Спустя шесть с половиной лет после выхода Vapor 4 и ровно через десять лет после релиза Vapor 1.0. Первый бета‑релиз увидел свет ровно через 10 лет после того, как был помечен тегом Vapor 1.0, и после почти 6,5 лет и 306 релизов Vapor 4 я невероятно рад объявить о первом бета‑релизе Vapor 5! Работа над Vapor 5 началась более двух лет назад, и с момента выхода первой альфа‑версии в июне мы потихоньку работали над альфа‑версиями. Теперь, после изменения 49 000 строк кода и завершения всех архитектурных изменений, мы готовы к тому, чтобы больше людей увидели и попробовали новую версию. Новые возможности Vapor 5 — это, по сути, полная переработка всего фреймворка. Ключевые изменения включают: Больше никаких EventLoop и EventLoopFuture! Vapor 5 полностью построен на async/await с настоящей поддержкой структурированной конкурентности. Нам даже удалось почти полностью убрать NIO из публичных API; осталось удалить пару ByteBuffer из Multipart и разобраться с некоторой работой NIO, связанной со сжатием и TLS. Совершенно новый HTTP‑сервер. Vapor 5 построен на основе Swift HTTP Server — нового современного HTTP‑сервера с поддержкой двунаправленной потоковой передачи, HTTP/3 и многого другого. Теперь Vapor может сосредоточиться на том, чтобы быть отличным веб‑фреймворком, и передать обработку HTTP новому серверу. Потоковая передача по умолчанию. Тела запросов и ответов в Vapor 5 теперь ориентированы в первую очередь на потоковую передачу, что делает работу с большими файлами и обратным давлением (backpressure) очень простой при отличной эффективности использования памяти. У нас по‑прежнему есть много синтаксического сахара сверху, так что если вы работаете с Data или JSON, вы можете легко с ними обращаться. Более того, потоковые замыкания используют Span, что делает их максимально производительными. Поддержка Service Lifecycle. Application в Vapor 5 — это просто Service, что делает интеграцию с более крупными приложениями очень простой. Мы также позволяем передавать другие сервисы в ваше Application и позволяем Vapor управлять жизненным циклом этих сервисов. Поддержка Swift Configuration. Теперь мы используем Swift Configuration для управления конфигурацией Vapor, что упрощает интеграцию с остальной экосистемой Swift. Swift HTTP Types. Наши типы запросов и ответов теперь предоставляют доступ к HTTPTypes, таким как Status, для лучшей интеграции с экосистемой и чтобы сделать HTTP‑сервер (и NIO) деталью реализации. Совершенно новая, переписанная библиотека Vapor Testing, которая унифицирует API, предоставляя единый способ тестирования вашего приложения. Поддержка потоковой передачи в Client и VaporTesting. Все флаги SwiftPM! Мы включили почти все возможные флаги, включая InternalImportsByDefault, NonisolatedNonsendingByDefault и .strictMemorySafety(). Это не только гарантирует максимальную безопасность, но и готовит нас к будущему, чтобы справляться с версиями Swift. Новые трейты (traits), которые позволяют легко отключать определённые функции, чтобы уменьшить объём Vapor, который нужно компилировать, использовать и распространять. Новая экспериментальная библиотека макросов. Мы создали новую экспериментальную библиотеку макросов, чтобы помочь вам определять маршруты и контроллеры. Это привносит типобезопасную маршрутизацию и параметры, проверяемую компилятором аутентификацию и более простые определения маршрутов! Этому будет посвящён отдельный пост, и работа над ней всё ещё идёт быстрыми темпами. Известные проблемы В Vapor 5 Beta 1 есть несколько известных проблем, в частности поддержка сжатия, которая появится в ближайшее время, и поддержка WebSockets, которая ожидает реализации в HTTP‑сервере. Следите за страницей релизов, чтобы узнать, когда они появятся! Требуется Swift 6.4 Vapor 5 требует Swift 6.4 или более поздней версии (и macOS 26 или более поздней), которая, к счастью, была выпущена только вчера! Это связано с тем, что мы в полной мере используем новые возможности Swift, поддержку fullSpan, а также гарантируем, что многие распространённые ошибки, включая, например, попытку захвата тела запроса, становятся ошибками компиляции. Vapor 4 Vapor 4 по‑прежнему является текущей версией Vapor, но большая часть усилий и разработки новых функций теперь будет происходить в Vapor 5. Однако мы объявим график поддержки ближе к релизу Vapor 5, но будьте уверены, что Vapor 4 будет продолжать получать исправления ошибок и обновления безопасности ещё долго после выхода Vapor 5, а в ближайшее время появится официальная платная расширенная поддержка для тех, кому она нужна. Попробуйте Шаблон уже обновлён в ветке vapor5 с поддержкой Fluent при желании. Интеграция с Leaf появится в ближайшее время. Вы можете создать новый проект с помощью: vapor new MyVapor5App --branch vapor5 sourcecraft.dev Примечание: в настоящее время шаблон напрямую зависит от FluentKit, а часть интеграционной работы выполняется в шаблоне. Вероятно, в будущем это перейдёт в vapor/fluent, как только мы его обновим. Вы также можете указать в вашем манифесте новый релиз, если у вас есть существующий проект, указав на бета‑версию: .package(url: "vapor/vapor", from: "5.0.0-beta.1"), sourcecraft.dev Мы выпустим руководство по миграции и полную документацию в ближайшие недели. Нам также предстоит много работы со всеми интеграционными пакетами, чтобы упростить внедрение Fluent, JWT, Queues и так далее. Повторюсь, они появятся в ближайшем будущем. Хотя бета‑версии должны быть достаточно стабильными, мы пока не рекомендуем использовать их в production для критически важных сервисов. Тем не менее, нам не терпится узнать, как вы найдёте Vapor 5. Как всегда, если вы обнаружите проблемы, вы можете сообщить о них на GitHub или связаться с нами в Discord. У нас нет полного графика релиза Vapor 5, так как часть его зависит от зависимостей экосистемы, и мы хотим убедиться, что всё сделаем правильно. Vapor 4 был поддерживаемой версией уже 6,5 лет и продолжает оставаться таковой — мы хотим аналогичного срока жизни для Vapor 5. Как всегда, мы не смогли бы этого сделать без поддержки сообщества. У нас уже есть множество вкладов от сообщества, и вы можете увидеть список задач на доске проекта, если хотите принять участие. И это было бы невозможно без поддержки наших спонсоров, как из Open Collective, так и из GitHub Sponsors. Удачной разработки!