Jupyter Starters JSON Schema#

https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json

A collection of JSON types for configuring and operating Starters

Abstract	Extensible	Status	Identifiable	Custom Properties	Additional Properties	Access Restrictions	Defined In
Cannot be instantiated	Yes	Unknown status	Unknown identifiability	Forbidden	Allowed	none	v3.json

Jupyter Starters JSON Type#

object (Jupyter Starters JSON)

any of

Jupyter Starters JSON Definitions#

Definitions group all-starters#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/all-starters"
}

Property	Type	Required	Nullable	Defined by
running	`array`	Optional	cannot be null	Jupyter Starters JSON
starters	`object`	Required	cannot be null	Jupyter Starters JSON
version	`string`	Required	cannot be null	Jupyter Starters JSON

running#

Starters currently using a process/resource

running

is optional
Type: string[]
cannot be null
defined in: Jupyter Starters JSON

running Type#

string[]

starters#

a named set of Starters

starters

is required
Type: object (Starters)
cannot be null
defined in: Jupyter Starters JSON

starters Type#

object (Starters)

version#

The version of the Jupyter Starters API

version

is required
Type: string (API Version)
cannot be null
defined in: Jupyter Starters JSON

version Type#

string (API Version)

version Constraints#

enum: the value of this property must be equal to one of the following values:

Value	Explanation
`"3"`

Definitions group command#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/command"
}

Property	Type	Required	Nullable	Defined by
args	`object`	Optional	cannot be null	Jupyter Starters JSON
id	`string`	Required	cannot be null	Jupyter Starters JSON

args#

optional values provided to the command when executed

args

is optional
Type: object (Arguments)
cannot be null
defined in: Jupyter Starters JSON

args Type#

object (Arguments)

id#

canonical name for the command

id

is required
Type: string (Command ID)
cannot be null
defined in: Jupyter Starters JSON

id Type#

string (Command ID)

Definitions group start-response#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/start-response"
}

Property	Type	Required	Nullable	Defined by
body	`object`	Required	cannot be null	Jupyter Starters JSON
copy	`boolean`	Optional	cannot be null	Jupyter Starters JSON
errors	`array`	Optional	cannot be null	Jupyter Starters JSON
name	`string`	Required	cannot be null	Jupyter Starters JSON
path	`string`	Required	cannot be null	Jupyter Starters JSON
starter	Merged	Required	cannot be null	Jupyter Starters JSON
status	`string`	Required	cannot be null	Jupyter Starters JSON

body#

user data populated by the client

body

is required
Type: object (Body)
cannot be null
defined in: Jupyter Starters JSON

body Type#

object (Body)

copy#

copy files after starter is run (irrespective of status) if true

copy

is optional
Type: boolean (Force Copy)
cannot be null
defined in: Jupyter Starters JSON

copy Type#

boolean (Force Copy)

errors#

a listing of system and user errors created during a starter

errors

is optional
Type: string[] (Error Text)
cannot be null
defined in: Jupyter Starters JSON

errors Type#

string[] (Error Text)

name#

the canonical name of the starter

name

is required
Type: string (Name)
cannot be null
defined in: Jupyter Starters JSON

name Type#

string (Name)

path#

the API path (/ delimited) to which files will be written

path

is required
Type: string (API Path)
cannot be null
defined in: Jupyter Starters JSON

path Type#

string (API Path)

starter#

the current definition of the starter: may change during multi-step starters

starter

is required
Type: object (Starter)
cannot be null
defined in: Jupyter Starters JSON

starter Type#

object (Starter)

any of

all of
- Starter Metadata
- Starter with Files
all of
- Starter Metadata
- A root of Jupyter contents
all of
- all of
  - Starter Metadata
  - Starter with Files
all of
- Starter Metadata
all of
- Starter Metadata
- Starter with Files

status#

the current state of the Starter

status

is required
Type: string (Status)
cannot be null
defined in: Jupyter Starters JSON

status Type#

string (Status)

status Constraints#

enum: the value of this property must be equal to one of the following values:

Value	Explanation
`"error"`
`"continuing"`
`"done"`

Definitions group starter#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter"
}

Property	Type	Required	Nullable	Defined by
type	`string`	Required	cannot be null	Jupyter Starters JSON

type#

type

is required
Type: string (Starter Type)
cannot be null
defined in: Jupyter Starters JSON

type Type#

string (Starter Type)

Definitions group starter-content#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-content"
}

Property	Type	Required	Nullable	Defined by

Definitions group starter-content-any#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-content-any"
}

Property	Type	Required	Nullable	Defined by

