Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/giginet/Toybox

🧸 Xcode Playground management made easy
https://github.com/giginet/Toybox

Last synced: about 2 months ago
JSON representation

🧸 Xcode Playground management made easy

Lists

README 

        
# Toybox



[![Build Status](https://travis-ci.org/giginet/Toybox.svg?branch=master)](https://travis-ci.org/giginet/Toybox)

[![GitHub license](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://raw.githubusercontent.com/giginet/Toybox/master/LICENSE.md) 

[![GitHub release](https://img.shields.io/github/release/giginet/Toybox.svg)](https://github.com/giginet/Toybox/releases)

[![Language](https://img.shields.io/badge/language-Swift%205.0-orange.svg)](https://swift.org)



Toybox made easy to manage Xcode Playgrounds.



You can create and open Xcode Playground from CLI.



```

$ toybox create Snippet

# Generate ~/.toybox/Snippet.playground and open with Xcode

```



This product is under development so interfaces might change.



## Before Toybox



![](Documentation/Images/before.gif)



## Using Toybox



![](Documentation/Images/after.gif)



## Installation



Toybox requires High Sierra or above.



### Homebrew



```console

$ brew tap giginet/toybox https://github.com/giginet/Toybox.git

$ brew install giginet/toybox/toybox

$ toybox version

```



If you got error on tapping the formula. try `brew untap giginet/toybox` before.



### Mint



Install [yonaskolb/Mint](https://github.com/yonaskolb/Mint).



```console

$ mint install giginet/toybox

```



## Features



### Create new Playground



```sh

# Create 'UIKitDemo.playground' for iOS

$ toybox create UIKitDemo

# Create a new Playground which is not saved

$ toybox create

# Create a new auto generated named Playground which is saved like 20190404082446.playground

$ toybox create -s

# Create 'SpriteKit.playground' for macOS

$ toybox create SpriteKitDemo --platform macos

# Overwrite existing playground 'UIKitDemo'

$ toybox create UIKitDemo -f

# Create but don't open with Xcode

$ toybox create UIKitDemo --no-open

# Create and open with specific Xcode

$ toybox create UIKitDemo --xcode-path /Application/Xcode7.3.app

$ toybox create UIKitDemo --xcode-version 11.1

# Create Playground from standard input

$ echo 'print("Hello World")' | toybox create --input

```



Created Playgrounds will be saved under `$HOME/.toybox`



### List Playgrounds



```sh

# List all existing playgrounds

$ toybox list

# List all playgrounds of specific platform

$ toybox list --platform ios

```



### Open Playground



```sh

# Open UIKitDemo.playground with default Xcode

$ toybox open UIKitDemo

# Open UIKitDemo.playground with specific Xcode

$ toybox open UIKitDemo --xcode-path /Application/Xcode7.3.app

$ toybox open UIKitDemo --xcode-version 11.1

```



### Other



```sh

# Display current Toybox version

$ toybox version

# Display path to Toybox root directory,

# It should return '$HOME/.toybox'

$ toybox root

```



## Extra Usage



Open existing playgrouds with [peco](https://github.com/peco/peco)



```sh

toybox list | peco | awk '{print $1}' | xargs toybox open



```



## Development



### Xcode 11



Open `Toybox` directory with Xcode 11 directly.



### Under Xcode 10.2



```console

$ swift package generate-xcodeproj

$ open Toybox.xcodeproj

```



## Author



giginet <>



## License



MIT License