diff options
Diffstat (limited to 'docs/sqlglot/schema.html')
| -rw-r--r-- | docs/sqlglot/schema.html | 2126 |
1 files changed, 1140 insertions, 986 deletions
diff --git a/docs/sqlglot/schema.html b/docs/sqlglot/schema.html index d94002d..10ba142 100644 --- a/docs/sqlglot/schema.html +++ b/docs/sqlglot/schema.html @@ -73,6 +73,9 @@ <a class="variable" href="#AbstractMappingSchema.empty">empty</a> </li> <li> + <a class="function" href="#AbstractMappingSchema.depth">depth</a> + </li> + <li> <a class="variable" href="#AbstractMappingSchema.supported_table_args">supported_table_args</a> </li> <li> @@ -105,6 +108,9 @@ <li> <a class="function" href="#MappingSchema.copy">copy</a> </li> + <li> + <a class="function" href="#MappingSchema.depth">depth</a> + </li> </ul> </li> @@ -179,451 +185,496 @@ </span><span id="L-31"><a href="#L-31"><span class="linenos"> 31</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> </span><span id="L-32"><a href="#L-32"><span class="linenos"> 32</span></a> <span class="n">column_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> </span><span id="L-33"><a href="#L-33"><span class="linenos"> 33</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="L-34"><a href="#L-34"><span class="linenos"> 34</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-35"><a href="#L-35"><span class="linenos"> 35</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-36"><a href="#L-36"><span class="linenos"> 36</span></a><span class="sd"> Register or update a table. Some implementing classes may require column information to also be provided.</span> -</span><span id="L-37"><a href="#L-37"><span class="linenos"> 37</span></a> -</span><span id="L-38"><a href="#L-38"><span class="linenos"> 38</span></a><span class="sd"> Args:</span> -</span><span id="L-39"><a href="#L-39"><span class="linenos"> 39</span></a><span class="sd"> table: the `Table` expression instance or string representing the table.</span> -</span><span id="L-40"><a href="#L-40"><span class="linenos"> 40</span></a><span class="sd"> column_mapping: a column mapping that describes the structure of the table.</span> -</span><span id="L-41"><a href="#L-41"><span class="linenos"> 41</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> -</span><span id="L-42"><a href="#L-42"><span class="linenos"> 42</span></a><span class="sd"> """</span> -</span><span id="L-43"><a href="#L-43"><span class="linenos"> 43</span></a> -</span><span id="L-44"><a href="#L-44"><span class="linenos"> 44</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> -</span><span id="L-45"><a href="#L-45"><span class="linenos"> 45</span></a> <span class="k">def</span> <span class="nf">column_names</span><span class="p">(</span> -</span><span id="L-46"><a href="#L-46"><span class="linenos"> 46</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="L-47"><a href="#L-47"><span class="linenos"> 47</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="L-48"><a href="#L-48"><span class="linenos"> 48</span></a> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> -</span><span id="L-49"><a href="#L-49"><span class="linenos"> 49</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="L-50"><a href="#L-50"><span class="linenos"> 50</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> -</span><span id="L-51"><a href="#L-51"><span class="linenos"> 51</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-52"><a href="#L-52"><span class="linenos"> 52</span></a><span class="sd"> Get the column names for a table.</span> -</span><span id="L-53"><a href="#L-53"><span class="linenos"> 53</span></a> -</span><span id="L-54"><a href="#L-54"><span class="linenos"> 54</span></a><span class="sd"> Args:</span> -</span><span id="L-55"><a href="#L-55"><span class="linenos"> 55</span></a><span class="sd"> table: the `Table` expression instance.</span> -</span><span id="L-56"><a href="#L-56"><span class="linenos"> 56</span></a><span class="sd"> only_visible: whether to include invisible columns.</span> -</span><span id="L-57"><a href="#L-57"><span class="linenos"> 57</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> -</span><span id="L-58"><a href="#L-58"><span class="linenos"> 58</span></a> -</span><span id="L-59"><a href="#L-59"><span class="linenos"> 59</span></a><span class="sd"> Returns:</span> -</span><span id="L-60"><a href="#L-60"><span class="linenos"> 60</span></a><span class="sd"> The list of column names.</span> -</span><span id="L-61"><a href="#L-61"><span class="linenos"> 61</span></a><span class="sd"> """</span> -</span><span id="L-62"><a href="#L-62"><span class="linenos"> 62</span></a> -</span><span id="L-63"><a href="#L-63"><span class="linenos"> 63</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> -</span><span id="L-64"><a href="#L-64"><span class="linenos"> 64</span></a> <span class="k">def</span> <span class="nf">get_column_type</span><span class="p">(</span> -</span><span id="L-65"><a href="#L-65"><span class="linenos"> 65</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="L-66"><a href="#L-66"><span class="linenos"> 66</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="L-67"><a href="#L-67"><span class="linenos"> 67</span></a> <span class="n">column</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">,</span> -</span><span id="L-68"><a href="#L-68"><span class="linenos"> 68</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="L-69"><a href="#L-69"><span class="linenos"> 69</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> -</span><span id="L-70"><a href="#L-70"><span class="linenos"> 70</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-71"><a href="#L-71"><span class="linenos"> 71</span></a><span class="sd"> Get the `sqlglot.exp.DataType` type of a column in the schema.</span> -</span><span id="L-72"><a href="#L-72"><span class="linenos"> 72</span></a> -</span><span id="L-73"><a href="#L-73"><span class="linenos"> 73</span></a><span class="sd"> Args:</span> -</span><span id="L-74"><a href="#L-74"><span class="linenos"> 74</span></a><span class="sd"> table: the source table.</span> -</span><span id="L-75"><a href="#L-75"><span class="linenos"> 75</span></a><span class="sd"> column: the target column.</span> -</span><span id="L-76"><a href="#L-76"><span class="linenos"> 76</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> -</span><span id="L-77"><a href="#L-77"><span class="linenos"> 77</span></a> -</span><span id="L-78"><a href="#L-78"><span class="linenos"> 78</span></a><span class="sd"> Returns:</span> -</span><span id="L-79"><a href="#L-79"><span class="linenos"> 79</span></a><span class="sd"> The resulting column type.</span> -</span><span id="L-80"><a href="#L-80"><span class="linenos"> 80</span></a><span class="sd"> """</span> -</span><span id="L-81"><a href="#L-81"><span class="linenos"> 81</span></a> -</span><span id="L-82"><a href="#L-82"><span class="linenos"> 82</span></a> <span class="nd">@property</span> -</span><span id="L-83"><a href="#L-83"><span class="linenos"> 83</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> -</span><span id="L-84"><a href="#L-84"><span class="linenos"> 84</span></a> <span class="k">def</span> <span class="nf">supported_table_args</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]:</span> -</span><span id="L-85"><a href="#L-85"><span class="linenos"> 85</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-86"><a href="#L-86"><span class="linenos"> 86</span></a><span class="sd"> Table arguments this schema support, e.g. `("this", "db", "catalog")`</span> -</span><span id="L-87"><a href="#L-87"><span class="linenos"> 87</span></a><span class="sd"> """</span> -</span><span id="L-88"><a href="#L-88"><span class="linenos"> 88</span></a> -</span><span id="L-89"><a href="#L-89"><span class="linenos"> 89</span></a> <span class="nd">@property</span> -</span><span id="L-90"><a href="#L-90"><span class="linenos"> 90</span></a> <span class="k">def</span> <span class="nf">empty</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span><span class="p">:</span> -</span><span id="L-91"><a href="#L-91"><span class="linenos"> 91</span></a><span class="w"> </span><span class="sd">"""Returns whether or not the schema is empty."""</span> -</span><span id="L-92"><a href="#L-92"><span class="linenos"> 92</span></a> <span class="k">return</span> <span class="kc">True</span> -</span><span id="L-93"><a href="#L-93"><span class="linenos"> 93</span></a> -</span><span id="L-94"><a href="#L-94"><span class="linenos"> 94</span></a> -</span><span id="L-95"><a href="#L-95"><span class="linenos"> 95</span></a><span class="k">class</span> <span class="nc">AbstractMappingSchema</span><span class="p">(</span><span class="n">t</span><span class="o">.</span><span class="n">Generic</span><span class="p">[</span><span class="n">T</span><span class="p">]):</span> -</span><span id="L-96"><a href="#L-96"><span class="linenos"> 96</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> -</span><span id="L-97"><a href="#L-97"><span class="linenos"> 97</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="L-98"><a href="#L-98"><span class="linenos"> 98</span></a> <span class="n">mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="L-99"><a href="#L-99"><span class="linenos"> 99</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-100"><a href="#L-100"><span class="linenos">100</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span> <span class="o">=</span> <span class="n">mapping</span> <span class="ow">or</span> <span class="p">{}</span> -</span><span id="L-101"><a href="#L-101"><span class="linenos">101</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="o">=</span> <span class="n">new_trie</span><span class="p">(</span> -</span><span id="L-102"><a href="#L-102"><span class="linenos">102</span></a> <span class="nb">tuple</span><span class="p">(</span><span class="nb">reversed</span><span class="p">(</span><span class="n">t</span><span class="p">))</span> <span class="k">for</span> <span class="n">t</span> <span class="ow">in</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_depth</span><span class="p">())</span> -</span><span id="L-103"><a href="#L-103"><span class="linenos">103</span></a> <span class="p">)</span> -</span><span id="L-104"><a href="#L-104"><span class="linenos">104</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">()</span> -</span><span id="L-105"><a href="#L-105"><span class="linenos">105</span></a> -</span><span id="L-106"><a href="#L-106"><span class="linenos">106</span></a> <span class="nd">@property</span> -</span><span id="L-107"><a href="#L-107"><span class="linenos">107</span></a> <span class="k">def</span> <span class="nf">empty</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span><span class="p">:</span> -</span><span id="L-108"><a href="#L-108"><span class="linenos">108</span></a> <span class="k">return</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span> -</span><span id="L-109"><a href="#L-109"><span class="linenos">109</span></a> -</span><span id="L-110"><a href="#L-110"><span class="linenos">110</span></a> <span class="k">def</span> <span class="nf">_depth</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">int</span><span class="p">:</span> -</span><span id="L-111"><a href="#L-111"><span class="linenos">111</span></a> <span class="k">return</span> <span class="n">dict_depth</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">)</span> -</span><span id="L-112"><a href="#L-112"><span class="linenos">112</span></a> -</span><span id="L-113"><a href="#L-113"><span class="linenos">113</span></a> <span class="nd">@property</span> -</span><span id="L-114"><a href="#L-114"><span class="linenos">114</span></a> <span class="k">def</span> <span class="nf">supported_table_args</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]:</span> -</span><span id="L-115"><a href="#L-115"><span class="linenos">115</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">:</span> -</span><span id="L-116"><a href="#L-116"><span class="linenos">116</span></a> <span class="n">depth</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span><span class="p">()</span> -</span><span id="L-117"><a href="#L-117"><span class="linenos">117</span></a> -</span><span id="L-118"><a href="#L-118"><span class="linenos">118</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">depth</span><span class="p">:</span> <span class="c1"># None</span> -</span><span id="L-119"><a href="#L-119"><span class="linenos">119</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">()</span> -</span><span id="L-120"><a href="#L-120"><span class="linenos">120</span></a> <span class="k">elif</span> <span class="mi">1</span> <span class="o"><=</span> <span class="n">depth</span> <span class="o"><=</span> <span class="mi">3</span><span class="p">:</span> -</span><span id="L-121"><a href="#L-121"><span class="linenos">121</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="o">=</span> <span class="n">TABLE_ARGS</span><span class="p">[:</span><span class="n">depth</span><span class="p">]</span> -</span><span id="L-122"><a href="#L-122"><span class="linenos">122</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="L-123"><a href="#L-123"><span class="linenos">123</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Invalid mapping shape. Depth: </span><span class="si">{</span><span class="n">depth</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="L-124"><a href="#L-124"><span class="linenos">124</span></a> -</span><span id="L-125"><a href="#L-125"><span class="linenos">125</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> +</span><span id="L-34"><a href="#L-34"><span class="linenos"> 34</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-35"><a href="#L-35"><span class="linenos"> 35</span></a> <span class="n">match_depth</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> +</span><span id="L-36"><a href="#L-36"><span class="linenos"> 36</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-37"><a href="#L-37"><span class="linenos"> 37</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-38"><a href="#L-38"><span class="linenos"> 38</span></a><span class="sd"> Register or update a table. Some implementing classes may require column information to also be provided.</span> +</span><span id="L-39"><a href="#L-39"><span class="linenos"> 39</span></a><span class="sd"> The added table must have the necessary number of qualifiers in its path to match the schema's nesting level.</span> +</span><span id="L-40"><a href="#L-40"><span class="linenos"> 40</span></a> +</span><span id="L-41"><a href="#L-41"><span class="linenos"> 41</span></a><span class="sd"> Args:</span> +</span><span id="L-42"><a href="#L-42"><span class="linenos"> 42</span></a><span class="sd"> table: the `Table` expression instance or string representing the table.</span> +</span><span id="L-43"><a href="#L-43"><span class="linenos"> 43</span></a><span class="sd"> column_mapping: a column mapping that describes the structure of the table.</span> +</span><span id="L-44"><a href="#L-44"><span class="linenos"> 44</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> +</span><span id="L-45"><a href="#L-45"><span class="linenos"> 45</span></a><span class="sd"> normalize: whether to normalize identifiers according to the dialect of interest.</span> +</span><span id="L-46"><a href="#L-46"><span class="linenos"> 46</span></a><span class="sd"> match_depth: whether to enforce that the table must match the schema's depth or not.</span> +</span><span id="L-47"><a href="#L-47"><span class="linenos"> 47</span></a><span class="sd"> """</span> +</span><span id="L-48"><a href="#L-48"><span class="linenos"> 48</span></a> +</span><span id="L-49"><a href="#L-49"><span class="linenos"> 49</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> +</span><span id="L-50"><a href="#L-50"><span class="linenos"> 50</span></a> <span class="k">def</span> <span class="nf">column_names</span><span class="p">(</span> +</span><span id="L-51"><a href="#L-51"><span class="linenos"> 51</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="L-52"><a href="#L-52"><span class="linenos"> 52</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="L-53"><a href="#L-53"><span class="linenos"> 53</span></a> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> +</span><span id="L-54"><a href="#L-54"><span class="linenos"> 54</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-55"><a href="#L-55"><span class="linenos"> 55</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-56"><a href="#L-56"><span class="linenos"> 56</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> +</span><span id="L-57"><a href="#L-57"><span class="linenos"> 57</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-58"><a href="#L-58"><span class="linenos"> 58</span></a><span class="sd"> Get the column names for a table.</span> +</span><span id="L-59"><a href="#L-59"><span class="linenos"> 59</span></a> +</span><span id="L-60"><a href="#L-60"><span class="linenos"> 60</span></a><span class="sd"> Args:</span> +</span><span id="L-61"><a href="#L-61"><span class="linenos"> 61</span></a><span class="sd"> table: the `Table` expression instance.</span> +</span><span id="L-62"><a href="#L-62"><span class="linenos"> 62</span></a><span class="sd"> only_visible: whether to include invisible columns.</span> +</span><span id="L-63"><a href="#L-63"><span class="linenos"> 63</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> +</span><span id="L-64"><a href="#L-64"><span class="linenos"> 64</span></a><span class="sd"> normalize: whether to normalize identifiers according to the dialect of interest.</span> +</span><span id="L-65"><a href="#L-65"><span class="linenos"> 65</span></a> +</span><span id="L-66"><a href="#L-66"><span class="linenos"> 66</span></a><span class="sd"> Returns:</span> +</span><span id="L-67"><a href="#L-67"><span class="linenos"> 67</span></a><span class="sd"> The list of column names.</span> +</span><span id="L-68"><a href="#L-68"><span class="linenos"> 68</span></a><span class="sd"> """</span> +</span><span id="L-69"><a href="#L-69"><span class="linenos"> 69</span></a> +</span><span id="L-70"><a href="#L-70"><span class="linenos"> 70</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> +</span><span id="L-71"><a href="#L-71"><span class="linenos"> 71</span></a> <span class="k">def</span> <span class="nf">get_column_type</span><span class="p">(</span> +</span><span id="L-72"><a href="#L-72"><span class="linenos"> 72</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="L-73"><a href="#L-73"><span class="linenos"> 73</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="L-74"><a href="#L-74"><span class="linenos"> 74</span></a> <span class="n">column</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">,</span> +</span><span id="L-75"><a href="#L-75"><span class="linenos"> 75</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-76"><a href="#L-76"><span class="linenos"> 76</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-77"><a href="#L-77"><span class="linenos"> 77</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> +</span><span id="L-78"><a href="#L-78"><span class="linenos"> 78</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-79"><a href="#L-79"><span class="linenos"> 79</span></a><span class="sd"> Get the `sqlglot.exp.DataType` type of a column in the schema.</span> +</span><span id="L-80"><a href="#L-80"><span class="linenos"> 80</span></a> +</span><span id="L-81"><a href="#L-81"><span class="linenos"> 81</span></a><span class="sd"> Args:</span> +</span><span id="L-82"><a href="#L-82"><span class="linenos"> 82</span></a><span class="sd"> table: the source table.</span> +</span><span id="L-83"><a href="#L-83"><span class="linenos"> 83</span></a><span class="sd"> column: the target column.</span> +</span><span id="L-84"><a href="#L-84"><span class="linenos"> 84</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> +</span><span id="L-85"><a href="#L-85"><span class="linenos"> 85</span></a><span class="sd"> normalize: whether to normalize identifiers according to the dialect of interest.</span> +</span><span id="L-86"><a href="#L-86"><span class="linenos"> 86</span></a> +</span><span id="L-87"><a href="#L-87"><span class="linenos"> 87</span></a><span class="sd"> Returns:</span> +</span><span id="L-88"><a href="#L-88"><span class="linenos"> 88</span></a><span class="sd"> The resulting column type.</span> +</span><span id="L-89"><a href="#L-89"><span class="linenos"> 89</span></a><span class="sd"> """</span> +</span><span id="L-90"><a href="#L-90"><span class="linenos"> 90</span></a> +</span><span id="L-91"><a href="#L-91"><span class="linenos"> 91</span></a> <span class="nd">@property</span> +</span><span id="L-92"><a href="#L-92"><span class="linenos"> 92</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> +</span><span id="L-93"><a href="#L-93"><span class="linenos"> 93</span></a> <span class="k">def</span> <span class="nf">supported_table_args</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]:</span> +</span><span id="L-94"><a href="#L-94"><span class="linenos"> 94</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-95"><a href="#L-95"><span class="linenos"> 95</span></a><span class="sd"> Table arguments this schema support, e.g. `("this", "db", "catalog")`</span> +</span><span id="L-96"><a href="#L-96"><span class="linenos"> 96</span></a><span class="sd"> """</span> +</span><span id="L-97"><a href="#L-97"><span class="linenos"> 97</span></a> +</span><span id="L-98"><a href="#L-98"><span class="linenos"> 98</span></a> <span class="nd">@property</span> +</span><span id="L-99"><a href="#L-99"><span class="linenos"> 99</span></a> <span class="k">def</span> <span class="nf">empty</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span><span class="p">:</span> +</span><span id="L-100"><a href="#L-100"><span class="linenos">100</span></a><span class="w"> </span><span class="sd">"""Returns whether or not the schema is empty."""</span> +</span><span id="L-101"><a href="#L-101"><span class="linenos">101</span></a> <span class="k">return</span> <span class="kc">True</span> +</span><span id="L-102"><a href="#L-102"><span class="linenos">102</span></a> +</span><span id="L-103"><a href="#L-103"><span class="linenos">103</span></a> +</span><span id="L-104"><a href="#L-104"><span class="linenos">104</span></a><span class="k">class</span> <span class="nc">AbstractMappingSchema</span><span class="p">(</span><span class="n">t</span><span class="o">.</span><span class="n">Generic</span><span class="p">[</span><span class="n">T</span><span class="p">]):</span> +</span><span id="L-105"><a href="#L-105"><span class="linenos">105</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> +</span><span id="L-106"><a href="#L-106"><span class="linenos">106</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="L-107"><a href="#L-107"><span class="linenos">107</span></a> <span class="n">mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-108"><a href="#L-108"><span class="linenos">108</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-109"><a href="#L-109"><span class="linenos">109</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span> <span class="o">=</span> <span class="n">mapping</span> <span class="ow">or</span> <span class="p">{}</span> +</span><span id="L-110"><a href="#L-110"><span class="linenos">110</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="o">=</span> <span class="n">new_trie</span><span class="p">(</span> +</span><span id="L-111"><a href="#L-111"><span class="linenos">111</span></a> <span class="nb">tuple</span><span class="p">(</span><span class="nb">reversed</span><span class="p">(</span><span class="n">t</span><span class="p">))</span> <span class="k">for</span> <span class="n">t</span> <span class="ow">in</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">depth</span><span class="p">())</span> +</span><span id="L-112"><a href="#L-112"><span class="linenos">112</span></a> <span class="p">)</span> +</span><span id="L-113"><a href="#L-113"><span class="linenos">113</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">()</span> +</span><span id="L-114"><a href="#L-114"><span class="linenos">114</span></a> +</span><span id="L-115"><a href="#L-115"><span class="linenos">115</span></a> <span class="nd">@property</span> +</span><span id="L-116"><a href="#L-116"><span class="linenos">116</span></a> <span class="k">def</span> <span class="nf">empty</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span><span class="p">:</span> +</span><span id="L-117"><a href="#L-117"><span class="linenos">117</span></a> <span class="k">return</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span> +</span><span id="L-118"><a href="#L-118"><span class="linenos">118</span></a> +</span><span id="L-119"><a href="#L-119"><span class="linenos">119</span></a> <span class="k">def</span> <span class="nf">depth</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">int</span><span class="p">:</span> +</span><span id="L-120"><a href="#L-120"><span class="linenos">120</span></a> <span class="k">return</span> <span class="n">dict_depth</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">)</span> +</span><span id="L-121"><a href="#L-121"><span class="linenos">121</span></a> +</span><span id="L-122"><a href="#L-122"><span class="linenos">122</span></a> <span class="nd">@property</span> +</span><span id="L-123"><a href="#L-123"><span class="linenos">123</span></a> <span class="k">def</span> <span class="nf">supported_table_args</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]:</span> +</span><span id="L-124"><a href="#L-124"><span class="linenos">124</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">:</span> +</span><span id="L-125"><a href="#L-125"><span class="linenos">125</span></a> <span class="n">depth</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">depth</span><span class="p">()</span> </span><span id="L-126"><a href="#L-126"><span class="linenos">126</span></a> -</span><span id="L-127"><a href="#L-127"><span class="linenos">127</span></a> <span class="k">def</span> <span class="nf">table_parts</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> -</span><span id="L-128"><a href="#L-128"><span class="linenos">128</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">ReadCSV</span><span class="p">):</span> -</span><span id="L-129"><a href="#L-129"><span class="linenos">129</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> -</span><span id="L-130"><a href="#L-130"><span class="linenos">130</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)</span> <span class="k">for</span> <span class="n">part</span> <span class="ow">in</span> <span class="n">TABLE_ARGS</span> <span class="k">if</span> <span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)]</span> -</span><span id="L-131"><a href="#L-131"><span class="linenos">131</span></a> -</span><span id="L-132"><a href="#L-132"><span class="linenos">132</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span> -</span><span id="L-133"><a href="#L-133"><span class="linenos">133</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">,</span> <span class="n">trie</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span> -</span><span id="L-134"><a href="#L-134"><span class="linenos">134</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">T</span><span class="p">]:</span> -</span><span id="L-135"><a href="#L-135"><span class="linenos">135</span></a> <span class="n">parts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">table</span><span class="p">)[</span><span class="mi">0</span> <span class="p">:</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">)]</span> -</span><span id="L-136"><a href="#L-136"><span class="linenos">136</span></a> <span class="n">value</span><span class="p">,</span> <span class="n">trie</span> <span class="o">=</span> <span class="n">in_trie</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="k">if</span> <span class="n">trie</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">trie</span><span class="p">,</span> <span class="n">parts</span><span class="p">)</span> -</span><span id="L-137"><a href="#L-137"><span class="linenos">137</span></a> -</span><span id="L-138"><a href="#L-138"><span class="linenos">138</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">FAILED</span><span class="p">:</span> -</span><span id="L-139"><a href="#L-139"><span class="linenos">139</span></a> <span class="k">return</span> <span class="kc">None</span> +</span><span id="L-127"><a href="#L-127"><span class="linenos">127</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">depth</span><span class="p">:</span> <span class="c1"># None</span> +</span><span id="L-128"><a href="#L-128"><span class="linenos">128</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">()</span> +</span><span id="L-129"><a href="#L-129"><span class="linenos">129</span></a> <span class="k">elif</span> <span class="mi">1</span> <span class="o"><=</span> <span class="n">depth</span> <span class="o"><=</span> <span class="mi">3</span><span class="p">:</span> +</span><span id="L-130"><a href="#L-130"><span class="linenos">130</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="o">=</span> <span class="n">TABLE_ARGS</span><span class="p">[:</span><span class="n">depth</span><span class="p">]</span> +</span><span id="L-131"><a href="#L-131"><span class="linenos">131</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="L-132"><a href="#L-132"><span class="linenos">132</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Invalid mapping shape. Depth: </span><span class="si">{</span><span class="n">depth</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-133"><a href="#L-133"><span class="linenos">133</span></a> +</span><span id="L-134"><a href="#L-134"><span class="linenos">134</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> +</span><span id="L-135"><a href="#L-135"><span class="linenos">135</span></a> +</span><span id="L-136"><a href="#L-136"><span class="linenos">136</span></a> <span class="k">def</span> <span class="nf">table_parts</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> +</span><span id="L-137"><a href="#L-137"><span class="linenos">137</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">ReadCSV</span><span class="p">):</span> +</span><span id="L-138"><a href="#L-138"><span class="linenos">138</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> +</span><span id="L-139"><a href="#L-139"><span class="linenos">139</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)</span> <span class="k">for</span> <span class="n">part</span> <span class="ow">in</span> <span class="n">TABLE_ARGS</span> <span class="k">if</span> <span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)]</span> </span><span id="L-140"><a href="#L-140"><span class="linenos">140</span></a> -</span><span id="L-141"><a href="#L-141"><span class="linenos">141</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">PREFIX</span><span class="p">:</span> -</span><span id="L-142"><a href="#L-142"><span class="linenos">142</span></a> <span class="n">possibilities</span> <span class="o">=</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="n">trie</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">dict_depth</span><span class="p">(</span><span class="n">trie</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> -</span><span id="L-143"><a href="#L-143"><span class="linenos">143</span></a> -</span><span id="L-144"><a href="#L-144"><span class="linenos">144</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">possibilities</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> -</span><span id="L-145"><a href="#L-145"><span class="linenos">145</span></a> <span class="n">parts</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">possibilities</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span> -</span><span id="L-146"><a href="#L-146"><span class="linenos">146</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="L-147"><a href="#L-147"><span class="linenos">147</span></a> <span class="n">message</span> <span class="o">=</span> <span class="s2">", "</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s2">"."</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">parts</span><span class="p">)</span> <span class="k">for</span> <span class="n">parts</span> <span class="ow">in</span> <span class="n">possibilities</span><span class="p">)</span> -</span><span id="L-148"><a href="#L-148"><span class="linenos">148</span></a> <span class="k">if</span> <span class="n">raise_on_missing</span><span class="p">:</span> -</span><span id="L-149"><a href="#L-149"><span class="linenos">149</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ambiguous mapping for </span><span class="si">{</span><span class="n">table</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">message</span><span class="si">}</span><span class="s2">."</span><span class="p">)</span> -</span><span id="L-150"><a href="#L-150"><span class="linenos">150</span></a> <span class="k">return</span> <span class="kc">None</span> -</span><span id="L-151"><a href="#L-151"><span class="linenos">151</span></a> -</span><span id="L-152"><a href="#L-152"><span class="linenos">152</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">nested_get</span><span class="p">(</span><span class="n">parts</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">)</span> -</span><span id="L-153"><a href="#L-153"><span class="linenos">153</span></a> -</span><span id="L-154"><a href="#L-154"><span class="linenos">154</span></a> <span class="k">def</span> <span class="nf">nested_get</span><span class="p">(</span> -</span><span id="L-155"><a href="#L-155"><span class="linenos">155</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">parts</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">True</span> -</span><span id="L-156"><a href="#L-156"><span class="linenos">156</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">]:</span> -</span><span id="L-157"><a href="#L-157"><span class="linenos">157</span></a> <span class="k">return</span> <span class="n">nested_get</span><span class="p">(</span> -</span><span id="L-158"><a href="#L-158"><span class="linenos">158</span></a> <span class="n">d</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> -</span><span id="L-159"><a href="#L-159"><span class="linenos">159</span></a> <span class="o">*</span><span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">,</span> <span class="nb">reversed</span><span class="p">(</span><span class="n">parts</span><span class="p">)),</span> -</span><span id="L-160"><a href="#L-160"><span class="linenos">160</span></a> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">,</span> -</span><span id="L-161"><a href="#L-161"><span class="linenos">161</span></a> <span class="p">)</span> +</span><span id="L-141"><a href="#L-141"><span class="linenos">141</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span> +</span><span id="L-142"><a href="#L-142"><span class="linenos">142</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">,</span> <span class="n">trie</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span> +</span><span id="L-143"><a href="#L-143"><span class="linenos">143</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">T</span><span class="p">]:</span> +</span><span id="L-144"><a href="#L-144"><span class="linenos">144</span></a> <span class="n">parts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">table</span><span class="p">)[</span><span class="mi">0</span> <span class="p">:</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">)]</span> +</span><span id="L-145"><a href="#L-145"><span class="linenos">145</span></a> <span class="n">value</span><span class="p">,</span> <span class="n">trie</span> <span class="o">=</span> <span class="n">in_trie</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="k">if</span> <span class="n">trie</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">trie</span><span class="p">,</span> <span class="n">parts</span><span class="p">)</span> +</span><span id="L-146"><a href="#L-146"><span class="linenos">146</span></a> +</span><span id="L-147"><a href="#L-147"><span class="linenos">147</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">FAILED</span><span class="p">:</span> +</span><span id="L-148"><a href="#L-148"><span class="linenos">148</span></a> <span class="k">return</span> <span class="kc">None</span> +</span><span id="L-149"><a href="#L-149"><span class="linenos">149</span></a> +</span><span id="L-150"><a href="#L-150"><span class="linenos">150</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">PREFIX</span><span class="p">:</span> +</span><span id="L-151"><a href="#L-151"><span class="linenos">151</span></a> <span class="n">possibilities</span> <span class="o">=</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="n">trie</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">dict_depth</span><span class="p">(</span><span class="n">trie</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> +</span><span id="L-152"><a href="#L-152"><span class="linenos">152</span></a> +</span><span id="L-153"><a href="#L-153"><span class="linenos">153</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">possibilities</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> +</span><span id="L-154"><a href="#L-154"><span class="linenos">154</span></a> <span class="n">parts</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">possibilities</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span> +</span><span id="L-155"><a href="#L-155"><span class="linenos">155</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="L-156"><a href="#L-156"><span class="linenos">156</span></a> <span class="n">message</span> <span class="o">=</span> <span class="s2">", "</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s2">"."</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">parts</span><span class="p">)</span> <span class="k">for</span> <span class="n">parts</span> <span class="ow">in</span> <span class="n">possibilities</span><span class="p">)</span> +</span><span id="L-157"><a href="#L-157"><span class="linenos">157</span></a> <span class="k">if</span> <span class="n">raise_on_missing</span><span class="p">:</span> +</span><span id="L-158"><a href="#L-158"><span class="linenos">158</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ambiguous mapping for </span><span class="si">{</span><span class="n">table</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">message</span><span class="si">}</span><span class="s2">."</span><span class="p">)</span> +</span><span id="L-159"><a href="#L-159"><span class="linenos">159</span></a> <span class="k">return</span> <span class="kc">None</span> +</span><span id="L-160"><a href="#L-160"><span class="linenos">160</span></a> +</span><span id="L-161"><a href="#L-161"><span class="linenos">161</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">nested_get</span><span class="p">(</span><span class="n">parts</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">)</span> </span><span id="L-162"><a href="#L-162"><span class="linenos">162</span></a> -</span><span id="L-163"><a href="#L-163"><span class="linenos">163</span></a> -</span><span id="L-164"><a href="#L-164"><span class="linenos">164</span></a><span class="k">class</span> <span class="nc">MappingSchema</span><span class="p">(</span><span class="n">AbstractMappingSchema</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]],</span> <span class="n">Schema</span><span class="p">):</span> -</span><span id="L-165"><a href="#L-165"><span class="linenos">165</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-166"><a href="#L-166"><span class="linenos">166</span></a><span class="sd"> Schema based on a nested mapping.</span> -</span><span id="L-167"><a href="#L-167"><span class="linenos">167</span></a> -</span><span id="L-168"><a href="#L-168"><span class="linenos">168</span></a><span class="sd"> Args:</span> -</span><span id="L-169"><a href="#L-169"><span class="linenos">169</span></a><span class="sd"> schema: Mapping in one of the following forms:</span> -</span><span id="L-170"><a href="#L-170"><span class="linenos">170</span></a><span class="sd"> 1. {table: {col: type}}</span> -</span><span id="L-171"><a href="#L-171"><span class="linenos">171</span></a><span class="sd"> 2. {db: {table: {col: type}}}</span> -</span><span id="L-172"><a href="#L-172"><span class="linenos">172</span></a><span class="sd"> 3. {catalog: {db: {table: {col: type}}}}</span> -</span><span id="L-173"><a href="#L-173"><span class="linenos">173</span></a><span class="sd"> 4. None - Tables will be added later</span> -</span><span id="L-174"><a href="#L-174"><span class="linenos">174</span></a><span class="sd"> visible: Optional mapping of which columns in the schema are visible. If not provided, all columns</span> -</span><span id="L-175"><a href="#L-175"><span class="linenos">175</span></a><span class="sd"> are assumed to be visible. The nesting should mirror that of the schema:</span> -</span><span id="L-176"><a href="#L-176"><span class="linenos">176</span></a><span class="sd"> 1. {table: set(*cols)}}</span> -</span><span id="L-177"><a href="#L-177"><span class="linenos">177</span></a><span class="sd"> 2. {db: {table: set(*cols)}}}</span> -</span><span id="L-178"><a href="#L-178"><span class="linenos">178</span></a><span class="sd"> 3. {catalog: {db: {table: set(*cols)}}}}</span> -</span><span id="L-179"><a href="#L-179"><span class="linenos">179</span></a><span class="sd"> dialect: The dialect to be used for custom type mappings & parsing string arguments.</span> -</span><span id="L-180"><a href="#L-180"><span class="linenos">180</span></a><span class="sd"> normalize: Whether to normalize identifier names according to the given dialect or not.</span> -</span><span id="L-181"><a href="#L-181"><span class="linenos">181</span></a><span class="sd"> """</span> -</span><span id="L-182"><a href="#L-182"><span class="linenos">182</span></a> -</span><span id="L-183"><a href="#L-183"><span class="linenos">183</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> -</span><span id="L-184"><a href="#L-184"><span class="linenos">184</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="L-185"><a href="#L-185"><span class="linenos">185</span></a> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="L-186"><a href="#L-186"><span class="linenos">186</span></a> <span class="n">visible</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="L-187"><a href="#L-187"><span class="linenos">187</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="L-188"><a href="#L-188"><span class="linenos">188</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> -</span><span id="L-189"><a href="#L-189"><span class="linenos">189</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-190"><a href="#L-190"><span class="linenos">190</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> -</span><span id="L-191"><a href="#L-191"><span class="linenos">191</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span> <span class="o">=</span> <span class="n">visible</span> <span class="ow">or</span> <span class="p">{}</span> -</span><span id="L-192"><a href="#L-192"><span class="linenos">192</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span> <span class="o">=</span> <span class="n">normalize</span> -</span><span id="L-193"><a href="#L-193"><span class="linenos">193</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="L-194"><a href="#L-194"><span class="linenos">194</span></a> -</span><span id="L-195"><a href="#L-195"><span class="linenos">195</span></a> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize</span><span class="p">(</span><span class="n">schema</span> <span class="ow">or</span> <span class="p">{}))</span> -</span><span id="L-196"><a href="#L-196"><span class="linenos">196</span></a> -</span><span id="L-197"><a href="#L-197"><span class="linenos">197</span></a> <span class="nd">@classmethod</span> -</span><span id="L-198"><a href="#L-198"><span class="linenos">198</span></a> <span class="k">def</span> <span class="nf">from_mapping_schema</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">mapping_schema</span><span class="p">:</span> <span class="n">MappingSchema</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> -</span><span id="L-199"><a href="#L-199"><span class="linenos">199</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> -</span><span id="L-200"><a href="#L-200"><span class="linenos">200</span></a> <span class="n">schema</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> -</span><span id="L-201"><a href="#L-201"><span class="linenos">201</span></a> <span class="n">visible</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">visible</span><span class="p">,</span> -</span><span id="L-202"><a href="#L-202"><span class="linenos">202</span></a> <span class="n">dialect</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> -</span><span id="L-203"><a href="#L-203"><span class="linenos">203</span></a> <span class="p">)</span> +</span><span id="L-163"><a href="#L-163"><span class="linenos">163</span></a> <span class="k">def</span> <span class="nf">nested_get</span><span class="p">(</span> +</span><span id="L-164"><a href="#L-164"><span class="linenos">164</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">parts</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">True</span> +</span><span id="L-165"><a href="#L-165"><span class="linenos">165</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">]:</span> +</span><span id="L-166"><a href="#L-166"><span class="linenos">166</span></a> <span class="k">return</span> <span class="n">nested_get</span><span class="p">(</span> +</span><span id="L-167"><a href="#L-167"><span class="linenos">167</span></a> <span class="n">d</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> +</span><span id="L-168"><a href="#L-168"><span class="linenos">168</span></a> <span class="o">*</span><span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">,</span> <span class="nb">reversed</span><span class="p">(</span><span class="n">parts</span><span class="p">)),</span> +</span><span id="L-169"><a href="#L-169"><span class="linenos">169</span></a> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">,</span> +</span><span id="L-170"><a href="#L-170"><span class="linenos">170</span></a> <span class="p">)</span> +</span><span id="L-171"><a href="#L-171"><span class="linenos">171</span></a> +</span><span id="L-172"><a href="#L-172"><span class="linenos">172</span></a> +</span><span id="L-173"><a href="#L-173"><span class="linenos">173</span></a><span class="k">class</span> <span class="nc">MappingSchema</span><span class="p">(</span><span class="n">AbstractMappingSchema</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]],</span> <span class="n">Schema</span><span class="p">):</span> +</span><span id="L-174"><a href="#L-174"><span class="linenos">174</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-175"><a href="#L-175"><span class="linenos">175</span></a><span class="sd"> Schema based on a nested mapping.</span> +</span><span id="L-176"><a href="#L-176"><span class="linenos">176</span></a> +</span><span id="L-177"><a href="#L-177"><span class="linenos">177</span></a><span class="sd"> Args:</span> +</span><span id="L-178"><a href="#L-178"><span class="linenos">178</span></a><span class="sd"> schema: Mapping in one of the following forms:</span> +</span><span id="L-179"><a href="#L-179"><span class="linenos">179</span></a><span class="sd"> 1. {table: {col: type}}</span> +</span><span id="L-180"><a href="#L-180"><span class="linenos">180</span></a><span class="sd"> 2. {db: {table: {col: type}}}</span> +</span><span id="L-181"><a href="#L-181"><span class="linenos">181</span></a><span class="sd"> 3. {catalog: {db: {table: {col: type}}}}</span> +</span><span id="L-182"><a href="#L-182"><span class="linenos">182</span></a><span class="sd"> 4. None - Tables will be added later</span> +</span><span id="L-183"><a href="#L-183"><span class="linenos">183</span></a><span class="sd"> visible: Optional mapping of which columns in the schema are visible. If not provided, all columns</span> +</span><span id="L-184"><a href="#L-184"><span class="linenos">184</span></a><span class="sd"> are assumed to be visible. The nesting should mirror that of the schema:</span> +</span><span id="L-185"><a href="#L-185"><span class="linenos">185</span></a><span class="sd"> 1. {table: set(*cols)}}</span> +</span><span id="L-186"><a href="#L-186"><span class="linenos">186</span></a><span class="sd"> 2. {db: {table: set(*cols)}}}</span> +</span><span id="L-187"><a href="#L-187"><span class="linenos">187</span></a><span class="sd"> 3. {catalog: {db: {table: set(*cols)}}}}</span> +</span><span id="L-188"><a href="#L-188"><span class="linenos">188</span></a><span class="sd"> dialect: The dialect to be used for custom type mappings & parsing string arguments.</span> +</span><span id="L-189"><a href="#L-189"><span class="linenos">189</span></a><span class="sd"> normalize: Whether to normalize identifier names according to the given dialect or not.</span> +</span><span id="L-190"><a href="#L-190"><span class="linenos">190</span></a><span class="sd"> """</span> +</span><span id="L-191"><a href="#L-191"><span class="linenos">191</span></a> +</span><span id="L-192"><a href="#L-192"><span class="linenos">192</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> +</span><span id="L-193"><a href="#L-193"><span class="linenos">193</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="L-194"><a href="#L-194"><span class="linenos">194</span></a> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-195"><a href="#L-195"><span class="linenos">195</span></a> <span class="n">visible</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-196"><a href="#L-196"><span class="linenos">196</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-197"><a href="#L-197"><span class="linenos">197</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> +</span><span id="L-198"><a href="#L-198"><span class="linenos">198</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-199"><a href="#L-199"><span class="linenos">199</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> +</span><span id="L-200"><a href="#L-200"><span class="linenos">200</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span> <span class="o">=</span> <span class="n">visible</span> <span class="ow">or</span> <span class="p">{}</span> +</span><span id="L-201"><a href="#L-201"><span class="linenos">201</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span> <span class="o">=</span> <span class="n">normalize</span> +</span><span id="L-202"><a href="#L-202"><span class="linenos">202</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="L-203"><a href="#L-203"><span class="linenos">203</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span> <span class="o">=</span> <span class="mi">0</span> </span><span id="L-204"><a href="#L-204"><span class="linenos">204</span></a> -</span><span id="L-205"><a href="#L-205"><span class="linenos">205</span></a> <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> -</span><span id="L-206"><a href="#L-206"><span class="linenos">206</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> -</span><span id="L-207"><a href="#L-207"><span class="linenos">207</span></a> <span class="o">**</span><span class="p">{</span> <span class="c1"># type: ignore</span> -</span><span id="L-208"><a href="#L-208"><span class="linenos">208</span></a> <span class="s2">"schema"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> -</span><span id="L-209"><a href="#L-209"><span class="linenos">209</span></a> <span class="s2">"visible"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> -</span><span id="L-210"><a href="#L-210"><span class="linenos">210</span></a> <span class="s2">"dialect"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> -</span><span id="L-211"><a href="#L-211"><span class="linenos">211</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> -</span><span id="L-212"><a href="#L-212"><span class="linenos">212</span></a> <span class="p">}</span> -</span><span id="L-213"><a href="#L-213"><span class="linenos">213</span></a> <span class="p">)</span> -</span><span id="L-214"><a href="#L-214"><span class="linenos">214</span></a> -</span><span id="L-215"><a href="#L-215"><span class="linenos">215</span></a> <span class="k">def</span> <span class="nf">add_table</span><span class="p">(</span> -</span><span id="L-216"><a href="#L-216"><span class="linenos">216</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="L-217"><a href="#L-217"><span class="linenos">217</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="L-218"><a href="#L-218"><span class="linenos">218</span></a> <span class="n">column_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="L-219"><a href="#L-219"><span class="linenos">219</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="L-220"><a href="#L-220"><span class="linenos">220</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-221"><a href="#L-221"><span class="linenos">221</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-222"><a href="#L-222"><span class="linenos">222</span></a><span class="sd"> Register or update a table. Updates are only performed if a new column mapping is provided.</span> -</span><span id="L-223"><a href="#L-223"><span class="linenos">223</span></a> -</span><span id="L-224"><a href="#L-224"><span class="linenos">224</span></a><span class="sd"> Args:</span> -</span><span id="L-225"><a href="#L-225"><span class="linenos">225</span></a><span class="sd"> table: the `Table` expression instance or string representing the table.</span> -</span><span id="L-226"><a href="#L-226"><span class="linenos">226</span></a><span class="sd"> column_mapping: a column mapping that describes the structure of the table.</span> -</span><span id="L-227"><a href="#L-227"><span class="linenos">227</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> -</span><span id="L-228"><a href="#L-228"><span class="linenos">228</span></a><span class="sd"> """</span> -</span><span id="L-229"><a href="#L-229"><span class="linenos">229</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> -</span><span id="L-230"><a href="#L-230"><span class="linenos">230</span></a> -</span><span id="L-231"><a href="#L-231"><span class="linenos">231</span></a> <span class="n">normalized_column_mapping</span> <span class="o">=</span> <span class="p">{</span> -</span><span id="L-232"><a href="#L-232"><span class="linenos">232</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">):</span> <span class="n">value</span> -</span><span id="L-233"><a href="#L-233"><span class="linenos">233</span></a> <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">ensure_column_mapping</span><span class="p">(</span><span class="n">column_mapping</span><span class="p">)</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> -</span><span id="L-234"><a href="#L-234"><span class="linenos">234</span></a> <span class="p">}</span> -</span><span id="L-235"><a href="#L-235"><span class="linenos">235</span></a> -</span><span id="L-236"><a href="#L-236"><span class="linenos">236</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> -</span><span id="L-237"><a href="#L-237"><span class="linenos">237</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">normalized_column_mapping</span><span class="p">:</span> -</span><span id="L-238"><a href="#L-238"><span class="linenos">238</span></a> <span class="k">return</span> -</span><span id="L-239"><a href="#L-239"><span class="linenos">239</span></a> -</span><span id="L-240"><a href="#L-240"><span class="linenos">240</span></a> <span class="n">parts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">)</span> -</span><span id="L-241"><a href="#L-241"><span class="linenos">241</span></a> -</span><span id="L-242"><a href="#L-242"><span class="linenos">242</span></a> <span class="n">nested_set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">tuple</span><span class="p">(</span><span class="nb">reversed</span><span class="p">(</span><span class="n">parts</span><span class="p">)),</span> <span class="n">normalized_column_mapping</span><span class="p">)</span> -</span><span id="L-243"><a href="#L-243"><span class="linenos">243</span></a> <span class="n">new_trie</span><span class="p">([</span><span class="n">parts</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span><span class="p">)</span> -</span><span id="L-244"><a href="#L-244"><span class="linenos">244</span></a> -</span><span id="L-245"><a href="#L-245"><span class="linenos">245</span></a> <span class="k">def</span> <span class="nf">column_names</span><span class="p">(</span> -</span><span id="L-246"><a href="#L-246"><span class="linenos">246</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="L-247"><a href="#L-247"><span class="linenos">247</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="L-248"><a href="#L-248"><span class="linenos">248</span></a> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> -</span><span id="L-249"><a href="#L-249"><span class="linenos">249</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="L-250"><a href="#L-250"><span class="linenos">250</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> -</span><span id="L-251"><a href="#L-251"><span class="linenos">251</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> -</span><span id="L-252"><a href="#L-252"><span class="linenos">252</span></a> -</span><span id="L-253"><a href="#L-253"><span class="linenos">253</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">)</span> -</span><span id="L-254"><a href="#L-254"><span class="linenos">254</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-255"><a href="#L-255"><span class="linenos">255</span></a> <span class="k">return</span> <span class="p">[]</span> -</span><span id="L-256"><a href="#L-256"><span class="linenos">256</span></a> -</span><span id="L-257"><a href="#L-257"><span class="linenos">257</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">only_visible</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="p">:</span> -</span><span id="L-258"><a href="#L-258"><span class="linenos">258</span></a> <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> -</span><span id="L-259"><a href="#L-259"><span class="linenos">259</span></a> -</span><span id="L-260"><a href="#L-260"><span class="linenos">260</span></a> <span class="n">visible</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">nested_get</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">),</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[]</span> -</span><span id="L-261"><a href="#L-261"><span class="linenos">261</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">col</span> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">schema</span> <span class="k">if</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">visible</span><span class="p">]</span> +</span><span id="L-205"><a href="#L-205"><span class="linenos">205</span></a> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize</span><span class="p">(</span><span class="n">schema</span> <span class="ow">or</span> <span class="p">{}))</span> +</span><span id="L-206"><a href="#L-206"><span class="linenos">206</span></a> +</span><span id="L-207"><a href="#L-207"><span class="linenos">207</span></a> <span class="nd">@classmethod</span> +</span><span id="L-208"><a href="#L-208"><span class="linenos">208</span></a> <span class="k">def</span> <span class="nf">from_mapping_schema</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">mapping_schema</span><span class="p">:</span> <span class="n">MappingSchema</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> +</span><span id="L-209"><a href="#L-209"><span class="linenos">209</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> +</span><span id="L-210"><a href="#L-210"><span class="linenos">210</span></a> <span class="n">schema</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> +</span><span id="L-211"><a href="#L-211"><span class="linenos">211</span></a> <span class="n">visible</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">visible</span><span class="p">,</span> +</span><span id="L-212"><a href="#L-212"><span class="linenos">212</span></a> <span class="n">dialect</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> +</span><span id="L-213"><a href="#L-213"><span class="linenos">213</span></a> <span class="n">normalize</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">normalize</span><span class="p">,</span> +</span><span id="L-214"><a href="#L-214"><span class="linenos">214</span></a> <span class="p">)</span> +</span><span id="L-215"><a href="#L-215"><span class="linenos">215</span></a> +</span><span id="L-216"><a href="#L-216"><span class="linenos">216</span></a> <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> +</span><span id="L-217"><a href="#L-217"><span class="linenos">217</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> +</span><span id="L-218"><a href="#L-218"><span class="linenos">218</span></a> <span class="o">**</span><span class="p">{</span> <span class="c1"># type: ignore</span> +</span><span id="L-219"><a href="#L-219"><span class="linenos">219</span></a> <span class="s2">"schema"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> +</span><span id="L-220"><a href="#L-220"><span class="linenos">220</span></a> <span class="s2">"visible"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> +</span><span id="L-221"><a href="#L-221"><span class="linenos">221</span></a> <span class="s2">"dialect"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> +</span><span id="L-222"><a href="#L-222"><span class="linenos">222</span></a> <span class="s2">"normalize"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span><span class="p">,</span> +</span><span id="L-223"><a href="#L-223"><span class="linenos">223</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> +</span><span id="L-224"><a href="#L-224"><span class="linenos">224</span></a> <span class="p">}</span> +</span><span id="L-225"><a href="#L-225"><span class="linenos">225</span></a> <span class="p">)</span> +</span><span id="L-226"><a href="#L-226"><span class="linenos">226</span></a> +</span><span id="L-227"><a href="#L-227"><span class="linenos">227</span></a> <span class="k">def</span> <span class="nf">add_table</span><span class="p">(</span> +</span><span id="L-228"><a href="#L-228"><span class="linenos">228</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="L-229"><a href="#L-229"><span class="linenos">229</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="L-230"><a href="#L-230"><span class="linenos">230</span></a> <span class="n">column_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-231"><a href="#L-231"><span class="linenos">231</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-232"><a href="#L-232"><span class="linenos">232</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-233"><a href="#L-233"><span class="linenos">233</span></a> <span class="n">match_depth</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> +</span><span id="L-234"><a href="#L-234"><span class="linenos">234</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-235"><a href="#L-235"><span class="linenos">235</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-236"><a href="#L-236"><span class="linenos">236</span></a><span class="sd"> Register or update a table. Updates are only performed if a new column mapping is provided.</span> +</span><span id="L-237"><a href="#L-237"><span class="linenos">237</span></a><span class="sd"> The added table must have the necessary number of qualifiers in its path to match the schema's nesting level.</span> +</span><span id="L-238"><a href="#L-238"><span class="linenos">238</span></a> +</span><span id="L-239"><a href="#L-239"><span class="linenos">239</span></a><span class="sd"> Args:</span> +</span><span id="L-240"><a href="#L-240"><span class="linenos">240</span></a><span class="sd"> table: the `Table` expression instance or string representing the table.</span> +</span><span id="L-241"><a href="#L-241"><span class="linenos">241</span></a><span class="sd"> column_mapping: a column mapping that describes the structure of the table.</span> +</span><span id="L-242"><a href="#L-242"><span class="linenos">242</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> +</span><span id="L-243"><a href="#L-243"><span class="linenos">243</span></a><span class="sd"> normalize: whether to normalize identifiers according to the dialect of interest.</span> +</span><span id="L-244"><a href="#L-244"><span class="linenos">244</span></a><span class="sd"> match_depth: whether to enforce that the table must match the schema's depth or not.</span> +</span><span id="L-245"><a href="#L-245"><span class="linenos">245</span></a><span class="sd"> """</span> +</span><span id="L-246"><a href="#L-246"><span class="linenos">246</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span><span class="p">)</span> +</span><span id="L-247"><a href="#L-247"><span class="linenos">247</span></a> +</span><span id="L-248"><a href="#L-248"><span class="linenos">248</span></a> <span class="k">if</span> <span class="n">match_depth</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">empty</span> <span class="ow">and</span> <span class="nb">len</span><span class="p">(</span><span class="n">normalized_table</span><span class="o">.</span><span class="n">parts</span><span class="p">)</span> <span class="o">!=</span> <span class="bp">self</span><span class="o">.</span><span class="n">depth</span><span class="p">():</span> +</span><span id="L-249"><a href="#L-249"><span class="linenos">249</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span> +</span><span id="L-250"><a href="#L-250"><span class="linenos">250</span></a> <span class="sa">f</span><span class="s2">"Table </span><span class="si">{</span><span class="n">normalized_table</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="n">dialect</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">)</span><span class="si">}</span><span class="s2"> must match the "</span> +</span><span id="L-251"><a href="#L-251"><span class="linenos">251</span></a> <span class="sa">f</span><span class="s2">"schema's nesting level: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">depth</span><span class="p">()</span><span class="si">}</span><span class="s2">."</span> +</span><span id="L-252"><a href="#L-252"><span class="linenos">252</span></a> <span class="p">)</span> +</span><span id="L-253"><a href="#L-253"><span class="linenos">253</span></a> +</span><span id="L-254"><a href="#L-254"><span class="linenos">254</span></a> <span class="n">normalized_column_mapping</span> <span class="o">=</span> <span class="p">{</span> +</span><span id="L-255"><a href="#L-255"><span class="linenos">255</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span><span class="p">):</span> <span class="n">value</span> +</span><span id="L-256"><a href="#L-256"><span class="linenos">256</span></a> <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">ensure_column_mapping</span><span class="p">(</span><span class="n">column_mapping</span><span class="p">)</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> +</span><span id="L-257"><a href="#L-257"><span class="linenos">257</span></a> <span class="p">}</span> +</span><span id="L-258"><a href="#L-258"><span class="linenos">258</span></a> +</span><span id="L-259"><a href="#L-259"><span class="linenos">259</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> +</span><span id="L-260"><a href="#L-260"><span class="linenos">260</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">normalized_column_mapping</span><span class="p">:</span> +</span><span id="L-261"><a href="#L-261"><span class="linenos">261</span></a> <span class="k">return</span> </span><span id="L-262"><a href="#L-262"><span class="linenos">262</span></a> -</span><span id="L-263"><a href="#L-263"><span class="linenos">263</span></a> <span class="k">def</span> <span class="nf">get_column_type</span><span class="p">(</span> -</span><span id="L-264"><a href="#L-264"><span class="linenos">264</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="L-265"><a href="#L-265"><span class="linenos">265</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="L-266"><a href="#L-266"><span class="linenos">266</span></a> <span class="n">column</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">,</span> -</span><span id="L-267"><a href="#L-267"><span class="linenos">267</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="L-268"><a href="#L-268"><span class="linenos">268</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> -</span><span id="L-269"><a href="#L-269"><span class="linenos">269</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> -</span><span id="L-270"><a href="#L-270"><span class="linenos">270</span></a> -</span><span id="L-271"><a href="#L-271"><span class="linenos">271</span></a> <span class="n">normalized_column_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span> -</span><span id="L-272"><a href="#L-272"><span class="linenos">272</span></a> <span class="n">column</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="k">else</span> <span class="n">column</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span> -</span><span id="L-273"><a href="#L-273"><span class="linenos">273</span></a> <span class="p">)</span> -</span><span id="L-274"><a href="#L-274"><span class="linenos">274</span></a> -</span><span id="L-275"><a href="#L-275"><span class="linenos">275</span></a> <span class="n">table_schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> -</span><span id="L-276"><a href="#L-276"><span class="linenos">276</span></a> <span class="k">if</span> <span class="n">table_schema</span><span class="p">:</span> -</span><span id="L-277"><a href="#L-277"><span class="linenos">277</span></a> <span class="n">column_type</span> <span class="o">=</span> <span class="n">table_schema</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">normalized_column_name</span><span class="p">)</span> -</span><span id="L-278"><a href="#L-278"><span class="linenos">278</span></a> -</span><span id="L-279"><a href="#L-279"><span class="linenos">279</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column_type</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">):</span> -</span><span id="L-280"><a href="#L-280"><span class="linenos">280</span></a> <span class="k">return</span> <span class="n">column_type</span> -</span><span id="L-281"><a href="#L-281"><span class="linenos">281</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column_type</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> -</span><span id="L-282"><a href="#L-282"><span class="linenos">282</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_to_data_type</span><span class="p">(</span><span class="n">column_type</span><span class="o">.</span><span class="n">upper</span><span class="p">(),</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> +</span><span id="L-263"><a href="#L-263"><span class="linenos">263</span></a> <span class="n">parts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">)</span> +</span><span id="L-264"><a href="#L-264"><span class="linenos">264</span></a> +</span><span id="L-265"><a href="#L-265"><span class="linenos">265</span></a> <span class="n">nested_set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">tuple</span><span class="p">(</span><span class="nb">reversed</span><span class="p">(</span><span class="n">parts</span><span class="p">)),</span> <span class="n">normalized_column_mapping</span><span class="p">)</span> +</span><span id="L-266"><a href="#L-266"><span class="linenos">266</span></a> <span class="n">new_trie</span><span class="p">([</span><span class="n">parts</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span><span class="p">)</span> +</span><span id="L-267"><a href="#L-267"><span class="linenos">267</span></a> +</span><span id="L-268"><a href="#L-268"><span class="linenos">268</span></a> <span class="k">def</span> <span class="nf">column_names</span><span class="p">(</span> +</span><span id="L-269"><a href="#L-269"><span class="linenos">269</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="L-270"><a href="#L-270"><span class="linenos">270</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="L-271"><a href="#L-271"><span class="linenos">271</span></a> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> +</span><span id="L-272"><a href="#L-272"><span class="linenos">272</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-273"><a href="#L-273"><span class="linenos">273</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-274"><a href="#L-274"><span class="linenos">274</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> +</span><span id="L-275"><a href="#L-275"><span class="linenos">275</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span><span class="p">)</span> +</span><span id="L-276"><a href="#L-276"><span class="linenos">276</span></a> +</span><span id="L-277"><a href="#L-277"><span class="linenos">277</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">)</span> +</span><span id="L-278"><a href="#L-278"><span class="linenos">278</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-279"><a href="#L-279"><span class="linenos">279</span></a> <span class="k">return</span> <span class="p">[]</span> +</span><span id="L-280"><a href="#L-280"><span class="linenos">280</span></a> +</span><span id="L-281"><a href="#L-281"><span class="linenos">281</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">only_visible</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="p">:</span> +</span><span id="L-282"><a href="#L-282"><span class="linenos">282</span></a> <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> </span><span id="L-283"><a href="#L-283"><span class="linenos">283</span></a> -</span><span id="L-284"><a href="#L-284"><span class="linenos">284</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="s2">"unknown"</span><span class="p">)</span> -</span><span id="L-285"><a href="#L-285"><span class="linenos">285</span></a> -</span><span id="L-286"><a href="#L-286"><span class="linenos">286</span></a> <span class="k">def</span> <span class="nf">_normalize</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> -</span><span id="L-287"><a href="#L-287"><span class="linenos">287</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-288"><a href="#L-288"><span class="linenos">288</span></a><span class="sd"> Normalizes all identifiers in the schema.</span> -</span><span id="L-289"><a href="#L-289"><span class="linenos">289</span></a> -</span><span id="L-290"><a href="#L-290"><span class="linenos">290</span></a><span class="sd"> Args:</span> -</span><span id="L-291"><a href="#L-291"><span class="linenos">291</span></a><span class="sd"> schema: the schema to normalize.</span> -</span><span id="L-292"><a href="#L-292"><span class="linenos">292</span></a> -</span><span id="L-293"><a href="#L-293"><span class="linenos">293</span></a><span class="sd"> Returns:</span> -</span><span id="L-294"><a href="#L-294"><span class="linenos">294</span></a><span class="sd"> The normalized schema mapping.</span> -</span><span id="L-295"><a href="#L-295"><span class="linenos">295</span></a><span class="sd"> """</span> -</span><span id="L-296"><a href="#L-296"><span class="linenos">296</span></a> <span class="n">flattened_schema</span> <span class="o">=</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">dict_depth</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> -</span><span id="L-297"><a href="#L-297"><span class="linenos">297</span></a> -</span><span id="L-298"><a href="#L-298"><span class="linenos">298</span></a> <span class="n">normalized_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="L-299"><a href="#L-299"><span class="linenos">299</span></a> <span class="k">for</span> <span class="n">keys</span> <span class="ow">in</span> <span class="n">flattened_schema</span><span class="p">:</span> -</span><span id="L-300"><a href="#L-300"><span class="linenos">300</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="n">nested_get</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="o">*</span><span class="nb">zip</span><span class="p">(</span><span class="n">keys</span><span class="p">,</span> <span class="n">keys</span><span class="p">))</span> -</span><span id="L-301"><a href="#L-301"><span class="linenos">301</span></a> <span class="k">assert</span> <span class="n">columns</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> -</span><span id="L-302"><a href="#L-302"><span class="linenos">302</span></a> -</span><span id="L-303"><a href="#L-303"><span class="linenos">303</span></a> <span class="n">normalized_keys</span> <span class="o">=</span> <span class="p">[</span> -</span><span id="L-304"><a href="#L-304"><span class="linenos">304</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> <span class="n">is_table</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">keys</span> -</span><span id="L-305"><a href="#L-305"><span class="linenos">305</span></a> <span class="p">]</span> -</span><span id="L-306"><a href="#L-306"><span class="linenos">306</span></a> <span class="k">for</span> <span class="n">column_name</span><span class="p">,</span> <span class="n">column_type</span> <span class="ow">in</span> <span class="n">columns</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> -</span><span id="L-307"><a href="#L-307"><span class="linenos">307</span></a> <span class="n">nested_set</span><span class="p">(</span> -</span><span id="L-308"><a href="#L-308"><span class="linenos">308</span></a> <span class="n">normalized_mapping</span><span class="p">,</span> -</span><span id="L-309"><a href="#L-309"><span class="linenos">309</span></a> <span class="n">normalized_keys</span> <span class="o">+</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">column_name</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">)],</span> -</span><span id="L-310"><a href="#L-310"><span class="linenos">310</span></a> <span class="n">column_type</span><span class="p">,</span> -</span><span id="L-311"><a href="#L-311"><span class="linenos">311</span></a> <span class="p">)</span> -</span><span id="L-312"><a href="#L-312"><span class="linenos">312</span></a> -</span><span id="L-313"><a href="#L-313"><span class="linenos">313</span></a> <span class="k">return</span> <span class="n">normalized_mapping</span> +</span><span id="L-284"><a href="#L-284"><span class="linenos">284</span></a> <span class="n">visible</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">nested_get</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">),</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[]</span> +</span><span id="L-285"><a href="#L-285"><span class="linenos">285</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">col</span> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">schema</span> <span class="k">if</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">visible</span><span class="p">]</span> +</span><span id="L-286"><a href="#L-286"><span class="linenos">286</span></a> +</span><span id="L-287"><a href="#L-287"><span class="linenos">287</span></a> <span class="k">def</span> <span class="nf">get_column_type</span><span class="p">(</span> +</span><span id="L-288"><a href="#L-288"><span class="linenos">288</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="L-289"><a href="#L-289"><span class="linenos">289</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="L-290"><a href="#L-290"><span class="linenos">290</span></a> <span class="n">column</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">,</span> +</span><span id="L-291"><a href="#L-291"><span class="linenos">291</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-292"><a href="#L-292"><span class="linenos">292</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-293"><a href="#L-293"><span class="linenos">293</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> +</span><span id="L-294"><a href="#L-294"><span class="linenos">294</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span><span class="p">)</span> +</span><span id="L-295"><a href="#L-295"><span class="linenos">295</span></a> +</span><span id="L-296"><a href="#L-296"><span class="linenos">296</span></a> <span class="n">normalized_column_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span> +</span><span id="L-297"><a href="#L-297"><span class="linenos">297</span></a> <span class="n">column</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="k">else</span> <span class="n">column</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span> +</span><span id="L-298"><a href="#L-298"><span class="linenos">298</span></a> <span class="p">)</span> +</span><span id="L-299"><a href="#L-299"><span class="linenos">299</span></a> +</span><span id="L-300"><a href="#L-300"><span class="linenos">300</span></a> <span class="n">table_schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> +</span><span id="L-301"><a href="#L-301"><span class="linenos">301</span></a> <span class="k">if</span> <span class="n">table_schema</span><span class="p">:</span> +</span><span id="L-302"><a href="#L-302"><span class="linenos">302</span></a> <span class="n">column_type</span> <span class="o">=</span> <span class="n">table_schema</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">normalized_column_name</span><span class="p">)</span> +</span><span id="L-303"><a href="#L-303"><span class="linenos">303</span></a> +</span><span id="L-304"><a href="#L-304"><span class="linenos">304</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column_type</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">):</span> +</span><span id="L-305"><a href="#L-305"><span class="linenos">305</span></a> <span class="k">return</span> <span class="n">column_type</span> +</span><span id="L-306"><a href="#L-306"><span class="linenos">306</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column_type</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> +</span><span id="L-307"><a href="#L-307"><span class="linenos">307</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_to_data_type</span><span class="p">(</span><span class="n">column_type</span><span class="o">.</span><span class="n">upper</span><span class="p">(),</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> +</span><span id="L-308"><a href="#L-308"><span class="linenos">308</span></a> +</span><span id="L-309"><a href="#L-309"><span class="linenos">309</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="s2">"unknown"</span><span class="p">)</span> +</span><span id="L-310"><a href="#L-310"><span class="linenos">310</span></a> +</span><span id="L-311"><a href="#L-311"><span class="linenos">311</span></a> <span class="k">def</span> <span class="nf">_normalize</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> +</span><span id="L-312"><a href="#L-312"><span class="linenos">312</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-313"><a href="#L-313"><span class="linenos">313</span></a><span class="sd"> Normalizes all identifiers in the schema.</span> </span><span id="L-314"><a href="#L-314"><span class="linenos">314</span></a> -</span><span id="L-315"><a href="#L-315"><span class="linenos">315</span></a> <span class="k">def</span> <span class="nf">_normalize_table</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">:</span> -</span><span id="L-316"><a href="#L-316"><span class="linenos">316</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">maybe_parse</span><span class="p">(</span> -</span><span id="L-317"><a href="#L-317"><span class="linenos">317</span></a> <span class="n">table</span><span class="p">,</span> <span class="n">into</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">True</span> -</span><span id="L-318"><a href="#L-318"><span class="linenos">318</span></a> <span class="p">)</span> -</span><span id="L-319"><a href="#L-319"><span class="linenos">319</span></a> -</span><span id="L-320"><a href="#L-320"><span class="linenos">320</span></a> <span class="k">for</span> <span class="n">arg</span> <span class="ow">in</span> <span class="n">TABLE_ARGS</span><span class="p">:</span> -</span><span id="L-321"><a href="#L-321"><span class="linenos">321</span></a> <span class="n">value</span> <span class="o">=</span> <span class="n">normalized_table</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">arg</span><span class="p">)</span> -</span><span id="L-322"><a href="#L-322"><span class="linenos">322</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">str</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">)):</span> -</span><span id="L-323"><a href="#L-323"><span class="linenos">323</span></a> <span class="n">normalized_table</span><span class="o">.</span><span class="n">set</span><span class="p">(</span> -</span><span id="L-324"><a href="#L-324"><span class="linenos">324</span></a> <span class="n">arg</span><span class="p">,</span> -</span><span id="L-325"><a href="#L-325"><span class="linenos">325</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">is_table</span><span class="o">=</span><span class="kc">True</span><span class="p">)),</span> -</span><span id="L-326"><a href="#L-326"><span class="linenos">326</span></a> <span class="p">)</span> -</span><span id="L-327"><a href="#L-327"><span class="linenos">327</span></a> -</span><span id="L-328"><a href="#L-328"><span class="linenos">328</span></a> <span class="k">return</span> <span class="n">normalized_table</span> -</span><span id="L-329"><a href="#L-329"><span class="linenos">329</span></a> -</span><span id="L-330"><a href="#L-330"><span class="linenos">330</span></a> <span class="k">def</span> <span class="nf">_normalize_name</span><span class="p">(</span> -</span><span id="L-331"><a href="#L-331"><span class="linenos">331</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">,</span> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">is_table</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span> -</span><span id="L-332"><a href="#L-332"><span class="linenos">332</span></a> <span class="p">)</span> <span class="o">-></span> <span class="nb">str</span><span class="p">:</span> -</span><span id="L-333"><a href="#L-333"><span class="linenos">333</span></a> <span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> -</span><span id="L-334"><a href="#L-334"><span class="linenos">334</span></a> -</span><span id="L-335"><a href="#L-335"><span class="linenos">335</span></a> <span class="k">try</span><span class="p">:</span> -</span><span id="L-336"><a href="#L-336"><span class="linenos">336</span></a> <span class="n">identifier</span> <span class="o">=</span> <span class="n">sqlglot</span><span class="o">.</span><span class="n">maybe_parse</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">into</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">)</span> -</span><span id="L-337"><a href="#L-337"><span class="linenos">337</span></a> <span class="k">except</span> <span class="n">ParseError</span><span class="p">:</span> -</span><span id="L-338"><a href="#L-338"><span class="linenos">338</span></a> <span class="k">return</span> <span class="n">name</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="k">else</span> <span class="n">name</span><span class="o">.</span><span class="n">name</span> -</span><span id="L-339"><a href="#L-339"><span class="linenos">339</span></a> -</span><span id="L-340"><a href="#L-340"><span class="linenos">340</span></a> <span class="n">name</span> <span class="o">=</span> <span class="n">identifier</span><span class="o">.</span><span class="n">name</span> -</span><span id="L-341"><a href="#L-341"><span class="linenos">341</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span><span class="p">:</span> -</span><span id="L-342"><a href="#L-342"><span class="linenos">342</span></a> <span class="k">return</span> <span class="n">name</span> +</span><span id="L-315"><a href="#L-315"><span class="linenos">315</span></a><span class="sd"> Args:</span> +</span><span id="L-316"><a href="#L-316"><span class="linenos">316</span></a><span class="sd"> schema: the schema to normalize.</span> +</span><span id="L-317"><a href="#L-317"><span class="linenos">317</span></a> +</span><span id="L-318"><a href="#L-318"><span class="linenos">318</span></a><span class="sd"> Returns:</span> +</span><span id="L-319"><a href="#L-319"><span class="linenos">319</span></a><span class="sd"> The normalized schema mapping.</span> +</span><span id="L-320"><a href="#L-320"><span class="linenos">320</span></a><span class="sd"> """</span> +</span><span id="L-321"><a href="#L-321"><span class="linenos">321</span></a> <span class="n">normalized_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="L-322"><a href="#L-322"><span class="linenos">322</span></a> <span class="n">flattened_schema</span> <span class="o">=</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">dict_depth</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> +</span><span id="L-323"><a href="#L-323"><span class="linenos">323</span></a> +</span><span id="L-324"><a href="#L-324"><span class="linenos">324</span></a> <span class="k">for</span> <span class="n">keys</span> <span class="ow">in</span> <span class="n">flattened_schema</span><span class="p">:</span> +</span><span id="L-325"><a href="#L-325"><span class="linenos">325</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="n">nested_get</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="o">*</span><span class="nb">zip</span><span class="p">(</span><span class="n">keys</span><span class="p">,</span> <span class="n">keys</span><span class="p">))</span> +</span><span id="L-326"><a href="#L-326"><span class="linenos">326</span></a> +</span><span id="L-327"><a href="#L-327"><span class="linenos">327</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">columns</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span> +</span><span id="L-328"><a href="#L-328"><span class="linenos">328</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span> +</span><span id="L-329"><a href="#L-329"><span class="linenos">329</span></a> <span class="sa">f</span><span class="s2">"Table </span><span class="si">{</span><span class="s1">'.'</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">keys</span><span class="p">[:</span><span class="o">-</span><span class="mi">1</span><span class="p">])</span><span class="si">}</span><span class="s2"> must match the schema's nesting level: </span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="n">flattened_schema</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span><span class="si">}</span><span class="s2">."</span> +</span><span id="L-330"><a href="#L-330"><span class="linenos">330</span></a> <span class="p">)</span> +</span><span id="L-331"><a href="#L-331"><span class="linenos">331</span></a> +</span><span id="L-332"><a href="#L-332"><span class="linenos">332</span></a> <span class="n">normalized_keys</span> <span class="o">=</span> <span class="p">[</span> +</span><span id="L-333"><a href="#L-333"><span class="linenos">333</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> <span class="n">is_table</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">keys</span> +</span><span id="L-334"><a href="#L-334"><span class="linenos">334</span></a> <span class="p">]</span> +</span><span id="L-335"><a href="#L-335"><span class="linenos">335</span></a> <span class="k">for</span> <span class="n">column_name</span><span class="p">,</span> <span class="n">column_type</span> <span class="ow">in</span> <span class="n">columns</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> +</span><span id="L-336"><a href="#L-336"><span class="linenos">336</span></a> <span class="n">nested_set</span><span class="p">(</span> +</span><span id="L-337"><a href="#L-337"><span class="linenos">337</span></a> <span class="n">normalized_mapping</span><span class="p">,</span> +</span><span id="L-338"><a href="#L-338"><span class="linenos">338</span></a> <span class="n">normalized_keys</span> <span class="o">+</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">column_name</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">)],</span> +</span><span id="L-339"><a href="#L-339"><span class="linenos">339</span></a> <span class="n">column_type</span><span class="p">,</span> +</span><span id="L-340"><a href="#L-340"><span class="linenos">340</span></a> <span class="p">)</span> +</span><span id="L-341"><a href="#L-341"><span class="linenos">341</span></a> +</span><span id="L-342"><a href="#L-342"><span class="linenos">342</span></a> <span class="k">return</span> <span class="n">normalized_mapping</span> </span><span id="L-343"><a href="#L-343"><span class="linenos">343</span></a> -</span><span id="L-344"><a href="#L-344"><span class="linenos">344</span></a> <span class="c1"># This can be useful for normalize_identifier</span> -</span><span id="L-345"><a href="#L-345"><span class="linenos">345</span></a> <span class="n">identifier</span><span class="o">.</span><span class="n">meta</span><span class="p">[</span><span class="s2">"is_table"</span><span class="p">]</span> <span class="o">=</span> <span class="n">is_table</span> -</span><span id="L-346"><a href="#L-346"><span class="linenos">346</span></a> <span class="k">return</span> <span class="n">Dialect</span><span class="o">.</span><span class="n">get_or_raise</span><span class="p">(</span><span class="n">dialect</span><span class="p">)</span><span class="o">.</span><span class="n">normalize_identifier</span><span class="p">(</span><span class="n">identifier</span><span class="p">)</span><span class="o">.</span><span class="n">name</span> -</span><span id="L-347"><a href="#L-347"><span class="linenos">347</span></a> -</span><span id="L-348"><a href="#L-348"><span class="linenos">348</span></a> <span class="k">def</span> <span class="nf">_depth</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">int</span><span class="p">:</span> -</span><span id="L-349"><a href="#L-349"><span class="linenos">349</span></a> <span class="c1"># The columns themselves are a mapping, but we don't want to include those</span> -</span><span id="L-350"><a href="#L-350"><span class="linenos">350</span></a> <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">_depth</span><span class="p">()</span> <span class="o">-</span> <span class="mi">1</span> -</span><span id="L-351"><a href="#L-351"><span class="linenos">351</span></a> -</span><span id="L-352"><a href="#L-352"><span class="linenos">352</span></a> <span class="k">def</span> <span class="nf">_to_data_type</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">schema_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> -</span><span id="L-353"><a href="#L-353"><span class="linenos">353</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-354"><a href="#L-354"><span class="linenos">354</span></a><span class="sd"> Convert a type represented as a string to the corresponding `sqlglot.exp.DataType` object.</span> -</span><span id="L-355"><a href="#L-355"><span class="linenos">355</span></a> -</span><span id="L-356"><a href="#L-356"><span class="linenos">356</span></a><span class="sd"> Args:</span> -</span><span id="L-357"><a href="#L-357"><span class="linenos">357</span></a><span class="sd"> schema_type: the type we want to convert.</span> -</span><span id="L-358"><a href="#L-358"><span class="linenos">358</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `schema_type`, if needed.</span> -</span><span id="L-359"><a href="#L-359"><span class="linenos">359</span></a> -</span><span id="L-360"><a href="#L-360"><span class="linenos">360</span></a><span class="sd"> Returns:</span> -</span><span id="L-361"><a href="#L-361"><span class="linenos">361</span></a><span class="sd"> The resulting expression type.</span> -</span><span id="L-362"><a href="#L-362"><span class="linenos">362</span></a><span class="sd"> """</span> -</span><span id="L-363"><a href="#L-363"><span class="linenos">363</span></a> <span class="k">if</span> <span class="n">schema_type</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">:</span> -</span><span id="L-364"><a href="#L-364"><span class="linenos">364</span></a> <span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> +</span><span id="L-344"><a href="#L-344"><span class="linenos">344</span></a> <span class="k">def</span> <span class="nf">_normalize_table</span><span class="p">(</span> +</span><span id="L-345"><a href="#L-345"><span class="linenos">345</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="L-346"><a href="#L-346"><span class="linenos">346</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="L-347"><a href="#L-347"><span class="linenos">347</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-348"><a href="#L-348"><span class="linenos">348</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-349"><a href="#L-349"><span class="linenos">349</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">:</span> +</span><span id="L-350"><a href="#L-350"><span class="linenos">350</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">maybe_parse</span><span class="p">(</span> +</span><span id="L-351"><a href="#L-351"><span class="linenos">351</span></a> <span class="n">table</span><span class="p">,</span> <span class="n">into</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">True</span> +</span><span id="L-352"><a href="#L-352"><span class="linenos">352</span></a> <span class="p">)</span> +</span><span id="L-353"><a href="#L-353"><span class="linenos">353</span></a> +</span><span id="L-354"><a href="#L-354"><span class="linenos">354</span></a> <span class="k">for</span> <span class="n">arg</span> <span class="ow">in</span> <span class="n">TABLE_ARGS</span><span class="p">:</span> +</span><span id="L-355"><a href="#L-355"><span class="linenos">355</span></a> <span class="n">value</span> <span class="o">=</span> <span class="n">normalized_table</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">arg</span><span class="p">)</span> +</span><span id="L-356"><a href="#L-356"><span class="linenos">356</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">str</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">)):</span> +</span><span id="L-357"><a href="#L-357"><span class="linenos">357</span></a> <span class="n">normalized_table</span><span class="o">.</span><span class="n">set</span><span class="p">(</span> +</span><span id="L-358"><a href="#L-358"><span class="linenos">358</span></a> <span class="n">arg</span><span class="p">,</span> +</span><span id="L-359"><a href="#L-359"><span class="linenos">359</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span> +</span><span id="L-360"><a href="#L-360"><span class="linenos">360</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span> +</span><span id="L-361"><a href="#L-361"><span class="linenos">361</span></a> <span class="n">value</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">is_table</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span> +</span><span id="L-362"><a href="#L-362"><span class="linenos">362</span></a> <span class="p">)</span> +</span><span id="L-363"><a href="#L-363"><span class="linenos">363</span></a> <span class="p">),</span> +</span><span id="L-364"><a href="#L-364"><span class="linenos">364</span></a> <span class="p">)</span> </span><span id="L-365"><a href="#L-365"><span class="linenos">365</span></a> -</span><span id="L-366"><a href="#L-366"><span class="linenos">366</span></a> <span class="k">try</span><span class="p">:</span> -</span><span id="L-367"><a href="#L-367"><span class="linenos">367</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="n">schema_type</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> -</span><span id="L-368"><a href="#L-368"><span class="linenos">368</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">[</span><span class="n">schema_type</span><span class="p">]</span> <span class="o">=</span> <span class="n">expression</span> -</span><span id="L-369"><a href="#L-369"><span class="linenos">369</span></a> <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span> -</span><span id="L-370"><a href="#L-370"><span class="linenos">370</span></a> <span class="n">in_dialect</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">" in dialect </span><span class="si">{</span><span class="n">dialect</span><span class="si">}</span><span class="s2">"</span> <span class="k">if</span> <span class="n">dialect</span> <span class="k">else</span> <span class="s2">""</span> -</span><span id="L-371"><a href="#L-371"><span class="linenos">371</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Failed to build type '</span><span class="si">{</span><span class="n">schema_type</span><span class="si">}</span><span class="s2">'</span><span class="si">{</span><span class="n">in_dialect</span><span class="si">}</span><span class="s2">."</span><span class="p">)</span> -</span><span id="L-372"><a href="#L-372"><span class="linenos">372</span></a> -</span><span id="L-373"><a href="#L-373"><span class="linenos">373</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">[</span><span class="n">schema_type</span><span class="p">]</span> -</span><span id="L-374"><a href="#L-374"><span class="linenos">374</span></a> -</span><span id="L-375"><a href="#L-375"><span class="linenos">375</span></a> -</span><span id="L-376"><a href="#L-376"><span class="linenos">376</span></a><span class="k">def</span> <span class="nf">ensure_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">:</span> <span class="n">Schema</span> <span class="o">|</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">)</span> <span class="o">-></span> <span class="n">Schema</span><span class="p">:</span> -</span><span id="L-377"><a href="#L-377"><span class="linenos">377</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="n">Schema</span><span class="p">):</span> -</span><span id="L-378"><a href="#L-378"><span class="linenos">378</span></a> <span class="k">return</span> <span class="n">schema</span> -</span><span id="L-379"><a href="#L-379"><span class="linenos">379</span></a> -</span><span id="L-380"><a href="#L-380"><span class="linenos">380</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> -</span><span id="L-381"><a href="#L-381"><span class="linenos">381</span></a> +</span><span id="L-366"><a href="#L-366"><span class="linenos">366</span></a> <span class="k">return</span> <span class="n">normalized_table</span> +</span><span id="L-367"><a href="#L-367"><span class="linenos">367</span></a> +</span><span id="L-368"><a href="#L-368"><span class="linenos">368</span></a> <span class="k">def</span> <span class="nf">_normalize_name</span><span class="p">(</span> +</span><span id="L-369"><a href="#L-369"><span class="linenos">369</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="L-370"><a href="#L-370"><span class="linenos">370</span></a> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">,</span> +</span><span id="L-371"><a href="#L-371"><span class="linenos">371</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-372"><a href="#L-372"><span class="linenos">372</span></a> <span class="n">is_table</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> +</span><span id="L-373"><a href="#L-373"><span class="linenos">373</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="L-374"><a href="#L-374"><span class="linenos">374</span></a> <span class="p">)</span> <span class="o">-></span> <span class="nb">str</span><span class="p">:</span> +</span><span id="L-375"><a href="#L-375"><span class="linenos">375</span></a> <span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> +</span><span id="L-376"><a href="#L-376"><span class="linenos">376</span></a> <span class="n">normalize</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span> <span class="k">if</span> <span class="n">normalize</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">normalize</span> +</span><span id="L-377"><a href="#L-377"><span class="linenos">377</span></a> +</span><span id="L-378"><a href="#L-378"><span class="linenos">378</span></a> <span class="k">try</span><span class="p">:</span> +</span><span id="L-379"><a href="#L-379"><span class="linenos">379</span></a> <span class="n">identifier</span> <span class="o">=</span> <span class="n">sqlglot</span><span class="o">.</span><span class="n">maybe_parse</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">into</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">)</span> +</span><span id="L-380"><a href="#L-380"><span class="linenos">380</span></a> <span class="k">except</span> <span class="n">ParseError</span><span class="p">:</span> +</span><span id="L-381"><a href="#L-381"><span class="linenos">381</span></a> <span class="k">return</span> <span class="n">name</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="k">else</span> <span class="n">name</span><span class="o">.</span><span class="n">name</span> </span><span id="L-382"><a href="#L-382"><span class="linenos">382</span></a> -</span><span id="L-383"><a href="#L-383"><span class="linenos">383</span></a><span class="k">def</span> <span class="nf">ensure_column_mapping</span><span class="p">(</span><span class="n">mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">])</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> -</span><span id="L-384"><a href="#L-384"><span class="linenos">384</span></a> <span class="k">if</span> <span class="n">mapping</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-385"><a href="#L-385"><span class="linenos">385</span></a> <span class="k">return</span> <span class="p">{}</span> -</span><span id="L-386"><a href="#L-386"><span class="linenos">386</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span> -</span><span id="L-387"><a href="#L-387"><span class="linenos">387</span></a> <span class="k">return</span> <span class="n">mapping</span> -</span><span id="L-388"><a href="#L-388"><span class="linenos">388</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> -</span><span id="L-389"><a href="#L-389"><span class="linenos">389</span></a> <span class="n">col_name_type_strs</span> <span class="o">=</span> <span class="p">[</span><span class="n">x</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">mapping</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">","</span><span class="p">)]</span> -</span><span id="L-390"><a href="#L-390"><span class="linenos">390</span></a> <span class="k">return</span> <span class="p">{</span> -</span><span id="L-391"><a href="#L-391"><span class="linenos">391</span></a> <span class="n">name_type_str</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">":"</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">strip</span><span class="p">():</span> <span class="n">name_type_str</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">":"</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> -</span><span id="L-392"><a href="#L-392"><span class="linenos">392</span></a> <span class="k">for</span> <span class="n">name_type_str</span> <span class="ow">in</span> <span class="n">col_name_type_strs</span> -</span><span id="L-393"><a href="#L-393"><span class="linenos">393</span></a> <span class="p">}</span> -</span><span id="L-394"><a href="#L-394"><span class="linenos">394</span></a> <span class="c1"># Check if mapping looks like a DataFrame StructType</span> -</span><span id="L-395"><a href="#L-395"><span class="linenos">395</span></a> <span class="k">elif</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="s2">"simpleString"</span><span class="p">):</span> -</span><span id="L-396"><a href="#L-396"><span class="linenos">396</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">struct_field</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="n">struct_field</span><span class="o">.</span><span class="n">dataType</span><span class="o">.</span><span class="n">simpleString</span><span class="p">()</span> <span class="k">for</span> <span class="n">struct_field</span> <span class="ow">in</span> <span class="n">mapping</span><span class="p">}</span> -</span><span id="L-397"><a href="#L-397"><span class="linenos">397</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span> -</span><span id="L-398"><a href="#L-398"><span class="linenos">398</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">x</span><span class="o">.</span><span class="n">strip</span><span class="p">():</span> <span class="kc">None</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">mapping</span><span class="p">}</span> -</span><span id="L-399"><a href="#L-399"><span class="linenos">399</span></a> -</span><span id="L-400"><a href="#L-400"><span class="linenos">400</span></a> <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Invalid mapping provided: </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">mapping</span><span class="p">)</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="L-401"><a href="#L-401"><span class="linenos">401</span></a> -</span><span id="L-402"><a href="#L-402"><span class="linenos">402</span></a> -</span><span id="L-403"><a href="#L-403"><span class="linenos">403</span></a><span class="k">def</span> <span class="nf">flatten_schema</span><span class="p">(</span> -</span><span id="L-404"><a href="#L-404"><span class="linenos">404</span></a> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="n">depth</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">keys</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-405"><a href="#L-405"><span class="linenos">405</span></a><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]:</span> -</span><span id="L-406"><a href="#L-406"><span class="linenos">406</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-407"><a href="#L-407"><span class="linenos">407</span></a> <span class="n">keys</span> <span class="o">=</span> <span class="n">keys</span> <span class="ow">or</span> <span class="p">[]</span> -</span><span id="L-408"><a href="#L-408"><span class="linenos">408</span></a> -</span><span id="L-409"><a href="#L-409"><span class="linenos">409</span></a> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">schema</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> -</span><span id="L-410"><a href="#L-410"><span class="linenos">410</span></a> <span class="k">if</span> <span class="n">depth</span> <span class="o">>=</span> <span class="mi">2</span><span class="p">:</span> -</span><span id="L-411"><a href="#L-411"><span class="linenos">411</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">flatten_schema</span><span class="p">(</span><span class="n">v</span><span class="p">,</span> <span class="n">depth</span> <span class="o">-</span> <span class="mi">1</span><span class="p">,</span> <span class="n">keys</span> <span class="o">+</span> <span class="p">[</span><span class="n">k</span><span class="p">]))</span> -</span><span id="L-412"><a href="#L-412"><span class="linenos">412</span></a> <span class="k">elif</span> <span class="n">depth</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> -</span><span id="L-413"><a href="#L-413"><span class="linenos">413</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">keys</span> <span class="o">+</span> <span class="p">[</span><span class="n">k</span><span class="p">])</span> -</span><span id="L-414"><a href="#L-414"><span class="linenos">414</span></a> -</span><span id="L-415"><a href="#L-415"><span class="linenos">415</span></a> <span class="k">return</span> <span class="n">tables</span> -</span><span id="L-416"><a href="#L-416"><span class="linenos">416</span></a> +</span><span id="L-383"><a href="#L-383"><span class="linenos">383</span></a> <span class="n">name</span> <span class="o">=</span> <span class="n">identifier</span><span class="o">.</span><span class="n">name</span> +</span><span id="L-384"><a href="#L-384"><span class="linenos">384</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">normalize</span><span class="p">:</span> +</span><span id="L-385"><a href="#L-385"><span class="linenos">385</span></a> <span class="k">return</span> <span class="n">name</span> +</span><span id="L-386"><a href="#L-386"><span class="linenos">386</span></a> +</span><span id="L-387"><a href="#L-387"><span class="linenos">387</span></a> <span class="c1"># This can be useful for normalize_identifier</span> +</span><span id="L-388"><a href="#L-388"><span class="linenos">388</span></a> <span class="n">identifier</span><span class="o">.</span><span class="n">meta</span><span class="p">[</span><span class="s2">"is_table"</span><span class="p">]</span> <span class="o">=</span> <span class="n">is_table</span> +</span><span id="L-389"><a href="#L-389"><span class="linenos">389</span></a> <span class="k">return</span> <span class="n">Dialect</span><span class="o">.</span><span class="n">get_or_raise</span><span class="p">(</span><span class="n">dialect</span><span class="p">)</span><span class="o">.</span><span class="n">normalize_identifier</span><span class="p">(</span><span class="n">identifier</span><span class="p">)</span><span class="o">.</span><span class="n">name</span> +</span><span id="L-390"><a href="#L-390"><span class="linenos">390</span></a> +</span><span id="L-391"><a href="#L-391"><span class="linenos">391</span></a> <span class="k">def</span> <span class="nf">depth</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">int</span><span class="p">:</span> +</span><span id="L-392"><a href="#L-392"><span class="linenos">392</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">empty</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span><span class="p">:</span> +</span><span id="L-393"><a href="#L-393"><span class="linenos">393</span></a> <span class="c1"># The columns themselves are a mapping, but we don't want to include those</span> +</span><span id="L-394"><a href="#L-394"><span class="linenos">394</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span> <span class="o">=</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">depth</span><span class="p">()</span> <span class="o">-</span> <span class="mi">1</span> +</span><span id="L-395"><a href="#L-395"><span class="linenos">395</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span> +</span><span id="L-396"><a href="#L-396"><span class="linenos">396</span></a> +</span><span id="L-397"><a href="#L-397"><span class="linenos">397</span></a> <span class="k">def</span> <span class="nf">_to_data_type</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">schema_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> +</span><span id="L-398"><a href="#L-398"><span class="linenos">398</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-399"><a href="#L-399"><span class="linenos">399</span></a><span class="sd"> Convert a type represented as a string to the corresponding `sqlglot.exp.DataType` object.</span> +</span><span id="L-400"><a href="#L-400"><span class="linenos">400</span></a> +</span><span id="L-401"><a href="#L-401"><span class="linenos">401</span></a><span class="sd"> Args:</span> +</span><span id="L-402"><a href="#L-402"><span class="linenos">402</span></a><span class="sd"> schema_type: the type we want to convert.</span> +</span><span id="L-403"><a href="#L-403"><span class="linenos">403</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `schema_type`, if needed.</span> +</span><span id="L-404"><a href="#L-404"><span class="linenos">404</span></a> +</span><span id="L-405"><a href="#L-405"><span class="linenos">405</span></a><span class="sd"> Returns:</span> +</span><span id="L-406"><a href="#L-406"><span class="linenos">406</span></a><span class="sd"> The resulting expression type.</span> +</span><span id="L-407"><a href="#L-407"><span class="linenos">407</span></a><span class="sd"> """</span> +</span><span id="L-408"><a href="#L-408"><span class="linenos">408</span></a> <span class="k">if</span> <span class="n">schema_type</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">:</span> +</span><span id="L-409"><a href="#L-409"><span class="linenos">409</span></a> <span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> +</span><span id="L-410"><a href="#L-410"><span class="linenos">410</span></a> +</span><span id="L-411"><a href="#L-411"><span class="linenos">411</span></a> <span class="k">try</span><span class="p">:</span> +</span><span id="L-412"><a href="#L-412"><span class="linenos">412</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="n">schema_type</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> +</span><span id="L-413"><a href="#L-413"><span class="linenos">413</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">[</span><span class="n">schema_type</span><span class="p">]</span> <span class="o">=</span> <span class="n">expression</span> +</span><span id="L-414"><a href="#L-414"><span class="linenos">414</span></a> <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span> +</span><span id="L-415"><a href="#L-415"><span class="linenos">415</span></a> <span class="n">in_dialect</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">" in dialect </span><span class="si">{</span><span class="n">dialect</span><span class="si">}</span><span class="s2">"</span> <span class="k">if</span> <span class="n">dialect</span> <span class="k">else</span> <span class="s2">""</span> +</span><span id="L-416"><a href="#L-416"><span class="linenos">416</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Failed to build type '</span><span class="si">{</span><span class="n">schema_type</span><span class="si">}</span><span class="s2">'</span><span class="si">{</span><span class="n">in_dialect</span><span class="si">}</span><span class="s2">."</span><span class="p">)</span> </span><span id="L-417"><a href="#L-417"><span class="linenos">417</span></a> -</span><span id="L-418"><a href="#L-418"><span class="linenos">418</span></a><span class="k">def</span> <span class="nf">nested_get</span><span class="p">(</span> -</span><span id="L-419"><a href="#L-419"><span class="linenos">419</span></a> <span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="o">*</span><span class="n">path</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">],</span> <span class="n">raise_on_missing</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span> -</span><span id="L-420"><a href="#L-420"><span class="linenos">420</span></a><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">]:</span> -</span><span id="L-421"><a href="#L-421"><span class="linenos">421</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-422"><a href="#L-422"><span class="linenos">422</span></a><span class="sd"> Get a value for a nested dictionary.</span> -</span><span id="L-423"><a href="#L-423"><span class="linenos">423</span></a> -</span><span id="L-424"><a href="#L-424"><span class="linenos">424</span></a><span class="sd"> Args:</span> -</span><span id="L-425"><a href="#L-425"><span class="linenos">425</span></a><span class="sd"> d: the dictionary to search.</span> -</span><span id="L-426"><a href="#L-426"><span class="linenos">426</span></a><span class="sd"> *path: tuples of (name, key), where:</span> -</span><span id="L-427"><a href="#L-427"><span class="linenos">427</span></a><span class="sd"> `key` is the key in the dictionary to get.</span> -</span><span id="L-428"><a href="#L-428"><span class="linenos">428</span></a><span class="sd"> `name` is a string to use in the error if `key` isn't found.</span> -</span><span id="L-429"><a href="#L-429"><span class="linenos">429</span></a> -</span><span id="L-430"><a href="#L-430"><span class="linenos">430</span></a><span class="sd"> Returns:</span> -</span><span id="L-431"><a href="#L-431"><span class="linenos">431</span></a><span class="sd"> The value or None if it doesn't exist.</span> -</span><span id="L-432"><a href="#L-432"><span class="linenos">432</span></a><span class="sd"> """</span> -</span><span id="L-433"><a href="#L-433"><span class="linenos">433</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">path</span><span class="p">:</span> -</span><span id="L-434"><a href="#L-434"><span class="linenos">434</span></a> <span class="n">d</span> <span class="o">=</span> <span class="n">d</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">key</span><span class="p">)</span> <span class="c1"># type: ignore</span> -</span><span id="L-435"><a href="#L-435"><span class="linenos">435</span></a> <span class="k">if</span> <span class="n">d</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-436"><a href="#L-436"><span class="linenos">436</span></a> <span class="k">if</span> <span class="n">raise_on_missing</span><span class="p">:</span> -</span><span id="L-437"><a href="#L-437"><span class="linenos">437</span></a> <span class="n">name</span> <span class="o">=</span> <span class="s2">"table"</span> <span class="k">if</span> <span class="n">name</span> <span class="o">==</span> <span class="s2">"this"</span> <span class="k">else</span> <span class="n">name</span> -</span><span id="L-438"><a href="#L-438"><span class="linenos">438</span></a> <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">key</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="L-439"><a href="#L-439"><span class="linenos">439</span></a> <span class="k">return</span> <span class="kc">None</span> -</span><span id="L-440"><a href="#L-440"><span class="linenos">440</span></a> -</span><span id="L-441"><a href="#L-441"><span class="linenos">441</span></a> <span class="k">return</span> <span class="n">d</span> -</span><span id="L-442"><a href="#L-442"><span class="linenos">442</span></a> -</span><span id="L-443"><a href="#L-443"><span class="linenos">443</span></a> -</span><span id="L-444"><a href="#L-444"><span class="linenos">444</span></a><span class="k">def</span> <span class="nf">nested_set</span><span class="p">(</span><span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="n">keys</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">value</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> -</span><span id="L-445"><a href="#L-445"><span class="linenos">445</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-446"><a href="#L-446"><span class="linenos">446</span></a><span class="sd"> In-place set a value for a nested dictionary</span> +</span><span id="L-418"><a href="#L-418"><span class="linenos">418</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">[</span><span class="n">schema_type</span><span class="p">]</span> +</span><span id="L-419"><a href="#L-419"><span class="linenos">419</span></a> +</span><span id="L-420"><a href="#L-420"><span class="linenos">420</span></a> +</span><span id="L-421"><a href="#L-421"><span class="linenos">421</span></a><span class="k">def</span> <span class="nf">ensure_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">:</span> <span class="n">Schema</span> <span class="o">|</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">)</span> <span class="o">-></span> <span class="n">Schema</span><span class="p">:</span> +</span><span id="L-422"><a href="#L-422"><span class="linenos">422</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="n">Schema</span><span class="p">):</span> +</span><span id="L-423"><a href="#L-423"><span class="linenos">423</span></a> <span class="k">return</span> <span class="n">schema</span> +</span><span id="L-424"><a href="#L-424"><span class="linenos">424</span></a> +</span><span id="L-425"><a href="#L-425"><span class="linenos">425</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> +</span><span id="L-426"><a href="#L-426"><span class="linenos">426</span></a> +</span><span id="L-427"><a href="#L-427"><span class="linenos">427</span></a> +</span><span id="L-428"><a href="#L-428"><span class="linenos">428</span></a><span class="k">def</span> <span class="nf">ensure_column_mapping</span><span class="p">(</span><span class="n">mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">])</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> +</span><span id="L-429"><a href="#L-429"><span class="linenos">429</span></a> <span class="k">if</span> <span class="n">mapping</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-430"><a href="#L-430"><span class="linenos">430</span></a> <span class="k">return</span> <span class="p">{}</span> +</span><span id="L-431"><a href="#L-431"><span class="linenos">431</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span> +</span><span id="L-432"><a href="#L-432"><span class="linenos">432</span></a> <span class="k">return</span> <span class="n">mapping</span> +</span><span id="L-433"><a href="#L-433"><span class="linenos">433</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> +</span><span id="L-434"><a href="#L-434"><span class="linenos">434</span></a> <span class="n">col_name_type_strs</span> <span class="o">=</span> <span class="p">[</span><span class="n">x</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">mapping</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">","</span><span class="p">)]</span> +</span><span id="L-435"><a href="#L-435"><span class="linenos">435</span></a> <span class="k">return</span> <span class="p">{</span> +</span><span id="L-436"><a href="#L-436"><span class="linenos">436</span></a> <span class="n">name_type_str</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">":"</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">strip</span><span class="p">():</span> <span class="n">name_type_str</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">":"</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> +</span><span id="L-437"><a href="#L-437"><span class="linenos">437</span></a> <span class="k">for</span> <span class="n">name_type_str</span> <span class="ow">in</span> <span class="n">col_name_type_strs</span> +</span><span id="L-438"><a href="#L-438"><span class="linenos">438</span></a> <span class="p">}</span> +</span><span id="L-439"><a href="#L-439"><span class="linenos">439</span></a> <span class="c1"># Check if mapping looks like a DataFrame StructType</span> +</span><span id="L-440"><a href="#L-440"><span class="linenos">440</span></a> <span class="k">elif</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="s2">"simpleString"</span><span class="p">):</span> +</span><span id="L-441"><a href="#L-441"><span class="linenos">441</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">struct_field</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="n">struct_field</span><span class="o">.</span><span class="n">dataType</span><span class="o">.</span><span class="n">simpleString</span><span class="p">()</span> <span class="k">for</span> <span class="n">struct_field</span> <span class="ow">in</span> <span class="n">mapping</span><span class="p">}</span> +</span><span id="L-442"><a href="#L-442"><span class="linenos">442</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span> +</span><span id="L-443"><a href="#L-443"><span class="linenos">443</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">x</span><span class="o">.</span><span class="n">strip</span><span class="p">():</span> <span class="kc">None</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">mapping</span><span class="p">}</span> +</span><span id="L-444"><a href="#L-444"><span class="linenos">444</span></a> +</span><span id="L-445"><a href="#L-445"><span class="linenos">445</span></a> <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Invalid mapping provided: </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">mapping</span><span class="p">)</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-446"><a href="#L-446"><span class="linenos">446</span></a> </span><span id="L-447"><a href="#L-447"><span class="linenos">447</span></a> -</span><span id="L-448"><a href="#L-448"><span class="linenos">448</span></a><span class="sd"> Example:</span> -</span><span id="L-449"><a href="#L-449"><span class="linenos">449</span></a><span class="sd"> >>> nested_set({}, ["top_key", "second_key"], "value")</span> -</span><span id="L-450"><a href="#L-450"><span class="linenos">450</span></a><span class="sd"> {'top_key': {'second_key': 'value'}}</span> -</span><span id="L-451"><a href="#L-451"><span class="linenos">451</span></a> -</span><span id="L-452"><a href="#L-452"><span class="linenos">452</span></a><span class="sd"> >>> nested_set({"top_key": {"third_key": "third_value"}}, ["top_key", "second_key"], "value")</span> -</span><span id="L-453"><a href="#L-453"><span class="linenos">453</span></a><span class="sd"> {'top_key': {'third_key': 'third_value', 'second_key': 'value'}}</span> -</span><span id="L-454"><a href="#L-454"><span class="linenos">454</span></a> -</span><span id="L-455"><a href="#L-455"><span class="linenos">455</span></a><span class="sd"> Args:</span> -</span><span id="L-456"><a href="#L-456"><span class="linenos">456</span></a><span class="sd"> d: dictionary to update.</span> -</span><span id="L-457"><a href="#L-457"><span class="linenos">457</span></a><span class="sd"> keys: the keys that makeup the path to `value`.</span> -</span><span id="L-458"><a href="#L-458"><span class="linenos">458</span></a><span class="sd"> value: the value to set in the dictionary for the given key path.</span> +</span><span id="L-448"><a href="#L-448"><span class="linenos">448</span></a><span class="k">def</span> <span class="nf">flatten_schema</span><span class="p">(</span> +</span><span id="L-449"><a href="#L-449"><span class="linenos">449</span></a> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="n">depth</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">keys</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-450"><a href="#L-450"><span class="linenos">450</span></a><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]:</span> +</span><span id="L-451"><a href="#L-451"><span class="linenos">451</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-452"><a href="#L-452"><span class="linenos">452</span></a> <span class="n">keys</span> <span class="o">=</span> <span class="n">keys</span> <span class="ow">or</span> <span class="p">[]</span> +</span><span id="L-453"><a href="#L-453"><span class="linenos">453</span></a> +</span><span id="L-454"><a href="#L-454"><span class="linenos">454</span></a> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">schema</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> +</span><span id="L-455"><a href="#L-455"><span class="linenos">455</span></a> <span class="k">if</span> <span class="n">depth</span> <span class="o">>=</span> <span class="mi">2</span><span class="p">:</span> +</span><span id="L-456"><a href="#L-456"><span class="linenos">456</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">flatten_schema</span><span class="p">(</span><span class="n">v</span><span class="p">,</span> <span class="n">depth</span> <span class="o">-</span> <span class="mi">1</span><span class="p">,</span> <span class="n">keys</span> <span class="o">+</span> <span class="p">[</span><span class="n">k</span><span class="p">]))</span> +</span><span id="L-457"><a href="#L-457"><span class="linenos">457</span></a> <span class="k">elif</span> <span class="n">depth</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> +</span><span id="L-458"><a href="#L-458"><span class="linenos">458</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">keys</span> <span class="o">+</span> <span class="p">[</span><span class="n">k</span><span class="p">])</span> </span><span id="L-459"><a href="#L-459"><span class="linenos">459</span></a> -</span><span id="L-460"><a href="#L-460"><span class="linenos">460</span></a><span class="sd"> Returns:</span> -</span><span id="L-461"><a href="#L-461"><span class="linenos">461</span></a><span class="sd"> The (possibly) updated dictionary.</span> -</span><span id="L-462"><a href="#L-462"><span class="linenos">462</span></a><span class="sd"> """</span> -</span><span id="L-463"><a href="#L-463"><span class="linenos">463</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">keys</span><span class="p">:</span> -</span><span id="L-464"><a href="#L-464"><span class="linenos">464</span></a> <span class="k">return</span> <span class="n">d</span> -</span><span id="L-465"><a href="#L-465"><span class="linenos">465</span></a> -</span><span id="L-466"><a href="#L-466"><span class="linenos">466</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">keys</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> -</span><span id="L-467"><a href="#L-467"><span class="linenos">467</span></a> <span class="n">d</span><span class="p">[</span><span class="n">keys</span><span class="p">[</span><span class="mi">0</span><span class="p">]]</span> <span class="o">=</span> <span class="n">value</span> -</span><span id="L-468"><a href="#L-468"><span class="linenos">468</span></a> <span class="k">return</span> <span class="n">d</span> -</span><span id="L-469"><a href="#L-469"><span class="linenos">469</span></a> -</span><span id="L-470"><a href="#L-470"><span class="linenos">470</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">d</span> -</span><span id="L-471"><a href="#L-471"><span class="linenos">471</span></a> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">keys</span><span class="p">[:</span><span class="o">-</span><span class="mi">1</span><span class="p">]:</span> -</span><span id="L-472"><a href="#L-472"><span class="linenos">472</span></a> <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">subd</span><span class="p">:</span> -</span><span id="L-473"><a href="#L-473"><span class="linenos">473</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">subd</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="p">{})</span> -</span><span id="L-474"><a href="#L-474"><span class="linenos">474</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="L-475"><a href="#L-475"><span class="linenos">475</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">subd</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> -</span><span id="L-476"><a href="#L-476"><span class="linenos">476</span></a> -</span><span id="L-477"><a href="#L-477"><span class="linenos">477</span></a> <span class="n">subd</span><span class="p">[</span><span class="n">keys</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]]</span> <span class="o">=</span> <span class="n">value</span> -</span><span id="L-478"><a href="#L-478"><span class="linenos">478</span></a> <span class="k">return</span> <span class="n">d</span> +</span><span id="L-460"><a href="#L-460"><span class="linenos">460</span></a> <span class="k">return</span> <span class="n">tables</span> +</span><span id="L-461"><a href="#L-461"><span class="linenos">461</span></a> +</span><span id="L-462"><a href="#L-462"><span class="linenos">462</span></a> +</span><span id="L-463"><a href="#L-463"><span class="linenos">463</span></a><span class="k">def</span> <span class="nf">nested_get</span><span class="p">(</span> +</span><span id="L-464"><a href="#L-464"><span class="linenos">464</span></a> <span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="o">*</span><span class="n">path</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">],</span> <span class="n">raise_on_missing</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span> +</span><span id="L-465"><a href="#L-465"><span class="linenos">465</span></a><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">]:</span> +</span><span id="L-466"><a href="#L-466"><span class="linenos">466</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-467"><a href="#L-467"><span class="linenos">467</span></a><span class="sd"> Get a value for a nested dictionary.</span> +</span><span id="L-468"><a href="#L-468"><span class="linenos">468</span></a> +</span><span id="L-469"><a href="#L-469"><span class="linenos">469</span></a><span class="sd"> Args:</span> +</span><span id="L-470"><a href="#L-470"><span class="linenos">470</span></a><span class="sd"> d: the dictionary to search.</span> +</span><span id="L-471"><a href="#L-471"><span class="linenos">471</span></a><span class="sd"> *path: tuples of (name, key), where:</span> +</span><span id="L-472"><a href="#L-472"><span class="linenos">472</span></a><span class="sd"> `key` is the key in the dictionary to get.</span> +</span><span id="L-473"><a href="#L-473"><span class="linenos">473</span></a><span class="sd"> `name` is a string to use in the error if `key` isn't found.</span> +</span><span id="L-474"><a href="#L-474"><span class="linenos">474</span></a> +</span><span id="L-475"><a href="#L-475"><span class="linenos">475</span></a><span class="sd"> Returns:</span> +</span><span id="L-476"><a href="#L-476"><span class="linenos">476</span></a><span class="sd"> The value or None if it doesn't exist.</span> +</span><span id="L-477"><a href="#L-477"><span class="linenos">477</span></a><span class="sd"> """</span> +</span><span id="L-478"><a href="#L-478"><span class="linenos">478</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">path</span><span class="p">:</span> +</span><span id="L-479"><a href="#L-479"><span class="linenos">479</span></a> <span class="n">d</span> <span class="o">=</span> <span class="n">d</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">key</span><span class="p">)</span> <span class="c1"># type: ignore</span> +</span><span id="L-480"><a href="#L-480"><span class="linenos">480</span></a> <span class="k">if</span> <span class="n">d</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-481"><a href="#L-481"><span class="linenos">481</span></a> <span class="k">if</span> <span class="n">raise_on_missing</span><span class="p">:</span> +</span><span id="L-482"><a href="#L-482"><span class="linenos">482</span></a> <span class="n">name</span> <span class="o">=</span> <span class="s2">"table"</span> <span class="k">if</span> <span class="n">name</span> <span class="o">==</span> <span class="s2">"this"</span> <span class="k">else</span> <span class="n">name</span> +</span><span id="L-483"><a href="#L-483"><span class="linenos">483</span></a> <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">key</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-484"><a href="#L-484"><span class="linenos">484</span></a> <span class="k">return</span> <span class="kc">None</span> +</span><span id="L-485"><a href="#L-485"><span class="linenos">485</span></a> +</span><span id="L-486"><a href="#L-486"><span class="linenos">486</span></a> <span class="k">return</span> <span class="n">d</span> +</span><span id="L-487"><a href="#L-487"><span class="linenos">487</span></a> +</span><span id="L-488"><a href="#L-488"><span class="linenos">488</span></a> +</span><span id="L-489"><a href="#L-489"><span class="linenos">489</span></a><span class="k">def</span> <span class="nf">nested_set</span><span class="p">(</span><span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="n">keys</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">value</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> +</span><span id="L-490"><a href="#L-490"><span class="linenos">490</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-491"><a href="#L-491"><span class="linenos">491</span></a><span class="sd"> In-place set a value for a nested dictionary</span> +</span><span id="L-492"><a href="#L-492"><span class="linenos">492</span></a> +</span><span id="L-493"><a href="#L-493"><span class="linenos">493</span></a><span class="sd"> Example:</span> +</span><span id="L-494"><a href="#L-494"><span class="linenos">494</span></a><span class="sd"> >>> nested_set({}, ["top_key", "second_key"], "value")</span> +</span><span id="L-495"><a href="#L-495"><span class="linenos">495</span></a><span class="sd"> {'top_key': {'second_key': 'value'}}</span> +</span><span id="L-496"><a href="#L-496"><span class="linenos">496</span></a> +</span><span id="L-497"><a href="#L-497"><span class="linenos">497</span></a><span class="sd"> >>> nested_set({"top_key": {"third_key": "third_value"}}, ["top_key", "second_key"], "value")</span> +</span><span id="L-498"><a href="#L-498"><span class="linenos">498</span></a><span class="sd"> {'top_key': {'third_key': 'third_value', 'second_key': 'value'}}</span> +</span><span id="L-499"><a href="#L-499"><span class="linenos">499</span></a> +</span><span id="L-500"><a href="#L-500"><span class="linenos">500</span></a><span class="sd"> Args:</span> +</span><span id="L-501"><a href="#L-501"><span class="linenos">501</span></a><span class="sd"> d: dictionary to update.</span> +</span><span id="L-502"><a href="#L-502"><span class="linenos">502</span></a><span class="sd"> keys: the keys that makeup the path to `value`.</span> +</span><span id="L-503"><a href="#L-503"><span class="linenos">503</span></a><span class="sd"> value: the value to set in the dictionary for the given key path.</span> +</span><span id="L-504"><a href="#L-504"><span class="linenos">504</span></a> +</span><span id="L-505"><a href="#L-505"><span class="linenos">505</span></a><span class="sd"> Returns:</span> +</span><span id="L-506"><a href="#L-506"><span class="linenos">506</span></a><span class="sd"> The (possibly) updated dictionary.</span> +</span><span id="L-507"><a href="#L-507"><span class="linenos">507</span></a><span class="sd"> """</span> +</span><span id="L-508"><a href="#L-508"><span class="linenos">508</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">keys</span><span class="p">:</span> +</span><span id="L-509"><a href="#L-509"><span class="linenos">509</span></a> <span class="k">return</span> <span class="n">d</span> +</span><span id="L-510"><a href="#L-510"><span class="linenos">510</span></a> +</span><span id="L-511"><a href="#L-511"><span class="linenos">511</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">keys</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> +</span><span id="L-512"><a href="#L-512"><span class="linenos">512</span></a> <span class="n">d</span><span class="p">[</span><span class="n">keys</span><span class="p">[</span><span class="mi">0</span><span class="p">]]</span> <span class="o">=</span> <span class="n">value</span> +</span><span id="L-513"><a href="#L-513"><span class="linenos">513</span></a> <span class="k">return</span> <span class="n">d</span> +</span><span id="L-514"><a href="#L-514"><span class="linenos">514</span></a> +</span><span id="L-515"><a href="#L-515"><span class="linenos">515</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">d</span> +</span><span id="L-516"><a href="#L-516"><span class="linenos">516</span></a> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">keys</span><span class="p">[:</span><span class="o">-</span><span class="mi">1</span><span class="p">]:</span> +</span><span id="L-517"><a href="#L-517"><span class="linenos">517</span></a> <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">subd</span><span class="p">:</span> +</span><span id="L-518"><a href="#L-518"><span class="linenos">518</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">subd</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="p">{})</span> +</span><span id="L-519"><a href="#L-519"><span class="linenos">519</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="L-520"><a href="#L-520"><span class="linenos">520</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">subd</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> +</span><span id="L-521"><a href="#L-521"><span class="linenos">521</span></a> +</span><span id="L-522"><a href="#L-522"><span class="linenos">522</span></a> <span class="n">subd</span><span class="p">[</span><span class="n">keys</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]]</span> <span class="o">=</span> <span class="n">value</span> +</span><span id="L-523"><a href="#L-523"><span class="linenos">523</span></a> <span class="k">return</span> <span class="n">d</span> </span></pre></div> @@ -651,76 +702,85 @@ </div> <a class="headerlink" href="#Schema"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Schema-24"><a href="#Schema-24"><span class="linenos">24</span></a><span class="k">class</span> <span class="nc">Schema</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABC</span><span class="p">):</span> -</span><span id="Schema-25"><a href="#Schema-25"><span class="linenos">25</span></a><span class="w"> </span><span class="sd">"""Abstract base class for database schemas"""</span> -</span><span id="Schema-26"><a href="#Schema-26"><span class="linenos">26</span></a> -</span><span id="Schema-27"><a href="#Schema-27"><span class="linenos">27</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> -</span><span id="Schema-28"><a href="#Schema-28"><span class="linenos">28</span></a> -</span><span id="Schema-29"><a href="#Schema-29"><span class="linenos">29</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> -</span><span id="Schema-30"><a href="#Schema-30"><span class="linenos">30</span></a> <span class="k">def</span> <span class="nf">add_table</span><span class="p">(</span> -</span><span id="Schema-31"><a href="#Schema-31"><span class="linenos">31</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="Schema-32"><a href="#Schema-32"><span class="linenos">32</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="Schema-33"><a href="#Schema-33"><span class="linenos">33</span></a> <span class="n">column_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="Schema-34"><a href="#Schema-34"><span class="linenos">34</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="Schema-35"><a href="#Schema-35"><span class="linenos">35</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="Schema-36"><a href="#Schema-36"><span class="linenos">36</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Schema-37"><a href="#Schema-37"><span class="linenos">37</span></a><span class="sd"> Register or update a table. Some implementing classes may require column information to also be provided.</span> -</span><span id="Schema-38"><a href="#Schema-38"><span class="linenos">38</span></a> -</span><span id="Schema-39"><a href="#Schema-39"><span class="linenos">39</span></a><span class="sd"> Args:</span> -</span><span id="Schema-40"><a href="#Schema-40"><span class="linenos">40</span></a><span class="sd"> table: the `Table` expression instance or string representing the table.</span> -</span><span id="Schema-41"><a href="#Schema-41"><span class="linenos">41</span></a><span class="sd"> column_mapping: a column mapping that describes the structure of the table.</span> -</span><span id="Schema-42"><a href="#Schema-42"><span class="linenos">42</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> -</span><span id="Schema-43"><a href="#Schema-43"><span class="linenos">43</span></a><span class="sd"> """</span> -</span><span id="Schema-44"><a href="#Schema-44"><span class="linenos">44</span></a> -</span><span id="Schema-45"><a href="#Schema-45"><span class="linenos">45</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> -</span><span id="Schema-46"><a href="#Schema-46"><span class="linenos">46</span></a> <span class="k">def</span> <span class="nf">column_names</span><span class="p">(</span> -</span><span id="Schema-47"><a href="#Schema-47"><span class="linenos">47</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="Schema-48"><a href="#Schema-48"><span class="linenos">48</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="Schema-49"><a href="#Schema-49"><span class="linenos">49</span></a> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> -</span><span id="Schema-50"><a href="#Schema-50"><span class="linenos">50</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="Schema-51"><a href="#Schema-51"><span class="linenos">51</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> -</span><span id="Schema-52"><a href="#Schema-52"><span class="linenos">52</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Schema-53"><a href="#Schema-53"><span class="linenos">53</span></a><span class="sd"> Get the column names for a table.</span> -</span><span id="Schema-54"><a href="#Schema-54"><span class="linenos">54</span></a> -</span><span id="Schema-55"><a href="#Schema-55"><span class="linenos">55</span></a><span class="sd"> Args:</span> -</span><span id="Schema-56"><a href="#Schema-56"><span class="linenos">56</span></a><span class="sd"> table: the `Table` expression instance.</span> -</span><span id="Schema-57"><a href="#Schema-57"><span class="linenos">57</span></a><span class="sd"> only_visible: whether to include invisible columns.</span> -</span><span id="Schema-58"><a href="#Schema-58"><span class="linenos">58</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> -</span><span id="Schema-59"><a href="#Schema-59"><span class="linenos">59</span></a> -</span><span id="Schema-60"><a href="#Schema-60"><span class="linenos">60</span></a><span class="sd"> Returns:</span> -</span><span id="Schema-61"><a href="#Schema-61"><span class="linenos">61</span></a><span class="sd"> The list of column names.</span> -</span><span id="Schema-62"><a href="#Schema-62"><span class="linenos">62</span></a><span class="sd"> """</span> -</span><span id="Schema-63"><a href="#Schema-63"><span class="linenos">63</span></a> -</span><span id="Schema-64"><a href="#Schema-64"><span class="linenos">64</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> -</span><span id="Schema-65"><a href="#Schema-65"><span class="linenos">65</span></a> <span class="k">def</span> <span class="nf">get_column_type</span><span class="p">(</span> -</span><span id="Schema-66"><a href="#Schema-66"><span class="linenos">66</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="Schema-67"><a href="#Schema-67"><span class="linenos">67</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="Schema-68"><a href="#Schema-68"><span class="linenos">68</span></a> <span class="n">column</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">,</span> -</span><span id="Schema-69"><a href="#Schema-69"><span class="linenos">69</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="Schema-70"><a href="#Schema-70"><span class="linenos">70</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> -</span><span id="Schema-71"><a href="#Schema-71"><span class="linenos">71</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Schema-72"><a href="#Schema-72"><span class="linenos">72</span></a><span class="sd"> Get the `sqlglot.exp.DataType` type of a column in the schema.</span> -</span><span id="Schema-73"><a href="#Schema-73"><span class="linenos">73</span></a> -</span><span id="Schema-74"><a href="#Schema-74"><span class="linenos">74</span></a><span class="sd"> Args:</span> -</span><span id="Schema-75"><a href="#Schema-75"><span class="linenos">75</span></a><span class="sd"> table: the source table.</span> -</span><span id="Schema-76"><a href="#Schema-76"><span class="linenos">76</span></a><span class="sd"> column: the target column.</span> -</span><span id="Schema-77"><a href="#Schema-77"><span class="linenos">77</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> -</span><span id="Schema-78"><a href="#Schema-78"><span class="linenos">78</span></a> -</span><span id="Schema-79"><a href="#Schema-79"><span class="linenos">79</span></a><span class="sd"> Returns:</span> -</span><span id="Schema-80"><a href="#Schema-80"><span class="linenos">80</span></a><span class="sd"> The resulting column type.</span> -</span><span id="Schema-81"><a href="#Schema-81"><span class="linenos">81</span></a><span class="sd"> """</span> -</span><span id="Schema-82"><a href="#Schema-82"><span class="linenos">82</span></a> -</span><span id="Schema-83"><a href="#Schema-83"><span class="linenos">83</span></a> <span class="nd">@property</span> -</span><span id="Schema-84"><a href="#Schema-84"><span class="linenos">84</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> -</span><span id="Schema-85"><a href="#Schema-85"><span class="linenos">85</span></a> <span class="k">def</span> <span class="nf">supported_table_args</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]:</span> -</span><span id="Schema-86"><a href="#Schema-86"><span class="linenos">86</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Schema-87"><a href="#Schema-87"><span class="linenos">87</span></a><span class="sd"> Table arguments this schema support, e.g. `("this", "db", "catalog")`</span> -</span><span id="Schema-88"><a href="#Schema-88"><span class="linenos">88</span></a><span class="sd"> """</span> -</span><span id="Schema-89"><a href="#Schema-89"><span class="linenos">89</span></a> -</span><span id="Schema-90"><a href="#Schema-90"><span class="linenos">90</span></a> <span class="nd">@property</span> -</span><span id="Schema-91"><a href="#Schema-91"><span class="linenos">91</span></a> <span class="k">def</span> <span class="nf">empty</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span><span class="p">:</span> -</span><span id="Schema-92"><a href="#Schema-92"><span class="linenos">92</span></a><span class="w"> </span><span class="sd">"""Returns whether or not the schema is empty."""</span> -</span><span id="Schema-93"><a href="#Schema-93"><span class="linenos">93</span></a> <span class="k">return</span> <span class="kc">True</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Schema-24"><a href="#Schema-24"><span class="linenos"> 24</span></a><span class="k">class</span> <span class="nc">Schema</span><span class="p">(</span><span class="n">abc</span><span class="o">.</span><span class="n">ABC</span><span class="p">):</span> +</span><span id="Schema-25"><a href="#Schema-25"><span class="linenos"> 25</span></a><span class="w"> </span><span class="sd">"""Abstract base class for database schemas"""</span> +</span><span id="Schema-26"><a href="#Schema-26"><span class="linenos"> 26</span></a> +</span><span id="Schema-27"><a href="#Schema-27"><span class="linenos"> 27</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> +</span><span id="Schema-28"><a href="#Schema-28"><span class="linenos"> 28</span></a> +</span><span id="Schema-29"><a href="#Schema-29"><span class="linenos"> 29</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> +</span><span id="Schema-30"><a href="#Schema-30"><span class="linenos"> 30</span></a> <span class="k">def</span> <span class="nf">add_table</span><span class="p">(</span> +</span><span id="Schema-31"><a href="#Schema-31"><span class="linenos"> 31</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="Schema-32"><a href="#Schema-32"><span class="linenos"> 32</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="Schema-33"><a href="#Schema-33"><span class="linenos"> 33</span></a> <span class="n">column_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema-34"><a href="#Schema-34"><span class="linenos"> 34</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema-35"><a href="#Schema-35"><span class="linenos"> 35</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema-36"><a href="#Schema-36"><span class="linenos"> 36</span></a> <span class="n">match_depth</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> +</span><span id="Schema-37"><a href="#Schema-37"><span class="linenos"> 37</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="Schema-38"><a href="#Schema-38"><span class="linenos"> 38</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Schema-39"><a href="#Schema-39"><span class="linenos"> 39</span></a><span class="sd"> Register or update a table. Some implementing classes may require column information to also be provided.</span> +</span><span id="Schema-40"><a href="#Schema-40"><span class="linenos"> 40</span></a><span class="sd"> The added table must have the necessary number of qualifiers in its path to match the schema's nesting level.</span> +</span><span id="Schema-41"><a href="#Schema-41"><span class="linenos"> 41</span></a> +</span><span id="Schema-42"><a href="#Schema-42"><span class="linenos"> 42</span></a><span class="sd"> Args:</span> +</span><span id="Schema-43"><a href="#Schema-43"><span class="linenos"> 43</span></a><span class="sd"> table: the `Table` expression instance or string representing the table.</span> +</span><span id="Schema-44"><a href="#Schema-44"><span class="linenos"> 44</span></a><span class="sd"> column_mapping: a column mapping that describes the structure of the table.</span> +</span><span id="Schema-45"><a href="#Schema-45"><span class="linenos"> 45</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> +</span><span id="Schema-46"><a href="#Schema-46"><span class="linenos"> 46</span></a><span class="sd"> normalize: whether to normalize identifiers according to the dialect of interest.</span> +</span><span id="Schema-47"><a href="#Schema-47"><span class="linenos"> 47</span></a><span class="sd"> match_depth: whether to enforce that the table must match the schema's depth or not.</span> +</span><span id="Schema-48"><a href="#Schema-48"><span class="linenos"> 48</span></a><span class="sd"> """</span> +</span><span id="Schema-49"><a href="#Schema-49"><span class="linenos"> 49</span></a> +</span><span id="Schema-50"><a href="#Schema-50"><span class="linenos"> 50</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> +</span><span id="Schema-51"><a href="#Schema-51"><span class="linenos"> 51</span></a> <span class="k">def</span> <span class="nf">column_names</span><span class="p">(</span> +</span><span id="Schema-52"><a href="#Schema-52"><span class="linenos"> 52</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="Schema-53"><a href="#Schema-53"><span class="linenos"> 53</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="Schema-54"><a href="#Schema-54"><span class="linenos"> 54</span></a> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> +</span><span id="Schema-55"><a href="#Schema-55"><span class="linenos"> 55</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema-56"><a href="#Schema-56"><span class="linenos"> 56</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema-57"><a href="#Schema-57"><span class="linenos"> 57</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> +</span><span id="Schema-58"><a href="#Schema-58"><span class="linenos"> 58</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Schema-59"><a href="#Schema-59"><span class="linenos"> 59</span></a><span class="sd"> Get the column names for a table.</span> +</span><span id="Schema-60"><a href="#Schema-60"><span class="linenos"> 60</span></a> +</span><span id="Schema-61"><a href="#Schema-61"><span class="linenos"> 61</span></a><span class="sd"> Args:</span> +</span><span id="Schema-62"><a href="#Schema-62"><span class="linenos"> 62</span></a><span class="sd"> table: the `Table` expression instance.</span> +</span><span id="Schema-63"><a href="#Schema-63"><span class="linenos"> 63</span></a><span class="sd"> only_visible: whether to include invisible columns.</span> +</span><span id="Schema-64"><a href="#Schema-64"><span class="linenos"> 64</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> +</span><span id="Schema-65"><a href="#Schema-65"><span class="linenos"> 65</span></a><span class="sd"> normalize: whether to normalize identifiers according to the dialect of interest.</span> +</span><span id="Schema-66"><a href="#Schema-66"><span class="linenos"> 66</span></a> +</span><span id="Schema-67"><a href="#Schema-67"><span class="linenos"> 67</span></a><span class="sd"> Returns:</span> +</span><span id="Schema-68"><a href="#Schema-68"><span class="linenos"> 68</span></a><span class="sd"> The list of column names.</span> +</span><span id="Schema-69"><a href="#Schema-69"><span class="linenos"> 69</span></a><span class="sd"> """</span> +</span><span id="Schema-70"><a href="#Schema-70"><span class="linenos"> 70</span></a> +</span><span id="Schema-71"><a href="#Schema-71"><span class="linenos"> 71</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> +</span><span id="Schema-72"><a href="#Schema-72"><span class="linenos"> 72</span></a> <span class="k">def</span> <span class="nf">get_column_type</span><span class="p">(</span> +</span><span id="Schema-73"><a href="#Schema-73"><span class="linenos"> 73</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="Schema-74"><a href="#Schema-74"><span class="linenos"> 74</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="Schema-75"><a href="#Schema-75"><span class="linenos"> 75</span></a> <span class="n">column</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">,</span> +</span><span id="Schema-76"><a href="#Schema-76"><span class="linenos"> 76</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema-77"><a href="#Schema-77"><span class="linenos"> 77</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema-78"><a href="#Schema-78"><span class="linenos"> 78</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> +</span><span id="Schema-79"><a href="#Schema-79"><span class="linenos"> 79</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Schema-80"><a href="#Schema-80"><span class="linenos"> 80</span></a><span class="sd"> Get the `sqlglot.exp.DataType` type of a column in the schema.</span> +</span><span id="Schema-81"><a href="#Schema-81"><span class="linenos"> 81</span></a> +</span><span id="Schema-82"><a href="#Schema-82"><span class="linenos"> 82</span></a><span class="sd"> Args:</span> +</span><span id="Schema-83"><a href="#Schema-83"><span class="linenos"> 83</span></a><span class="sd"> table: the source table.</span> +</span><span id="Schema-84"><a href="#Schema-84"><span class="linenos"> 84</span></a><span class="sd"> column: the target column.</span> +</span><span id="Schema-85"><a href="#Schema-85"><span class="linenos"> 85</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> +</span><span id="Schema-86"><a href="#Schema-86"><span class="linenos"> 86</span></a><span class="sd"> normalize: whether to normalize identifiers according to the dialect of interest.</span> +</span><span id="Schema-87"><a href="#Schema-87"><span class="linenos"> 87</span></a> +</span><span id="Schema-88"><a href="#Schema-88"><span class="linenos"> 88</span></a><span class="sd"> Returns:</span> +</span><span id="Schema-89"><a href="#Schema-89"><span class="linenos"> 89</span></a><span class="sd"> The resulting column type.</span> +</span><span id="Schema-90"><a href="#Schema-90"><span class="linenos"> 90</span></a><span class="sd"> """</span> +</span><span id="Schema-91"><a href="#Schema-91"><span class="linenos"> 91</span></a> +</span><span id="Schema-92"><a href="#Schema-92"><span class="linenos"> 92</span></a> <span class="nd">@property</span> +</span><span id="Schema-93"><a href="#Schema-93"><span class="linenos"> 93</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> +</span><span id="Schema-94"><a href="#Schema-94"><span class="linenos"> 94</span></a> <span class="k">def</span> <span class="nf">supported_table_args</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]:</span> +</span><span id="Schema-95"><a href="#Schema-95"><span class="linenos"> 95</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Schema-96"><a href="#Schema-96"><span class="linenos"> 96</span></a><span class="sd"> Table arguments this schema support, e.g. `("this", "db", "catalog")`</span> +</span><span id="Schema-97"><a href="#Schema-97"><span class="linenos"> 97</span></a><span class="sd"> """</span> +</span><span id="Schema-98"><a href="#Schema-98"><span class="linenos"> 98</span></a> +</span><span id="Schema-99"><a href="#Schema-99"><span class="linenos"> 99</span></a> <span class="nd">@property</span> +</span><span id="Schema-100"><a href="#Schema-100"><span class="linenos">100</span></a> <span class="k">def</span> <span class="nf">empty</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span><span class="p">:</span> +</span><span id="Schema-101"><a href="#Schema-101"><span class="linenos">101</span></a><span class="w"> </span><span class="sd">"""Returns whether or not the schema is empty."""</span> +</span><span id="Schema-102"><a href="#Schema-102"><span class="linenos">102</span></a> <span class="k">return</span> <span class="kc">True</span> </span></pre></div> @@ -745,7 +805,7 @@ <div class="decorator">@abc.abstractmethod</div> <span class="def">def</span> - <span class="name">add_table</span><span class="signature pdoc-code multiline">(<span class="param"> <span class="bp">self</span>,</span><span class="param"> <span class="n">table</span><span class="p">:</span> <span class="n"><a href="expressions.html#Table">sqlglot.expressions.Table</a></span> <span class="o">|</span> <span class="nb">str</span>,</span><span class="param"> <span class="n">column_mapping</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">Dict</span><span class="p">,</span> <span class="nb">str</span><span class="p">,</span> <span class="n">sqlglot</span><span class="o">.</span><span class="n">dataframe</span><span class="o">.</span><span class="n">sql</span><span class="o">.</span><span class="n">types</span><span class="o">.</span><span class="n">StructType</span><span class="p">,</span> <span class="n">List</span><span class="p">,</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">dialect</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">,</span> <span class="n">Type</span><span class="p">[</span><span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">],</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span></span><span class="return-annotation">) -> <span class="kc">None</span>:</span></span> + <span class="name">add_table</span><span class="signature pdoc-code multiline">(<span class="param"> <span class="bp">self</span>,</span><span class="param"> <span class="n">table</span><span class="p">:</span> <span class="n"><a href="expressions.html#Table">sqlglot.expressions.Table</a></span> <span class="o">|</span> <span class="nb">str</span>,</span><span class="param"> <span class="n">column_mapping</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">Dict</span><span class="p">,</span> <span class="nb">str</span><span class="p">,</span> <span class="n">sqlglot</span><span class="o">.</span><span class="n">dataframe</span><span class="o">.</span><span class="n">sql</span><span class="o">.</span><span class="n">types</span><span class="o">.</span><span class="n">StructType</span><span class="p">,</span> <span class="n">List</span><span class="p">,</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">dialect</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">,</span> <span class="n">Type</span><span class="p">[</span><span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">],</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">normalize</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">match_depth</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span></span><span class="return-annotation">) -> <span class="kc">None</span>:</span></span> <label class="view-source-button" for="Schema.add_table-view-source"><span>View Source</span></label> @@ -757,19 +817,25 @@ </span><span id="Schema.add_table-32"><a href="#Schema.add_table-32"><span class="linenos">32</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> </span><span id="Schema.add_table-33"><a href="#Schema.add_table-33"><span class="linenos">33</span></a> <span class="n">column_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> </span><span id="Schema.add_table-34"><a href="#Schema.add_table-34"><span class="linenos">34</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="Schema.add_table-35"><a href="#Schema.add_table-35"><span class="linenos">35</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="Schema.add_table-36"><a href="#Schema.add_table-36"><span class="linenos">36</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Schema.add_table-37"><a href="#Schema.add_table-37"><span class="linenos">37</span></a><span class="sd"> Register or update a table. Some implementing classes may require column information to also be provided.</span> -</span><span id="Schema.add_table-38"><a href="#Schema.add_table-38"><span class="linenos">38</span></a> -</span><span id="Schema.add_table-39"><a href="#Schema.add_table-39"><span class="linenos">39</span></a><span class="sd"> Args:</span> -</span><span id="Schema.add_table-40"><a href="#Schema.add_table-40"><span class="linenos">40</span></a><span class="sd"> table: the `Table` expression instance or string representing the table.</span> -</span><span id="Schema.add_table-41"><a href="#Schema.add_table-41"><span class="linenos">41</span></a><span class="sd"> column_mapping: a column mapping that describes the structure of the table.</span> -</span><span id="Schema.add_table-42"><a href="#Schema.add_table-42"><span class="linenos">42</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> -</span><span id="Schema.add_table-43"><a href="#Schema.add_table-43"><span class="linenos">43</span></a><span class="sd"> """</span> +</span><span id="Schema.add_table-35"><a href="#Schema.add_table-35"><span class="linenos">35</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema.add_table-36"><a href="#Schema.add_table-36"><span class="linenos">36</span></a> <span class="n">match_depth</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> +</span><span id="Schema.add_table-37"><a href="#Schema.add_table-37"><span class="linenos">37</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="Schema.add_table-38"><a href="#Schema.add_table-38"><span class="linenos">38</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Schema.add_table-39"><a href="#Schema.add_table-39"><span class="linenos">39</span></a><span class="sd"> Register or update a table. Some implementing classes may require column information to also be provided.</span> +</span><span id="Schema.add_table-40"><a href="#Schema.add_table-40"><span class="linenos">40</span></a><span class="sd"> The added table must have the necessary number of qualifiers in its path to match the schema's nesting level.</span> +</span><span id="Schema.add_table-41"><a href="#Schema.add_table-41"><span class="linenos">41</span></a> +</span><span id="Schema.add_table-42"><a href="#Schema.add_table-42"><span class="linenos">42</span></a><span class="sd"> Args:</span> +</span><span id="Schema.add_table-43"><a href="#Schema.add_table-43"><span class="linenos">43</span></a><span class="sd"> table: the `Table` expression instance or string representing the table.</span> +</span><span id="Schema.add_table-44"><a href="#Schema.add_table-44"><span class="linenos">44</span></a><span class="sd"> column_mapping: a column mapping that describes the structure of the table.</span> +</span><span id="Schema.add_table-45"><a href="#Schema.add_table-45"><span class="linenos">45</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> +</span><span id="Schema.add_table-46"><a href="#Schema.add_table-46"><span class="linenos">46</span></a><span class="sd"> normalize: whether to normalize identifiers according to the dialect of interest.</span> +</span><span id="Schema.add_table-47"><a href="#Schema.add_table-47"><span class="linenos">47</span></a><span class="sd"> match_depth: whether to enforce that the table must match the schema's depth or not.</span> +</span><span id="Schema.add_table-48"><a href="#Schema.add_table-48"><span class="linenos">48</span></a><span class="sd"> """</span> </span></pre></div> - <div class="docstring"><p>Register or update a table. Some implementing classes may require column information to also be provided.</p> + <div class="docstring"><p>Register or update a table. Some implementing classes may require column information to also be provided. +The added table must have the necessary number of qualifiers in its path to match the schema's nesting level.</p> <h6 id="arguments">Arguments:</h6> @@ -777,6 +843,8 @@ <li><strong>table:</strong> the <code>Table</code> expression instance or string representing the table.</li> <li><strong>column_mapping:</strong> a column mapping that describes the structure of the table.</li> <li><strong>dialect:</strong> the SQL dialect that will be used to parse <code>table</code> if it's a string.</li> +<li><strong>normalize:</strong> whether to normalize identifiers according to the dialect of interest.</li> +<li><strong>match_depth:</strong> whether to enforce that the table must match the schema's depth or not.</li> </ul> </div> @@ -788,30 +856,32 @@ <div class="decorator">@abc.abstractmethod</div> <span class="def">def</span> - <span class="name">column_names</span><span class="signature pdoc-code multiline">(<span class="param"> <span class="bp">self</span>,</span><span class="param"> <span class="n">table</span><span class="p">:</span> <span class="n"><a href="expressions.html#Table">sqlglot.expressions.Table</a></span> <span class="o">|</span> <span class="nb">str</span>,</span><span class="param"> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>,</span><span class="param"> <span class="n">dialect</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">,</span> <span class="n">Type</span><span class="p">[</span><span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">],</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span></span><span class="return-annotation">) -> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>:</span></span> + <span class="name">column_names</span><span class="signature pdoc-code multiline">(<span class="param"> <span class="bp">self</span>,</span><span class="param"> <span class="n">table</span><span class="p">:</span> <span class="n"><a href="expressions.html#Table">sqlglot.expressions.Table</a></span> <span class="o">|</span> <span class="nb">str</span>,</span><span class="param"> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>,</span><span class="param"> <span class="n">dialect</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">,</span> <span class="n">Type</span><span class="p">[</span><span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">],</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">normalize</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span></span><span class="return-annotation">) -> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>:</span></span> <label class="view-source-button" for="Schema.column_names-view-source"><span>View Source</span></label> </div> <a class="headerlink" href="#Schema.column_names"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Schema.column_names-45"><a href="#Schema.column_names-45"><span class="linenos">45</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> -</span><span id="Schema.column_names-46"><a href="#Schema.column_names-46"><span class="linenos">46</span></a> <span class="k">def</span> <span class="nf">column_names</span><span class="p">(</span> -</span><span id="Schema.column_names-47"><a href="#Schema.column_names-47"><span class="linenos">47</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="Schema.column_names-48"><a href="#Schema.column_names-48"><span class="linenos">48</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="Schema.column_names-49"><a href="#Schema.column_names-49"><span class="linenos">49</span></a> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> -</span><span id="Schema.column_names-50"><a href="#Schema.column_names-50"><span class="linenos">50</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="Schema.column_names-51"><a href="#Schema.column_names-51"><span class="linenos">51</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> -</span><span id="Schema.column_names-52"><a href="#Schema.column_names-52"><span class="linenos">52</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Schema.column_names-53"><a href="#Schema.column_names-53"><span class="linenos">53</span></a><span class="sd"> Get the column names for a table.</span> -</span><span id="Schema.column_names-54"><a href="#Schema.column_names-54"><span class="linenos">54</span></a> -</span><span id="Schema.column_names-55"><a href="#Schema.column_names-55"><span class="linenos">55</span></a><span class="sd"> Args:</span> -</span><span id="Schema.column_names-56"><a href="#Schema.column_names-56"><span class="linenos">56</span></a><span class="sd"> table: the `Table` expression instance.</span> -</span><span id="Schema.column_names-57"><a href="#Schema.column_names-57"><span class="linenos">57</span></a><span class="sd"> only_visible: whether to include invisible columns.</span> -</span><span id="Schema.column_names-58"><a href="#Schema.column_names-58"><span class="linenos">58</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> -</span><span id="Schema.column_names-59"><a href="#Schema.column_names-59"><span class="linenos">59</span></a> -</span><span id="Schema.column_names-60"><a href="#Schema.column_names-60"><span class="linenos">60</span></a><span class="sd"> Returns:</span> -</span><span id="Schema.column_names-61"><a href="#Schema.column_names-61"><span class="linenos">61</span></a><span class="sd"> The list of column names.</span> -</span><span id="Schema.column_names-62"><a href="#Schema.column_names-62"><span class="linenos">62</span></a><span class="sd"> """</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Schema.column_names-50"><a href="#Schema.column_names-50"><span class="linenos">50</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> +</span><span id="Schema.column_names-51"><a href="#Schema.column_names-51"><span class="linenos">51</span></a> <span class="k">def</span> <span class="nf">column_names</span><span class="p">(</span> +</span><span id="Schema.column_names-52"><a href="#Schema.column_names-52"><span class="linenos">52</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="Schema.column_names-53"><a href="#Schema.column_names-53"><span class="linenos">53</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="Schema.column_names-54"><a href="#Schema.column_names-54"><span class="linenos">54</span></a> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> +</span><span id="Schema.column_names-55"><a href="#Schema.column_names-55"><span class="linenos">55</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema.column_names-56"><a href="#Schema.column_names-56"><span class="linenos">56</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema.column_names-57"><a href="#Schema.column_names-57"><span class="linenos">57</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> +</span><span id="Schema.column_names-58"><a href="#Schema.column_names-58"><span class="linenos">58</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Schema.column_names-59"><a href="#Schema.column_names-59"><span class="linenos">59</span></a><span class="sd"> Get the column names for a table.</span> +</span><span id="Schema.column_names-60"><a href="#Schema.column_names-60"><span class="linenos">60</span></a> +</span><span id="Schema.column_names-61"><a href="#Schema.column_names-61"><span class="linenos">61</span></a><span class="sd"> Args:</span> +</span><span id="Schema.column_names-62"><a href="#Schema.column_names-62"><span class="linenos">62</span></a><span class="sd"> table: the `Table` expression instance.</span> +</span><span id="Schema.column_names-63"><a href="#Schema.column_names-63"><span class="linenos">63</span></a><span class="sd"> only_visible: whether to include invisible columns.</span> +</span><span id="Schema.column_names-64"><a href="#Schema.column_names-64"><span class="linenos">64</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> +</span><span id="Schema.column_names-65"><a href="#Schema.column_names-65"><span class="linenos">65</span></a><span class="sd"> normalize: whether to normalize identifiers according to the dialect of interest.</span> +</span><span id="Schema.column_names-66"><a href="#Schema.column_names-66"><span class="linenos">66</span></a> +</span><span id="Schema.column_names-67"><a href="#Schema.column_names-67"><span class="linenos">67</span></a><span class="sd"> Returns:</span> +</span><span id="Schema.column_names-68"><a href="#Schema.column_names-68"><span class="linenos">68</span></a><span class="sd"> The list of column names.</span> +</span><span id="Schema.column_names-69"><a href="#Schema.column_names-69"><span class="linenos">69</span></a><span class="sd"> """</span> </span></pre></div> @@ -823,6 +893,7 @@ <li><strong>table:</strong> the <code>Table</code> expression instance.</li> <li><strong>only_visible:</strong> whether to include invisible columns.</li> <li><strong>dialect:</strong> the SQL dialect that will be used to parse <code>table</code> if it's a string.</li> +<li><strong>normalize:</strong> whether to normalize identifiers according to the dialect of interest.</li> </ul> <h6 id="returns">Returns:</h6> @@ -840,30 +911,32 @@ <div class="decorator">@abc.abstractmethod</div> <span class="def">def</span> - <span class="name">get_column_type</span><span class="signature pdoc-code multiline">(<span class="param"> <span class="bp">self</span>,</span><span class="param"> <span class="n">table</span><span class="p">:</span> <span class="n"><a href="expressions.html#Table">sqlglot.expressions.Table</a></span> <span class="o">|</span> <span class="nb">str</span>,</span><span class="param"> <span class="n">column</span><span class="p">:</span> <span class="n"><a href="expressions.html#Column">sqlglot.expressions.Column</a></span>,</span><span class="param"> <span class="n">dialect</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">,</span> <span class="n">Type</span><span class="p">[</span><span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">],</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span></span><span class="return-annotation">) -> <span class="n"><a href="expressions.html#DataType">sqlglot.expressions.DataType</a></span>:</span></span> + <span class="name">get_column_type</span><span class="signature pdoc-code multiline">(<span class="param"> <span class="bp">self</span>,</span><span class="param"> <span class="n">table</span><span class="p">:</span> <span class="n"><a href="expressions.html#Table">sqlglot.expressions.Table</a></span> <span class="o">|</span> <span class="nb">str</span>,</span><span class="param"> <span class="n">column</span><span class="p">:</span> <span class="n"><a href="expressions.html#Column">sqlglot.expressions.Column</a></span>,</span><span class="param"> <span class="n">dialect</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">,</span> <span class="n">Type</span><span class="p">[</span><span class="n"><a href="dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">],</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">normalize</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span></span><span class="return-annotation">) -> <span class="n"><a href="expressions.html#DataType">sqlglot.expressions.DataType</a></span>:</span></span> <label class="view-source-button" for="Schema.get_column_type-view-source"><span>View Source</span></label> </div> <a class="headerlink" href="#Schema.get_column_type"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Schema.get_column_type-64"><a href="#Schema.get_column_type-64"><span class="linenos">64</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> -</span><span id="Schema.get_column_type-65"><a href="#Schema.get_column_type-65"><span class="linenos">65</span></a> <span class="k">def</span> <span class="nf">get_column_type</span><span class="p">(</span> -</span><span id="Schema.get_column_type-66"><a href="#Schema.get_column_type-66"><span class="linenos">66</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="Schema.get_column_type-67"><a href="#Schema.get_column_type-67"><span class="linenos">67</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="Schema.get_column_type-68"><a href="#Schema.get_column_type-68"><span class="linenos">68</span></a> <span class="n">column</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">,</span> -</span><span id="Schema.get_column_type-69"><a href="#Schema.get_column_type-69"><span class="linenos">69</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="Schema.get_column_type-70"><a href="#Schema.get_column_type-70"><span class="linenos">70</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> -</span><span id="Schema.get_column_type-71"><a href="#Schema.get_column_type-71"><span class="linenos">71</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Schema.get_column_type-72"><a href="#Schema.get_column_type-72"><span class="linenos">72</span></a><span class="sd"> Get the `sqlglot.exp.DataType` type of a column in the schema.</span> -</span><span id="Schema.get_column_type-73"><a href="#Schema.get_column_type-73"><span class="linenos">73</span></a> -</span><span id="Schema.get_column_type-74"><a href="#Schema.get_column_type-74"><span class="linenos">74</span></a><span class="sd"> Args:</span> -</span><span id="Schema.get_column_type-75"><a href="#Schema.get_column_type-75"><span class="linenos">75</span></a><span class="sd"> table: the source table.</span> -</span><span id="Schema.get_column_type-76"><a href="#Schema.get_column_type-76"><span class="linenos">76</span></a><span class="sd"> column: the target column.</span> -</span><span id="Schema.get_column_type-77"><a href="#Schema.get_column_type-77"><span class="linenos">77</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> -</span><span id="Schema.get_column_type-78"><a href="#Schema.get_column_type-78"><span class="linenos">78</span></a> -</span><span id="Schema.get_column_type-79"><a href="#Schema.get_column_type-79"><span class="linenos">79</span></a><span class="sd"> Returns:</span> -</span><span id="Schema.get_column_type-80"><a href="#Schema.get_column_type-80"><span class="linenos">80</span></a><span class="sd"> The resulting column type.</span> -</span><span id="Schema.get_column_type-81"><a href="#Schema.get_column_type-81"><span class="linenos">81</span></a><span class="sd"> """</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Schema.get_column_type-71"><a href="#Schema.get_column_type-71"><span class="linenos">71</span></a> <span class="nd">@abc</span><span class="o">.</span><span class="n">abstractmethod</span> +</span><span id="Schema.get_column_type-72"><a href="#Schema.get_column_type-72"><span class="linenos">72</span></a> <span class="k">def</span> <span class="nf">get_column_type</span><span class="p">(</span> +</span><span id="Schema.get_column_type-73"><a href="#Schema.get_column_type-73"><span class="linenos">73</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="Schema.get_column_type-74"><a href="#Schema.get_column_type-74"><span class="linenos">74</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="Schema.get_column_type-75"><a href="#Schema.get_column_type-75"><span class="linenos">75</span></a> <span class="n">column</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">,</span> +</span><span id="Schema.get_column_type-76"><a href="#Schema.get_column_type-76"><span class="linenos">76</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema.get_column_type-77"><a href="#Schema.get_column_type-77"><span class="linenos">77</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="Schema.get_column_type-78"><a href="#Schema.get_column_type-78"><span class="linenos">78</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> +</span><span id="Schema.get_column_type-79"><a href="#Schema.get_column_type-79"><span class="linenos">79</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Schema.get_column_type-80"><a href="#Schema.get_column_type-80"><span class="linenos">80</span></a><span class="sd"> Get the `sqlglot.exp.DataType` type of a column in the schema.</span> +</span><span id="Schema.get_column_type-81"><a href="#Schema.get_column_type-81"><span class="linenos">81</span></a> +</span><span id="Schema.get_column_type-82"><a href="#Schema.get_column_type-82"><span class="linenos">82</span></a><span class="sd"> Args:</span> +</span><span id="Schema.get_column_type-83"><a href="#Schema.get_column_type-83"><span class="linenos">83</span></a><span class="sd"> table: the source table.</span> +</span><span id="Schema.get_column_type-84"><a href="#Schema.get_column_type-84"><span class="linenos">84</span></a><span class="sd"> column: the target column.</span> +</span><span id="Schema.get_column_type-85"><a href="#Schema.get_column_type-85"><span class="linenos">85</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> +</span><span id="Schema.get_column_type-86"><a href="#Schema.get_column_type-86"><span class="linenos">86</span></a><span class="sd"> normalize: whether to normalize identifiers according to the dialect of interest.</span> +</span><span id="Schema.get_column_type-87"><a href="#Schema.get_column_type-87"><span class="linenos">87</span></a> +</span><span id="Schema.get_column_type-88"><a href="#Schema.get_column_type-88"><span class="linenos">88</span></a><span class="sd"> Returns:</span> +</span><span id="Schema.get_column_type-89"><a href="#Schema.get_column_type-89"><span class="linenos">89</span></a><span class="sd"> The resulting column type.</span> +</span><span id="Schema.get_column_type-90"><a href="#Schema.get_column_type-90"><span class="linenos">90</span></a><span class="sd"> """</span> </span></pre></div> @@ -875,6 +948,7 @@ <li><strong>table:</strong> the source table.</li> <li><strong>column:</strong> the target column.</li> <li><strong>dialect:</strong> the SQL dialect that will be used to parse <code>table</code> if it's a string.</li> +<li><strong>normalize:</strong> whether to normalize identifiers according to the dialect of interest.</li> </ul> <h6 id="returns">Returns:</h6> @@ -924,73 +998,73 @@ </div> <a class="headerlink" href="#AbstractMappingSchema"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="AbstractMappingSchema-96"><a href="#AbstractMappingSchema-96"><span class="linenos"> 96</span></a><span class="k">class</span> <span class="nc">AbstractMappingSchema</span><span class="p">(</span><span class="n">t</span><span class="o">.</span><span class="n">Generic</span><span class="p">[</span><span class="n">T</span><span class="p">]):</span> -</span><span id="AbstractMappingSchema-97"><a href="#AbstractMappingSchema-97"><span class="linenos"> 97</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> -</span><span id="AbstractMappingSchema-98"><a href="#AbstractMappingSchema-98"><span class="linenos"> 98</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="AbstractMappingSchema-99"><a href="#AbstractMappingSchema-99"><span class="linenos"> 99</span></a> <span class="n">mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="AbstractMappingSchema-100"><a href="#AbstractMappingSchema-100"><span class="linenos">100</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="AbstractMappingSchema-101"><a href="#AbstractMappingSchema-101"><span class="linenos">101</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span> <span class="o">=</span> <span class="n">mapping</span> <span class="ow">or</span> <span class="p">{}</span> -</span><span id="AbstractMappingSchema-102"><a href="#AbstractMappingSchema-102"><span class="linenos">102</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="o">=</span> <span class="n">new_trie</span><span class="p">(</span> -</span><span id="AbstractMappingSchema-103"><a href="#AbstractMappingSchema-103"><span class="linenos">103</span></a> <span class="nb">tuple</span><span class="p">(</span><span class="nb">reversed</span><span class="p">(</span><span class="n">t</span><span class="p">))</span> <span class="k">for</span> <span class="n">t</span> <span class="ow">in</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_depth</span><span class="p">())</span> -</span><span id="AbstractMappingSchema-104"><a href="#AbstractMappingSchema-104"><span class="linenos">104</span></a> <span class="p">)</span> -</span><span id="AbstractMappingSchema-105"><a href="#AbstractMappingSchema-105"><span class="linenos">105</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">()</span> -</span><span id="AbstractMappingSchema-106"><a href="#AbstractMappingSchema-106"><span class="linenos">106</span></a> -</span><span id="AbstractMappingSchema-107"><a href="#AbstractMappingSchema-107"><span class="linenos">107</span></a> <span class="nd">@property</span> -</span><span id="AbstractMappingSchema-108"><a href="#AbstractMappingSchema-108"><span class="linenos">108</span></a> <span class="k">def</span> <span class="nf">empty</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span><span class="p">:</span> -</span><span id="AbstractMappingSchema-109"><a href="#AbstractMappingSchema-109"><span class="linenos">109</span></a> <span class="k">return</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span> -</span><span id="AbstractMappingSchema-110"><a href="#AbstractMappingSchema-110"><span class="linenos">110</span></a> -</span><span id="AbstractMappingSchema-111"><a href="#AbstractMappingSchema-111"><span class="linenos">111</span></a> <span class="k">def</span> <span class="nf">_depth</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">int</span><span class="p">:</span> -</span><span id="AbstractMappingSchema-112"><a href="#AbstractMappingSchema-112"><span class="linenos">112</span></a> <span class="k">return</span> <span class="n">dict_depth</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">)</span> -</span><span id="AbstractMappingSchema-113"><a href="#AbstractMappingSchema-113"><span class="linenos">113</span></a> -</span><span id="AbstractMappingSchema-114"><a href="#AbstractMappingSchema-114"><span class="linenos">114</span></a> <span class="nd">@property</span> -</span><span id="AbstractMappingSchema-115"><a href="#AbstractMappingSchema-115"><span class="linenos">115</span></a> <span class="k">def</span> <span class="nf">supported_table_args</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]:</span> -</span><span id="AbstractMappingSchema-116"><a href="#AbstractMappingSchema-116"><span class="linenos">116</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">:</span> -</span><span id="AbstractMappingSchema-117"><a href="#AbstractMappingSchema-117"><span class="linenos">117</span></a> <span class="n">depth</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span><span class="p">()</span> -</span><span id="AbstractMappingSchema-118"><a href="#AbstractMappingSchema-118"><span class="linenos">118</span></a> -</span><span id="AbstractMappingSchema-119"><a href="#AbstractMappingSchema-119"><span class="linenos">119</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">depth</span><span class="p">:</span> <span class="c1"># None</span> -</span><span id="AbstractMappingSchema-120"><a href="#AbstractMappingSchema-120"><span class="linenos">120</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">()</span> -</span><span id="AbstractMappingSchema-121"><a href="#AbstractMappingSchema-121"><span class="linenos">121</span></a> <span class="k">elif</span> <span class="mi">1</span> <span class="o"><=</span> <span class="n">depth</span> <span class="o"><=</span> <span class="mi">3</span><span class="p">:</span> -</span><span id="AbstractMappingSchema-122"><a href="#AbstractMappingSchema-122"><span class="linenos">122</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="o">=</span> <span class="n">TABLE_ARGS</span><span class="p">[:</span><span class="n">depth</span><span class="p">]</span> -</span><span id="AbstractMappingSchema-123"><a href="#AbstractMappingSchema-123"><span class="linenos">123</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="AbstractMappingSchema-124"><a href="#AbstractMappingSchema-124"><span class="linenos">124</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Invalid mapping shape. Depth: </span><span class="si">{</span><span class="n">depth</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="AbstractMappingSchema-125"><a href="#AbstractMappingSchema-125"><span class="linenos">125</span></a> -</span><span id="AbstractMappingSchema-126"><a href="#AbstractMappingSchema-126"><span class="linenos">126</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="AbstractMappingSchema-105"><a href="#AbstractMappingSchema-105"><span class="linenos">105</span></a><span class="k">class</span> <span class="nc">AbstractMappingSchema</span><span class="p">(</span><span class="n">t</span><span class="o">.</span><span class="n">Generic</span><span class="p">[</span><span class="n">T</span><span class="p">]):</span> +</span><span id="AbstractMappingSchema-106"><a href="#AbstractMappingSchema-106"><span class="linenos">106</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> +</span><span id="AbstractMappingSchema-107"><a href="#AbstractMappingSchema-107"><span class="linenos">107</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="AbstractMappingSchema-108"><a href="#AbstractMappingSchema-108"><span class="linenos">108</span></a> <span class="n">mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="AbstractMappingSchema-109"><a href="#AbstractMappingSchema-109"><span class="linenos">109</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="AbstractMappingSchema-110"><a href="#AbstractMappingSchema-110"><span class="linenos">110</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span> <span class="o">=</span> <span class="n">mapping</span> <span class="ow">or</span> <span class="p">{}</span> +</span><span id="AbstractMappingSchema-111"><a href="#AbstractMappingSchema-111"><span class="linenos">111</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="o">=</span> <span class="n">new_trie</span><span class="p">(</span> +</span><span id="AbstractMappingSchema-112"><a href="#AbstractMappingSchema-112"><span class="linenos">112</span></a> <span class="nb">tuple</span><span class="p">(</span><span class="nb">reversed</span><span class="p">(</span><span class="n">t</span><span class="p">))</span> <span class="k">for</span> <span class="n">t</span> <span class="ow">in</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">depth</span><span class="p">())</span> +</span><span id="AbstractMappingSchema-113"><a href="#AbstractMappingSchema-113"><span class="linenos">113</span></a> <span class="p">)</span> +</span><span id="AbstractMappingSchema-114"><a href="#AbstractMappingSchema-114"><span class="linenos">114</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">()</span> +</span><span id="AbstractMappingSchema-115"><a href="#AbstractMappingSchema-115"><span class="linenos">115</span></a> +</span><span id="AbstractMappingSchema-116"><a href="#AbstractMappingSchema-116"><span class="linenos">116</span></a> <span class="nd">@property</span> +</span><span id="AbstractMappingSchema-117"><a href="#AbstractMappingSchema-117"><span class="linenos">117</span></a> <span class="k">def</span> <span class="nf">empty</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span><span class="p">:</span> +</span><span id="AbstractMappingSchema-118"><a href="#AbstractMappingSchema-118"><span class="linenos">118</span></a> <span class="k">return</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span> +</span><span id="AbstractMappingSchema-119"><a href="#AbstractMappingSchema-119"><span class="linenos">119</span></a> +</span><span id="AbstractMappingSchema-120"><a href="#AbstractMappingSchema-120"><span class="linenos">120</span></a> <span class="k">def</span> <span class="nf">depth</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">int</span><span class="p">:</span> +</span><span id="AbstractMappingSchema-121"><a href="#AbstractMappingSchema-121"><span class="linenos">121</span></a> <span class="k">return</span> <span class="n">dict_depth</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">)</span> +</span><span id="AbstractMappingSchema-122"><a href="#AbstractMappingSchema-122"><span class="linenos">122</span></a> +</span><span id="AbstractMappingSchema-123"><a href="#AbstractMappingSchema-123"><span class="linenos">123</span></a> <span class="nd">@property</span> +</span><span id="AbstractMappingSchema-124"><a href="#AbstractMappingSchema-124"><span class="linenos">124</span></a> <span class="k">def</span> <span class="nf">supported_table_args</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]:</span> +</span><span id="AbstractMappingSchema-125"><a href="#AbstractMappingSchema-125"><span class="linenos">125</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">:</span> +</span><span id="AbstractMappingSchema-126"><a href="#AbstractMappingSchema-126"><span class="linenos">126</span></a> <span class="n">depth</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">depth</span><span class="p">()</span> </span><span id="AbstractMappingSchema-127"><a href="#AbstractMappingSchema-127"><span class="linenos">127</span></a> -</span><span id="AbstractMappingSchema-128"><a href="#AbstractMappingSchema-128"><span class="linenos">128</span></a> <span class="k">def</span> <span class="nf">table_parts</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> -</span><span id="AbstractMappingSchema-129"><a href="#AbstractMappingSchema-129"><span class="linenos">129</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">ReadCSV</span><span class="p">):</span> -</span><span id="AbstractMappingSchema-130"><a href="#AbstractMappingSchema-130"><span class="linenos">130</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> -</span><span id="AbstractMappingSchema-131"><a href="#AbstractMappingSchema-131"><span class="linenos">131</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)</span> <span class="k">for</span> <span class="n">part</span> <span class="ow">in</span> <span class="n">TABLE_ARGS</span> <span class="k">if</span> <span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)]</span> -</span><span id="AbstractMappingSchema-132"><a href="#AbstractMappingSchema-132"><span class="linenos">132</span></a> -</span><span id="AbstractMappingSchema-133"><a href="#AbstractMappingSchema-133"><span class="linenos">133</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span> -</span><span id="AbstractMappingSchema-134"><a href="#AbstractMappingSchema-134"><span class="linenos">134</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">,</span> <span class="n">trie</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span> -</span><span id="AbstractMappingSchema-135"><a href="#AbstractMappingSchema-135"><span class="linenos">135</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">T</span><span class="p">]:</span> -</span><span id="AbstractMappingSchema-136"><a href="#AbstractMappingSchema-136"><span class="linenos">136</span></a> <span class="n">parts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">table</span><span class="p">)[</span><span class="mi">0</span> <span class="p">:</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">)]</span> -</span><span id="AbstractMappingSchema-137"><a href="#AbstractMappingSchema-137"><span class="linenos">137</span></a> <span class="n">value</span><span class="p">,</span> <span class="n">trie</span> <span class="o">=</span> <span class="n">in_trie</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="k">if</span> <span class="n">trie</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">trie</span><span class="p">,</span> <span class="n">parts</span><span class="p">)</span> -</span><span id="AbstractMappingSchema-138"><a href="#AbstractMappingSchema-138"><span class="linenos">138</span></a> -</span><span id="AbstractMappingSchema-139"><a href="#AbstractMappingSchema-139"><span class="linenos">139</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">FAILED</span><span class="p">:</span> -</span><span id="AbstractMappingSchema-140"><a href="#AbstractMappingSchema-140"><span class="linenos">140</span></a> <span class="k">return</span> <span class="kc">None</span> +</span><span id="AbstractMappingSchema-128"><a href="#AbstractMappingSchema-128"><span class="linenos">128</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">depth</span><span class="p">:</span> <span class="c1"># None</span> +</span><span id="AbstractMappingSchema-129"><a href="#AbstractMappingSchema-129"><span class="linenos">129</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">()</span> +</span><span id="AbstractMappingSchema-130"><a href="#AbstractMappingSchema-130"><span class="linenos">130</span></a> <span class="k">elif</span> <span class="mi">1</span> <span class="o"><=</span> <span class="n">depth</span> <span class="o"><=</span> <span class="mi">3</span><span class="p">:</span> +</span><span id="AbstractMappingSchema-131"><a href="#AbstractMappingSchema-131"><span class="linenos">131</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> <span class="o">=</span> <span class="n">TABLE_ARGS</span><span class="p">[:</span><span class="n">depth</span><span class="p">]</span> +</span><span id="AbstractMappingSchema-132"><a href="#AbstractMappingSchema-132"><span class="linenos">132</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="AbstractMappingSchema-133"><a href="#AbstractMappingSchema-133"><span class="linenos">133</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Invalid mapping shape. Depth: </span><span class="si">{</span><span class="n">depth</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="AbstractMappingSchema-134"><a href="#AbstractMappingSchema-134"><span class="linenos">134</span></a> +</span><span id="AbstractMappingSchema-135"><a href="#AbstractMappingSchema-135"><span class="linenos">135</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span> +</span><span id="AbstractMappingSchema-136"><a href="#AbstractMappingSchema-136"><span class="linenos">136</span></a> +</span><span id="AbstractMappingSchema-137"><a href="#AbstractMappingSchema-137"><span class="linenos">137</span></a> <span class="k">def</span> <span class="nf">table_parts</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> +</span><span id="AbstractMappingSchema-138"><a href="#AbstractMappingSchema-138"><span class="linenos">138</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">ReadCSV</span><span class="p">):</span> +</span><span id="AbstractMappingSchema-139"><a href="#AbstractMappingSchema-139"><span class="linenos">139</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> +</span><span id="AbstractMappingSchema-140"><a href="#AbstractMappingSchema-140"><span class="linenos">140</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)</span> <span class="k">for</span> <span class="n">part</span> <span class="ow">in</span> <span class="n">TABLE_ARGS</span> <span class="k">if</span> <span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)]</span> </span><span id="AbstractMappingSchema-141"><a href="#AbstractMappingSchema-141"><span class="linenos">141</span></a> -</span><span id="AbstractMappingSchema-142"><a href="#AbstractMappingSchema-142"><span class="linenos">142</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">PREFIX</span><span class="p">:</span> -</span><span id="AbstractMappingSchema-143"><a href="#AbstractMappingSchema-143"><span class="linenos">143</span></a> <span class="n">possibilities</span> <span class="o">=</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="n">trie</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">dict_depth</span><span class="p">(</span><span class="n">trie</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> -</span><span id="AbstractMappingSchema-144"><a href="#AbstractMappingSchema-144"><span class="linenos">144</span></a> -</span><span id="AbstractMappingSchema-145"><a href="#AbstractMappingSchema-145"><span class="linenos">145</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">possibilities</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> -</span><span id="AbstractMappingSchema-146"><a href="#AbstractMappingSchema-146"><span class="linenos">146</span></a> <span class="n">parts</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">possibilities</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span> -</span><span id="AbstractMappingSchema-147"><a href="#AbstractMappingSchema-147"><span class="linenos">147</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="AbstractMappingSchema-148"><a href="#AbstractMappingSchema-148"><span class="linenos">148</span></a> <span class="n">message</span> <span class="o">=</span> <span class="s2">", "</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s2">"."</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">parts</span><span class="p">)</span> <span class="k">for</span> <span class="n">parts</span> <span class="ow">in</span> <span class="n">possibilities</span><span class="p">)</span> -</span><span id="AbstractMappingSchema-149"><a href="#AbstractMappingSchema-149"><span class="linenos">149</span></a> <span class="k">if</span> <span class="n">raise_on_missing</span><span class="p">:</span> -</span><span id="AbstractMappingSchema-150"><a href="#AbstractMappingSchema-150"><span class="linenos">150</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ambiguous mapping for </span><span class="si">{</span><span class="n">table</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">message</span><span class="si">}</span><span class="s2">."</span><span class="p">)</span> -</span><span id="AbstractMappingSchema-151"><a href="#AbstractMappingSchema-151"><span class="linenos">151</span></a> <span class="k">return</span> <span class="kc">None</span> -</span><span id="AbstractMappingSchema-152"><a href="#AbstractMappingSchema-152"><span class="linenos">152</span></a> -</span><span id="AbstractMappingSchema-153"><a href="#AbstractMappingSchema-153"><span class="linenos">153</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">nested_get</span><span class="p">(</span><span class="n">parts</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">)</span> -</span><span id="AbstractMappingSchema-154"><a href="#AbstractMappingSchema-154"><span class="linenos">154</span></a> -</span><span id="AbstractMappingSchema-155"><a href="#AbstractMappingSchema-155"><span class="linenos">155</span></a> <span class="k">def</span> <span class="nf">nested_get</span><span class="p">(</span> -</span><span id="AbstractMappingSchema-156"><a href="#AbstractMappingSchema-156"><span class="linenos">156</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">parts</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">True</span> -</span><span id="AbstractMappingSchema-157"><a href="#AbstractMappingSchema-157"><span class="linenos">157</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">]:</span> -</span><span id="AbstractMappingSchema-158"><a href="#AbstractMappingSchema-158"><span class="linenos">158</span></a> <span class="k">return</span> <span class="n">nested_get</span><span class="p">(</span> -</span><span id="AbstractMappingSchema-159"><a href="#AbstractMappingSchema-159"><span class="linenos">159</span></a> <span class="n">d</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> -</span><span id="AbstractMappingSchema-160"><a href="#AbstractMappingSchema-160"><span class="linenos">160</span></a> <span class="o">*</span><span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">,</span> <span class="nb">reversed</span><span class="p">(</span><span class="n">parts</span><span class="p">)),</span> -</span><span id="AbstractMappingSchema-161"><a href="#AbstractMappingSchema-161"><span class="linenos">161</span></a> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">,</span> -</span><span id="AbstractMappingSchema-162"><a href="#AbstractMappingSchema-162"><span class="linenos">162</span></a> <span class="p">)</span> +</span><span id="AbstractMappingSchema-142"><a href="#AbstractMappingSchema-142"><span class="linenos">142</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span> +</span><span id="AbstractMappingSchema-143"><a href="#AbstractMappingSchema-143"><span class="linenos">143</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">,</span> <span class="n">trie</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span> +</span><span id="AbstractMappingSchema-144"><a href="#AbstractMappingSchema-144"><span class="linenos">144</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">T</span><span class="p">]:</span> +</span><span id="AbstractMappingSchema-145"><a href="#AbstractMappingSchema-145"><span class="linenos">145</span></a> <span class="n">parts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">table</span><span class="p">)[</span><span class="mi">0</span> <span class="p">:</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">)]</span> +</span><span id="AbstractMappingSchema-146"><a href="#AbstractMappingSchema-146"><span class="linenos">146</span></a> <span class="n">value</span><span class="p">,</span> <span class="n">trie</span> <span class="o">=</span> <span class="n">in_trie</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="k">if</span> <span class="n">trie</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">trie</span><span class="p">,</span> <span class="n">parts</span><span class="p">)</span> +</span><span id="AbstractMappingSchema-147"><a href="#AbstractMappingSchema-147"><span class="linenos">147</span></a> +</span><span id="AbstractMappingSchema-148"><a href="#AbstractMappingSchema-148"><span class="linenos">148</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">FAILED</span><span class="p">:</span> +</span><span id="AbstractMappingSchema-149"><a href="#AbstractMappingSchema-149"><span class="linenos">149</span></a> <span class="k">return</span> <span class="kc">None</span> +</span><span id="AbstractMappingSchema-150"><a href="#AbstractMappingSchema-150"><span class="linenos">150</span></a> +</span><span id="AbstractMappingSchema-151"><a href="#AbstractMappingSchema-151"><span class="linenos">151</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">PREFIX</span><span class="p">:</span> +</span><span id="AbstractMappingSchema-152"><a href="#AbstractMappingSchema-152"><span class="linenos">152</span></a> <span class="n">possibilities</span> <span class="o">=</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="n">trie</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">dict_depth</span><span class="p">(</span><span class="n">trie</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> +</span><span id="AbstractMappingSchema-153"><a href="#AbstractMappingSchema-153"><span class="linenos">153</span></a> +</span><span id="AbstractMappingSchema-154"><a href="#AbstractMappingSchema-154"><span class="linenos">154</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">possibilities</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> +</span><span id="AbstractMappingSchema-155"><a href="#AbstractMappingSchema-155"><span class="linenos">155</span></a> <span class="n">parts</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">possibilities</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span> +</span><span id="AbstractMappingSchema-156"><a href="#AbstractMappingSchema-156"><span class="linenos">156</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="AbstractMappingSchema-157"><a href="#AbstractMappingSchema-157"><span class="linenos">157</span></a> <span class="n">message</span> <span class="o">=</span> <span class="s2">", "</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s2">"."</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">parts</span><span class="p">)</span> <span class="k">for</span> <span class="n">parts</span> <span class="ow">in</span> <span class="n">possibilities</span><span class="p">)</span> +</span><span id="AbstractMappingSchema-158"><a href="#AbstractMappingSchema-158"><span class="linenos">158</span></a> <span class="k">if</span> <span class="n">raise_on_missing</span><span class="p">:</span> +</span><span id="AbstractMappingSchema-159"><a href="#AbstractMappingSchema-159"><span class="linenos">159</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ambiguous mapping for </span><span class="si">{</span><span class="n">table</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">message</span><span class="si">}</span><span class="s2">."</span><span class="p">)</span> +</span><span id="AbstractMappingSchema-160"><a href="#AbstractMappingSchema-160"><span class="linenos">160</span></a> <span class="k">return</span> <span class="kc">None</span> +</span><span id="AbstractMappingSchema-161"><a href="#AbstractMappingSchema-161"><span class="linenos">161</span></a> +</span><span id="AbstractMappingSchema-162"><a href="#AbstractMappingSchema-162"><span class="linenos">162</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">nested_get</span><span class="p">(</span><span class="n">parts</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">)</span> +</span><span id="AbstractMappingSchema-163"><a href="#AbstractMappingSchema-163"><span class="linenos">163</span></a> +</span><span id="AbstractMappingSchema-164"><a href="#AbstractMappingSchema-164"><span class="linenos">164</span></a> <span class="k">def</span> <span class="nf">nested_get</span><span class="p">(</span> +</span><span id="AbstractMappingSchema-165"><a href="#AbstractMappingSchema-165"><span class="linenos">165</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">parts</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">True</span> +</span><span id="AbstractMappingSchema-166"><a href="#AbstractMappingSchema-166"><span class="linenos">166</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">]:</span> +</span><span id="AbstractMappingSchema-167"><a href="#AbstractMappingSchema-167"><span class="linenos">167</span></a> <span class="k">return</span> <span class="n">nested_get</span><span class="p">(</span> +</span><span id="AbstractMappingSchema-168"><a href="#AbstractMappingSchema-168"><span class="linenos">168</span></a> <span class="n">d</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> +</span><span id="AbstractMappingSchema-169"><a href="#AbstractMappingSchema-169"><span class="linenos">169</span></a> <span class="o">*</span><span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">,</span> <span class="nb">reversed</span><span class="p">(</span><span class="n">parts</span><span class="p">)),</span> +</span><span id="AbstractMappingSchema-170"><a href="#AbstractMappingSchema-170"><span class="linenos">170</span></a> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">,</span> +</span><span id="AbstractMappingSchema-171"><a href="#AbstractMappingSchema-171"><span class="linenos">171</span></a> <span class="p">)</span> </span></pre></div> @@ -1025,15 +1099,15 @@ For example, a generic mapping type might be defined as::</p> </div> <a class="headerlink" href="#AbstractMappingSchema.__init__"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="AbstractMappingSchema.__init__-97"><a href="#AbstractMappingSchema.__init__-97"><span class="linenos"> 97</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> -</span><span id="AbstractMappingSchema.__init__-98"><a href="#AbstractMappingSchema.__init__-98"><span class="linenos"> 98</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="AbstractMappingSchema.__init__-99"><a href="#AbstractMappingSchema.__init__-99"><span class="linenos"> 99</span></a> <span class="n">mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="AbstractMappingSchema.__init__-100"><a href="#AbstractMappingSchema.__init__-100"><span class="linenos">100</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="AbstractMappingSchema.__init__-101"><a href="#AbstractMappingSchema.__init__-101"><span class="linenos">101</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span> <span class="o">=</span> <span class="n">mapping</span> <span class="ow">or</span> <span class="p">{}</span> -</span><span id="AbstractMappingSchema.__init__-102"><a href="#AbstractMappingSchema.__init__-102"><span class="linenos">102</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="o">=</span> <span class="n">new_trie</span><span class="p">(</span> -</span><span id="AbstractMappingSchema.__init__-103"><a href="#AbstractMappingSchema.__init__-103"><span class="linenos">103</span></a> <span class="nb">tuple</span><span class="p">(</span><span class="nb">reversed</span><span class="p">(</span><span class="n">t</span><span class="p">))</span> <span class="k">for</span> <span class="n">t</span> <span class="ow">in</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_depth</span><span class="p">())</span> -</span><span id="AbstractMappingSchema.__init__-104"><a href="#AbstractMappingSchema.__init__-104"><span class="linenos">104</span></a> <span class="p">)</span> -</span><span id="AbstractMappingSchema.__init__-105"><a href="#AbstractMappingSchema.__init__-105"><span class="linenos">105</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">()</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="AbstractMappingSchema.__init__-106"><a href="#AbstractMappingSchema.__init__-106"><span class="linenos">106</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> +</span><span id="AbstractMappingSchema.__init__-107"><a href="#AbstractMappingSchema.__init__-107"><span class="linenos">107</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="AbstractMappingSchema.__init__-108"><a href="#AbstractMappingSchema.__init__-108"><span class="linenos">108</span></a> <span class="n">mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="AbstractMappingSchema.__init__-109"><a href="#AbstractMappingSchema.__init__-109"><span class="linenos">109</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="AbstractMappingSchema.__init__-110"><a href="#AbstractMappingSchema.__init__-110"><span class="linenos">110</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span> <span class="o">=</span> <span class="n">mapping</span> <span class="ow">or</span> <span class="p">{}</span> +</span><span id="AbstractMappingSchema.__init__-111"><a href="#AbstractMappingSchema.__init__-111"><span class="linenos">111</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="o">=</span> <span class="n">new_trie</span><span class="p">(</span> +</span><span id="AbstractMappingSchema.__init__-112"><a href="#AbstractMappingSchema.__init__-112"><span class="linenos">112</span></a> <span class="nb">tuple</span><span class="p">(</span><span class="nb">reversed</span><span class="p">(</span><span class="n">t</span><span class="p">))</span> <span class="k">for</span> <span class="n">t</span> <span class="ow">in</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">depth</span><span class="p">())</span> +</span><span id="AbstractMappingSchema.__init__-113"><a href="#AbstractMappingSchema.__init__-113"><span class="linenos">113</span></a> <span class="p">)</span> +</span><span id="AbstractMappingSchema.__init__-114"><a href="#AbstractMappingSchema.__init__-114"><span class="linenos">114</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_supported_table_args</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">()</span> </span></pre></div> @@ -1073,6 +1147,25 @@ For example, a generic mapping type might be defined as::</p> </div> + <div id="AbstractMappingSchema.depth" class="classattr"> + <input id="AbstractMappingSchema.depth-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1"> +<div class="attr function"> + + <span class="def">def</span> + <span class="name">depth</span><span class="signature pdoc-code condensed">(<span class="param"><span class="bp">self</span></span><span class="return-annotation">) -> <span class="nb">int</span>:</span></span> + + <label class="view-source-button" for="AbstractMappingSchema.depth-view-source"><span>View Source</span></label> + + </div> + <a class="headerlink" href="#AbstractMappingSchema.depth"></a> + <div class="pdoc-code codehilite"><pre><span></span><span id="AbstractMappingSchema.depth-120"><a href="#AbstractMappingSchema.depth-120"><span class="linenos">120</span></a> <span class="k">def</span> <span class="nf">depth</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">int</span><span class="p">:</span> +</span><span id="AbstractMappingSchema.depth-121"><a href="#AbstractMappingSchema.depth-121"><span class="linenos">121</span></a> <span class="k">return</span> <span class="n">dict_depth</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">)</span> +</span></pre></div> + + + + + </div> <div id="AbstractMappingSchema.supported_table_args" class="classattr"> <div class="attr variable"> <span class="name">supported_table_args</span><span class="annotation">: Tuple[str, ...]</span> @@ -1095,10 +1188,10 @@ For example, a generic mapping type might be defined as::</p> </div> <a class="headerlink" href="#AbstractMappingSchema.table_parts"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="AbstractMappingSchema.table_parts-128"><a href="#AbstractMappingSchema.table_parts-128"><span class="linenos">128</span></a> <span class="k">def</span> <span class="nf">table_parts</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> -</span><span id="AbstractMappingSchema.table_parts-129"><a href="#AbstractMappingSchema.table_parts-129"><span class="linenos">129</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">ReadCSV</span><span class="p">):</span> -</span><span id="AbstractMappingSchema.table_parts-130"><a href="#AbstractMappingSchema.table_parts-130"><span class="linenos">130</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> -</span><span id="AbstractMappingSchema.table_parts-131"><a href="#AbstractMappingSchema.table_parts-131"><span class="linenos">131</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)</span> <span class="k">for</span> <span class="n">part</span> <span class="ow">in</span> <span class="n">TABLE_ARGS</span> <span class="k">if</span> <span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)]</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="AbstractMappingSchema.table_parts-137"><a href="#AbstractMappingSchema.table_parts-137"><span class="linenos">137</span></a> <span class="k">def</span> <span class="nf">table_parts</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> +</span><span id="AbstractMappingSchema.table_parts-138"><a href="#AbstractMappingSchema.table_parts-138"><span class="linenos">138</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">ReadCSV</span><span class="p">):</span> +</span><span id="AbstractMappingSchema.table_parts-139"><a href="#AbstractMappingSchema.table_parts-139"><span class="linenos">139</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> +</span><span id="AbstractMappingSchema.table_parts-140"><a href="#AbstractMappingSchema.table_parts-140"><span class="linenos">140</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)</span> <span class="k">for</span> <span class="n">part</span> <span class="ow">in</span> <span class="n">TABLE_ARGS</span> <span class="k">if</span> <span class="n">table</span><span class="o">.</span><span class="n">text</span><span class="p">(</span><span class="n">part</span><span class="p">)]</span> </span></pre></div> @@ -1116,27 +1209,27 @@ For example, a generic mapping type might be defined as::</p> </div> <a class="headerlink" href="#AbstractMappingSchema.find"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="AbstractMappingSchema.find-133"><a href="#AbstractMappingSchema.find-133"><span class="linenos">133</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span> -</span><span id="AbstractMappingSchema.find-134"><a href="#AbstractMappingSchema.find-134"><span class="linenos">134</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">,</span> <span class="n">trie</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span> -</span><span id="AbstractMappingSchema.find-135"><a href="#AbstractMappingSchema.find-135"><span class="linenos">135</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">T</span><span class="p">]:</span> -</span><span id="AbstractMappingSchema.find-136"><a href="#AbstractMappingSchema.find-136"><span class="linenos">136</span></a> <span class="n">parts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">table</span><span class="p">)[</span><span class="mi">0</span> <span class="p">:</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">)]</span> -</span><span id="AbstractMappingSchema.find-137"><a href="#AbstractMappingSchema.find-137"><span class="linenos">137</span></a> <span class="n">value</span><span class="p">,</span> <span class="n">trie</span> <span class="o">=</span> <span class="n">in_trie</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="k">if</span> <span class="n">trie</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">trie</span><span class="p">,</span> <span class="n">parts</span><span class="p">)</span> -</span><span id="AbstractMappingSchema.find-138"><a href="#AbstractMappingSchema.find-138"><span class="linenos">138</span></a> -</span><span id="AbstractMappingSchema.find-139"><a href="#AbstractMappingSchema.find-139"><span class="linenos">139</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">FAILED</span><span class="p">:</span> -</span><span id="AbstractMappingSchema.find-140"><a href="#AbstractMappingSchema.find-140"><span class="linenos">140</span></a> <span class="k">return</span> <span class="kc">None</span> -</span><span id="AbstractMappingSchema.find-141"><a href="#AbstractMappingSchema.find-141"><span class="linenos">141</span></a> -</span><span id="AbstractMappingSchema.find-142"><a href="#AbstractMappingSchema.find-142"><span class="linenos">142</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">PREFIX</span><span class="p">:</span> -</span><span id="AbstractMappingSchema.find-143"><a href="#AbstractMappingSchema.find-143"><span class="linenos">143</span></a> <span class="n">possibilities</span> <span class="o">=</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="n">trie</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">dict_depth</span><span class="p">(</span><span class="n">trie</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> -</span><span id="AbstractMappingSchema.find-144"><a href="#AbstractMappingSchema.find-144"><span class="linenos">144</span></a> -</span><span id="AbstractMappingSchema.find-145"><a href="#AbstractMappingSchema.find-145"><span class="linenos">145</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">possibilities</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> -</span><span id="AbstractMappingSchema.find-146"><a href="#AbstractMappingSchema.find-146"><span class="linenos">146</span></a> <span class="n">parts</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">possibilities</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span> -</span><span id="AbstractMappingSchema.find-147"><a href="#AbstractMappingSchema.find-147"><span class="linenos">147</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="AbstractMappingSchema.find-148"><a href="#AbstractMappingSchema.find-148"><span class="linenos">148</span></a> <span class="n">message</span> <span class="o">=</span> <span class="s2">", "</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s2">"."</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">parts</span><span class="p">)</span> <span class="k">for</span> <span class="n">parts</span> <span class="ow">in</span> <span class="n">possibilities</span><span class="p">)</span> -</span><span id="AbstractMappingSchema.find-149"><a href="#AbstractMappingSchema.find-149"><span class="linenos">149</span></a> <span class="k">if</span> <span class="n">raise_on_missing</span><span class="p">:</span> -</span><span id="AbstractMappingSchema.find-150"><a href="#AbstractMappingSchema.find-150"><span class="linenos">150</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ambiguous mapping for </span><span class="si">{</span><span class="n">table</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">message</span><span class="si">}</span><span class="s2">."</span><span class="p">)</span> -</span><span id="AbstractMappingSchema.find-151"><a href="#AbstractMappingSchema.find-151"><span class="linenos">151</span></a> <span class="k">return</span> <span class="kc">None</span> -</span><span id="AbstractMappingSchema.find-152"><a href="#AbstractMappingSchema.find-152"><span class="linenos">152</span></a> -</span><span id="AbstractMappingSchema.find-153"><a href="#AbstractMappingSchema.find-153"><span class="linenos">153</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">nested_get</span><span class="p">(</span><span class="n">parts</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="AbstractMappingSchema.find-142"><a href="#AbstractMappingSchema.find-142"><span class="linenos">142</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span> +</span><span id="AbstractMappingSchema.find-143"><a href="#AbstractMappingSchema.find-143"><span class="linenos">143</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">,</span> <span class="n">trie</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span> +</span><span id="AbstractMappingSchema.find-144"><a href="#AbstractMappingSchema.find-144"><span class="linenos">144</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">T</span><span class="p">]:</span> +</span><span id="AbstractMappingSchema.find-145"><a href="#AbstractMappingSchema.find-145"><span class="linenos">145</span></a> <span class="n">parts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">table</span><span class="p">)[</span><span class="mi">0</span> <span class="p">:</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">)]</span> +</span><span id="AbstractMappingSchema.find-146"><a href="#AbstractMappingSchema.find-146"><span class="linenos">146</span></a> <span class="n">value</span><span class="p">,</span> <span class="n">trie</span> <span class="o">=</span> <span class="n">in_trie</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span> <span class="k">if</span> <span class="n">trie</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">trie</span><span class="p">,</span> <span class="n">parts</span><span class="p">)</span> +</span><span id="AbstractMappingSchema.find-147"><a href="#AbstractMappingSchema.find-147"><span class="linenos">147</span></a> +</span><span id="AbstractMappingSchema.find-148"><a href="#AbstractMappingSchema.find-148"><span class="linenos">148</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">FAILED</span><span class="p">:</span> +</span><span id="AbstractMappingSchema.find-149"><a href="#AbstractMappingSchema.find-149"><span class="linenos">149</span></a> <span class="k">return</span> <span class="kc">None</span> +</span><span id="AbstractMappingSchema.find-150"><a href="#AbstractMappingSchema.find-150"><span class="linenos">150</span></a> +</span><span id="AbstractMappingSchema.find-151"><a href="#AbstractMappingSchema.find-151"><span class="linenos">151</span></a> <span class="k">if</span> <span class="n">value</span> <span class="o">==</span> <span class="n">TrieResult</span><span class="o">.</span><span class="n">PREFIX</span><span class="p">:</span> +</span><span id="AbstractMappingSchema.find-152"><a href="#AbstractMappingSchema.find-152"><span class="linenos">152</span></a> <span class="n">possibilities</span> <span class="o">=</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="n">trie</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">dict_depth</span><span class="p">(</span><span class="n">trie</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> +</span><span id="AbstractMappingSchema.find-153"><a href="#AbstractMappingSchema.find-153"><span class="linenos">153</span></a> +</span><span id="AbstractMappingSchema.find-154"><a href="#AbstractMappingSchema.find-154"><span class="linenos">154</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">possibilities</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> +</span><span id="AbstractMappingSchema.find-155"><a href="#AbstractMappingSchema.find-155"><span class="linenos">155</span></a> <span class="n">parts</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">possibilities</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span> +</span><span id="AbstractMappingSchema.find-156"><a href="#AbstractMappingSchema.find-156"><span class="linenos">156</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="AbstractMappingSchema.find-157"><a href="#AbstractMappingSchema.find-157"><span class="linenos">157</span></a> <span class="n">message</span> <span class="o">=</span> <span class="s2">", "</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s2">"."</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">parts</span><span class="p">)</span> <span class="k">for</span> <span class="n">parts</span> <span class="ow">in</span> <span class="n">possibilities</span><span class="p">)</span> +</span><span id="AbstractMappingSchema.find-158"><a href="#AbstractMappingSchema.find-158"><span class="linenos">158</span></a> <span class="k">if</span> <span class="n">raise_on_missing</span><span class="p">:</span> +</span><span id="AbstractMappingSchema.find-159"><a href="#AbstractMappingSchema.find-159"><span class="linenos">159</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ambiguous mapping for </span><span class="si">{</span><span class="n">table</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">message</span><span class="si">}</span><span class="s2">."</span><span class="p">)</span> +</span><span id="AbstractMappingSchema.find-160"><a href="#AbstractMappingSchema.find-160"><span class="linenos">160</span></a> <span class="k">return</span> <span class="kc">None</span> +</span><span id="AbstractMappingSchema.find-161"><a href="#AbstractMappingSchema.find-161"><span class="linenos">161</span></a> +</span><span id="AbstractMappingSchema.find-162"><a href="#AbstractMappingSchema.find-162"><span class="linenos">162</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">nested_get</span><span class="p">(</span><span class="n">parts</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">)</span> </span></pre></div> @@ -1154,14 +1247,14 @@ For example, a generic mapping type might be defined as::</p> </div> <a class="headerlink" href="#AbstractMappingSchema.nested_get"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="AbstractMappingSchema.nested_get-155"><a href="#AbstractMappingSchema.nested_get-155"><span class="linenos">155</span></a> <span class="k">def</span> <span class="nf">nested_get</span><span class="p">(</span> -</span><span id="AbstractMappingSchema.nested_get-156"><a href="#AbstractMappingSchema.nested_get-156"><span class="linenos">156</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">parts</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">True</span> -</span><span id="AbstractMappingSchema.nested_get-157"><a href="#AbstractMappingSchema.nested_get-157"><span class="linenos">157</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">]:</span> -</span><span id="AbstractMappingSchema.nested_get-158"><a href="#AbstractMappingSchema.nested_get-158"><span class="linenos">158</span></a> <span class="k">return</span> <span class="n">nested_get</span><span class="p">(</span> -</span><span id="AbstractMappingSchema.nested_get-159"><a href="#AbstractMappingSchema.nested_get-159"><span class="linenos">159</span></a> <span class="n">d</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> -</span><span id="AbstractMappingSchema.nested_get-160"><a href="#AbstractMappingSchema.nested_get-160"><span class="linenos">160</span></a> <span class="o">*</span><span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">,</span> <span class="nb">reversed</span><span class="p">(</span><span class="n">parts</span><span class="p">)),</span> -</span><span id="AbstractMappingSchema.nested_get-161"><a href="#AbstractMappingSchema.nested_get-161"><span class="linenos">161</span></a> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">,</span> -</span><span id="AbstractMappingSchema.nested_get-162"><a href="#AbstractMappingSchema.nested_get-162"><span class="linenos">162</span></a> <span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="AbstractMappingSchema.nested_get-164"><a href="#AbstractMappingSchema.nested_get-164"><span class="linenos">164</span></a> <span class="k">def</span> <span class="nf">nested_get</span><span class="p">(</span> +</span><span id="AbstractMappingSchema.nested_get-165"><a href="#AbstractMappingSchema.nested_get-165"><span class="linenos">165</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">parts</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">True</span> +</span><span id="AbstractMappingSchema.nested_get-166"><a href="#AbstractMappingSchema.nested_get-166"><span class="linenos">166</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">]:</span> +</span><span id="AbstractMappingSchema.nested_get-167"><a href="#AbstractMappingSchema.nested_get-167"><span class="linenos">167</span></a> <span class="k">return</span> <span class="n">nested_get</span><span class="p">(</span> +</span><span id="AbstractMappingSchema.nested_get-168"><a href="#AbstractMappingSchema.nested_get-168"><span class="linenos">168</span></a> <span class="n">d</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> +</span><span id="AbstractMappingSchema.nested_get-169"><a href="#AbstractMappingSchema.nested_get-169"><span class="linenos">169</span></a> <span class="o">*</span><span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">supported_table_args</span><span class="p">,</span> <span class="nb">reversed</span><span class="p">(</span><span class="n">parts</span><span class="p">)),</span> +</span><span id="AbstractMappingSchema.nested_get-170"><a href="#AbstractMappingSchema.nested_get-170"><span class="linenos">170</span></a> <span class="n">raise_on_missing</span><span class="o">=</span><span class="n">raise_on_missing</span><span class="p">,</span> +</span><span id="AbstractMappingSchema.nested_get-171"><a href="#AbstractMappingSchema.nested_get-171"><span class="linenos">171</span></a> <span class="p">)</span> </span></pre></div> @@ -1180,216 +1273,252 @@ For example, a generic mapping type might be defined as::</p> </div> <a class="headerlink" href="#MappingSchema"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="MappingSchema-165"><a href="#MappingSchema-165"><span class="linenos">165</span></a><span class="k">class</span> <span class="nc">MappingSchema</span><span class="p">(</span><span class="n">AbstractMappingSchema</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]],</span> <span class="n">Schema</span><span class="p">):</span> -</span><span id="MappingSchema-166"><a href="#MappingSchema-166"><span class="linenos">166</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="MappingSchema-167"><a href="#MappingSchema-167"><span class="linenos">167</span></a><span class="sd"> Schema based on a nested mapping.</span> -</span><span id="MappingSchema-168"><a href="#MappingSchema-168"><span class="linenos">168</span></a> -</span><span id="MappingSchema-169"><a href="#MappingSchema-169"><span class="linenos">169</span></a><span class="sd"> Args:</span> -</span><span id="MappingSchema-170"><a href="#MappingSchema-170"><span class="linenos">170</span></a><span class="sd"> schema: Mapping in one of the following forms:</span> -</span><span id="MappingSchema-171"><a href="#MappingSchema-171"><span class="linenos">171</span></a><span class="sd"> 1. {table: {col: type}}</span> -</span><span id="MappingSchema-172"><a href="#MappingSchema-172"><span class="linenos">172</span></a><span class="sd"> 2. {db: {table: {col: type}}}</span> -</span><span id="MappingSchema-173"><a href="#MappingSchema-173"><span class="linenos">173</span></a><span class="sd"> 3. {catalog: {db: {table: {col: type}}}}</span> -</span><span id="MappingSchema-174"><a href="#MappingSchema-174"><span class="linenos">174</span></a><span class="sd"> 4. None - Tables will be added later</span> -</span><span id="MappingSchema-175"><a href="#MappingSchema-175"><span class="linenos">175</span></a><span class="sd"> visible: Optional mapping of which columns in the schema are visible. If not provided, all columns</span> -</span><span id="MappingSchema-176"><a href="#MappingSchema-176"><span class="linenos">176</span></a><span class="sd"> are assumed to be visible. The nesting should mirror that of the schema:</span> -</span><span id="MappingSchema-177"><a href="#MappingSchema-177"><span class="linenos">177</span></a><span class="sd"> 1. {table: set(*cols)}}</span> -</span><span id="MappingSchema-178"><a href="#MappingSchema-178"><span class="linenos">178</span></a><span class="sd"> 2. {db: {table: set(*cols)}}}</span> -</span><span id="MappingSchema-179"><a href="#MappingSchema-179"><span class="linenos">179</span></a><span class="sd"> 3. {catalog: {db: {table: set(*cols)}}}}</span> -</span><span id="MappingSchema-180"><a href="#MappingSchema-180"><span class="linenos">180</span></a><span class="sd"> dialect: The dialect to be used for custom type mappings & parsing string arguments.</span> -</span><span id="MappingSchema-181"><a href="#MappingSchema-181"><span class="linenos">181</span></a><span class="sd"> normalize: Whether to normalize identifier names according to the given dialect or not.</span> -</span><span id="MappingSchema-182"><a href="#MappingSchema-182"><span class="linenos">182</span></a><span class="sd"> """</span> -</span><span id="MappingSchema-183"><a href="#MappingSchema-183"><span class="linenos">183</span></a> -</span><span id="MappingSchema-184"><a href="#MappingSchema-184"><span class="linenos">184</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> -</span><span id="MappingSchema-185"><a href="#MappingSchema-185"><span class="linenos">185</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="MappingSchema-186"><a href="#MappingSchema-186"><span class="linenos">186</span></a> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="MappingSchema-187"><a href="#MappingSchema-187"><span class="linenos">187</span></a> <span class="n">visible</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="MappingSchema-188"><a href="#MappingSchema-188"><span class="linenos">188</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="MappingSchema-189"><a href="#MappingSchema-189"><span class="linenos">189</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> -</span><span id="MappingSchema-190"><a href="#MappingSchema-190"><span class="linenos">190</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="MappingSchema-191"><a href="#MappingSchema-191"><span class="linenos">191</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> -</span><span id="MappingSchema-192"><a href="#MappingSchema-192"><span class="linenos">192</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span> <span class="o">=</span> <span class="n">visible</span> <span class="ow">or</span> <span class="p">{}</span> -</span><span id="MappingSchema-193"><a href="#MappingSchema-193"><span class="linenos">193</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span> <span class="o">=</span> <span class="n">normalize</span> -</span><span id="MappingSchema-194"><a href="#MappingSchema-194"><span class="linenos">194</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="MappingSchema-195"><a href="#MappingSchema-195"><span class="linenos">195</span></a> -</span><span id="MappingSchema-196"><a href="#MappingSchema-196"><span class="linenos">196</span></a> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize</span><span class="p">(</span><span class="n">schema</span> <span class="ow">or</span> <span class="p">{}))</span> -</span><span id="MappingSchema-197"><a href="#MappingSchema-197"><span class="linenos">197</span></a> -</span><span id="MappingSchema-198"><a href="#MappingSchema-198"><span class="linenos">198</span></a> <span class="nd">@classmethod</span> -</span><span id="MappingSchema-199"><a href="#MappingSchema-199"><span class="linenos">199</span></a> <span class="k">def</span> <span class="nf">from_mapping_schema</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">mapping_schema</span><span class="p">:</span> <span class="n">MappingSchema</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> -</span><span id="MappingSchema-200"><a href="#MappingSchema-200"><span class="linenos">200</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> -</span><span id="MappingSchema-201"><a href="#MappingSchema-201"><span class="linenos">201</span></a> <span class="n">schema</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> -</span><span id="MappingSchema-202"><a href="#MappingSchema-202"><span class="linenos">202</span></a> <span class="n">visible</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">visible</span><span class="p">,</span> -</span><span id="MappingSchema-203"><a href="#MappingSchema-203"><span class="linenos">203</span></a> <span class="n">dialect</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> -</span><span id="MappingSchema-204"><a href="#MappingSchema-204"><span class="linenos">204</span></a> <span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="MappingSchema-174"><a href="#MappingSchema-174"><span class="linenos">174</span></a><span class="k">class</span> <span class="nc">MappingSchema</span><span class="p">(</span><span class="n">AbstractMappingSchema</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]],</span> <span class="n">Schema</span><span class="p">):</span> +</span><span id="MappingSchema-175"><a href="#MappingSchema-175"><span class="linenos">175</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="MappingSchema-176"><a href="#MappingSchema-176"><span class="linenos">176</span></a><span class="sd"> Schema based on a nested mapping.</span> +</span><span id="MappingSchema-177"><a href="#MappingSchema-177"><span class="linenos">177</span></a> +</span><span id="MappingSchema-178"><a href="#MappingSchema-178"><span class="linenos">178</span></a><span class="sd"> Args:</span> +</span><span id="MappingSchema-179"><a href="#MappingSchema-179"><span class="linenos">179</span></a><span class="sd"> schema: Mapping in one of the following forms:</span> +</span><span id="MappingSchema-180"><a href="#MappingSchema-180"><span class="linenos">180</span></a><span class="sd"> 1. {table: {col: type}}</span> +</span><span id="MappingSchema-181"><a href="#MappingSchema-181"><span class="linenos">181</span></a><span class="sd"> 2. {db: {table: {col: type}}}</span> +</span><span id="MappingSchema-182"><a href="#MappingSchema-182"><span class="linenos">182</span></a><span class="sd"> 3. {catalog: {db: {table: {col: type}}}}</span> +</span><span id="MappingSchema-183"><a href="#MappingSchema-183"><span class="linenos">183</span></a><span class="sd"> 4. None - Tables will be added later</span> +</span><span id="MappingSchema-184"><a href="#MappingSchema-184"><span class="linenos">184</span></a><span class="sd"> visible: Optional mapping of which columns in the schema are visible. If not provided, all columns</span> +</span><span id="MappingSchema-185"><a href="#MappingSchema-185"><span class="linenos">185</span></a><span class="sd"> are assumed to be visible. The nesting should mirror that of the schema:</span> +</span><span id="MappingSchema-186"><a href="#MappingSchema-186"><span class="linenos">186</span></a><span class="sd"> 1. {table: set(*cols)}}</span> +</span><span id="MappingSchema-187"><a href="#MappingSchema-187"><span class="linenos">187</span></a><span class="sd"> 2. {db: {table: set(*cols)}}}</span> +</span><span id="MappingSchema-188"><a href="#MappingSchema-188"><span class="linenos">188</span></a><span class="sd"> 3. {catalog: {db: {table: set(*cols)}}}}</span> +</span><span id="MappingSchema-189"><a href="#MappingSchema-189"><span class="linenos">189</span></a><span class="sd"> dialect: The dialect to be used for custom type mappings & parsing string arguments.</span> +</span><span id="MappingSchema-190"><a href="#MappingSchema-190"><span class="linenos">190</span></a><span class="sd"> normalize: Whether to normalize identifier names according to the given dialect or not.</span> +</span><span id="MappingSchema-191"><a href="#MappingSchema-191"><span class="linenos">191</span></a><span class="sd"> """</span> +</span><span id="MappingSchema-192"><a href="#MappingSchema-192"><span class="linenos">192</span></a> +</span><span id="MappingSchema-193"><a href="#MappingSchema-193"><span class="linenos">193</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> +</span><span id="MappingSchema-194"><a href="#MappingSchema-194"><span class="linenos">194</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="MappingSchema-195"><a href="#MappingSchema-195"><span class="linenos">195</span></a> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-196"><a href="#MappingSchema-196"><span class="linenos">196</span></a> <span class="n">visible</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-197"><a href="#MappingSchema-197"><span class="linenos">197</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-198"><a href="#MappingSchema-198"><span class="linenos">198</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> +</span><span id="MappingSchema-199"><a href="#MappingSchema-199"><span class="linenos">199</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="MappingSchema-200"><a href="#MappingSchema-200"><span class="linenos">200</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> +</span><span id="MappingSchema-201"><a href="#MappingSchema-201"><span class="linenos">201</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span> <span class="o">=</span> <span class="n">visible</span> <span class="ow">or</span> <span class="p">{}</span> +</span><span id="MappingSchema-202"><a href="#MappingSchema-202"><span class="linenos">202</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span> <span class="o">=</span> <span class="n">normalize</span> +</span><span id="MappingSchema-203"><a href="#MappingSchema-203"><span class="linenos">203</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="MappingSchema-204"><a href="#MappingSchema-204"><span class="linenos">204</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span> <span class="o">=</span> <span class="mi">0</span> </span><span id="MappingSchema-205"><a href="#MappingSchema-205"><span class="linenos">205</span></a> -</span><span id="MappingSchema-206"><a href="#MappingSchema-206"><span class="linenos">206</span></a> <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> -</span><span id="MappingSchema-207"><a href="#MappingSchema-207"><span class="linenos">207</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> -</span><span id="MappingSchema-208"><a href="#MappingSchema-208"><span class="linenos">208</span></a> <span class="o">**</span><span class="p">{</span> <span class="c1"># type: ignore</span> -</span><span id="MappingSchema-209"><a href="#MappingSchema-209"><span class="linenos">209</span></a> <span class="s2">"schema"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> -</span><span id="MappingSchema-210"><a href="#MappingSchema-210"><span class="linenos">210</span></a> <span class="s2">"visible"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> -</span><span id="MappingSchema-211"><a href="#MappingSchema-211"><span class="linenos">211</span></a> <span class="s2">"dialect"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> -</span><span id="MappingSchema-212"><a href="#MappingSchema-212"><span class="linenos">212</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> -</span><span id="MappingSchema-213"><a href="#MappingSchema-213"><span class="linenos">213</span></a> <span class="p">}</span> -</span><span id="MappingSchema-214"><a href="#MappingSchema-214"><span class="linenos">214</span></a> <span class="p">)</span> -</span><span id="MappingSchema-215"><a href="#MappingSchema-215"><span class="linenos">215</span></a> -</span><span id="MappingSchema-216"><a href="#MappingSchema-216"><span class="linenos">216</span></a> <span class="k">def</span> <span class="nf">add_table</span><span class="p">(</span> -</span><span id="MappingSchema-217"><a href="#MappingSchema-217"><span class="linenos">217</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="MappingSchema-218"><a href="#MappingSchema-218"><span class="linenos">218</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="MappingSchema-219"><a href="#MappingSchema-219"><span class="linenos">219</span></a> <span class="n">column_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="MappingSchema-220"><a href="#MappingSchema-220"><span class="linenos">220</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="MappingSchema-221"><a href="#MappingSchema-221"><span class="linenos">221</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="MappingSchema-222"><a href="#MappingSchema-222"><span class="linenos">222</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="MappingSchema-223"><a href="#MappingSchema-223"><span class="linenos">223</span></a><span class="sd"> Register or update a table. Updates are only performed if a new column mapping is provided.</span> -</span><span id="MappingSchema-224"><a href="#MappingSchema-224"><span class="linenos">224</span></a> -</span><span id="MappingSchema-225"><a href="#MappingSchema-225"><span class="linenos">225</span></a><span class="sd"> Args:</span> -</span><span id="MappingSchema-226"><a href="#MappingSchema-226"><span class="linenos">226</span></a><span class="sd"> table: the `Table` expression instance or string representing the table.</span> -</span><span id="MappingSchema-227"><a href="#MappingSchema-227"><span class="linenos">227</span></a><span class="sd"> column_mapping: a column mapping that describes the structure of the table.</span> -</span><span id="MappingSchema-228"><a href="#MappingSchema-228"><span class="linenos">228</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> -</span><span id="MappingSchema-229"><a href="#MappingSchema-229"><span class="linenos">229</span></a><span class="sd"> """</span> -</span><span id="MappingSchema-230"><a href="#MappingSchema-230"><span class="linenos">230</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> -</span><span id="MappingSchema-231"><a href="#MappingSchema-231"><span class="linenos">231</span></a> -</span><span id="MappingSchema-232"><a href="#MappingSchema-232"><span class="linenos">232</span></a> <span class="n">normalized_column_mapping</span> <span class="o">=</span> <span class="p">{</span> -</span><span id="MappingSchema-233"><a href="#MappingSchema-233"><span class="linenos">233</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">):</span> <span class="n">value</span> -</span><span id="MappingSchema-234"><a href="#MappingSchema-234"><span class="linenos">234</span></a> <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">ensure_column_mapping</span><span class="p">(</span><span class="n">column_mapping</span><span class="p">)</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> -</span><span id="MappingSchema-235"><a href="#MappingSchema-235"><span class="linenos">235</span></a> <span class="p">}</span> -</span><span id="MappingSchema-236"><a href="#MappingSchema-236"><span class="linenos">236</span></a> -</span><span id="MappingSchema-237"><a href="#MappingSchema-237"><span class="linenos">237</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> -</span><span id="MappingSchema-238"><a href="#MappingSchema-238"><span class="linenos">238</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">normalized_column_mapping</span><span class="p">:</span> -</span><span id="MappingSchema-239"><a href="#MappingSchema-239"><span class="linenos">239</span></a> <span class="k">return</span> -</span><span id="MappingSchema-240"><a href="#MappingSchema-240"><span class="linenos">240</span></a> -</span><span id="MappingSchema-241"><a href="#MappingSchema-241"><span class="linenos">241</span></a> <span class="n">parts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">)</span> -</span><span id="MappingSchema-242"><a href="#MappingSchema-242"><span class="linenos">242</span></a> -</span><span id="MappingSchema-243"><a href="#MappingSchema-243"><span class="linenos">243</span></a> <span class="n">nested_set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">tuple</span><span class="p">(</span><span class="nb">reversed</span><span class="p">(</span><span class="n">parts</span><span class="p">)),</span> <span class="n">normalized_column_mapping</span><span class="p">)</span> -</span><span id="MappingSchema-244"><a href="#MappingSchema-244"><span class="linenos">244</span></a> <span class="n">new_trie</span><span class="p">([</span><span class="n">parts</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span><span class="p">)</span> -</span><span id="MappingSchema-245"><a href="#MappingSchema-245"><span class="linenos">245</span></a> -</span><span id="MappingSchema-246"><a href="#MappingSchema-246"><span class="linenos">246</span></a> <span class="k">def</span> <span class="nf">column_names</span><span class="p">(</span> -</span><span id="MappingSchema-247"><a href="#MappingSchema-247"><span class="linenos">247</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="MappingSchema-248"><a href="#MappingSchema-248"><span class="linenos">248</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="MappingSchema-249"><a href="#MappingSchema-249"><span class="linenos">249</span></a> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> -</span><span id="MappingSchema-250"><a href="#MappingSchema-250"><span class="linenos">250</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="MappingSchema-251"><a href="#MappingSchema-251"><span class="linenos">251</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> -</span><span id="MappingSchema-252"><a href="#MappingSchema-252"><span class="linenos">252</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> -</span><span id="MappingSchema-253"><a href="#MappingSchema-253"><span class="linenos">253</span></a> -</span><span id="MappingSchema-254"><a href="#MappingSchema-254"><span class="linenos">254</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">)</span> -</span><span id="MappingSchema-255"><a href="#MappingSchema-255"><span class="linenos">255</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="MappingSchema-256"><a href="#MappingSchema-256"><span class="linenos">256</span></a> <span class="k">return</span> <span class="p">[]</span> -</span><span id="MappingSchema-257"><a href="#MappingSchema-257"><span class="linenos">257</span></a> -</span><span id="MappingSchema-258"><a href="#MappingSchema-258"><span class="linenos">258</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">only_visible</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="p">:</span> -</span><span id="MappingSchema-259"><a href="#MappingSchema-259"><span class="linenos">259</span></a> <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> -</span><span id="MappingSchema-260"><a href="#MappingSchema-260"><span class="linenos">260</span></a> -</span><span id="MappingSchema-261"><a href="#MappingSchema-261"><span class="linenos">261</span></a> <span class="n">visible</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">nested_get</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">),</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[]</span> -</span><span id="MappingSchema-262"><a href="#MappingSchema-262"><span class="linenos">262</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">col</span> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">schema</span> <span class="k">if</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">visible</span><span class="p">]</span> +</span><span id="MappingSchema-206"><a href="#MappingSchema-206"><span class="linenos">206</span></a> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize</span><span class="p">(</span><span class="n">schema</span> <span class="ow">or</span> <span class="p">{}))</span> +</span><span id="MappingSchema-207"><a href="#MappingSchema-207"><span class="linenos">207</span></a> +</span><span id="MappingSchema-208"><a href="#MappingSchema-208"><span class="linenos">208</span></a> <span class="nd">@classmethod</span> +</span><span id="MappingSchema-209"><a href="#MappingSchema-209"><span class="linenos">209</span></a> <span class="k">def</span> <span class="nf">from_mapping_schema</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">mapping_schema</span><span class="p">:</span> <span class="n">MappingSchema</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> +</span><span id="MappingSchema-210"><a href="#MappingSchema-210"><span class="linenos">210</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> +</span><span id="MappingSchema-211"><a href="#MappingSchema-211"><span class="linenos">211</span></a> <span class="n">schema</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> +</span><span id="MappingSchema-212"><a href="#MappingSchema-212"><span class="linenos">212</span></a> <span class="n">visible</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">visible</span><span class="p">,</span> +</span><span id="MappingSchema-213"><a href="#MappingSchema-213"><span class="linenos">213</span></a> <span class="n">dialect</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> +</span><span id="MappingSchema-214"><a href="#MappingSchema-214"><span class="linenos">214</span></a> <span class="n">normalize</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">normalize</span><span class="p">,</span> +</span><span id="MappingSchema-215"><a href="#MappingSchema-215"><span class="linenos">215</span></a> <span class="p">)</span> +</span><span id="MappingSchema-216"><a href="#MappingSchema-216"><span class="linenos">216</span></a> +</span><span id="MappingSchema-217"><a href="#MappingSchema-217"><span class="linenos">217</span></a> <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> +</span><span id="MappingSchema-218"><a href="#MappingSchema-218"><span class="linenos">218</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> +</span><span id="MappingSchema-219"><a href="#MappingSchema-219"><span class="linenos">219</span></a> <span class="o">**</span><span class="p">{</span> <span class="c1"># type: ignore</span> +</span><span id="MappingSchema-220"><a href="#MappingSchema-220"><span class="linenos">220</span></a> <span class="s2">"schema"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> +</span><span id="MappingSchema-221"><a href="#MappingSchema-221"><span class="linenos">221</span></a> <span class="s2">"visible"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> +</span><span id="MappingSchema-222"><a href="#MappingSchema-222"><span class="linenos">222</span></a> <span class="s2">"dialect"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> +</span><span id="MappingSchema-223"><a href="#MappingSchema-223"><span class="linenos">223</span></a> <span class="s2">"normalize"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span><span class="p">,</span> +</span><span id="MappingSchema-224"><a href="#MappingSchema-224"><span class="linenos">224</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> +</span><span id="MappingSchema-225"><a href="#MappingSchema-225"><span class="linenos">225</span></a> <span class="p">}</span> +</span><span id="MappingSchema-226"><a href="#MappingSchema-226"><span class="linenos">226</span></a> <span class="p">)</span> +</span><span id="MappingSchema-227"><a href="#MappingSchema-227"><span class="linenos">227</span></a> +</span><span id="MappingSchema-228"><a href="#MappingSchema-228"><span class="linenos">228</span></a> <span class="k">def</span> <span class="nf">add_table</span><span class="p">(</span> +</span><span id="MappingSchema-229"><a href="#MappingSchema-229"><span class="linenos">229</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="MappingSchema-230"><a href="#MappingSchema-230"><span class="linenos">230</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="MappingSchema-231"><a href="#MappingSchema-231"><span class="linenos">231</span></a> <span class="n">column_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-232"><a href="#MappingSchema-232"><span class="linenos">232</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-233"><a href="#MappingSchema-233"><span class="linenos">233</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-234"><a href="#MappingSchema-234"><span class="linenos">234</span></a> <span class="n">match_depth</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> +</span><span id="MappingSchema-235"><a href="#MappingSchema-235"><span class="linenos">235</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="MappingSchema-236"><a href="#MappingSchema-236"><span class="linenos">236</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="MappingSchema-237"><a href="#MappingSchema-237"><span class="linenos">237</span></a><span class="sd"> Register or update a table. Updates are only performed if a new column mapping is provided.</span> +</span><span id="MappingSchema-238"><a href="#MappingSchema-238"><span class="linenos">238</span></a><span class="sd"> The added table must have the necessary number of qualifiers in its path to match the schema's nesting level.</span> +</span><span id="MappingSchema-239"><a href="#MappingSchema-239"><span class="linenos">239</span></a> +</span><span id="MappingSchema-240"><a href="#MappingSchema-240"><span class="linenos">240</span></a><span class="sd"> Args:</span> +</span><span id="MappingSchema-241"><a href="#MappingSchema-241"><span class="linenos">241</span></a><span class="sd"> table: the `Table` expression instance or string representing the table.</span> +</span><span id="MappingSchema-242"><a href="#MappingSchema-242"><span class="linenos">242</span></a><span class="sd"> column_mapping: a column mapping that describes the structure of the table.</span> +</span><span id="MappingSchema-243"><a href="#MappingSchema-243"><span class="linenos">243</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `table` if it's a string.</span> +</span><span id="MappingSchema-244"><a href="#MappingSchema-244"><span class="linenos">244</span></a><span class="sd"> normalize: whether to normalize identifiers according to the dialect of interest.</span> +</span><span id="MappingSchema-245"><a href="#MappingSchema-245"><span class="linenos">245</span></a><span class="sd"> match_depth: whether to enforce that the table must match the schema's depth or not.</span> +</span><span id="MappingSchema-246"><a href="#MappingSchema-246"><span class="linenos">246</span></a><span class="sd"> """</span> +</span><span id="MappingSchema-247"><a href="#MappingSchema-247"><span class="linenos">247</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span><span class="p">)</span> +</span><span id="MappingSchema-248"><a href="#MappingSchema-248"><span class="linenos">248</span></a> +</span><span id="MappingSchema-249"><a href="#MappingSchema-249"><span class="linenos">249</span></a> <span class="k">if</span> <span class="n">match_depth</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">empty</span> <span class="ow">and</span> <span class="nb">len</span><span class="p">(</span><span class="n">normalized_table</span><span class="o">.</span><span class="n">parts</span><span class="p">)</span> <span class="o">!=</span> <span class="bp">self</span><span class="o">.</span><span class="n">depth</span><span class="p">():</span> +</span><span id="MappingSchema-250"><a href="#MappingSchema-250"><span class="linenos">250</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span> +</span><span id="MappingSchema-251"><a href="#MappingSchema-251"><span class="linenos">251</span></a> <span class="sa">f</span><span class="s2">"Table </span><span class="si">{</span><span class="n">normalized_table</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="n">dialect</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">)</span><span class="si">}</span><span class="s2"> must match the "</span> +</span><span id="MappingSchema-252"><a href="#MappingSchema-252"><span class="linenos">252</span></a> <span class="sa">f</span><span class="s2">"schema's nesting level: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">depth</span><span class="p">()</span><span class="si">}</span><span class="s2">."</span> +</span><span id="MappingSchema-253"><a href="#MappingSchema-253"><span class="linenos">253</span></a> <span class="p">)</span> +</span><span id="MappingSchema-254"><a href="#MappingSchema-254"><span class="linenos">254</span></a> +</span><span id="MappingSchema-255"><a href="#MappingSchema-255"><span class="linenos">255</span></a> <span class="n">normalized_column_mapping</span> <span class="o">=</span> <span class="p">{</span> +</span><span id="MappingSchema-256"><a href="#MappingSchema-256"><span class="linenos">256</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span><span class="p">):</span> <span class="n">value</span> +</span><span id="MappingSchema-257"><a href="#MappingSchema-257"><span class="linenos">257</span></a> <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">ensure_column_mapping</span><span class="p">(</span><span class="n">column_mapping</span><span class="p">)</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> +</span><span id="MappingSchema-258"><a href="#MappingSchema-258"><span class="linenos">258</span></a> <span class="p">}</span> +</span><span id="MappingSchema-259"><a href="#MappingSchema-259"><span class="linenos">259</span></a> +</span><span id="MappingSchema-260"><a href="#MappingSchema-260"><span class="linenos">260</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> +</span><span id="MappingSchema-261"><a href="#MappingSchema-261"><span class="linenos">261</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">normalized_column_mapping</span><span class="p">:</span> +</span><span id="MappingSchema-262"><a href="#MappingSchema-262"><span class="linenos">262</span></a> <span class="k">return</span> </span><span id="MappingSchema-263"><a href="#MappingSchema-263"><span class="linenos">263</span></a> -</span><span id="MappingSchema-264"><a href="#MappingSchema-264"><span class="linenos">264</span></a> <span class="k">def</span> <span class="nf">get_column_type</span><span class="p">(</span> -</span><span id="MappingSchema-265"><a href="#MappingSchema-265"><span class="linenos">265</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="MappingSchema-266"><a href="#MappingSchema-266"><span class="linenos">266</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> -</span><span id="MappingSchema-267"><a href="#MappingSchema-267"><span class="linenos">267</span></a> <span class="n">column</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">,</span> -</span><span id="MappingSchema-268"><a href="#MappingSchema-268"><span class="linenos">268</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="MappingSchema-269"><a href="#MappingSchema-269"><span class="linenos">269</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> -</span><span id="MappingSchema-270"><a href="#MappingSchema-270"><span class="linenos">270</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> -</span><span id="MappingSchema-271"><a href="#MappingSchema-271"><span class="linenos">271</span></a> -</span><span id="MappingSchema-272"><a href="#MappingSchema-272"><span class="linenos">272</span></a> <span class="n">normalized_column_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span> -</span><span id="MappingSchema-273"><a href="#MappingSchema-273"><span class="linenos">273</span></a> <span class="n">column</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="k">else</span> <span class="n">column</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span> -</span><span id="MappingSchema-274"><a href="#MappingSchema-274"><span class="linenos">274</span></a> <span class="p">)</span> -</span><span id="MappingSchema-275"><a href="#MappingSchema-275"><span class="linenos">275</span></a> -</span><span id="MappingSchema-276"><a href="#MappingSchema-276"><span class="linenos">276</span></a> <span class="n">table_schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> -</span><span id="MappingSchema-277"><a href="#MappingSchema-277"><span class="linenos">277</span></a> <span class="k">if</span> <span class="n">table_schema</span><span class="p">:</span> -</span><span id="MappingSchema-278"><a href="#MappingSchema-278"><span class="linenos">278</span></a> <span class="n">column_type</span> <span class="o">=</span> <span class="n">table_schema</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">normalized_column_name</span><span class="p">)</span> -</span><span id="MappingSchema-279"><a href="#MappingSchema-279"><span class="linenos">279</span></a> -</span><span id="MappingSchema-280"><a href="#MappingSchema-280"><span class="linenos">280</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column_type</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">):</span> -</span><span id="MappingSchema-281"><a href="#MappingSchema-281"><span class="linenos">281</span></a> <span class="k">return</span> <span class="n">column_type</span> -</span><span id="MappingSchema-282"><a href="#MappingSchema-282"><span class="linenos">282</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column_type</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> -</span><span id="MappingSchema-283"><a href="#MappingSchema-283"><span class="linenos">283</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_to_data_type</span><span class="p">(</span><span class="n">column_type</span><span class="o">.</span><span class="n">upper</span><span class="p">(),</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> +</span><span id="MappingSchema-264"><a href="#MappingSchema-264"><span class="linenos">264</span></a> <span class="n">parts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">)</span> +</span><span id="MappingSchema-265"><a href="#MappingSchema-265"><span class="linenos">265</span></a> +</span><span id="MappingSchema-266"><a href="#MappingSchema-266"><span class="linenos">266</span></a> <span class="n">nested_set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">tuple</span><span class="p">(</span><span class="nb">reversed</span><span class="p">(</span><span class="n">parts</span><span class="p">)),</span> <span class="n">normalized_column_mapping</span><span class="p">)</span> +</span><span id="MappingSchema-267"><a href="#MappingSchema-267"><span class="linenos">267</span></a> <span class="n">new_trie</span><span class="p">([</span><span class="n">parts</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping_trie</span><span class="p">)</span> +</span><span id="MappingSchema-268"><a href="#MappingSchema-268"><span class="linenos">268</span></a> +</span><span id="MappingSchema-269"><a href="#MappingSchema-269"><span class="linenos">269</span></a> <span class="k">def</span> <span class="nf">column_names</span><span class="p">(</span> +</span><span id="MappingSchema-270"><a href="#MappingSchema-270"><span class="linenos">270</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="MappingSchema-271"><a href="#MappingSchema-271"><span class="linenos">271</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="MappingSchema-272"><a href="#MappingSchema-272"><span class="linenos">272</span></a> <span class="n">only_visible</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> +</span><span id="MappingSchema-273"><a href="#MappingSchema-273"><span class="linenos">273</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-274"><a href="#MappingSchema-274"><span class="linenos">274</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-275"><a href="#MappingSchema-275"><span class="linenos">275</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span> +</span><span id="MappingSchema-276"><a href="#MappingSchema-276"><span class="linenos">276</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span><span class="p">)</span> +</span><span id="MappingSchema-277"><a href="#MappingSchema-277"><span class="linenos">277</span></a> +</span><span id="MappingSchema-278"><a href="#MappingSchema-278"><span class="linenos">278</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">)</span> +</span><span id="MappingSchema-279"><a href="#MappingSchema-279"><span class="linenos">279</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="MappingSchema-280"><a href="#MappingSchema-280"><span class="linenos">280</span></a> <span class="k">return</span> <span class="p">[]</span> +</span><span id="MappingSchema-281"><a href="#MappingSchema-281"><span class="linenos">281</span></a> +</span><span id="MappingSchema-282"><a href="#MappingSchema-282"><span class="linenos">282</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">only_visible</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="p">:</span> +</span><span id="MappingSchema-283"><a href="#MappingSchema-283"><span class="linenos">283</span></a> <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> </span><span id="MappingSchema-284"><a href="#MappingSchema-284"><span class="linenos">284</span></a> -</span><span id="MappingSchema-285"><a href="#MappingSchema-285"><span class="linenos">285</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="s2">"unknown"</span><span class="p">)</span> -</span><span id="MappingSchema-286"><a href="#MappingSchema-286"><span class="linenos">286</span></a> -</span><span id="MappingSchema-287"><a href="#MappingSchema-287"><span class="linenos">287</span></a> <span class="k">def</span> <span class="nf">_normalize</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> -</span><span id="MappingSchema-288"><a href="#MappingSchema-288"><span class="linenos">288</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="MappingSchema-289"><a href="#MappingSchema-289"><span class="linenos">289</span></a><span class="sd"> Normalizes all identifiers in the schema.</span> -</span><span id="MappingSchema-290"><a href="#MappingSchema-290"><span class="linenos">290</span></a> -</span><span id="MappingSchema-291"><a href="#MappingSchema-291"><span class="linenos">291</span></a><span class="sd"> Args:</span> -</span><span id="MappingSchema-292"><a href="#MappingSchema-292"><span class="linenos">292</span></a><span class="sd"> schema: the schema to normalize.</span> -</span><span id="MappingSchema-293"><a href="#MappingSchema-293"><span class="linenos">293</span></a> -</span><span id="MappingSchema-294"><a href="#MappingSchema-294"><span class="linenos">294</span></a><span class="sd"> Returns:</span> -</span><span id="MappingSchema-295"><a href="#MappingSchema-295"><span class="linenos">295</span></a><span class="sd"> The normalized schema mapping.</span> -</span><span id="MappingSchema-296"><a href="#MappingSchema-296"><span class="linenos">296</span></a><span class="sd"> """</span> -</span><span id="MappingSchema-297"><a href="#MappingSchema-297"><span class="linenos">297</span></a> <span class="n">flattened_schema</span> <span class="o">=</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">dict_depth</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> -</span><span id="MappingSchema-298"><a href="#MappingSchema-298"><span class="linenos">298</span></a> -</span><span id="MappingSchema-299"><a href="#MappingSchema-299"><span class="linenos">299</span></a> <span class="n">normalized_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="MappingSchema-300"><a href="#MappingSchema-300"><span class="linenos">300</span></a> <span class="k">for</span> <span class="n">keys</span> <span class="ow">in</span> <span class="n">flattened_schema</span><span class="p">:</span> -</span><span id="MappingSchema-301"><a href="#MappingSchema-301"><span class="linenos">301</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="n">nested_get</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="o">*</span><span class="nb">zip</span><span class="p">(</span><span class="n">keys</span><span class="p">,</span> <span class="n">keys</span><span class="p">))</span> -</span><span id="MappingSchema-302"><a href="#MappingSchema-302"><span class="linenos">302</span></a> <span class="k">assert</span> <span class="n">columns</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> -</span><span id="MappingSchema-303"><a href="#MappingSchema-303"><span class="linenos">303</span></a> -</span><span id="MappingSchema-304"><a href="#MappingSchema-304"><span class="linenos">304</span></a> <span class="n">normalized_keys</span> <span class="o">=</span> <span class="p">[</span> -</span><span id="MappingSchema-305"><a href="#MappingSchema-305"><span class="linenos">305</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> <span class="n">is_table</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">keys</span> -</span><span id="MappingSchema-306"><a href="#MappingSchema-306"><span class="linenos">306</span></a> <span class="p">]</span> -</span><span id="MappingSchema-307"><a href="#MappingSchema-307"><span class="linenos">307</span></a> <span class="k">for</span> <span class="n">column_name</span><span class="p">,</span> <span class="n">column_type</span> <span class="ow">in</span> <span class="n">columns</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> -</span><span id="MappingSchema-308"><a href="#MappingSchema-308"><span class="linenos">308</span></a> <span class="n">nested_set</span><span class="p">(</span> -</span><span id="MappingSchema-309"><a href="#MappingSchema-309"><span class="linenos">309</span></a> <span class="n">normalized_mapping</span><span class="p">,</span> -</span><span id="MappingSchema-310"><a href="#MappingSchema-310"><span class="linenos">310</span></a> <span class="n">normalized_keys</span> <span class="o">+</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">column_name</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">)],</span> -</span><span id="MappingSchema-311"><a href="#MappingSchema-311"><span class="linenos">311</span></a> <span class="n">column_type</span><span class="p">,</span> -</span><span id="MappingSchema-312"><a href="#MappingSchema-312"><span class="linenos">312</span></a> <span class="p">)</span> -</span><span id="MappingSchema-313"><a href="#MappingSchema-313"><span class="linenos">313</span></a> -</span><span id="MappingSchema-314"><a href="#MappingSchema-314"><span class="linenos">314</span></a> <span class="k">return</span> <span class="n">normalized_mapping</span> +</span><span id="MappingSchema-285"><a href="#MappingSchema-285"><span class="linenos">285</span></a> <span class="n">visible</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">nested_get</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">table_parts</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">),</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[]</span> +</span><span id="MappingSchema-286"><a href="#MappingSchema-286"><span class="linenos">286</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">col</span> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">schema</span> <span class="k">if</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">visible</span><span class="p">]</span> +</span><span id="MappingSchema-287"><a href="#MappingSchema-287"><span class="linenos">287</span></a> +</span><span id="MappingSchema-288"><a href="#MappingSchema-288"><span class="linenos">288</span></a> <span class="k">def</span> <span class="nf">get_column_type</span><span class="p">(</span> +</span><span id="MappingSchema-289"><a href="#MappingSchema-289"><span class="linenos">289</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="MappingSchema-290"><a href="#MappingSchema-290"><span class="linenos">290</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="MappingSchema-291"><a href="#MappingSchema-291"><span class="linenos">291</span></a> <span class="n">column</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">,</span> +</span><span id="MappingSchema-292"><a href="#MappingSchema-292"><span class="linenos">292</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-293"><a href="#MappingSchema-293"><span class="linenos">293</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-294"><a href="#MappingSchema-294"><span class="linenos">294</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> +</span><span id="MappingSchema-295"><a href="#MappingSchema-295"><span class="linenos">295</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_table</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span><span class="p">)</span> +</span><span id="MappingSchema-296"><a href="#MappingSchema-296"><span class="linenos">296</span></a> +</span><span id="MappingSchema-297"><a href="#MappingSchema-297"><span class="linenos">297</span></a> <span class="n">normalized_column_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span> +</span><span id="MappingSchema-298"><a href="#MappingSchema-298"><span class="linenos">298</span></a> <span class="n">column</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="k">else</span> <span class="n">column</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span> +</span><span id="MappingSchema-299"><a href="#MappingSchema-299"><span class="linenos">299</span></a> <span class="p">)</span> +</span><span id="MappingSchema-300"><a href="#MappingSchema-300"><span class="linenos">300</span></a> +</span><span id="MappingSchema-301"><a href="#MappingSchema-301"><span class="linenos">301</span></a> <span class="n">table_schema</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">normalized_table</span><span class="p">,</span> <span class="n">raise_on_missing</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> +</span><span id="MappingSchema-302"><a href="#MappingSchema-302"><span class="linenos">302</span></a> <span class="k">if</span> <span class="n">table_schema</span><span class="p">:</span> +</span><span id="MappingSchema-303"><a href="#MappingSchema-303"><span class="linenos">303</span></a> <span class="n">column_type</span> <span class="o">=</span> <span class="n">table_schema</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">normalized_column_name</span><span class="p">)</span> +</span><span id="MappingSchema-304"><a href="#MappingSchema-304"><span class="linenos">304</span></a> +</span><span id="MappingSchema-305"><a href="#MappingSchema-305"><span class="linenos">305</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column_type</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">):</span> +</span><span id="MappingSchema-306"><a href="#MappingSchema-306"><span class="linenos">306</span></a> <span class="k">return</span> <span class="n">column_type</span> +</span><span id="MappingSchema-307"><a href="#MappingSchema-307"><span class="linenos">307</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column_type</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> +</span><span id="MappingSchema-308"><a href="#MappingSchema-308"><span class="linenos">308</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_to_data_type</span><span class="p">(</span><span class="n">column_type</span><span class="o">.</span><span class="n">upper</span><span class="p">(),</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> +</span><span id="MappingSchema-309"><a href="#MappingSchema-309"><span class="linenos">309</span></a> +</span><span id="MappingSchema-310"><a href="#MappingSchema-310"><span class="linenos">310</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="s2">"unknown"</span><span class="p">)</span> +</span><span id="MappingSchema-311"><a href="#MappingSchema-311"><span class="linenos">311</span></a> +</span><span id="MappingSchema-312"><a href="#MappingSchema-312"><span class="linenos">312</span></a> <span class="k">def</span> <span class="nf">_normalize</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> +</span><span id="MappingSchema-313"><a href="#MappingSchema-313"><span class="linenos">313</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="MappingSchema-314"><a href="#MappingSchema-314"><span class="linenos">314</span></a><span class="sd"> Normalizes all identifiers in the schema.</span> </span><span id="MappingSchema-315"><a href="#MappingSchema-315"><span class="linenos">315</span></a> -</span><span id="MappingSchema-316"><a href="#MappingSchema-316"><span class="linenos">316</span></a> <span class="k">def</span> <span class="nf">_normalize_table</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">:</span> -</span><span id="MappingSchema-317"><a href="#MappingSchema-317"><span class="linenos">317</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">maybe_parse</span><span class="p">(</span> -</span><span id="MappingSchema-318"><a href="#MappingSchema-318"><span class="linenos">318</span></a> <span class="n">table</span><span class="p">,</span> <span class="n">into</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">True</span> -</span><span id="MappingSchema-319"><a href="#MappingSchema-319"><span class="linenos">319</span></a> <span class="p">)</span> -</span><span id="MappingSchema-320"><a href="#MappingSchema-320"><span class="linenos">320</span></a> -</span><span id="MappingSchema-321"><a href="#MappingSchema-321"><span class="linenos">321</span></a> <span class="k">for</span> <span class="n">arg</span> <span class="ow">in</span> <span class="n">TABLE_ARGS</span><span class="p">:</span> -</span><span id="MappingSchema-322"><a href="#MappingSchema-322"><span class="linenos">322</span></a> <span class="n">value</span> <span class="o">=</span> <span class="n">normalized_table</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">arg</span><span class="p">)</span> -</span><span id="MappingSchema-323"><a href="#MappingSchema-323"><span class="linenos">323</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">str</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">)):</span> -</span><span id="MappingSchema-324"><a href="#MappingSchema-324"><span class="linenos">324</span></a> <span class="n">normalized_table</span><span class="o">.</span><span class="n">set</span><span class="p">(</span> -</span><span id="MappingSchema-325"><a href="#MappingSchema-325"><span class="linenos">325</span></a> <span class="n">arg</span><span class="p">,</span> -</span><span id="MappingSchema-326"><a href="#MappingSchema-326"><span class="linenos">326</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">is_table</span><span class="o">=</span><span class="kc">True</span><span class="p">)),</span> -</span><span id="MappingSchema-327"><a href="#MappingSchema-327"><span class="linenos">327</span></a> <span class="p">)</span> -</span><span id="MappingSchema-328"><a href="#MappingSchema-328"><span class="linenos">328</span></a> -</span><span id="MappingSchema-329"><a href="#MappingSchema-329"><span class="linenos">329</span></a> <span class="k">return</span> <span class="n">normalized_table</span> -</span><span id="MappingSchema-330"><a href="#MappingSchema-330"><span class="linenos">330</span></a> -</span><span id="MappingSchema-331"><a href="#MappingSchema-331"><span class="linenos">331</span></a> <span class="k">def</span> <span class="nf">_normalize_name</span><span class="p">(</span> -</span><span id="MappingSchema-332"><a href="#MappingSchema-332"><span class="linenos">332</span></a> <span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">,</span> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">is_table</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span> -</span><span id="MappingSchema-333"><a href="#MappingSchema-333"><span class="linenos">333</span></a> <span class="p">)</span> <span class="o">-></span> <span class="nb">str</span><span class="p">:</span> -</span><span id="MappingSchema-334"><a href="#MappingSchema-334"><span class="linenos">334</span></a> <span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> -</span><span id="MappingSchema-335"><a href="#MappingSchema-335"><span class="linenos">335</span></a> -</span><span id="MappingSchema-336"><a href="#MappingSchema-336"><span class="linenos">336</span></a> <span class="k">try</span><span class="p">:</span> -</span><span id="MappingSchema-337"><a href="#MappingSchema-337"><span class="linenos">337</span></a> <span class="n">identifier</span> <span class="o">=</span> <span class="n">sqlglot</span><span class="o">.</span><span class="n">maybe_parse</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">into</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">)</span> -</span><span id="MappingSchema-338"><a href="#MappingSchema-338"><span class="linenos">338</span></a> <span class="k">except</span> <span class="n">ParseError</span><span class="p">:</span> -</span><span id="MappingSchema-339"><a href="#MappingSchema-339"><span class="linenos">339</span></a> <span class="k">return</span> <span class="n">name</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="k">else</span> <span class="n">name</span><span class="o">.</span><span class="n">name</span> -</span><span id="MappingSchema-340"><a href="#MappingSchema-340"><span class="linenos">340</span></a> -</span><span id="MappingSchema-341"><a href="#MappingSchema-341"><span class="linenos">341</span></a> <span class="n">name</span> <span class="o">=</span> <span class="n">identifier</span><span class="o">.</span><span class="n">name</span> -</span><span id="MappingSchema-342"><a href="#MappingSchema-342"><span class="linenos">342</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span><span class="p">:</span> -</span><span id="MappingSchema-343"><a href="#MappingSchema-343"><span class="linenos">343</span></a> <span class="k">return</span> <span class="n">name</span> +</span><span id="MappingSchema-316"><a href="#MappingSchema-316"><span class="linenos">316</span></a><span class="sd"> Args:</span> +</span><span id="MappingSchema-317"><a href="#MappingSchema-317"><span class="linenos">317</span></a><span class="sd"> schema: the schema to normalize.</span> +</span><span id="MappingSchema-318"><a href="#MappingSchema-318"><span class="linenos">318</span></a> +</span><span id="MappingSchema-319"><a href="#MappingSchema-319"><span class="linenos">319</span></a><span class="sd"> Returns:</span> +</span><span id="MappingSchema-320"><a href="#MappingSchema-320"><span class="linenos">320</span></a><span class="sd"> The normalized schema mapping.</span> +</span><span id="MappingSchema-321"><a href="#MappingSchema-321"><span class="linenos">321</span></a><span class="sd"> """</span> +</span><span id="MappingSchema-322"><a href="#MappingSchema-322"><span class="linenos">322</span></a> <span class="n">normalized_mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="MappingSchema-323"><a href="#MappingSchema-323"><span class="linenos">323</span></a> <span class="n">flattened_schema</span> <span class="o">=</span> <span class="n">flatten_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">dict_depth</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> +</span><span id="MappingSchema-324"><a href="#MappingSchema-324"><span class="linenos">324</span></a> +</span><span id="MappingSchema-325"><a href="#MappingSchema-325"><span class="linenos">325</span></a> <span class="k">for</span> <span class="n">keys</span> <span class="ow">in</span> <span class="n">flattened_schema</span><span class="p">:</span> +</span><span id="MappingSchema-326"><a href="#MappingSchema-326"><span class="linenos">326</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="n">nested_get</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="o">*</span><span class="nb">zip</span><span class="p">(</span><span class="n">keys</span><span class="p">,</span> <span class="n">keys</span><span class="p">))</span> +</span><span id="MappingSchema-327"><a href="#MappingSchema-327"><span class="linenos">327</span></a> +</span><span id="MappingSchema-328"><a href="#MappingSchema-328"><span class="linenos">328</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">columns</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span> +</span><span id="MappingSchema-329"><a href="#MappingSchema-329"><span class="linenos">329</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span> +</span><span id="MappingSchema-330"><a href="#MappingSchema-330"><span class="linenos">330</span></a> <span class="sa">f</span><span class="s2">"Table </span><span class="si">{</span><span class="s1">'.'</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">keys</span><span class="p">[:</span><span class="o">-</span><span class="mi">1</span><span class="p">])</span><span class="si">}</span><span class="s2"> must match the schema's nesting level: </span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="n">flattened_schema</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span><span class="si">}</span><span class="s2">."</span> +</span><span id="MappingSchema-331"><a href="#MappingSchema-331"><span class="linenos">331</span></a> <span class="p">)</span> +</span><span id="MappingSchema-332"><a href="#MappingSchema-332"><span class="linenos">332</span></a> +</span><span id="MappingSchema-333"><a href="#MappingSchema-333"><span class="linenos">333</span></a> <span class="n">normalized_keys</span> <span class="o">=</span> <span class="p">[</span> +</span><span id="MappingSchema-334"><a href="#MappingSchema-334"><span class="linenos">334</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> <span class="n">is_table</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">keys</span> +</span><span id="MappingSchema-335"><a href="#MappingSchema-335"><span class="linenos">335</span></a> <span class="p">]</span> +</span><span id="MappingSchema-336"><a href="#MappingSchema-336"><span class="linenos">336</span></a> <span class="k">for</span> <span class="n">column_name</span><span class="p">,</span> <span class="n">column_type</span> <span class="ow">in</span> <span class="n">columns</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> +</span><span id="MappingSchema-337"><a href="#MappingSchema-337"><span class="linenos">337</span></a> <span class="n">nested_set</span><span class="p">(</span> +</span><span id="MappingSchema-338"><a href="#MappingSchema-338"><span class="linenos">338</span></a> <span class="n">normalized_mapping</span><span class="p">,</span> +</span><span id="MappingSchema-339"><a href="#MappingSchema-339"><span class="linenos">339</span></a> <span class="n">normalized_keys</span> <span class="o">+</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span><span class="n">column_name</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">)],</span> +</span><span id="MappingSchema-340"><a href="#MappingSchema-340"><span class="linenos">340</span></a> <span class="n">column_type</span><span class="p">,</span> +</span><span id="MappingSchema-341"><a href="#MappingSchema-341"><span class="linenos">341</span></a> <span class="p">)</span> +</span><span id="MappingSchema-342"><a href="#MappingSchema-342"><span class="linenos">342</span></a> +</span><span id="MappingSchema-343"><a href="#MappingSchema-343"><span class="linenos">343</span></a> <span class="k">return</span> <span class="n">normalized_mapping</span> </span><span id="MappingSchema-344"><a href="#MappingSchema-344"><span class="linenos">344</span></a> -</span><span id="MappingSchema-345"><a href="#MappingSchema-345"><span class="linenos">345</span></a> <span class="c1"># This can be useful for normalize_identifier</span> -</span><span id="MappingSchema-346"><a href="#MappingSchema-346"><span class="linenos">346</span></a> <span class="n">identifier</span><span class="o">.</span><span class="n">meta</span><span class="p">[</span><span class="s2">"is_table"</span><span class="p">]</span> <span class="o">=</span> <span class="n">is_table</span> -</span><span id="MappingSchema-347"><a href="#MappingSchema-347"><span class="linenos">347</span></a> <span class="k">return</span> <span class="n">Dialect</span><span class="o">.</span><span class="n">get_or_raise</span><span class="p">(</span><span class="n">dialect</span><span class="p">)</span><span class="o">.</span><span class="n">normalize_identifier</span><span class="p">(</span><span class="n">identifier</span><span class="p">)</span><span class="o">.</span><span class="n">name</span> -</span><span id="MappingSchema-348"><a href="#MappingSchema-348"><span class="linenos">348</span></a> -</span><span id="MappingSchema-349"><a href="#MappingSchema-349"><span class="linenos">349</span></a> <span class="k">def</span> <span class="nf">_depth</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">int</span><span class="p">:</span> -</span><span id="MappingSchema-350"><a href="#MappingSchema-350"><span class="linenos">350</span></a> <span class="c1"># The columns themselves are a mapping, but we don't want to include those</span> -</span><span id="MappingSchema-351"><a href="#MappingSchema-351"><span class="linenos">351</span></a> <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">_depth</span><span class="p">()</span> <span class="o">-</span> <span class="mi">1</span> -</span><span id="MappingSchema-352"><a href="#MappingSchema-352"><span class="linenos">352</span></a> -</span><span id="MappingSchema-353"><a href="#MappingSchema-353"><span class="linenos">353</span></a> <span class="k">def</span> <span class="nf">_to_data_type</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">schema_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> -</span><span id="MappingSchema-354"><a href="#MappingSchema-354"><span class="linenos">354</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="MappingSchema-355"><a href="#MappingSchema-355"><span class="linenos">355</span></a><span class="sd"> Convert a type represented as a string to the corresponding `sqlglot.exp.DataType` object.</span> -</span><span id="MappingSchema-356"><a href="#MappingSchema-356"><span class="linenos">356</span></a> -</span><span id="MappingSchema-357"><a href="#MappingSchema-357"><span class="linenos">357</span></a><span class="sd"> Args:</span> -</span><span id="MappingSchema-358"><a href="#MappingSchema-358"><span class="linenos">358</span></a><span class="sd"> schema_type: the type we want to convert.</span> -</span><span id="MappingSchema-359"><a href="#MappingSchema-359"><span class="linenos">359</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `schema_type`, if needed.</span> -</span><span id="MappingSchema-360"><a href="#MappingSchema-360"><span class="linenos">360</span></a> -</span><span id="MappingSchema-361"><a href="#MappingSchema-361"><span class="linenos">361</span></a><span class="sd"> Returns:</span> -</span><span id="MappingSchema-362"><a href="#MappingSchema-362"><span class="linenos">362</span></a><span class="sd"> The resulting expression type.</span> -</span><span id="MappingSchema-363"><a href="#MappingSchema-363"><span class="linenos">363</span></a><span class="sd"> """</span> -</span><span id="MappingSchema-364"><a href="#MappingSchema-364"><span class="linenos">364</span></a> <span class="k">if</span> <span class="n">schema_type</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">:</span> -</span><span id="MappingSchema-365"><a href="#MappingSchema-365"><span class="linenos">365</span></a> <span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> +</span><span id="MappingSchema-345"><a href="#MappingSchema-345"><span class="linenos">345</span></a> <span class="k">def</span> <span class="nf">_normalize_table</span><span class="p">(</span> +</span><span id="MappingSchema-346"><a href="#MappingSchema-346"><span class="linenos">346</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="MappingSchema-347"><a href="#MappingSchema-347"><span class="linenos">347</span></a> <span class="n">table</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span> <span class="o">|</span> <span class="nb">str</span><span class="p">,</span> +</span><span id="MappingSchema-348"><a href="#MappingSchema-348"><span class="linenos">348</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-349"><a href="#MappingSchema-349"><span class="linenos">349</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-350"><a href="#MappingSchema-350"><span class="linenos">350</span></a> <span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">:</span> +</span><span id="MappingSchema-351"><a href="#MappingSchema-351"><span class="linenos">351</span></a> <span class="n">normalized_table</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">maybe_parse</span><span class="p">(</span> +</span><span id="MappingSchema-352"><a href="#MappingSchema-352"><span class="linenos">352</span></a> <span class="n">table</span><span class="p">,</span> <span class="n">into</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">True</span> +</span><span id="MappingSchema-353"><a href="#MappingSchema-353"><span class="linenos">353</span></a> <span class="p">)</span> +</span><span id="MappingSchema-354"><a href="#MappingSchema-354"><span class="linenos">354</span></a> +</span><span id="MappingSchema-355"><a href="#MappingSchema-355"><span class="linenos">355</span></a> <span class="k">for</span> <span class="n">arg</span> <span class="ow">in</span> <span class="n">TABLE_ARGS</span><span class="p">:</span> +</span><span id="MappingSchema-356"><a href="#MappingSchema-356"><span class="linenos">356</span></a> <span class="n">value</span> <span class="o">=</span> <span class="n">normalized_table</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">arg</span><span class="p">)</span> +</span><span id="MappingSchema-357"><a href="#MappingSchema-357"><span class="linenos">357</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">str</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">)):</span> +</span><span id="MappingSchema-358"><a href="#MappingSchema-358"><span class="linenos">358</span></a> <span class="n">normalized_table</span><span class="o">.</span><span class="n">set</span><span class="p">(</span> +</span><span id="MappingSchema-359"><a href="#MappingSchema-359"><span class="linenos">359</span></a> <span class="n">arg</span><span class="p">,</span> +</span><span id="MappingSchema-360"><a href="#MappingSchema-360"><span class="linenos">360</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span> +</span><span id="MappingSchema-361"><a href="#MappingSchema-361"><span class="linenos">361</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_normalize_name</span><span class="p">(</span> +</span><span id="MappingSchema-362"><a href="#MappingSchema-362"><span class="linenos">362</span></a> <span class="n">value</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">is_table</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">normalize</span><span class="o">=</span><span class="n">normalize</span> +</span><span id="MappingSchema-363"><a href="#MappingSchema-363"><span class="linenos">363</span></a> <span class="p">)</span> +</span><span id="MappingSchema-364"><a href="#MappingSchema-364"><span class="linenos">364</span></a> <span class="p">),</span> +</span><span id="MappingSchema-365"><a href="#MappingSchema-365"><span class="linenos">365</span></a> <span class="p">)</span> </span><span id="MappingSchema-366"><a href="#MappingSchema-366"><span class="linenos">366</span></a> -</span><span id="MappingSchema-367"><a href="#MappingSchema-367"><span class="linenos">367</span></a> <span class="k">try</span><span class="p">:</span> -</span><span id="MappingSchema-368"><a href="#MappingSchema-368"><span class="linenos">368</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="n">schema_type</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> -</span><span id="MappingSchema-369"><a href="#MappingSchema-369"><span class="linenos">369</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">[</span><span class="n">schema_type</span><span class="p">]</span> <span class="o">=</span> <span class="n">expression</span> -</span><span id="MappingSchema-370"><a href="#MappingSchema-370"><span class="linenos">370</span></a> <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span> -</span><span id="MappingSchema-371"><a href="#MappingSchema-371"><span class="linenos">371</span></a> <span class="n">in_dialect</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">" in dialect </span><span class="si">{</span><span class="n">dialect</span><span class="si">}</span><span class="s2">"</span> <span class="k">if</span> <span class="n">dialect</span> <span class="k">else</span> <span class="s2">""</span> -</span><span id="MappingSchema-372"><a href="#MappingSchema-372"><span class="linenos">372</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Failed to build type '</span><span class="si">{</span><span class="n">schema_type</span><span class="si">}</span><span class="s2">'</span><span class="si">{</span><span class="n">in_dialect</span><span class="si">}</span><span class="s2">."</span><span class="p">)</span> -</span><span id="MappingSchema-373"><a href="#MappingSchema-373"><span class="linenos">373</span></a> -</span><span id="MappingSchema-374"><a href="#MappingSchema-374"><span class="linenos">374</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">[</span><span class="n">schema_type</span><span class="p">]</span> +</span><span id="MappingSchema-367"><a href="#MappingSchema-367"><span class="linenos">367</span></a> <span class="k">return</span> <span class="n">normalized_table</span> +</span><span id="MappingSchema-368"><a href="#MappingSchema-368"><span class="linenos">368</span></a> +</span><span id="MappingSchema-369"><a href="#MappingSchema-369"><span class="linenos">369</span></a> <span class="k">def</span> <span class="nf">_normalize_name</span><span class="p">(</span> +</span><span id="MappingSchema-370"><a href="#MappingSchema-370"><span class="linenos">370</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="MappingSchema-371"><a href="#MappingSchema-371"><span class="linenos">371</span></a> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">,</span> +</span><span id="MappingSchema-372"><a href="#MappingSchema-372"><span class="linenos">372</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-373"><a href="#MappingSchema-373"><span class="linenos">373</span></a> <span class="n">is_table</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span> +</span><span id="MappingSchema-374"><a href="#MappingSchema-374"><span class="linenos">374</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema-375"><a href="#MappingSchema-375"><span class="linenos">375</span></a> <span class="p">)</span> <span class="o">-></span> <span class="nb">str</span><span class="p">:</span> +</span><span id="MappingSchema-376"><a href="#MappingSchema-376"><span class="linenos">376</span></a> <span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> +</span><span id="MappingSchema-377"><a href="#MappingSchema-377"><span class="linenos">377</span></a> <span class="n">normalize</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span> <span class="k">if</span> <span class="n">normalize</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">normalize</span> +</span><span id="MappingSchema-378"><a href="#MappingSchema-378"><span class="linenos">378</span></a> +</span><span id="MappingSchema-379"><a href="#MappingSchema-379"><span class="linenos">379</span></a> <span class="k">try</span><span class="p">:</span> +</span><span id="MappingSchema-380"><a href="#MappingSchema-380"><span class="linenos">380</span></a> <span class="n">identifier</span> <span class="o">=</span> <span class="n">sqlglot</span><span class="o">.</span><span class="n">maybe_parse</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">,</span> <span class="n">into</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">)</span> +</span><span id="MappingSchema-381"><a href="#MappingSchema-381"><span class="linenos">381</span></a> <span class="k">except</span> <span class="n">ParseError</span><span class="p">:</span> +</span><span id="MappingSchema-382"><a href="#MappingSchema-382"><span class="linenos">382</span></a> <span class="k">return</span> <span class="n">name</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="k">else</span> <span class="n">name</span><span class="o">.</span><span class="n">name</span> +</span><span id="MappingSchema-383"><a href="#MappingSchema-383"><span class="linenos">383</span></a> +</span><span id="MappingSchema-384"><a href="#MappingSchema-384"><span class="linenos">384</span></a> <span class="n">name</span> <span class="o">=</span> <span class="n">identifier</span><span class="o">.</span><span class="n">name</span> +</span><span id="MappingSchema-385"><a href="#MappingSchema-385"><span class="linenos">385</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">normalize</span><span class="p">:</span> +</span><span id="MappingSchema-386"><a href="#MappingSchema-386"><span class="linenos">386</span></a> <span class="k">return</span> <span class="n">name</span> +</span><span id="MappingSchema-387"><a href="#MappingSchema-387"><span class="linenos">387</span></a> +</span><span id="MappingSchema-388"><a href="#MappingSchema-388"><span class="linenos">388</span></a> <span class="c1"># This can be useful for normalize_identifier</span> +</span><span id="MappingSchema-389"><a href="#MappingSchema-389"><span class="linenos">389</span></a> <span class="n">identifier</span><span class="o">.</span><span class="n">meta</span><span class="p">[</span><span class="s2">"is_table"</span><span class="p">]</span> <span class="o">=</span> <span class="n">is_table</span> +</span><span id="MappingSchema-390"><a href="#MappingSchema-390"><span class="linenos">390</span></a> <span class="k">return</span> <span class="n">Dialect</span><span class="o">.</span><span class="n">get_or_raise</span><span class="p">(</span><span class="n">dialect</span><span class="p">)</span><span class="o">.</span><span class="n">normalize_identifier</span><span class="p">(</span><span class="n">identifier</span><span class="p">)</span><span class="o">.</span><span class="n">name</span> +</span><span id="MappingSchema-391"><a href="#MappingSchema-391"><span class="linenos">391</span></a> +</span><span id="MappingSchema-392"><a href="#MappingSchema-392"><span class="linenos">392</span></a> <span class="k">def</span> <span class="nf">depth</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">int</span><span class="p">:</span> +</span><span id="MappingSchema-393"><a href="#MappingSchema-393"><span class="linenos">393</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">empty</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span><span class="p">:</span> +</span><span id="MappingSchema-394"><a href="#MappingSchema-394"><span class="linenos">394</span></a> <span class="c1"># The columns themselves are a mapping, but we don't want to include those</span> +</span><span id="MappingSchema-395"><a href="#MappingSchema-395"><span class="linenos">395</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span> <span class="o">=</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">depth</span><span class="p">()</span> <span class="o">-</span> <span class="mi">1</span> +</span><span id="MappingSchema-396"><a href="#MappingSchema-396"><span class="linenos">396</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span> +</span><span id="MappingSchema-397"><a href="#MappingSchema-397"><span class="linenos">397</span></a> +</span><span id="MappingSchema-398"><a href="#MappingSchema-398"><span class="linenos">398</span></a> <span class="k">def</span> <span class="nf">_to_data_type</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">schema_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">:</span> +</span><span id="MappingSchema-399"><a href="#MappingSchema-399"><span class="linenos">399</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="MappingSchema-400"><a href="#MappingSchema-400"><span class="linenos">400</span></a><span class="sd"> Convert a type represented as a string to the corresponding `sqlglot.exp.DataType` object.</span> +</span><span id="MappingSchema-401"><a href="#MappingSchema-401"><span class="linenos">401</span></a> +</span><span id="MappingSchema-402"><a href="#MappingSchema-402"><span class="linenos">402</span></a><span class="sd"> Args:</span> +</span><span id="MappingSchema-403"><a href="#MappingSchema-403"><span class="linenos">403</span></a><span class="sd"> schema_type: the type we want to convert.</span> +</span><span id="MappingSchema-404"><a href="#MappingSchema-404"><span class="linenos">404</span></a><span class="sd"> dialect: the SQL dialect that will be used to parse `schema_type`, if needed.</span> +</span><span id="MappingSchema-405"><a href="#MappingSchema-405"><span class="linenos">405</span></a> +</span><span id="MappingSchema-406"><a href="#MappingSchema-406"><span class="linenos">406</span></a><span class="sd"> Returns:</span> +</span><span id="MappingSchema-407"><a href="#MappingSchema-407"><span class="linenos">407</span></a><span class="sd"> The resulting expression type.</span> +</span><span id="MappingSchema-408"><a href="#MappingSchema-408"><span class="linenos">408</span></a><span class="sd"> """</span> +</span><span id="MappingSchema-409"><a href="#MappingSchema-409"><span class="linenos">409</span></a> <span class="k">if</span> <span class="n">schema_type</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">:</span> +</span><span id="MappingSchema-410"><a href="#MappingSchema-410"><span class="linenos">410</span></a> <span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> +</span><span id="MappingSchema-411"><a href="#MappingSchema-411"><span class="linenos">411</span></a> +</span><span id="MappingSchema-412"><a href="#MappingSchema-412"><span class="linenos">412</span></a> <span class="k">try</span><span class="p">:</span> +</span><span id="MappingSchema-413"><a href="#MappingSchema-413"><span class="linenos">413</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="n">schema_type</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="n">dialect</span><span class="p">)</span> +</span><span id="MappingSchema-414"><a href="#MappingSchema-414"><span class="linenos">414</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">[</span><span class="n">schema_type</span><span class="p">]</span> <span class="o">=</span> <span class="n">expression</span> +</span><span id="MappingSchema-415"><a href="#MappingSchema-415"><span class="linenos">415</span></a> <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span> +</span><span id="MappingSchema-416"><a href="#MappingSchema-416"><span class="linenos">416</span></a> <span class="n">in_dialect</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">" in dialect </span><span class="si">{</span><span class="n">dialect</span><span class="si">}</span><span class="s2">"</span> <span class="k">if</span> <span class="n">dialect</span> <span class="k">else</span> <span class="s2">""</span> +</span><span id="MappingSchema-417"><a href="#MappingSchema-417"><span class="linenos">417</span></a> <span class="k">raise</span> <span class="n">SchemaError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Failed to build type '</span><span class="si">{</span><span class="n">schema_type</span><span class="si">}</span><span class="s2">'</span><span class="si">{</span><span class="n">in_dialect</span><span class="si">}</span><span class="s2">."</span><span class="p">)</span> +</span><span id="MappingSchema-418"><a href="#MappingSchema-418"><span class="linenos">418</span></a> +</span><span id="MappingSchema-419"><a href="#MappingSchema-419"><span class="linenos">419</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">[</span><span class="n">schema_type</span><span class="p">]</span> </span></pre></div> @@ -1428,19 +1557,20 @@ are assumed to be visible. The nesting should mirror that of the schema: </div> <a class="headerlink" href="#MappingSchema.__init__"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="MappingSchema.__init__-184"><a href="#MappingSchema.__init__-184"><span class="linenos">184</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> -</span><span id="MappingSchema.__init__-185"><a href="#MappingSchema.__init__-185"><span class="linenos">185</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="MappingSchema.__init__-186"><a href="#MappingSchema.__init__-186"><span class="linenos">186</span></a> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="MappingSchema.__init__-187"><a href="#MappingSchema.__init__-187"><span class="linenos">187</span></a> <span class="n">visible</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="MappingSchema.__init__-188"><a href="#MappingSchema.__init__-188"><span class="linenos">188</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> -</span><span id="MappingSchema.__init__-189"><a href="#MappingSchema.__init__-189"><span class="linenos">189</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> -</span><span id="MappingSchema.__init__-190"><a href="#MappingSchema.__init__-190"><span class="linenos">190</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="MappingSchema.__init__-191"><a href="#MappingSchema.__init__-191"><span class="linenos">191</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> -</span><span id="MappingSchema.__init__-192"><a href="#MappingSchema.__init__-192"><span class="linenos">192</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span> <span class="o">=</span> <span class="n">visible</span> <span class="ow">or</span> <span class="p">{}</span> -</span><span id="MappingSchema.__init__-193"><a href="#MappingSchema.__init__-193"><span class="linenos">193</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span> <span class="o">=</span> <span class="n">normalize</span> -</span><span id="MappingSchema.__init__-194"><a href="#MappingSchema.__init__-194"><span class="linenos">194</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="MappingSchema.__init__-195"><a href="#MappingSchema.__init__-195"><span class="linenos">195</span></a> -</span><span id="MappingSchema.__init__-196"><a href="#MappingSchema.__init__-196"><span class="linenos">196</span></a> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize</span><span class="p">(</span><span class="n">schema</span> <span class="ow">or</span> <span class="p">{}))</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="MappingSchema.__init__-193"><a href="#MappingSchema.__init__-193"><span class="linenos">193</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> +</span><span id="MappingSchema.__init__-194"><a href="#MappingSchema.__init__-194"><span class="linenos">194</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="MappingSchema.__init__-195"><a href="#MappingSchema.__init__-195"><span class="linenos">195</span></a> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema.__init__-196"><a href="#MappingSchema.__init__-196"><span class="linenos">196</span></a> <span class="n">visible</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema.__init__-197"><a href="#MappingSchema.__init__-197"><span class="linenos">197</span></a> <span class="n">dialect</span><span class="p">:</span> <span class="n">DialectType</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> +</span><span id="MappingSchema.__init__-198"><a href="#MappingSchema.__init__-198"><span class="linenos">198</span></a> <span class="n">normalize</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> +</span><span id="MappingSchema.__init__-199"><a href="#MappingSchema.__init__-199"><span class="linenos">199</span></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="MappingSchema.__init__-200"><a href="#MappingSchema.__init__-200"><span class="linenos">200</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span> <span class="o">=</span> <span class="n">dialect</span> +</span><span id="MappingSchema.__init__-201"><a href="#MappingSchema.__init__-201"><span class="linenos">201</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span> <span class="o">=</span> <span class="n">visible</span> <span class="ow">or</span> <span class="p">{}</span> +</span><span id="MappingSchema.__init__-202"><a href="#MappingSchema.__init__-202"><span class="linenos">202</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span> <span class="o">=</span> <span class="n">normalize</span> +</span><span id="MappingSchema.__init__-203"><a href="#MappingSchema.__init__-203"><span class="linenos">203</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_type_mapping_cache</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="MappingSchema.__init__-204"><a href="#MappingSchema.__init__-204"><span class="linenos">204</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span> <span class="o">=</span> <span class="mi">0</span> +</span><span id="MappingSchema.__init__-205"><a href="#MappingSchema.__init__-205"><span class="linenos">205</span></a> +</span><span id="MappingSchema.__init__-206"><a href="#MappingSchema.__init__-206"><span class="linenos">206</span></a> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_normalize</span><span class="p">(</span><span class="n">schema</span> <span class="ow">or</span> <span class="p">{}))</span> </span></pre></div> @@ -1481,13 +1611,14 @@ are assumed to be visible. The nesting should mirror that of the schema: </div> <a class="headerlink" href="#MappingSchema.from_mapping_schema"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="MappingSchema.from_mapping_schema-198"><a href="#MappingSchema.from_mapping_schema-198"><span class="linenos">198</span></a> <span class="nd">@classmethod</span> -</span><span id="MappingSchema.from_mapping_schema-199"><a href="#MappingSchema.from_mapping_schema-199"><span class="linenos">199</span></a> <span class="k">def</span> <span class="nf">from_mapping_schema</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">mapping_schema</span><span class="p">:</span> <span class="n">MappingSchema</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> -</span><span id="MappingSchema.from_mapping_schema-200"><a href="#MappingSchema.from_mapping_schema-200"><span class="linenos">200</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> -</span><span id="MappingSchema.from_mapping_schema-201"><a href="#MappingSchema.from_mapping_schema-201"><span class="linenos">201</span></a> <span class="n">schema</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> -</span><span id="MappingSchema.from_mapping_schema-202"><a href="#MappingSchema.from_mapping_schema-202"><span class="linenos">202</span></a> <span class="n">visible</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">visible</span><span class="p">,</span> -</span><span id="MappingSchema.from_mapping_schema-203"><a href="#MappingSchema.from_mapping_schema-203"><span class="linenos">203</span></a> <span class="n">dialect</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> -</span><span id="MappingSchema.from_mapping_schema-204"><a href="#MappingSchema.from_mapping_schema-204"><span class="linenos">204</span></a> <span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="MappingSchema.from_mapping_schema-208"><a href="#MappingSchema.from_mapping_schema-208"><span class="linenos">208</span></a> <span class="nd">@classmethod</span> +</span><span id="MappingSchema.from_mapping_schema-209"><a href="#MappingSchema.from_mapping_schema-209"><span class="linenos">209</span></a> <span class="k">def</span> <span class="nf">from_mapping_schema</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">mapping_schema</span><span class="p">:</span> <span class="n">MappingSchema</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> +</span><span id="MappingSchema.from_mapping_schema-210"><a href="#MappingSchema.from_mapping_schema-210"><span class="linenos">210</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> +</span><span id="MappingSchema.from_mapping_schema-211"><a href="#MappingSchema.from_mapping_schema-211"><span class="linenos">211</span></a> <span class="n">schema</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">mapping</span><span class="p">,</span> +</span><span id="MappingSchema.from_mapping_schema-212"><a href="#MappingSchema.from_mapping_schema-212"><span class="linenos">212</span></a> <span class="n">visible</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">visible</span><span class="p">,</span> +</span><span id="MappingSchema.from_mapping_schema-213"><a href="#MappingSchema.from_mapping_schema-213"><span class="linenos">213</span></a> <span class="n">dialect</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> +</span><span id="MappingSchema.from_mapping_schema-214"><a href="#MappingSchema.from_mapping_schema-214"><span class="linenos">214</span></a> <span class="n">normalize</span><span class="o">=</span><span class="n">mapping_schema</span><span class="o">.</span><span class="n">normalize</span><span class="p">,</span> +</span><span id="MappingSchema.from_mapping_schema-215"><a href="#MappingSchema.from_mapping_schema-215"><span class="linenos">215</span></a> <span class="p">)</span> </span></pre></div> @@ -1505,15 +1636,38 @@ are assumed to be visible. The nesting should mirror that of the schema: </div> <a class="headerlink" href="#MappingSchema.copy"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="MappingSchema.copy-206"><a href="#MappingSchema.copy-206"><span class="linenos">206</span></a> <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> -</span><span id="MappingSchema.copy-207"><a href="#MappingSchema.copy-207"><span class="linenos">207</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> -</span><span id="MappingSchema.copy-208"><a href="#MappingSchema.copy-208"><span class="linenos">208</span></a> <span class="o">**</span><span class="p">{</span> <span class="c1"># type: ignore</span> -</span><span id="MappingSchema.copy-209"><a href="#MappingSchema.copy-209"><span class="linenos">209</span></a> <span class="s2">"schema"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> -</span><span id="MappingSchema.copy-210"><a href="#MappingSchema.copy-210"><span class="linenos">210</span></a> <span class="s2">"visible"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> -</span><span id="MappingSchema.copy-211"><a href="#MappingSchema.copy-211"><span class="linenos">211</span></a> <span class="s2">"dialect"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> -</span><span id="MappingSchema.copy-212"><a href="#MappingSchema.copy-212"><span class="linenos">212</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> -</span><span id="MappingSchema.copy-213"><a href="#MappingSchema.copy-213"><span class="linenos">213</span></a> <span class="p">}</span> -</span><span id="MappingSchema.copy-214"><a href="#MappingSchema.copy-214"><span class="linenos">214</span></a> <span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="MappingSchema.copy-217"><a href="#MappingSchema.copy-217"><span class="linenos">217</span></a> <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-></span> <span class="n">MappingSchema</span><span class="p">:</span> +</span><span id="MappingSchema.copy-218"><a href="#MappingSchema.copy-218"><span class="linenos">218</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span> +</span><span id="MappingSchema.copy-219"><a href="#MappingSchema.copy-219"><span class="linenos">219</span></a> <span class="o">**</span><span class="p">{</span> <span class="c1"># type: ignore</span> +</span><span id="MappingSchema.copy-220"><a href="#MappingSchema.copy-220"><span class="linenos">220</span></a> <span class="s2">"schema"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">mapping</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> +</span><span id="MappingSchema.copy-221"><a href="#MappingSchema.copy-221"><span class="linenos">221</span></a> <span class="s2">"visible"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visible</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> +</span><span id="MappingSchema.copy-222"><a href="#MappingSchema.copy-222"><span class="linenos">222</span></a> <span class="s2">"dialect"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">dialect</span><span class="p">,</span> +</span><span id="MappingSchema.copy-223"><a href="#MappingSchema.copy-223"><span class="linenos">223</span></a> <span class="s2">"normalize"</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">normalize</span><span class="p">,</span> +</span><span id="MappingSchema.copy-224"><a href="#MappingSchema.copy-224"><span class="linenos">224</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> +</span><span id="MappingSchema.copy-225"><a href="#MappingSchema.copy-225"><span class="linenos">225</span></a> <span class="p">}</span> +</span><span id="MappingSchema.copy-226"><a href="#MappingSchema.copy-226"><span class="linenos">226</span></a> <span class="p">)</span> +</span></pre></div> + + + + + </div> + <div id="MappingSchema.depth" class="classattr"> + <input id="MappingSchema.depth-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1"> +<div class="attr function"> + + <span class="def">def</span> + <span class="name">depth</span><span class="signature pdoc-code condensed">(<span class="param"><span class="bp">self</span></span><span class="return-annotation">) -> <span class="nb">int</span>:</span></span> + + <label class="view-source-button" for="MappingSchema.depth-view-source"><span>View Source</span></label> + + </div> + <a class="headerlink" href="#MappingSchema.depth"></a> + <div class="pdoc-code codehilite"><pre><span></span><span id="MappingSchema.depth-392"><a href="#MappingSchema.depth-392"><span class="linenos">392</span></a> <span class="k">def</span> <span class="nf">depth</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">int</span><span class="p">:</span> +</span><span id="MappingSchema.depth-393"><a href="#MappingSchema.depth-393"><span class="linenos">393</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">empty</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span><span class="p">:</span> +</span><span id="MappingSchema.depth-394"><a href="#MappingSchema.depth-394"><span class="linenos">394</span></a> <span class="c1"># The columns themselves are a mapping, but we don't want to include those</span> +</span><span id="MappingSchema.depth-395"><a href="#MappingSchema.depth-395"><span class="linenos">395</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span> <span class="o">=</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">depth</span><span class="p">()</span> <span class="o">-</span> <span class="mi">1</span> +</span><span id="MappingSchema.depth-396"><a href="#MappingSchema.depth-396"><span class="linenos">396</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_depth</span> </span></pre></div> @@ -1554,11 +1708,11 @@ are assumed to be visible. The nesting should mirror that of the schema: </div> <a class="headerlink" href="#ensure_schema"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="ensure_schema-377"><a href="#ensure_schema-377"><span class="linenos">377</span></a><span class="k">def</span> <span class="nf">ensure_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">:</span> <span class="n">Schema</span> <span class="o">|</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">)</span> <span class="o">-></span> <span class="n">Schema</span><span class="p">:</span> -</span><span id="ensure_schema-378"><a href="#ensure_schema-378"><span class="linenos">378</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="n">Schema</span><span class="p">):</span> -</span><span id="ensure_schema-379"><a href="#ensure_schema-379"><span class="linenos">379</span></a> <span class="k">return</span> <span class="n">schema</span> -</span><span id="ensure_schema-380"><a href="#ensure_schema-380"><span class="linenos">380</span></a> -</span><span id="ensure_schema-381"><a href="#ensure_schema-381"><span class="linenos">381</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="ensure_schema-422"><a href="#ensure_schema-422"><span class="linenos">422</span></a><span class="k">def</span> <span class="nf">ensure_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">:</span> <span class="n">Schema</span> <span class="o">|</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">],</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">)</span> <span class="o">-></span> <span class="n">Schema</span><span class="p">:</span> +</span><span id="ensure_schema-423"><a href="#ensure_schema-423"><span class="linenos">423</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="n">Schema</span><span class="p">):</span> +</span><span id="ensure_schema-424"><a href="#ensure_schema-424"><span class="linenos">424</span></a> <span class="k">return</span> <span class="n">schema</span> +</span><span id="ensure_schema-425"><a href="#ensure_schema-425"><span class="linenos">425</span></a> +</span><span id="ensure_schema-426"><a href="#ensure_schema-426"><span class="linenos">426</span></a> <span class="k">return</span> <span class="n">MappingSchema</span><span class="p">(</span><span class="n">schema</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> </span></pre></div> @@ -1576,24 +1730,24 @@ are assumed to be visible. The nesting should mirror that of the schema: </div> <a class="headerlink" href="#ensure_column_mapping"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="ensure_column_mapping-384"><a href="#ensure_column_mapping-384"><span class="linenos">384</span></a><span class="k">def</span> <span class="nf">ensure_column_mapping</span><span class="p">(</span><span class="n">mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">])</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> -</span><span id="ensure_column_mapping-385"><a href="#ensure_column_mapping-385"><span class="linenos">385</span></a> <span class="k">if</span> <span class="n">mapping</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="ensure_column_mapping-386"><a href="#ensure_column_mapping-386"><span class="linenos">386</span></a> <span class="k">return</span> <span class="p">{}</span> -</span><span id="ensure_column_mapping-387"><a href="#ensure_column_mapping-387"><span class="linenos">387</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span> -</span><span id="ensure_column_mapping-388"><a href="#ensure_column_mapping-388"><span class="linenos">388</span></a> <span class="k">return</span> <span class="n">mapping</span> -</span><span id="ensure_column_mapping-389"><a href="#ensure_column_mapping-389"><span class="linenos">389</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> -</span><span id="ensure_column_mapping-390"><a href="#ensure_column_mapping-390"><span class="linenos">390</span></a> <span class="n">col_name_type_strs</span> <span class="o">=</span> <span class="p">[</span><span class="n">x</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">mapping</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">","</span><span class="p">)]</span> -</span><span id="ensure_column_mapping-391"><a href="#ensure_column_mapping-391"><span class="linenos">391</span></a> <span class="k">return</span> <span class="p">{</span> -</span><span id="ensure_column_mapping-392"><a href="#ensure_column_mapping-392"><span class="linenos">392</span></a> <span class="n">name_type_str</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">":"</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">strip</span><span class="p">():</span> <span class="n">name_type_str</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">":"</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> -</span><span id="ensure_column_mapping-393"><a href="#ensure_column_mapping-393"><span class="linenos">393</span></a> <span class="k">for</span> <span class="n">name_type_str</span> <span class="ow">in</span> <span class="n">col_name_type_strs</span> -</span><span id="ensure_column_mapping-394"><a href="#ensure_column_mapping-394"><span class="linenos">394</span></a> <span class="p">}</span> -</span><span id="ensure_column_mapping-395"><a href="#ensure_column_mapping-395"><span class="linenos">395</span></a> <span class="c1"># Check if mapping looks like a DataFrame StructType</span> -</span><span id="ensure_column_mapping-396"><a href="#ensure_column_mapping-396"><span class="linenos">396</span></a> <span class="k">elif</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="s2">"simpleString"</span><span class="p">):</span> -</span><span id="ensure_column_mapping-397"><a href="#ensure_column_mapping-397"><span class="linenos">397</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">struct_field</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="n">struct_field</span><span class="o">.</span><span class="n">dataType</span><span class="o">.</span><span class="n">simpleString</span><span class="p">()</span> <span class="k">for</span> <span class="n">struct_field</span> <span class="ow">in</span> <span class="n">mapping</span><span class="p">}</span> -</span><span id="ensure_column_mapping-398"><a href="#ensure_column_mapping-398"><span class="linenos">398</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span> -</span><span id="ensure_column_mapping-399"><a href="#ensure_column_mapping-399"><span class="linenos">399</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">x</span><span class="o">.</span><span class="n">strip</span><span class="p">():</span> <span class="kc">None</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">mapping</span><span class="p">}</span> -</span><span id="ensure_column_mapping-400"><a href="#ensure_column_mapping-400"><span class="linenos">400</span></a> -</span><span id="ensure_column_mapping-401"><a href="#ensure_column_mapping-401"><span class="linenos">401</span></a> <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Invalid mapping provided: </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">mapping</span><span class="p">)</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="ensure_column_mapping-429"><a href="#ensure_column_mapping-429"><span class="linenos">429</span></a><span class="k">def</span> <span class="nf">ensure_column_mapping</span><span class="p">(</span><span class="n">mapping</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">ColumnMapping</span><span class="p">])</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> +</span><span id="ensure_column_mapping-430"><a href="#ensure_column_mapping-430"><span class="linenos">430</span></a> <span class="k">if</span> <span class="n">mapping</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="ensure_column_mapping-431"><a href="#ensure_column_mapping-431"><span class="linenos">431</span></a> <span class="k">return</span> <span class="p">{}</span> +</span><span id="ensure_column_mapping-432"><a href="#ensure_column_mapping-432"><span class="linenos">432</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span> +</span><span id="ensure_column_mapping-433"><a href="#ensure_column_mapping-433"><span class="linenos">433</span></a> <span class="k">return</span> <span class="n">mapping</span> +</span><span id="ensure_column_mapping-434"><a href="#ensure_column_mapping-434"><span class="linenos">434</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> +</span><span id="ensure_column_mapping-435"><a href="#ensure_column_mapping-435"><span class="linenos">435</span></a> <span class="n">col_name_type_strs</span> <span class="o">=</span> <span class="p">[</span><span class="n">x</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">mapping</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">","</span><span class="p">)]</span> +</span><span id="ensure_column_mapping-436"><a href="#ensure_column_mapping-436"><span class="linenos">436</span></a> <span class="k">return</span> <span class="p">{</span> +</span><span id="ensure_column_mapping-437"><a href="#ensure_column_mapping-437"><span class="linenos">437</span></a> <span class="n">name_type_str</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">":"</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">strip</span><span class="p">():</span> <span class="n">name_type_str</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">":"</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> +</span><span id="ensure_column_mapping-438"><a href="#ensure_column_mapping-438"><span class="linenos">438</span></a> <span class="k">for</span> <span class="n">name_type_str</span> <span class="ow">in</span> <span class="n">col_name_type_strs</span> +</span><span id="ensure_column_mapping-439"><a href="#ensure_column_mapping-439"><span class="linenos">439</span></a> <span class="p">}</span> +</span><span id="ensure_column_mapping-440"><a href="#ensure_column_mapping-440"><span class="linenos">440</span></a> <span class="c1"># Check if mapping looks like a DataFrame StructType</span> +</span><span id="ensure_column_mapping-441"><a href="#ensure_column_mapping-441"><span class="linenos">441</span></a> <span class="k">elif</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="s2">"simpleString"</span><span class="p">):</span> +</span><span id="ensure_column_mapping-442"><a href="#ensure_column_mapping-442"><span class="linenos">442</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">struct_field</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="n">struct_field</span><span class="o">.</span><span class="n">dataType</span><span class="o">.</span><span class="n">simpleString</span><span class="p">()</span> <span class="k">for</span> <span class="n">struct_field</span> <span class="ow">in</span> <span class="n">mapping</span><span class="p">}</span> +</span><span id="ensure_column_mapping-443"><a href="#ensure_column_mapping-443"><span class="linenos">443</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mapping</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span> +</span><span id="ensure_column_mapping-444"><a href="#ensure_column_mapping-444"><span class="linenos">444</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">x</span><span class="o">.</span><span class="n">strip</span><span class="p">():</span> <span class="kc">None</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">mapping</span><span class="p">}</span> +</span><span id="ensure_column_mapping-445"><a href="#ensure_column_mapping-445"><span class="linenos">445</span></a> +</span><span id="ensure_column_mapping-446"><a href="#ensure_column_mapping-446"><span class="linenos">446</span></a> <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Invalid mapping provided: </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">mapping</span><span class="p">)</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> </span></pre></div> @@ -1611,19 +1765,19 @@ are assumed to be visible. The nesting should mirror that of the schema: </div> <a class="headerlink" href="#flatten_schema"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="flatten_schema-404"><a href="#flatten_schema-404"><span class="linenos">404</span></a><span class="k">def</span> <span class="nf">flatten_schema</span><span class="p">(</span> -</span><span id="flatten_schema-405"><a href="#flatten_schema-405"><span class="linenos">405</span></a> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="n">depth</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">keys</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="flatten_schema-406"><a href="#flatten_schema-406"><span class="linenos">406</span></a><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]:</span> -</span><span id="flatten_schema-407"><a href="#flatten_schema-407"><span class="linenos">407</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="flatten_schema-408"><a href="#flatten_schema-408"><span class="linenos">408</span></a> <span class="n">keys</span> <span class="o">=</span> <span class="n">keys</span> <span class="ow">or</span> <span class="p">[]</span> -</span><span id="flatten_schema-409"><a href="#flatten_schema-409"><span class="linenos">409</span></a> -</span><span id="flatten_schema-410"><a href="#flatten_schema-410"><span class="linenos">410</span></a> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">schema</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> -</span><span id="flatten_schema-411"><a href="#flatten_schema-411"><span class="linenos">411</span></a> <span class="k">if</span> <span class="n">depth</span> <span class="o">>=</span> <span class="mi">2</span><span class="p">:</span> -</span><span id="flatten_schema-412"><a href="#flatten_schema-412"><span class="linenos">412</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">flatten_schema</span><span class="p">(</span><span class="n">v</span><span class="p">,</span> <span class="n">depth</span> <span class="o">-</span> <span class="mi">1</span><span class="p">,</span> <span class="n">keys</span> <span class="o">+</span> <span class="p">[</span><span class="n">k</span><span class="p">]))</span> -</span><span id="flatten_schema-413"><a href="#flatten_schema-413"><span class="linenos">413</span></a> <span class="k">elif</span> <span class="n">depth</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> -</span><span id="flatten_schema-414"><a href="#flatten_schema-414"><span class="linenos">414</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">keys</span> <span class="o">+</span> <span class="p">[</span><span class="n">k</span><span class="p">])</span> -</span><span id="flatten_schema-415"><a href="#flatten_schema-415"><span class="linenos">415</span></a> -</span><span id="flatten_schema-416"><a href="#flatten_schema-416"><span class="linenos">416</span></a> <span class="k">return</span> <span class="n">tables</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="flatten_schema-449"><a href="#flatten_schema-449"><span class="linenos">449</span></a><span class="k">def</span> <span class="nf">flatten_schema</span><span class="p">(</span> +</span><span id="flatten_schema-450"><a href="#flatten_schema-450"><span class="linenos">450</span></a> <span class="n">schema</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="n">depth</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">keys</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="flatten_schema-451"><a href="#flatten_schema-451"><span class="linenos">451</span></a><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]:</span> +</span><span id="flatten_schema-452"><a href="#flatten_schema-452"><span class="linenos">452</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="flatten_schema-453"><a href="#flatten_schema-453"><span class="linenos">453</span></a> <span class="n">keys</span> <span class="o">=</span> <span class="n">keys</span> <span class="ow">or</span> <span class="p">[]</span> +</span><span id="flatten_schema-454"><a href="#flatten_schema-454"><span class="linenos">454</span></a> +</span><span id="flatten_schema-455"><a href="#flatten_schema-455"><span class="linenos">455</span></a> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">schema</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> +</span><span id="flatten_schema-456"><a href="#flatten_schema-456"><span class="linenos">456</span></a> <span class="k">if</span> <span class="n">depth</span> <span class="o">>=</span> <span class="mi">2</span><span class="p">:</span> +</span><span id="flatten_schema-457"><a href="#flatten_schema-457"><span class="linenos">457</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">flatten_schema</span><span class="p">(</span><span class="n">v</span><span class="p">,</span> <span class="n">depth</span> <span class="o">-</span> <span class="mi">1</span><span class="p">,</span> <span class="n">keys</span> <span class="o">+</span> <span class="p">[</span><span class="n">k</span><span class="p">]))</span> +</span><span id="flatten_schema-458"><a href="#flatten_schema-458"><span class="linenos">458</span></a> <span class="k">elif</span> <span class="n">depth</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> +</span><span id="flatten_schema-459"><a href="#flatten_schema-459"><span class="linenos">459</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">keys</span> <span class="o">+</span> <span class="p">[</span><span class="n">k</span><span class="p">])</span> +</span><span id="flatten_schema-460"><a href="#flatten_schema-460"><span class="linenos">460</span></a> +</span><span id="flatten_schema-461"><a href="#flatten_schema-461"><span class="linenos">461</span></a> <span class="k">return</span> <span class="n">tables</span> </span></pre></div> @@ -1641,30 +1795,30 @@ are assumed to be visible. The nesting should mirror that of the schema: </div> <a class="headerlink" href="#nested_get"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="nested_get-419"><a href="#nested_get-419"><span class="linenos">419</span></a><span class="k">def</span> <span class="nf">nested_get</span><span class="p">(</span> -</span><span id="nested_get-420"><a href="#nested_get-420"><span class="linenos">420</span></a> <span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="o">*</span><span class="n">path</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">],</span> <span class="n">raise_on_missing</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span> -</span><span id="nested_get-421"><a href="#nested_get-421"><span class="linenos">421</span></a><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">]:</span> -</span><span id="nested_get-422"><a href="#nested_get-422"><span class="linenos">422</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="nested_get-423"><a href="#nested_get-423"><span class="linenos">423</span></a><span class="sd"> Get a value for a nested dictionary.</span> -</span><span id="nested_get-424"><a href="#nested_get-424"><span class="linenos">424</span></a> -</span><span id="nested_get-425"><a href="#nested_get-425"><span class="linenos">425</span></a><span class="sd"> Args:</span> -</span><span id="nested_get-426"><a href="#nested_get-426"><span class="linenos">426</span></a><span class="sd"> d: the dictionary to search.</span> -</span><span id="nested_get-427"><a href="#nested_get-427"><span class="linenos">427</span></a><span class="sd"> *path: tuples of (name, key), where:</span> -</span><span id="nested_get-428"><a href="#nested_get-428"><span class="linenos">428</span></a><span class="sd"> `key` is the key in the dictionary to get.</span> -</span><span id="nested_get-429"><a href="#nested_get-429"><span class="linenos">429</span></a><span class="sd"> `name` is a string to use in the error if `key` isn't found.</span> -</span><span id="nested_get-430"><a href="#nested_get-430"><span class="linenos">430</span></a> -</span><span id="nested_get-431"><a href="#nested_get-431"><span class="linenos">431</span></a><span class="sd"> Returns:</span> -</span><span id="nested_get-432"><a href="#nested_get-432"><span class="linenos">432</span></a><span class="sd"> The value or None if it doesn't exist.</span> -</span><span id="nested_get-433"><a href="#nested_get-433"><span class="linenos">433</span></a><span class="sd"> """</span> -</span><span id="nested_get-434"><a href="#nested_get-434"><span class="linenos">434</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">path</span><span class="p">:</span> -</span><span id="nested_get-435"><a href="#nested_get-435"><span class="linenos">435</span></a> <span class="n">d</span> <span class="o">=</span> <span class="n">d</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">key</span><span class="p">)</span> <span class="c1"># type: ignore</span> -</span><span id="nested_get-436"><a href="#nested_get-436"><span class="linenos">436</span></a> <span class="k">if</span> <span class="n">d</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="nested_get-437"><a href="#nested_get-437"><span class="linenos">437</span></a> <span class="k">if</span> <span class="n">raise_on_missing</span><span class="p">:</span> -</span><span id="nested_get-438"><a href="#nested_get-438"><span class="linenos">438</span></a> <span class="n">name</span> <span class="o">=</span> <span class="s2">"table"</span> <span class="k">if</span> <span class="n">name</span> <span class="o">==</span> <span class="s2">"this"</span> <span class="k">else</span> <span class="n">name</span> -</span><span id="nested_get-439"><a href="#nested_get-439"><span class="linenos">439</span></a> <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">key</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="nested_get-440"><a href="#nested_get-440"><span class="linenos">440</span></a> <span class="k">return</span> <span class="kc">None</span> -</span><span id="nested_get-441"><a href="#nested_get-441"><span class="linenos">441</span></a> -</span><span id="nested_get-442"><a href="#nested_get-442"><span class="linenos">442</span></a> <span class="k">return</span> <span class="n">d</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="nested_get-464"><a href="#nested_get-464"><span class="linenos">464</span></a><span class="k">def</span> <span class="nf">nested_get</span><span class="p">(</span> +</span><span id="nested_get-465"><a href="#nested_get-465"><span class="linenos">465</span></a> <span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="o">*</span><span class="n">path</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">],</span> <span class="n">raise_on_missing</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span> +</span><span id="nested_get-466"><a href="#nested_get-466"><span class="linenos">466</span></a><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">]:</span> +</span><span id="nested_get-467"><a href="#nested_get-467"><span class="linenos">467</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="nested_get-468"><a href="#nested_get-468"><span class="linenos">468</span></a><span class="sd"> Get a value for a nested dictionary.</span> +</span><span id="nested_get-469"><a href="#nested_get-469"><span class="linenos">469</span></a> +</span><span id="nested_get-470"><a href="#nested_get-470"><span class="linenos">470</span></a><span class="sd"> Args:</span> +</span><span id="nested_get-471"><a href="#nested_get-471"><span class="linenos">471</span></a><span class="sd"> d: the dictionary to search.</span> +</span><span id="nested_get-472"><a href="#nested_get-472"><span class="linenos">472</span></a><span class="sd"> *path: tuples of (name, key), where:</span> +</span><span id="nested_get-473"><a href="#nested_get-473"><span class="linenos">473</span></a><span class="sd"> `key` is the key in the dictionary to get.</span> +</span><span id="nested_get-474"><a href="#nested_get-474"><span class="linenos">474</span></a><span class="sd"> `name` is a string to use in the error if `key` isn't found.</span> +</span><span id="nested_get-475"><a href="#nested_get-475"><span class="linenos">475</span></a> +</span><span id="nested_get-476"><a href="#nested_get-476"><span class="linenos">476</span></a><span class="sd"> Returns:</span> +</span><span id="nested_get-477"><a href="#nested_get-477"><span class="linenos">477</span></a><span class="sd"> The value or None if it doesn't exist.</span> +</span><span id="nested_get-478"><a href="#nested_get-478"><span class="linenos">478</span></a><span class="sd"> """</span> +</span><span id="nested_get-479"><a href="#nested_get-479"><span class="linenos">479</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">path</span><span class="p">:</span> +</span><span id="nested_get-480"><a href="#nested_get-480"><span class="linenos">480</span></a> <span class="n">d</span> <span class="o">=</span> <span class="n">d</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">key</span><span class="p">)</span> <span class="c1"># type: ignore</span> +</span><span id="nested_get-481"><a href="#nested_get-481"><span class="linenos">481</span></a> <span class="k">if</span> <span class="n">d</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="nested_get-482"><a href="#nested_get-482"><span class="linenos">482</span></a> <span class="k">if</span> <span class="n">raise_on_missing</span><span class="p">:</span> +</span><span id="nested_get-483"><a href="#nested_get-483"><span class="linenos">483</span></a> <span class="n">name</span> <span class="o">=</span> <span class="s2">"table"</span> <span class="k">if</span> <span class="n">name</span> <span class="o">==</span> <span class="s2">"this"</span> <span class="k">else</span> <span class="n">name</span> +</span><span id="nested_get-484"><a href="#nested_get-484"><span class="linenos">484</span></a> <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">key</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="nested_get-485"><a href="#nested_get-485"><span class="linenos">485</span></a> <span class="k">return</span> <span class="kc">None</span> +</span><span id="nested_get-486"><a href="#nested_get-486"><span class="linenos">486</span></a> +</span><span id="nested_get-487"><a href="#nested_get-487"><span class="linenos">487</span></a> <span class="k">return</span> <span class="n">d</span> </span></pre></div> @@ -1699,41 +1853,41 @@ are assumed to be visible. The nesting should mirror that of the schema: </div> <a class="headerlink" href="#nested_set"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="nested_set-445"><a href="#nested_set-445"><span class="linenos">445</span></a><span class="k">def</span> <span class="nf">nested_set</span><span class="p">(</span><span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="n">keys</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">value</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> -</span><span id="nested_set-446"><a href="#nested_set-446"><span class="linenos">446</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="nested_set-447"><a href="#nested_set-447"><span class="linenos">447</span></a><span class="sd"> In-place set a value for a nested dictionary</span> -</span><span id="nested_set-448"><a href="#nested_set-448"><span class="linenos">448</span></a> -</span><span id="nested_set-449"><a href="#nested_set-449"><span class="linenos">449</span></a><span class="sd"> Example:</span> -</span><span id="nested_set-450"><a href="#nested_set-450"><span class="linenos">450</span></a><span class="sd"> >>> nested_set({}, ["top_key", "second_key"], "value")</span> -</span><span id="nested_set-451"><a href="#nested_set-451"><span class="linenos">451</span></a><span class="sd"> {'top_key': {'second_key': 'value'}}</span> -</span><span id="nested_set-452"><a href="#nested_set-452"><span class="linenos">452</span></a> -</span><span id="nested_set-453"><a href="#nested_set-453"><span class="linenos">453</span></a><span class="sd"> >>> nested_set({"top_key": {"third_key": "third_value"}}, ["top_key", "second_key"], "value")</span> -</span><span id="nested_set-454"><a href="#nested_set-454"><span class="linenos">454</span></a><span class="sd"> {'top_key': {'third_key': 'third_value', 'second_key': 'value'}}</span> -</span><span id="nested_set-455"><a href="#nested_set-455"><span class="linenos">455</span></a> -</span><span id="nested_set-456"><a href="#nested_set-456"><span class="linenos">456</span></a><span class="sd"> Args:</span> -</span><span id="nested_set-457"><a href="#nested_set-457"><span class="linenos">457</span></a><span class="sd"> d: dictionary to update.</span> -</span><span id="nested_set-458"><a href="#nested_set-458"><span class="linenos">458</span></a><span class="sd"> keys: the keys that makeup the path to `value`.</span> -</span><span id="nested_set-459"><a href="#nested_set-459"><span class="linenos">459</span></a><span class="sd"> value: the value to set in the dictionary for the given key path.</span> -</span><span id="nested_set-460"><a href="#nested_set-460"><span class="linenos">460</span></a> -</span><span id="nested_set-461"><a href="#nested_set-461"><span class="linenos">461</span></a><span class="sd"> Returns:</span> -</span><span id="nested_set-462"><a href="#nested_set-462"><span class="linenos">462</span></a><span class="sd"> The (possibly) updated dictionary.</span> -</span><span id="nested_set-463"><a href="#nested_set-463"><span class="linenos">463</span></a><span class="sd"> """</span> -</span><span id="nested_set-464"><a href="#nested_set-464"><span class="linenos">464</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">keys</span><span class="p">:</span> -</span><span id="nested_set-465"><a href="#nested_set-465"><span class="linenos">465</span></a> <span class="k">return</span> <span class="n">d</span> -</span><span id="nested_set-466"><a href="#nested_set-466"><span class="linenos">466</span></a> -</span><span id="nested_set-467"><a href="#nested_set-467"><span class="linenos">467</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">keys</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> -</span><span id="nested_set-468"><a href="#nested_set-468"><span class="linenos">468</span></a> <span class="n">d</span><span class="p">[</span><span class="n">keys</span><span class="p">[</span><span class="mi">0</span><span class="p">]]</span> <span class="o">=</span> <span class="n">value</span> -</span><span id="nested_set-469"><a href="#nested_set-469"><span class="linenos">469</span></a> <span class="k">return</span> <span class="n">d</span> -</span><span id="nested_set-470"><a href="#nested_set-470"><span class="linenos">470</span></a> -</span><span id="nested_set-471"><a href="#nested_set-471"><span class="linenos">471</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">d</span> -</span><span id="nested_set-472"><a href="#nested_set-472"><span class="linenos">472</span></a> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">keys</span><span class="p">[:</span><span class="o">-</span><span class="mi">1</span><span class="p">]:</span> -</span><span id="nested_set-473"><a href="#nested_set-473"><span class="linenos">473</span></a> <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">subd</span><span class="p">:</span> -</span><span id="nested_set-474"><a href="#nested_set-474"><span class="linenos">474</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">subd</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="p">{})</span> -</span><span id="nested_set-475"><a href="#nested_set-475"><span class="linenos">475</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="nested_set-476"><a href="#nested_set-476"><span class="linenos">476</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">subd</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> -</span><span id="nested_set-477"><a href="#nested_set-477"><span class="linenos">477</span></a> -</span><span id="nested_set-478"><a href="#nested_set-478"><span class="linenos">478</span></a> <span class="n">subd</span><span class="p">[</span><span class="n">keys</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]]</span> <span class="o">=</span> <span class="n">value</span> -</span><span id="nested_set-479"><a href="#nested_set-479"><span class="linenos">479</span></a> <span class="k">return</span> <span class="n">d</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="nested_set-490"><a href="#nested_set-490"><span class="linenos">490</span></a><span class="k">def</span> <span class="nf">nested_set</span><span class="p">(</span><span class="n">d</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">,</span> <span class="n">keys</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">value</span><span class="p">:</span> <span class="n">t</span><span class="o">.</span><span class="n">Any</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Dict</span><span class="p">:</span> +</span><span id="nested_set-491"><a href="#nested_set-491"><span class="linenos">491</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="nested_set-492"><a href="#nested_set-492"><span class="linenos">492</span></a><span class="sd"> In-place set a value for a nested dictionary</span> +</span><span id="nested_set-493"><a href="#nested_set-493"><span class="linenos">493</span></a> +</span><span id="nested_set-494"><a href="#nested_set-494"><span class="linenos">494</span></a><span class="sd"> Example:</span> +</span><span id="nested_set-495"><a href="#nested_set-495"><span class="linenos">495</span></a><span class="sd"> >>> nested_set({}, ["top_key", "second_key"], "value")</span> +</span><span id="nested_set-496"><a href="#nested_set-496"><span class="linenos">496</span></a><span class="sd"> {'top_key': {'second_key': 'value'}}</span> +</span><span id="nested_set-497"><a href="#nested_set-497"><span class="linenos">497</span></a> +</span><span id="nested_set-498"><a href="#nested_set-498"><span class="linenos">498</span></a><span class="sd"> >>> nested_set({"top_key": {"third_key": "third_value"}}, ["top_key", "second_key"], "value")</span> +</span><span id="nested_set-499"><a href="#nested_set-499"><span class="linenos">499</span></a><span class="sd"> {'top_key': {'third_key': 'third_value', 'second_key': 'value'}}</span> +</span><span id="nested_set-500"><a href="#nested_set-500"><span class="linenos">500</span></a> +</span><span id="nested_set-501"><a href="#nested_set-501"><span class="linenos">501</span></a><span class="sd"> Args:</span> +</span><span id="nested_set-502"><a href="#nested_set-502"><span class="linenos">502</span></a><span class="sd"> d: dictionary to update.</span> +</span><span id="nested_set-503"><a href="#nested_set-503"><span class="linenos">503</span></a><span class="sd"> keys: the keys that makeup the path to `value`.</span> +</span><span id="nested_set-504"><a href="#nested_set-504"><span class="linenos">504</span></a><span class="sd"> value: the value to set in the dictionary for the given key path.</span> +</span><span id="nested_set-505"><a href="#nested_set-505"><span class="linenos">505</span></a> +</span><span id="nested_set-506"><a href="#nested_set-506"><span class="linenos">506</span></a><span class="sd"> Returns:</span> +</span><span id="nested_set-507"><a href="#nested_set-507"><span class="linenos">507</span></a><span class="sd"> The (possibly) updated dictionary.</span> +</span><span id="nested_set-508"><a href="#nested_set-508"><span class="linenos">508</span></a><span class="sd"> """</span> +</span><span id="nested_set-509"><a href="#nested_set-509"><span class="linenos">509</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">keys</span><span class="p">:</span> +</span><span id="nested_set-510"><a href="#nested_set-510"><span class="linenos">510</span></a> <span class="k">return</span> <span class="n">d</span> +</span><span id="nested_set-511"><a href="#nested_set-511"><span class="linenos">511</span></a> +</span><span id="nested_set-512"><a href="#nested_set-512"><span class="linenos">512</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">keys</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> +</span><span id="nested_set-513"><a href="#nested_set-513"><span class="linenos">513</span></a> <span class="n">d</span><span class="p">[</span><span class="n">keys</span><span class="p">[</span><span class="mi">0</span><span class="p">]]</span> <span class="o">=</span> <span class="n">value</span> +</span><span id="nested_set-514"><a href="#nested_set-514"><span class="linenos">514</span></a> <span class="k">return</span> <span class="n">d</span> +</span><span id="nested_set-515"><a href="#nested_set-515"><span class="linenos">515</span></a> +</span><span id="nested_set-516"><a href="#nested_set-516"><span class="linenos">516</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">d</span> +</span><span id="nested_set-517"><a href="#nested_set-517"><span class="linenos">517</span></a> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">keys</span><span class="p">[:</span><span class="o">-</span><span class="mi">1</span><span class="p">]:</span> +</span><span id="nested_set-518"><a href="#nested_set-518"><span class="linenos">518</span></a> <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">subd</span><span class="p">:</span> +</span><span id="nested_set-519"><a href="#nested_set-519"><span class="linenos">519</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">subd</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="p">{})</span> +</span><span id="nested_set-520"><a href="#nested_set-520"><span class="linenos">520</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="nested_set-521"><a href="#nested_set-521"><span class="linenos">521</span></a> <span class="n">subd</span> <span class="o">=</span> <span class="n">subd</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> +</span><span id="nested_set-522"><a href="#nested_set-522"><span class="linenos">522</span></a> +</span><span id="nested_set-523"><a href="#nested_set-523"><span class="linenos">523</span></a> <span class="n">subd</span><span class="p">[</span><span class="n">keys</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]]</span> <span class="o">=</span> <span class="n">value</span> +</span><span id="nested_set-524"><a href="#nested_set-524"><span class="linenos">524</span></a> <span class="k">return</span> <span class="n">d</span> </span></pre></div> |