Definitions group starter-content-directory#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-content-directory"
}

Property	Type	Required	Nullable	Defined by
content	`array`	Optional	cannot be null	Jupyter Starters JSON
type	`string`	Required	cannot be null	Jupyter Starters JSON

content#

content

is optional
Type: object[] (Details)
cannot be null
defined in: Jupyter Starters JSON

content Type#

object[] (Details)

type#

type

is required
Type: string
cannot be null
defined in: Jupyter Starters JSON

type Type#

string

type Constraints#

enum: the value of this property must be equal to one of the following values:

Value	Explanation
`"directory"`

Definitions group starter-content-file-common#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-content-file-common"
}

Property	Type	Required	Nullable	Defined by
mimetype	`string`	Required	cannot be null	Jupyter Starters JSON
type	`string`	Required	cannot be null	Jupyter Starters JSON

mimetype#

mimetype

is required
Type: string
cannot be null
defined in: Jupyter Starters JSON

mimetype Type#

string

type#

type

is required
Type: string
cannot be null
defined in: Jupyter Starters JSON

type Type#

string

type Constraints#

enum: the value of this property must be equal to one of the following values:

Value	Explanation
`"file"`

Definitions group starter-content-file-json#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-content-file-json"
}

Property	Type	Required	Nullable	Defined by
content	Merged	Optional	cannot be null	Jupyter Starters JSON
format	`string`	Optional	cannot be null	Jupyter Starters JSON

content#

content

is optional
Type: merged type (Details)
cannot be null
defined in: Jupyter Starters JSON

content Type#

merged type (Details)

one (and only one) of

format#

format

is optional
Type: string
cannot be null
defined in: Jupyter Starters JSON

format Type#

string

format Constraints#

enum: the value of this property must be equal to one of the following values:

Value	Explanation
`"json"`

Definitions group starter-content-file-text#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-content-file-text"
}

Property	Type	Required	Nullable	Defined by
content	`string`	Optional	cannot be null	Jupyter Starters JSON
format	`string`	Optional	cannot be null	Jupyter Starters JSON

content#

content

is optional
Type: string
cannot be null
defined in: Jupyter Starters JSON

content Type#

string

format#

format

is optional
Type: string
cannot be null
defined in: Jupyter Starters JSON

format Type#

string

format Constraints#

enum: the value of this property must be equal to one of the following values:

Value	Explanation
`"text"`
`"base64"`

Definitions group starter-copy#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-copy"
}

Property	Type	Required	Nullable	Defined by
type	`string`	Optional	cannot be null	Jupyter Starters JSON

type#

Signifies a copy type

type

is optional
Type: string (Copy Type)
cannot be null
defined in: Jupyter Starters JSON

type Type#

string (Copy Type)

type Constraints#

enum: the value of this property must be equal to one of the following values:

Value	Explanation
`"copy"`

Definitions group starter-copy-with-dest#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-copy-with-dest"
}

Property	Type	Required	Nullable	Defined by
dest	`string`	Required	cannot be null	Jupyter Starters JSON

dest#

The file or folder to copy to: Jinja templates will be applied with body as the context

dest

is required
Type: string (Copy Destination)
cannot be null
defined in: Jupyter Starters JSON

dest Type#

string (Copy Destination)

Definitions group starter-meta#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-meta"
}

Property	Type	Required	Nullable	Defined by
category	`string`	Optional	cannot be null	Jupyter Starters JSON
commands	`array`	Optional	cannot be null	Jupyter Starters JSON
description	`string`	Required	cannot be null	Jupyter Starters JSON
icon	`string`	Optional	cannot be null	Jupyter Starters JSON
ignore	`array`	Optional	cannot be null	Jupyter Starters JSON
label	`string`	Required	cannot be null	Jupyter Starters JSON
rank	`integer`	Optional	cannot be null	Jupyter Starters JSON
schema	`object`	Optional	cannot be null	Jupyter Starters JSON
uiSchema	`object`	Optional	cannot be null	Jupyter Starters JSON

category#

category to place the starter card under in Launcher

category

is optional
Type: string (Category)
cannot be null
defined in: Jupyter Starters JSON

category Type#

string (Category)

category Default Value#

The default value is:

"Starters"

commands#

JupyterLab commands to run after the Starter has completed

commands

is optional
Type: object[] (JupyterLab Command)
cannot be null
defined in: Jupyter Starters JSON

commands Type#

object[] (JupyterLab Command)

description#

short, plain-text description of the intent of the Starter

description

is required
Type: string (Description)
cannot be null
defined in: Jupyter Starters JSON

