Skip to content

new.package.workshop-extension

Create a workshop extension: a python package with its extension.toml, its content and its verbs, and with --app a branded App.

Writes the package-base seeds, then the files of the template workshop-extension, after the files of python-library and each template it extends, into packages/, with the distribution named - and the contract listing the template's extensions. Each option's answer is checked before anything is written, and renders the files; nothing stores it.

A creation installs nothing: a template that needs an extension the workspace's lists do not hold, or that no installed distribution declares yet, refuses before anything is written, naming each. Then the runner the workspace's environment holds wires the member, run as new.wire <name>: it writes the project files again, and locks and syncs the environment and the tools.

fm new.package.workshop-extension <name> [--app=VALUE]
Parameter Type Default Description
<name> required directory name under packages/ (e.g. scratch)
--app=VALUE "" the name of a branded App, a script on PATH that runs the workshop with this extension's verbs; none by default

Example

$ fm new.package.workshop-extension <name>