fbec83cbe3
Often you are doing one of 2 things: * Building a larger example from many small cells. * Showing many small isolated examples. The default so far has followed iPython, where cells are connected by default (in its case, the interpreter state backing them sticks around). This change adds a new magic `%config` where you can change the setting `cellreset` to change that behaviour (this is currently the only setting). Also added is a `%noreset` magic so that along with `%reset` you can override the default for one particular cell. The default is equivalent to `%config cellreset off`. If you then wanted to reset in a cell, you can just do %reset to override it. (this is what the current notebooks do) If you instead do `%config cellreset on`, cells always reset and you can choose not to using `%noreset`. The setting is named `cellreset` not `reset` to differentiate it a bit more from the one off command `reset`. The demo notebook has been updated with examples of this in action. Reviewed By: awarzynski Differential Revision: https://reviews.llvm.org/D149055
513 lines
10 KiB
Plaintext
513 lines
10 KiB
Plaintext
{
|
|
"cells": [
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "c45bc113",
|
|
"metadata": {},
|
|
"source": [
|
|
"# LLVM TableGen Kernel"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "483313fc",
|
|
"metadata": {},
|
|
"source": [
|
|
"This notebook is running `llvm-tblgen`."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 1,
|
|
"id": "e238dd42",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stdout",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"------------- Classes -----------------\n",
|
|
"class Foo {\n",
|
|
"}\n",
|
|
"------------- Defs -----------------\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%reset\n",
|
|
"// This is some tablegen\n",
|
|
"class Foo {}"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "27f5aa83",
|
|
"metadata": {},
|
|
"source": [
|
|
"Errors printed to stderr are shown."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 2,
|
|
"id": "e8b10293",
|
|
"metadata": {
|
|
"scrolled": true
|
|
},
|
|
"outputs": [
|
|
{
|
|
"name": "stderr",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"<stdin>:1:1: error: Unexpected token at top level\n",
|
|
"This is not tablegen.\n",
|
|
"^\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%reset\n",
|
|
"This is not tablegen."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "83907141",
|
|
"metadata": {},
|
|
"source": [
|
|
"Add some classes to get some output."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 3,
|
|
"id": "4ca8a9cb",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stdout",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"------------- Classes -----------------\n",
|
|
"class Stuff {\n",
|
|
"}\n",
|
|
"------------- Defs -----------------\n",
|
|
"def thing {\t// Stuff\n",
|
|
"}\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%reset\n",
|
|
"class Stuff {}\n",
|
|
"def thing : Stuff {}"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "3f29d1a0",
|
|
"metadata": {},
|
|
"source": [
|
|
"By default cells are connected. Meaning that we cache the code and magic directives from the previously run cells.\n",
|
|
"\n",
|
|
"This means that the next cell still sees the `Stuff` class."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 4,
|
|
"id": "3a204c70",
|
|
"metadata": {
|
|
"scrolled": true
|
|
},
|
|
"outputs": [
|
|
{
|
|
"name": "stdout",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"------------- Classes -----------------\n",
|
|
"class Stuff {\n",
|
|
"}\n",
|
|
"------------- Defs -----------------\n",
|
|
"def other_thing {\t// Stuff\n",
|
|
"}\n",
|
|
"def thing {\t// Stuff\n",
|
|
"}\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"def other_thing : Stuff {}"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "473b0a1c",
|
|
"metadata": {},
|
|
"source": [
|
|
"You can use the magic `%reset` to clear this cache and start fresh."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 5,
|
|
"id": "1f674a03",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stderr",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"<stdin>:1:19: error: Couldn't find class 'Stuff'\n",
|
|
"def other_thing : Stuff {}\n",
|
|
" ^\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%reset\n",
|
|
"def other_thing : Stuff {}"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "8f120cee",
|
|
"metadata": {},
|
|
"source": [
|
|
"You can also configure the default reset behaviour using the `%config` magic."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 6,
|
|
"id": "7c356853",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stdout",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"------------- Classes -----------------\n",
|
|
"class Thing {\n",
|
|
"}\n",
|
|
"------------- Defs -----------------\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%config cellreset on\n",
|
|
"class Thing {}"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 7,
|
|
"id": "c5399401",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stderr",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"<stdin>:2:13: error: Couldn't find class 'Thing'\n",
|
|
"def AThing: Thing {}\n",
|
|
" ^\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"// The cache is reset here so this is an error.\n",
|
|
"def AThing: Thing {}"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "53220700",
|
|
"metadata": {},
|
|
"source": [
|
|
"The default value is `off`, meaning cells are connected. If you want to override the default for one cell only, use the `%reset` or `%noreset` magic. These always override the default."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 8,
|
|
"id": "50a865ea",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stdout",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"------------- Classes -----------------\n",
|
|
"class Thing {\n",
|
|
"}\n",
|
|
"------------- Defs -----------------\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"class Thing {}"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 9,
|
|
"id": "3c079649",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stdout",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"------------- Classes -----------------\n",
|
|
"class Thing {\n",
|
|
"}\n",
|
|
"------------- Defs -----------------\n",
|
|
"def AThing {\t// Thing\n",
|
|
"}\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%noreset\n",
|
|
"// This works because of the noreset above.\n",
|
|
"def AThing: Thing {}"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 10,
|
|
"id": "75f3c51c",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stderr",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"<stdin>:2:19: error: Couldn't find class 'Thing'\n",
|
|
"def AnotherThing: Thing {}\n",
|
|
" ^\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"// This does not because we're not changing the default.\n",
|
|
"def AnotherThing: Thing {}"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 11,
|
|
"id": "9abe502e",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stdout",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"------------- Classes -----------------\n",
|
|
"------------- Defs -----------------\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%config cellreset off\n",
|
|
"%reset\n",
|
|
"// Here we have an empty cache and default reset behaviour."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "0de42c3c",
|
|
"metadata": {},
|
|
"source": [
|
|
"It is not valid to have `%reset` and `%noreset` in the same cell."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 12,
|
|
"id": "a763daa4",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stderr",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"%reset and %noreset in the same cell is not allowed. Use only one, or neither."
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%reset\n",
|
|
"%noreset"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "f6d4613b",
|
|
"metadata": {},
|
|
"source": [
|
|
"Consider setting `cellreset` to the majority usecase for your notebook. For example a tutorial building a large example across many cells will likely want it `off`. One with many standalone examples, `on`.\n",
|
|
"\n",
|
|
"There is a \"magic\" directive `%args` that you can use to send command line arguments to `llvm-tblgen`.\n",
|
|
"\n",
|
|
"For example, here we have some code that shows a warning."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 13,
|
|
"id": "2586893b",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stderr",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"<stdin>:1:25: warning: unused template argument: Thing:B\n",
|
|
"class Thing <int A, int B> {\n",
|
|
" ^\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%reset\n",
|
|
"class Thing <int A, int B> {\n",
|
|
" int num = A;\n",
|
|
"}"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "41be44e7",
|
|
"metadata": {},
|
|
"source": [
|
|
"We can pass an argument to ignore that warning."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 14,
|
|
"id": "ae078bc4",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stdout",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"------------- Classes -----------------\n",
|
|
"class Thing<int Thing:A = ?, int Thing:B = ?> {\n",
|
|
" int num = Thing:A;\n",
|
|
"}\n",
|
|
"------------- Defs -----------------\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%args --no-warn-on-unused-template-args"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "316b9543",
|
|
"metadata": {},
|
|
"source": [
|
|
"If you have a run of cells without a `%reset`, the most recent `%args` is used."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 15,
|
|
"id": "9634170c",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stdout",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"------------- Classes -----------------\n",
|
|
"class Thing<int Thing:A = ?, int Thing:B = ?> {\n",
|
|
" int num = Thing:A;\n",
|
|
"}\n",
|
|
"------------- Defs -----------------\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"// This passes --no-warn-on-unused-template-args"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 16,
|
|
"id": "fa15b542",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stderr",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"<stdin>:1:25: warning: unused template argument: Thing:B\n",
|
|
"class Thing <int A, int B> {\n",
|
|
" ^\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%args\n",
|
|
"// Now we're not passing the argument so the warning comes back."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "e112f1d4",
|
|
"metadata": {},
|
|
"source": [
|
|
"If there are many `%args` in a cell, the last one is used."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "code",
|
|
"execution_count": 17,
|
|
"id": "2ac46c7a",
|
|
"metadata": {},
|
|
"outputs": [
|
|
{
|
|
"name": "stderr",
|
|
"output_type": "stream",
|
|
"text": [
|
|
"<stdin>:1:18: warning: unused template argument: Thing:A\n",
|
|
"class Thing <int A, int B> {}\n",
|
|
" ^\n",
|
|
"<stdin>:1:25: warning: unused template argument: Thing:B\n",
|
|
"class Thing <int A, int B> {}\n",
|
|
" ^\n"
|
|
]
|
|
}
|
|
],
|
|
"source": [
|
|
"%reset\n",
|
|
"%args --no-warn-on-unused-template-args\n",
|
|
"%args\n",
|
|
"class Thing <int A, int B> {}"
|
|
]
|
|
}
|
|
],
|
|
"metadata": {
|
|
"kernelspec": {
|
|
"display_name": "LLVM TableGen",
|
|
"language": "tablegen",
|
|
"name": "tablegen"
|
|
},
|
|
"language_info": {
|
|
"file_extension": ".td",
|
|
"mimetype": "text/x-tablegen",
|
|
"name": "tablegen",
|
|
"pygments_lexer": "text"
|
|
}
|
|
},
|
|
"nbformat": 4,
|
|
"nbformat_minor": 5
|
|
}
|