A simple Vapor provider for creating server-side Swift Playgrounds.
MicroPlaygroundProvider creates a websocket server that can accept Swift source code and return Swift build output text to a client.
Add this dependency to your Package.swift:
dependencies: [
.package(url: "https://github.com/hallee/micro-playground-provider.git", from: "0.1"),
],And add "MicroPlaygroundProvider" as a dependency to your app's target.
In configure.swift:
import MicroPlaygroundProvidertry services.register(MicroPlaygroundProvider())By default, MicroPlaygroundProvider creates a websocket server at the path /playground.
MicroPlaygroundProvider expects a Swift toolchain in your Vapor project's path at ./Toolchains/.
You can download the latest toolchain using this script:
SWIFT_VERSION=5.1
BRANCH=release
RELEASE=RELEASE
if [[ `uname` == 'Darwin' ]]; then
SWIFT_TARGET=osx
else
SWIFT_TARGET=ubuntu16.04
fi
case "$SWIFT_TARGET" in
*osx)
mkdir -p Toolchains/swift-$SWIFT_VERSION-$RELEASE.xctoolchain
# download
curl -O https://swift.org/builds/swift-$SWIFT_VERSION-$BRANCH/xcode/swift-$SWIFT_VERSION-$RELEASE/swift-$SWIFT_VERSION-$RELEASE-$SWIFT_TARGET.pkg
# extract
xar -xf swift-$SWIFT_VERSION-$RELEASE-$SWIFT_TARGET.pkg -C Toolchains/
tar -xzf Toolchains/swift-$SWIFT_VERSION-$RELEASE-$SWIFT_TARGET-package.pkg/Payload -C Toolchains/swift-$SWIFT_VERSION-$RELEASE.xctoolchain
# cleanup
rm Toolchains/Distribution
rm -r Toolchains/swift-$SWIFT_VERSION-$RELEASE-$SWIFT_TARGET-package.pkg
rm -r swift-$SWIFT_VERSION-$RELEASE-$SWIFT_TARGET.pkg
;;
ubuntu*)
mkdir -p Toolchains/swift-$SWIFT_VERSION-$RELEASE.xctoolchain
# download
curl -O https://swift.org/builds/swift-$SWIFT_VERSION-$BRANCH/ubuntu1604/swift-$SWIFT_VERSION-$RELEASE/swift-$SWIFT_VERSION-$RELEASE-$SWIFT_TARGET.tar.gz
# extract
tar -xvzf swift-$SWIFT_VERSION-$RELEASE-$SWIFT_TARGET.tar.gz -C Toolchains/swift-$SWIFT_VERSION-$RELEASE.xctoolchain --strip-components=1
# cleanup
rm -rf swift-$SWIFT_VERSION-$RELEASE-$SWIFT_TARGET.tar.gz
;;
esacOnce you've set up MicroPlaygroundProvider on your server, you can use the WebSocket API directly without any Javascript client libraries.
For example:
socket = new WebSocket('wss://' + location.host + '/playground') // ws:// for non-https sites
socket.onopen = function () {
socket.send('print("Hello, world!")')
}
socket.onmessage = function (event) {
var response = JSON.parse(event.data)
if (response.hasOwnProperty('error') && response.hasOwnProperty('text')) {
console.log(response.text + response.error) // Hello, world!
if (response.error != '') {
// error
} else {
// success
}
}
}