description Type#

string (Description)

icon#

SVG string to use in Launcher cards and tab icons

icon

is optional
Type: string (Icon)
cannot be null
defined in: Jupyter Starters JSON

icon Type#

string (Icon)

ignore#

glob-style patterns for folders and files exclude from copying, with * for wildcards

ignore

is optional
Type: string[]
cannot be null
defined in: Jupyter Starters JSON

ignore Type#

string[]

label#

human-readable, plain-text description used in UI labels and tab titles

label

is required
Type: string (Label)
cannot be null
defined in: Jupyter Starters JSON

label Type#

string (Label)

rank#

rank of the launcher card within its category, lowest value will appear first

rank

is optional
Type: integer (Rank)
cannot be null
defined in: Jupyter Starters JSON

rank Type#

integer (Rank)

schema#

Draft 7 JSON Schema that generates a form like this one, which must validate the user’s data. Description fields may include markdown

schema

is optional
Type: object (JSON Schema)
cannot be null
defined in: Jupyter Starters JSON

schema Type#

object (JSON Schema)

uiSchema#

react-jsonschema-form uiSchema for customizing the selection of widgets

uiSchema

is optional
Type: object (UI Schema)
cannot be null
defined in: Jupyter Starters JSON

uiSchema Type#

object (UI Schema)

Definitions group starter-notebook#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-notebook"
}

Property	Type	Required	Nullable	Defined by
type	`string`	Optional	cannot be null	Jupyter Starters JSON

type#

Signifies a notebook starter

type

is optional
Type: string (Notebook Type)
cannot be null
defined in: Jupyter Starters JSON

type Type#

string (Notebook Type)

type Constraints#

enum: the value of this property must be equal to one of the following values:

Value	Explanation
`"notebook"`

Definitions group starter-python#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-python"
}

Property	Type	Required	Nullable	Defined by
callable	`string`	Required	cannot be null	Jupyter Starters JSON
type	`string`	Optional	cannot be null	Jupyter Starters JSON

callable#

a python function that accepts the body

callable

is required
Type: string (Python Callable)
cannot be null
defined in: Jupyter Starters JSON

callable Type#

string (Python Callable)

callable Constraints#

pattern: the string must match the following regular expression:

[a-zA-Z_\d\.]

try pattern

type#

Signifies a python starter

type

is optional
Type: string (Python Type)
cannot be null
defined in: Jupyter Starters JSON

type Type#

string (Python Type)

type Constraints#

enum: the value of this property must be equal to one of the following values:

Value	Explanation
`"python"`

Definitions group starter-with-content#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-with-content"
}

Property	Type	Required	Nullable	Defined by
content	Merged	Required	cannot be null	Jupyter Starters JSON

content#

content

is required
Type: object (Details)
cannot be null
defined in: Jupyter Starters JSON

content Type#

object (Details)

all of

Untitled object in Jupyter Starters JSON
one (and only one) of
- Content Folder
- all of
  - Jupyter Contents File
  - one (and only one) of
    - A Text File
    - A JSON File

Definitions group starter-with-src#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starter-with-src"
}

Property	Type	Required	Nullable	Defined by
py_src	`string`	Optional	cannot be null	Jupyter Starters JSON
src	`string`	Required	cannot be null	Jupyter Starters JSON

py_src#

name of a python module installed in the notebook environment to prepent to src

py_src

is optional
Type: string (Starter Python Source)
cannot be null
defined in: Jupyter Starters JSON

py_src Type#

string (Starter Python Source)

src#

path to the starter. may be absolute or relative to the notebook launch directory (or py_src)

src

is required
Type: string (Starter Source)
cannot be null
defined in: Jupyter Starters JSON

src Type#

string (Starter Source)

Definitions group starters#

Reference this group by using

{
  "$ref": "https://raw.githubusercontent.com/deathbeds/jupyterlab-starters/master/src/jupyter_starters/schema/v3.json#/definitions/starters"
}

Property	Type	Required	Nullable	Defined by
Additional Properties	Merged	Optional	cannot be null	Jupyter Starters JSON

Additional Properties#

Additional properties are allowed, as long as they follow this schema:

is optional
Type: object (Starter)
cannot be null
defined in: Jupyter Starters JSON

additionalProperties Type#

object (Starter)

any of

all of
- Starter Metadata
- Starter with Files
all of
- Starter Metadata
- A root of Jupyter contents
all of
- all of
  - Starter Metadata
  - Starter with Files
all of
- Starter Metadata
all of
- Starter Metadata
- Starter with Files