Playground Book in iPad

[miguelangel-dev]

Description

As a user, I would like to have Playgrounds with support for third party libraries in my iPad. I would like using nef generate a Playground with the whole dependencies compatible with my iPad.

How is it implemented?

It has been developed in functional programming using Bow. The project has been split in UI and Component

UI inside the SwiftPlayground folder you can find the command line script, in the end, it only gets the values from the command line and sends to Component (nef framework)

Component in framework NefSwiftPlayground you can find the whole logic for building a Swift Playground with the whole dependencies.

• SwiftPlayground file makes the structure for building and resolves the dependencies using swift-package-manager.
• PlaygroundBook builds the Playground Book compatible with iPad using the repositories.
• Module is the model where describe how to build a repository compatible with Playground Book.

How is the project structured?

in command-line (bin folder - legacy)

nef (bash) -- use nef-project UI or another bash scripts

in nef project (project folder)

UI (SwiftPlayground) (CLI - main.swift)
|-- connect to Component (nef)(umbrella fw to NefSwiftPlayground, NefMardown, NefJekyll, NefCarbon...)
| -- using the Core (render) (playground page AST: CoreMarkdown, CoreJekyll, CoreCarbon...)

PUBLIC
UI - CLI scripts
Components - fw to use as a library (nef works as API umbrella)

PRIVATE
Core - renders the AST given a Playground page

Helpers - nef commands in Swift Playground

We have added some commands to help development in iPad. Between them, you can find:

• PlaygroundColor: some predefined colours (nef, bow, ...)
• PlaygroundLog: the whole necessary for logging in LiveView

How can I use it?

we can build a Swift Playground with third-party libraries using the next command:
nef-swift-playground --package <package path> --to <output path> --name <swift-playground name>