512 lines
10 KiB
Text
512 lines
10 KiB
Text
{
|
|
"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
|
|
}
|