Skip to content

JohnSundell/Playground

Repository files navigation

Playground

Swift 5.1 SwiftPM @johnsundell

Welcome to playground, a Swift script that enables you to super quickly generate Swift playgrounds from the command line - with or without dependencies - for any supported platform.

It essentially provides a command line interface to Xgen.

Features

  • Generate playgrounds in seconds.
  • Automatically reuse any playground created today, for easy code note taking.
  • Add dependencies to a playground with a simple command - no more fiddling with workspaces.
  • Easily open a Gist or code from a GitHub URL in a playground.
  • Supports iOS, macOS & tvOS.

Usage

Simply run playground and a new playground will be created and opened

$ playground

You can also supply various arguments to customize your playground:

Add a playground at a specific path

$ playground -t ~/MyPlayground

Add some dependencies to your playground

$ playground -d ~/unbox/unbox.xcodeproj,~/files/files.xcodeproj

Open the contents of a Gist, a GitHub URL or any other URL in a playground

$ playground -u https://gist.github.com/JohnSundell/b7f901e8edb89d1396ede4d8db3e8c21

Quickly get started with view code prototyping

$ playground -v

Specify what platform you want the playground to run on

$ playground -p tvOS

For all available options, run $ playground -h

Installation

The easiest way to install playground is using the Swift Package Manager:

$ git clone https://github.com/JohnSundell/Playground.git
$ cd Playground
$ swift build -c release
$ install .build/release/Playground /usr/local/bin/playground

Help, feedback or suggestions?

  • Open a PR if you want to make some change to playground.
  • Contact @johnsundell on Twitter for discussions, news & announcements about playground & other projects.

About

Instantly create Swift playgrounds from the command line

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages