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: 10 days ago
JSON representation
🧸 Xcode Playground management made easy
- Host: GitHub
- URL: https://github.com/giginet/Toybox
- Owner: giginet
- License: mit
- Created: 2016-09-11T09:13:29.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-10-22T08:00:24.000Z (about 5 years ago)
- Last Synced: 2024-10-14T09:53:20.820Z (25 days ago)
- Language: Swift
- Homepage:
- Size: 936 KB
- Stars: 130
- Watchers: 3
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- fucking-awesome-swift - Toybox - Xcode Playground management made easy. (Misc / Vim)
- awesome-swift - Toybox - Xcode Playground management made easy. (Misc / Vim)
- awesome-swift - Toybox - Xcode Playground management made easy ` 📝 2 years ago ` (Misc [🔝](#readme))
- awesome-swift - Toybox - Xcode Playground management made easy. (Misc / Vim)
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